Return and Reason Codes

When the IXLREBLD 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 IXLREBLD Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Equate Symbol Meaning and Action
0	None.	Meaning: IXLREBLD request was successful. Action: None.
4	xxxx0415	Equate Symbol: IXLRSNCODEALREADYREBUILDING Meaning: Structure rebuild or duplexing rebuild for the structure has already been initiated. The REBUILD REQUEST=START REQUEST=STARTDUPLEX request is not processed. Action: Examine your protocol for initiating the rebuild process.
4	xxxx0416	Equate Symbol: IXLRSNCODEALREADYSTOPPING Meaning: Structure rebuild or duplexing rebuild stop has already been initiated. The REBUILD REQUEST=STOP or REQUEST=STOPDUPLEX request is not processed. Action: Examine your protocol for stopping the rebuild process.
4	xxxx041D	Equate Symbol: IXLRSNCODEIGNOREFORREBUILDSTOP Meaning: The system ignores IXLREBLD REQUEST=COMPLETE or REQUEST=DUPLEXCOMPLETE because a rebuild stop or stopduplex request for the structure is in progress. The request fails. Action: Examine your rebuild protocol.
4	xxxx0425	Equate Symbol: IXLRSNCODENOSTRFOUND Meaning: The system did not find any structures eligible for rebuild in the specified coupling facility. The request fails. Action: Verify that the names of the structure and the coupling facility have been specified correctly.
8	xxxx0801	Equate Symbol: IXLRSNCODEBADPARMLIST Meaning: The IXLREBLD 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 IXLREBLD 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 IXLREBLD in AR-mode, SYSSTATE ASCENV=AR must be issued before the IXLREBLD.
8	xxxx0802	Equate Symbol: IXLRSNCODEBADPARMLISTALET Meaning: The IXLREBLD parameter list ALET is not accessible. 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 IXLREBLD 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 IXLREBLD macro when running in SRB mode.
8	xxxx0807	Equate Symbol: IXLRSNCODENOTENABLED Meaning: The requestor is not in an enabled state. Action: Issue the IXLREBLD macro while running enabled for I/O and external interrupts.
8	xxxx0809	Equate Symbol: IXLRSNCODEPRIMARYNOTHOME Meaning: The requestor's primary address space is not the same as the home address space. Action: Make sure that the primary address space and the home address space are the same at the time of the IXLREBLD 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, input contoken is not the 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	xxxx084C	Equate Symbol: IXLRSNCODENOSAFAUTH Meaning: The requestor does not have the required SAF authorization. Action: Determine why the installation has not allowed the proper SAF authorization for access to the structure.
8	xxxx0863	Equate Symbol: IXLRSNCODETASKTERM Meaning: The request is rejected because the requesting task is going through termination. IXLREBLD cannot be issued from a resource manager. Action: Examine your protocol to ensure that IXLREBLD is not issued from a resource manager.
8	xxxx0886	Equate Symbol: IXLRSNCODEBADREQUEST Meaning: The IXLREBLD REQUEST type is not supported. Action: Ensure that the request type has been specified correctly and that you are running on an appropriate level of z/OS.
C	xxxx0C05	Equate Symbol: IXLRSNCODESTRNOTINPOLICY Meaning: Environmental error. The structure specified is not defined in the active CFRM policy. Action: Ensure that the structure name has been specified correctly.
C	xxxx0C07	Equate Symbol: IXLRSNCODECFNOTINPOLICY Meaning: Environmental error. The coupling facility specified is not defined in the active CFRM policy. Action: Ensure that the coupling facility name has been specified correctly.
C	xxxx0C0A	Equate Symbol: IXLRSNCODESTRNOTALLOCATED Meaning: Environmental error. The structure specified is not allocated. Action: Ensure that the structure name has been specified correctly.
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: Environmental error. The rebuild request has been rejected because the structure has failed. A rebuild request that would result in a system-managed rebuild will be rejected if the structure has failed. Action: Examine the protocol in use by the application for recovery from structure failure.
C	xxxx0C29	Equate Symbol: IXLRSNCODEXESNOTACTIVE Meaning: Environmental error. CFRM services are not active or are not available. Action: Bring the CFRM couple data set in use in the sysplex.
C	xxxx0C35	Equate Symbol: IXLRSNCODENOACTIVECONNS Meaning: Environmental error. There are no active connections to the structure. The request to rebuild the structure is rejected. Action: Ensure that there is at least one active connection to the structure that is to be rebuilt.
C	xxxx0C36	Equate Symbol: IXLRSNCODESTOPINPROGRESS Meaning: Environmental error. The rebuild start or startduplex request for the structure fails because processing to stop rebuilding the same structure name is in progress. Action: Examine your rebuild protocol.
C	xxxx0C3D	Equate Symbol: IXLRSNCODENOTREBUILDING Meaning: Environmental error. The request to rebuild the structure is rejected because the structure is not in the rebuild process. Action: Ensure that the structure name was specified correctly.
C	xxxx0C3E	Equate Symbol: IXLRSNCODEINCLEANUP Meaning: Environmental error. The rebuild stop or stopduplexing request cannot be processed once the rebuild has entered the Cleanup phase. The rebuild process cannot be stopped. Action: Do not attempt to stop the rebuild or duplex rebuild process once the rebuild has entered the Cleanup phase.
C	xxxx0C3F	Equate Symbol: IXLRSNCODECONNNOTDEFINED Meaning: Environmental error. The connection making the rebuild complete or duplex complete request is not defined. Action: Ensure that the IXLREBLD REQUEST=COMPLETE or REQUEST=DUPLEXCOMPLETE is invoked by an active connector to the structure.
C	xxxx0C40	Equate Symbol: IXLRSNCODECONNNOTACTIVE Meaning: Environmental error. The connection indicating rebuild complete or duplex complete is not active. Action: Ensure that the IXLREBLD REQUEST=COMPLETE or REQUEST=DUPLEXCOMPLETE is invoked by an active connector to the structure.
C	xxxx0C41	Equate Symbol: IXLRSNCODEUNEXPECTEDRESPONSE Meaning; Environmental error. The system did not expect a rebuild complete or duplex complete request from the connection. Action: Examine the rebuild protocol in use by the application to ensure that the sequence of rebuild events/actions is correct.
C	xxxx0C46	Equate Symbol: IXLRSNCODEREBUILDCOMPLETE Meaning: Environmental error. The system did not expect a rebuild complete request at this stage of the rebuild process. Action: Examine the rebuild protocol in use by the application to ensure that the sequence of rebuild events/actions is correct.
C	xxxx0C4A	Equate Symbol: IXLRSNCODEREBUILDNOTPERMITTED Meaning: Environmental error. At least one active connection specified the ALLOWREBLD=NO option on IXLCONN for the structure. This prevents structure rebuild or duplexing rebuild from being initiated for the structure. Action: Examine the rebuild protocol to determine why structure rebuild or duplexing rebuild is not allowed for this structure.
C	xxxx0C67	Equate Symbol: IXLRSNCODEREBLDNOOTHER Meaning: Environmental error. LOCATION=OTHER either was specified on the rebuild request or was defaulted to for STARTREASON=LOSSCONN or REQUEST=STARTDUPLEX rebuild requests. When duplexing is stopped by the operator and DUPLEX(ENABLED) is specified in the active policy for the structure, the subsequent duplexing rebuild request initiated due to DUPLEX(ENABLED) will both avoid the coupling facility in which the current structure is allocated and the coupling facility in which the previous instance of the structure was allocated when the duplexing rebuild was stopped. No other coupling facility exists in the active (or pending) policy preference list for the structure. Action: Ensure that the CFRM policy is set up with more than one coupling facility in the preference list for the structure.
C	xxxx0C6A	Equate Symbol: IXLRSNCODEREBLDNOOTHERCONN Meaning: Environmental error. No coupling facility in the preference list provided better connectivity than the current facility for this LOSSCONN rebuild. The rebuild was not started to avoid a further degradation in connectivity for the application. When STARTREASON=LOSSCONN is specified, the system ignores the LESSCONNACTION specification and processes the request as if LESSCONNACTION=TERMINATE were specified. Action: Either disconnect from the structure or reattempt to rebuild the structure by reissuing the IXLREBLD macro with a different STARTREASON.
C	xxxx0C6B	Equate Symbol: IXLRSNCODEREBLDINSUFFCONN Meaning: Environmental error. No coupling facility in the preference list provided better or equivalent connectivity than the current facility. The rebuild was not started to avoid a further degradation in connectivity for the application. Action: If you want the rebuild to occur despite a degradation in connectivity, use the LESSCONNACTION=CONTINUE option.
C	xxxx0C6F	Equate Symbol: IXLRSNCODEDUPLEXNOTPERMITTED Meaning: Environmental error. The structure does not support duplexing rebuild for one of the following reasons: The ALLOWDUPREBLD=NO option on IXLCONN was specified or defaulted to by at least one active or failed-persistent connection. DUPLEX(DISABLED) was specified or defaulted to in the CFRM active policy for this structure. A user-managed duplexing rebuild was required, and user-managed duplexing rebuilds are not supported for the type of structure. There are connections pending reconciliation into the CFRM policy. A system-managed duplexing rebuild is not supported when a CFRM policy change is pending for the structure. Action: Rebuild the structure first to cause the pending policy change to take effect.
C	xxxx0C70	Equate Symbol: IXLRSNCODEWRONGBUILDTYPE Meaning: Environmental error. Either of the following conditions exists: IXLREBLD REQUEST=STOP was requested and a duplexing rebuild is in progress IXLREBLD REQUEST=STOPDUPLEX was requested and a structure rebuild is in progress. Action: Examine the rebuild protocol in use by the application to ensure that the sequesnce of rebuild or duplexing events and actions is correct.
C	xxxx0C71	Equate Symbol: IXLRSNCODENOTDUPLEXESTAB Meaning: Environmental error. An IXLREBLD REQUEST=STOP to switch to the new structure was requested and the rebuild process is not yet in the Duplex Established phase. A stop to switch to the new structure cannot be accepted until the rebuild reaches the Duplex Established phase. Action: Examine the duplexing protocol in use by the application to ensure that the sequence of duplexing events and actions is correct.
C	xxxx0C72	Equate Symbol: IXLRSNCODEDUPLEXCOMPLETE Meaning: Environmental error. An IXLREBLD REQUEST=DUPLEXCOMPLETE request was not expected at this time. Either switch is not in progress or the connector has not established duplexing yet. if the latter, the connector must either establish duplexing or disconnect, allowing switch processing to proceed. Action: Enamine the duplexing protocol in use by the application to ensure that the sequence of duplexing events and actions is correct.
C	xxxx0C73	Equate Symbol: IXLRSNCODESTRFAILED Meaning: Environmental error. The rebuild request has been rejected because the structure has failed. A duplexing rebuild request will be rejected if the structure has failed. A structure rebuild request will be permitted. Action: Start a structure rebuild for the structure.
C	xxxx0C74	Equate Symbol: IXLRSNCODESTOPPINGDIRECTION Meaning: Environmental error. The duplexing rebuild is stopping in a direction that will not keep the structure specified on the IXLREBLD STOPDUPLEX request. The request could not be processed as requested for one of the following reasons: A request to stop structure duplexing has already been initiated in the other direction. This request is rejected. A recovery manager is active and this request with REASON=LOSSCONN specified would not have kept the structure in the coupling facility at the recovery site. Duplexing is instead stopped in the other direction to keep the structure in the coupling facility at the recovery site. Action: Examine the duplexing protocol in use by the application to ensure that the sequence of duplexing events and actions is correct.
C	xxxx0C75	Equate Symbol: IXLRSNCODEDUPLEXNOTFEASIBLE Meaning: The IXLREBLD START DUPLEX request was not processed because XES determined that allocation of the rebuild new structure would not be feasible. A duplexing rebuild might not be feasible because: There is no coupling facility in the preference list that has CF-to-CF connectivity to the coupling facility in which the primary structure is allocated. A loss of coupling facility connectivity would occur for active connectors to the structure. Action: Depending on the reason that the allocation of the rebuild new structure was not considered feasible, put actions in place to correct the situation.
C	xxxx0C80	Equate Symbol: IXLRSNCODEREBUILDPOPCFINPROGRESS Meaning: Environmental error. An IXLREBLD REQUEST=START,POPULATECF=cfname was attempted when either a previous POPULATECF request or REALLOCATE process was already in progress. The request is not processed. Action: Examine the protocol in use by the application to ensure that the sequence of events and actions when populating a coupling facility is correct. The POPULATECF function and REALLOCATE process are mutually exclusive. The REALLOCATE process can only be started or stopped by using the SETXCF operator command.
C	xxxx0C81	Equate Symbol: IXLRSNCODEREBUILDPOPCFNOTINPROGRESS Meaning: Environmental error. An IXLREBLD STOP,POPULATECF=cfname was attempted. However, there is no currently active POPULATECF request in progress for the specified coupling facility. The request is not processed. Action: Examine the protocol in use by the application to ensure that the sequence of events and actions when populating a coupling facility is correct.
C	xxxx0C83	Equate Symbol: IXLRSNCODEREBUILDPOPCFNOSTRUCTS Meaning: Environmental error. An IXLREBLD REQUEST=START,POPULATECF=cfname was attempted. No structures were selected for the request. The request is not processed. Action: Examine the protocol in use by the application to ensure that the sequence of events and actions when populating a coupling facility is correct.
C	xxxx0C84	Equate Symbol: IXLRSNCODEREBUILDPOPCFFAILED Meaning: Environmental error. An IXLREBLD REQUEST=START,POPULATECF=cfname was attempted. The specified coupling facility has failed. The request is not processed. Action: Resubmit the request specifying a coupling facility that is available in the CFRM active policy or change the policy to reinstate the coupling facility.
C	xxxx0C85	Equate Symbol: IXLRSNCODEREBUILDPOPCFINCLEANUP Meaning: Environmental error. An IXLREBLD REQUEST=START,POPULATECF=cfname was attempted. The specified coupling facility is in cleanup processing. The request is not processed. Action: Resubmit the request after the coupling facility has completed cleanup.
C	xxxx0C86	Equate Symbol: IXLRSNCODEREBUILDPOPCFDELETEPENDING Meaning: Environmental error. An IXLREBLD REQUEST=START,POPULATECF=cfname was attempted. The specified coupling facility is being deleted from the CFRM active policy. The request is not processed. Action: Resubmit the request specifying a coupling facility that is available in the CFRM active policy or change the policy to reinstate the coupling facility.
C	xxxx0C88	Equate Symbol: IXLRSNCODEREBUILDPOPCFALLOCNOTPERMITTED Meaning: A request to start a POPULATECF rebuild was attempted. Structure allocation is not permitted in the specified coupling facility. The request is not processed. Action: The specified coupling facility is not eligible for structure allocation. Resubmit the request specifying a coupling facility that is available for structure allocation; otherwise, if the specified coupling facility is the intended target, issue the DISPLAY XCF,CF command to determine the possible reasons why the coupling facility is not eligible for structure allocation, and take any necessary actions to allow structure allocation.
C	xxxx0C92	Equate Symbol: IXLRSNCODESYSMGDNOTSUPPORTEDSTR Meaning: An IXLREBLD REQUEST=START was attempted that needed system-managed processing (for example, rebuild). The system-managed process cannot be initiated for one of the following reasons: The structure was not allocated in a coupling facility at or above the minimum CFLEVEL required for the current process. The structure was not allocated by a system supporting system-managed processing. The structure has connections that have not been reconciled into the CFRM active policy. Structure cleanup is in progress for the structure (applicable to lock structures only). The request is not processed. Action: Determine the CFLEVEL of the coupling facility in which the structure is allocated through one of the following methods: using the IXLMG macro, issuing the DISPLAY XCF,STR and DISPLAY CF commands, or referencing the data returned in the CONA on the original connect to the structure. If the CFLEVEL is too low, follow application protocols to shut down and allocate the structure in a coupling facility of suitable CFLEVEL. If the CFLEVEL is sufficient, try the IXLREBLD request at a later time to allow CFRM policy reconciliation or lock structure cleanup to complete.
C	xxxx0C93	Equate Symbol: IXLRSNCODESYSMGDSTRPREFLIST Meaning: An IXLREBLD REQUEST=START was attempted that needed system-managed processing (for example, rebuild). The system-managed process cannot be initiated because the preference list for the structure was unsuitable for one of the following reasons: The preference list is empty. The preference list contains no other coupling facility at the required CFLEVEL or higher. The structure already exists in the only suitable coupling facility and this coupling facility could not be selected as the target for the system-managed process because no CFRM policy change is pending for this structure. The request is not processed. Action: The system programmer must update the structure's preference list to include at least two coupling facilities at the required CFLEVEL.
C	xxxx0C94	Equate Symbol: IXLRSNCODESYSMGDNOTSUPPORTEDCONN Meaning: An IXLREBLD REQUEST=START request was attempted and would have resulted in system-managed processing (for example, rebuild). The system-managed process could not be initiated because there is at least one active connection and all connections did not specify ALLOWAUTO=YES on IXLCONN. The request is not processed. Action: The application must support either user-managed or system-managed rebuild for the rebuild start request to succeed. If the application intends to support system-managed processing, all active connectors that specified or defaulted to IXLCONN ALLOWAUTO=NO must disconnect and, if desired, reconnect with ALLOWAUTO=YES, before the request can be processed successfully.
C	xxxx0C95	Equate Symbol: IXLRSNCODESYSMGDBADSTARTREASON Meaning: An IXLREBLD REQUEST=START invocation would have resulted in a system-managed rebuild. The rebuild could not be initiated because the request specified a STARTREASON of LOSSCONN or STRFAILURE, which are not valid reasons for starting a system-managed rebuild. The request is not processed. Action: Specify a STARTREASON other than LOSSCONN or STRFAILURE.
C	xxxx0C96	Equate Symbol: IXLRSNCODESYSMGDLOSSCONN Meaning: An IXLREBLD REQUEST=START invocation would have resulted in a system-managed rebuild. The rebuild could not be initiated because an active or failing connector does not have connectivity to the target structure. The request is not processed. Action: Try the start request again when all connectors who have lost connectivity to the structure have disconnected and become either failed-persistent or undefined.
C	xxxx0C97	Equate Symbol: IXLRSNCODESYSMGDCOMPLETENOTPERMITTED Meaning: An IXLREBLD REQUEST=COMPLETE or REQUEST=DUPLEXCOMPLETE was issued for a structure that is undergoing system-managed processing (for example, rebuild). The request is not processed. Action: Do not issue IXLREBLD REQUEST=COMPLETE or REQUEST=DUPLEXCOMPLETE against a structure that is undergoing system-managed processing.
C	xxxx0C99	Equate Symbol: IXLRSNCODESYSMGDNOTSUPPORTEDCDS Meaning: An IXLREBLD REQUEST=START request was attempted which needed system-managed processing (for example, rebuild). The system-managed process could not be initiated because the CFRM couple data set was not formatted at the minimum required level. The request is not processed. Action: Format and activate a CFRM couple data set that supports the requested system-managed process. For rebuild, specify ITEM NAME(SMREBLD) NUMBER(1) when formatting.
C	xxxx0C9B	Equate Symbol: IXLRSNCODESYSMGDNOHISTORY Meaning: A request to initiate a duplexing rebuild was attempted which needed system-managed processing. The system-managed duplexing rebuild cannot be initiated because there are no connections to the structure and the structure has not previously been duplexed using system-managed processing. The request is not processed. Action: Start a connector that supports system-managed duplexing rebuild, and try again.
C	xxxx0CA2	Equate Symbol: IXLRSNCODESTORAGECLASSMEMORYINUSE Meaning: The request to start a duplexing rebuild was rejected because the structure contains objects in storage-class memory. Action: Retry the rebuild request when the structure no longer contains objects in storage-class memory.
C	FFFFFFFF	Equate Symbol: IXLRSNCODENOTAVAILABLE Meaning: 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	Equate Symbol: IXLRSNCODESYSMGDXCFERROR 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.