Starting Netstat
The NETSTAT program can be used under any user ID with the SHOW-NETSTAT-STATISTICS/NETSTAT command.
NETSTAT -h gives an overview of all available subcommands.
Example
/SHOW-NET-STATISTICS or NETSTAT
SHOW-NET-STATISTICS/NETSTAT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ARGUMENTS=...
Definition of the parameter list.
ARGUMENTS=*NO
Use the old parameter list (see the following list of parameters).
ARGUMENTS= <text 1..1800>
Use options from the new parameter list. A list of all available options can be found in Program call (BCAM V25B, #162).
IP-ADDRESSES=...
Show own IP addresses.
IP-ADDRESSES=*NO
Do not show own IP addresses.
IP-ADDRESSES=*YES
Show own IP addresses.
The display consists of a table with the following columns:
IP address | Own IP address |
Mask | Network mask of this IP address |
If | Name of the interface that corresponds to the IP address |
INTERNET-ADDRESSES=...
Show own IP/IPv6 addresses.
INTERNET-ADDRESSES=*NO
Do not show own IP/IPv6 addresses.
INTERNET-ADDRESSES=*YES
Show own IP/IPv6 addresses.
The display consists of a table with the following columns:
IP Address | Own IP/IPv6 address with prefix length specified |
Mac Address | Physical address of the network connection |
L4 If | Name of the Layer 4 Interfaces |
L2 If | Name of the line |
INTERFACE-VALUES=...
Show interface values.
INTERFACE-VALUES=*NO
Do not show interface values.
INTERFACE-VALUES=*YES(...)
Show interface values.
If just one INTERFACE-NAME that does not equal *ANY is specified, the display is limited to the interfaces with the specified names.
INTERFACE-NAME1 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
,INTERFACE-NAME2 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
,INTERFACE-NAME3 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
,INTERFACE-NAME4 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
,INTERFACE-NAME5 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
The display consists of a table containing the following columns:
Name | Name of the interface |
MTU | Maximum number of bytes per packet |
PacketsIn | Number of received packets |
BytesIn | Number of received bytes |
IosIn | Number of input operations |
ErrorsIn | Number of received packets with errors |
PacketsOut | Number of sent packets |
BytesOut | Number of sent bytes |
IosOut | Number of output operations |
ErrorsOut | Number of sent packets with errors |
INTERFACE-RATE=...
Shows the interface rate, i.e. the throughput rate for each interface.
INTERFACE-RATE=*NO
Do not show interface rate.
INTERFACE-RATE=*YES
Show interface rate.
If just one INTERFACE-NAME that does not equal *ANY is specified, the display is limited to the interfaces with the specified names.
INTERFACE-NAME1 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
,INTERFACE-NAME2 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
,INTERFACE-NAME3 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
,INTERFACE-NAME4 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
,INTERFACE-NAME5 = *ANY/<composed-name_1..8>
Name of the interface to be shown.
The first display consists of the following values for each interface:
Name | Name of the interface |
PacketsIn | Number of received packets |
BytesIn | Number of received bytes |
ErrorsIn | Number of received packets with errors |
PacketsOut | Number of sent packets |
BytesOut | Number of sent bytes |
ErrorsOut | Number of sent packets with errors |
If the WAITTIME parameter has been specified, a line is displayed with the differential time, and all the other lines contain the differential values compared with the previous request time divided by the WAITTIME value.
dt(s) | Differential time compared with previous request time (in seconds) |
Name | Name of the interface |
PktsIn/s | Number of packets received per second during the WAITTIME interval |
BytesIn/s | Number of bytes received per second during the WAITTIME interval |
ErrIn | Number of packets received with errors during the WAITTIME interval |
PktsOut/s | Number of packets sent per second during the WAITTIME interval |
BytesOut/s | Number of bytes sent per second during the WAITTIME interval |
ErrOut | Number of packets sent with errors during the WAITTIME interval |
INTERFACE-SUM=...
Shows the sum of all the interfaces.
INTERFACE-SUM=*NO
Do not show the sum of all the interfaces.
INTERFACE-SUM=*YES
Show the sum of all the interfaces.
The sum of the following values of all the interfaces is determined:
dt(s) | Differential time compared with previous request time (in seconds) |
PacketsIn | Number of received packets |
BytesIn | Number of received bytes |
ErrorsIn | Number of received packets with errors |
PacketsOut | Number of sent packets |
BytesOut | Number of sent bytes |
ErrorsOut | Number of sent packets with errors |
INTERFACE-SUM-RATE=...
Shows the interface sum rate, i.e. the total throughput of all interfaces.
INTERFACE-SUM-RATE=*NO
Do not show interface sum rate.
INTERFACE-SUM-RATE=*YES
Show interface sum rate.
This function determines the sum of the values shown for all interfaces.
The first display consists of the sum of the following values:
PacketsIn | Number of received packets |
BytesIn | Number of received bytes |
ErrorsIn | Number of received packets with errors |
PacketsOut | Number of sent packets |
BytesOut | Number of sent bytes |
ErrorsOut | Number of sent packets with errors |
If the WAITTIME parameter has been specified, all the other lines contain the differential values compared with the previous request time divided by the WAITTIME value.
dt(s) | Differential time compared with previous request time (in seconds) |
PktsIn/s | Number of packets received per second during the WAITTIME interval |
BytesIn/s | Number of bytes received per second during the WAITTIME interval |
ErrIn | Number of packets received with errors during the WAITTIME interval |
PktsOut/s | Number of packets sent per second during the WAITTIME interval |
BytesOut/s | Number of bytes sent per second during the WAITTIME interval |
ErrOut | Number of packets sent with errors during the WAITTIME interval |
DEVICE-VALUES=...
Shows the device connections.
DEVICE-VALUES = *NO
No device connections are shown.
DEVICE-VALUES = *YES
The device connections are shown.
The output consists of a table with the following columns:
Name | Name of the device connection |
DvMnemonic Write | Device Mnemonic Write |
DvMnemonic Read | Device Mnemonic Read |
Name Device | Name of the device connection |
Name Typ | Name of the type of device connection |
MTU | Maximum number of bytes contained in a packet |
PacketsIn | Number of received packets |
BytesIn | Number of received bytes |
IosIn | Number of input operations |
ErrorsIn | Number of faulty received packets |
PacketsOut | Number of transmitted packets |
BytesOut | Number of transmitted bytes |
IosOut | Number of output operations |
ErrorsOut | Number of faulty transmitted packets |
Ntyp | Specify type of interface, either line or dev(ice) |
MAC-ADDRESSES=...
Shows known MAC addresses.
MAC-ADDRESSES=*NO
Do not show MAC addresses.
MAC-ADDRESSES=*YES
Show MAC addresses.
The display consists of a table with the following values:
If | Name of the interface which is used to access the shown address |
IP-Address | IP address of the system |
MAC-Address | MAC address that corresponds to the IP address (if known) |
Type | Type of assignment of the MAC address to the IP address; |
ALL-MAC-ADDRESS=...
Shows all known MAC addresses (own and partner MAC addresses).
ALL-MAC-ADDRESSES=*NO
Do not show all MAC addresses.
ALL-MAC-ADDRESSES=*YES
Shows all MAC addresses.
The display consists of the table specified in MAC-ADRESSES.
OWN-MAC-ADDRESS=...
Shows the own MAC addresses which are known.
OWN-MAC-ADDRESSES=*NO
Do not show own MAC addresses.
OWN-MAC-ADDRESSES=*YES
Shows own MAC addresses.
The display consists of the table specified in MAC-ADRESSES.
PARTNER-MAC-ADDRESS=...
Shows the known partner MAC addresses.
PARTNER-MAC-ADDRESS=*NO
Do not show the partner MAC addresses.
PARTNER-MAC-ADDRESS=*YES
Shows the partner MAC addresses.
The display consists of the table specified in MAC-ADRESSES.
ROUTING=...
Shows routing information.
ROUTING=...*NO
Do not show routing information.
ROUTING=...*YES
Show routing information.
The display consists of a table with the following values:
Dest | IP address of the target system, where 0.0.0.0 specifies the default router |
NextHop | IP address of the first intermediate system |
Mask | Subnet mask of the intermediate system |
Type | Type of route; possible values: other, invalid, direct, indirect |
If | Name of the network port which belongs to the IP address |
Creation | Type of route creation; |
ALL-STATISTICS=...
Shows the ICMP, IP, TCP and UDP statistics.
ALL-STATISTICS=*NO
Do not show ICMP, IP, TCP and UDP statistics.
ALL-STATISTICS=*YES
Show ICMP, IP, TCP and UDP statistics.
The values shown are described below under the ICMP-STATISTICS, IP-STATISTICS, TCP-STATISTICS and UDP-STATISTICS functions.
IP-STATISTICS=...
Shows IP statistics.
IP-STATISTICS=*NO
Do not show IP statistics.
IP-STATISTICS=*YES
Show IP statistics.
The display contains the following values:
ipForwarding | Possible values: |
ipDefaultTTL | Value of Time-To-Live (TTL), which is entered in IP packets to be sent |
ipInReceives | Number of IP packets received (including packets with errors) |
ipInHdrErrors | Number of IP packets received, which were ignored due to an IP header error |
ipInAddrErrors | Number of IP packets received, which were ignored due to an incorrect destination address |
ipForwDatagrams | Number of routed IP packets |
ipInUnknownProtos | Number of IP packets received, which were ignored due to unknown or unsupported protocols |
ipInDiscards | Number of correct IP packets received, which were ignored for other reasons (e.g. shortage of memory) |
ipInDelivers | Number of successfully delivered IP packets (including ICMP packets) |
ipOutRequests | Number of IP packets to be sent (only routed packets) |
ipOutDiscards | Number of IP packets not sent (e.g. due to shortage of memory) |
ipOutNoRoutes | Number of IP packets to be sent, which were ignored due to missing routing information |
ipReasmTimeout | Time (in seconds) within which IP reassembling must be completed |
ipReasmReqds | Number of IP fragments to be reassembled |
ipReasmOKs | Number of successfully reassembled IP fragments |
ipReasmFails | Number of errors that occurred during reassembly |
ipFragOKs | Number of successfully fragmented IP packets |
ipFragFails | Number of IP packets that were not fragmented successfully |
ipFragCreates | Number of created IP fragments |
ipRoutingDiscards | Number of deleted routing entries |
ICMP-STATISTICS=...
Shows ICMP statistics.
ICMP-STATISTICS=*NO
Do not show ICMP statistics.
ICMP-STATISTICS=*YES
Show ICMP statistics.
The display contains the following values:
icmpInMsgs | Number of ICMP messages received (including messages with errors) |
icmpInErrors | Number of ICMP messages received with errors |
icmpInDestUnreachs | Number of Destination Unreachable messages |
icmpInTimeExcds | Number of Time Exceeded messages received |
icmpInParmProbs | Number of Parameter Problem messages received |
icmpInSrcQuenchs | Number of Source Quench messages received |
icmpInRedirects | Number of Redirect messages received |
icmpInEchos | Number of Echo Request messages received |
icmpInEchoReps | Number of Echo Reply messages received |
icmpInTimestamps | Number of Time Stamp Request messages received |
icmpInTimestamp | Number of Time Stamp Reply messages received |
icmpInAddrMasks | Number of Address Mask Request messages received |
icmpInAddrMaskReps | Number of Address Mask Reply messages received |
icmpOutMsgs | Number of ICMP requests to be sent |
icmpOutErrors | Number of ICMP requests to be sent with errors |
icmpOutDest | Number of Destination Unreachable messages sent |
icmpOutTimeExcds | Number of Time Exceeded messages sent |
icmpOutParmProbs | Number of Parameter Problem messages sent |
icmpOutSrcQuenchs | Number of Source Quench messages sent |
icmpOutRedirects | Number of Redirect messages sent |
icmpOutEchos | Number of Echo Request messages sent |
icmpOutEchoReps | Number of Echo Reply messages sent |
icmpOutTimestamps | Number of Time Stamp Request messages sent |
icmpOut | Number of Time Stamp Reply messages sent |
icmpOutAddrMasks | Number of Address Mask Request messages sent |
icmpOutAddr | Number of Address Mask Reply messages sent |
TCP-STATISTICS=...
Shows TCP statistics.
TCP-STATISTICS=*NO
Do not show TCP statistics.
TCP-STATISTICS=*YES
Show TCP statistics.
The display contains the following values:
tcpRtoAlgorithm | Retransmit algorithm used |
tcpRtoMin | Minimum time (in milliseconds) after which a retransmit occurs |
tcpRtoMax | Maximum time (in milliseconds) after which a retransmit occurs |
tcpMaxConn | Maximum number of TCP connections |
tcpActiveOpens | Number of actively opened TCP connections |
tcpPassiveOpens | Number of passively opened TCP connections |
tcpAttemptFails | Number of TCP connections opened with errors |
tcpEstabResets | Number of TCP connections established with RESET |
tcpCurrEstab | Number of TCP connections currently open |
tcpInSegs | Number of TCP segments received |
tcpOutSegs | Number of TCP segments sent |
tcpRetransSegs | Number of TCP segments sent, which required a retransmit |
tcpInErrs | Number of TCP segments received with errors |
tcpOutRsts | Number of TCP resets sent |
UDP-STATISTICS=...
Shows UDP statistics.
UDP-STATISTICS=*NO
Do not show UDP statistics.
UDP-STATISTICS=*YES
Show UDP statistics.
The display contains the following values:
udpInDatagrams | Number of UDP datagrams received |
udpNoPorts | Number of UDP datagrams received for which no application was opened |
udpInErrors | Number of UDP datagrams received with errors |
udpOutDatagrams | Number of UDP datagrams sent |
ALL-CONNECTIONS=...
Shows all connections.
ALL-CONNECTIONS=*NO
Do not show connections.
ALL-CONNECTIONS=*YES
Shows connections.
The display contains the following values:
Connection Type | Type of connection (TCP or UDP) |
State | State of the connection |
listen | listen port |
Local Address | Local address of the connection (IP/IPv6 address and port) |
Remote Address | Remote address of the connection (IP/IPv6 address and port) |
TCP-CONNECTIONS=...
Shows TCP connections.
TCP-CONNECTIONS=*NO
Do not show TCP connections.
TCP-CONNECTIONS=*YES
Show TCP connections.
The display contains the following values:
Local IP-Address | Local IP address of the connection |
Local Port | Local port number of the connection |
Remote IP-Address | Remote IP address of the connection |
Remote Port | Remote port number of the connection |
State | State of the connection |
UDP-PORTS=...
Shows opened UDP ports.
UDP-PORTS=*NO
Do not showopened UDP ports.
UDP-PORTS=*YES
Show opened UDP ports.
The display contains the following values:
Local IP-Address | Local IP address of the UDP application; |
Local Port | Local port number of the UDP application |
BCAM-GLOBAL=...
Shows global information on BCAM (for diagnostic purposes).
BCAM-GLOBAL=*NO
Do not show global information on BCAM.
BCAM-GLOBAL=*YES
Show global information on BCAM.
BCAM-MEMORY=...
Shows memory information on BCAM (for diagnostic purposes).
BCAM-MEMORY=*NO
Do not show memory information on BCAM.
BCAM-MEMORY=*YES
Show memory information on BCAM.
WAITTIME=...
Wait time (in seconds) between 2 displays of the selected functions.
WAITTIME=*NO
If REPETITIONS contains the value 0, the values of the selected functions are displayed once and the program is terminated.
If REPETITIONS contains a value not equal to 0, the values of the selected functions are displayed as often as specified. The interval between 2 displays is 10 seconds.
WAITTIME=<integer 1 .. 2147483647>
If REPETITIONS contains the value 0, the values of the selected functions are displayed every <WAITTIME> seconds until the program is terminated.
If REPETITIONS contains a value not equal to 0, the values of the selected functions are displayed as often as specified. The interval between 2 displays is <WAITTIME> seconds.
REPETITIONS=...
Number of times the display of the selected functions is repeated.
REPETITIONS=<integer 0 .. 2147483647>
If REPETITIONS contains the value 0 and WAITTIME contains the value *NO, the values of the selected functions are displayed every 10 seconds until the program is terminated.
If REPETITIONS contains the value 0 and WAITTIME contains a value not equal to *NO, the values of the selected functions are displayed every <WAITTIME> seconds until the program is terminated.
If REPETITIONS contains a value not equal to 0 and WAITTIME contains the value *NO, the values of the selected functions are displayed as often as specified. The interval between 2 displays is 10 seconds.
If REPETITIONS contains a value not equal to 0 and WAITTIME contains a value not equal to *NO, the values of the selected functions are displayed as often as specified. The interval between 2 displays is <WAITTIME> seconds.
Relationship between WAITTIME and REPETITIONS:
WAITTIME | |||
*NO | >=1 | ||
REPETITIONS | 0 | Command is terminated after one display | Displayed every <waittime> seconds until the command is shutdown |
<>0 | Displayed every 10 seconds for <repetitions> number of times | Displayed every <waittime> seconds for <repetitions> number of times | |
Relationship between WAITTIME and REPETITIONS
OUTPUT=...
Output redirection of values.
OUTPUT=*SYSOUT
The values are output to SYSOUT.
OUTPUT=<filename 1 .. 54 without-gen-vers>
The values are written to the <filename 1 .. 54 without-gen-vers> file.
If no operand which controls the output is selected when the command is executed, the command default value INTERFACE-VALUES=*YES is assumed implicitly.
If the command execution is aborted, e.g. with the K2 key, and the CMD0174 message is not answered with ’E’, this means that you are at procedure level 1 and all outputs are output to the specified file. Procedure level 0 and re-establishment of the original environment are implemented via the END-PROCEDURE command.