Return and Reason Codes

When the IXLSYNCH 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 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 IXLSYNCH Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None.	Meaning: IXLSYNCH request successful. Requested changes are reflected in the corresponding system's local structure. Action: None
4	xxxx041E	Equate Symbol: IXLRSNCODESYNCHRTNOTDELETED Meaning: The resource was released through IXLSYNCH. However, a record data element could not be deleted. Action: None expected.
8	xxxx0804	Equate Symbol: IXLRSNCODEBADVERSION# Meaning: The version number in the parameter list is 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™ that your program is running on.
8	xxxx0807	Equate Symbol: IXLRSNCODENOTENABLED Meaning: IXLSYNCH request unsuccessful. The caller is not enabled. Action: Verify that the program is enabled for I/O and external interrupts.
8	xxxx080A	Equate Symbol: IXLRSNCODEBADCONTOKEN Meaning: Invalid CONTOKEN specified. The contoken is invalid for one of the following reasons: disconnect has occurred, EOT of the connector's task, input contoken is not the contoken returned from IXLCONN, the request was issued outside the connector's address space, or the contoken has been invalidated for rebuild. Action: Verify that the CONTOKEN value specified is valid and for the correct structure.
8	xxxx0810	Equate Symbol: IXLRSNCODERESOURCENOTFOUND Meaning: IXLSYNCH request unsuccessful. Resource that caused the notify exit to be given control has been released by a previous invocation of IXLSYNCH. Action: None expected. If necessary, attempt to regain ownership of the resource.
8	xxxx0811	Equate Symbol: IXLRSNCODESYNCHBADSTATE Meaning: IXLSYNCH request unsuccessful. Attempt to change STATE to a value other than shared, exclusive, or free. Action: Valid STATE values are shared, exclusive, and free. See IXLYCON.
8	xxxx0815	Equate Symbol: IXLRSNCODEBADNEPL Meaning: Specified NEPL is not valid. Note that the NEPL is no longer valid upon return from the notify exit to which it was presented. Action: Ensure that the NEPL address is specified correctly. Also, verify that the protocol does not attempt to reacquire the NEPL after returning from the notify exit.
8	xxxx0816	Equate Symbol: IXLRSNCODENORTEXISTS Meaning: IXLSYNCH request unsuccessful. Record structure does not exist. Action: Ensure that RECORD=YES was specified on the IXLCONN macro to request recording.
8	xxxx0879	Equate Symbol: IXLRSNCODEBADMODEVAL Meaning: Program error. The value specified for MODEVAL is not valid. Action: Verify that the value specified for MODEVAL is one of the possible mode value constants provided in the IXLYCON macro and that it is a valid value for the IXLSYNCH request being processed.
C	xxxx0C06	Equate Symbol: IXLRSNCODENOCONN Meaning: No connectivity to lock structure. This may occur due to operator commands such as VARY PATH OFFLINE or CONFIG CHP OFFLINE or hardware errors such as coupling facility or path failures. The contoken will be invalidated. Action: Either disconnect from the structure or rebuild.
C	xxxx0C0B	Equate Symbol: IXLRSNCODERTFULL Meaning: Record structure full. Action: If your protocol allows, attempt to rebuild the lock structure so that additional record data might be available.
C	xxxx0C10	Equate Symbol: IXLRSNCODEOLDGLOBALMANAGERINSTANCE Meaning: Environmental error. IXLSYNCH processing determined the global manager instance that initiated the call to the Notify Exit is no longer valid. The request was purged before processing the request. Action: Updates are not made during IXLSYNCH processing.IXLSYNCH requestors should not perform any updates and undo any updates previously made in anticipation of IXLSYNCH completing successfully. If global manager responsibilities need to be reassigned, the new global manager instance can reinitiate a call to the contention exit with the CeplRecovery indication that can provide instructions about where again to notify all owners of the resource.
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	xxxx0C25	Equate Symbol: IXLRSNCODESTRFAILURE Meaning: Prior to completion of the request, the lock structure failed. Action: Attempt to rebuild the structure using IXLREBLD or disconnect from the structure using IXLDISC.
C	xxxx0C69	Equate Symbol: IXLRSNCODENODELAY Meaning: Environmental error. An IXLSYNCH request in which the user specified MODEVAL=IXLMODESYNCFAIL encountered a delay. The request is canceled. Action: Retry request at a later time.
C	FFFFFFFF	Equate Symbol: IXLRSNCODENOTAVAILABLE Meaning: Locking functions are not available. This can occur because the coupling facility hardware necessary to provide locking function is not present. Action: Re-IPL the system, or follow your particular failure management protocol.
10	xxxx10xx	Meaning: Failure in XES processing. The state of the resource request is unpredictable. Action: Save the reason code information and contact the IBM® support center.