Return and Reason Codes

When the IXLUSYNC 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 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 IXLUSYNC Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None.	Meaning: Processing completed successfully. Action: None.
4	xxxx0417	Equate Symbol: IXLRSNCODENOTLASTCONFIRMATION Meaning: Request to confirm the synchronization point has completed, but all connection confirmations have not yet been received. The next synchronization point has not yet been set. Applies only to REQUEST=CONFIRMSET Action: Request that the next event be set when all confirmations have been received for this event.
4	xxxx0420	Equate Symbol: IXLRSNCODEUSYNCEVENTSET Meaning: The user event specified has already been set by a peer connector. Action: Ensure that only one user-event is set at a time.
8	xxxx0801	Equate Symbol: IXLRSNCODEBADPARMLIST Meaning: The IXLUSYNC parameter list is not accessible. Action: Verify that: The parameter list is uncorrupted. The parameter list is addressable in the caller's primary address space. If you are invoking IXLUSYNC in AR-mode and you specified the parameter list address using explicit register notation, the corresponding access register must be updated appropriately. If you are invoking IXLUSYNC in AR-mode, SYSSTATE ASCENV=AR must be issued before the IXLUSYNC.
8	xxxx0802	Equate Symbol: IXLRSNCODEBADPARMLISTALET Meaning: The IXLUSYNC parameter list ALET is not valid. Action: Ensure that the ALET is zero or that the ALET represents a valid entry on the DU-AL.
8	xxxx0804	Equate Symbol: IXLRSNCODEBADVERSION# Meaning: There is an invalid version number in the IXLUSYNC parameter list. 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™ that your program is running on.
8	xxxx0806	Equate Symbol: IXLRSNCODESRBMODE Meaning: The requestor is in SRB mode. Action: Do not issue the IXLUSYNC macro when running in SRB mode.
8	xxxx0807	Equate Symbol: IXLRSNCODENOTENABLED Meaning: The requestor is not in an enabled state. Action: Issue the IXLUSYNC macro when running enabled for I/O and external interrupts.
8	xxxx0809	Equate Symbol: IXLRSNCODEPRIMARYNOTHOME Meaning: The primary address space does not equal the home address space. The request fails. Action: Make sure that the primary address space and the home address space are the same at the time of the IXLUSYNC invocation.
8	xxxx080A	Equate Symbol: IXLRSNCODEBADCONTOKEN Meaning: The requestor specified a CONTOKEN that is not valid. The CONTOKEN is invalid for one of the following reasons: disconnect has occurred, EOT of the connector's task, the input contoken is not the original contoken returned from IXLCONN, or the request was issued outside the connector's address space. Action: Verify that the CONTOKEN value specified was valid and for the correct structure.
8	xxxx0858	Equate Symbol: IXLRSNCODEBADUSEREVENT Meaning: The value specified for the USEREVENT or NEXTUSEREVENT keywords must be non-zero. Action: Correct the value specified for the USEREVENT or NEXTUSEREVENT keywords and resubmit the request.
8	xxxx0863	Equate Symbol: IXLRSNCODETASKTERM Meaning: The system rejects the request because the requesting task is going through termination. IXLUSYNC cannot be issued from a resource manager. Action: Examine your protocol to ensure that IXLUSYNC is not issued from a resource manager.
C	xxxx0C37	Equate Symbol: IXLRSNCODEUSEREVENTMISMATCH Meaning: Environment error. When confirming an event with REQUEST=CONFIRM or REQUEST=CONFIRMSET, the user event specified does not match the currently defined user event. Action: Ensure that the value of USEREVENT was specified correctly.
C	xxxx0C38	Equate Symbol: IXLRSNCODEUSERMISMATCH Meaning: Environmental error. The system did not expect a confirmation request from the responding connector. The connector probably has already confirmed the user event. Action: Check code to determine why the confirmation request was issued more than once. This return code is not issued on systems at z/OS® V1R8 and higher.
C	xxxx0C3F	Equate Symbol: IXLRSNCODECONNNOTDEFINED Meaning: Environmental error. The requesting connection is not defined. Action: Ensure that the IXLUSYNC request is issued by an active connector.
C	xxxx0C40	Equate Symbol: IXLRSNCODECONNNOTACTIVE Meaning: Environmental error. The requesting connection is not active. Action: Ensure that the IXLUSYNC request is issued by an active connector.
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	xxxx0C4B	Equate Symbol: IXLRSNCODEUSYNCEVENTNOTSET Meaning: Environmental error. When setting an event with REQUEST=SET, the system rejects the new user event because another event is still set. Either all confirmations have not been received for the current event or all connectors have not been notified of the previously completed event through the event exit. Action: Only one event can be set at a time.
C	xxxx0C4F	Equate Symbol: IXLRSNCODEUSYNCNOEVENTSET Meaning: Environmental error. A REQUEST=CONFIRM or REQUEST=CONFIRMSET is rejected because no user event is currently set. Action: Ensure that REQUEST=SET is issued before REQUEST=CONFIRM or REQUEST=CONFIRMSET.
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 SUBJCONTOKEN 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	FFFFFFFF	Equate Symbol: IXLRSNCODENOTAVAILABLE Meaning: Environmental error. XES functions are not available. This can occur because the coupling facility hardware necessary to provide XES functions is not present. Action: Re-IPL the system, or follow your particular failure management protocol.
10	xxxx10xx	Meaning: XES processing has failed. Action: Save the reason code information and contact the IBM® support center.