INGJLM

Purpose

The INGJLM command is used to start, stop, suspend or query Job Log Monitoring when the spooling subsystem is JES2 or JES3.

Parameters

DDN

Defines the ddname of a valid JES spool output data set:

JESMSGLG

JES message log. This is the default.

ddname

The ddname of any other spooled output data set.

procstepname

The step name of the "EXEC [PROC=]" statement.

stepname

The step name of the "EXEC PGM=" statement.

INTERVAL

Defines the monitoring interval for the indicated ddname in seconds. The minimum interval is 1 second, the maximum is 3600 seconds.

JOBID

Defines the job identifier, for example, JOB08450. The value can be up to 8 characters long.

Note: The command is rejected when the parameter is omitted and multiple job ids are found for the particular job name.

JOBNM

Defines the name of the job. The value can be up to 8 characters long.

OWNER

Defines the owner of the job. The value can be up to 8 characters long.

Note: The command is rejected when the parameter is omitted and multiple jobs are found for the particular job name with different owner ids.

RECYCLE

Instructs the monitoring task how to behave after a NetView recycle. The command needs only to be issued once for all future NetView recycles.

RESET

Instructs the monitoring task to ignore any former monitoring after a NetView recycle.

RESUME

Instructs the monitoring task to continue its monitoring after a NetView recycle.

The behavior is similar as when you would suspend and restart the task except that the task is not suspended and a NetView recycle takes place between task termination and restart.

START

Starts the monitoring of the ddname.

STATUS

Shows the status of the monitoring task and its monitored resources.

The column 'Status' shows the following:

  E........

The data set is marked "in error" and is not monitored any longer.

  .A.......

The data set is allocated.

  ..O......

The data set has been opened successfully.

  ...U.....

The user is not allowed to read the data set.

  ....S....

The monitoring of the data set is ACF-based.

  .....M...

All messages are passed to automation.

  ......J..

The corresponding job has not been found on the chain of active address spaces.

  .......I.

The spool data set is not initialized. The allocation of the data set is retried at the next monitoring interval. This repeats until the data set has been initialized.

  ........N

The ddname has defined the SPIN attribute. That means the corresponding spool data set can be spun off during processing.

STOP

Stops the monitoring of the ddname.

SUSPEND

Suspends the monitoring. All opened data sets are closed and deallocated. Finally, the task is terminated. However, all information to continue the preceding monitoring is kept. When the task is restarted it reopens each data set, positions to the last record read, and processes each new accumulated message.

Note: When you are no longer interested in monitoring at all use the NetView command STOP to terminate the task. All data sets are closed and all storage is released.

Restrictions and Limitations

Dynamically allocated spool output data sets are not supported.

The command is available to the primary subsystems JES2 and JES3 only.

When the monitoring task is restarted after it was suspended the Job Log Monitoring continues with the following limitations:

• The output of jobs that have finished before the monitoring task has been restarted is lost unless the output is still held on the output queue.
• A job is not monitored when it has been started between the time frame of the suspension of the task and its restart.

For manually monitored jobs you cannot specify any filter criteria to limit the data that is passed to automation. This means any line of data except an empty line which is generally excluded is forwarded to the message automation. The automation is always performed by the autotask LOGOPER.

Usage

The Start and Stop commands should be used only for the following jobs:

• Jobs that are not controlled by SA z/OS
• Jobs that are controlled by SA z/OS and do not contain Job Log Monitoring policy definitions

The Suspend command is used to suspend Job Log Monitoring. The accumulated output of all monitored jobs is not processed before the task has been restarted. To restart the task use the NetView command START TASK=INGTJLM.

The Query command is used to determine the current status of all monitored jobs. You can specify filter criteria to reduce the amount of status information returned. This command can be issued in a NetView PIPE.

The command INGJLM RECYCLE needs only to be issued once for all future NetView recycles until the next IPL.