Return and Reason Codes

When the IXCCFCM 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 IXCYCON provides equate symbols for the return and reason codes. The equate symbols associated with each hexadecimal return code are as follows:

0: IXCRETCODEOK
8: IXLRETCODEPARMERROR
C: IXCRETCODEENVERROR
10: IXCRETCODECOMPERROR

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 IXCCFCM macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None	Meaning: IXCCFCM request successful. Action: None required.
8	xxxx0801	Equate Symbol: IXCRSNCODEBADPARMLIST Meaning: Program error. The IXCCFCM parameter list is not valid. Action: Ensure that the parameter list is addressable and accessible in your program's key.
8	xxxx0802	Equate Symbol: IXCRSNCODEBADPARMLISTALET Meaning: Program error. The IXCCFRM parameter list ALET is not valid. Action: Ensure that macro usage meets environmental and programming requirements for control parameters.
8	xxxx0804	Equate Symbol: IXCRSNCODEBADVERSIONNUM Meaning: Program error. The level of z/OS® on which the caller is running does not support the specified IXCCFCM parameter list version. Action: Reissue the request specifying only keywords that are supported by the level of z/OS on which your program is running.
8	xxxx0806	Equate Symbol: IXCRSNCODENOTTASKMODE Meaning: Program error. The requestor is not in task mode. Action: Ensure that macro usage meets environmental requirements.
8	xxxx0807	Equate Symbol: IXCRSNCODENOTENABLED Meaning: Program error. The caller is not in an enabled state. Action: Ensure that macro usage meets environmental requirements.
8	xxxx0809	Equate Symbol: IXCRSNCODEPRIMARYNOTHOME Meaning: Program error. Issuer's primary address space is not the home address space. Action: Ensure that macro usage meets environmental requirements.
8	xxxx084C	Equate Symbol: IXCRSNCODEBADNOSAFAUTH Meaning: Program error. The caller does not have the required SAF authorization. Action: Determine why the installation has not allowed the proper SAF authorization for updating the policy.
8	xxxx084D	Equate Symbol: IXCRSNCODELOCKED Meaning: Program error. The caller holds a lock. Action: Ensure that macro usage meets environmental requirements.
8	xxxx0850	Equate Symbol: IXCRSNCODEBADPLISTRSVD Meaning: Program error. A reserved field in the parameter list is not valid. Action: Use the IBM-supported IXCCFCM macro interface to build the parameter list and execute the MVS™ service code. Only specify keywords that are supported on the level of z/OS on which your program is running.
8	xxxx0857	Equate Symbol: IXCRSNCODEFRR Meaning: Program error. The caller has an FRR defined. Action: Ensure that macro usage restrictions are not violated.
8	xxxx088A	Equate Symbol: IXCRSNCODEBADASCMODE Meaning: Program error. The ASC mode of the caller is not valid. Action: Ensure that macro usage meets environmental requirements.
8	xxxx088F	Equate Symbol: IXCRSNCODEBADSITE Meaning: Program error. The value of RecoverySite is not valid. Only 'SITE1' and 'SITE2' are valid values. Action: Ensure a valid site name is specified for RecoverySite.
C	xxxx0C29	Equate Symbol: IXCRSNCODENOCFRM Meaning: Environmental error. The CFRM function is not active or is not available. Action: Reissue the request when the CFRM function becomes available.
10	xxxx10xx	Meaning: Failure in CFRM processing. The state of the CFRM policy is unpredictable. Action: Save the reason code information and contact the IBM® support center.