Change Server Job (QGYCHGSJ) API
Required Parameter Group:
1 | Number of auxiliary server jobs allowed | Input | Binary(4) |
2 | Error code | I/O | Char(*) |
Default Public Authority: *USE
Threadsafe: No
The Change Server Job (QGYCHGSJ) API sets the maximum number of auxiliary server jobs allowed for a server job. At least one auxiliary server job is allowed; up to five auxiliary server jobs may be allowed. An auxiliary server job is used to do work asynchronously from the job that started the auxiliary server job. For example, the auxiliary server job is used to complete building lists of information. All auxiliary server jobs end automatically when the submitting job ends.
The Retrieve Server Job Information (QGYRTVSJ) API can be called to retrieve the number of active auxiliary server jobs, the number of auxiliary server jobs allowed, and the job names for each active auxiliary server job.
Authorities and Locks
None.
Required Parameter Group
- Number of auxiliary server jobs allowed
- INPUT; BINARY(4)
The number of auxiliary server jobs that may be started for the current server job. If the number specified is less than the number that is currently allowed, no change will be made. No more than five auxiliary server jobs may be allowed.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Error Messages
Message ID | Error Message Text |
---|---|
CPF24B4 E | Severe error while addressing parameter list. |
CPF3C90 E | Literal value cannot be changed. |
CPF3CF1 E | Error code parameter not valid. |
CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
GUI0113 E | Number of auxiliary server jobs, &1, not valid. |
API introduced: V3R6