User manual
Using S.M.A.R.T. Disk Monitor 161
SANTOOLS® is registered in US Patent and Trademark Office No 3,107,854 All rights reserved.
systems. At release 1.25, we were able to provide a common format and layout for all operating systems. In addition
to the first 10 substitution fields, there are 4 fields unique to Windows ($$11 - $$14) and 8 additional fields common to
all operating systems. These 8 additional parameters either provide field substitution or instruct the program to
perform an action such as terminate the program.
Below is the header of system-generated configuration files which provides details on these fields.
#
# DO NOT MODIFY LINE BELOW
# Version 1.03 Fri Mar 12 00:26:40 2004
#
# This file is used to define what statistical data should be monitored
# and reported at each polling interval. It may be edited manually, as
# long as the record format is strictly adhered to. Note also that there
# is one format common to all UNIX releases, and another common to Windows.
# Please refer to the manual for formatting information.
#
# Record #1:
# Field 1: Physical Device Name (i.e, \\.\PHYSICALDRIVE3, \\.\SCSI2Port2Path0Target4Lun0 or \\.\CDROM0
# (Both $$1 and $$P can be used to substitute for this value)
# Field 2: Log page number (hex)
# (Substitute as $$2)
# Field 3: If Field #4 is P for Parameter, then this is Log page parameter#
# Otherwise it is the hex byte offset to the start of the
# data.
# (Substitute as $$3)
# Field 4: Enter 'P' if field represents the log parameter number, or
# enter 'O' [capital letter O], if it is the byte offset
# (Substitute as $$4)
# Field 5: Threshold value (decimal). If zero, then value will always get read and
# reported (once value read is GREATER than 0). If non-zero, then a log entry
# will be displayed and recorded only when the value read meets or exceeds the
# threshold.
# (Substitute as $$5)
# Field 6: Polling frequency in seconds (decimal)
# (Substitute as $$6 for UNIX)
# Field 7: Can be 1 to 2 bytes. Enter 'E' to send email,
# and/or 'L' to log threshold alert in log file. Enter 'X' for neither.
# (Substitute as $$7)
# Field 8: Length in bytes of the data field (if Field#4 = O, otherwise, set to 0
# (Substitute as $$8)
# Field 9: Field format string -- N (numeric), A (alphanumeric)
# (Substitute as $$9)
# Field 10: The description. 1st character will start with a #, but that character will
# be suppressed for reporting
# (Substitute as $$10)
#
# Record #2:
# Script or program and options which will be launched in event threshold is exceeded
# Leave a blank line if this feature is not desired.
# WINDOWS Format:
# Both records same as above, with only exception is that fields 1-3 are replaced by the
# raw device driver. i.e.,
# \\.\PHYSICALDRIVE3 3c 11 P 1 E 0 #Time to clean the tape cartridge in Exabyte drive, rack slot #3
#
#
# Notes on substitutions
# In addition to field substitutions, you may also use the below values:
# $$P - Substitutes physical device path
# $$11 - Substitutes Adapter number (same as port number, Windows only)
# $$12 - SCSI ID of device to be queried (decimal, Windows only)
# $$13 - SCSI LUN of device to be queried (decimal, Windows only)
# $$14 - SCSI Path of device to be queried (decimal, Windows only) - Most but not all devices have
multiple paths
# $$V - Substitutes the current value read that was compared against threshold
# $$T - Substitutes event log text message that would normally be written to log
# $$D - Substitutes date and time string in default local format for this computer
# $$S - Substitutes time in seconds since midnight Jan 1, 1970 GMT
# $$X$$ - Instructs SMARTMon-UX to terminate the program after invoking the script