Modifying a TCP/IP/NJE Socket *MODIFY,SOCKET=

Function

Use the *MODIFY,SOCKET=sockname command to modify an existing socket definition.

Syntax


                               (1)                             
>>-+-*MODIFY-+--,SOCKET=--name------+----------------------+---->
   '-*F------'                      '-,HOSTNAME=--hostname-'   

>--+-------------------+--+---------------------+--------------->
   '-,PORT=--+-0-----+-'  '-,NETSERV=--ntsvname-'   
             '-nnnnn-'                              

>--+------------------+--+-------------------+------------------>
   '-,NODE=--nodename-'  '-,ITRACE=--+-NO--+-'   
                                     '-YES-'     

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

Notes:

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

Parameters

SOCKET=name

Specifies a 1-8 character name that uniquely identifies this socket. 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 this socket uses to communicate with TCP/IP.

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.

HOSTNAME=* can be specified to remove any existing HOSTNAME assignment.

PORT=0|nnnnn

Specifies a port number that the socket uses, in combination with the host name, to communicate with TCP/IP. The port must be a number from 0 to 65,535. A port of 0 indicates that when the socket starts, a standard service name of VMNET will be used. The service name 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.

NETSERV=ntsvname

Specifies the name of the Netserv on which the socket is activated. This parameter does not need to be specified at initialization time, but if omitted, it must be modified later. Otherwise, the socket cannot be started.

NERSERV=* can be specified to remove any existing NETSERV assignment.

NODE=nodename

Specifies the name of the node that uses this socket. This parameter does not need to be specified at initialization time, but if omitted, it must be modified later. Otherwise, the socket cannot be started.

NODE=* can be specified to remove any existing NODE assignment.

ITRACE=NO|YES

Indicates whether internal tracing in the Netserv address space is to be active.

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

HOSTNAME= can be abbreviated to HOST=.
Active sockets cannot be modified, except for ITRACE, JTRACE, and VTRACE.

Results

The socket is modified and the change takes effect immediately.

Examples

*F,SOCKET=SKBOSTON,NODE=BOSTON

*F,SOCKET=SKBOSTON,HOST=MYCORP.COM

*F,SOCKET=SKBOSTON,JTRACE=YES