Return and Reason Codes
- GPR 15 (and RETCODE, if specified) contains a return code.
- If the return code is not zero, GPR 0 (and RSNCODE, if specified) contains a reason code.
- 0
- IXLRETCODEOK
- 4
- IXLRETCODEWARNING
- 8
- IXLRETCODEPARMERROR
- C
- IXLRETCODEENVERROR
- 10
- IXLRETCODECOMPERROR
The following table contains hexadecimal return and reason codes, the equate symbols associated with each reason code, and the meaning and suggested action for each return and reason code.
Hexadecimal
Return Code |
Hexadecimal
Reason Code |
Equate Symbol
Meaning and Action |
---|---|---|
0 | None. | Meaning: If you specified a MODE value of ASYNCECB,
ASYNCEXIT, or ASYNCTOKEN, the request has been successfully initiated.
The answer area (ANSAREA) fields will not contain valid information
until the asynchronous processing has completed. For any other MODE
value, the request has successfully completed. Action:
|
4 | xxxx0402 | Equate Symbol: IXLRSNCODEASYNCH Meaning: The
request could not be processed synchronously. It will be processed
asynchronously. The answer area (ANSAREA) fields will not contain
valid information until the asynchronous processing has completed.
Action:
|
4 | xxxx0409 | Equate Symbol: IXLRSNCODETIMEOUT Meaning: The request has completed prematurely because the model-dependent time-out criteria of the coupling facility has been exceeded. The index of the next name element to be processed has been returned in the answer area (field CAAULINDEX). Action: Reissue the request. Update FIRSTNAME (from CAAULINDEX) with the index of the next name element to be processed. Be sure to process the information returned from this request before reissuing the request. The data returned from this request will be overwritten if you specify the same buffer address. Continue to reissue the request until the return code indicates that all processing has completed. For more information about premature request completion, see z/OS MVS Programming: Sysplex Services Guide. |
8 | xxxx0801 | Equate Symbol: IXLRSNCODEBADPARMLIST Meaning: The parameter list (mfctrl) for this request is not addressable. The answer area (ANSAREA) fields are not valid. Action:
|
8 | xxxx0804 | Equate Symbol: IXLRSNCODEBADVERSION# Meaning: The version number in the macro parameter list is not compatible with the level of XES currently being used. The answer area (ANSAREA) fields are not valid. Action:
|
8 | xxxx080A | Equate Symbol: IXLRSNCODEBADCONTOKEN Meaning: Program error. The specified
connect token (CONTOKEN) was not valid for one of the following reasons:
Note: The answer area (ANSAREA) fields are not valid.
Action: Verify that the CONTOKEN value specified was valid and for the correct structure.
The numbers on the following actions correspond to the numbers above.
You may want to issue IXCQUERY to get more information about the structure. |
8 | xxxx081E | Equate Symbol: IXLRSNCODEBADCOLOCKSTATE Meaning: You
requested that an entry in BUFFER or BUFLIST have its change bit overridden
to indicate that the entry contains changed data, but this option
is incompatible with the current cast-out lock state value, "write
with castout." The "write with castout" state is entered when the
cast-out lock is obtained by a WRITE_DATA request specifying GETCOLOCK=YES.
The following fields are returned in the answer area:
Action: The lock state and value are
returned in the answer area (ANSAREA).
You can bypass the current entry by updating FIRSTNAME with the index after the value in CAAULINDEX, and resubmitting your request. |
8 | xxxx0824 | Equate Symbol: IXLRSNCODEWRONGSTRTYPE Meaning: The connect token specified by CONTOKEN is not to a cache structure. Action: Verify the connect token for this cache structure. Note: The connect token can be found in the IXLCONN answer area. Verify the value specified on the
TYPE= parameter of the IXLCONN request for this structure.
|
8 | xxxx0825 | Equate Symbol: IXLRSNCODENOENTRY Meaning: Program error. The request failed because a name element specified an entry name that is not in the cache structure. All name elements before the offending name were processed; no name elements beyond the offending name were processed. The index of the offending name is returned in the answer area (field CAAULINDEX). Action: Reissue the request specifying for FIRSTNAME the next valid name element to be processed. |
8 | xxxx0829 | Equate Symbol: IXLRSNCODEBADUNLOCKVAL Meaning: Program error. The UNLOCK_CASTOUT request encountered a name element for which the cast-out lock was not held for the connection specified by CONTOKEN and/or the PROCESSID specified. Processing was halted with this name element. The lock state (field CAACOLOCKSTATE) and lock value (field CAACOLOCKVAL) for the element as well as the index value (field CAAULINDEX) for the name element that caused the failure are returned in the answer area (ANSAREA). Action: Specify for FIRSTNAME the index of the next name element (CAAULINDEX + 1) for which the cast-out lock is held, and reissue the request. |
8 | xxxx082B | Equate Symbol: IXLRSNCODEBADIDINDEX Meaning: Program error. The name index specified by either FIRSTNAME or LASTNAME is not valid. Some elements may have been processed. CAAULINDEX contains the index of the name that caused the failure. Action: Ensure that FIRSTNAME and LASTNAME specify valid indexes into the elements stored in BUFLIST or BUFFER. |
8 | xxxx082F | Equate Symbol: IXLRSNCODEBADPARITY Meaning: Program error. The parity bits in a name element are not valid. Action: The buffers specified in the request contained parity bits that were not valid. The answer area field CAAULINDEX, contains the index of the name element that caused the failure. The value for the parity bits may be 00, 01, or 11 in bits 2 and 3 of the specification (xxpp xxxx where pp is the parity bits). See mapping macro IXLYCUNB to find the parity bits in the buffer. |
8 | xxxx0833 | Equate Symbol: IXLRSNCODEBADPGBLATTR Meaning: Program error. The storage area specified by BUFFER, or one of the buffers in the BUFLIST list is specified as being pageable (PAGEABLE=YES) but is not. Action: Change the buffer area(s) to pageable storage, or specify PAGEABLE=NO. See the PAGEABLE parameter description for specification instructions. |
8 | xxxx0834 | Equate Symbol: IXLRSNCODEBADNONPGBLATTR Meaning: Program error. The storage area specified by BUFFER, or one of the buffers in the BUFLIST list is specified as being nonpageable (PAGEABLE=NO) but is either pageable or not addressable. Action: Ensure that:
|
8 | xxxx0835 | Equate Symbol: IXLRSNCODEBADDATAADDR Meaning: Program error. The storage area specified by BUFFER, or one of the buffers in the BUFLIST list, is not addressable. Action: Ensure
that:
|
8 | xxxx0836 | Equate Symbol: IXLRSNCODEBADREALADDR Meaning: Program error. Real storage addresses were provided in a BUFLIST list, but one of the buffers is not addressable in central storage. Action:
|
8 | xxxx0838 | Equate Symbol: IXLRSNCODEBADANSAREA Meaning: Program error. The storage area specified by ANSAREA is not addressable. Action:
|
8 | xxxx0839 | Equate Symbol: IXLRSNCODEBADREQTOKENAREA Meaning: Program error. The storage area specified by REQTOKEN is not addressable. Action: Ensure
that the request token area specified by REQTOKEN is valid:
|
8 | xxxx083D | Equate Symbol: IXLRSNCODEBADANSLEN Meaning: Program error. The length of the answer area, as specified by ANSLEN, is not sufficient to contain answer area information. The answer area (ANSAREA) fields do not contain valid information. Action: Increase the size of the answer area provided for the request, and rerun your
program. Depending on the macro version number, specify the length of the answer area as follows:
|
8 | xxxx0851 | Equate Symbol: IXLRSNCODENOSUSPENDISABLE Meaning: Program error. The request failed because MODE=SYNCSUSPEND was specified, but the caller is disabled and cannot be suspended. Action: Either specify another MODE value or become enabled (release the CPU lock); then reissue the request. |
8 | xxxx0865 | Equate Symbol: IXLRSNCODEBADBUFSPEC Meaning: Program error. There is an error in the buffer specification. Action: Check the following:
|
8 | xxxx0866 | Equate Symbol: IXLRSNCODEBADBUFKEY Meaning: Program error. The buffer storage key specified by BUFSTGKEY is incorrect or BUFSTGKEY was not specified and the caller's PSW key does not match the key of the buffers. The data cannot be fetched from the specified buffer area. Action: Check the following:
|
8 | xxxx0867 | Equate Symbol: IXLRSNCODEBADBUFLIST Meaning: Program error. The 128-byte storage area specified by BUFLIST is not addressable. Action: Ensure that:
|
8 | xxxx08AD | Equate Symbol: IXLRSNCODEBADHIGHSHAREDVIRT Meaning: Program error. The request specified a high shared virtual storage area (above 2GB). Action: None required. |
C | xxxx0C06 | Equate Symbol: IXLRSNCODENOCONN Meaning: Environmental error. No connectivity to the cache structure exists. This may occur due to operator commands such as VARY PATH,OFFLINE or CONFIG CHP,OFFLINE or hardware errors such as facility or path failures. The CONTOKEN is invalidated. The request fails. Action: Either disconnect from the structure (using IXLDISC) or initiate a rebuild of the structure, if allowed (using IXLREBLD). |
C | xxxx0C13 | Equate Symbol: IXLRSNCODEREQPURGED Meaning: Environmental error. The
request was purged prior to completion of the request. Possible reasons include:
Action: None if this is expected. Otherwise, determine why the connector failed. |
C | xxxx0C14 | Equate Symbol: IXLRSNCODESTATUSUNKNOWN Meaning: Environmental error. The IXLCACHE request has completed, but the final disposition of the request cannot be determined. The answer area (ANSAREA) fields do not contain valid information. Action: Verify the validity of your data by comparing the expected results with what is in the coupling facility. |
C | xxxx0C25 | Equate Symbol: IXLRSNCODESTRFAILURE Meaning: Environmental error. The cache structure failed prior to completion of the request. Action: Attempt to rebuild the structure using IXLREBLD, or disconnect from the structure using IXLDISC. |
C | xxxx0CA0 | Equate Symbol: IXLRSNCODEQUIESCEDSUSPENDFAIL Meaning: Environmental error. The request is failed because the structure is quiesced for a system-managed process and SUSPEND=FAIL is specified on the IXLCONN. Action: None, if this is expected. |
C | xxxxFFFF | Equate Symbol: IXLRSNCODENOTAVAILABLE Meaning: Environmental error. XES functions are not available. The coupling facility hardware might not be present. Action: XES may not be used when XCF is running local mode. XES requires that the coupling facility be installed. |
10 | xxxx10xx | Equate Symbol: IXLRSNCODECOMPERROR Meaning: System error. XES processing failure. The state of the structure and the disposition of the request are unpredictable. The answer area (ANSAREA) fields do not contain valid information. Action: Save the reason code information, and contact the IBM® support center. |