Displaying the status of nodes *INQUIRY,NJE

Function

Use the *INQUIRY,NJE command to display the status of the networking nodes and communication lines.

Use the PWCNTL keyword on the *INQUIRY,NJE command to display the job password control option for first job card passwords your node sends to a remote node. Your node can use one of the following options to verify passwords:

Send jobs with passwords encrypted (SENDENC).
Send jobs with passwords in clear text (SENDCLR).
Send jobs after passwords are verified at the local node (LOCALCHK). In this case, passwords are not sent to the remote node.

See z/OS JES3 Initialization and Tuning Guide and z/OS JES3 Initialization and Tuning Reference for more information about PWCNTL.

Syntax


>>-+-*INQUIRY-+--,--NJE--+-,--NAME--=-+--nodename--------------->
   '-*I-------'          '-,--N--=----'             

>--+---------------+-------------------------------------------><
   +-,--LINE-------+   
   +-,--NETHOLD----+   
   +-+-,--PWCNTL-+-+   
   | '-,--PC-----' |   
   +-,--R----------+   
   +-,--SNDR-------+   
   '-,--SP---------'

Parameters

NAME or N =nodename: The name of a remote node or an alias.
LINE: Displays the names of all lines defined to the node named on the NAME= keyword.
NETHOLD: Displays the option for processing inbound NJE SYSOUT data in NETDATA format.
PWCNTL or PC: Displays the job password control option for passwords sent to the designated node for processing.
R: Displays the number of retries (1 through 300) JES3 will attempt before ending the BSC NJE line.
SNDR: Displays the status of logical senders defined to the node named on the NAME= keyword.
SP: Display the name of the spool partition assigned for the specified node.

Rules

You can specify LINE or SNDR, but not both.
The LINE and SNDR parameters are valid only for BSC/NJE.
The NETHOLD parameter is only valid for the home node.

Results

If you specify only the NJE operand, JES3 issues one of the following messages for each active networking line in your installation. Each message contains the name of the remote node that is directly connected to your node through the indicated line.
```
IAT8651 - lname-nodename RESTARTING

IAT8652 - lname-nodename I/O ACTIVE

IAT8653 - lname-nodename ACTIVE

IAT8654 - lname-nodename STARTING

IAT8656 - lname-nodename CANCEL REQUESTED

IAT8657 - lname-nodename LINE TERMINATING
```
JES3 issues one of the following messages if you specify a node name in the command.
- If you specify *I,NJE,NAME=nodename, JES3 issues this message:
```
IAT8659  NODE nodename  {HOLD/NOHOLD} PATH pathname
{DEFINED LINE linename | SNA PROTOCOL | blank}
```
  If nodename is the name of the home node, JES3 issues this message:
```
IAT8659  HOME nodename  PRTDEF p PRTTSO t PRTXWTR x PUNDEF n
 
```
  If nodename is an alias, JES3 issues this message:
```
IAT8659  ALIAS nodename  PRTDEF p PRTTSO t PRTXWTR x PUNDEF n
 
```
  Note: In the above examples p is the value for the PRTDEF value, t for PRTTSO, x for PRTXWTR, and n for PUNDEF on the NJERMT initialization statement or the most recent *F NJE command.
- If you include the LINE parameter, JES3 issues this message:
```
IAT8660  NODE nodename ACTIVE LINES (linename RCV/NORCV
[linename RCV/NORCV]...)
```
- If you include the SNDR parameter, JES3 issues this message:
```
IAT8661  NODE nodename NJESENDR (sendername[sendername]...)
```
- If you include the SP parameter, JES3 issues this message:
```
IAT8648  NODE nodename , SPART=spart
```

If you include the PWCNTL keyword, JES3 issues the following message:

                                           {SENT ENCRYPTED    }
IAT8664  NODE nodename PASSWORDS WILL BE   {SENT IN CLEAR TEXT}
                                           {VERIFIED LOCALLY  }

If you specify *I,NJE,NAME=nodename and the node is defined with TYPE=TCPIP, JES3 issues the following message:

INFORMATION FOR NODE nodename
TYPE=TCPIP, JOBTRANS=jt, JOBRECV=jr, OUTTRANS=ot, OUTRECV=or,
SECSIGNON=<YES/NO>, TLS=<YES/NO>, ACTIVE=<YES/NO>
PWCNTL=<SENDENC/SENDCLR/LOCALCHK>
SOCKETS DEFINED FOR THIS NODE
SOCKET ACTIVE SERVER NETSERV SYSTEM
s1     YES/NO YES/NO YES/NO  sysname
END OF NODE INQUIRY RESPONSE

Example

Display the job password control option for passwords sent to NODEB:

*I,NJE,N=NODEB,PWCNTL

Display the spool partition to which the inbound NJE stream from NODE1 will be written.

*I,NJE,N=NODE1,SP

Display the node information for NODE3, which is defined with TYPE=TCPIP.

IAT8711 NODE INQUIRY RESPONSE
INFORMATION FOR NODE NODE3
TYPE=TCPIP, JOBTRANS=1, JOBRECV=1, OUTTRANS=1, OUTRECV=1,
SECSIGNON=NO, TLS=NO, ACTIVE=NO, PWCNTL=SENDCLR
SOCKETS DEFINED FOR THIS NODE
SOCKET ACTIVE SERVER NETSERV SYSTEM
S3     NO     NO     JES3S1  SY1
END OF NODE INQUIRY RESPONSE