Input parameters

Input parameters for the function routine are:

SSOB
SSIB
IAZSSJI
IAZSPLIO (SPOOL read service)

SSOB Contents: The caller sets the following fields in the SSOB control block on input:

Field Name: Description
SSOBID: Identifier 'SSOB'
SSOBLEN: Length of the SSOB (SSOBHSIZ) control block
SSOBFUNC: SSI function code 71(SSOBSSJI)
SSOBSSIB: Address of the SSIB control block or zero (if this field is zero, the life-of-job SSIB is used). See Subsystem Identification Block (SSIB) for more information on the life-of-job SSIB
SSOBINDV: Address of the function-dependent area (IAZSSJI control block)

Set all other fields in the SSOB control block to binary zeros before issuing the IEFSSREQ macro.

SSIB Contents: If you don't use the life-of-job SSIB, the caller must provide an SSIB and set the following fields in the SSIB control block on input:

Field Name: Description
SSIBID: Identifier 'SSIB'
SSIBLEN: Length of the SSIB (SSIBSIZE) control block
SSIBSSNM: Subsystem name — name of the subsystem to which this Job Information Services request is directed

Set all other fields in the SSIB control block to binary zeros before issuing the IEFSSREQ macro.

IAZSSJI Contents: The caller must set the following fields in the IAZSSJI control block on input:

Field Name

Description

SSJIID

Eyecatcher for the control block (set to 'SSJI')

SSJILEN

Length of the IAZSSJI (SSJISIZE) control block

SSJISVRN

Input version of the IAZSSJI control block. Set to SSJISVR# for version 1 of the control block

SSJIFREQ

Function to be performed on this request. Valid functions and their related SSJIUSER area are:

Field Value: SSJIUSER Description
SSJISIOM: IAZSPLIO SPOOL read service, read record from SPOOL
SSJISIRS: IAZSPLIO SPOOL read service, release storage

SSJIUSER

Pointer to service specific data area '(IAZSPLIO)'

Set all other fields in the IAZSSJI control block to binary zeros before issuing the IEFSSREQ macro.

SPOOL read service, IAZSLPIO contents:For the SPOOL read service (function code SSJISIOM) the caller must set the following fields in the IAZSPLIO control block:

Field Name

Description

SPIOSSID

Eyecatcher of the control block (set to 'SPIO')

SPIOLEN

Length of the IAZSPLIO (SPIOSZE) control block

SPLIOVRN

Input version of the IAZSPLIO control block. Set to SPLIOVR1 for version 1 of the control block. Set to SPLIOVR# for the current (latest) version

SPIOSPAD

SPOOL address token of the record to be read. For JES2, the token value can be any of the following:

A SPOOL address token returned by extended status: for example, STJ2SPOL, STS2SPOL or STO2SPST;
An MTTR placed in the first four bytes, and the next four bytes set to zero;
The first byte set to X'FF', the second byte set to zero (0), and the remaining 6 bytes an MQTR.

SPIOCTYP

Optional input which specifies the type of control block that the caller expects to find at location SPIOSPAD after the spool read operation is complete. Validation of the data area will be performed if this field is specified. The possible values for SPIOCTYP, and the corresponding control block mapping macros used for validation are:

Field Value	Macro	Description
CHK	$CHK	Printer check record
HDB	$BUFFER	SYSIN/SYSOUT data buffer
IOT	$IOT	Data set information blocks. Contains the PDDBs
JCT	$JCT	JES2 job control table. Main job control block
NHSB	$NHSB	NJE headers and trailers
OCT	$OCT	/* OUTPUT JECL card descriptors
SIG	none	Signature record (record 0)
SWBI	$SWBIT	SYSOUT SWB information

SPIOJNAM

Optional input that requests that the job name in the data area read matches the value specified. Ignored if SPIOCTYP is not specified or set to 'SIG'.

SPIOJID

Optional input that requests that the JOBID in the data area read matches the value specified. Only the number portion of the JOBID is verified. Ignored if SPIOCTYP is not specified.

SPIOJKEY

Optional input that requests that the job key in the data area read matches the value specified. Ignored if SPIOCTYP is not specified.

SPIODSKY

Optional input that requests that the data set key in the data area read matches the value specified. Ignored if SPIOCTYP is not specified as 'HDB'.

SPIOSSNM

Optional input. When combined with SPIOASID, it requests that SYSOUT data buffers that have not been written to spool be obtained from the specified address space. SPIOSSNM is the name of the system on which the job is currently running and must be specified as either blanks or the name of the local system. For this type of request, SPIOCTYP must be set to 'HDB'.

SPIOASID

Optional input. When combined with SPIOSSNM, it requests that SYSOUT data buffers that have not been written to spool be obtained from the address space specified by SPIOASID.

SPIOOPT

Processing options flag byte.

SPIORACF: Perform authorization checking even if the caller is authorized.

Set all other fields in the IAZSPLIO control block to binary zeros before issuing the IEFSSREQ macro.

For the SPOOL read service function codes SSJISIRS (release storage), the caller should not alter any fields in the IAZSPLIO control block returned on the last SSJISIOM function call.