HP 3000 Manuals HP 3000 Manuals
SCAN
SCAN [logfile]
The following related commands are discussed briefly in this section and
in more detail elsewhere in this chapter under the command name: LIST,
START, STOP, DETAIL, NOTES, and ALARMS.
The SCAN command reads a log file and writes a summary report on its
contents. The format of this report depends on the commands issued prior
to SCAN. For example,
* The LOGFILE and SCAN commands can create a report on the log
file's disc space.
The DETAIL, ALARMS, and NOTES commands can control the amount of
information reported during this process.
* Default details can be disabled by turning off DETAIL and NOTES
before performing a SCAN to produce a summary report on the
contents of a log file.
* By enabling DETAIL before scanning a log file, you can produce a
report on the changes in collection parameters over time.
This report would show summaries of application and process
collection whenever appropriate changes in collection occurred.
The report also would tell you each time the SCOPE(XL) collector
was restarted and the length of time the collector was not
running.
* Process performance alarms against a log file and report when
alarms would be satisfied. Alarm definitions must have been
processed by the most current PARMFILE command in order to be
processed during the SCAN. See the chapter on Performance Alarms
for more details.
The SCAN command requires that a log file is opened. The log file to be
scanned is the first of one of the following:
1. The log file named in the SCAN command itself.
2. The last log file opened by any previous command.
3. The default log file (LOGGLOB.SCOPE.SYS).
In this case, interactive users are prompted to override the
default log file name if so desired.
The following commands affect the operation of the SCAN function:
LIST (Redirects the report listing to another device.)
The default is to list to the standard list
device.
START (Specifies the starting date and time of the
scan.) The default is the beginning of the log
file.
STOP (Specifies the ending date and time of the scan.)
The default is the end of the log file.
DETAIL (Specifies the amount of detail in the report.)
The default (DETAIL=ON) specifies full detail.
NOTES (Specifies whether you want to see user and system
notes found in the log file.) The default is
NOTES=ON.
ALARMS (Specifies whether or not you want to see
individual Performance Alarms in the detailed
report.) The default is ALARMS=ON, if alarms are
defined.
The report from the SCAN command consists of several parts. You can
control whether some parts are present in the report by using the UTILITY
commands listed above.
Sample SCAN Tasks
Scan the current Performance Collection Software raw log files, and
display a report on the logging details.
This report includes details on the initial PARM file settings plus any
changes to these settings. An overall summary of disc space consumed by
each type of logging is also displayed. In this sample, the listing is
defaulted to the job or session $STDLIST device.
LOGFILE (Opens the LOGGLOB.SCOPE.SYS log
LOGGLOB.SCOPE.SYS file.)
DETAIL=ON (Specifies full detail for the SCAN
report.)
SCAN (Reads LOGGLOB and produces a
summary report on its contents.)