UNIX/390 Onetstat Dialog
The UNIX/390 Onetstat dialog box enables information to be specified to display the network status of the local host. It can supply information about TCP/IP connections, network clients, gateways, and devices. This command is executed on UNIX/390.
Specify information in the following fields to
display the network status of the local host.
Select an Option Section
The Select an option: section of the UNIX/390 Onetstat dialog box contains a list of radio buttons, one (and only one) of which must be selected. From the following list of radio buttons, select the type of information you want to obtain about the local host:
- (-A) Everything about a connection
- Provides detailed information about TCP/IP connections.
- (-a) Include TIME-WAIT and CLOSED TCP/IP connections
- Provides all information for all connections, including those recently closed.
- (-b) Current connection display
- Provides a byte count for each connection, including the following information:
- client name
- bytes sent on the connection
- bytes received on the connection
- local port
- foreign socket
- state
- Idle time
- This checkbox, which is available when the Current connection display radio button is selected, displays the byte count as well as the idle time for each connection in the following format:
hours:minutes:seconds
.
- (-c) Active TCP/IP connections
- Provides the following information about each active connection (including connections in time-wait state):
- (-C) Utilize Cache Accelerator
- Provides the following information about the TCP connections utilizing the Cache Accelerator:
- cache storage sizes
- counts of cache objects
- connection information
- request information
- cache retrieval information
- (-d) Devices and links
- Displays the following information about devices and defined links in the TCP/IP address space:
- device name
- device type
- device number
- link name
- link type
- status of link
- net number -- This is significant only for links on link connection subsystem (LCS) and CTC devices.
- queue size -- This is significant only for links on LCS and asynchronous transfer mode (ATM) devices.
- address resolution protocol (ARP) MAC addresses -- This is significant only for token ring links.
- SR bridging capability -- This is significant only for token ring links.
- broadcast capability -- This is significant only for links on LCS devices.
- broadcast type -- This is significant only for token ring links.
- number of bytes received
- number of bytes transmitted
- BSD parameters
- packet trace settings
- ATM specific information -- This is significant only for ATM devices and links.
- Multicast specific information -- This is significant only for multicast capable links. It indicates if the link is multicast-capable and displays the multicast group IP address and the numbers of sockets waiting to receive multicast data for each multicast group.
- (-e) Current clients
- Provides the following information about each client:
- authorization
- elapsed time since last used
- (-f) Configuration data
- Provides the following TCP/IP configuration data:
- configured IP information
- configured TCP information
- configured UDP information
- SMF parameters
- TCP/IP statistics
- data trace settings
- (-g) Current known gateways
- Provides the following information about each gateway:
- address of the network
- first hop address
- link name used by the first hop
- packet size used by the first hop
- subnet mask and subnet value
- Detail
- This checkbox, which is available when the Current known gateways radio button is selected, displays additional gateway information. In addition to the information displayed for the Current known gateways function, selecting this checkbox also displays the metric associated with the cost of the use for the link and configured parameters, specific to MVS, for each gateway, as follows:
- maximum retransmit time
- minimum retransmit time
- round trip gain
- variance gain
- variance multiplier
- (-h) Home address list
- Displays the
HOME
list. For each entry in the list, the following are also displayed:
- IP address
- link name
- primary interface information
- (-j) (SLA) policy definitions
- Displays the Service Level Agreement (SLA) policy definitions and performance data.
- (-o) Display port reservation list
- Displays the port reservation list as follows:
- port number
- protocol
- user name
- flags
- A autolog
- D DelayAcks
- O Optimize MSS
- R Port is reserved by range
- range -- This is significant only for port entry reserved by range (flag R in the flags field).
- (-R) Query ARP table or entry information
- Queries the ARP cache information.
- Drop down list box
- This list box, which is available (and required) when the Query ARP table or entry information radio button is selected, contains one of the following:
- net address -- A specific net address that the ARP cache is queried to locate.
- ALL -- The ARP cache is queried for all net addresses.
If you have previously provided this information, it will appear in this field. A drop down list containing your last ten entries will also be available and you can select from the list.
- (-r) Display routing information
- Displays routing information in a standard format:
- Destination -- The address of a destination host or network.
- Gateway -- The gateway used in forwarding packets.
- Flags -- The state of the route:
- U The route is up.
- H The route is to a host rather than to a network.
- G The route is a gateway.
- D The route was created dynamically by a redirect.
- Reference count -- The current number of active users for the route.
- Interface -- The link name for the route.
- (-s) Socket interface users and their sockets
- Displays information about:
- each client using the socket interface
- the sockets and associated connections owned by the client.
The following information is displayed when the Socket interface users and their sockets radio button is selected:
- Name -- Displays the client's address space name.
- Subtask -- Displays the subtask identifier. The subtask identifier is combined with the address space name to produce a unique identifier for the client.
- Type -- Displays one of the following socket types:
- "Stream" for stream (TCP) sockets
- "Dgram" for datagram (UDP) sockets
- Bound to -- Indicates the address and port to which the socket is bound or not bound (unbound). The output is in the format
internet address..bound port
where internet address
is the address to which the socket is bound and bound port
is the port number to which the socket is bound.
- Connected to -- Displays the address and port to which the socket is connected (or not connected).
- State -- Displays the TCP connection state for TCP sockets or "UDP" for UDP sockets.
- Conn -- Displays the client identifier, which is a unique number assigned by TCP/UDP stack to uniquely identify a particular socket entity.
- (-t) Telnet connection information
- Displays the status of the internal Telnet server. A connection in the "listen" state is always available for an incoming "open" request.
- Detail
- This checkbox, which is available when the Telnet connection information radio button is selected, displays the log mode and Telnet protocol in use by each connection.
- (-u) Date and time TCP/IP was last started
- Provides the date and time that TCP/IP was started.
- (-v) Dynamic VIPA information
- Displays the dynamic VIPA information.
- (-?) Display help
- Displays help information for the onetstat parameters.
- (-D) Drop a TCP/IP connection
- Drops the TCP/IP connection specified in the entry field which accompanies this radio button.
- Entry field
- This entry field, which is available (and required) when the Drop a TCP/IP connection radio button is selected, specifies the TCP/IP connection number to drop.
Select Information on Specified Section
The Select information on specified: section of this window contains a list of check boxes which are available if your selection in the Select an Option Section requires additional information to be specified. If no additional information is required, this section of radio buttons is not available. The radio buttons in this list have accompanying entry fields requiring additional information. These radio buttons and entry fields are described as follows:
- (-E) Client name
- Provides response, on the specified client name, to any of the following:
The (-E) Client name radio button has an associated entry field which will contain the last entry you specified in this field. It also has an associated pull down list which displays the last ten client names you have previously entered.
- (-I) IP address
- Provides response (on the specified IP address, ipaddr, or ipaddr/subnetmask) to any of the following:
The (-I) IP address radio button has an associated entry field. When the UNIX/390 Onetstat dialog box is invoked from the context menu of a specific resource, and the (-I) IP address radio button is active, then the IP address of the resource from which the dialog was opened is inserted into the associated entry field.
When this dialog box is not invoked from a specific resource, the IP address must be specified in the entry field associated with the (-I) IP address radio button. This IP address can be a local or remote address. If you specified an IP address in this field previously, then this field will contain the last IP address you specified. It also has a pull down list which displays the last ten IP addresses you specified. The default is 255.255.255.255.
- (-P) Port
- Provides the response, on the specified port number, to any of the following:
The (-P) Port radio button has an associated entry field which contains the last entry you specified in this field. It also has an associated pull down list which displays the last ten ports you specified.
Notes:
- The port number can be for either a local or remote port.
- This option is only valid for TCP/IP address spaces having the same version as onetstat.
- This option is not valid when z/OS UNIX System Services is configured for INET.
- (-N) Application name
- Provides the response, on the specified VTAM, to the
(-t) Telnet connection information option.
The (-N) Application name radio button has an associated entry field which contains the last entry you specified in this field. It also has an associated pull down list which displays the last ten application names you specified.
- (-L) LU name
- Provides the response, on the specified LU name, to the
(-t) Telnet connection information option. The (-L) LU name check box has an associated entry field which will contain the last entry you specified in this field. It also has an associated pull down list which displays the last ten LU names you specified.
- NetView domain ID
- In this optional entry field, specify the NetView that defines the UNIX/390 to which the request for host information is to be issued. If you specified a NetView domain ID in this field previously, this field contains the last NetView domain ID you specified. A drop down list, containing your last ten entries, is also available.
Note: If this entry field is left blank, then the NetView domain ID of the machine to which your server is connected (The NetView that issued the NETCONV command) will be used.
- (-p) Detail info about TCP/IP space
- Displays detailed information about the specified TCP/IP address space. In this entry field, enter the TCP/IP address for which you want this information. If you specified an address in this field previously, it contains your last entry. It also has a pull down list, containing the last ten TCP/IP addresses specified, from which to select.
Click one of the following buttons:
- Send
- Display the status, based on the information provided in the fields, and leave the dialog box open.
- Send and Exit
- Display the status, based on the information provided in the fields, and close the dialog box.
- Show Console Log
- Show the
Console Log window to see the command responses.
- Cancel
- Cancel the request for status and close the dialog box.
- Help
- View help for this dialog box.
Command responses to the onetstat query are listed in the
Log Window of the
NMC Topology Console.
This command is provided by the SNMP Service in UNIX/390.