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
Operator response
If these messages are not expected, do the
following:
- Message IST2346I identifies the node of concern. Enter a command
to obtain additional information about the node.
- Save the system log and request a dump for problem determination.
- Contact the system programmer.
System programmer response
- If message IST2347I was issued, then VTAM attempted to change the role of the node
from an input TDU.
- If message IST2347I was not issued, then VTAM attempted to change the role of the node
as the result of activating a link to an adjacent node.
- This problem is often the result of user definitions that are
not valid.
- When message IST2344I indicates that the role change is from a
real node (EN or NN) to a virtual routing node (VRN or GVRN), the
new virtual node name is defined in the XCA major node. Ensure that
the VRNNAME operand on the PORT definition statement or the GROUP
definition statement (EE XCA major node only) specifies a unique CP
name.
- When message IST2344I indicates that the role change is from a
virtual routing node to a real node, you must determine the correct
role of the node with the CP name in IST2346I.
- When IST2344I is issued indicating that the role change for a
node failed and the node is known throughout the network with an incorrect
role, or if you cannot resolve the problem, you need to contact IBM® for assistance.
- If you have access to IBMLink, contact IBM for assistance by using the Electronic Technical
Report (ETR) option on IBMLink.
- If you do not have access to IBMLink, contact IBM for assistance through the IBM software support center.
User response
Problem determination
Source
z/OS® Communications
Server SNA
Module
Routing code
Descriptor code
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