Adding a TCP/IP/NJE Network Server *MODIFY,NETSERV,ADD=

Function

Use the *MODIFY,NETSERV,ADD= command to dynamically add a new TCP/IP/NJE Network Server.

Syntax


                                          (1)   
>>-+-*MODIFY-+--,NETSERV--,ADD=--ntsvname----------------------->
   '-*F------'                                  

>--+----------------------+--+-------------------+-------------->
   '-,HOSTNAME=--hostname-'  '-,PORT=--+-0-----+-'   
                                       '-nnnnn-'     

>--+-------------------+--+--------------------+---------------->
   '-,SYSTEM=--sysname-'  '-,STACK=--stackname-'   

>--+-------------------+--+-------------------+----------------->
   '-,ITRACE=--+-NO--+-'  '-,JTRACE=--+-NO--+-'   
               '-YES-'                '-YES-'     

>--+-------------------+---------------------------------------><
   '-,VTRACE=--+-NO--+-'   
               '-YES-'

Notes:

More than one parameter can be specified at a time and in any order.

Parameters

ADD=ntsvname: Specifies the name of the Netserv to be added. The name must contain only A-Z, @, $, #, or 0-9 and cannot start with a digit.
HOSTNAME=hostname: Specifies the IP host name or IP address that the Netserv uses to listen over TCP/IP for incoming data. This name can be omitted or specified as HOSTNAME=* to use the default, which is to tell TCP/IP to listen over any IP address that is defined for this processor. Multiple Netservs can listen over the default, but only one Netserv can listen over a specific host name and port combination if a host name is specified.
The host name can consist of up to 60 characters and must be a legal TCP/IP IP address or host name defined to the TCP/IP resolver. The host name can be in IPV4 or IPV6 format.
PORT=0|nnnnn: Specifies a port number that the Netserv uses, in combination with the host name, to listen over TCP/IP for incoming data. The port must be a number from 0 to 65,535. A port of 0 indicates that when the Netserv starts, a standard service name of VMNET will be used instead of a numeric port. The service of VMNET corresponds to port 175. Although there is a corresponding port for the service NJENET-SSL, it is suggested that you use the TLS=YES parameter on the NJERMT statement or *MODIFY,NJE command instead.
SYSTEM=sysname: Specifies the name of the system that the Netserv runs on. If the SYSTEM= parameter is omitted, or specified as SYSTEM=*, the Netserv will run on the current global.
STACK=stackname: Specifies the name of the stack that TCP/IP uses to get its definitions. If the STACK= is omitted, or specified as STACK=*, TCP/IP will use its default stack. When only an INET configuration is being used, any specification of a stack name is ignored.
ITRACE=NO|YES: Indicates whether internal tracing in the Netserv address space is to be active. Internal tracing shows TCP/IP data records that are sent and received between IAZNJTCP and TCP/IP.
JTRACE=NO|YES: Indicates whether JES tracing is to be active. JES tracing occurs during JES specific exit points in the Netserv during which data records, headers, and trailers are transmitted and received.
VTRACE=NO|YES: Indicates whether verbose tracing is to be active. Verbose tracing involves various diagnostic messages being written to the console and job log from the Netserv address space.

Rules

The Netserv to be added must be a valid name for an address space.
It is the responsibility of the installation to provide security definitions for the added Netserv. See z/OS JES3 Initialization and Tuning Guide for information about defining Netservs.
For more information see the Rules description in Modifying a TCP/IP/NJE Network Server *MODIFY,NETSERV=.

Results

The Netserv is added.

Example

*F,NETSERV,ADD=NEWNTSV