$P NETSRV(nnnnn)

Function

To Stop the JES2 specified NETSERV interface. As a result, JES2 rejects all new connections from TCPIP. The NETSERV will not terminate until all active connections using this NETSERV terminate.

Syntax


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

>--+--------------------------------+--------------------------->
   '-| Selection limiting keyword |-'   

>--+---------------------------+-------------------------------><
   '-| Modification keywords |-'   

Modification keywords

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

Selection limiting keyword

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

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

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

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

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

Parameters

(nn)|(nn-mm): A single or range of numeric values between 1 to 999.
RESTART=(Yes|No,interval): Specifies 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=socket (Selection limiting keyword): Specifies the name of a local socket which the NETSRV should listen upon.
STACK=stack (Selection limiting keyword): Filters based on the name of the TCP/IP stack to be used by this server.
ASID=asid (Selection limiting keyword): Specifies the hexadecimal address space id associated with the active NETSRV. asid is 1 to 4 hexadecimal digits.
NAME=name (Selection limiting keyword): 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.

Authority Required

This command requires system 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 control 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  $pnetsrv(2)

$HASP898 NETSRV2 STATUS=DRAINING,ASID=0027,NAME=JES2S002
$HASP898         SOCKET=S2,STACK=

 2  $pnetsrv1,restart=no

$HASP898 NETSRV1
$HASP898 NETSRV1    STATUS=DRAINING,ASID=0029,NAME=JESAS001,
$HASP898            SOCKET=LOCAL,STACK=