Change Job Pool (QWCCHGJP) API
Required Parameter Group:
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(*) |
Default Public Authority: *EXCLUDE
Threadsafe: No
The Change Job Pool (QWCCHGJP) API moves a job into another main storage memory pool.
Restrictions for Movement of Jobs
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.
Authorities and Locks
- The requester must have *JOBCTL special authority if a source job name other than * is specified.
Required Parameter Group
- Function information
- INPUT; CHAR(*)
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.
- Length of function information
- INPUT; BINARY(4)
The length of the function information in the function information parameter. The length for format JOBP0100 is 40 bytes.
- Function information format
- INPUT; CHAR(8)
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.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Format of the Function Information
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 |
Field Descriptions
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. |
Error Messages
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. |
API introduced: V5R3M0