SPOOL-UPDATE

File 13
Statement FIND, PROCESS
Task Alter the status of a specified spool job, for example, change job class, change destination, delete spool job entry.

Fields

Dictionary Field Name F/L Mu DE Remarks
ERROR-CODE N3      
ERROR-TEXT A58      
NODE N5   D  
NODE-NAME A16   D  
JOB-NUMBER N5   D Required if no JOB-NAME or JOB-ID is specified.
JOB-ID A8   D Required if no JOB-NAME or JOB-NUMBER is specified.
FUNCTION A8   D Required
JOB-NAME A8   D Required if no JOB-NUMBER or JOB-ID is specified.
GROUP-ID A20   D  
CLASS A8   D  
JES3-CLASS A1     Valid for JES3 only.
JES3-QUEUE A4     Valid for JES3 only.
NEW-DESTINATION A8   D Valid only if FUNCTION=CHANGE.

Relevant Error Codes

Code Text
671 Class missing or invalid.
711 Logical Error occurred in Common JES Interface.
712 Request to Common JES Interface failed.
714 Jobname and Job ID missing. One of them required.
715 Duplicate jobnames found. Please specify Job ID.
723 Job not in output service.
724 Requested job not found.
730 Unknown error during alter.
778 Not APF authorized.
820 Unknown command.
821 Job no longer active.
830 JES interface not active.
830 POWER interface not active.
833 You are not allowed to alter this job.
834 Command failed, MGCRE RC =:1:.

Field Descriptions

Field Name Type/Length
CLASS (A1)

New job class or output class to be assigned when FUNCTION=CHANGE or RELEASE.

Field Name Type/Length
FUNCTION (A8)

Command to be executed. Possible options:

Option Explanation
CANCEL  Cancel job.
CHANGE 

Change one or more spool-queue attributes.

CLASS, NEW-DESTINATION.

HOLD  Set job in HOLD status.
RELEASE  Release job.
Field Name Type/Length
GROUP-ID (A20)

Identification of JES SYSOUT group.

Field Name Type/Length
JES3-CLASS (A1)

Valid for JES3 only. Specifies the output class of the SYSOUT data sets that should be modified.

Field Name Type/Length
JES3-QUEUE (A4)

Valid for JES3 only. Specifies the output queue of the SYSOUT data sets that should be modified. Possible values are HOLD and WTR.

Field Name Type/Length
JOB-ID (A8)

Job number in alphanumeric format.

Field Name Type/Length
JOB-NAME (A8)

Name of job.

Field Name Type/Length
JOB-NUMBER (N7)

Job number assigned by JES.

Field Name Type/Length
NEW-DESTINATION (A8)

New destination for a given GROUP-ID. This GROUP-ID may be read using the view SPOOL-QUEUE. Valid only if FUNCTION=CHANGE.

On this page