Input Parameters

Input parameters for the function routine are:

SSOB
SSIB
IAZSSJP
IAZJPSPL (SPOOL Volume Information)

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 82 (SSOBSSJP)
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 about the life-of-job SSIB
SSOBINDV: Address of the function-dependent area (IAZSSJP control block)

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

SSIB Contents: If you do not 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 SPOOL Volume Information Services request is directed.

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

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

Field Name

Description

SSJPID

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

SSJPLEN

Length of the IAZSSJP (SSJPSIZE) control block

SSJPVER

Input version of the IAZSSJP control block. Set to SSJPVER1 for version 1 of the control block or to SSJPVERC for the current version of the control block.

SSJPFREQ

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

Field Value: Description
SSJPSPOD: IAZJPSPL SPOOL Volume Information service, obtain data
SSJPSPRS: IAZJPSPL SPOOL Volume Information service, release storage

SSJPUSER

Pointer to service specific data area '(IAZJPSPL)'

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

SPOOL Volume Information service, IAZJPSPL contents: For the SPOOL Volume Information service (function code SSJPSPOD), the caller must set the following fields in the IAZJPSPL control block:

Field Name: Description
JPSPSSID: Eyecatcher of the control block (set to 'JPSPOOLD')
JPSPLEN: Length of the IAZJPSPL (JPSPSZE) control block
JPSPVER: Input version of the IAZJPSPL control block. Set to JPSPSVR# for the current (latest) version.
JPSPSTRP: Storage management anchor for use by the subsystem that responds to this request. It is expected that the caller will set this field to zero the first time IAZJPSPL is used and from that point on the field will be managed by the subsystem.

The caller can also set the following fields in the IAZJPSPL control block on input to limit (or select) which data is returned. If no filters are specified, all data is returned. If any filters are specified, at least one of the filter conditions in each of the separate filters must be matched before data is returned.

Field Name

Description

JPSPPARF

Partition filters. Each bit corresponds to a filter condition. This filter is matched if at least one of the specified filter conditions is met.

Bit Value: Description
JPSPFULL: Filter on spool partitions that are FULL (JES3 only)
JPSPPNM: Filter on the spool partition name specified in field JPSPPNAM (JES3 only)
JPSPALD: Filter on spool partitions for which spool allocations are allowed (JES3 only)
JPSPNALD: Filter on spool partitions for which spool allocations are not allowed (JES3 only)
JPSPLFTP: Filter on the default spool partition (JES3 only)
JPSPIDTA: Filter on spool partitions that contain initialization data (JES3 only)
JPSPNOVF: Filter on spool partitions that cannot overflow (JES3 only)
JPSPPOVF: Filter on spool partitions for which at least one other partition can overflow into them (JES3 only)

JPSPELF1

Extent Status Filters. Each bit corresponds to a filter condition. This filter will be matched if at least one of the specified filter conditions is met.

Bit Value: Description
JPSPACT: Extent Active
JPSPSTRT: Extent Starting (JES2 Only)
JPSPDRN: Extent Draining
JPSPHALT: Extent Halting (JES2 Only)
JPSPINAC: Extent Inactive (JES2 Only)
JPSPHLD: Extent Held (JES3 Only)
JPSPBADT: Extent holds a Bad Track (JES3 Only)
JPSPSTT: Extent STT (JES3 Only)

JPSPELF2

Extent filters. Each bit corresponds to a filter condition that must be matched before data is returned.

Bit Value: Description
JPSPEXI: Filter on the Extent ID specified in the field JPSPEXTI
JPSPTGU: Filter on the track group utilization level specified in the field JPSPTGUT (JES2 Only)
JPSPTGM: Filter on the minimum number of total track groups specified in the field JPSPTGMN (JES2 Only)
JPSPAMB: Filter on the JES2 affinity member name specified in the field JPSPAMBR (JES2 Only)
JPSPASY: Filter on the JES2 affinity MVS™ system name specified in the field JPSPASYS (JES2 Only)

JPSPEFL3

Extent filters:

Bit Value: Description
JPSPXTND: Extent EXTENDING
JPSPMIGR: Extent MIGRATING
JPSPMAPP: Extent MAPPED

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

For the SPOOL Volume Information service function code SSJPSPRS (release storage), the caller should not alter any fields in the IAZJPSPL control block returned on the last SSJPSPOD function call.