CA ADS Batch Print Log Utility › Control Statements

Control Statements

The print log utility's control statements enable you to specify the type of reports you want, the criteria to be applied in selecting log file records, and the information about the log file.

Syntax for the control statements is shown below:

►►──┬────────────────────────────────┬────────────────────────────────────────►
    └─ MODE ─┬──────┬─┬─ REPort ◄ ─┬─┘
             ├─ IS ─┤ └─ EXTract ──┘
             └─ = ──┘

 ►──┬───────────────────────────────────────────────┬─────────────────────────►
    └─┬─ PRInt ◄ ──┬───┬──────────────────────────┬─┘
      └─ EXClude ──┘   ├───── ALL ◄ ──────────────┤
                       │     ┌──────────────┐     │
                       └─ ( -v┬─ DEBug ────┬┴─ ) ─┘
                              ├─ USEr ─────┤
                              ├─ EDIterr ──┤
                              ├─ OPErator ─┤
                              ├─ ABEnd ────┤
                              └─ STAts ────┘
 ►──┬───────────────────────────────────────────────────────────┬─────────────►
    └─ FOR ──┬──── ALL ◄ ───────────────────────────────────┬───┘
             │                     ┌───────────────┐        │
             └───┬── DIAlogs ── ( ─▼─ dialog-name ─┴─ ) ──┬─┘
                 │                  ┌───────────┐         │
                 └┬─ USErids ─┬─ ( ─▼─ user-id ─┴─ ) ─────┘
                  └─ USERS ───┘

 ►───┬────────────────────────────────────────┬───────────────────────────────►
     └─ FROm time-hhmmsstttt ──┬────────────┬─┘
                               └─ ON yyddd ─┘
 ►──┬──────────────────────────────────────┬──────────────────────────────────►
    └─ TO time-hhmmsstttt ──┬────────────┬─┘
                            └─ ON yyddd ─┘

 ►──┬──────────────────────────────────────────────┬──────────────────────────►
    └─ LOG File ──┬──────┬──┬─ ADSLOGA ◄ ───────┬──┘
                  ├─ IS ─┤  └─ run-time-label ──┘
                  └─ = ──┘

 ►──┬─ PREfix ◄ ──┬──────────────────────────────────────────────────────────►◄
    └─ NOPrefix ──┘

MODE IS REPORT/EXTRACT

Specifies whether the output is formatted:

• REPORT (default) specifies that the output is formatted with page headers and carriage control characters.
• EXTRACT specifies that the output is unformatted. The selected records are simply extracted from the log file; each record includes the log file prefix.

  The EXTRACT option enables you, for example, to extract all EDITERR records created during the execution of an application. You can then merge these records with the suspense files that the records describe.

PRINT/EXCLUDE

Specifies whether the named record types are included in or excluded from the report. PRINT is the default.

ALL/(DEBUG/USER/EDITERR/OPERATOR/ABEND/STATS)

Specifies the types of records requested, as follows:

• ALL (default) specifies all record types.
• DEBUG specifies debugging information issued by SNAP commands and by the CA ADS Batch trace facility.
• USER specifies messages issued by WRITE TO LOG and CONTINUE commands, and by WRITE TRANSACTION commands that perform a mapout to the terminal operator.
• EDITERR specifies error messages issued when an input record is written to the suspense file.
• OPERATOR specifies messages issued by WRITE TO OPERATOR commands.
• ABEND specifies messages issued by the ABORT command and by the runtime system when an application abends. These messages also include snap dumps of memory produced by abends.
• STATS specifies statistics written by the runtime system when dialog statistics are being collected for the application.

FOR ALL/DIALOGS (dialog-name)/USERIDS (user-id)

Specifies selection criteria by dialog and/or user id, as follows:

• ALL (default) specifies that the dialog name and user id are not used as selection criteria.
• DIALOGS (dialog-name) specifies that only log file records created by the named dialog or dialogs are included in the report. Multiple dialog names must be separated by commas. If the DIALOGS parameter is not specified, the dialog name is not used as a selection criterion.
• USERIDS (user-id) specifies that only log file records created by the named user or users are included in the report. Multiple user ids must be separated by commas. If the USERIDS parameter is not specified, the user id is not used as a selection criterion.

FROM time-hhmmsstttt

Specifies that only log file records created on or after the specified time are included in the report. Time-hhmmsstttt specifies the time in hours (1 through 24), minutes, seconds, and tenths of seconds. Two digits of the hour must be specified; the remainder is optional. For example, 9:45 a.m. is specified as 0945. To include a date using the ON parameter, you must specify a time; you can specify the beginning of a day as 00. The default is the beginning of the day.

ON yyddd

Specifies that only log file records created on or after the specified Julian date are included in the report. The default is the date on which the print log utility is executed.

TO time-hhmmsstttt

Specifies that only log file records created on or before the specified time are included in the report. Time-hhmmsstttt specifies the time in hours (1 through 24), minutes, seconds, and tenths of seconds. Two digits of the hour must be specified; the remainder is optional. For example, 9:45 a.m. is specified as 0945. To include a date using the ON parameter, you must specify a time; you can specify the end of a day as 24. The default is 24, which is the end of the day.

ON yyddd

Specifies that only log file records created on or before the specified Julian date are included in the report. The default is the date on which the print log utility is executed.

LOG FILE IS ADSLOGA/ddname

Specifies the z/OS ddname or z/VSE filename of the log file. The default is ADSLOGA.

PREFIX/NOPREFIX

Specifies whether the log file contains a prefix for each record. The default is PREFIX. NOPREFIX must be specified if no prefix is included, so that the print log utility does not attempt to interpret the beginning portion of each log file record as a prefix.