Return and Reason Codes

When the IXLFORCE macro returns control to your program:

GPR 15 (and retcode, if you coded RETCODE) contains a return code.
GPR 0 (and rsncode, if you coded RSNCODE) contains a reason code, if applicable.

Macro IXLYCON provides equate symbols for the return and reason codes. The equate symbols associated with each hexadecimal return code are as follows:

0: IXLRETCODEOK
4: IXLRETCODEWARNING
8: IXLRETCODEPARMERROR
C: IXLRETCODEENVERROR
10: IXLRETCODECOMPERROR

The following table identifies the hexadecimal return and reason codes and the equate symbol associated with each reason code.

Table 1. Return and Reason Codes for the IXLFORCE Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None	Meaning: IXLFORCE processing completed successfully. The structure, failed-persistent connection, all failed-persistent connections, structure dump, or structure dump serialization has been deleted as requested. Action: None.
4	xxxx041A	Equate Symbol: IXLRSNCODEFORCECONNDELSTR Meaning: The IXLFORCE request to delete a connection or all connections succeeded, but the structure disposition was DELETE, and no active connections to the structure remained. The structure was deallocated. Action: None necessary. However, if this result is unexpected, determine if the structure disposition was specified properly in IXLCONN.
4	xxxx041BA	Equate Symbol: IXLRSNCODEFORCESTRDELCONNS Meaning: Force of a structure was successful, but also resulted in the deletion of failed-persistent connection(s). Action: None necessary.
4	xxxx041C	Equate Symbol: IXLRSNCODEPENDING Meaning: The IXLFORCE request could not be processed immediately. The request is pending, and the system will process it when the condition causing the delay is resolved. Action: None necessary. If the delay is due to a dump associated with the structure, you might supply a dump data set for SDUMPX to write the dump or you might delete the dump.
8	xxxx0801	Equate Symbol: IXLRSNCODEBADPARMLIST Meaning: The IXLFORCE parameter list is not accessible. Action: Verify that: The parameter list address is uncorrupted. The parameter list is addressable in the caller's primary address space. If you are invoking IXLFORCE in AR-mode and you specified the parameter list address using implicit register notation, the corresponding access register was updated appropriately. If you are invoking IXLFORCE in AR-mode, SYSSTATE ASCENV=AR must be issued before the IXLFORCE.
8	xxxx0802	Equate Symbol: IXLRSNCODEBADPARMLISTALET Meaning: The IXLFORCE parameter list ALET is not valid. Action: Ensure that the ALET is zero or that the ALET represents a valid entry on the DU-AL.
8	xxxx0804	Equate Symbol: IXLRSNCODEBADVERSION# Meaning: Version number in the IXLFORCE parameter list is not valid. Action: Verify that your program did not overlay the parameter list storage. Verify that your program was assembled with the correct macro library for the release of MVS™ that your program is running on.
8	xxxx0806	Equate Symbol: IXLRSNCODESRBMODE Meaning: The requestor is in SRB mode. The request fails. Action: Do not issue the IXLFORCE macro when running in SRB mode.
8	xxxx0807	Equate Symbol: IXLRSNCODENOTENABLED Meaning: The requestor is not in an enabled state. The request fails. Action: Ensure that the user is enabled for I/O and external interrupts.
8	xxxx0809	Equate Symbol: IXLRSNCODEPRIMARYNOTHOME Meaning: Issuer's primary address space is not equal to the home address space. Action: Make sure that the primary address space and the home address space are the same at the time of the IXLFORCE invocation.
8	xxxx084C	Equate Symbol: IXLRSNCODEBADNOSAFAUTH Meaning: Environmental error. The user does not have the proper SAF authorization. The request fails. Action: Determine why the installation has not allowed the proper SAF authorization for access to the structure.
C	xxxx0C05	Equate Symbol: IXLRSNCODESTRNOTINPOLICY Meaning: Environmental error. The requested structure is not in the CFRM active policy. Action: Specify a structure that is currently defined in the CFRM active policy or switch to a new CFRM policy that contains the structure for which this IXLFORCE was invoked.
C	xxxx0C0A	Equate Symbol: IXLRSNCODESTRNOTALLOCATED Meaning: Environmental error. The requested structure is not currently allocated. Action: Ensure that the structure name has been specified correctly.
C	xxxx0C26	Equate Symbol: IXLRSNCODECONACTIVE Meaning: Environmental error. The requested connection is active. IXLFORCE can only delete connections in a failed-persistent state. Action: Ensure that the connection to be deleted is in a failed-persistent state.
C	xxxx0C27	Equate Symbol: IXLRSNCODERSPNOTREC Meaning: Environmental error. One or more surviving connections have not provided an event exit response for the requested connection. Action: Examine your protocol to determine why responses have not been provided.
C	xxxx0C28	Equate Symbol: IXLRSNCODESTILLACTIVECONN Meaning: Environmental error. The requested structure cannot be deleted because it still has active connections. Action: Do not delete a structure with active connections. Use IXCQUERY to determine the state of the structure connections.
C	xxxx0C29	Equate Symbol: IXLRSNCODEXESNOTACTIVE Meaning: Environmental error. The CFRM function is not active or is not available. Action: Bring the CFRM couple data set in use in the sysplex by issuing the SETXCF COUPLE,TYPE=CFRM,PCOUPLE= command.
C	xxxx0C2A	Equate Symbol: IXLRSNCODENOSUCHCONNECTION Meaning: Environmental error. The requested connection does not exist, or in the case of an ALLCONNS request, there are no failed-persistent connections to be deleted. Action: Ensure that the connection name was specified correctly.
C	xxxx0C33	Equate Symbol: IXLRSNCODECONNPENDINGRECONCIL Meaning: Environmental error. The specified structure still has connections in the coupling facility that are pending reconciliation into the CFRM active policy. Action: Retry the request at a later time.
C	xxxx0C4D	Equate Symbol: IXLRSNCODENOSTRDUMP Meaning: Environmental error. Either no structure dump was associated with the requested structure, or no structure dump with a matching STRDUMPID was associated with the requested structure. Action: Verify that the structure name and/or the structure dump identifier were specified correctly.
C	xxxx0C51	Equate Symbol: IXLRSNCODEREBUILDINPROGRESS Meaning: Environmental error. The requested structure is in a structure rebuild or a structure duplexing rebuild process. Structures and connections cannot be deleted while a structure rebuild is in progress. Structures and connections can be deleted while a structure duplexing rebuild is in the Duplex Established phase and no stop to switch to the new structure has been requested. Action: Retry the request at a later time.
C	FFFFFFFF	Equate Symbol: IXLRSNCODENOTAVAILABLE Meaning: Environmental error. XES functions are not available. This can occur because the coupling facility hardware necessary to provide XES functions is not present. Action: Re-IPL the system, or follow your particular management protocol.
10	xxxx10xx	Meaning: Failure in XES processing. Action: Save the reason code information and contact the IBM® support center.