Input Parameters

Input parameters for the function routine are:

SSOB
SSIB
IAZSSJP
IAZJPNJN (NJE Node 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 NJE Node 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 the related SSJIUSER area are:

Field Value: SSJPUSER Description
SSJPNJOD: IAZJPNJN NJE Node Information service, obtain data
SSJPNJRS: IAZJPNJN NJE Node Information service, release storage

SSJPUSER

Pointer to service specific data area '(IAZJPNJN)'

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

NJE Node Information service, IAZJPNJN contents: For the NJE Node Information service (function code SSJPNJOD), the caller must set the following fields in the IAZJPNJN control block:

Field Name

Description

NJNLEYE

Eyecatcher of the control block (set to ' SSJPNJNL ').

NJNLLNG

Length of the IAZJPNJN (NJNLSIZE) control block.

NJNLVRM

Input version of the IAZJPNJN control block. Set to NJNLVRM1 for version 1 of the control block. Set to NJNLVRMC for the current (latest) version.

NJNLOPT1

Processing options:

Bit Value: Description
NJNLODMC: Perform security label dominance check. This check is always performed for non-authorized callers (JES2 Only).

NJNLSTRP

Storage management anchor for use by the subsystem that responds to this request. It is expected that the caller sets this field to zero the first time IAZJPNJN is used and from that point on the field is managed by the subsystem.

The caller can also set the following fields in the IAZJPNJN 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.

An implicit OR is performed between filters that apply to the same node attribute. For example, if both NJNL1SSG and NJNL1CSG are selected, SSI returns NJE nodes that are defined with compatible signon in addition to NJE nodes that are defined with a secure signon.

An implicit AND is performed between filters that apply to the different node attributes. For example, if both NJNL1NAM and NJNL1SNA filters are selected, SSI returns NJE nodes with the names that match NJNLNOD1 field and which are at the same time connected through SNA protocol.

If a filter is not recognized or does not apply, it does not have an impact on the result of the SSI call. For example, JES3-only filters do not have impact on SSI output from JES2.

Field Name

Description

NJNLFLT1

Filter by node attributes:

Bit Value: Description
NJNL1NAM: Select by the node name specified in NJNLNOD1
NJNL1RNG: Select by a range of node numbers specified in NJNLRNGL and NJNLRNGH (JES2 Only)
NJNL1SSG: Select nodes with a secure signon
NJNL1CSG: Select nodes with a compatible signon
NJNL1NET: Select by the subnet name specified in NJNLSUBN (JES2 only)
NJNL1SNA: Select nodes using the SNA protocol (JES3 Only)
NJNL1BSC: Select nodes using the BSC protocol (JES3 Only)
NJNL1TCP: Select nodes using the TCP protocol (JES3 Only)

NJNLFLT2

Filter by node attributes:

Bit Value: Description
NJNL2PMY: Select nodes managed by path manager (JES2 Only)
NJNL2PMN: Select nodes not managed by path manager (JES2 Only)
NJNL2TLS: Select nodes using secure sockets (JES3 Only)

NJNLFLTC

Filter by connection status:

Bit Value: Description
NJNLCOWN: Select only the own node (JES2) or the home node (JES3). This filter should not be used with any other connection filter.
NJNLCADJ: Select adjacent nodes. An adjacent node is one hop away from the own (local) node.
NJNLCDIR: Select directly attached nodes. Directly attached nodes are adjacent nodes that use dedicated lines.
NJNLCCNC: Select connected nodes. A connected node is one that JES can communicate with in order to send data.
NJNLCNCN: Select not-connected nodes. A not-connected node is configured, but JES is unable to communicate with it.
NJNLCPDN: Select nodes pending connection.
NJNLCVIA: Select nodes connected with the adjacent node that is specified in NJNLNOD2.

NJNLFLTA

Filter by node authority (JES2 Only):

Bit Value: Description
NJNLADCY: Select nodes with authority to device commands
NJNLADCN: Select nodes without authority to device commands
NJNLAJCY: Select nodes with authority to job commands
NJNLAJCN: Select nodes without authority to job commands
NJNLANCY: Select nodes with authority to net commands
NJNLANCN: Select nodes without authority to net commands
NJNLASCY: Select nodes with authority to system commands
NJNLASCN: Select nodes without authority to system commands

If none of the following filters is specified, the SSI only returns data from the system where the SSI was called. To request information from other systems in a JESPLEX, specify the MVS™ system name or JES member selection filters.

NJNLFLTS

Filter by MVS System name or JES Member name (JES2 Only)

Bit Value: Description
NJNLSSYS: Filter by the MVS System name specified by NJNLSYSN
NJNLSMBR: Filter by the JES Member name specified by NJNLMBRN

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

For the NJE Node Information service function code SSJPNJRS (release storage), the caller should not alter any fields in the IAZJPNJN control block returned on the last SSJPNJOD function call.