Netstat SOCKets/-s report

CLIent/-E clientname

Filter the output of the SOCKets/-s report using the specified client name clientname. You can enter up to six filter values and each specified value can be up to eight characters long.

HOSTName/-H hostname

Filter the output of the SOCKets/-s report using the specified host name hostname. You can enter one filter value at a time and the specified value can be up to 255 characters long.

Result: At the end of the report, Netstat will display 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.

Restrictions:

1. The HOSTName/-H filter does not support wildcard characters.
2. Using the HOSTName/-H filter might cause delays in the output due to resolution of the hostname value, depending upon resolver and DNS configuration.

IPAddr/-I ipaddrIPAddr/-I ipaddr/prefixlengthIPAddr/-I ipaddr/subnetmask

Filter the report output using the specified IP address ipaddr, ipaddr/prefixlength, or ipaddr/subnetmask. You can enter up to six filter values. Each specified IPv4 ipaddr value can be up to 15 characters in length and each selected IPv6 ipaddr value can be up to 45 characters in length.

ipaddr

Filter the output of the SOCKets/-s report using the specified IP address ipaddr. For IPv4 addresses, the default subnet mask of 255.255.255.255 is used. For IPv6 addresses, the default prefixlength of 128 is used.

ipaddr/prefixlength

Filter the output of the SOCKets/-s report using the specified IP address and prefix length ipaddr/prefixlength. For an IPv4 address, the prefix length range is 1 – 32. For an IPv6 address, the prefix length range is 1 – 128.

ipaddr/subnetmask

Filter the output of the SOCKets/-s report using the specified IP address and subnet mask ipaddr/subnetmask. The IP address ipaddr in this format must be an IPv4 IP address.

Guidelines:

1. The filter value ipaddr can be an address to which the socket is bound or connected.
2. For an IPv6-enabled stack:
   • Both IPv4 and IPv6 ipaddr values are accepted and can be mixed on the IPAddr/-I option.
   • An IPv4-mapped IPv6 address is accepted as a valid ipaddr value and will usually provide the same result as its IPv4 address does.

Restrictions:

1. The filter value for an IPv6 address does not support wildcard characters.
2. For an IPv4-only stack, only IPv4 ipaddr values are accepted.
3. For a UDP endpoint socket, the filter value applies only to the local or source IP address.

IPPort/-B ipaddr+portnum

Filter the report output of the SOCKets/-s report using the specified IP address and port number. You can enter up to six filter values. Each specified IPv4 ipaddr value can be up to 15 characters in length, denoting a single IPv4 IP address; each specified IPv6 ipaddr value can be up to 45 characters in length, denoting a single IPv6 IP address. Valid portnum values are in the range 0 – 65535. The filter values ipaddr and portnum will match any combination of the local and remote IP address and local and remote port.

Guidelines:

• The filter value ipaddr can be either the local or remote IP address.
• For an IPv6-enabled stack, the following apply:
  • Both IPv4 and IPv6 ipaddr values are accepted and can be mixed on the IPPort/-B option.
  • An IPv4-mapped IPv6 address is accepted as a valid ipaddr value and usually provides the same result as the IPv4 address.

Restrictions:

• The ipaddr value in the IPPort/-B filter does not support wildcard characters.
• For an IPv4-only stack, only IPv4 ipaddr values are accepted.
• An entry is returned only when both the ipaddr and portnum values match.
• For a UDP endpoint socket, the filter value applies only to the local or source IP address and port.

NOTN3270/-T

Filter the output of the SOCKets/-s report, excluding TN3270 server connections.

POrt/-P portnum

Filter the output of the SOCKets/-s report using the specified port number portnum. You can enter up to six filter values.

Guideline: The port number can be a port to which the socket is bound or connected.

Restriction: For a UDP endpoint socket, the filter value applies only to the local or source port.

The filter value for CLIent/-E and IPAddr/-I 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 with "*ar?he*". If you want to use the wildcard character on the IPAddr/-I filter, you must 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 -s -I '10.*.0.0' or netstat -s -I "10.*.0.0".

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.