$D SOCKET (xxxxxxxx) - Display the characteristics of a socket
Function
To display the characteristics of a socket.
Syntax
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)
- Displays whether an NJE connection is automatically attempted for this socket. The interval is the approximate 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. A third positional displays the approximate time (yyyy.ddd,hh:mm) when the next attempt is made.
- IPADDR=
- Displays the TCP/IP address or host name that is associated with this socket. The default value,
*LOCAL, indicates all IP addresses available at the start netserver time are to be considered.
If the status of the socket is active, the TCP/IP address or host name the socket is connected to is displayed. If the status of the socket is inactive, the configured value for the socket is displayed.
- PORT=
- Displays the port number that is associated with this socket. The default is the value that is
associated with VMNET (typically 175) if SECURE=NO, and the value associated with NJENET-SSL
(typically 2252) if SECURE=YES.
If the status of the socket is active, the port number that the socket is connected to is displayed. If the status of the socket is inactive, the configured value for the socket is displayed.
- PORTNAME=
- If PORT= is specified as the default value, it displays either VMNET or NJENET-SSL, depending on the value of SECURE=.
- LINE=
- Specifies a TCP/IP line that is to be dedicated to this socket.
- NODE=
- Specifies the NJE node that is 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 that is associated with the socket.
- SECURE=
- Indicates whether SSL/TLS is to be used or not 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.
- SOCKID=
- Displays the socket ID assigned by IAZNJTCP (display only).
- STATUS=
- Specifies the current status of the socket.
- ACTIVE/line/netserv
- Indicates that the socket is active on the displayed line and netserv.
- INACTIVE
- Indicates that the socket is currently not being used.
Authority Required
This command requires display 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 read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.
Scope
Single system. The values supplied for this command are in effect for this member only.
Messages
$HASP897
Examples
1 $dsocket(wsc)
$HASP897 SOCKET(WSC)
$HASP897 SOCKET(WSC) STATUS=ACTIVE/LNE26/NETSRV1,
$HASP897 IPADDR=9.57.1.179,PORT=175,
$HASP897 PORTNAME=VMNET,SECURE=NO,LINE=0,
$HASP897 NODE=2,REST=0,NETSRV=0,SOCKID=S1
2 $dsocket(node4)
$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