Explanation
VTAM® issues this group of messages when a Shared Memory Communications - Remote Direct Memory Access (SMC-R) link failure is detected.
A complete description of the message group follows:
IST2406I SMC-R LINK FAILURE ON TRLE trlename CODE = rsn_code
IST1717I ULPID = ulp_id ULP INTERFACE = ulp_interface
IST2407I LOCAL LINK ID = local_id REMOTE LINK ID = remote_id
IST2408I LOCAL MAC = local_mac REMOTE MAC = remote_mac
IST2409I type GID = gid_value
IST2410I LOCAL QP = local_qp_num REMOTE QP = remote_qp_num
[IST2411I VLAN = vlan_id]
IST314I ENDIST1717I
This message is displayed to identify the Upper-layer Protocol (ULP) associated with the failing SMC-R link.
- ulp_id
- The name of a z/OS® Communications Server ULP. In this message group, the ulp_id value is always the TCP/IP job name.
- ulp_interface
- The name of the 10GbE RoCE Express® interface that was used by the failing SMC-R link.
IST2406I
This is the first message in the message group.
- trlename
- The name of the TRLE that represents the 10GbE RoCE Express interface that was used by the failing SMC-R link.
- rsn_code
- The reason code generated by z/OS Communications Server to assist in identifying the reason for the SMC-R link failure.
IST2407I
This message displays the SMC-R link identification values assigned to the failing SMC-R link.
- local_id
- The SMC-R link ID value assigned by this node for the failing SMC-R link.
- remote_id
- The SMC-R link ID value assigned by the remote SMC-R peer for the failing SMC-R link.
IST2408I
This message displays the Media Access Control (MAC) address values for the failing SMC-R link.
- local_mac
- The MAC value assigned by this node for the 10GbE RoCE Express interface that was used by the failing SMC-R link.
- remote_mac
- The MAC value assigned by the remote SMC-R peer for 10GbE RoCE Express interface that was used by the failing SMC-R link.
IST2409I
This message displays a group ID (GID) value for the failing SMC-R link.
- type
- Indicates which SMC-R link peer generated this GID value. Possible
values are:
- LOCAL
- The GID value was assigned by this node.
- REMOTE
- The GID value was assigned by the remote SMC-R peer.
- gid_value
- The GID value assigned by the SMC-R peer for the failing SMC-R link.
IST2410I
This message displays the queue pair (QP) values for the failing SMC-R link.
- local_qp_num
- The QP number assigned by this node for the failing SMC-R link.
- remote_qp_num
- The QP number assigned by the remote SMC-R peer for the failing SMC-R link.
IST2411I
This optional message is displayed when a virtual LAN (VLAN) is associated with the failing SMC-R link.
- vlan_id
- The VLAN value associated with the failing SMC-R link.
System action
Processing continues. The TCP/IP stack attempts to switch the TCP connections that are using the failing SMC-R link to another SMC-R link, if one exists, within the SMC-R link group. This switch occurs automatically and the TCP connections continue over the alternate SMC-R link. If no alternate SMC-R link exists within the link group, the TCP connections end.
Operator response
Contact the system programmer.
System programmer response
For more information about Data Link Control (DLC) status
codes and about the error that the value of rsn_code reports,
see z/OS Communications Server: IP and SNA Codes.
Perform the necessary corrections,
if any. If there are no corrections to make, or the corrections
do not fix the condition, take these steps:- If the error occurs infrequently and the TCP connections switch successfully to the alternate SMC-R link in the link group, the error might be a transient network condition. These errors can be ignored.
- If the error occurs repeatedly during SMC-R link
activation with rsn_code= X'0830500C',
the error might be a configuration issue with the Ethernet
switch. For suggestions on how to correct the switch configuration
issues, see z/OS Communications Server: IP Diagnosis Guide in
z/OS Communications Server: IP Diagnosis Guide.
- If the error occurs repeatedly, or the TCP connections do not
switch to the alternate SMC-R link in the link group,
instruct the operator to issue either of these commands:
- MODIFY CSDUMP,MESSAGE=IST2406I to collect a VTAM dump the next time this message group is displayed.
- MODIFY CSDUMP,MESSAGE=IST2406I,RNICTRLE=trlename to
collect both a VTAM dump
and a 10GbE RoCE Express diagnostic
dump the next time this message group is generated
for an SMC-R link associated with trlename.
The diagnostic dump is disruptive to all TCP/IP stacks
that activate the 10GbE RoCE Express interface, so this option should
be used only when a VTAM dump
provides insufficient information to diagnose the
problem. In addition, you should ensure that an alternate
SMC-R link is available so that the TCP connections remain active
when the diagnostic dump is taken.
When the diagnostic information is collected, contact IBM® Service.
User response
Not applicable.
Problem determination
Not applicable.
Source
z/OS Communications Server SNA
Module
Use the modifiable VTAM start option MSGMOD=YES (f procname,vtamopts,msgmod=yes or f procname,msgmod=yes) to display the issuing module when a message is issued. See z/OS Communications Server: SNA Operation and z/OS Communications Server: SNA Resource Definition Reference for more information about start options.
Routing code
2
Descriptor code
5
Automation
This message is not a good candidate for automation.
Example
IST2406I SMC-R LINK FAILURE ON TRLE IUT10018 CODE = 8014510B
IST1717I ULPID = TCPCS1 ULP INTERFACE = EZARIUT10018
IST2407I LOCAL LINK ID = 2D8F0100 REMOTE LINK ID = 729D0101
IST2408I LOCAL MAC = 02000012F030 REMOTE MAC = 02000112F030
IST2409I LOCAL GID = FE80::200:1FF:FE12:F030
IST2409I REMOTE GID = FE80::200:FF:FE12:F030
IST2410I LOCAL QP = 40 REMOTE QP = 41
IST2411I VLAN = 100
IST314I END