Standalone Logtool for MPE/iX

be displayed in a report generated by the

LIST command. Quotes are only required

for field labels which contain embedded

blanks.

<field label list> ::= <field label range> |

<field label range>,<field label list> | ALL

<field label> ::= text | "text"

Ex: DISABLE="NL CHECKSUM"/"SL CHECKSUM"

ENABLE = <field label list> - Specifies which fields are to

be displayed in a report generated by the

LIST command. Quotes are only required

for field labels which contain embedded

blanks.

<field label list> ::= <field label range> |

<field label range>,<field label list> | ALL

<field label> ::= text | "text"

Ex: ENABLE = PDEV/"LLIO STATUS"

Command Example:

LOGTOOL> altfield type=111 disable="retry scheme"/"mgr code"

LOGTOOL>

LAYOUT

The LAYOUT command will allow the user to define the format of a particular log entry, which may be found in the

system log file. This command requires special files containing the definition of some log file record entries defined in

a special language. Please refer to the Record Definition File Formatting section for more detailed information.

Once the record definitions have been accepted, LOGTOOL will display the record entry as specified when performing a

LIST command. If any syntax errors are detected by the LAYOUT command, the errors will be displayed to the user and

the record definition will not be accepted. Upon completion of the record definition file processing, LAYOUT will

display the number of errors detected, the number of record definition accepted and the number of tag definitions

accepted. If the APPEND option is given, LOGTOOL will append the new record definitions to the record decoding files

(LAYOUTF and LAYMSG). These decoding files are used as a data base of record definitions. The record definitions

in the record decoding files will be used by all users when performing a LIST command. If the APPEND option is not

given, the record definitions given will be used only by the current session of LOGTOOL and will be lost upon exiting

LOGTOOL.

During the processing of a record definition file, if a record definition already exists, the user will be prompted to

determine if the previous definition should be overwritten. If the answer YES is given, the previous definition will be

destroyed. This prompting can be disabled by giving the NOVERIFY option and the overwrite case is assumed.

To execute this command, the user must possess at least diagnostic security 1. (It is assumed that the record definition

files given are located in the diagnostic directory -- DIAG.SYS on MPE/iX.)

Syntax:

LAYOUT FILES=<file_list>

[;VERIFY | ;NOVERIFY]

[;APPEND]