Standalone Logtool for MPE/iX

In order for a log record to be considered during the generation of a summary report, it must match all of the selection
criteria specified. The user can define the selection criteria by using the TYPE keyword, DATE or TIME options, or
field label keywords.
TYPE
keyword
The TYPE keyword can be used to indicate that only log records of the types specified are to be displayed.
The
LOGTOOL command TYPES can be used to obtain a list of the log record types available.
DATE or
TIME
options
The DATE or TIME options can be used to indicate that only the log records generated between the date
and time entered are to be displayed.
Field
Label
Keywords
Field label keywords allow the user to select log records based on the data present in the log record.
Whenever the LIST or SUMMARIZE command displays a data item from a log record, a field label is shown
before the data item to identify what the item represents. This field label is usually a text abbreviation.
Field label keywords allow the user to use this text abbreviation as a selection keyword. For example, if
the user wishes to have all log records with the field label of "LDEV" and a logged data value of 1
considered during the generation of the summary report, the parameter of "LDEV=1" can be entered as
part of the SUMMARIZE command.
If no selection criteria is given, all log records present in the system log files will be considered during the generation
of the summary report. The
SUMMARIZE command can produce two types of summary report.
Simple
summary
report
If the user does not use the FIELD keyword, a simple summary report will be generated. A simple
summary report will display the number of each type of log record present in the specified log files.
Summary
report
To generate a summary report using the FIELD keyword, the user must specify which fields of a log
record are to be summarized.
LOGTOOL will display each unique value found for the fields specified and the
number of log records in the log files which have that unique value. If the user specifies more than one
field, LOGTOOL will display each unique combination of field values found and the number of log records in
the log files which have that unique combination. The summary report will contain the first log record with
the unique value found. Please note that the summary report will only display the fields specified by the
FIELD keyword.
To execute this command, the user must posses at least diagnostic security level 1.
Syntax:
LIST LOG=<log list> | FILES=<file list>
[;OUTFILE=<file name>]
[;TYPE=<type list>]
[;<field label>=<data list>]
[;FIELD=<field label list>]
[;DATE]
[;TIME]
[;WIDE]
[;HEXDUMP]
Parameters:
LOG=<log list> - The LOG keyword specifies which log files to
base the report on. Use the STATUS
command to obtain a list of the system log files
available on the host system.
<log list> ::= <log number range> | <log number range> , <log list>
<log number range> ::= <log number> | <log number>/<log number>
<log number> ::= integer value
Ex: LOG=100/105, 150
FILES=<file list> - The FILES keyword is optionally used in place