Using the TCPIP DISPLAY, TCPIP DISPLAY INTERVAL, and TCPIP DISPLAY OPTIONS Commands

Note: If you enter both the TCPIP DEBUG and TCPIP DISPLAY commands, message reporting is based on the last command entered.

The TCPIP DISPLAY command controls when all (or specific) ICMP messages are reported to the system consoles and sent to the SUMLOG. The TCPIP DISPLAY command offers two advantages over the TCPIP DEBUG TRACE command:

  • TCPIP DISPLAY can be defined in the initialization file.

  • TCPIP DISPLAY allows a specified message type to be reported just once within a specified time interval.

Three options are available to specify how messages are reported

  • ALWAYS

    The message is always reported. This is the default condition.

  • NEVER

    The message is never reported.

  • FIRST

    Only the first occurrence of a message within a specified time interval is reported. You can set this interval with the TCPIP DISPLAY INTERVAL command. The default interval is 2 hours.

If the NEVER or FIRST option is specified, the unreported ICMP message information can still be accessed using the TCPIP DISPLAY TABLE command. See Using the TCPIP DISPLAY TABLE Command for more information.

ICMP Message Options identifies specific ICMP messages that can be controlled by issuing the TCPIP DISPLAY command.

Table 8. ICMP Message Options

To control the reporting of this message:

Use this command option:

ICMP Address Mask

ICMPADMSK

ICMP Destination Unreachable

ICMPDSTUNR

ICMP Information Request/Reply

ICMPINF

ICMP Parameter Problem

ICMPPRMPRB

ICMP Redirect

ICMPRED

ICMP Router Discovery

ICMPRDISC

ICMP Source Quench

ICMPSRCQ

ICMP Time Exceeded

ICMPTMEXC

ICMP Timestamp Request/Reply

ICMPTMSTP

ICMPV6 Packet Too Big

ICMPV6PKTTOOBIG

ICMPV6 Multicast Listener Discovery

ICMPV6MLD

ICMPV6 Router Information

ICMPV6RDISC

ICMPV6 Neighbor Discovery

ICMPV6NDISC

ICMPV6 Redirect

ICMPV6RED

All of the previous messages

ICMPRPTS

The enterprise server TCP/IP INFORMATION SUMMARY report displays the reporting option (ALWAYS, NEVER, or FIRST) for every message type. You can also use the TCPIP DISPLAY OPTIONS command to obtain the current reporting option for a specified ICMP message.

Refer to the Networking Commands and Inquiries Help for a detailed description of the TCPIP DISPLAY, TCPIP DISPLAY INTERVAL, and TCPIP DISPLAY OPTIONS commands.

Examples

The following examples illustrate how you can use the TCPIP DISPLAY command to control when specific messages are reported.

  1. To enable all ICMP messages to always be reported, enter the following command at the system console: 

    NW TCPIP DIS ICMPRPTS ALWAYS

    After this command is entered, the following command:

    NW TCPIP DIS OPT ICMPRPTS

    results in the following response:

    ICMPADMSK DISPLAY ALWAYS
 ICMPDSTUNR DISPLAY ALWAYS
 ICMPINF DISPLAY ALWAYS
 ICMPPRMPRB DISPLAY ALWAYS
 ICMPRED DISPLAY ALWAYS
 ICMPRDISC DISPLAY ALWAYS
 ICMPSRCQ DISPLAY ALWAYS
 ICMPTMEXC DISPLAY ALWAYS
 ICMPTMSTP DISPLAY ALWAYS
 ICMPV6PKTTOOBIG DISPLAY ALWAYS
 ICMPV6MLD DISPLAY ALWAYS
 ICMPV6RDISC DISPLAY ALWAYS
 ICMPV6NDISC DISPLAY ALWAYS
 ICMPV6REDP DISPLAY ALWAYS

  2. To enable only the first occurrence of a unique ICMP Redirect message to be reported, enter the following command: 

    NW TCPIP DIS ICMPRED FIRST

    After this command is entered, the following command:

    NW TCPIP DIS OPT ICMPRED

    results in the following response:

    ICMPRED DISPLAY FIRST

  3. To disable all reporting of the ICMP Parameter Problem message, enter the following command: 

    NW TCPIP DIS ICMPPRMPRB NEVER

    After this command is entered, the following command:

    NW TCPIP DIS OPT ICMPPRMPRB

    results in the following response:

    ICMPPRMPRB DISPLAY NEVER
Prev  Up  Next
Using the Dump Option of the TCPIP DEBUG Command  Home  Using the TCPIP DISPLAY TABLE Command