$T NETSRV(nnnnn)

Function

To modify the attributes of a network server.

Syntax


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

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

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

Modification keywords

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

>--+----------------+--+--------------+------------------------->
   '-,SOCKet=socket-'  '-,STACK=stack-'   

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

Selection limiting keywords

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

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

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

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

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

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

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

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)

Specifies whether tracing is to be active, and which types of traces are to be activated for the server.

YES: Indicates all types of tracing are to be done (JES, COMMON, VERBOSE).
NO: Indicates no tracing is to be done (JES, COMMON, VERBOSE).
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=stack

Specifies the name of a TCP/IP stack to be used by this server when the Common INET (CINET) configuration is being used. If not specified, all stacks on the local machine will be used. Start of change

When only an INET configuration is being used, specification of a stack name is ignored. End of change

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. The $T NODE(nnnn) command sets command authority for a node.

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 member. The values supplied for this command will be in effect for this member only.

Messages

$HASP898

Examples

 1 $t netsrv1,socket=local

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

 2 $tnetsrv1,restart=(yes,2)

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