Standalone Logtool for MPE/iX

Typing a user interrupt while LOGTOOL is performing a lengthy task (i.e., producing a report or selecting out a subset of

error log records) will cause that task to be interrupted. The user may be asked in some cases to choose either to abort

or to continue the current task. If the user decides to terminate the task and there was output being directed to a disk

file (a report, for example), that file will be closed and preserved as is. Any appropriate cleanup is performed and the

user will be returned to the LOGTOOL> prompt.

The following notation appears throughout the remainder of this document. This notation is also used when performing

the HELP HELP command.

Notations Table

[ ] An element inside brackets is optional.

<> Items within angle brackets will be replaced with user-supplied information. Do NOT type the angle brackets.

{} Items within curly brackets are required. (Usually you must choose one of several options).

... A horizontal ellipsis indicates that the previous element may be repeated, or that elements have been omitted.

| A vertical bar means "or." For example, (YES | NO) means (YES or NO).

:: Means "is defined as."

Parameters

The following list of parameters will be used to define the functions and options of the LOGTOOL package. The

Command Descriptions section of this document makes constant reference to the terms defined here.

log list Specifies a list of log file ranges. All system log files are named "LOGxxxx" where "xxxx" is a 4-digit

number.

<log_list> ::= <log_range> | <log_range> , <log_list>

<log_range> ::= <log#> | <log#> / <log#>

<log#> ::= (Any 4 digit integer)

Example: LOG=1/5, 253/1004

file list Specifies a list of file names used as input or output to

LOGTOOL. LP can be specified if output is to be

directed to the system printer. All input and output files are assumed to be located in the diagnostic

directory (DIAG.SYS for MPE/iX)

<file_list> ::= <file_name> | <file_name> , <file_list>

<file_name> ::= Alpha-numeric text (starting with an alpha) |

Example: FILE=file1,file8,junk,work

type list The system error logs contain several different "types" of log records. These record types may be referred

to by a type number. (The LOGTOOL command TYPES gives the user a list of the types known to LOGTOOL.)

<type number range> ::= <type number> | <type number>/

<type number> ::= integer value

Example: TYPE=101, 104, 106

ldev list A list of logical names for devices.

<ldev_list> ::= <ldev> | <ldev> , <ldev_list>

<ldev> ::= (Any positive integer) (For MPE/iX)