Inquire On Run Log - JBSF5301

Purpose To monitor the log records which record the activity of request jobs and batch queues
Subsystem Job Control and Scheduling
Structure One Block Run Log
Image

Run Log

Explanation
The majority of executable jobs generate information about whether or not they have run successfully. This information is displayed in run logs in this form. The system may also generate logs directly, among these a record of each time a batch queue status alters. The run log is particularly useful for diagnostic purposes when a job fails, and often includes details of a more technical nature intended primarily to aid specialist IT staff. Jobs returning extensive information have multiple log records.

The form displays:

  • a list of log records with identifying information about the job or batch queue to which the log record belongs
  • a log entry corresponding to the record selected in the list of log records.

A context request job is carried from the previous form, Maintain Request Job Run (JBSF5300), with its first record selected and log entry displayed automatically. The form can also be used to query all, or a subset, of job runs with records still existing in the system.

Log Entry field

Entries for typical log records might report on one or more of the following items: job execution, outputs, parameters, conditions under which a job failed, an aborted job, a job that has been restarted or the changed status of a batch queue.

The entire log entry can be seen by using the scroll bar or the Edit Field facility.

Example
Job CALR0620 in request 35, selected in the previous form, has two log records displayed, with logged information from the first record shown in the Log Entry field below. To see the log entry for the second record, it is necessary to select that record.

Some typical log entries are:

Entry about output:

Output number: 1, Destination number: 1, Filename: calr0620.lst successfully sent to the printer

Entry about a restartable job:

Start up check: Job status altered from RUNNING to SCHEDULED because it is restartable

Entry about a batch queue:

Batch queue status set to INACTIVE by the automated process.

To inquire on log records for jobs other than the context job, using the Inquire On Run Log form:
In Query mode:
  1. Enter query details in the appropriate fields.
  2. Execute the query.
  3. If more than one record is returned, select the required record to see its log entry.
Rules:
  • REMINDER: The Edit Field facility is useful to view long log entries.

Changes within this form will have the following notable effects: