Return and Reason Codes

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

0: IXCRETCODEOK
4: IXCRETCODEWARNING
8: IXCRETCODEPARMERROR
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 IXCDELET Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
00	None.	Meaning: IXCDELET completed successfully; XCF places the member in the not-defined state. Action: None.
08	04	Equate Symbol: IXCDELETRSNNOTDEFINED Meaning: Program error. The target member does not exist. Action: None required. However, if the target member is expected to exist, make sure TARGET MEMTOKEN is correct, and retry the request.
08	08	Equate Symbol: IXCDELETRSNINAPPROPRIATESTATE Meaning: Program error. The target member is not in a created, failed, or quiesced state. Action: The action required depends on your application. If the member is expected to be in a created, failed, or quiesced state, ensure that the TARGET MEMTOKEN is correct, and retry the request. If the target member can be in another state, use the IXCQUERY service to determine what state the member is in. If the member is not defined to the XCF group, no action is required. If the member is in an active state and should be placed in a not-defined state, you can use the IXCLEAVE or IXCTERM service to place the member in a not-defined state.
08	40	Equate Symbol: IXCDELETRSNPLISTRSVDNOTVALID 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.
08	100	Equate Symbol: IXCDELETRSNPLISTBADALET Meaning: Program error. Your program is not running in primary ASC mode, and 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 IXCDELET macro. The ALET for the parameter list is on the DU-AL or is zero (primary address space ALET).
08	104	Equate Symbol: IXCDELETRSNPLISTVERSIONNOTVALID Meaning: Program error. The version number in the control parameter list is not valid. Action: Check to see if your program inadvertently overlaid the parameter list storage.
08	108	Equate Symbol: IXCDELETRSNPLISTBADFUNCTION Meaning: Program error. The function code in the control parameter list is not valid. Action: Check to see if your program inadvertently overlaid the parameter list storage.
08	10C	Equate Symbol: IXCDELETRSNPLISTBADSTG Meaning: Program error. XCF could not access the control parameter list. Action: Take one or more of the following actions: Ensure that the correct parameter list storage area was specified. If your program is running in AR ASC mode: Ensure that you specified SYSSTATE ASCENV=AR before issuing the IXCDELET macro. Ensure that the parameter list ALET is correct. Ensure that the parameter list storage area was not inadvertently freed by your program.
08	118	Equate Symbol: IXCDELETRSNNOTTASKMODE Meaning: Program error. The caller is not in task mode. Action: Correct your program so that it issues IXCDELET only while in task mode.
08	11C	Equate Symbol: IXCDELETRSNNOTENABLED Meaning: Program error. The caller is not enabled. Action: Correct your program so that it issues IXCDELET only while enabled.
0C	18	Equate Symbol: IXCDELETRSNTASKABENDED Meaning: Environmental error. While the issuing task was suspended for XCF processing, the task was abended (i.e.another unit of work attempted to abnormally terminate this task). The state of the IXCDELET request is unpredictable. Action: Determine why this task was being abended.
10	None	Meaning: System error. XCF processing failed. Action: Retry the request at least once. If the problem persists, record the return code, and supply it to the appropriate IBM® support personnel.