Displays detailed information about TCP connections and UDP sockets, including some recently closed ones. The purpose of this report is to aid in debugging problems with TCP connections and UDP sockets.
Provide the report for a specific TCP/IP address space by using TCp tcpname. See The Netstat command target for more information about the TCp parameter.
The default output option displays the output on the user's terminal. For other options, see The TSO NETSTAT command syntax or Netstat command output.
>>-+-APPLD--appldata-------------------+----------------------->< | .----------------. | | V | | +-CLIent------clientname---+--------+ +-HOSTName--hostname----------------+ | .-----------------------. | | V | | +-IPAddr----+-ipaddr------------+-+-+ | +-ipaddr/prefixLen--+ | | '-ipaddr/subnetmask-' | | .----------------. | | V | | +-IPPort----ipaddr+portnum-+--------+ +-NOTN3270--------------------------+ | .-------------. | | V | | +-POrt------portnum---+-------------+ '-SMCID--+-smcid-+------------------' '-*-----'
Provide the report for a specific TCP/IP address space by using -p tcpname. See The Netstat command target for more information about the -p parameter.
The default output option displays the output to z/OS UNIX shell stdout. For other options, see The z/OS UNIX netstat command syntax or Netstat command output.
.----------------. V | >>-+- -B----ipaddr+portnum-+--------+-------------------------->< | .----------------. | | V | | +- -E------clientname---+--------+ +- -G--appldata------------------+ +- -H--hostname------------------+ | .-----------------------. | | V | | +- -I----+-ipaddr------------+-+-+ | +-ipaddr/prefixLen--+ | | '-ipaddr/subnetmask-' | | .-------------. | | V | | +- -P------portnum---+-----------+ +- -T----------------------------+ '- -U--+-smcid-+-----------------' '-*-----'
Result: At the end of the report, Netstat displays the host name that the resolver used for the resolution and the list of IP addresses returned from the resolver that it used as filters.
Guideline: The port number can be either a local or remote port.
The filter value for CLIent/-E, IPAddr/-I, and APPLD/-G can be a complete string or a partial string using wildcard characters. A wildcard character can be an asterisk (*), which matches a null string or any character or character string, at the same position. A wildcard character can be a question mark (?), which matches any single character at the same position. For example, a string searchee matches with *ar?he*, but the string searhee does not match *ar?he*. To use the wildcard character on the IPAddr/-I filter, specify the value in the ipaddr format. The wildcard character is not accepted for the ipaddr/prefixlen or ipaddr/subnetmask format of IPAddr/-I values.
When you use z/OS UNIX netstat/onetstat command in a z/OS® UNIX shell environment, take care if you use a z/OS UNIX MVS™ special character in a character string. It might cause an unpredictable result. To be safe, if you want to use a z/OS UNIX MVS special character in a character string, surround the character string with single (') or double (") quotation marks. For example, to use an asterisk (*) in the IP address, 10.*.0.0 for the -I filter, issue the command as: netstat -A -I '10.*.0.0'.
NETSTAT ALL
Display detailed information about TCP connections and UDP sockets in the default
TCP/IP stack.
NETSTAT ALL TCP TCPCS6
Display detailed information about TCP connections and UDP sockets in TCPCS6 stack.
NETSTAT ALL TCP TCPCS8 (IPADDR 9.43.1.1 9.43.2.2
Display detailed information about those TCP connections and UDP sockets in TCPCS8
stack whose local or remote IP addresses match the specified filter IP address values.
NETSTAT ALL (PORT 2222 6666 88
Display detailed information about those TCP connections and UDP sockets in the
default TCP/IP stack whose local or remote ports match the specified filter port
numbers.
NETSTAT ALL SERVER TCP TCPCS
Display detailed information about those TCP connections in listen state on
TCP/IP stack TCPCS
NETSTAT ALL TCP TCPCS (IPPORT 127.0.0.1+21
Display detailed information about connections using ip address 127.0.0.1 and
port 21 on TCP/IP stack TCPCS
netstat -A
netstat -A -p tcpcs6
netstat -A -p tcpcs6 -I 9.43.1.1 9.43.2.2
netstat -A -P 2222 6666 88
netstat -A SERVER -p tcpcs
netstat -A -B 127.0.0.1+21 -p tcpcs
The following examples are generated by using TSO NETSTAT command. Using the z/OS UNIX netstat command displays the data in the same format as the TSO NETSTAT command.
NETSTAT ALL
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 22:24:30
Client Name: FTPD1 Client Id: 000000F9
Local Socket: 9.42.104.43..21 Foreign Socket: 9.42.103.165..1035
BytesIn: 0000000035 BytesOut: 0000000265
SegmentsIn: 0000000017 SegmentsOut: 0000000014
StartDate: 01/09/2012 StartTime: 22:04:11
Last Touched: 22:04:18 State: Establsh
RcvNxt: 0214444666 SndNxt: 0216505563
ClientRcvNxt: 0214443596 ClientSndNxt: 0216504670
InitRcvSeqNum: 0214443560 InitSndSeqNum: 0216504404
CongestionWindow: 0000007336 SlowStartThreshold: 0000065535
IncomingWindowNum: 0214477396 OutgoingWindowNum: 0216538247
SndWl1: 0214444666 SndWl2: 0216505563
SndWnd: 0000032684 MaxSndWnd: 0000032768
SndUna: 0216505563 rtt_seq: 0216505479
MaximumSegmentSize: 0000000524 DSField: 00
Round-trip information:
Smooth trip time: 102.000 SmoothTripVariance: 286.000
ReXmt: 0000000000 ReXmtCount: 0000000000
DupACKs: 0000000000 RcvWnd: 0000032730
SockOpt: 85 TcpTimer: 00
TcpSig: 84 TcpSel: 60
TcpDet: E0 TcpPol: 00
TcpPrf: 40
QOSPolicy: No
TTLSPolicy: Yes
TTLSRule: server
TTLSGrpAction: group_action1
TTLSEnvAction: Environment1
RoutingPolicy: No
ReceiveBufferSize: 0000016384 SendBufferSize: 0000016384
ReceiveDataQueued: 0000000000
SendDataQueued: 0000000000
SendStalled: No
Ancillary Input Queue: Yes
BulkDataIntfName: OSAQDIO4
Application Data: EZAFTP0S C USER1 PTS305
----
Client Name: FTPD1 Client Id: 000000F6
Local Socket: 0.0.0.0..21 Foreign Socket: 0.0.0.0..0
BytesIn: 0000000000 BytesOut: 0000000000
SegmentsIn: 0000000000 SegmentsOut: 0000000000
StartDate: 01/09/2012 StartTime: 22:04:11
Last Touched: 21:41:09 State: Listen
RcvNxt: 0000000000 SndNxt: 0000000000
ClientRcvNxt: 0000000000 ClientSndNxt: 0000000000
InitRcvSeqNum: 0000000000 InitSndSeqNum: 0000000000
CongestionWindow: 0000000000 SlowStartThreshold: 0000000000
IncomingWindowNum: 0000000000 OutgoingWindowNum: 0000000000
SndWl1: 0000000000 SndWl2: 0000000000
SndWnd: 0000000000 MaxSndWnd: 0000000000
SndUna: 0000000000 rtt_seq: 0000000000
MaximumSegmentSize: 0000000536 DSField: 00
Round-trip information:
Smooth trip time: 0.000 SmoothTripVariance: 1500.000
ReXmt: 0000000000 ReXmtCount: 0000000000
DupACKs: 0000000000 RcvWnd: 0000032768
SockOpt: 80 TcpTimer: 00
TcpSig: 00 TcpSel: 20
TcpDet: C0 TcpPol: 00
TcpPrf: 40
QOSPolicy: No
TTLSPolicy: No
RoutingPolicy: No
ReceiveBufferSize: 0000016384 SendBufferSize: 0000016384
ConnectionsIn: 0000000001 ConnectionsDropped: 0000000000
MaximumBacklog: 0000000010 ConnectionFlood: No
CurrentBacklog: 0000000000
ServerBacklog: 0000000000 FRCABacklog: 0000000000
CurrentConnections: 0000000001 SEF: 98
Quiesced: No
SharePort: WLM
RawWeight: 63 NormalizedWeight: 15
Abnorm: 10 Health: 100
RawCP: 060 RawzAAP: 000 RawzIIP: 040
PropCP: 040 PropzAAP: 000 PropzIIP: 023
ILWeighting: 1 XcostzAAP: 001 XcostzIIP: 001
Application Data: EZAFTP0D
----
Client Name: TCPCS Client Id: 0000000C
Local Socket: 9.67.115.5..23 Foreign Socket: 9.27.11.182..4665
BytesIn: 0000001062 BytesOut: 0000000480
SegmentsIn: 0000000019 SegmentsOut: 0000000019
StartDate: 01/09/2012 StartTime: 16:46:15
Last Touched: 16:46:15 State: Establsh
RcvNxt: 3296375906 SndNxt: 3296308452
ClientRcvNxt: 3296375906 ClientSndNxt: 3296308452
InitRcvSeqNum: 3296374843 InitSndSeqNum: 3296307971
CongestionWindow: 0000340353 SlowStartThreshold: 0000016384
IncomingWindowNum: 3296408638 OutgoingWindowNum: 3296341180
SndWl1: 3296375906 SndWl2: 3296308452
SndWnd: 0000032728 MaxSndWnd: 0000032768
SndUna: 3296308452 rtt_seq: 3296308412
MaximumSegmentSize: 0000065483 DSField: 00
Round-trip information:
Smooth trip time: 37.000 SmoothTripVariance: 101.000
ReXmt: 0000000000 ReXmtCount: 0000000000
DupACKs: 0000000000
SockOpt: 00 TcpTimer: 00
TcpSig: 00 TcpSel: C0
TcpDet: F0 TcpPol: 00
TcpPrf: 40
QOSPolicy: Yes
QOSRuleName: QosRule1
TTLSPolicy: Yes
TTLSRule: TTLSRule1
TTLSGrpAction: TTLSGrpAction1
TTLSEnvAction: TTLSEnvAction1
TTLSConnAction: TTLSConnAction1 (Stale)
RoutingPolicy: Yes
RoutingTableName: prTabl
RoutingRuleName: SecLow2
ReceiveBufferSize: 0000016384 SendBufferSize: 0000016384
ReceiveDataQueued: 000000002C
OldQDate: 09/15/06 OldQTime: 03:36:32
SendDataQueued: 000002C000
OldQDate: 09/15/06 OldQTime: 03:36:32
SendStalled: No
SMC information:
SMCStatus: Active SMCGroupId: 00000100
LocalSMCLinkId: 00000101 RemoteSMCLinkId: 00000301
LocalSMCRcvBuf: 64K RemoteSMCRcvBuf: 64K
Ancillary Input Queue: N/A
Application Data: EZBTNSRV TCPM1001 TSO10002 ET ST14S
----
Client Name: APPV4 Client Id: 00000015
Local Socket: 0.0.0.0..2049 Foreign Socket: 9.42.103.99..1234
BytesIn: 0000000200 BytesOut: 0000000100
DgramIn: 0000000010 DgramOut: 0000000005
StartDate: 06/16/2011 StartTime: 22:53:55
Last Touched: 16:00:29
MaxSendLim: 0000065535 MaxRecvLim: 0000065535
SockOpt: 00 DSField: 00
QOSPolicy: Yes
QOSRuleName: QosRule2
RoutingPolicy: Yes
RoutingTableName: prTab4
RoutingRuleName: SecLow4
ReceiveDataQueued: 0000000000 ReceiveMsgCnt: 0000000000
----
Client Name: SYSLOGD1 Client Id: 00000010
Local Socket: 0.0.0.0..514 Foreign Socket: *..*
BytesIn: 0000000000 BytesOut: 0000000000
DgramIn: 0000000000 DgramOut: 0000000000
StartDate: 06/16/2011 StartTime: 23:33:52
Last Touched: 16:46:29
MaxSendLim: 0000065535 MaxRecvLim: 0000065535
SockOpt: 00 DSField: 00
QOSPolicy: No
RoutingPolicy: No
ReceiveDataQueued: 0000000000 ReceiveMsgCnt: 0000000000
----
NETSTAT ALL
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 22:06:44
Client Name: FTPD1 Client Id: 0000006D
Local Socket: ::1..21
Foreign Socket: ::1..1026
BytesIn: 00000000000000000035
BytesOut: 00000000000000000265
SegmentsIn: 00000000000000000015
SegmentsOut: 00000000000000000015
StartDate: 01/09/2012 StartTime: 22:04:11
Last Touched: 22:05:51 State: Establsh
RcvNxt: 0634886921 SndNxt: 0634950319
ClientRcvNxt: 0634885851 ClientSndNxt: 0634949426
InitRcvSeqNum: 0634885815 InitSndSeqNum: 0634949160
CongestionWindow: 0000299155 SlowStartThreshold: 0000065535
IncomingWindowNum: 0634919651 OutgoingWindowNum: 0634983003
SndWl1: 0634886921 SndWl2: 0634950319
SndWnd: 0000032684 MaxSndWnd: 0000032768
SndUna: 0634950319 rtt_seq: 0634950235
MaximumSegmentSize: 0000065463 DSField: 00
Round-trip information:
Smooth trip time: 81.000 SmoothTripVariance: 270.000
ReXmt: 0000000000 ReXmtCount: 0000000000
DupACKs: 0000000000 RcvWnd: 0000032730
SockOpt: 8500 TcpTimer: 00
TcpSig: 85 TcpSel: 64
TcpDet: E0 TcpPol: 00
TcpPrf: 40
QOSPolicy: No
TTLSPolicy: Yes
TTLSRule: server
TTLSGrpAction: group_action1
TTLSEnvAction: Environment1
RoutingPolicy: No
ReceiveBufferSize: 0000016384 SendBufferSize: 0000016384
ReceiveDataQueued: 0000000000
SendDataQueued: 0000000000
SendStalled: No
Ancillary Input Queue: Yes
BulkDataIntfName: OSAQDIO4
Application Data: EZAFTP0S C USER1 PTS305
----
Client Name: FTPD1 Client Id: 0000005B
Local Socket: ::..21
Foreign Socket: ::..0
BytesIn: 00000000000000000000
BytesOut: 00000000000000000000
SegmentsIn: 00000000000000000000
SegmentsOut: 00000000000000000000
StartDate: 01/09/2012 StartTime: 22:05:11
Last Touched: 22:05:41 State: Listen
RcvNxt: 0000000000 SndNxt: 0000000000
ClientRcvNxt: 0000000000 ClientSndNxt: 0000000000
InitRcvSeqNum: 0000000000 InitSndSeqNum: 0000000000
CongestionWindow: 0000000000 SlowStartThreshold: 0000000000
IncomingWindowNum: 0000000000 OutgoingWindowNum: 0000000000
SndWl1: 0000000000 SndWl2: 0000000000
SndWnd: 0000000000 MaxSndWnd: 0000000000
SndUna: 0000000000 rtt_seq: 0000000000
MaximumSegmentSize: 0000000536 DSField: 00
Round-trip information:
Smooth trip time: 0.000 SmoothTripVariance: 1500.000
ReXmt: 0000000000 ReXmtCount: 0000000000
DupACKs: 0000000000 RcvWnd: 0000032768
SockOpt: 8000 TcpTimer: 00
TcpSig: 01 TcpSel: 20
TcpDet: C0 TcpPol: 00
TcpPrf: 40
QOSPolicy: No
TTLSPolicy: No
RoutingPolicy: No
ReceiveBufferSize: 0000016384 SendBufferSize: 0000016384
ConnectionsIn: 0000000001 ConnectionsDropped: 0000000000
MaximumBacklog: 0000000010 ConnectionFlood: No
CurrentBacklog: 0000000000
ServerBacklog: 0000000000 FRCABacklog: 0000000000
CurrentConnections: 0000000001 SEF: 100
Quiesced: No
SharePort: WLM
RawWeight: 63 NormalizedWeight: 15
Abnorm: 10 Health: 100
RawCP: 060 RawzAAP: 000 RawzIIP: 040
PropCP: 040 PropzAAP: 000 PropzIIP: 023
Application Data: EZAFTP0D
----
Client Name: TCPCS Client Id: 0000001E
Local Socket: 9.67.115.5..23
Foreign Socket: 9.27.11.182..4665
BytesIn: 00000000000000001062
BytesOut: 00000000000000000480
SegmentsIn: 00000000000000000019
SegmentsOut: 00000000000000000018
StartDate: 01/09/2012 StartTime: 14:27:37
Last Touched: 14:27:37 State: Establsh
RcvNxt: 2776729719 SndNxt: 2776682484
ClientRcvNxt: 2776729719 ClientSndNxt: 2776682484
InitRcvSeqNum: 2776728656 InitSndSeqNum: 2776682003
CongestionWindow: 0000340353 SlowStartThreshold: 0000016384
IncomingWindowNum: 2776762451 OutgoingWindowNum: 2776715212
SndWl1: 2776729719 SndWl2: 2776682484
SndWnd: 0000032728 MaxSndWnd: 0000032768
SndUna: 2776682484 rtt_seq: 2776682444
MaximumSegmentSize: 0000065483 DSField: 00
Round-trip information:
Smooth trip time: 100.000 SmoothTripVariance: 163.000
ReXmt: 0000000000 ReXmtCount: 0000000000
DupACKs: 0000000000
SockOpt: 0000 TcpTimer: 00
TcpSig: 00 TcpSel: C0
TcpDet: F0 TcpPol: 00
TcpPrf: 40
QOSPolicy: Yes
QOSRuleName: QosRule1
TTLSPolicy: Yes
TTLSRule: TTLSRule1
TTLSGrpAction: TTLSGrpAction1
TTLSEnvAction: TTLSEnvAction1
TTLSConnAction: TTLSConnAction1 (Stale)
RoutingPolicy: Yes
RoutingTableName: prTabl
RoutingRuleName: SecLow2
ReceiveBufferSize: 0000016384 SendBufferSize: 0000016384
ReceiveDataQueued: 0000000000
SendDataQueued: 0000000000
SendStalled: No
SMC information:
SMCStatus: Inactive
SMCReason: 00005303 - No active RNICs for the PNetID
Ancillary Input Queue: N/A
Application Data: EZACICSO CSKL 0000038 CICSUSER CICP
----
Client Name: APPV4 Client Id: 00000015
Local Socket: 0.0.0.0..2049
Foreign Socket: 9.42.103.99..1234
BytesIn: 00000000000000000200
BytesOut: 00000000000000000100
DgramIn: 00000000000000000010
DgramOut: 00000000000000000005
StartDate: 06/17/2011 StartTime: 16:00:29
Last Touched: 16:00:29
MaxSendLim: 0000065535 MaxRecvLim: 0000065535
SockOpt: 00000000 DSField: 00
QOSPolicy: Yes
QOSRuleName: QosRule2
RoutingPolicy: Yes
RoutingTableName: prTab4
RoutingRuleName: SecLow4
ReceiveDataQueued: 0000345655 ReceiveMsgCnt: 0000045644
OldQDate: 09/15/06 OldQTime: 03:36:32
Multicast Specific:
TimeToLive: 0000000001 Loopback: Yes
OutgoingIpAddr: 199.1.2.3
Group IncomingIpAddr SrcFltMd
----- -------------- --------
224.8.8.8 193.1.1.94 Exclude
SrcAddr: 20.20.20.20
22.22.22.22
----
Client Name: APPV6 Client Id: 00000016
Local Socket: ::..2050
Foreign Socket: 12AB::1..1235
BytesIn: 00000000000000000200
BytesOut: 00000000000000000100
DgramIn: 00000000000000000010
DgramOut: 00000000000000000005
StartDate: 06/17/2011 StartTime: 16:00:29
Last Touched: 16:00:29
MaxSendLim: 0000065535 MaxRecvLim: 0000065535
SockOpt: 00000000 DSField: 00
QOSPolicy: No
RoutingPolicy: No
ReceiveDataQueued: 0000000000 ReceiveMsgCnt: 0000000000
Multicast Specific:
HopLimit: 0000000001 Loopback: Yes
OutgoingIntf:
Group: ff03::333
IncomingIntf: LINK6 SrcFltMd: Exclude
SrcAddr: 2e00::7
2e00::8
----
Client Name: SYSLOGD1 Client Id: 0000002C
Local Socket: 0.0.0.0..529
Foreign Socket: *..*
BytesIn: 00000000000000000000
BytesOut: 00000000000000000000
DgramIn: 00000000000000000000
DgramOut: 00000000000000000000
StartDate: 06/17/2011 StartTime: 14:27:42
Last Touched: 14:27:42
MaxSendLim: 0000065535 MaxRecvLim: 0000065535
SockOpt: 00000000 DSField: 00
QOSPolicy: No
RoutingPolicy: No
ReceiveDataQueued: 0000345655 ReceiveMsgCnt: 0000004564
OldQDate: 09/15/06 OldQTime: 03:36:32
ReceiveBufferSize: 0000016384 SendBufferSize: 0000016384
----
The DSField represents one of the following values:
Common socket options:
IPv6 socket options:
For an Enterprise Extender (EE) UDP socket entry, the RoutingPolicy value is always No. Display the routing policy information for an Enterprise Extender (EE) UDP socket entry by using the DISPLAY NET,EEDIAG,TEST=YES command. See z/OS Communications Server: SNA Operation for details.
When the RoutingPolicy value is Yes, the following information is displayed:
For more information about the cluster connection type, see the z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference. For more information about the SIOCGPARTNERINFO ioctl, see z/OS Communications Server: IP Programmer's Guide and Reference.
The TCP trusted connection flag is a 1-byte hexadecimal field and can have the following values:
For information about trusted TCP/IP connections and the SIOCGPARTNERINFO and SIOCSPARTNERINFO ioctl calls, see z/OS Communications Server: IP Programmer's Guide and Reference.
When using SHAREPORTWLM, the SEF value is used to modify the WLM server-specific weights, thereby influencing how new connection setup requests are distributed to the servers sharing this port. When using SHAREPORT, the SEF value is used to weight the distribution of new connection setup requests among the SHAREPORT servers. Whether SHAREPORT or SHAREPORTWLM are specified, the SEF value is reported back to the distributor to be used as part of the target server responsiveness fraction calculation, which influences how new connection setup requests are distributed to the target servers.
The greater the Abnorm rate field value, the greater the reduction WLM applies to the recommendation for this target instance. For more information about the conditions that cause the abnormal transaction completions for a given server application, see the documentation provided by the server application.
If applications do not provide this transaction status to WLM or SHAREPORTWLM is not configured, then this field has the value 0. For more information about workload management interfaces, see z/OS MVS Programming: Workload Management Services.
The reduction in the WLM recommendation is proportional to value of the Health indicator. For example, if the health value is 20%, WLM reduces the recommendation for this server by 80%. For more information about the conditions leading to a health indicator of less than 100, see the documentation for the server application.
If applications do not provide this health indicator to WLM or SHAREPORTWLM is not configured, then the value of this field is 100. For more information about workload management interfaces, see z/OS MVS Programming: Workload Management Services.
20 Low
40 Medium
80 High
C0 Network
For outgoing multicast data the following field descriptions apply: