$ADD NETSRV(nnn)

Function

To dynamically create a network server device, as a JES2 TCP/IP interface.

Syntax


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

>--+-------------------------------------------------------+---->
   |                  .-NO--.                              |   
   '-,--RESTART--=--+-+-YES-+----------------------------+-'   
                    '-(--+-YES-+--+-----------------+--)-'     
                         '-NO--'  |    .-0--------. |          
                                  '-,--+-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-1440. An interval value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used. The default RESTART value is No, and the default interval value is 0.

SOCKET=

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

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. If you omit the TRACEIO keyword or specify its value as NO, the subparameters (JES,COMMON,VERBOSE) will be set to NO.
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=

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

Authority Required

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

Messages

$HASP898

Example

$addnetserv3                                          
$HASP898 NETSRV3                                      
$HASP898 NETSRV3    STATUS=DRAINED,RESTART=(NO),SOCKET=,STACK=, 
$HASP898            TRACEIO=(JES=NO,COMMON=NO,VERBOSE=NO)