$D NETSRV(nnnnn)

Function

To display the characteristics of a network server.

Syntax


>>-$D--+-NETSRV--+--+--------------------------------------+---->
       +-NETSERV-+  +-nn--+------------+-------------------+   
       '-NSV-----'  |     '- ---+-mm-+-'                   |   
                    |           '-*--'                     |   
                    |    .-,--------------------------.    |   
                    |    V                            |    |   
                    '-(------+-nn-+--+------------+---+--)-'   
                             '-*--'  '- ---+-mm-+-'            
                                           '-*--'              

>--+-------------------------------+---------------------------->
   '-| Display limiting keywords |-'   

>--+---------------------------------+-------------------------><
   '-| Selection limiting keywords |-'   

Display limiting keywords

|--+-------+--+-------+--+-------+--+----------+---------------->
   '-,ASID-'  '-,LONG-'  '-,NAME-'  '-,RESTART-'   

>--+-----------+--+---------+--+--------+--+---------+---------->
   '-,SESSIONS-'  '-,SOCKet-'  '-,STACK-'  '-,STATUS-'   

>--+--------------------------------------+---------------------|
   |                   .-,-----------.    |   
   |                   V             |    |   
   '-,--TRaceio--=--(----+-Common--+-+--)-'   
                         +-Jes-----+          
                         '-Verbose-'          

Selection limiting keywords

|--+------------------------------+----------------------------->
   '-,--+---+--ASID--+-=--+--asid-'   
        '-/-'        +-^=-+           
                     +->--+           
                     '-<--'           

>--+------------------------------+----------------------------->
   '-,--+---+--NAME--+-=--+--name-'   
        '-/-'        +-^=-+           
                     +->--+           
                     '-<--'           

>--+-------------------------------------------------------------+-->
   '-,--+---+--RESTART--+-=--+--+-+-YES-+----------------------+-'   
        '-/-'           '-^=-'  | '-NO--'                      |     
                                '-(--+-YES-+--+-----------+--)-'     
                                     '-NO--'  '-,interval-'          

>--+----------------------------------+------------------------->
   '-,--+---+--SOCKet--+-=--+--socket-'   
        '-/-'          +-^=-+             
                       +->--+             
                       '-<--'             

>--+--------------------------------+--------------------------->
   '-,--+---+--STACK--+-=--+--stack-'   
        '-/-'         +-^=-+            
                      +->--+            
                      '-<--'            

>--+----------------------------------------+------------------->
   '-,--+---+--STATUS--+-=--+--+-ACTIVE---+-'   
        '-/-'          '-^=-'  +-DRAINED--+     
                               +-DRAINING-+     
                               '-INACTIVE-'     

>--+---------------------------------------------------------------------+--|
   |                          .-,-----------------------------------.    |   
   |                          V                                     |    |   
   '-,--+---+--TRaceio--=--(----+-+---+--Common--+-=--+--+-No--+--+-+--)-'   
        '-/-'                   | '-/-'          '-^=-'  '-Yes-'  |          
                                +-+---+--Jes--+-=--+--+-No--+-----+          
                                | '-/-'       '-^=-'  '-Yes-'     |          
                                +-+---+--Verbose--+-=--+--+-No--+-+          
                                | '-/-'           '-^=-'  '-Yes-' |          
                                +-+---+--Yes----------------------+          
                                | '-/-'                           |          
                                '-+---+--No-----------------------'          
                                  '-/-'

Parameters

RESTART=(Yes|No,interval)

Displays whether this NETSRV will be restarted if it is drained. The interval is the time (in minutes) between attempted restarts. The valid range for interval is 0 to 1440. An interval value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used.

SOCKET=

Specifies the name of a local socket which the NETSRV should listen upon.

TRaceio=(YES|NO|JES=YES|NO|COMMON=YES|NO|VERBOSE=YES|NO)

Displays or filters based on the trace settings of the server.

YES: Indicates all types of tracing are to be done (JES, COMMON, VERBOSE).
NO: Indicates no tracing is to be done.
JES=YES|NO: Indicates whether data and control records passed between JES and TCP/IP are to be traced for this server.
COMMON=YES|NO: Indicates whether TCP/IP and other services called by IAZNJTCP are to be traced.
VERBOSE=YES|NO: Indicates whether diagnostic messages are to be issued to the master console and SYSLOG.

STACK=

Displays or filters based on the name of the TCP/IP stack to be used by this server. End of change

ASID=

Specifies the hexadecimal address space id associated with the active NETSRV.

NAME=

Specifies the address space name associated with the active NETSRV. The address space name is the subsystem name followed by the character 'S' followed by the 3–digit device number, for example, JES2S001.

SESSIONS=

Displays a list of all the active connections associated with this server (line number/socket name).

STATUS=

Displays the status of the server.

LONG=

Displays extended parameters associated with the server (including SESSIONS)

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single system. The values supplied for this command will be in effect for this member only.

Messages

$HASP898

Examples

 1 $dnetsrv2

$HASP898 NETSRV2
$HASP898 NETSRV2 STATUS=ACTIVE,ASID=0027,NAME=JES2S002
$HASP898         SOCKET=S2,STACK=,TRACEIO=(JES=NO,COMMON=NO,
$HASP898         VERBOSE=NO)

 2 $dnetsrv1

$HASP898 NETSRV1    STATUS=DRAINED,RESTART=(YES,2),SOCKET=LOCAL, 
$HASP898            STACK=,TRACEIO=(JES=NO,COMMON=NO,VERBOSE=NO)