Return and Reason Codes

When the IXCQUERY macro returns control to your program:

GPR 15 (and retcode, if you coded RETCODE) contains a return code.
When the value in GPR 15 is not zero, GPR 0 (and rsncode, if you coded RSNCODE) contains a reason code if applicable.

Mapping macro IXCYQUAA provides equate symbols for the reason codes. 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 IXCQUERY Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None.	Meaning: IXCQUERY completed successfully and returned the requested information. Action: None.
4	00000004	Equate Symbol: QUAARSNRECORDSREMAIN Meaning: Program error. IXCQUERY completed successfully and provided some data; however, ANSAREA is too small to contain all the requested data. Action: Take one or more of the following actions: If the required information is contained in the ANSAREA, no further action needs to be taken. If the required information is not contained in the ANSAREA, obtain a larger ANSAREA and reissue IXCQUERY. The QUAHTLEN field contains the ANSAREA size that is required to contain all of the information requested. However, because IXCQUERY returns only a snapshot of the current environment, it is possible that the QUAHTLEN may be too small on the next invocation. Ensure that you specified the correct length for the answer area.
8	00000004	Equate Symbol: QUAARSNGROUPNOTFOUND Meaning: Program error. The group name specified is not defined to XCF. Action: Take one or more of the following actions: Ensure that the correct group name, group name address, and ALET (if appropriate) were specified. Correct the group name and retry the request. Any further action depends on your application. Some type of recovery action might need to be taken. However, if the group no longer exists, no action is required.
8	00000008	Equate Symbol: QUAARSNREQINFONOTVALID Meaning: Program error. The REQINFO information is not valid. Action: Take one or more of the following actions: Ensure that GROUP, SYSPLEX, COUPLE, CF, CF_ALLDATA, STR_ALLDATA, STR, ARMSTATUS, or ARMS_ALLDATA was specified for REQINFO. If REQINFO=GROUP was specified, ensure that GRPNAME or MEMNAME was specified. Ensure that the parameter list was not inadvertently overlaid. Ensure that the correct parameter list and ALET were specified. If your program is running in AR ASC mode, ensure that SYSSTATE ASCENV=AR was specified.
8	0000000C	Equate Symbol: QUAARSNREQTYPEINCOR Meaning: Program error. The caller specified the REQTYPE control parameter incorrectly. Action: Take one or more of the following actions: Ensure that a REQTYPE of DEFER or IMMEDIATE was specified. Ensure that the parameter list was not inadvertently overlaid. Ensure that the correct parameter list address and ALET were specified. If your program is running in AR mode, ensure that SYSSTATE ASCENV=AR was specified.
8	00000010	Equate Symbol: QUAARSNMEMBERNOTFOUND Meaning: Program error. The member name specified is not defined within the specified group, or the MEMTOKEN specified was not defined to XCF. Action: The action you take depends on your application. If you have reason to believe that the member is defined, ensure that: The parameter list was not inadvertently overlaid. The correct parameter list address and ALET were specified. SYSSTATE ASCENV=AR was specified if your program is running in AR mode.
8	00000014	Equate Symbol: QUAARSNANSAREATOOSMALL Meaning: Program error. The length the caller specified on ANSLEN is too small to contain even the header. Action: Take one or more of the following actions: Provide an answer area that is large enough to contain at least the header information as mapped by the field QUAHDR of the query answer area mapping. Ensure that you specified the correct length for the answer area. Ensure that the parameter list was not inadvertently overlaid. Ensure that you specified the correct answer area address and ALET. If your program is running in AR mode, ensure that you specified SYSSTATE ASCENV=AR
8	00000018	Equate Symbol: QUAARSNANSAREANOACCESS Meaning: Program error. XCF cannot access the area specified by ANSAREA. Action: Take one or more of the following actions: Ensure that the correct ANSAREA address, ALET, and ANSLEN were specified. Ensure that the parameter list storage area was not inadvertently freed by your program. If your program is running in AR mode, ensure that you specified SYSSTATE ASCENV=AR before issuing the IXCQUERY macro.
8	0000001C	Equate Symbol: QUAARSNANSALETNOTVALID Meaning: Program error. The ALET that qualifies the address of the ANSAREA is neither zero nor is it associated with a valid public entry on the DU-AL. Action: Ensure that: Your program is not intended to run in primary ASC mode. If your program is running in AR mode, you specified SYSSTATE ASCENV=AR before issuing the IXCQUERY macro. The ALET for the parameter list is a valid public entry on the DU-AL or is zero (primary address space ALET).
8	00000020	Equate Symbol: QUAARSNCFNOTFOUND Meaning: Program error. The coupling facility name specified is not defined in the CFRM active policy. Action: Take one or more of the following actions: Ensure that the correct coupling facility name was specified. Correct the coupling facility name and retry the request. Any further action depends on your application. Some type of recovery action might need to be taken. However, if the coupling facility is no longer defined in the CFRM active policy, no action is required.
8	00000024	Equate Symbol: QUAARSNSTRNOTFOUND Meaning: Program error. The structure name specified is not defined in the CFRM active policy. Action: Take one or more of the following actions: Ensure that the correct coupling facility structure name was specified. Correct the coupling facility structure name and retry the request. Any further action depends on your application. Some type of recovery action might need to be taken. However, if the coupling facility is no longer defined in the CFRM active policy, no action is required.
8	00000028	Equate Symbol: QUAARSNARMNAMENOTFOUND Meaning: Program error. The job, element, system, or restart group name specified is not known to the automatic restart manager. Action: The action you take depends on your application. If you have reason to believe that the name is correct ensure that: The parameter list was not inadvertently overlaid. The correct parameter list address and ALET were specified. SYSSTATE ASCENV=AR was specified if your program is running in AR mode. The correct name was specified.
8	00000034	Equate Symbol: QUAARSNAMODE24 Meaning: Program error. The IXCQUERY macro was issued in 24-bit addressing mode. Action: IXCQUERY runs in 31-bit addressing mode. Correct your program so that it calls IXCQUERY while in 31-bit addressing mode.
8	00000040	Equate Symbol: QUAARSNBADPLISTRSVD Meaning: Program error or environmental error. A reserved field in the control parameter list is not zero. Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of MVS™ your program is running on.
8	000000A0	Equate Symbol: IXCARMINVR0 Meaning: System error. Action: Make sure your program was assembled with the correct macro library for the release of MVS your program is running on. If the macro version is correct, retry the request at least once.
8	000000A4	Equate Symbol: IXCARMR0TYPECONFL Meaning: System error. Action: Verify that: The parameter list was not inadvertently overlaid. The parameter list was initialized. Your program was assembled with the correct macro library for the release of MVS your program is running on. If IXCQUERY was called in AR mode: The SYSSTATE ASCENV=AR macro was issued prior to this macro. If the parameter list address was specified using explicit register notation, the corresponding access register was updated accordingly. This area is either in the primary address space or in an address/data space that is addressable through a public entry on the caller's DU-AL. If everything is verified, retry the request at least once. If the problem persists, record the return and reason code, and supply them to the appropriate IBM® support personnel.
8	00000100	Equate Symbol: QUAARSNPLISTALETNOTVALID Meaning: Program error. The ALET that qualifies the address of the control parameter list is neither zero nor associated with a valid public entry on the caller's DU-AL. Action: Ensure that: Your program is not intended to run in primary ASC mode. You specified SYSSTATE ASCENV=AR before issuing the IXCQUERY macro. The ALET for the parameter list is a valid public entry on the DU-AL or is zero (primary address space ALET).
8	00000104	Equate Symbol: QUAARSNVERSIONNOTVALID Meaning: Program or environmental error. The version number in the control parameter list is not valid. Your program might have inadvertently written over an area in the control parameter list. Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of MVS your program is running on.
8	00000108	Equate Symbol: QUAARSNFUNCCODENOTVALID Meaning: Program error or environmental error. The function code in the control parameter list is not valid. Your program might have inadvertently written over an area in the control parameter list. Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of MVS your program is running on.
8	0000010C	Equate Symbol: QUAARSNPLISTNOACCESS Meaning: Program error or environmental error. XCF could not access the control parameter list. Action: Check to see if your program inadvertently freed or overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of MVS your program is running on.
8	00000118	Equate Symbol: QUAARSNNOTTASKMODE Meaning: Program error. The caller is not in task mode. Action: Correct your program so that it issues IXCQUERY while in task mode.
8	0000011C	Equate Symbol: QUAARSNNOTENABLED Meaning: Program error. The caller is not enabled. Action: Correct your program so that it issues IXCQUERY while it is enabled.
8	00000120	Equate Symbol: QUAARSNHASLOCK Meaning: Program error. The caller is holding a lock. Action: Correct your program so that it issues IXCQUERY when it is not holding a lock.
8	00000124	Equate Symbol: QUAARSNHASEUTFRR Meaning: Program error. The caller has an EUT FRR established. Action: Correct your program so that it issues IXCQUERY when it does not have an EUT FRR established.
8	00000128	Equate Symbol: QUAARSNQUAALEVELNOTVALID Meaning: Program error. The caller specified a value for QUAALEVEL that is not valid. Action: Correct your program so that it specifies a valid value for QUAALEVEL.
C	00000004	Equate Symbol: QUAARSNDSPSERVFAIL Meaning: XCF was unable to create a data space for an IXCQUERY request. This reason code applies only to IXCQUERY requests REQINFO=CF, CF_ALLDATA, STR, or STR_ALLDATA. Action: Retry the request one or more times. If the problem persists, record the return and reason codes and supply them to the appropriate IBM support personnel.
C	00000008	Equate Symbol: QUAARSNALESERVFAIL Meaning: XCF was unable to associate a data space to an address space on behalf of an IXCQUERY request. This reason code applies only to IXCQUERY requests REQINFO=CF, CF_ALLDATA, STR, or STR_ALLDATA. Action: Retry the request one or more times. If the problem persists, record the return and reason codes and supply them to the appropriate IBM support personnel.
C	00000018	Equate Symbol: QUAARSNTASKABENDED Meaning: While the issuing task was suspended for XCF processing, the system abended the task (that is, another unit of work attempted to abnormally terminate this task). No data was returned in the ANSAREA. This reason code applies only to REQINFO=GROUP,REQTYPE=DEFER requests. Action: Retry the request one or more times. If the problem persists, record the return and reason codes and supply them to the appropriate IBM support personnel.
C	00000144	Equate Symbol: QUAARSNNOCFRMDSN Meaning: Environmental error. The CFRM active policy could not be read because the couple data set supporting TYPE(CFRM) is not accessible to this system. This reason code applies only to IXCQUERY requests REQINFO=CF, CF_ALLDATA, STR, or STR_ALLDATA. Action: Ensure that the request is issued from a system with access to a CFRM couple data set.
C	00000154	Equate Symbol: QUAARSNNOCFRMPOL Meaning: A CFRM policy has not been activated. This reason code applies only to IXCQUERY requests REQINFO=CF, CF_ALLDATA, STR, or STR_ALLDATA. Action: Ensure that a CFRM policy is active.
C	0000015C	Equate Symbol: QUAARSNFAILCFRMREAD Meaning: The CFRM active policy could not be read because the couple data set supporting TYPE(CFRM) is in error. This reason code applies only to IXCQUERY requests REQINFO=CF, CF_ALLDATA, STR, or STR_ALLDATA. Action: Retry the request one or more times. If the problem persists, record the return and reason codes and supply them to the appropriate IBM support personnel.
C	00000160	Equate Symbol: QUAARSNNOARMDSN Meaning: Environmental error. The automatic restart management couple data set could not be read because the couple data set supporting TYPE(ARM) is not accessible to this system. This reason code applies only to IXCQUERY requests REQINFO=ARMSTATUS and ARMS_ALLDATA. Action: If this reason code is not expected, contact the system programmer or issue a message to the operator to see if the automatic restart management couple data set can be brought online for this system. Issue this IXCQUERY request from a system that is connected to the automatic restart management couple data set.
C	00000164	Equate Symbol: QUAARSNFAILARMREAD Meaning: Environmental error. The automatic restart manager active policy could not be read because the couple data set supporting TYPE(ARM) is in error. This reason code applies only to IXCQUERY requests REQINFO=ARMSTATUS, and ARMS_ALLDATA. Action: Retry the request one or more times. If the problem persists, record the return and reason codes and supply them to the appropriate IBM support personnel.
10	xxxxxxxx	Meaning: System error. XCF processing failed. Action: Retry the request one or more times. If the problem persists, record the return and reason codes and supply them to the appropriate IBM support personnel.