Displays:
o Device socket counters
o Current settings from the running communications software
(A device socket is composed of two parts: the Internet device
(interface) and the socket.)
Format
SHOW DEVICE_SOCKET [ device_socket ]
[ /CONTINUOUS[=n] ]
[ /FULL ]
[ /HOST=host ]
[ /[NO]LOCAL ]
[ /PORT=n ]
[ /SERVICE=service ]
[ /TYPE=socket_type ]
1 – Parameters
device_socket
Optional. Default: All device sockets.
Device socket for which you want information.
Specify the characters BG and the device's unit number, for
example, BG3, BG17.
2 – Qualifiers
2.1 /CONTINUOUS
/CONTINUOUS[=n]
Optional. Default: Static display; /CONTINUOUS=4.
Automatically updates the display.
Screen update interval in seconds. Valid only for a specific
device socket.
To terminate the display, press Ctrl/C.
2.2 /FULL
Optional. The default is to give a brief listing of the
information.
Displays complete information, including:
o Application option settings, for example, ACCEPT or FULL_
DUPLEX_CLOSE
o State of the service
o Counters for receiving and sending buffers
2.3 /HOST
/HOST=host
Optional. Default: All hosts.
Displays information for device sockets bound to the specified
host.
This does not include device sockets bound to the "ANY host"
(address 0.0.0.0).
2.4 /LOCAL
/LOCAL
/NOLOCAL
Optional. Default: /LOCAL.
Displays information for device sockets bound to hosts in the
local hosts database.
/NOLOCAL: Displays information for device sockets bound to hosts
in the hosts database and hosts known by the BIND resolver.
2.5 /PORT
/PORT=n
Optional. Default: All local ports.
Displays information for device sockets bound to the specified
local port.
2.6 /SERVICE
/SERVICE=service
Optional. Default: All services.
Displays information for device sockets used for the specified
service. To specify a lowercase or mixed-case service name,
enclose it in quotation marks.
2.7 /TYPE
/TYPE=socket_type
Optional. Default: /TYPE=ALL.
Displays information for the specified type of device socket.
Specify one of the following:
o STREAM
o DGRAM
3 – Examples
1.TCPIP> SHOW DEVICE_SOCKET BG21 /FULL
Displays complete information about device socket BG21,
including the options that are set, for example, the FULL_
DUPLEX_CLOSE option.
(With the FULL_DUPLEX_CLOSE option set, the first data
transmission on a TCP connection that has been closed by the
remote application returns an EPIPE error. Subsequent send
operations on the half-closed socket proceed normally.)
The following table describes the counters in the first column
of the display.
Counter Meaning
Q0LEN Number of sockets that are about to be connected to
the specified socket
QLEN Number of sockets that have established a connection
but have not yet been accepted by the specified
socket
QLIMIT Number of sockets for the Q0LEN and QLEN sockets
TIMEO Not used
ERROR Error code temporarily stored on the socket
OOBMARK Out-of-band mark
2.TCPIP> SHOW DEVICE_SOCKET BG75 /CONTINUOUS=10
Displays information about device socket BG75 every 10 seconds.
3.TCPIP> SHOW DEVICE_SOCKET /HOST="lark"
Displays information about all device sockets for remote host
lark.
4.TCPIP> SHOW DEVICE_SOCKET BG1898
Port Remote
Device_socket Type Local Remote Service Host
bg1898 STREAM 23 2568 TELNET 16.20.176.227
Displays socket type, service, and host information for device
BG1898.