$T SOCKET

Function

To modify the characteristics of a SOCKET used for NJE over TCP/IP.

Syntax


>>-$T--SOCKet--------------------------------------------------->

>--+-'--xxxxxxxx--'---------------------------------------+----->
   |    .-,------------------------------------------.    |   
   |    V                                            |    |   
   '-(----+-xxxxxxxx-------+--+--------------------+-+--)-'   
          +-'--xxxxxxxx--'-+  +- ---xxxxxxxx-------+          
          '-*--------------'  +- ---'--xxxxxxxx--'-+          
                              '- -*----------------'          

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

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

Modification keywords

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

>--+----------------+--+------------+--------------------------->
   '-,IPaddr=ipaddr-'  '-,LINE=line-'   

>--+---------------------------+--+------------+---------------->
   '-,--+-NETSERV-+--=--netsrv-'  '-,NODE=node-'   
        +-NETSRV--+                                
        '-NSV-----'                                

>--+------------+--+------------+--+-----------------------+----|
   '-,Port=port-'  '-,REST=rest-'  '-,--SECURE--=--+-No--+-'   
                                                   '-Yes-'     

Selection limiting keywords

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

>--+----------------------------------+------------------------->
   '-,----/----IPaddr--+-=--+--ipaddr-'   
                       '-^=-'             

>--+------------------------------+----------------------------->
   '-,----/----LINE--+-=--+--line-'   
                     +-^=-+           
                     +->--+           
                     '-<--'           

>--+---------------------------------------+-------------------->
   '-,--+---/----NETSERV-+--+-=--+--netsrv-'   
        +---/----NETSRV--+  +-^=-+             
        '---/----NSV-----'  +->--+             
                            '-<--'             

>--+------------------------------+----------------------------->
   '-,----/----NODE--+-=--+--node-'   
                     +-^=-+           
                     +->--+           
                     '-<--'           

>--+------------------------------+----------------------------->
   '-,----/----Port--+-=--+--port-'   
                     +-^=-+           
                     +->--+           
                     '-<--'           

>--+------------------------------+----------------------------->
   '-,----/----REST--+-=--+--rest-'   
                     +-^=-+           
                     +->--+           
                     '-<--'           

>--+-----------------------------------+------------------------>
   '-,----/----SECURE--+-=--+--+-No--+-'   
                       '-^=-'  '-Yes-'     

>--+----------------------------------+------------------------->
   '-,----/----SOCKID--+-=--+--sockid-'   
                       +-^=-+             
                       +->--+             
                       '-<--'             

>--+----------------------------------------+-------------------|
   '-,--+---+--STATUS--+-=--+--+-ACTIVE---+-'   
        '-/-'          '-^=-'  '-INACTIVE-'

Parameters

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.
CONNECT=(Yes|No|DEFAULT,interval): Specifies whether an NJE connection is automatically attempted for this socket. If DEFAULT is specified, processing uses the CONNECT=(YES|NO) value that is specified on the associated NODE statement. The interval is the time (in minutes) between attempted connections. The valid range for interval is 0 to 1440. A value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used.
IPADDR=: Specifies the TCP/IP address or hostname associated with this socket. The default value, *LOCAL, indicates all IP addresses available at the start netserver time 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.
NETSRV=: Specifies the device number of the NETSRV to be used when connecting to this remote socket.
REST=: Specifies the resistance associated with the socket.
SECURE=YES|NO: Specifies whether (YES) or not (NO) SSL/TLS is to be used when communicating with this socket
SOCKID=: Displays the socket id assigned by IAZNJTCP (display only).
STATUS=ACTIVE|INACTIVE: Specifies the current status of the 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.

Examples

 1   $tsocket (s3),ipaddr=9.57.2.174

$HASP897 SOCKET(s3) IPADDR=9.57.2.174,PORTNAME=VMNET,
$HASP897            SECURE=NO,LINE=0,NODE=2,REST=0,
$HASP897            NETSRV=1

 2   $tsocket(node4),connect=(yes,2)

$HASP897 SOCKET(NODE4)
$HASP897 SOCKET(NODE4)     STATUS=INACTIVE,IPADDR=9.117.0.0,
$HASP897                   PORTNAME=VMNET,CONNECT=(YES,2),  
$HASP897                   SECURE=NO,LINE=0,NODE=4,REST=0,  
$HASP897                   NETSRV=0