Output Options

The following options affect the destination of the LOGANALYZER output or the form in which the output is presented. The destination of the LOGANALYZER output can also be affected by the CON, PRINTER, and REMOTE options in “Option List” earlier in this section. The format of the LOGANALYZER output can also be affected by the RAW option in Selection Options.

Syntax

<output options> 

──┬─ APPEND ─┬─┬─ " ──<file title>── " ────────────────────────┬───────┤
  ├─ CREATE ─┘ └─ ' ──<file title>── ' ────────────────────────┤
  ├─ DUMP ─────────────────────────────────────────────────────┤
  ├─ ESLFILE ─┬─ " ──<file title>── " ─┬─┬─────────────────────┤
  │           └─ ' ──<file title>── ' ─┘ ├─ " ──<comment>── " ─┤
  │                                      └─ ' ──<comment>── ' ─┤
  ├─<sort option>──────────────────────────────────────────────┤
  ├─ SORTSIZE ── = ──<integer>─────────────────────────────────┤
  └─ TRUNCATE ─┬─────────────┬─────────────────────────────────┘
               └─ <integer> ─┘

<sort option> 

──┬─ SORTED ───┬───────────────────────────────────────────────────────┤
  └─ UNSORTED ─┘

Explanation

The following text describes the meaning of each option:

APPEND

Places the log records selected for analysis at the end of an existing file with the title <file title>, instead of listing them. The records are added in the same order as they appear in the log file being analyzed. The resulting file has the same format as the system log file and can in turn be analyzed by LOGANALYZER. The APPEND option cannot be used to append records from logs of different machine types. The APPEND option cannot be used simultaneously with the ABORT or ERRORS option unless the UNSORTED option is also specified. The APPEND option cannot be used simultaneously with the SORTED option.

Notes:

  • If a file title is specified inside quotation marks, it is converted to uppercase. If, however, a file title containing quotation marks is surrounded by apostrophes, the string inside the quotation marks is not converted to uppercase, allowing special characters and lowercase letters to be specified.

  • If a RUN command is used to initiate LOGANALYZER, and the option list is enclosed in quotation marks, then a double set of quotation marks ("") is required to signify a single quotation mark ('') for embedded strings.

  • If the user has sufficient privilege to access security-related records from the SECURITYLOG, the output of APPEND contains merged records from the SUMLOG and the SECURITYLOG.

  • If LOGANALYZER is run under a usercode that has SECADMIN privilege, the output of APPEND is assigned the file attribute SECURITYADMIN.

CREATE

Places the log records selected for analysis in a new file with the title <file title>, instead of listing them. If a file with the specified <file title> already exists, an error is reported and LOGANALYZER terminates. The records are placed in the new file in the same order as they appear in the log file being analyzed.

The resultant file has the same format as the system log file and can in turn be analyzed by LOGANALYZER. The CREATE option cannot be used simultaneously with the ABORT or ERRORS option unless the UNSORTED option also is specified. The CREATE option cannot be used simultaneously with the SORTED option.

Notes:

  • If a file title is specified inside quotation marks, it will be converted to uppercase. If, however, a file title containing quotation marks is surrounded by apostrophes, the string inside the quotation marks will not be converted to uppercase, allowing special characters and lowercase letters to be specified.

  • If a RUN command is used to initiate LOGANALYZER, and the option list is enclosed in quotation marks, then a double set of quotation marks ("") is required to signify a single quotation mark ('') for embedded strings.

  • If the user has sufficient privilege to access security-related records from the SECURITYLOG, the output of CREATE contains merged records from the SUMLOG and the SECURITYLOG.

  • If LOGANALYZER is run under a usercode that has SECADMIN privilege, the output of CREATE is assigned the file attribute SECURITYADMIN.

DUMP

Dumps in hexadecimal form each specified log record selected by other LOGANALYZER options before listing the record in its analyzed form.

<sort option>

If you specify SORTED, lists the log entries sorted into order first by job number. If the request is for a directory, the result of the SORTED option is based on each SUMLOG file and not on the entire output.

If you specify UNSORTED, LOGANALYZER lists the log entries in chronological order.

You cannot use the SORTED and UNSORTED options together.

If you do not specify SORTED or UNSORTED, the sort option defaults to UNSORTED unless you also specify one of the following options, in which case the sort performed is as follows:

  • By default, the ABORT and ERRORS options set the SORTED option. You can override the setting by specifying the UNSORTED option. If you specify the UNSORTED option with the ABORT or ERRORS option, LOGANALYZER sorts the output into chronological order. In some cases, the output might be different from a sequential list of the log entries. For example, the output would be different if the time of day is set backwards during the time period being analyzed.

  • The APPEND and CREATE options implicitly set the UNSORTED option. You cannot override this value.

  • The MAINT option sets the sort option default to SORTED. You can override this value by assigning the UNSORTED option. For MAINT entries, the primary sort key is the unit number.

ESLFILE

When ESLFILE is specified, various entries are written to the ESL file. Each entry is associated with an IOP that could have multiple entries. Some of the entries have ESL data and some do not. For each IOP that has at least one entry with ESL data, there is a row in the table shown in the log analysis report. The row shows the IOP number, the total number of entries, and the number of entries that have ESL data. Only IOPs that have at least one entry with ESL data are shown.

An ESLFILE contains some Mainframe Hardware Report (Major Type 2, Subtype 23) entries that contain IOP error state information to a file for processing by internal Unisys hardware fault analysis programs.

The <file title> is the title of the output file. The suffix .SLG is appended to the file name if the file name is not already specified and if the length of the file name and of the final node of the name permits. The node containing .SLG is enclosed in quotation marks when the name is constructed.

The optional <comment> contains brief descriptive text (up to 60 characters) the user can supply. The comment is written to the output file.

Notes:

  • If a file title or comment is specified inside quotation marks, it is converted to uppercase. If, however, a file title containing quotation marks is enclosed by apostrophes, the string inside the quotation marks is not converted to uppercase, allowing special characters and lowercase letters to be specified.

  • If a RUN command is used to initiate LOGANALYZER and the option list is enclosed in quotation marks, then a double set of quotation marks ("") is required to signify a single quotation mark ('') for embedded strings.

  • The output is a stream file and is intended only for analysis by internal Unisys support programs.

SORTSIZE

Overrides the core size default value (25000) for the SORT.

TRUNCATE

Limits the number of lines of output produced for each log entry to the specified value. If no number is specified, a default value of 1 is used.

The identity information generated by the SHOWID selection option is not subject to truncation.

Note: When the TRUNCATE option is set, output lines that are wrapped due to the width of the display will be truncated.
Prev  Up  Next
Selection Options  Home  Input Examples