Output Parameters

Output parameters for the function routine are:

SSOBRETN
SSJIRETN
IAZSPLIO (SPOOL read service)

SSOBRETN Contents: When control returns to the caller and register 15 contains a zero, the job information services function places one of the following decimal values in the SSOBRETN field:

Value (Decimal): Meaning
SSJIOK (0): Request successful.
SSJIERVR (4): Request completed with possible errors, see SSJIRETN for reason code.
SSJIERRU (8): Request cannot be completed because of user error, see SSJIRETN for reason code.
SSJIERRJ (12): Request cannot be completed, SSJIRETN contains internal reason code.
SSJIPARM (16): Error in the parameter list, ie, the SSJI extension is an invalid format - it is not an SSJI, the service version number is not supported, or the SSJI is not large enough.

SSJIRETN Contents: In addition to the return code in SSOBRETN, the field SSJIRETN contains the service related error or more specific information about the error. SSJIRETN can be set to the following values if SSOBRETN = SSJIERRU (8):

Value (Decimal): Meaning
SSJIUNSF (4): Unsupported subfunction requested.
SSJINTDS (24): SSJIUSER does not point to the correct control block.
SSJIUNSD (28): Version number in the control block pointed to by SSJIUSER is not correct.
SSJISMDS (32): Length field in the control block pointed to by SSJIUSER is too small.

Return codes in SSJIRETN specific to the SPOOL read service: The following return codes are set if the SPOOL read service was requested and SSOBRETN is zero:

Value (Decimal): Meaning
SPIOOK (0): Success
SPIONTVF (4): Control block verification failed
SPIOCBIO (8): SPOOL control block I/O error
SPIOCBTK (12): SPOOL control block track address
SPIOCBNG (16): General control block problem
SPIOSTRG (20): Error obtaining 31-bit storage
SPIOSJER (24): Error obtaining 24-bit storage
SPIOILOG (28): A logic error has occurred
SPIONSPL (32): SPIOSTRP not initialized correctly
SPIONBUF (36): Could not locate instorage buffer. Most likely, the buffer has been written to SPOOL and is no longer in memory.
SPIONSAF (40): Authorization (SAF) failure accessing data.

SPOOL read service, IAZSPLIO contents: For the SPOOL read service (function code SSJISIOM) the following is returned in IAZSPLIO:

Field Name

Description

SPIOVERO

Subsystem version number (currently 1)

SPIOOUTA

Address of buffer obtained. This is a pointer directly to the SPOOLed data area (the $SPID). Normally, pointers to the data areas point to a prefix area; this does not.

SPIOOLEN

Length of the data area returned (not including the prefix area).

SPIOND1

Indicator field.

Value (Decimal): Meaning
SPIONSTG: The control block was retrieved from an instorage buffer.