DISPLAY NETSRVR command

Read syntax diagramSkip visual syntax diagramDISPLAY NET,NETSRVR,SCOPE=ALL,SCOPE=ALLONLY

Abbreviations

Operand Abbreviation
DISPLAY D
SCOPE=ALL EVERY or E
SCOPE=ONLY NONE or N

When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for SCOPE=ALL, code only EVERY or E. Do not code SCOPE=E.

Purpose

The DISPLAY NETSRVR (network node server) command displays information about network node servers. Enter this command at the end node whose server information you want to display. This command is valid only when it is issued at an end node or migration data host.

Operands

SCOPE
Specifies the required scope of the display.
SCOPE=ONLY
Displays the network node server list that is currently active and displays the current network node server.
SCOPE=ALL
Displays, in addition to the information shown for SCOPE=ONLY, other network nodes known to the end node that can act as network node servers. Other network nodes are allowed as servers only if the current network node server list contains a nameless entry.

Resulting display

The resulting display shows:
  • The contents of the active network node server list.
  • For each network node in the list, an indication of whether support for SLU-initiated sessions is required or optional in order to establish a CP-CP session with this end node.
  • If the list contains explicit entries, the order in which the entries are used (FIRST or NEXT).
  • If SCOPE=ALL is specified, other network nodes known to this end node that are allowed as network node servers. Other network nodes are allowed as servers only if the current list contains a nameless entry.
  • The name of the current network node server. The name displayed here is the name of an adjacent network node that this end node has most recently determined to be a suitable network node server and with which this end node has either established CP-CP sessions or is in the process of establishing CP-CP sessions. At the time the DISPLAY NETSRVR command displays this name, CP-CP sessions with this network node may or may not be fully active yet.
  • The name of the preferred network node server if one has been specified.

For more information about how to code a network node server list, see the z/OS Communications Server: SNA Resource Definition Reference.

Examples

Displaying a network node server list with one nameless entry and no explicit entries using SCOPE=ALL (no preferred network node server has been defined):
d net,netsrvr,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = NETWORK NODE SERVER LIST
IST1252I DEFINED NETWORK NODE SERVER LIST, NAME = NNSL2J
IST1253I ****NAMELESS****      SLUINIT = OPT      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1255I OTHER NETWORK NODES ALLOWED AS SERVERS
IST1253I NETA.SSCP1A           SLUINIT = OPT      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1256I CURRENT NETWORK NODE SERVER
IST1253I NETA.SSCP1A           SLUINIT = OPT      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1677I PREFERRED NETWORK NODE SERVER
IST1253I NONE
IST314I END
Displaying a network node server list with one nameless entry and no explicit entries using SCOPE=ONLY (no preferred network node server has been defined):
d net,netsrvr,scope=only
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = NETWORK NODE SERVER LIST
IST1252I DEFINED NETWORK NODE SERVER LIST, NAME = NNSL2J
IST1253I ****NAMELESS****      SLUINIT = OPT      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1256I CURRENT NETWORK NODE SERVER
IST1253I NETA.SSCP1A           SLUINIT = OPT      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1677I PREFERRED NETWORK NODE SERVER
IST1253I NONE
IST314I END
Displaying a network node server list with one explicit entry and no nameless entry using SCOPE=ALL (no preferred network node server has been defined):
d net,netsrvr,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = NETWORK NODE SERVER LIST
IST1252I DEFINED NETWORK NODE SERVER LIST, NAME = NNSL2B
IST1253I NETA.SSCP1A           SLUINIT = OPT      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1254I SERVER LIST PROCESSED ORDER = FIRST
IST924I ------------------------------------------------------------
IST1255I OTHER NETWORK NODES ALLOWED AS SERVERS
IST1253I NONE
IST924I ------------------------------------------------------------
IST1256I CURRENT NETWORK NODE SERVER
IST1253I NETA.SSCP1A           SLUINIT = OPT      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1677I PREFERRED NETWORK NODE SERVER
IST1253I NONE
IST314I END
Displaying a network node server list with one explicit entry and no nameless entry using SCOPE=ONLY (no preferred network node server has been defined):
d net,netsrvr,scope=only
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = NETWORK NODE SERVER LIST
IST1252I DEFINED NETWORK NODE SERVER LIST, NAME = NNSL2B
IST1253I NETA.SSCP1A           SLUINIT = OPT      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1254I SERVER LIST PROCESSED ORDER = FIRST
IST924I ------------------------------------------------------------
IST1256I CURRENT NETWORK NODE SERVER
IST1253I NETA.SSCP1A           SLUINIT = OPT      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1677I PREFERRED NETWORK NODE SERVER
IST1253I NONE
IST314I END

Displaying the preferred network node server using SCOPE=ALL. A network node server list has not been activated.

d net,netsrvr,scope=all
IST097I  DISPLAY ACCEPTED
IST350I  DISPLAY TYPE = NETWORK NODE SERVER LIST
IST1252I DEFINED NETWORK NODE SERVER LIST, NAME = NONE                
IST1253I NONE                                                         
IST924I ------------------------------------------------------------
IST1255I OTHER NETWORK NODES ALLOWED AS SERVERS                       
IST1253I NETA.SSCP1A           SLUINIT = REQ      ENBCAST = NO        
IST924I ------------------------------------------------------------
IST1256I CURRENT NETWORK NODE SERVER                                  
IST1253I NETA.SSCP1A           SLUINIT = REQ      ENBCAST = NO        
IST924I ------------------------------------------------------------
IST1677I PREFERRED NETWORK NODE SERVER                                
IST1253I NETA.SSCP1A           SLUINIT = REQ      ENBCAST = NO        
IST314I END                                                          

Displaying the preferred network node server using SCOPE=ONLY. A network node server list has not been activated.

d net,netsrvr,scope=only
IST097I  DISPLAY ACCEPTED   
IST350I  DISPLAY TYPE = NETWORK NODE SERVER LIST   
IST1252I DEFINED NETWORK NODE SERVER LIST, NAME = NONE     
IST1253I NONE                                              
IST924I ------------------------------------------------------------
IST1256I CURRENT NETWORK NODE SERVER                       
IST1253I NETA.SSCP1A           SLUINIT = REQ      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1677I PREFERRED NETWORK NODE SERVER                     
IST1253I NETA.SSCP1A           SLUINIT = REQ      ENBCAST = NO
IST314I END                                                

Displaying a network node server list with four explicit entries and one nameless entry using SCOPE=ALL. A preferred network node server has been defined.

d net,netsrvr,scope=all
IST097I  DISPLAY ACCEPTED    
IST350I  DISPLAY TYPE = NETWORK NODE SERVER LIST        
IST1252I DEFINED NETWORK NODE SERVER LIST, NAME = NNSL2A        
IST1253I NETA.SSCPBA           SLUINIT = OPT      ENBCAST = NO  
IST1253I NETA.SSCPCA           SLUINIT = REQ      ENBCAST = NO  
IST1253I NETA.SSCPDA           SLUINIT = OPT      ENBCAST = NO  
IST1253I NETA.SSCPEA           SLUINIT = REQ      ENBCAST = NO  
IST1253I ****NAMELESS****      SLUINIT = REQ      ENBCAST = NO  
IST924I ------------------------------------------------------------
IST1254I SERVER LIST PROCESSED ORDER = FIRST                    
IST1255I OTHER NETWORK NODES ALLOWED AS SERVERS                
IST1253I NETA.SSCP1A           SLUINIT = REQ      ENBCAST = NO  
IST924I ------------------------------------------------------------
IST1256I CURRENT NETWORK NODE SERVER                            
IST1253I NETA.SSCP1A           SLUINIT = REQ      ENBCAST = NO  
IST924I ------------------------------------------------------------
IST1677I PREFERRED NETWORK NODE SERVER         
IST1253I NETA.SSCP1A           SLUINIT = REQ      ENBCAST = NO
IST314I END                                    
 

Displaying a network node server list with seven explicit entries and no nameless entry using SCOPE=ALL. A preferred network node server has been defined.

d net,netsrvr,scope=all
IST097I  DISPLAY ACCEPTED       
IST350I DISPLAY TYPE = NETWORK NODE SERVER LIST  
IST1252I DEFINED NETWORK NODE SERVER LIST, NAME = NNSL2B 
IST1253I NETA.SSCPXX           SLUINIT = REQ      ENBCAST = NO
IST1253I NETA.SSCPAA           SLUINIT = REQ      ENBCAST = NO
IST1253I NETC.SSCP9C           SLUINIT = REQ      ENBCAST = NO
IST1253I NETA.SSCPBA           SLUINIT = OPT      ENBCAST = NO
IST1253I NETA.SSCPCA           SLUINIT = REQ      ENBCAST = NO
IST1253I NETA.SSCPDA           SLUINIT = OPT      ENBCAST = NO
IST1253I NETA.SSCPEA           SLUINIT = REQ      ENBCAST = NO
IST924I ------------------------------------------------------------
IST1254I SERVER LIST PROCESSED ORDER = FIRST           
IST924I ------------------------------------------------------------
IST1255I OTHER NETWORK NODES ALLOWED AS SERVERS        
IST1253I NETA.SSCP1A           SLUINIT = REQ       ENBCAST = NO
IST924I ------------------------------------------------------------
IST1256I CURRENT NETWORK NODE SERVER                   
IST1253I NETA.SSCP1A           SLUINIT = REQ       ENBCAST = NO
IST924I ------------------------------------------------------------
IST1677I PREFERRED NETWORK NODE SERVER             
IST1253I NETA.SSCP1A           SLUINIT = REQ       ENBCAST = NO
IST314I END                                                                                                               

Displaying a network node server list with two explicit entries and no nameless entry using SCOPE=ALL. The primary network node server has been defined with ENBCAST=NO; a backup-mode network node server (used to enable generic resources with a network node server that is not attached to the same generic resource structure) is defined with ENBCAST=YES. The primary network node server is also defined as the preferred network node server.

d net,netsrvr,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = NETWORK NODE SERVER LIST
IST1252I DEFINED NETWORK NODE SEVER LIST, NAME = NNSL2B
IST1253I NETA.SSCP1A           SLUINIT = REQ     ENBCAST = NO
IST1253I NETA.SSCPXX           SLUINIT = REQ     ENBCAST = YES
IST924I ------------------------------------------------------------
IST1254I SERVER LIST PROCESSED ORDER = FIRST
IST924I ------------------------------------------------------------
IST1255I OTHER NETWORK NODES ALLOWED AS SERVERS
IST1253I NONE
IST924I ------------------------------------------------------------
IST1256I CURRENT NETWORK NODE SERVER
IST1253I NETA.SSCP1A           SLUINIT = REQ     ENBCAST = NO
IST924I ------------------------------------------------------------
IST1677I PREFERRED NETWORK NODE SERVER
IST1253I NETA.SSCP1A           SLUINIT = REQ     ENBCAST = NO