Output Parameters

Output parameters for the function routine are:

SSIB
SSOBRETN
SSRRJCRP

SSIB Contents: The SSIB control block contains:

The JES name (supplied by the user on input)
The 8-character returned job ID
The subsystem use value (contained in the SSIBSUSE field-JES3 only)

The subsystem name (SSIBSSNM), returned job ID (SSIBJBID) and subsystem use value (SSIBSUSE-JES3 only) must be used on subsequent IEFSSREQ calls to the appropriate JES for subsequent services.

SSOBRETN Contents: When control returns to the caller and register 15 contains a zero, the SSOBRETN field contains one of the following decimal values:

Value (Decimal)

Meaning

SSRROK (0)

Successful completion. JES assigned a job ID to the caller. The job ID is available in the SSIBJBID field. See Restrictions for information on the processing that takes place after successful completion has been obtained.

SSRRFAIL (4)

The Request Job ID call did not successfully complete.

This can happen if JES is in the process of ending, and therefore cannot return job IDs.

This caller cannot make use of subsequent JES services.

SSRRFREQ (8)

The Request Job ID call is already known to this JES, and may not have a second job ID established.

SSRRNOEC (16)

For JES2 only, an ECB was not supplied through the SSRRSECB pointer field on the Request Job ID call.

SSRRPRME (20)

There is an error in the SSRR data area. For example, both the SSRRJOBL bit and the SSRRNJBL bits may be set.

SSRRPERR (36)

The JES processing this call has returned a program error. This can happen if the JES does not have enough virtual storage available to create either the job structure or other control blocks for the requesting address space.

Start of change SSRRJCRP Contents: The SSRJCRP field is a 4-byte pointer to the job correlator for the associated job. The job correlator is stored in the Subsystem Job Block Extension (SJXB) in field SJXJCOR. End of change