z/OS MVS Programming: Sysplex Services Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Return and Reason Codes

z/OS MVS Programming: Sysplex Services Reference
SA38-0658-00

When the IXLEERSP 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.
Macro IXLYCON provides equate symbols for the return and reason codes. The equate symbols associated with each hexadecimal return code are as follows:
0
IXLRETCODEOK
4
IXLRETCODEWARNING
8
IXLRETCODEPARMERROR
C
IXLRETCODEENVERROR
10
IXLRETCODECOMPERROR

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 IXLEERSP Macro
Hexadecimal Return Code Hexadecimal Reason Code

Equate Symbol
Meaning and Action

0 None Meaning: Processing for IXLEERSP has completed successfully.

Action: None.

4 xxxx041D Equate Symbol: IXLRSNCODEIGNOREFORREBUILDSTOP

Meaning: The response for the Rebuild Quiesce event was ignored because a Rebuild Stop is in progress.

Action: You should have been notified of the Rebuild Stop event. You may have issued IXLEERSP for the wrong event. You may have issued IXLEERSP for the Rebuild Quiesce event more than once. You may have connected during the Rebuild Quiesce window and a Rebuild Stop has been processed already. If so, respond to the Rebuild Stop event.

Check your protocol for the rebuild process.

4 xxxx0428 Equate Symbol: IXLRSNCODEIGNOREFORSYSMGDSTOP

Meaning: The response for the Structure Temporarily Unavailable event was ignored because the system-managed rebuild process has been stopped.

Action: None.

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.
8 xxxx0802 Equate Symbol: IXLRSNCODEBADPARMLISTALET

Meaning: Program error. The IXLEERSP parameter list ALET is not valid.

Action: All parameters must be in the primary address space so all ALETs should be set up accordingly. Fix the ALET of the parameter list and re-issue the macro.

8 xxxx0804 Equate Symbol: IXLRSNCODEBADVERSIONNUM (or 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:
  • Verify that your program did not overlay the parameter list storage.
  • Verify that your program was assembled with the correct macro library for the release of MVS™ on which your program is running.
8 xxxx0806 Equate Symbol: IXLRSNCODESRBMODE

Meaning: Program error. The requestor is in SRB mode.

Action: You must be running in task mode to issue this macro.

8 xxxx0807 Equate Symbol: IXLRSNCODENOTENABLED

Meaning: Program error. The requestor is not in an enabled state.

Action: The user must be enabled for I/O and external interrupts to issue this macro.

8 xxxx0809 Equate Symbol: IXLRSNCODEPRIMARYNOTHOME

Meaning: Program error. The primary address space does not equal the home address space.

Action: The primary address space must be equal to the primary address space when the IXLCONN was issued. The home address space must be equal to the primary address space.

8 xxxx080A Equate Symbol: IXLRSNCODEBADCONTOKEN

Meaning: Program error. The specified connect token (CONTOKEN) was not valid for one of the following reasons:

  1. The user with the connection identifier represented by the token has disconnected from the structure.
  2. The connector's task (the task that issued IXLCONN) ended.
  3. The specified token is not the token that was returned from IXLCONN.
  4. The request was issued from an address space other than the address space in which IXLCONN was issued.
  5. The connect token was invalidated during rebuild.
  6. The connect token was invalidated by XES.
Note: The answer area (ANSAREA) fields are not valid.

Action: Take the action with the corresponding meaning.

  1. Discontinue use of the structure. Perform recovery and cleanup for the structure and check the protocol for the use of the structure to determine why you did not know of the disconnection.
  2. Discontinue use of the structure. Perform recovery and cleanup for the structure and check the protocol for the use of the structure to determine why you did not know that the task ended.
  3. The contoken is returned in the CONACONTOKEN field of the answer area specified on the IXLCONN request.
  4. Issue your request from the same address space the IXLCONN was issued in.
  5. Wait for the rebuild to complete, and try again.
  6. Discontinue use of the structure. Perform recovery and cleanup for the structure.
C xxxx0C13 Equate Symbol: IXLRSNCODEREQPURGED
Meaning: Environmental error. The request was purged prior to completion of the request. Possible reasons include:
  • The connector failed.
  • The connector disconnected.
  • The requestor failed.
  • The request was purged by IXLPURGE.
  • Requests were purged when the connector provided an IXLEERSP response for the Rebuild Stop or Rebuild Cleanup event.
  • The secondary address space was no longer valid.

Action: None if this is expected. Otherwise, determine why the connector failed.

C xxxx0C3F Equate Symbol: IXLRSNCODECONNNOTDEFINED

Meaning: Environmental error. The CONTOKEN is for a connection that is in the not defined state.

Action: The connection issuing the IXLEERSP macro must be active. Verify the CONTOKEN passed. Check your protocol to determine why you are responding to this event.

C xxxx0C40 Equate Symbol: IXLRSNCODECONNNOTACTIVE

Meaning: Environmental error. The CONTOKEN is for a connection that is not in the active state.

Action: The connection issuing the IXLEERSP macro must be in the active state. Verify the CONTOKEN passed. Check your protocol to determine why you are responding to this event.

C xxxx0C41 Equate Symbol: IXLRSNCODEUNEXPECTEDRESPONSE

Meaning: Environmental error. This connection is responding to an event via IXLEERSP to which the system is not currently expecting a response.

Action: Prior to issuing the IXLEERSP macro, an event exit must have passed a return code of X'8' in the IXLYEEPL to indicate to XES that a response will be made to the event through the IXLEERSP macro. Otherwise, the response will not be expected. Check your event exit, and your protocol for handling events.

C xxxx0C42 Equate Symbol: IXLRSNCODEINVALIDEVENT

Meaning: Environmental error. The response provided via IXLEERSP is not one that is expected for the event presented.

Action: Verify the event specified and the parameters passed on the IXLEERSP.

C xxxx0C48 Equate Symbol: IXLRSNCODESUBJCONNNOTDEFINED

Meaning: Environmental error. The connection identified by SUBJCONTOKEN is in the not defined state.

Action: Verify that your parameter list has not been overlaid. Verify that SUBJCONTOKEN is from EEPLSUBJCONTOKEN from the EEPL passed to the event exit.

C xxxx0C49 Equate Symbol: IXLRSNCODEREBUILDEERSPIGNORED

Meaning: Environmental error. EVENT=REBLDCONNFAIL is not valid because the connection identified by SUBJCONTOKEN is not in the active state. The original connection has terminated.

Action: None necessary, but check your protocol to determine why you thought you needed to respond to this event. Verify that SUBJCONTOKEN is from EEPLSUBJCONTOKEN from the EEPL passed to the event exit. You may have responded more than once to this event.

C xxxx0C6D Equate Symbol: IXLRSNCODESUBJCONNNOTFAILING

Meaning: Environmental error. An attempt to respond by proxy on behalf of the connector identified by the value provided for the SUBJTOKEN keyword failed because that connector is not in the failing state.

Action: Ensure that you do not respond by proxy on behalf of a failing connector until after you have been presented with the EEPLDISCFAILCONNECTION event exit.

C xxxx0C91 Equate Symbol: IXLRSNCODESYSMGDRESPONSENOTPERMITTED

Meaning: The structure is in system-managed processing. A response is not permitted from the connection. The request is not processed.

Applies to the following events: REBLDQUIESCE, REBLDCONNFAIL, REBLDCLEANUP, and REBLDSTOP.

Action: Check your protocol for system-managed processes.

C FFFFFFFF Equate Symbol: IXLRSNCODENOTAVAILABLE

Meaning: There are no coupling facility services available. The hardware support necessary to support coupling facility services might not be present.

Action: Re-IPL the system, or follow your particular failure management protocol.

10 None Meaning: XES processing has failed.

Action: Save the reason code information and contact the IBM® support center.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014