VTAM® issues this message as the first message of a group of messages in response to a DISPLAY TOPO,LIST=UNRCHTIM command. The description of the message group follows:

IST2057I UNREACHABLE PARTNER INFORMATION:
[IST924I -------------------------------------------------------------]
[IST2150I VIRTUAL NODE vrn_name - count UNREACHABLE PARTNERS]
[IST2151I PARTNER LIMIT EXCEEDED - UNUSABLE UNTIL COUNT IS BELOW lowerlim]
[IST2052I   ORIGIN NODE        PARTNER NODE    UNRCHTIM  EXPIRES]
[IST2055I orig_name  partner_name  unrchtim   time]
⋮
[IST1315I DISPLAY TRUNCATED AT keyword = number]
[IST924I -------------------------------------------------------------]
[IST2056I  NO MATCHING UNREACHABLE PARTNER INFORMATION EXISTS]
IST314I END

IST924I

• This message is a separator message.

IST1315I

• VTAM issues this message when the number of unreachable partner paths to be displayed exceeds the value specified for the MAX operand.
• In the message text:

  keyword

  The keyword value is always MAX.

  number

  The value specified for the MAX operand.

IST2052I

• This message is a header message for unreachable partner information associated with the Enterprise Extender virtual routing node (VRN) named in message IST2150I.

IST2055I

• orig_name is the network-qualified name of the origin node in the path to the unreachable partner node.
• partner_name is the network qualified name of the partner node that is unreachable on the path through an Enterprise Extender virtual routing node (VRN).
• unrchtim is the time in seconds that a path through the VRN will not be considered as a possible session path to an unreachable partner. The path is identified by origin node, intermediate VRN, and unreachable destination partner node. This is the unreachable time value of UNRCHTIM specified for the Enterprise Extender VRN in the node that detected the path through the VRN to the unreachable partner. See the UNRCHTIM start option in z/OS Communications Server: SNA Resource Definition Reference for more information about the unreachable time value of the UNRCHTIM start option or the UNRCHTIM operand in the XCA major node.
• It is possible for unrchtim in the node that detected the problem to be different in other nodes that have learned the unreachable partner information through TDU flows. This happens if topology that includes unreachable partner information is exchanged when a CP-CP session is established between two network nodes or between an end node and its network node server. The time until the unreachable information expires is calculated from the unrchtim value, so when a topology exchange is done after the initial detection of the unreachable partner, it is necessary to alter the unrchtim value sent in the topology information to make sure the expiration time is consistent on all nodes. In this case, unrchtim is not meaningful in the nodes that learned the unreachable partner information through TDU flows and the unrchtim value will display as five asterisks (*****).
• time is the time that the unreachable time will expire. When the time expires, if this path still has the lowest weight of any available path to the partner node, the path over this particular Enterprise Extender VRN will be selected on the next attempt to redial the partner node. The dial attempt will result in failure if the underlying problem with the connection has not been corrected. That dial failure will cause the unreachable time to be set again to prevent selection of the path through this Enterprise Extender VRN to the unreachable partner node for the period of time specified for the VRN. This will continue until the problem with the connection path is corrected.
• The time is expressed in 24-hour system format (hh:mm:ss). For example, 1:00 p.m. is displayed as 13:00:00. The expiration time might appear to be earlier than the time the DISPLAY TOPO command was entered if the unreachable time value causes the time to expire the following day (after 24:59:59 on the day the command was entered). For example, if the DISPLAY TOPO command is entered at 23:45:00 and the unreachable time expires at 1:15 a.m., time will be 01:15:00.
• This message is issued as many times as necessary to display all of the unreachable partner information that matches the values specified on the ORIG, VRN, and DEST operands of the DISPLAY TOPO,LIST=UNRCHTIM command. The unreachable path is from the name specified by the orig_name value to the name specified by the vrn_name value (from message IST2150)I to the name specified by the partner_name value. See z/OS Communications Server: SNA Network Implementation Guide for more information about this display.

IST2056I

• This message is issued when there is no unreachable partner information that matches the values specified on the ORIG, VRN, and DEST operands of the DISPLAY command.

IST2150I

• In the message text:

  vrn_name

  The network-qualified name of the Enterprise Extender virtual routing node (VRN) that is the intermediate node in a path to an unreachable partner.

  count

  The total number of unreachable partner paths that are associated with the named Enterprise Extender VRN in the topology database.

  The count value might differ from the number of unreachable partner paths displayed for the VRN in message IST2055I messages if the ORIG, VRN, or DEST operand is used on the DISPLAY TOPO,LIST=UNRCHTIM command to limit the scope of unreachable partner paths displayed or if the message display is truncated with message IST1315I.

IST2151I

• This message is issued when the number of unreachable partner paths associated with the VRN in message IST2150I exceeds the unreachable partner limit.
• A user-specified limit of unreachability records associated with an Enterprise Extender VRN can be set on the UNRCHTIM start option. When the count of unreachable partner paths through an Enterprise Extender VRN exceeds this limit, the VRN is no longer used for session route selection. The VRN remains unusable until enough unreachability records that are associated with the VRN are deleted to make the count less than 80% of the limit set in the UNRCHTIM start option. An unreachability record is deleted when the unreachable time that is associated with that record expires, or when the unreachability records are manually cleared with the MODIFY TOPO,FUNCTION=CLRUNRCH command. See the UNRCHTIM start option in z/OS Communications Server: SNA Resource Definition Reference for more information.
• In the message text:

  lowerlim

  When the number of unreachable partner paths through an EE VRN falls below the number specified by the lowerlim value, the unreachable partner limit is no longer considered to be exceeded.