IST2344I
NODE ROLE CHANGE FROM from_role TO to_role FAILED - SENSE: sense

Explanation

This message is part of a group of unsolicited messages that VTAM® issues when an attempt is made to change the role of an APPN node. Valid APPN node roles are network node (NN), end node (EN), virtual routing node (VRN), and global virtual routing node (GVRN). The role of a node can be changed in two ways:
  • A link is activated to another node that has changed roles. In this case, it is the role of the destination node of a TG that changes.
  • A topology database update (TDU) is received and the role of the node identified in the TDU does not match the role of the node in the topology database.
A complete description of the message group follows:
[IST2344I NODE ROLE CHANGE FROM from_type TO to_type FAILED - SENSE: sense]
[IST2345I NODE ROLE CHANGE FROM from_type TO to_type SUCCEEDED]                                     

 IST2346I CP NAME = cp_name                                      
[IST2347I TDU RECEIVED FROM ADJACENT NODE adj_cp] 
IST2344I
  • This message identifies the roles involved in a node role change that failed.
  • In the message text:
    from_role
    The existing role of the node in the topology database. Values can be EN, NN, VRN, or GVRN.
    to_role
    The role of the node in the input TDU or the new role of the destination node of the TG being activated. Values can be EN, NN, VRN, or GVRN.
    sense_code
    The sense code set for the node role change failure.
  • A node role change is not valid and will fail when the following changes are attempted:
    • The change in roles is for the host node.
    • The change in roles is from a virtual node (VRN or GVRN) to a real node (NN or EN).
    • The change in roles is from a real node to a virtual node.
    • The change in roles is attempted with a TDU, but there is already an active link to that node.
    • The change in roles is attempted with a TDU for a non-adjacent DLUR EN, but the new role is not an EN.
  • In addition to the messages, an alert with ID X'A6C6D1D5' is generated for the failed node role change.
IST2345I
  • This message identifies the roles involved in a node role change that succeeded.
  • In the message text:
    from_role
    The existing role of the node in the topology database. Values can be EN or NN.
    to_role
    The role of the node in the input TDU or the new role of the destination node of the TG that is being activated. Values can be EN or NN.
IST2346I
  • This message identifies the node whose role change succeeded or failed.
  • In the message text:
    cp_name
    The network-qualified CP name of the node.
IST2347I
  • This message is issued when VTAM attempts to change the role of an APPN node because VTAM received a TDU with a node role that differs from the role in the topology database. This TDU contains the control vectors that identify the node for the role change. The message identifies the adjacent node from which the TDU was received.
  • In the message text:
    adj_cp
    The network-qualified CP name of the adjacent node.

System action

Processing continues.

Operator response

If these messages are not expected, do the following:

  1. Message IST2346I identifies the node of concern. Enter a command to obtain additional information about the node.
  2. Save the system log and request a dump for problem determination.
  3. Contact the system programmer.

System programmer response

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,8

Descriptor code

12

Automation

Automation on these messages can aid in the detection of unauthorized node role changes.

Example

IST2344I NODE ROLE CHANGE FROM EN TO VRN FAILED - SENSE: 08954409
IST2346I CP NAME = NETA.CPAA
IST2347I TDU RECEIVED FROM ADJACENT NODE NETA.CP2A
IST314I END