Return and Reason Codes

When the IXCSYSCL 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 IXCSYSCL Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
00	None.	Meaning: The request was accepted for processing. Action: None.
08	04	Equate Symbol: IXCSYSCLRSNNOTACTIVE Meaning: Program error. The member token specified is not for an active member in the primary address space. Action: The member token was returned by IXCJOIN when this member joined the XCF group. Try one or more of the following: Verify the token passed. Ensure that this request is running in the correct address space. Ensure that this request is for an active member. Verify that if IXCSYSCL was called in AR mode, the SYSSTATE ASCENV=AR macro was issued prior to this macro. Verify that if member token was specified using explicit register notation, the corresponding access register was updated accordingly.
08	08	Equate Symbol: IXCSYSCLRSNINAPPROPRIATEPRIMARY Meaning: Program error. The primary address space is neither the master scheduler address space nor the primary address space of the caller of the IXCJOIN request. Action: This macro must be issued from the same primary address space as when the IXCJOIN was issued. Ensure that: The parameter list has not been overlaid. This request is running in the correct address space. If IXCSYSCL was called in AR mode, the SYSSTATE ASCENV=AR macro was issued prior to this macro.
08	0C	Equate Symbol: IXCSYSCLRSNSYSCLEANUPMEMNO Meaning: Program error. The member token specified in MEMTOKEN is not for a member that specified SYSCLEANUPMEM=YES on the IXCJOIN macro. Action: The IXCSYSCL macro should be issued only by a member that joined the XCF group with SYSCLEANUPMEM=YES specified. If this return code is unexpected, then ensure that: The member token has not been overlaid. The correct member token is being used. If IXCSYSCL was called in AR mode, the SYSSTATE ASCENV=AR macro was issued prior to this macro. If the member token was specified using explicit register notation, the corresponding access register was updated accordingly.
08	10	Equate Symbol: IXCSYSCLRSNFAILEDSYSNOTVALID Meaning: Program error. The system token specified for FAILEDSYS is not valid. Action: The system token is from the group exit parameter list (IXCYGEPL). Ensure that: The system token has not been overlaid. If IXCSYSCL was called in AR mode, the SYSSTATE ASCENV=AR macro was issued prior to this macro. If the address space token was specified using explicit register notation, the corresponding access register was updated accordingly.
08	40	Equate Symbol: IXCSYSCLRSNPLISTRSVDNOTVALID Meaning: Program error. A reserved field in the parameter list is not zero. Action: Ensure that: The parameter list was not inadvertently overlaid. The parameter list was initialized before it was used. If IXCSYSCL was called in AR mode, the SYSSTATE ASCENV=AR macro was issued prior to this macro. Your program was assembled with the correct macro library for the release of MVS™ your program is running on. The correct parameter list version was specified.
08	100	Equate Symbol: IXCSYSCLRSNPLISTBADALET Meaning: Program error. The ALET that qualifies the address of the parameter list is not valid. Action: Ensure that: The address of the parameter list has not been overlaid. If IXCSYSCL 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.
08	104	Equate Symbol: IXCSYSCLRSNPLISTVERSIONNOTVALID Meaning: Program error. The version number specified in the IXCSYSCL parameter list is not valid. Action: Ensure that: Your program did not overlay the parameter list storage. Your program was assembled with the correct macro library for the release of MVS your program is running on. The correct parameter list version was specified.
08	108	Equate Symbol: IXCSYSCLRSNPLISTBADFUNCTION Meaning: Program error. The parameter list is not valid. Action: Ensure that: Your program did not overlay the parameter list storage. Your program was assembled with the correct macro library for the release of MVS your program is running on. If IXCSYSCL 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.
08	10C	Equate Symbol: IXCSYSCLRSNPLISTBADSTG Meaning: Program error. An error occurred when the system tried to access the parameter list. Action: Take one or more of the following actions: Ensure that the parameter list address has not been overlaid. 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 IXCSYSCL macro. If the parameter list address was specified using explicit register notation, the corresponding access register was updated accordingly. The parameter list 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. Ensure that the parameter list storage area was not inadvertently freed by your program. Ensure that your program was assembled with the correct macro library for the release of MVS your program is running on.
08	11C	Equate Symbol: IXCSYSCLRSNNOTENABLED Meaning: The caller is not enabled. Action: Correct your program so that it does not issue IXCSYSCL while it is disabled.
08	12C	Equate Symbol: IXCSYSCLRSNLOCKHELD Meaning: Program error. The caller of IXCSYSCL holds a lock. Action: Correct your program so that it does not issue IXCSYSCL while it is holding a lock.
10	None.	Meaning: System error. The system experienced an unexpected error while processing this request. Action: 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.