Function

To define a SOCKET statement for use in NJE over TCP/IP. SOCKETs map an IP address and port combination to an NJE node. You can also use SOCKETs to define the IP address and port that a local NETSERV listens on.

Parameters

CONNECT=(Yes|No|DEFAULT,interval)

Specifies whether an NJE connection is automatically attempted for this socket. For the default value DEFAULT, processing uses the CONNECT=(YES|NO) value that is specified on the associated NODE statement. The interval is the approximate time (in minutes) between attempted connections. The valid range for interval is 0 to 1440. The default interval value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used.

xxxxxxxx

Specifies the 1 to 8 character name of this socket. Installations can assign any name to a SOCKET. You can only use it in $SN commands and on NETSERV statements.

IPADDR=

Specifies the TCP/IP address or hostname associated with this socket. The default value, *LOCAL, indicates all IP addresses associated with the local machine are to be considered.

PORT=

Specifies the port number associated with this socket. The default is the value associated with VMNET (typically 175) if SECURE=NO, and the value associated with NJENET-SSL (typically 2252) if SECURE=YES. The range is 0-32767.

LINE=

Specifies a TCP/IP line which is to be dedicated to this socket.

NODE=

Specifies the NJE node associated with this socket. Both the symbolic name and the corresponding numeric value are valid.

NETSRV=

Specifies the device number of the NETSRV to be used when connecting to this remote socket. $ADDSOCKET and $ADDNETSRV commands are interdependent. You can enter a non-existent netsrv value in the $ADDSOCKET command, if the netsrv value is created before the connection is established.

REST=

Specifies the resistance associated with the socket. The default value is 0.

SECURE=YES|NO

Specifies whether (YES) or not (NO) SSL/TLS is to be used when communicating with this socket.

YES

Indicates that SSL/TLS is to be used when communicating with this socket.

NO

Indicates that SSL/TLS is not to be used when communicating with this socket.

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

Messages

$HASP897