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 on the iSeries server. 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
Top | APIs by category