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. A token for restarting the request has been returned in the answer area (field CAARESTOKEN or CAAEXTRESTOKEN). The number of processed directory entries that initially had the reference bit set (field CAAREFCOUNT), and the number of directory entries processed (field CAADIRCOUNT) are returned in the answer area. Action: Reissue the request using the appropriate restart token. 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 | 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 | 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 | xxxx0849 | Equate Symbol: IXLRSNCODEBADRESTOKEN Meaning: Program error. The restart token specified by RESTOKEN is not valid. Action: Determine why the restart token cannot be used to resume the request. Possible
causes are:
For more information about premature request completion, see z/OS MVS Programming: Sysplex Services Guide. |
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 | xxxx0887 | Equate Symbol: IXLRSNCODEBADEXTRESTOKEN Meaning: Program error. The extended restart token specified by EXTRESTOKEN is not valid. The specified token refers to an older instance of the target structure. A system-managed process occurred between the time a request returned the extended restart token and the time the connector tried to continue the request using that token. Action:Discard the results of the initial request and reissue the request with an EXTRESTOKEN value of zero. For more information about restarting requests, see z/OS MVS Programming: Sysplex Services Guide. |
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. |