DFHIR3780 applid Unable to start interregion communication. Return code=X'retcode', Reason code=X'rsncode'.
Explanation
CICS attempted to establish itself as a user of the interregion communication (IRC) services, but the attempt failed.
System action
The IRC session is not started.
Message DFHME0116, which contains the symptom string for this problem, is produced.
User response
The return code and reason code (if any) correspond to a number of possible errors. 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.)
The return codes should be referenced from the documentation for the version of CICS that supplied the IRP program in use rather than the version of CICS that issued the message.
Check that the following requirements are satisfied:
-
A copy of DFHIRP providing an adequate level of function is present in the link pack area (LPA).
-
CICS has been defined as an operating system subsystem. The Installing CICS TS explains how to define CICS as a subsystem.
-
The XCF couple data sets have been formatted with enough XCF groups and members per group to satisfy the requirements of your installation.
-
The userid of the CICS job is authorized to log on to the CICS interregion program (DFHIRP) using the generic applid specified.
-
The CICS region has a unique generic applid within the MVS sysplex.
-
The CICS DB2 attachment has not been initialized before the first start of IRC in a CICS system that is using both of the following:
-
Multiregion operation (MRO) or CICS shared database, where any of the installed MRO or CICS shared database resource definitions specify ACCESSMETHOD(XM)
-
The DB2 CICS attachment to run DB2 applications.
-
If the message is issued when all of these conditions have been met, you will need further assistance from IBM. See IBM problem support for guidance on how to proceed.
Module
XMEOUT parameters/Message inserts
- applid
- X'retcode'
- X'rsncode'
Destination
Console