Return and Reason Codes

When the IXLDISC macro returns control to your program:

GPR 15 (and retcode, if you coded RETCODE) contains a return code.
When the value in GPR 15 is not zero, if applicable, GPR 0 (and rsncode, if you coded RSNCODE) contains a reason code.

The IXLYCON macro 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 IXLDISC Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None	Meaning: Disconnection is successful. The connect token is now invalid and will be rejected on any subsequent requests. Action: None.
4	xxxx0401	Equate Symbol: IXLRSNCODEOWNINGRESOURCES Meaning: Disconnection is successful. Requestor owned the resources in the lock structure from which the requestor has disconnected. The disconnect will be treated as abnormal regardless of whether the connector specified REASON=NORMAL. If the connection is CONDISP=KEEP, the connector is made failed-persistent after all confirmations are received. Action: The system invalidates the connect token of the requestor.
8	xxxx0801	Equate Symbol: IXLRSNCODEBADPARMLIST Meaning: Program error. The IXLDISC parameter list is not accessible. Action: Verify that: The parameter list address is uncorrupted The parameter list is addressable in the caller's primary address space. If you are calling IXLDISC in AR-mode and you specified the parameter list address using explicit register notation, the corresponding access register was updated appropriately. If you are calling IXLDISC in AR-mode, SYSSTATE ASCENV=AR must be issued before the IXLDISC.
8	xxxx0802	Equate Symbol: IXLRSNCODEBADPARMLISTALET Meaning: Program error. The IXLDISC parameter list ALET is not valid. Action: Verify that: If you are calling IXLDISC in AR-mode and you specified the parameter list address using explicit register notation, the corresponding access register was updated appropriately. If you are calling IXLDISC in AR-mode, SYSSTATE ASCENV=AR must be issued before issuing the IXLDISC. If you are not running in AR-mode, and the parameter list does not need to be ALET-qualified, the corresponding access register should contain zeros.
8	xxxx0804	Equate Symbol: IXLRSNCODEBADVERSION# Meaning: Program error. The IXLDISC parameter list contains an invalid version number 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™ your program is running on.
8	xxxx0805	Equate Symbol: IXLRSNCODEBADTCB Meaning: Program error. The task that issued the IXLDISC macro is different from the task that issued the corresponding IXLCONN macro. Action: Set up your program so that it does the disconnect under the same TCB that the connect was done under.
8	xxxx0806	Equate Symbol: IXLRSNCODESRBMODE Meaning: Program error. The requestor is in SRB mode. Action: You must be running in task mode under the task that did the connect to issue IXLDISC.
8	xxxx0807	Equate Symbol: IXLRSNCODENOTENABLED Meaning: Program error. The requestor is not in an enabled state. Action: The requestor must be enabled for I/O and external interrupts.
8	xxxx0809	Equate Symbol: IXLRSNCODEPRIMARYNOTHOME Meaning: Program error. The requestor's primary address space is not the same as the home address space. Action: The primary address space must equal the home address space to issue the IXLDISC. The primary address space must be the same address space the IXLCONN was issued from.
8	xxxx080A	Equate Symbol: IXLRSNCODEBADCONTOKEN Meaning: Program error. The requestor specified a CONTOKEN that is not valid, or the request was issued from an address space other than the connector's address space. Action: Verify the CONTOKEN specified was the original one received in the IXLCONN answer area after the connect was issued. The disconnect must be issued from the same address space as the connect.
C	FFFFFFFF	Equate Symbol: IXLRSNCODENOTAVAILABLE Meaning: Environmental error. There are no coupling facility services available. The hardware support necessary to provide coupling facility services might not be present. Action: Re-IPL the system, or follow your particular failure management protocol.
10	—	Meaning: XES processing has failed. Action: Save the reason code information and contact the IBM® support center.