The following input-specification commands can be used as input to LOGGER.

<input-specification command>

──┬─<correction command>──────┬────────────────────────────────────────┤
  ├─<maxrecords command>──────┤
  ├─<option command>──────────┤
  ├─<sort parameters command>─┤
  ├─<stop command>────────────┤
  └─<use command>─────────────┘

CORRECTION Command

Use the CORRECTION command to correct values in a report if the log contains erroneous data for an entry. Only reports generated from the JOBSUMMARY file can have corrections applied to them.

This command must follow any report-specification commands.

<correction command>

── CORRECTION ──<mm/dd>──<time>──<mix number>──<item>── = ──<number>───┤

<mix number>

  ┌◄───────────┐
──┴──<integer>─┴────────────────────────────────────────────────────┤

The following text describes the meaning of each variable:

Examples

The following command replaces the processor time for task 1234 dated 09/01 with the value 2.54:

CORRECTION 09/01 09 1234 PROCESSTIME = 2.54.

The following command replaces the I/O time for task 7245 dated 08/24 with the value 1.72:

CORRECTION 08/24 00 7245 IOTIME = 1.72.

MAXRECORDS Command

Use the MAXRECORDS command to specify the maximum number of log records to be read. This command can appear before or after a report-specification command. If no MAXRECORDS command is entered, the maximum number of log records to be read is 1,000,000,000.

<maxrecords command>

── MAXRECORDS ──<integer>──────────────────────────────────────────────┤

The following text describes the meaning of the variable:

Example

The following example specifies that a maximum of 45,000 log records are to be read:

MAXRECORDS 45000

OPTION Command

Use the OPTION command to enable certain options. All options are disenabled by default. This command can appear before or after the report-specification commands.

<option command>

           ┌◄───────────────────────┐
── OPTION ─┴─┬─/1\─ WRITEIODATA ──┬─┴──────────────────────────────────┤
             ├─/1\─ WRITEDRCDATA ─┤
             ├─/1\─ DRCONLY ──────┤
             ├─/1\─ RESETDRC ─────┤
             ├─/1\─ DEBUG ────────┤
             ├─/1\─ UPDATE ───────┤
             └─/1\─ YEAR ─────────┘

The following text describes the meaning of each variable:

Examples

The following command enables the DEBUG and UPDATE options:

OPTION DEBUG UPDATE

The following is an example of a WFL job that can be used to restart LOGGER for a DRC report with the RESETDRC option set. This example is not complete and must be modified for individual systems. For information about issues involved in recovery, refer to the discussion of the RESETDRC option earlier under this heading.

BEGIN JOB LOGGER/DRC;
TASK T;
BOOLEAN RESETONLY;
SUBROUTINE SETDRC;
BEGIN
RUN SYSTEM/LOGGER;
DATA
OPTION DRCONLY RESETDRC
?%END
END; %SUBROUTINE
ON RESTART,
BEGIN
     IF RESETONLY THEN
        BEGIN
        SETDRC;
        GO ENDOFJOB;
        END
     ELSE
        GO JOBSTART;
END;
JOBSTART:
PROCESS RUN SYSTEM/LOGGER[T];
DATA
OPTION RESETDRC
SOURCE IS DRCDATA
REPORT USERCODE, PACKNAME, DISKINUSE, MBYTEDAYS
SORT BY USERCODE ASCENDING
REPORTS ARE SUMMARY 1
?%END DATA
WAIT(T(VALUE)=1);
RESETONLY := TRUE;
ENDOFJOB:
END JOB

SORT PARAMETERS Command

Use the SORT PARAMETERS command to change the parameters used by the SORT command when sorting the entries.

<sort parameters command>

                       ┌◄──────────────────────────────┐
── SORT ── PARAMETERS ─┴─┬─/1\─ DISKSIZE ──<integer>─┬─┴───────────────┤
                         └─/1\─ TAPES ──<integer>────┘

The following text describes the meaning of each variable:

Example

The following command sets the disk size to 3,600,000 words and specifies that no tapes are to be used:

SORT PARAMETERS DISKSIZE 3600000 TAPES 0

STOP Command

Use the STOP command to indicate the end of the LOGGER input. LOGGER does not read any input-specification or report-specification commands specified after the STOP command. This command should be the last entry in the LOGGER input.

<stop command>

── STOP ───────────────────────────────────────────────────────────────┤

USE Command

The USE command specifies the source files to be used for the LOGGER report. If you do not specify the USE command, LOGGER uses the current SYSTEM/SUMLOG on the current log family as the source file. LOGGER can access a SUMLOG file only if the log file title has the form SUMLOG/<system serial number>/<date>/<log number>, which is the form assigned to it automatically by the system during a log release process.

LOGGER accesses SUMLOG files through the SDASUPPORT library. Depending on the security status of the SUMLOG file and the privilege status of the usercode running LOGGER, the SDASUPPORT library might perform log filtering. For further information about log filtering, refer to the System Log Programming Reference Manual.

The USE command can only appear once in an input deck. This command can appear before or after a report-specification command.

<use command>

── USE ─┬──────────┬─┬─ CURRENT ───────────┬───────────────────────────┤
        ├─ SUMLOG ─┘ └─<mmddyy>─┬──────────┤
        │                       └─<mmddyy>─┤
        └─ SYSTEM/SUMLOG ──────────────────┘

The following text describes the meaning of each variable. The date can be any valid date, where mm is the month, dd is the day, and yy is the year.

Example

The following command specifies that SUMLOG files dated with 030292 are to be used as source files:

USE SUMLOG 030292