Return and Reason Codes

When the IXCTERM 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 IXCTERM Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
00	None.	Meaning: IXCTERM completed successfully; XCF will terminate the member. Action: None.
08	04	Equate Symbol: IXCTERMRSNNOTACTIVE Meaning: Program error. The calling member token does not identify an active member. Action: Take one or more of the following actions: Ensure that the proper MEMTOKEN address and ALET (if appropriate) were used. Any additional action depends on your application. Because the member (MEMTOKEN) is no longer active, your program might want to stop any further activity associated with the member.
08	08	Equate Symbol: IXCTERMRSNINAPPROPRIATEPRIMARY Meaning: Program error. The primary address space is not the same as the primary address space of the caller of the IXCJOIN that placed the calling member in the active state. Action: Take one or more of the following actions: Ensure that the correct MEMTOKEN address and ALET (if appropriate) were used. Change your program to issue IXCTERM from the address space in which the calling member joined the group and retry the request.
08	0C	Equate Symbol: IXCTERMRSNTARGETNOTACTIVE Meaning: Program error. The target member is not an active member. Action: If the member is expected to be in an active state, ensure that the TARGET MEMTOKEN is correct, and retry the request. If the target member is required to be in a not-defined state, you can use the IXCQUERY service to determine if the member is in a created, quiesced, or failed state. You can use the IXCDELET service to place the member in a not-defined state.
08	10	Equate Symbol: IXCTERMRSNTARGETNOTDEFINED Meaning: Program error. The target member is not defined to XCF. Action: If the TARGET member is expected to be in an active, created, quiesced, or failed state, ensure that the correct TARGET MEMTOKEN was specified. Otherwise, no action is required because the target member has terminated.
08	14	Equate Symbol: IXCTERMRSNTARGETDIFFERENTGROUP Meaning: Program error. The target member and the issuing member are in different XCF groups. Action: Take one or more of the following actions: Ensure that the correct TARGET and MEMTOKEN member tokens were specified. Check the addresses and ALETs (if appropriate). You might have to change your program to ensure that it issues IXCTERM only with TARGET and caller (MEMTOKEN) members that are in the same group.
08	18	Equate Symbol: IXCTERMRSNTARGETNOTVALID Meaning: Program error. The target member token is not valid. Action: Take one or more of the following actions: Ensure that the correct TARGET member token address and ALET (if appropriate) were used. If your program is running in AR mode, ensure that the SYSSTATE ASCENV=AR macro was issued before the IXCTERM.
08	1C	Equate Symbol: IXCTERMRSNMEMTOKENNOTVALID Meaning: Program error. The token of the issuing member is not valid. Action: Correct the member token and retry the request.
08	40	Equate Symbol: IXCTERMRSNPLISTRSVDNOTVALID 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: IXCTERMRSNPLISTBADALET Meaning: Program error. Your program is running in AR mode, and the ALET that qualifies the address of the control parameter list is neither zero nor associated with a valid entry on the caller's DU-AL. Action: Ensure that: You specified SYSSTATE ASCENV=AR before issuing the IXCJOIN macro. The ALET for the parameter list is on the DU-AL or is zero (primary address space ALET).
08	104	Equate Symbol: IXCTERMRSNPLISTVERSIONNOTVALID 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: IXCTERMRSNPLISTBADFUNCTION 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, and that it was assembled with the correct macro library for the release of MVS your program is running on.
08	10C	Equate Symbol: IXCTERMRSNPLISTBADSTG Meaning: Program error or environmental 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 mode: Ensure that you specified SYSSTATE ASCENV=AR before issuing the IXCTERM 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: IXCTERMRSNNOTTASKMODE Meaning: Program error. The caller is not in task mode. Action: Correct your program so that it issues IXCTERM only while in task mode.
08	11C	Equate Symbol: IXCTERMRSNNOTENABLED Meaning: Program error. The caller is not enabled. Action: Correct your program so that it issues IXCTERM only while enabled.
08	120	Equate Symbol: IXCTERMRSNTARGETNOTMEMASSOCTASK Meaning: Program error. The target member cannot be terminated because it is associated with an address space instead of a task. Action: Change your program to associate the member with a task, or cancel the member's associated address space.
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.