DFHIR3788 date time applid Unexpected failure (return code=X'retcode', reason code=X'rsncode') trying to establish connection to system sysid
Explanation
CICS could not establish a link to system sysid, even though system sysid is available for communication.
The most common value of code X'retcode' returned by the interregion communication SVC is X'68'. This means that no connection to the requesting region has been defined in the target region.
Another possible value of code X'retcode' returned by the interregion communication SVC is X'138'. This means that although the requesting and the target region are both running in the same MVS image, and it is possible to connect via cross memory, the requesting and the target regions belong to different XCF Groups.
The four byte return code field displays the following information starting with the high order byte:
-
One byte error qualifier (if any)
-
One byte MVS return code (if any)
-
Two byte IRC return code
See Interregion control blocks in the CICS Data Areas manual for a complete list of return codes and error qualifiers. (The names of all the return codes and error qualifiers start with IRERR and IRERQ respectively.)
A possible reason for this message is that the applid of the system on which the message appears does not match the NETNAME on any of the system entries defined in system sysid.
This error may also occur when connections are being created dynamically. In this case, the mismatch is transient and will eventually be resolved when the connection creation process running on the remote CICS region completes.
System action
If the mismatch is transient, the connection is established.
If there is a definition error, the connection is not established. Any existing connections are not affected.
Message DFHME0116, which contains the symptom string for this problem, is produced.
User response
If the mismatch is transient, a connection should be established. This can be verified by querying the connection status using CEMT.
If an applid or a NETNAME mismatch has occurred, correct the error and retry.
If an XCFGROUP mismatch has occurred, correct the error and retry.
If a mismatch is not the cause of the error, you may need further assistance from IBM. See IBM problem support for guidance on how to proceed.
Module
XMEOUT parameters/Message inserts
- date
- time
- applid
- X'retcode'
- X'rsncode'
- sysid
Destination
CSMT