IST2130I
ENTERPRISE EXTENDER CONNECTIVITY TEST INFORMATION

Explanation

VTAM® issues this message as part of a group of messages in response to a DISPLAY EEDIAG,TEST=YES command. This message is the first in a group of messages. The full description of the message group follows the example.
 IST2130I ENTERPRISE EXTENDER CONNECTIVITY TEST INFORMATION
 IST2119I ENTERPRISE EXTENDER DISPLAY CORRELATOR: correlator
 IST2131I EEDIAG DISPLAY COMPLETED ON date AT time
 IST2132I LDLC PROBE VERSIONS: VTAM = local_version PARTNER = remote_version
 IST1680I type IP ADDRESS ip_address
 IST1680I type IP ADDRESS ip_address
[IST2224I ENTERPRISE EXTENDER ROUTING POLICY INFORMATION]
[IST2225I  PORT    ROUTE TABLE   ROUTING RULE]                   
[IST2205I  ----    -----------   ------------]                   
[IST2226I  portnum route_table   routing_rule]
 IST924I -------------------------------------------------------------
 IST2133I INTFNAME: intfname               INTFTYPE: intftype
[IST2134I   CONNECTIVITY SUCCESSFUL                        PORT: portnum]
[IST2135I   CONNECTIVITY UNSUCCESSFUL    SENSE: sense      PORT: portnum]
[IST2136I   CONNECTIVITY TEST ENDED - MAXIMUM TIME LIMIT EXCEEDED]
[IST2227I   CONNECTIVITY NOT TESTED - ROUTE NOT APPLICABLE PORT: portnum]
[IST2137I   hop  ipv4address        flags   RTT: time ]
[IST2138I hop ipv6address                             flags RTT: time]
 IST924I -------------------------------------------------------------
 IST2139I CONNECTIVITY TEST RESULTS DISPLAYED FOR tested_routes OF total_routes ROUTES
 IST314I END
IST924I
  • This message is a line separator between message IST2133I subgroups.
IST1680I
  • The first occurrence of this message identifies the local IP address used for the Enterprise Extender (EE) connectivity test. The second occurrence identifies the remote IP address used for the EE connectivity test.
  • In the message text:
    type
    Indicates which IP address is being displayed. The type value is either LOCAL or REMOTE.
    ip_address
    The IP address.
IST2119I
  • In the message text:
    correlator
    A unique display correlator associated with this DISPLAY EEDIAG command. This correlator can be used to locate the various message groups associated with this DISPLAY EEDIAG command.
IST2131I
  • The date and time values specify when the EE connectivity test completed. See DATE and TIME formats for information about the date and time values.
IST2132I
  • In the message text:
    local_version
    The version of the Logical Data Link Control (LDLC) probe command supported by Communications Server for the EE connectivity test.
    remote_version
    The version of the Logical Data Link Control (LDLC) probe command supported by the partner EE endpoint.
IST2133I
  • This is the first message of a message subgroup. The message subgroup is displayed for each TCP/IP interface that has a valid path to the remote IP address. When LIST=DETAIL is specified, message IST2137I (IPv4) or IST2138I (IPv6) is repeated for each time-to-live (TTL) hop for which an LDLC probe command was sent. When LIST=SUMMARY is specified or is the default value on the DISPLAY EEDIAG command, message IST2137I or IST2138I is displayed only once with the information related to the last hop that sent a reply to the LDLC probe command.
  • In the message text:
    intfname
    The name of the TCP/IP interface that was used to perform the EE connectivity test.
    intftype
    The device type that was configured on the TCP/IP profile DEVICE statement or that was generated based on the INTERFACE statement.
  • The IST2133I message subgroup has various formats. The following examples show both IPv4 and IPv6 formats.
  • Successful IPv4 IST2133I message subgroup format:
     IST2133I INTFNAME: intfname               INTFTYPE: intftype
     IST2134I   CONNECTIVITY SUCCESSFUL                        PORT: portnum
     IST2137I   hop  ipv4address        flags   RTT: time
  • Unsuccessful IPv4 IST2133I message subgroup format:
     IST2133I INTFNAME: intfname               INTFTYPE: intftype
     IST2135I   CONNECTIVITY UNSUCCESSFUL    SENSE: sense      PORT: portnum
    [IST2136I   CONNECTIVITY TEST ENDED - MAXIMUM TIME LIMIT EXCEEDED]
     IST2137I   hop  ipv4address        flags   RTT: time
  • Successful IPv6 IST2133I message subgroup format:
     IST2133I INTFNAME: intfname               INTFTYPE: intftype
     IST2134I   CONNECTIVITY SUCCESSFUL                        PORT: portnum
     IST2138I hop ipv6address                             flags RTT: time 
  • Unsuccessful IPv6 IST2133I message subgroup format:
     IST2133I INTFNAME: intfname               INTFTYPE: intftype
     IST2135I   CONNECTIVITY UNSUCCESSFUL    SENSE: sense      PORT: portnum
    [IST2136I   CONNECTIVITY TEST ENDED - MAXIMUM TIME LIMIT EXCEEDED]
     IST2138I hop ipv6address                             flags RTT: time 
IST2134I
  • This message indicates that the EE connectivity test to the partner EE endpoint was successful for this specific EE port and TCP/IP interface.
  • In the message text:
    portnum
    The Enterprise Extender User Datagram Protocol (UDP) port that was tested. The default EE port numbers are as follows:
    • 12000 - Signal Priority
    • 12001 - Network Priority
    • 12002 - High Priority
    • 12003 - Medium Priority
    • 12004 - Low Priority
IST2135I
  • This message indicates that the EE connectivity test to the partner EE endpoint was unsuccessful for this specific EE port and TCP/IP interface. This message might be issued if the test was unable to contact the partner EE node, or if a TTL hop in the route returned an unexpected Internet Control Message Protocol (ICMP) message in response to the LDLC probe command.
  • In the message text:
    sense
    The SNA sense code that was sent in the LDLC probe response from the Enterprise Extender partner. The sense might display as ***NA*** if a response to the LDLC probe is not received from the EE partner. If a SNA sense code is displayed, see SNA sense codes in z/OS Communications Server: IP and SNA Codes for more information about this sense code.
    portnum
    The Enterprise Extender User Datagram Protocol (UDP) port that was tested. The default EE port numbers are as follows:
    • 12000 - Signal Priority
    • 12001 - Network Priority
    • 12002 - High Priority
    • 12003 - Medium Priority
    • 12004 - Low Priority
IST2136I
  • This is an optional message in the IST2133I message subgroup that is issued when the EE connectivity test is unsuccessful. This message indicates that the EE connectivity test exceeded the amount of time allowed for the test to run. This time limit is specified or is the default value on the MAXTIME operand on the D NET,EEDIAG,TEST=YES command.
IST2137I
  • This message displays information gathered during the EE connectivity test over an IPv4 route.
  • When LIST=SUMMARY is specified or is the default value on the DISPLAY EEDIAG command, this message is displayed only once with the information related to a reply to the LDLC probe command.
  • When LIST=DETAIL is specified on the DISPLAY EEDIAG command, this message is displayed for each TTL hop in the route to the EE partner. To reduce repetitive information in the detailed display, when a TTL hop is unresponsive to the LDLC probe, message IST2137I is displayed only for the first unresponsive hop and the last unresponsive hop. In these cases, all hops in between were also unresponsive to the LDLC probe command.
  • In the message text:
    hop
    The TTL hop count used in the LDLC probe command. The TTL hop count is *NA (not applicable) when LIST=SUMMARY is specified.
    ipv4addr
    The source IPv4 address from the ICMP response. The source IPv4 address might display as an asterisk (*) if the TTL hop did not respond to the LDLC probes.
    flags
    This is an optional field. The flags field has one of two forms:
    t-ccc
    The t value is a representative character of the error detected in response to the LDLC probe and the ccc value is the specific code associated with an ICMP message type (if the error detected is not associated with an ICMP message then the code value will be 0).
    The error message type is displayed as one of the following:
    • D - Destination unreachable ICMP type 3
    • P - Parameter problem ICMP type 12
    • Q - Source quench ICMP type 4
    • H - Hop limit was exceeded. A maximum of 255 hops can be tested when performing the EE connectivity test. The EE connectivity test will terminate for the route being tested.
    • L - A route loop condition was detected. This specific hop was already found as a previous hop for this route being tested. Because a route loop condition was detected the EE connectivity test will terminate for the route being tested.

    For a list of the ICMP types and codes, go to .

    (a)
    The a value is the number of LDLC probe attempts, if more than one.
    time
    One of the following:
    • The round-trip time required for the LDLC probe to be sent to an intermediate hop for which an ICMP response was received
    • The round-trip time required for the LDLC probe to be sent to the destination hop for which either an ICMP response or LDLC probe response was received.

    This field is displayed in milliseconds (ms). If the time field displays as 0, the round-trip time was less than 1 millisecond.

    Result: The round-trip time for intermediate hops is computed when an ICMP message is received from the intermediate hop. Even though the round-trip time calculated to the Enterprise Extender remote partner is based on the receipt of a UDP datagram responding to the query that was received, intermediate hops might delay the returning of an ICMP message. The remote Enterprise Extender partner should always respond immediately to the query received. Therefore, in some instances the round-trip time to the remote Enterprise Extender node might be less than the value computed to intermediate hops.

IST2138I
  • This message displays information gathered during the EE connectivity test over an IPv6 route.
  • When LIST=SUMMARY is specified or is the default value on the DISPLAY EEDIAG command, this message is displayed only once. The information displayed is related to the reply from the last hop that received the LDLC probe command.
  • When LIST=DETAIL is specified on the DISPLAY EEDIAG command, this message is displayed for each TTL hop in the route to the EE partner. To reduce repetitive information in the detailed display, when a TTL hop is unresponsive to the LDLC probe, message IST2138I is displayed only for the first unresponsive hop and the last unresponsive hop. In these cases, all hops in between were also unresponsive to the LDLC probe command.
  • In the message text:
    hop
    The TTL hop count used in the LDLC probe command. The TTL hop count is *NA when LIST=SUMMARY is specified.
    ipv6addr
    The source IPv6 address from the ICMPv6 response. The source IPv6 address might display as an asterisk (*) if the TTL hop did not respond to the LDLC probes.
    flags
    This is an optional field. The flags field has one of two forms:
    t-ccc
    The t value is a representative character of the ICMPv6 message type returned in response to the LDLC probe and the ccc value is the specific code associated with the ICMPv6 message type.
    The ICMP message type is displayed as one of the following:
    • B - Packet too big ICMPv6 Type 2
    • D - Destination unreachable ICMPv6 Type 1
    • P - Parameter problem ICMPv6 Type 4

    For a list of the ICMPv6 types and codes, go to .

    (a)
    The a value is the number of LDLC probe attempts, if more than one.
    time
    One of the following:
    • The round-trip time required for the LDLC probe to be sent to an intermediate hop for which an ICMPv6 response was received
    • The round-trip time required for the LDLC probe to be sent to the destination hop for which either an ICMPv6 response or LDLC probe response was received.

    This field is displayed in milliseconds (ms). If the time field displays as 0, the round-trip time was less than 1 millisecond.

    Result: The round-trip time for intermediate hops is computed when an ICMP message is received from the intermediate hop. Even though the round-trip time calculated to the Enterprise Extender remote partner is based on the receipt of a UDP datagram responding to the query that was received, intermediate hops might delay the returning of an ICMP message. The remote Enterprise Extender partner should always respond immediately to the query received. Therefore, in some instances the round-trip time to the remote Enterprise Extender node might be less than the value computed to intermediate hops.

IST2139I
  • In the message text:
    tested_routes
    The number of TCP/IP routes that were tested and displayed in the EE connectivity test output.
    total_routes
    The number of valid TCP/IP routes that were found between the EE endpoints.
IST2205I
  • This message is a line separator between various sections of the message group.
IST2224I
  • This message is displayed when policy-based routing is being used to determine an IPv4 route between two Enterprise Extender endpoints.
IST2225I
  • This message is displayed as a heading for displaying EE UDP port numbers and their associated route tables and policy-based routing rules.
IST2226I
  • In the message text:
    portnum
    The EE UDP port number.
    route_table
    The route table being used for IPv4 route calculations. If the main routing table is being used, then the value EZBMAIN is displayed. If the value *NONE* is displayed, then no route could be calculated between the EE endpoints for this specific EE UDP port and the EE connectivity test was unsuccessful.
    routing_rule
    The policy-based routing rule associated with this EE UDP port. If no policy-based routing rule is associated with the port, then the value NONE is displayed.
IST2227I
  • This message is an optional message in the IST2133I message subgroup that is issued when the EE connectivity test is not performed because the route is not associated with the specific EE UDP port. This message does not indicate an error. The EE connectivity test is not performed because the policy-based routing rule has indicated that this route is not associated with the EE UDP port that is being tested.
  • In the message text:
    portnum
    The Enterprise Extender User Datagram Protocol (UDP) port that was tested.

System action

Processing continues.

Operator response

Review the Enterprise Extender Connectivity Test output for any unsuccessful test results. See DISPLAY EEDIAG,TEST=YES in z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures for information about analyzing the test output.

System programmer response

None.

User response

Not applicable.

Problem determination

Not applicable.

Source

z/OS® Communications Server SNA

Module

You can display the module that issues a SNA message in the message by setting the MSGMOD start option to YES. See Adding the originating module to the message text for more information about the MSGMOD start option.

Routing code

2

Descriptor code

5

Example

None.