SPOOL-UPDATE

#### Search Results

Search

# 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

- Fields
- Relevant Error Codes
- Field Descriptions