Return and Reason Codes

When the system 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.

Table 1. Return and Reason Codes for the IXLMG Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None	Meaning: IXLMG completed successfully and returned the requested information in the data area provided. Action: None.
4	xxxx0404	Equate Symbol: IXLRSNCODEMOREDATA Meaning: Not all requested data could be returned in the data area provided because the data area was not large enough. Action: Retry the request with a larger data area. The required size is provided in the IXLYAMDA header in the field IXLYAMDAREA_TLEN.
4	xxxx0421	Equate Symbol: IXLRSNCODESTGCLASSERR Meaning: The requested data could not be returned for the storage class information. The STGCLASS specified is a storage class that exceeds the maximum defined storage class for the structure. The maximum defined storage class is defined on the IXLCONN for initial structure allocation. Action: Retry the request with the correct value.
4	xxxx0422	Equate Symbol: IXLRSNCODECOCLASSERR Meaning: Not all requested data could be returned for the cast-out class information. Either the COCLASSE was larger than the maximum cast-out class, or the COCLASSB was larger than the maximum cast-out class for the structure. The start and end of range values returned indicates the amount of data reported. The cast-out class values are set on the IXLCONN invocation. Action: Retry the request with correct start and end values.
4	xxxx0423	Equate Symbol: IXLRSNCODESTRUCTUREERR Meaning: No data could be returned for the structure specified. The name is not for a known structure. Action: Retry the request with the correct structure name.
4	xxxx0426	Equate Symbol: IXLRSNCODESTRUCTUREFAIL Meaning: No data could be returned for the structure specified. The structure is in the failed state. Action: None necessary. IXLMG should only be called for valid structures. If this is unexpected, check your protocol to determine why you did not know about the problem with this structure.
8	xxxx0801	Equate Symbol: IXLRSNCODEBADPARMLIST Meaning: Program error. The parameter list for this request is not addressable. The answer area (ANSAREA) fields are not valid. Action: Verify that: The parameter list address is uncorrupted. The parameter list is addressable in the caller's primary address space. If you are issuing this macro while disabled, the parameter list resides in either page-fixed or DREF storage. If you are issuing this macro in AR-mode and you specified the parameter list address using explicit register notation, the corresponding access register was updated appropriately. If you are issuing this macro in AR-mode, SYSSTATE ASCENV=AR must be issued before issuing this macro. The parameter list resides in storage with a key that is consistent with the PSW key of the IXLMG invoker.
8	xxxx0802	Equate Symbol: IXLRSNCODEBADPARMLISTALET Meaning: The ALET for the parameter list is not valid. Action: All parameters must be in the primary address space so all ALETs should be set up accordingly.
8	xxxx0803	Equate Symbol: IXLRSNCODERESERVEDNOT0 Meaning: Reserved field in parameter list is not zero. Action: Check to see if your program overlaid the parameter list. Check the parameter list address to make sure it is uncorrupted. Make sure you are running with the same version of MVS™ that the macro was compiled with.
8	xxxx080D	Equate Symbol: IXLRSNCODEAREATOOSMALL Meaning: DATAAREA is too small to contain the minimum response information. (The minimum response information is the IXLYAMDA header information mapped by IXLYAMDAREA.) Action: Run the request again and specify a DATAAREA with a minimum DATALEN of IXLYAMDAREA_LENGTH.
8	xxxx080E	Equate Symbol: IXLRSNCODEBADAREA Meaning: Error accessing DATAAREA. Action: Verify the following: The DATAAREA specified is addressable in the primary address space. The DATAAREA is in fixed or disabled reference storage. The DATAAREA storage key is consistent with the PSW key of the IXLMG invoker.
8	xxxx080F	Equate Symbol: IXLRSNCODEBADAREAALET Meaning: DATAAREA ALET is not valid. Action: All parameters must be in the primary address space so all ALETs should be set up accordingly.
8	xxxx0885	Equate Symbol: IXLRSNCODEBADAMDALEVEL Meaning: The value specified for AMDALEVEL is not valid. Action: Retry the request with the correct AMDALEVEL value.
C	FFFFFFFF	Equate Symbol: IXLRSNCODENOTAVAILABLE Meaning: Environment error. There are no coupling facility services available. The hardware support necessary to provide coupling facility services might not be present. Action: XES may not be used when XCF is running in local mode. XES requires that the coupling facility be installed.
10	xxxx10xx	Meaning: Software failure in XES software processing. Action: Contact the IBM® support center.