LOGGER Operation

LOGGER operates in two main phases. During the first phase, LOGGER creates data files containing the information necessary to generate a report. During the second phase, LOGGER reads the files and generates a report. The first phase is bypassed if LOGGER is instructed to use existing data files to generate a report.

LOGGER creates the files JOBSUMMARY, STATISTICS, DRCDATA, and FILEIODATA during the first phase of operation. These files contain the data necessary to generate reports. The JOBSUMMARY file contains data on each job, task, and message control system (MCS) session. The STATISTICS file contains overall system statistics such as number of jobs run and number of halt/loads. This data is grouped by 15-minute intervals. The FILEIODATA file contains data on file usage obtained from file open and close log entries. The JOBSUMMARY and STATISTICS files are always created; however, the DRCDATA file is created only when the OPTION WRITEDRCDATA command is used, and the FILEIODATA file is created only when the OPTION WRITEIODATA command is used.

LOGGER generates reports during the second phase of operation by reading data from the files created in the first phase. During any run, LOGGER generates a report based on only one of the files. When instructed, LOGGER can bypass the first operational phase by generating reports using files created during previous runs. LOGGER can also generate reports using files covering a range of dates (for example, all JOBSUMMARY files created during one week).

The following WFL job can be used to run LOGGER:

BEGIN JOB;
  RUN SYSTEM/LOGGER;
  <input records>
END JOB

<input records>

──┬──────────────────┬─┬───────────────────┬─┬──────────────────┬──────┤
  │ ┌◄─ <in spec> ─┐ │ │ ┌◄─ <rep spec> ─┐ │ │ ┌◄─ <in spec> ─┐ │
  └─┴─<in spec>────┴─┘ └─┴─<rep spec>────┴─┘ └─┴─<in spec>────┴─┘

<in spec>

──<input-specification command>────────────────────────────────────────┤

<rep spec>

──<report-specification command>───────────────────────────────────────┤

The following text describes the meaning of each variable:

<input records>

Determines which information is used to generate a report and where the information comes from.

If <input records> is not specified, a report is not generated. However, LOGGER still creates the JOBSUMMARY and STATISTICS files.

<input-specification command>

Described in “Input-Specification Commands” in this section.

<report-specification command>

Described in “Report-Specification Commands” in this section.

Example

The following WFL job generates a report based on SYSTEM/SUMLOG because a SOURCE command is not present. Refer to “SOURCE Command” in this section for more information.

BEGIN JOB;
  RUN SYSTEM/LOGGER; DATA CARD
  REPORT 1
END JOB