Input Parameters

Input parameters for the function routine are:

SSOB
SSIB
IAZSSJP
IAZJPLEX (JESPLEX 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 JESPLEX 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
SSJPJXOD: IAZJPLEX JESPLEX Information service, obtain data
SSJPJXRS: IAZJPLEX JESPLEX Information service, release storage

SSJPUSER

Pointer to service specific data area '(IAZJPLEX)'

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

JESPLEX Information service, IAZJPLEX contents: For the JESPLEX Information service (function code SSJPJXOD), the caller must set the following fields in the IAZJPLEX control block:

Field Name: Description
JPLXID: Eyecatcher of the control block (set to 'JESPLEXI')
JPLXLEN: Length of the IAZJPLEX (JPLXSZE) control block
JPLXVER: Input version of the IAZJPLEX control block. Set to JPLXSVR# for the current (latest) version.
JPLXSTRP: 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 IAZJPLEX 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 IAZJPLEX control block on input to limit (or select) which data will be returned. If no filters are specified, all data will be returned. If any filters are specified, at least one of the filter conditions in each of the separate filters must be matched before data will be returned.

Field Name

Description

JPLXFLTR

Flag byte for filtering results. Each bit corresponds to a filter condition that must be matched before data is returned.

Bit Value: Description
JPLXFSNM: Filter on the MVS™ system name specified in the field JPLXSNAM
JPLXFMNM: Filter on the JES member name specified in the field JPLXMNAM

JPLXSTS1

Flag byte to filter on Status. 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
JPLDRAIN: Return JESPLEX information only if the system or member is in a Drained or Down state.
JPLINTZ: Return JESPLEX information only if the system or member is in an Initializing state (JES2 Only)
JPLXACTV: Return JESPLEX information only if the system or member is in an Active state
JPLXDRING: Return JESPLEX information only if the system or member is in a Draining state (JES2 Only)
JPLOUDEF: Omit undefined members (JES2 Only)
JPLNATCH: Return JESPLEX information only if the system or member is in a Not Attached state (JES3 Only)

JPLXSPEC

Flag byte to filter on JES Specific values. 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
JPLXINDP: Return JESPLEX information only if the system or member is Independent (JES2 Only)
JPLXBOSS: Return JESPLEX information only if the system or member is BOSS (JES2 Only)
JPLXPRIM: Return JESPLEX information only if the system or member is the Primary Subsystem (JES2 Only)
JPLXGLOB: Return JESPLEX information only if the system is the Global system (JES3 Only)
JPLXLOCL: Return JESPLEX information only if the system is a Local system (JES3 Only)

JPLXSNAM

MVS System Name filter.

JPLXMNAM

MVS Member Name filter.

Note: For JES3, the member name is the same as the system name.

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

For the JESPLEX Information service function code SSJPJXRS (release storage), the caller should not alter any fields in the IAZJPLEX control block returned on the last SSJPJXOD function call.