TCP/IP Commands and Inquiries

This appendix lists and briefly describes the OI commands and inquiries that you can use to perform TCP/IP operations. For a complete description of each OI command and inquiry, refer to the Networking Commands and Inquiries Help.

To initialize, terminate, or inquire on the TCP/IP software, see Operating TCP/IP Software.

Table 12. TCP/IP Commands and Inquiries

Command

Description

SNMP GET Inquiry

Displays SNMP object values.

SNMP GETNEXT Inquiry

Displays the SNMP object values located at the hexagraphical MIB II location.

SNMP GET TCPVERSION

Enables SNMP agents to inquire about the TCPIP AND TCPIP Security version in use.

SNMP RESET

Resets or disables the SNMP objects and functions.

SNMP SET

Sets and enables SNMP objects and functions.

SNMP SET RIProutetimeout

Sets the value (in seconds) for the routing expiration timer.

TCPIP ADDRESS SELECTION POLICY

Enables an administrator to override the default address selection as specified by RFC 3484 and set up policies for selecting preferred source and destination addresses.

TCPIP ARP

Sets, deletes, adds, or displays the IP address, physical address, and status for all entries in the ARP table.

TCPIP ARP ATM

Used to add an ARP ATM entry for either a PVC or SVC connection, delete an ARP ATM entry, or inquire on an ARP ATM entry.

TCPIP ARP SERVER

Used to

  • Add ARP servers with PVC or SVC connections

  • Delete a specific ARP server entry, all entries to a specific ARP server, or all ARP server entries

  • Inquire on ARP servers

TCPIP ATMCACHETIMER

Enables you to specify or inquire on the ATMCacheTimer used for aging entries in the ATMARP table.

TCPIP BROADCASTFILTER

Enables you to filter out broadcast traffic (packets). By eliminating excessive broadcast traffic at the network interface level rather than within the MCP host, you can free up the MCP processor for its normal workload and prevent a Denial of Service from being imposed on the MCP host.

TCPIP CONNECTION

Displays a list of TCP/IP connections to a specified IP host or IP network address. The inquiry details of this command allow the network administrator to inquire on the specific attributes identified by the following subport keys:

  • FILENAME

  • HOSTNAME

  • IPADDRESS

  • MYNAME

  • SECURED

  • SSH

  • YOURNAME

  • TCPSTATE

  • RESUMABLE (SSL connections only)

  • SSL

  • SACK

  • UNSECURED

This command, when issued without a subport key selection, returns all known connections from the connections table. When issued with a subport key, the response to this command defaults to connection details regarding the subport identifiers specified. The returned responses also include SSL connections if they exist.

You can limit the returned responses only to SSH, SECURED, or UNSECURED connections by specifying the respective keyword.

The optional VERBOSE keyword, when specified, expands the response details to include transmission statistics.

When the SACK option is used with the VERBOSE keyword, the response details are expanded to display the current usage of a negotiated TCP option or connection attributes for a TCP dialog instance. If a TCP dialog has successfully negotiated any of the supported options, the new response indicates the option that has been negotiated. Supported options include Selective ACK (SACK), Window Scale Factor (WSF), and Timestamp (TS).

TCPIP DEBUG

Enables, disables, or interrogates the TCP/IP debug options. This command has two options: DUMP, which examines the contents of various data structures, and TRACE, which traces the data flow through the TCP/IP software.

You can specify the environment you want to examine or trace. The environments you can specify are the MCP server only, a Windows server only, or the MCP server and all Windows servers.

TCPIP DISPLAY

Sets when all (or specified) ICMP messages are reported at the ODT and in the SUMLOG. There are three message reporting options: ALWAYS, NEVER, or only the FIRST message within a specified time interval.

TCPIP DISPLAY INTERVAL

Sets the interval (in hours) that ICMP, Reset, and Error table information is written to the SUMLOG. The default interval is 2 hours. If no interval value is specified, this command displays the currently-defined interval.

TCPIP DISPLAY OPTIONS Inquiry

Displays the current display setting (ALWAYS, NEVER, or FIRST) for a particular ICMP message type.

TCPIP DISPLAY TABLE Inquiry

Displays TCP and ICMP report information maintained in the TCP/IP library. You can display all information contained in the ICMP table, Error table, or Reset table. You can also display information about a specified ICMP message type.

TCPIP DYNAMICINIT

Enables and disables the dynamic initiation of specified port numbers for registered TCP and UDP applications, and inquires on the current dynamic initiation status of all valid port numbers.

TCPIP FILTERFRAMES

Enables and disables filtering on specific TCP or UDP port numbers. If the command is entered without an enable or disable selection, it serves as an inquiry command and returns the current configuration setup for frame filtering for all TCP and UDP ports.

TCPIP [TCPIP]IDENTITY

Sets the local IP address, the network processor used for a particular IP address, and the subnet Mask for an IP address. Sets the Visible attribute for a network interface.

Enhancements to this command enable a network administrator to

  • Configure multiple local IP address and mask pairs for each network interface

  • Delete multiple local IP address and mask pairs for each network interface

  • Delete all local IP address and mask pairs for a network interface without specifying individual pairs

  • Set the RIP Authentication type for each network interface

  • Set the IP addresses associated with the interface to be available instead of being passed to Client Access Services or other applications

For IPv6 interfaces, this command enables an administrator to specify whether autoconfiguration should occur for an interface and to specify the number of consecutive neighbor solicitation messages to be sent when performing duplicate address detection.

TCPIP [TCPIP]IDENTITY Inquiry

Displays the local IP address, the IP address mask or prefix-length, the network provider, backup network provider device ID, the backup network provider device Line ID, the VLAN ID, and the physical address.

For IPv6 interfaces, can display VLAN ID, autoconfiguration, and duplicate address detection characteristics.

TCPIP LANRESILTIMER

Enables a system administrator to specify or inquire on the LAN Resiliency Timer, which is used to check for network interfaces that are unavailable.

TCPIP MAPPING Inquiry

Displays the host or domain name currently mapped to the specified IP address or the IP addresses currently mapped to the specified host or domain name.

TCPIP MAPPING

Creates or removes one or more user-specified mappings between a TCP/IP host or domain name and an IP address.

If the LEARNED option is specified, it removes all names to IP address mappings that were “learned” during domain name resolver queries over the Internet.

TCPIP MONITOREVENTS

Enables a system administrator to monitor port events, which include OPEN, CLOSE, LISTEN, RESET (both LOCAL and REMOTE), UDP SEND, and UDP RECEIVE.

TCPIP MULTICASTDEFAULTADDRESS (MDA)

Enables a system administrator to specify or inquire on the IP address of the network interface that is to be used, by default, for sending and receiving IP multicast frames.

There can be one IPv4 address and one IPv6 address defined for the system, with each address entered by a different command.

TCPIP NEIGHBOR

IPv6 discovers and records information concerning neighbor nodes on the local link. This command works in conjunction with Neighbor Discovery to permit the administrator to add, modify, and delete a neighbor.

The IPv6 NEIGHBOR function is similar to the IPV4 ARP function.

TCPIP OPTION

Enables a system administrator to configure TCP/IP options to control network behavior.

Some options are enabled or disabled; others require that a value be supplied.

The IPV4OnlyOperation option of this command restricts operation and configuration to IPv4 only. This command is provided as a safeguard to prevent the unintentional issuance of configuration commands that either explicitly configure IPv6 interfaces or enable IPv6 address autoconfiguration.

The IPV4OnlyOperation option must be the first command processed by TCPIP during initialization. This sets the operating mode context for processing subsequent configuration commands. If IPV4OnlyOperation is not the first command, it is rejected as an invalid phase.

In IPv4 only operating mode, commands that attempt to configure IPv6 interfaces receive the “Invalid operating mode or Command processed with exceptions” negative response, depending on the type of command and the TCPIP context at the time of processing.

See Using TCP/IP Options for details on using this command.

TCPIP PING

Initiates the IP PING function. Use this command to determine if a remote host or another network interface on the same logical host is reachable.

TCPIP RIP

Provides network administrators with current Routing Information Protocol Version 2 (RIPv2) status and configuration information.

Supported only for IPv4 interfaces.

TCPIP RIP RIPAUTHENTICATION

Enables network administrators to set the type of RIPv2 authentication that is in effect for a specified network processor and line. Administrators can also inquire on the current authentication types set on each device and line configured on the system.

Supported only for IPv4 interfaces.

TCPIP ROUTE

This command enables a network administrator to

  • Set or interrogate which networks are reachable by way of known gateways

  • Clear learned routes from the routing table

  • Configure VLSM and CIDR routes

  • Configure multiple routes to a destination

  • Configure multiple default routes

TCPIP SECURITY

Instantiates the TCPIPSECURITY library and loads a rules file (with the + parameter), terminates the TCPIPSECURITY library (with the - parameter), or loads a different rules file (with the RELOAD parameter).

Filename (in quotation marks) is optional for the + and RELOAD command forms. Filename is ignored for the - command form.

TCPIP SECURITY STATE

Enables or disables TCP/IP network security settings.

TCPIP STATUS Inquiry

Displays the current phase of the TCP/IP network provider. If a module is not specified, the summary response is returned. If a module is specified, then detailed status for that module is returned. The following modules can be specified:

  • IPsec: Can be used to inquire the status of the IPsec module and detailed information about the policies in use.

  • SSL: Can be used to inquire the status of the SSL module and the list of versions and ciphers supported.

  • SSH: Can be used to inquire the status of the SSH module and which algorithms are available for use.

TCPIP TCPIPHOSTNAME

Defines the TCP/IP host named used by the network administrator.

TCPIP TCPIPHOSTNAME Inquiry

Displays the TCP/IP host name.

TCPIP TRACERT

Enables you to interrogate your TCPIP network to determine whether a remote node is reachable, and the path used to try to reach it.

TCPIP UDP ENDPOINTS

Enables the inquiry on all UDP endpoints or on a specific UDP endpoint identified by a subport key.

VERSION

This command has been modified to display the versions of TCPIPSUPPORT and TCPIPSECURITY.

The command response indicates which version of the TCPIPSUPPORT library code file is installed. When the *SYSTEM/TCPIPSUPPORT2 code file is installed, the qualifier will be V2 or V3 depending on the installed network configuration. Note that TCPIPSUPPORT2 is the only version of the library that is currently supported.

ADD NETWORK ADDRESS PAIR

Maps a TCP/IP application host's IP address to its OSI NSAP address.

DELETE NETWORK ADDRESS PAIR

Deletes a previously configured OSI‑TCP/IP address pair.

NETWORK ADDRESS PAIR Inquiry

Displays all OSI-TCP/IP address pairs configured for your network.

OSITCP CONNECTION Inquiry

Displays the current number of TCP subports in use.