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.