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:
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:

(-d) Devices and links
Displays the following information about devices and defined links in the TCP/IP address space:

(-e) Current clients
Provides the following information about each client:

(-f) Configuration data
Provides the following TCP/IP configuration data:

(-g) Current known gateways
Provides the following information about each gateway:
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:

(-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:

(-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:

(-s) Socket interface users and their sockets
Displays information about: The following information is displayed when the Socket interface users and their sockets radio button is selected:

(-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:

  1. The port number can be for either a local or remote port.
  2. This option is only valid for TCP/IP address spaces having the same version as onetstat.
  3. 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.