Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

Commands for job monitoring

&pagelevel(4)&pagelevel

The commands below manage a job or provide information. If the job is monitored by a job variable, this job can optionally be identified via its monitoring job variable (name or link name) instead of the TSN.
The specification is made in the MONJV operand (with a few exceptions, in the structure JOB-IDENTIFICATION=*MONJV(...)).

Command

Function

CANCEL-FILE-TRANSFER

cancels a file transfer job (see “openFT” [15])

CANCEL-JOB

cancels an interactive, batch or print job (see also Note on CANCEL-JOB)

CANCEL-PRINT-JOB

cancels a print job

CHANGE-TASK-CPU-LIMIT

changes the CPU limit of a job that has been started

CHANGE-TASK-PRIORITY

changes the execution priority of a job that has been started

FORCE-JOB-CANCEL

cancels the specified job without delay

HOLD-JOB

places a job that has not yet been started in the wait state

HOLD-TASK

places a job that has been started in the wait state

MODIFY-JOB

modifies the attributes of the job

MODIFY-JOB-OPTIONS

modifies the parameters (logging and job monitoring) of an existing job

MOVE-TASK-TO-CATEGORY

moves a job that has been started into another category

RESUME-JOB

cancels the wait state of the specified job

SET-SYSLST-READ-MARK

sets a read mark in the job’s SYSLST file

SET-SYSOUT-READ-MARK

sets a read mark in the job’s SYSLOUT file

SHOW-FILE-TRANSFER

provides information about a (see “openFT” [15])

SHOW-JOB-STATUS

provides information about a file transfer job

SHOW-RESOURCE-ALLOCATION

provides information about resources allocated to the job

Table 24: Commands for defining job monitoring

The commands below are rejected if the job variable specified in the JOB-IDENTIFICATION or SELECT operand does not identify a monitoring job variable. The commands are also rejected if the monitoring job variable cannot be accessed (e.g. protection by password), or if the caller is not allowed to access the monitored job.

The monitoring job variable is automatically entered under the link name SMONJVJ in the JV-LINK table of the job being monitored. This default link name enables the job to access its monitoring job variable and the information that it contains, without needing to know the name beforehand. This is particularly significant for cataloged command sequences when multiple batch jobs are to run concurrently. It must be noted here that the standard link name is not assigned explicitly in the job’s command sequence and thus overwrites the assignment.

Note on CANCEL-JOB

If a job has been terminated abnormally, i.e. the CANCEL-JOB command has been executed with STEPS=*ALL (default setting), the status indicator of a monitoring job variable is set to the value $A. In addition, the information about the originator is transferred in shortened form, together with the comment from the TEXT operand of the command, to the system part (the first 128 bytes) of the monitoring job variable:

  • the information about the originator begins at byte 37 and consists of the character string CAN:info, where info contains the first 27 bytes of the originator information supplied to SYSOUT;

  • the comment begins at byte 70 and consists of the character string TEXT:text, where text contains the first 51 bytes of the comment specified in the operand.