| 1 | Function information | Input | Char(*) |
| 2 | Length of function information | Input | Binary(4) |
| 3 | Function information format | Input | Char(8) |
| 4 | Error code | I/O | Char(*) |
The Change Job Pool (QWCCHGJP) API moves a job into another main storage memory pool.
The job can only be moved to a pool that is allocated by the subsystem in which the job is running or to a private pool allocated by the Change Pools (QWCCHGPL) API.
The information that is associated with the job to be moved and the pool to which the job is to be moved. See the Format of the Function Information for the format of this parameter.
The length of the function information in the function information parameter. The length for format JOBP0100 is 40 bytes.
The format of the function information that is being provided. The information is provided in the function information parameter. The valid values are:
| JOBP0100 | Format for the job name and pool id. |
The structure in which to return error information. For the format of the structure, see Error code parameter.
JOBP0100 Format: The following table shows the information for the JOBP0100 format. For more details about the fields in the following table, see Field Descriptions.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(10) | Source job name |
| 10 | A | CHAR(10) | Source job user name |
| 20 | 14 | CHAR(6) | Source job number |
| 26 | 1A | CHAR(10) | Target pool type |
| 36 | 24 | BINARY(4) | Target pool identifier |
Source job name. The name of the job to be moved. The possible values are:
| * | The job running the API is to be moved. |
| Name | The name of the job to be moved. |
Source job number. The number of the job to be moved. (Must be blank if * is specified for the source job name.)
Source job user name. The user name of the job to be moved. (Must be blank if * is specified for the source job name.)
Target pool identifier. The pool identifier for the pool into which the source job is to be moved. A Target pool type of *SBS indicates that this is the subsystem pool identifier, which is a value from 1 - 10. A Target pool type of *SYSTEM indicates that this is the system pool identifier, which is a value from 2 - 64.
Target pool type. The type of pool that the target pool identifier is referring to. The valid values are:
| *SBS | This is for a subsystem pool identifier. |
| *SYSTEM | This is for a system pool identifier. |
| Message ID | Error Message Text |
|---|---|
| CPF1893 E | Errors occurred while changing job &3/&2/&1. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3C36 E | Number of parameters, &1, entered for this API was not valid. |
| CPF3C3B E | Value for parameter &2 for API &1 not valid. |
| CPF3C90 E | Literal value cannot be changed. |