Create Job Structures (QWTCTJBS) API


  Required Parameter Group:

1 Current number of temporary job structures available Output Binary(4)
2 Current number of permanent job structures available Output Binary(4)
3 Number of temporary job structures to create Input Binary(4)
4 Error Code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Create Job Structures (QWTCTJBS) API creates the number of temporary job structures that are passed on the call. The current number of temporary and permanent job structures available are returned.


Authorities and Locks

Job Authority
*JOBCTL

Required Parameter Group

Current number of temporary job structures available
OUTPUT; BINARY(4)

The number of temporary job structures that currently exist on the system that are not in use. This number also includes any temporary job structures that are to be created on this call to the API.

Current number of permanent job structures available
OUTPUT; BINARY(4)

The number of permanent job structures that currently exist on the system that are not in use.

Number of temporary job structures to create
INPUT; BINARY(4)

The number of additional temporary job structures that the user would like to have created. The valid range is 0-32000. If a number outside that range is passed, an error will be signaled. Under some conditions, the system may create fewer than the requested number. The following special value can be passed:

0 No additional temporary job structures are created. The current number of temporary and permanent job structures are returned.

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
CPE3002 E A range error occurred.
CPF222E E &1 special authority is required.
CPF24B4 E Severe error while addressing parameter list.
CPF3CF1 E Error code parameter not valid.
CPF3CF2 E Error(s) occurred during running of &1 API.
CPF3C20 E Error found by program &1.
CPF3C36 E Number of parameters, &1, entered for this API was not valid.
CPF3C90 E Literal value cannot be changed.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V4R1
Top | Work Management APIs | APIs by category