Netstat SRCIP/-J report
Displays the job-specific and destination-specific information that is configured using the SRCIP profile statement. See z/OS Communications Server: IP Configuration Reference for more information about the SRCIP statement.
TSO syntax
Target
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.
Output
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.
z/OS UNIX syntax
Target
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.
Output
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.
Command syntax examples
From TSO environment
NETSTAT SRCIPFrom UNIX shell environment
netstat -JReport examples
The following examples are generated using the TSO NETSTAT command. The z/OS UNIX netstat command displays the data in the same format as the TSO NETSTAT command.
Not IPv6 enabled (SHORT format)
NETSTAT SRCIP
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 20:30:49
Source IP Address Based on Job Name:
Job Name Type Flg Source
-------- ---- --- ------
* IPV4 C 9.67.5.16
T* IPV4 S 9.67.5.15
TCPUSR1* IPV4 B 9.67.5.12
U* IPV4 C 9.67.5.14
USER1* IPV4 S 9.67.5.13
USER12 IPV4 B 9.67.5.11
Source IP Address Based on Destination:
Destination Source
----------- ------
10.1.0.0/16 9.1.1.2
10.1.1.1 9.1.1.1 IPv6 enabled or request for LONG format
NETSTAT SRCIP
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 20:30:49
Source IP Address Based on Job Name:
Job Name Type Flg Source
-------- ---- --- ------
* IPV4 C 9.67.5.16
* IPV6 C DVIPA66
T* IPV4 S 9.67.5.15
T* IPV6 S 2000::9:67:5:15
TCPUSR1* IPV4 B 9.67.5.12
TCPUSR2* IPV6 B DVIPA62
TCPUSR3* IPV6 TEMPADDRS
TCPUSR4* IPV6 PUBLICADDRS
U* IPV4 C 9.67.5.14
U* IPV6 C DVIPA64
USER* IPV6 C 2000::9:67:5:13
USER1* IPV4 C 9.67.5.13
USER12 IPV4 C 9.67.5.11
U27 IPV6 C 2000::9:67:5:11
Source IP Address Based on Destination:
Destination: 10.1.0.0/16
Source: 9.1.1.2
Destination: 10.1.1.1
Source: 9.1.1.1
Destination: 2001:0db8::0522:f103
Source: 2000::9:67:5:10
Destination: 2001:0db8::/32
Source: DVIPA66 Report field descriptions
- Destination
- A destination IP address, network address, or subnet address for which the designated source should be used to provide the source IP address for an outbound TCP connection. If a connection's destination address matches more than one Destination value, the most complete match is selected. The Destination designations are ignored if a connection's job name matches a Job Name value with at least one non-wildcard character, but a Destination match overrides a JOBNAME * match.
- Job Name
- The name of the job that matches this entry. The job name can
end in an asterisk (*). Any job that is running that begins with the
same characters that precede the asterisk matches this designation.
If several different designations exist, then the matching entry is
determined by the most complete match: either an exact match, or the
entry that has the most matching characters before the asterisk in
the job-specific source IP address designation. An asterisk (*) in
this field indicates that all of the applications match the entry.
When an IP address or interface name is displayed in the Source column, the Job Name value is the name of the job or jobs for which the designated interface should be used as the source IP address. An asterisk (*) indicates that all applications that issue TCP connect requests are associated with the specified source IP address or interface. They override any existing TCPSTACKSOURCEVIPA specifications except for outbound connections whose destination address matches a Destination value.
When TEMPADDRS is displayed in the Source column, the Job Name value is the name of the job or jobs that should prefer a temporary IPv6 address over a public IPv6 address when the default source address selection algorithm is used to select the source IP address. When PUBLICADDRS is displayed in the Source column, the Job Name value is the name of the job or jobs that should prefer a public IPv6 address over a temporary IPv6 address when the default source address selection algorithm is used to select the source IP address. An asterisk (*) in the Job Name column indicates that all the applications match the entry. See the information about default source address selection in z/OS Communications Server: IPv6 Network and Application Design Guide.
- Type
- The address family to which this job-specific source IP address applies, either IPv4 or IPv6. An entry for which the value TEMPADDRS or PUBLICADDRS is displayed in the Source column always has the value IPv6.
- Flg
- The flags represent parameter values defined with the JOBNAME
parameter on the SRCIP profile statement.
- B
- The value Both was specified for this SRCIP JOBNAME statement. This JOBNAME statement is used for both TCP client and server applications. For server applications it is applied for only servers that invoke the bind() function call with the IPv4 INADDR_ANY address or the IPv6 unspecified address (in6addr_any).
- C
- The value Client was specified for this SRCIP JOBNAME statement (or was set by default). This JOBNAME statement is used for TCP outbound (client) connections only.
- S
- The value Server was specified for this SRCIP JOBNAME statement. This JOBNAME statement is used for server applications that invoke the bind() function call with the IPv4 INADDR_ANY address or the IPv6 unspecified address (in6addr_any).
This field is blank for an entry that displays the value TEMPADDRS or PUBLICADDRS in the Source column.
- Source
-
- IP address or interface name
- The interface name or IP address that is used to supply a source
IP address for TCP client or server applications.
- When the source address is displayed after the destination display line, TCP client applications that have a destination IP address that matches the corresponding destination value use this source address.
- When the source address is displayed with job name values, both IPv4 and IPv6 TCP client and server applications that have a job name that matches the corresponding job name value use this source address depending on the flag field value (Both, Client only, or Server only).
- TEMPADDRS
- Indicates that a temporary IPv6 address should be preferred over a public IPv6 address when IPv6 default address selection is used to select the source IP address for the specified job.
- PUBLICADDRS
- Indicates that a public IPv6 address should be preferred over a temporary IPv6 address when IPv6 default address selection is used to select the source IP address for the specified job.