Selection options choose particular types of log entries for inclusion in the LOGANALYZER output.

<selection options>

──┬─ DATE ──────────────────────────────────────────┬──────────────────┤
  ├─ ALL ───────────────────────────────────────────┤
  ├─ FILTERED ──────────────────────────────────────┤
  ├─ RAW ───────────────────────────────────────────┤
  │ ┌◄────────────────────────────────────────────┐ │
  └─┴─┬─<configuration and maintenance options>─┬─┴─┘
      ├─<data comm options>─────────────────────┤
      ├─<diagnostics options>───────────────────┤
      ├─<job/task/session options>──────────────┤
      └─<additional selection options>──────────┘

The following text describes the meaning of each option.

Configuration and Maintenance Options

These options select log records related to the hardware and software configurations of the system and the problems that are encountered during operation.

<configuration and maintenance options>

──┬─ CLU ────────────────────────────────────────┬─────────────────────┤
  ├─ COD ────────────────────────────────────────┤
  ├─ CONFIG ─┬───────────────────────────────────┤
  │          └─ (EXT) ───────────────────────────┤
  ├─ CPUERROR ───────────────────────────────────┤
  ├─ ESR ────────────────────────────────────────┤
  ├─ HL ─────────────────────────────────────────┤
  ├─ IOSUMMARY ──────────────────────────────────┤
  ├─ TAPESERVER ─────────────────────────────────┤
  ├─ TS ─────────────────────────────────────────┤
  ├─ IOERROR ───┬─┬──────────────────────────────┤
  ├─ IOERRONLY ─┤ └─<device option>──────────────┤
  ├─ MAINT ─────┘                                │
  ├─ MAINFRAME ─┬─┬──────────────────────────────┤
  └─ MFERRONLY ─┘ └─<IOP selection and analysis>─┘

The following text describes the meaning of each option:

<device option>

The following diagram lists the many device options available.

  ┌◄─────────────────────────────────────┐
──┴─┬─ CPU ────────────────────────────┬─┴─────────────────────────────┤
    ├─ DECODEEXTRD ────────────────────┤
    ├─ DUMPEXTRD ──────────────────────┤
    │             ┌◄─────────────────┐ │
    ├───────────┬─┴─┬──────────────┬─┴─┘
    ├─ ARPS ────┤   └─<unit range>─┘
    ├─ CD ──────┤
    ├─ DC ──────┤
    ├─ DK ──────┤
    ├─ FPSAP ───┤
    ├─ HC ──────┤
    ├─ HY ──────┤
    ├─ LBP ─────┤
    ├─ LP ──────┤
    ├─ MT ──────┤
    ├─ NP ──────┤
    ├─ PK ──────┤
    ├─ SC ──────┤
    ├─ SPC ─────┤
    ├─ TSP ─────┤
    ├─ VC ──────┤
    └─ SERVICE ─┘

<unit range>

──<unit number>─┬────────────────────┬─────────────────────────────────┤
                └─ ─ ──<unit number>─┘

<unit number>

An integer that specifies the unit number to be analyzed, or the beginning or ending unit number of a range.

Explanation

If a <unit range> includes two <unit number>s separated by a hyphen, the range comprises all unit numbers between and inclusive of the two <unit number>s. A <unit range> of one <unit number> comprises only that <unit number>. When two <unit number>s are specified, the second number must be larger than the first.

For example, to specify the unit numbers 1, 2, 3, 4, 7, 8, 9, 12, you may use:

1-4 7-9 12

The device mnemonic definitions are as follows:

The DUMPEXTRD and DECODEEXTRD options affect the analysis of log entries for those device types that have extended status information or request sense information (for example, native SCSI devices). For all such devices except HYPERchannel devices, DUMPEXTRD displays a hexadecimal dump of the extended status information. DECODEEXTRD displays a formal analysis of the same information.

Expanded analysis for HYPERchannel devices is produced only if either DUMPEXTRD or DECODEEXTRD is used in conjunction with the MAINT HY option. Requesting the option DUMPEXTRD in conjunction with a MAINT HY request causes the message proper and sense bytes to be presented in raw format without description. For example, the “LOG MAINT HY DUMPEXTRD” request produces the following output in addition to the normal “LOG MAINT HY” output:

MESSAGE PROPER           :  <first 16 bytes of the message proper>
ADAPTER SENSE BYTES DATA : <adapter sense byte information>

If the option DECODEEXTRD is requested in conjunction with a MAINT HY request, the message proper and sense bytes are given expanded analysis.

<IOP selection and analysis>

The following diagram defines IOP selection and analysis.

── ( ──<IOP selection criteria>─┬───────────┬─ ) ──────────────────────┤
                                ├─ ESLTEXT ─┤
                                ├─ IOCB ────┤
                                └─ DETAIL ──┘

<IOP selection criteria>

──┬─ ERROR ─────┬─┬─ IOP ──<n>─┬───────────────────────────────────────┤
  ├─ INFO ──────┤ └─ EDN ──<n>─┘
  ├─ WARN ──────┤
  ├─ CONFIG ────┤
  ├─ TYPE ──<n>─┤
  └─ ALL ───────┘

Explanation

The <IOP selection criteria> is specific to IOP-related reports only and allows selection by generic report category, such as ERROR, INFO, CONFIG, WARN, or a specific TYPE, and for a specific IOP or EDN. The selection is based on “type” and “device <n>”, if both are specified.

The use of MFERRONLY is equivalent to MAINFRAME(ERROR).

IOP-generated reports include an Event Notification type that describes the general characteristics of this report. These reports include the following TYPEs:

ERROR selection includes MCP-generated IOP fault reports and IOP Event reports of TYPES 1, 3, 5, 6, and any nonclassified (new or unknown) type, plus types included with WARN.

INFO selection includes IOP Event reports of TYPEs 7, 8, and any nonclassified (new or unknown) type, plus types included with WARN and CONFIG.

CONFIG selection includes IOP Event reports of TYPE 10.

The analysis of an IOP mainframe report is determined by the type of report and the selection of report content, ESLTEXT, IOCB, or DETAIL. By default, the analysis includes the Reporting Unit, the associated External Device number (if non-zero), and the analysis of the specific event or error including description and possible sources.

The report selection options provide the following information:

Examples

The following examples show the use of the MAINFRAME and MFERRONLY commands.

Data Comm Options

The following options select log records that are related to data communications:

Syntax

<data comm option>

──┬─ BNA ──────────────────────────────────────────────────────────────┤
  ├─ BNAV2 ──────────────────────────────┬─────────────────────────────┤
  ├─ CIA ─┬──────────────────────────────┤
  │       │     ┌◄─────────────────┐     │
  │       └─ ( ─┴─┬─ ALL ────────┬─┴─ ) ─┤
  │               ├─ INIT ───────┤       │
  │               ├─ ACP ────────┤       │
  │               ├─ IFE ────────┤       │
  │               ├─ NODE ───────┤       │
  │               ├─ DIALOG ─────┤       │
  │               ├─ BUFFERPOOL ─┤       │
  │               ├─ POOLMGR ────┤       │
  │               ├─ SYSQUEUES ──┤       │
  │               └─ MISC ───────┘       │
  ├─ CNS ─┬──────────────────────────────┤
  │       ├─ NPSM ───────────────────────┤
  │       ├─ GS ─────────────────────────┤
  │       ├─ LCF ────────────────────────┤
  │       ├─ TSMM ───────────────────────┤
  │       └─ LSS ────────────────────────┤
  ├─ COMS ─┬─────────────────────────────┤
  │        ├─ CONFIG ────────────────────┤
  │        ├─ WINDOW ────────────────────┤
  │        └─ EVENTS ────────────────────┤
  ├─ IDC ────────────────────────────────┤
  ├─ LPP ─┬──────────────────────────────┤
  │       ├─ PIM ────────────────────────┤
  │       ├─ PIE ────────────────────────┤
  │       ├─ MGR ────────────────────────┤
  │       ├─ OI ─────────────────────────┤
  │       └─ OTHER ──────────────────────┤
  ├─ MCS ────────────────────────────────┤
  ├─ NMS ─┬──────────────────────────────┤
  │       │     ┌◄────────────┐          │
  │       └─ ( ─┴─┬─ LCF ───┬─┴─ ) ──────┤
  │               ├─ SNMP ──┤            │
  │               └─ OTHER ─┘            │
  ├─ NSP ────────────────────────────────┤
  ├─ NW ─────────────────────────────────┤
  ├─ NWS ────────────────────────────────┤
  ├─ RSS ────────────────────────────────┤
  ├─ SNA ─┬──────────────────────────────┤
  │       ├─ REPORT ─────────────────────┤
  │       ├─ TRACE ──────────────────────┤
  │       ├─ ERROR ──────────────────────┤
  │       ├─ INQUIRY ────────────────────┤
  │       ├─ COMMAND ────────────────────┤
  │       └─ OTHER ──────────────────────┤
  ├─ SSH ────────────────────────────────┤
  ├─ SSHCLIENT ──────────────────────────┤                           
  └─ SSHSUPPORT ─────────────────────────┤                           
  │                                      │
  └─ TCPIP ─┬────────────────────────────┤
            │     ┌◄───────────────┐     │
            └─ ( ─┴─┬─ ARP ──────┬─┴─ ) ─┘
                    ├─ AUTOCONF ─┤
                    ├─ DHCP ─────┤ 
                    ├─ DNS ──────┤
                    ├─ ICMP ─────┤
                    ├─ IP ───────┤
                    ├─ IPSEC ────┤
                    ├─ IPTABLE───┤
                    ├─ MLD ──────┤
                    ├─ MSS ──────┤
                    ├─ ND ───────┤
                    ├─ PATHMTU ──┤
                    ├─ PIM ──────┤
                    ├─ RESILIENCY┤
                    ├─ RIP ──────┤
                    ├─ SECURITY ─┤
                    ├─ SNMP ─────┤
                    ├─ SSH ──────┤
                    ├─ SSL ──────┤
                    ├─ TCP ──────┤
                    ├─ TCPMGR ───┤
                    ├─ UDP ──────┤
                    └─ OTHER ────┘

Explanation

The following text describes the meaning of each option:

BNA

Lists Network Debug records.

BNAV2

Lists all BNA Version 2 log records. Analysis of BNA Version 2 records requires that the CNS translation library, CNSTRANSLATION be specified using the SL (Support Library) system command.

CIA

Lists the records reporting ClearPath Intraconnect Architecture (CIA) events. .

CNS

Lists all CNS (Core Networking Services) records. Analysis of CNS records requires that the CNS translation library, CNSTRANSLATION, be specified using the SL (Support Library) system command. .

COMS

Lists the COMS records.

IDC

Lists the IDC and ID records.

LPP

Lists the local port provider (LPP) records.

MCS

Lists all MCS log records.

NMS

Lists all nondiagnostic commands, responses, and reports generated for Network Management.

NSP

Lists all data comm log records.

NW

Lists BNAV2, CNS, NMS, SNA and TCP/IP log records.

NWS

Lists all the NetWare Services (NWS) log records.

RSS

Lists all log records from the Reliable Session Service (RSS).

SNA

Lists all nondiagnostic commands, responses, and reports generated for Systems Network Architecture (SNA).

SSH

SSHSUPPORT

Lists connection open and close, channel open, and request and close entries generated by SSHSUPPORT.

SSHCLIENT

Lists outgoing connection open and close, channel open, request and close entries generated by SSH clients.

TCPIP

Lists all nondiagnostic commands, responses, and reports generated by the TCP/IP network provider.

Diagnostics Options

These options select log records created by diagnostics options of various system software products.

Syntax

── DIAGNOSTICS ────────────────────────────────────────────────────────►
►─┬────────────────────────────────────────────────────────────────┬───┤
  └─ ( ─┬─ ALL ──────────────────────────────────────────────┬─ ) ─┘
        │ ┌◄───────────────────────────────────────────────┐ │
        └─┴─┬─ /1\ ── BNAV2 ──────┬─┬────────────────────┬─┴─┘
            ├─ /1\ ── CCF ────────┤ └─<selection option>─┘
            ├─ /1\ ── CNS ────────┤
            ├─ /1\ ── COMS ───────┤
            ├─ /1\ ── CONN ───────┤
            ├─ /1\ ── DIR ────────┤
            ├─ /1\ ── DSS ────────┤
            ├─ /1\ ── DTP ────────┤
            ├─ /1\ ── GRAPHS ─────┤
            ├─ /1\ ── GSS ────────┤
            ├─ /1\ ── JAVA ───────┤
            ├─ /1\ ── KMAPI ──────┤
            ├─ /1\ ── KRB ────────┤
            ├─ /1\ ── LIB ────────┤
            ├─ /1\ ── LPP ────────┤
            ├─ /1\ ── MCAPI ──────┤
            ├─ /1\ ── MFA ────────┤
            ├─ /1\ ── MHS ────────┤
            ├─ /1\ ── MQS ────────┤
            ├─ /1\ ── NIS ────────┤
            ├─ /1\ ── NMS ────────┤
            ├─ /1\ ── NPS ────────┤
            ├─ /1\ ── NWS ────────┤
            ├─ /1\ ── ONC ────────┤
            ├─ /1\ ── OSI ────────┤
            ├─ /1\ ── PIO ────────┤
            ├─ /1\ ── PS ─────────┤
            ├─ /1\ ── RBAC ───────┤
            ├─ /1\ ── RUNX ───────┤
            ├─ /1\ ── SCL ────────┤
            ├─ /1\ ── SNA ────────┤
            ├─ /1\ ── SSHCLIENT ──┤
            ├─ /1\ ── SSHSUPPORT ─┤
            ├─ /1\ ── TCPIP ──────┤
            ├─ /1\ ── TELNET ─────┤
            ├─ /1\ ── TPV ────────┤
            ├─ /1\ ── UMSG ───────┤
            ├─ /1\ ── VCON ───────┤
            ├─ /1\ ── WIN ────────┤
            └─ /1\ ── WLM ────────┘

<selection option>

──┬───────────────────────────────────┬────────────────────────────────┤
  └─ ( ─┬─ ALL ─────────────────┬─ ) ─┘
        │ ┌◄──────────────────┐ │
        └─┴─<Keyword Subtype>─┴─┘

Explanation

To retrieve all diagnostics options, specify DIAGNOSTICS without including any options.

To limit the search to specific subsets of the diagnostic records, include a subtype option. The DIAGNOSTICS options each correspond to minor types and subtypes of the Major Type 19 (Diagnostics) log entry.

The subtype options, such as the <DSS subtypes>, limit the search to specific subsets of the diagnostic records logged for each minor type. Each keyword can be followed by: nothing, ALL, or <keyword subtypes>. For a list of the possible subtypes for each minor type, refer to the discussion of the Diagnostics Record (Major Type 19) in the System Log Programming Reference Manual.

In that discussion, each subtype corresponds to a JOBFORMATTER define name. The last part of each JOBFORMATTER define is the same as the corresponding LOGANALYZER subtype. For example, the SUMLOG discussion lists a define called LOGDIAG_DSS_FTP under the DSS minor type. To request that LOGANALYZER report on this subtype, specify DIAGNOSTICS (DSS (FTP)).

The following are the minor types corresponding to each DIAGNOSTICS option:

DIAGNOSTICS Examples shows examples of ways you can combine DIAGNOSTICS options for various effects.

Job, Task, and Session Options

The following options select log records for a job, task, or session activity.

The job, task, and session options use the following logic to select log records for listing:

Syntax

<job/task/session options>

──┬─ ABORT ───────────────────────────────────┬────────────────────────┤
  ├─ BOJ ─────────────────────────────────────┤
  ├─ BOT ─────────────────────────────────────┤
  ├─ CONTROLCARD ─────────────────────────────┤
  ├─ DCKEY ───────────────────────────────────┤
  ├─ DMS ──┬──────────────────────────────────┤
  │        └─ ( ──<DMS option list>── ) ──────┤
  ├─ EOJ ─────────────────────────────────────┤
  ├─ EOT ─────────────────────────────────────┤
  ├─ ERRORS ──────────────────────────────────┤
  ├─ FILE ─┬──────────────────────────────────┤
  │        ├─ VSS2 ───────────────────────────┤
  │        └─ VSS3 ───────────────────────────┤
  ├─ FTP ─────────────────────────────────────┤
  ├─/1\─┬─ IDENTITY ──<number range>──────────┤
  │     ├─ MIX ──<number range>───────────────┤
  │     ├─ STATUS ────────────────────────────┤
  │     └─ TASK ─┬─ " ──<name>─┬──────┬─ " ───┤
  │              │             └─ /= ─┘       │
  │              └─<number range>─────────────┤
  ├─ IO ──────────────────────────────────────┤
  ├─ INT ─────────────────────────────────────┤
  ├─/1\─┬─ JOB ─┬─ " ─┬─<name>─┬──────┬─┬─ " ─┤
  │     │       ├─ ' ─┘        ├─ /= ─┤ └─ ' ─┤
  │     │       │              └─ = ──┘       │
  │     │       └─<number range>──────────────┤
  │     └─ SESSION ──<number range>───────────┤
  ├─ LIB ─────────────────────────────────────┤
  ├─ MPID ── " ──<name>── " ──────────────────┤
  ├─ PRINTS ─┬────────────────────────────────┤
  │          ├───────────┬─<number range>─────┤
  │          ├─ REQUEST ─┘                    │
  │          └─ JOB ──<number range>──────────┤
  └─ STACK ──<hex stack number range>─────────┘

<DMS option list>

  ┌◄──────────────────────────────────────┐
 ─┴─┬─/1\── DATABASE =  <database name>─┬─┴────────────────────────┤
    │─/1\── SECURITY────────────────────┤
    ├─/1\── ACCESS ─────────────────────┤                                 
    ├─/1\── OPEN────────────────────────┤
    ├─/1\── CLOSE───────────────────────┤
    ├─/1\── FREEZE──────────────────────┤
    ├─/1\── RESUME──────────────────────┤
    └─/1\── DEADLOCK────────────────────┘

<database name>

──┬─ " ──<file title>── " ────┬────────────────────────────────────────┤
  └─ ' ──<file title>── ' ────┘

<number range>

  ┌◄───────────┬──────┬────────────┐
  │            └◄─ , ─┘            │
──┴─<number>─┬───────────────────┬─┴───────────────────────────────────┤
             ├─ THRU ─┬─<number>─┘
             └─ ─ ────┘

<hex stack number range>

  ┌◄────────────────── , ──────────────────┐
──┴─<hex number>─┬───────────────────────┬─┴───────────────────────────┤
                 ├─ THRU ─┬─<hex number>─┘
                 └─ ─ ────┘

Explanation

The following text describes the meaning of each option:

ABORT

Lists the records associated with tasks that were terminated abnormally with a DS or QT command. By default, LOGANALYZER reports the output from the ABORT option in sorted order; therefore, you cannot use it with the CREATE or APPEND options. You can use the ABORT option with the UNSORTED option to produce output in chronological order. You can use the CREATE and APPEND options with the UNSORTED option.

BOJ

Lists the beginning of job records.

BOT

Lists the beginning of job and beginning of task records.

CONTROLCARD

Lists the records created when a job file is locked by the WFL compiler. The record identifies the job number that will be used and the name of the source jobsymbol file if available, or the program that used a ZIP WITH ARRAY construct.

DCKEY

Lists the DCKEYIN commands submitted by the task.

DMS

If an option list is omitted or contains just a DATABASE option, all DMS record types are analyzed.

The following are sub-options of the DMS option:

EOJ

Lists the end of job records.

EOT

Lists the end of job and end of task records.

ERRORS

Lists the records associated with compiler tasks that terminated with syntax errors. By default, LOGANALYZER reports the output from the ERRORS option in sorted order; therefore, you cannot use it with the APPEND or CREATE options. However, you can use the ERRORS option with the UNSORTED option to produce output in chronological order. You can use the CREATE and APPEND options with the UNSORTED option.

FILE

Lists the following records: file OPEN, CLOSE, and INTERVAL; port activity; file status entries; and NetWare Services (NWS) open and close file entries.

The FILE option has two mutually-exclusive optional parameters, VSS2 and VSS3, which limit the report to CLOSE records. When one of the parameters is specified, only the information that is appropriate for determining VSS-2 or VSS-3 migration requirements is displayed. You can use these records to determine if the file attributes support logical-physical alignment for storage on a VSS-2 or VSS-3 disk, respectively.

FTP

Lists records associated with FTP sessions where an FTP session is defined to be a single connection between an FTP Client and an FTP Server.

IDENTITY

Lists identity records. The system writes identity records into the log to indicate what mix number or session number was assigned to a given job, task, or session, to indicate when the name of a job, task, or session changed, and to indicate when a job, task, or session terminated.

The following are identity records:

IDENTITY <number range> lists the identity records associated with the specified mix numbers.

The IDENTITY option cannot be used simultaneously with the MIX or TASK options.

IO

Lists the file OPEN, CLOSE, INTERVAL, and port activity records.

INT

Lists task interval records.

JOB

Lists the records associated with the specified job and its tasks.

JOB “<name>” lists the records for the job whose BEGIN JOB statement contains the specified <name>. The <name> parameter uses the same format as a file title.

JOB “<name>/=” lists all jobs whose high-level identifier matches the specified <name>. The comparison is like a file title tested for membership in a file directory. For example, JOB (ME)TOO/= selects jobs named (ME)TOO/A or (ME)TOO/B, but not (ME)TOO.

A name parameter can consist of either a "<string>" construct or a '"<string>"' construct. JOB ""<string>"" lists the records associated with the job whose job name matches the specified string. Use the '"<string>"' format to specify a job name that includes lowercase letters that should remain lowercased.

For example, the following command lists the records for the BEGIN JOB "MY JOB" statement:

LOG JOB ""MY JOB""

The following command lists the records for the BEGIN JOB "My Job" statement:

LOG JOB '"My Job"'

Lowercased characters that are not included within the '"<string>"' format are automatically uppercased. The case can occur where LOGANALYZER will not be able to find a job that includes lowercase characters in the name because the characters have been uppercased.

In general, you should classify jobs with names that have embedded blanks as strings rather than as file names. This rule applies to a number of system commands (or DCKEYIN) commands. For example, to list the log records of a RB ON MYPACK system command, use the following command:

LOG JOB ""RB ON MYPACK""

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

For example, the command

RUN *SYSTEM/LOGANALYZER ("JOB """"MY JOB""""");

is equivalent to

LOG JOB ""MY JOB"";

The command

RUN *SYSTEM/LOGANALYZER ("JOB '""My Job""'");

is equivalent to

LOG JOB '"My Job"';

JOB <number range> lists the records for jobs with the specified job numbers. The listed records include log entries created by the print system when processing print requests for the specified mix number or numbers.

The JOB option cannot be used simultaneously with the SESSION option.

LIB

Lists the library LINK, DELINK, FREEZE, READY, RESUME, and UNREADY records.

MIX

MIX <number range> lists the records associated with the specified mix numbers. A mix number of zero (0) lists all log records that have no associated mix numbers (for example, configuration records).

The MIX option cannot be used simultaneously with the IDENTITY or TASK options.

MPID

The MPID option lists the records associated with jobs and tasks that ran with the specified MPID attribute. The <name> parameter uses the same format as the MPID attribute.

The MPID option can be used in conjunction with the JOB and TASK options.

PRINTS

Lists the records that are created by the print system.

PRINTS <number range> lists the printing entries that are logged for the specified print request numbers. The REQ option is the default option.

PRINTS JOB <number range> lists the printing entries that are logged for the specified job numbers.

SESSION

SESSION <number range> lists the records associated with the specified mix numbers. The SESSION option cannot be used simultaneously with the JOB option.

STACK

STACK <hex stack number range> lists the records from programs that have used the specified stack numbers. The hexadecimal stack number identifies the internal process, but it is not as unique as a mix number. Log entries for BOJ, BOT, EOJ, and EOT contain stack numbers. Because some software structures use stack numbers internally (events, for example), the STACK option can be useful for identifying the process involved.

STATUS

Lists the records that are generated for certain task events. When a program takes a program dump or uses the SORT intrinsic, the system logs a status entry that contains the resources used for that activity. If a program is suspended (for example, on a no-file condition or if disk space is needed), the system logs a status entry that contains the elapsed time that the program waited.

TASK

TASK “<name>” lists the records associated with the specified task name. The <name> parameter uses the same format as a file title.

TASK “<name>/=” lists all jobs whose high-level identifier matches the specified <name>. The comparison is like a file title tested for membership in a file directory. For example, TASK “(ME)TOO/=” lists tasks named (ME)TOO/A or (ME)TOO/B, but not (ME)TOO.

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

For example, the command

RUN *SYSTEM/LOGANALYZER ("TASK """"MY TASK""""");

is equivalent to

LOG TASK ""MY TASK"";

The command

RUN *SYSTEM/LOGANALYZER ("TASK '""My Task""'");

is equivalent to

LOG TASK '"My Task"';

TASK <number range> lists the records for tasks with the specified mix numbers. A mix number of zero (0) lists all log records that have no associated mix numbers (for example, configuration records).

The TASK option cannot be used simultaneously with the IDENTITY or MIX options.

Additional Selection Options

The following options list various types of log entries.

Syntax

<additional selection options>

                                ┌◄────── , ──────────┐
──┬─/1\────┬───── AC ─────┬─────┴─<code identifier>──┴─────────┬──────────────┤
  │        └─ ACCESSCODE ─┘                                    │              
  ├─ ADD ──────┬─ ( ──<major number>── , ──<minor number>── ) ─┤
  ├─ SUBTRACT ─┘                                               │
  ├─ ASSISTANT ─┬──────────────────────────────────────────────┤
  │             └─ ( ──<Assistant option list>── ) ────────────┤
  │                              ┌◄────── , ──────────┐        │
  ├─/1\───┬───── CC ─────┬───────┴─<code identifier>──┴────────┤
  │       └─ CHARGECODE ─┘                                     │
  ├─ COMMENT ──────────────────────────────────────────────────┤
  ├─ DEIMPLEMENTATION ─────────────────────────────────────────┤
  ├─ DISCARD ──────────────────────────────────────────────────┤
  ├─ DRC ──────────────────────────────────────────────────────┤
  ├─ EPORTAL ──┬───────────────────────────────────────────────┤
  │            └── ( ──<ePortal option list>── ) ──────────────┤
  ├─ FIND ──<find expression>──────────────────────────────────┤
  ├─ INST───────────┬──────────────────────────────────────────┤
  ├─ INSTALLATION ──┘                                          │
  ├─ KERBEROS ─────────────────────────────────────────────────┤
  ├─ MFA ─┬────────────────────────────────────────────────────┤
  │       └─ ( ──<MFA option list>── ) ────────────────────────┤
  ├─ MIT ─┬────────────────────────────────────────────────────┤
  │       ├─ INDEX ──<MIT index>───────────────────────────────┤
  │       ├─ SERIAL ──<serial number>──────────────────────────┤
  │       ├─ UNIT ─┬─<unit number>─────────────────────────────┤
  │       └─ PK ───┘                                           │
  ├─ MSG ──────────────────────────────────────────────────────┤
  ├─ MSGNW ─┬──────────────────────────────────────────────────┤
  │         └─ ( ──<network list>── ) ─────────────────────────┤
  ├─ OPERATOR ─┬─────────┬─┬───────────────────────────────────┤
  │            ├─ TEXT ──┤ │ ┌◄───────┐                        │
  │            └─ IDENT ─┘ └─┴─<type>─┴────────────────────────┤
  ├─ RBAC ─────────────────────────────────────────────────────┤
  │          ┌◄────────────────┐                               │
  ├─ RESULT ─┴─┬─ SUCCESS ───┬─┴───────────────────────────────┤
  │            ├─ FAILURE ───┤                                 │
  │            ├─ RELEVANT ──┤                                 │
  │            └─ VIOLATION ─┘                                 │
  ├─ SECURITY─┬────────────────────────────────────────────────┤
  │           └─ ( ──<security option list>── ) ───────────────┤
  ├─ SHOWID ───────────────────────────────────────────────────┤
  ├─ TL────────────────────────────────────────────────────────┤
  ├─ TIME ─────────────────────────────────────────────────────┤
  ├─ TPV───────────────────────────────────────────────────────┤
  ├─ UNKNOWN ──────────────────────────────────────────────────┤
  │                             ┌◄────── , ──────────┐         │
  ├─/1\────┬──── UC ────┬───────┴─<code identifier>──┴─────────┤
  │        └─ USERCODE ─┘                                      │
  ├─ USERDATA ─────────────────────────────────────────────────┤
  ├─ VOLUMES ──────────────────────────────────────────────────┤
  └─ WLM ──────────────────────────────────────────────────────┘

<Assistant option list>

──┬───────────────────────┬─┬─ ALL ─────────────────────┬──────────────┤
  ├─ ID ─┬─────┬─<string>─┘ │ ┌◄─────────────┐          │
  │      └─ = ─┘            └─┴─┬─ ERRORS ─┬─┴─┬────────┐
  │                             ├─ API ────┤   └─ ONLY ─┤
  │                             ├─ CONFIG ─┤            │
  │                             └─ EVENTS ─┘            │
  └─ ID ─┬─────┬─<string>───────────────────────────────┘
         └─ = ─┘

<find expression>

         ┌◄────┬───────┬──────┬─ AND ─┬──────────────────────┐
         │     └─ NOT ─┘      └─ OR ──┘                      │
── FIND ─┴/100\─── " ──<wild-card string>── " ─┬───────────┬─┴─────────┤
                                               └─ UNCASED ─┘

<ePortal option list>

  ┌◄───────────────────────┐
──┴─┬─/1\── ALL ─────────┬─┴────────────────────────────────────────────┤
    ├─/1\── APPLICATION ─┤
    ├─/1\── SECURITY ────┤
    └─/1\── SYSTEM ──────┘
  

<code identifier>

──┬─<simple name>─┬────────────────────────────────────────────────────┤
  ├─ . ───────────┤
  ├─ * ───────────┤
  └─ = ───────────┘

<MFA option list>

  ┌◄─────────────────────┐
──┴─┬─/1\── ALL ───────┬─┴────────────────────────────────────────────┤
    └─/1\── AUTH ──────┘

<MIT option selection>

──┬───────────────────────────┬────────────────────────────────────────┤
  ├─ INDEX ──<MIT index>──────┤
  ├─ SERIAL ──<serial number>─┤
  ├─ UNIT ─┬─<unit number>────┘
  └─ PK ───┘

<network list>

──┬─────────┬──────────────────────────────────────────────────────────┤
  ├─ BNAV2 ─┤
  ├─ CNS ───┤
  ├─ NMS ───┤
  ├─ SNA ───┤
  └─ TCPIP ─┘

<security option list>

  ┌◄───────────────────────┐
──┴─┬─/1\── ALL ─────────┬─┴────────────────────────────────────────────┤
    ├─/1\── KEYMGMT ─────┤
    ├─/1\── NXSERVICES ──┤
    ├─/1\── RUNX ────────┤
    ├─/1\── SCERRORS ────┤
    ├─/1\── VIOLATIONS ──┤
    └─/1\── WARN ────────┘
  

Explanation

The following text describes the meaning of each option:

ACCESSCODE

AC

Lists entries associated with the specified code identifiers. The ACCESSCODE option requires the IGSDASUPPORT library and either the Secure Access Control Module or the Secure Accountability Facility.

AC is a synonym for ACCESSCODE.

To list entries with no accesscode specification, use an asterisk (*) as the code identifier. To list entries with the accesscode of the LOGANALYZER process, specify an equals sign (=) as the code identifier. The accesscode is not interrogated for entry selection if a period (.) is specified as the code identifier. If ACCESSCODE is specified in combination with CHARGECODE, RESULT, and/or USERCODE, only the records that contain all the specified options are selected. If ACCESSCODE is used together with ALL, then all entries with the specified accesscode and all public records are selected. Public records include all maintenance and halt/load records.

ADD

Use ADD to request that LOGANALYZER analyze a specific type of record. You specify the type of record by specifying the number for the Major type and the number for the Minor type of record. Refer to System Log Programming Reference Manual for more detailed information. The following example would cause LOGANALYZER to analyze all records containing non-MLS (MultiLingual System) messages. You can use ADD multiple times to select a number of different types of records.

ADD (3, 4)

ASSISTANT

Lists entries associated with System Assistant. If a program identity (ID) is not specified, the program identity of ASSIST is used. The <string> is unquoted, must be 17 characters or less, and consist of only alphanumeric characters.

If you do not specify an option list for Assistant, the default set of entries are selected for analysis. The default set consists of entries dealing with one of the following:

The ALL option lists all Major Type 34 (ASSISTANT) entries and all message entries associated with the identity <ID>.

The API option selects the commands and responses requested via the Assistant Programmatic Interface. These entries are included in the default entries set. Using the ONLY option allows exclusive selection of these entries from the default set.

The CONFIG option selects the entries containing Hardware, Software, or Switch configuration references, in addition to the default entries set.

The EVENTS option selects entries containing responses generated by Assistant's MONITOR or TRACE facilities, in addition to the default entries set. MONITOR entries appear only if the LOGMONITOR option is set when running Assistant. TRACE log entries are generated to record basic Assistant events only when Assistant's TRACE option is reset; otherwise, the data is recorded in the printer backup file created by the Assistant trace facility.

The ONLY option selects only the CONFIG, API, ERRORS, or EVENTS entries, or any combination specified. Message entries are not included unless specifically requested.

If there are no message entries associated with the identity, but other log entries are analyzed, LOGANALYZER will show the following termination message:

NO ASSISTANT MESSAGE ENTRIES WITH IDENTITY '<id>' FOUND.

CHARGECODE

CC

Lists entries associated with the specified code identifiers. A chargecode is a sequence of names separated by slashes (/). The length of a chargecode, including slashes, cannot exceed 60 characters. The CHARGECODE option requires the IGSDASUPPORT library and either the Secure Access Control Module or the Secure Accountability Facility.

CC is a synonym for CHARGECODE.

To list entries with no chargecode specification, use an asterisk (*) as the code identifier. To list entries with the chargecode of the LOGANALYZER process, specify an equals sign (=) as the code identifier. The chargecode is not interrogated for entry selection if a period (.) is specified as the code identifier. If CHARGECODE is specified in combination with ACCESSCODE, RESULT, and/or USERCODE, only the records that contain all the specified options are selected. If CHARGECODE is used together with ALL, then all entries with the specified chargecode and all public records are selected. Public records include all maintenance and halt/load records.

COMMENT

Lists all comments entered into SUMLOG by means of the LC (Log Comment) and LJ (Log to Job) system commands. Refer to the System Commands Reference Manual for information on the LC and LJ commands.

DEIMPLEMENTATION

Lists the deimplementation warnings generated by the operating system with the associated mix number and task identification.

DISCARD

Lists records of discarded periods and entries within the log file.

DRC

Causes all disk resource control system entries to be listed. These entries include USERDATA record overflow, userdata error, and invalid family name in the familylist entry.

EPORTAL

Lists System, Application, and Security entries generated by ePortal.

If an ePortal option list is specified, only the ePortal records for that type are shown.

FIND

Limits the output to those log entries that satisfy the tokens specified in the find expression.

The find expression consists of a number of <wild-card string>s concatenated with AND and OR boolean operators. All but the first <wild-card string> can be preceded by the NOT operator.

The <wild-card string> can include two types of wild-card characters: question marks (?) and equal signs (=). A question mark matches any single character, and an equal sign matches any sequence of characters.

The boolean operators are applied in precedence order with the NOT operator having highest precedence and the OR operator having lowest precedence.

For example, the phrase

"A" AND "B" OR NOT "C" AND "D" OR "E" 

is evaluated as

("A" AND "B") OR (NOT "C" AND "D") OR "E"   

You should begin and end the <wild-card string> with equal signs, even if the <wild-card string> consists of complete tokens. For example, to find the phrase "INVALID DESTINATION", specify the following:

FIND "=INVALID DESTINATION="      

If you want the token match to ignore casing, you should use UNCASED after the <wild-card string>, otherwise a case-sensitive match is performed. You must specify UNCASED after all <wild-card string>s that are to be used in case-insensitive matches.

You cannot use the FIND option simultaneously with the APPEND or CREATE options.

INST

INSTALLATION

Selects site defined installation log entries for analysis. If the SITESUPPORT library is not present or the PINSTALLATION function of the SITESUPPORT library indicates that the log entry is not analyzed, the log entry is dumped in hexadecimal form.

KERBEROS

Selects log records associated with Kerberos. These log records contain:

MFA

Lists multi-factor authentication entries.

MIT

Gives summary information for each MIRROR1 (MIT image entry) and MIRROR2 (MIT change entry) log record. If a MIT request is qualified with a MIT selection option, only MIRROR2 entries for the specified INDEX, SERIAL, or UNIT number are displayed as output.

MSG

Lists all system messages and the mix numbers associated with these messages. The list includes operator entries as listed by the OPERATOR option.

If a message is displayed by a library entrypoint that has been called from a program, the text will show “FROM <mix number>,” meaning that a procedure in the library <mix number> performed the display while being called by another program.

MSGNW

The MSGNW selection option analyzes network messages in a brief format, suppressing the network header analysis. The brief analysis is applied to any BNAV2, CNS, NMS, SNA, and TCP/IP messages. The entries selected for analysis are those that correspond to messages that might appear in the response to an MSG NW (Network Messages) system command.

MSGNW (<network list>)

If the MSGNW selection option includes a network list, only those messages originating from the selected networks are analyzed in a brief format. If entries for an unselected network are requested through a network selection option, all entries from that network are analyzed in the full format.

OPERATOR

Lists all SETSTATUS commands entered either by operator inputs or by programmatic calls. When OPERATOR is used with one or more type specifications, only log entries for the corresponding system commands are listed. Each type is a system command mnemonic, such as DS, MP, OK or PG. Most system commands that change the system state are allowed types. PS is a valid type and lists log entries that are associated only with print system commands that have caused a change in the print system. System commands that are inquiries but do not change the system state, such as PER, cannot be used as types. Refer to the System Commands Reference Manual for all the system commands and their mnemonics.

Use the TEXT or the IDENT modifier, or both, immediately after the OPERATOR option to display information in addition to that resulting from the system's interpretation of the command. Use the TEXT modifier to display the actual text input by the operator. Use the IDENT modifier to display additional identity information about the origin of the command, for example usercode, station name, and LSN.

RBAC

Lists entries associated with the successful completion of administrator procedures in the RBACSUPPORT library.

RESULT

Reports are created based on the results of the actions logged. These results can be any combination of successful actions, failed actions, security-relevant actions, and security violations. The results to be reported are specified by entering any combination of SUCCESS, FAILURE, RELEVANT, and VIOLATION.

Result reports for RELEVANT include actions on the USERDATAFILE, use of the system ??SECAD primitive and SECOPT commands, and attachments of guard files to files.

If RESULT is specified with ACCESSCODE, CHARGECODE, and/or USERCODE, only the records that contain all the specified options are selected.

The RESULT option requires the IGSDASUPPORT library and either the Secure Access Control Module or the Secure Accountability Facility.

SECURITY

Lists security records. Only a privileged user or security administrator can use the SECURITY option.

If a security option list is specified, only the SECURITY records for that type are shown. If no security option list is specified, VIOLATIONS are shown.

SHOWID

Includes identity information in the analysis. The information includes the usercode, accesscode, and chargecode of the process that generated the record. The information is included regardless of the TRUNCATE setting.

SUBTRACT

Use SUBTRACT to request that LOGANALYZER not analyze a specific type of record. You specify the type of record by specifying the number for the Major type and the number for the Minor type of the record. Refer to System Log Programming Reference Manual for more detailed information. The following example would cause LOGANALYZER to analyze all message records except non-MLS messages.

MSG SUBTRACT (3, 4)

You can use SUBTRACT multiple times to de-select a number of different types of records. 

TL

Lists the log transfer log entries. These entries include automatic and manual log transfers, change of DL LOG, and the count of records discarded when space is not available.

TIME

Lists records generated for clock drift and time correction adjustments.

TPV

Lists entries associated with third-party vendor products.

UNKNOWN

Lists a hexadecimal dump of all SUMLOG records with major and minor types that LOGANALYZER does not recognize.

USERCODE UC

Lists entries associated with the specified code identifiers. The USERCODE option requires the IGSDASUPPORT library and either the Secure Access Control Module or the Secure Accountability Facility.

UC is a synonym for USERCODE.

To list entries with no USERCODE specification, use an asterisk (*) as the code identifier. To list entries with the USERCODE of the LOGANALYZER process, specify an equals sign (=) as the code identifier. The USERCODE is not interrogated for entry selection if a period (.) is specified as the code identifier. If USERCODE is specified in combination with CHARGECODE, RESULT, and/or ACCESSCODE, only the records that contain all the specified options are selected. If USERCODE is used together with ALL, then all entries with the specified USERCODE and all public records are selected. Public records include all maintenance and halt/load records.

If LOGANALYZER has no direct read access to the analyzed SUMLOG file, the only valid <code identifier> is the USERCODE of the LOGANALYZER process; otherwise, any value is valid. For a discussion of direct read access, refer to the information about understanding log access security in the System Log Programming Reference Manual.

USERDATA

Lists USERDATA records. USERDATA records are records that describe the installation of a *SYSTEM/USERDATAFILE or changes to that file.

VOLUMES

Analyzes all the CD-ROM, disk, and tape volume status records generated by the system when a CD-ROM, disk, or tape volume comes online or goes offline; when a tape volume is purged by either the PG or SN system command; or when the first file on a tape volume is overwritten by a new file.

For disk volumes, the display includes the mix of disk formats that make up the family. A family can include a combination of 180-byte disks, VSS-1 disks, VSS-2 disks, and VSS-3 disks.

WLM

Lists all entries for workload management events and configuration changes.