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 IXLCONN 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. xxxx indicates internal information.

Table 1. Return and Reason Codes for the IXLCONN Macro

Hexadecimal
Return Code

Hexadecimal
Reason Code

Equate Symbol
Meaning and Action

0 None. Meaning: Processing completed successfully. The system returns data to ANSAREA. To map ANSAREA, use IXLYCONA.

Action: None. It is the responsibility of the connector to verify that the structure attributes, as recorded in the connect answer area, are acceptable.

4 xxxx0407 Equate Symbol: IXLRSNCODESPECIALCONN

Meaning: The connection was completed. The CONA provides additional status information about the structure and the connector. The field CONAFLAGS indicates any special conditions that affect the connection to the structure. If any of the CONAFLAGS bits are ON, the connector receives this reason code. CONAFLAGS contains flags which indicate one or more of the following: connector has been reconnected, rebuild in progress, rebuild stop in progress, alter in progress, or a user sync point event is set.

Action: If required, interrogate the CONAFLAGS field to determine the status of the structure.

It is the responsibility of the connector to verify that the structure attributes, as recorded in the connect answer area, are acceptable.

8 xxxx0801 Equate Symbol: IXLRSNCODEBADPARMLIST

Meaning: Program error. The IXLCONN 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 IXLCONN 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 IXLCONN in AR-mode, SYSSTATE ASCENV=AR must be issued before the IXLCONN.
8 xxxx0802 Equate Symbol: IXLRSNCODEBADPARMLISTALET

Meaning: Program error. The IXLCONN parameter list ALET is not valid. The request fails.

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: Program error. Invalid version number in the IXLCONN 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™ your program is running on.
8 xxxx0806 Equate Symbol: IXLRSNCODESRBMODE

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

Action: Do not issue the IXLCONN macro when running in SRB mode.

8 xxxx0807 Equate Symbol: IXLRSNCODENOTENABLED

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

Action: Issue the IXLCONN macro while running enabled for I/O and external interrupts.

8 xxxx0808 Equate Symbol: IXLRSNCODEMASTERAS

Meaning: Program error. The connection is not permitted from the Master address space.

Action: Do not issue the IXLCONN macro from the Master address space.

8 xxxx0809 Equate Symbol: IXLRSNCODEPRIMARYNOTHOME

Meaning: Program error. The primary address space does not equal 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 IXLCONN invocation.

8 xxxx080D Equate Symbol: IXLRSNCODEAREATOOSMALL

Meaning: Program error. ANSAREA is too small, as specified by ANSLEN.

Action: Ensure that the ANSLEN parameter properly reflects the size of the area specified by ANSAREA. Also, make sure that the length of ANSAREA is large enough to contain the data returned.

8 xxxx080E Equate Symbol: IXLRSNCODEBADAREA

Meaning: Program error. Unable to access ANSAREA.

Action: Make sure that ANSAREA is properly addressed prior to the IXLCONN invocation.

8 xxxx080F Equate Symbol: IXLRSNCODEBADAREAALET

Meaning: Program error. The ANSAREA ALET is not valid.

Action: Verify that the ANSAREA ALET is valid.

8 xxxx081B Equate Symbol: IXLRSNCODENOLENTRIES

Meaning: Program error. The number of lock entries specified for a lock structure with record data was zero.

Action: Ensure that if a lock structure is to support record data, the value of LOCKENTRIES is greater than zero.

8 xxxx081C Equate Symbol: IXLRSNCODENOLISTHDRS

Meaning: Program error. The number of list headers specified for LISTHEADERS must be greater than zero.

Action: Ensure that the IXLCONN LISTHEADERS parameter is a value greater than zero.

8 xxxx081D Equate Symbol: IXLRSNCODEZEROLUSERS

Meaning: Program error. The number of users specified for TYPE=LOCK NUMUSERS must be greater than zero.

Action: Ensure that the IXLCONN NUMUSERS parameter value is greater than zero.

8 xxxx081F Equate Symbol: IXLRSNCODECONNAME

Meaning: Program error. CONNAME matches the CONNAME of another active connection to the same structure. CONNAME must be unique for each connection to a structure.

Action: Make sure that the CONNAME specified is not already connected to the structure.

8 xxxx0820 Equate Symbol: IXLRSNCODESTRTYPE

Meaning: Program error. The structure type specified does not match the type of the currently-allocated structure or the RNAMELEN attribute specified does not match that of the currently-allocated structure. When you connect to an allocated structure or issue a rebuild connect to a structure, you cannot change some of the structure attributes, specifically TYPE and RNAMELEN. The request fails.

Action: Specify a value for TYPE or for RNAMELEN that matches the attribute specified when the structure was allocated.

8 xxxx0821 Equate Symbol: IXLRSNCODESTRSERIAL

Meaning: Program error. The serialization attribute for a list structure specified by the LOCKENTRIES keyword on connect does not match the currently-allocated structure. When you connect to an allocated structure, you cannot change the structure attributes.

Action: Specify a value for LOCKENTRIES that matches that specified for original structure.

8 xxxx0823 Equate Symbol: IXLRSNCODECONNAMEERR

Meaning: Program error. CONNAME is not valid.

Action: Verify that the CONNAME meets the requirements of the keyword.

8 xxxx084C Equate Symbol: IXLRSNCODENOSAFAUTH

Meaning: Program error. Connector does not have the proper SAF authorization. In IXLYCONA, CONADIAG1 contains the SAF return code and CONADIAG2 contains the SAF reason code.

Action: Determine why the installation has not allowed the proper SAF authorization for access to the structure.

8 xxxx0857 Equate Symbol: IXLRSNCODEBADMAXCONN

Meaning: Program error.

For a lock structure the same keyword (MAXCONN or NUMUSERS) that was used on the initial connect was not used on the rebuild connect request.

For a list structure the use of keyword MAXCONN is inconsistent between the initial IXLCONN request and the IXLCONN REBUILD request. If a connector to a list structure explicitly specifies a MAXCONN value on the initial IXLCONN request, the connector must explicitly specify a MAXCONN value on the IXLCONN REBUILD request. The actual value specified can be different from the value coded on the initial IXLCONN request. If a connector takes the default for MAXCONN on the initial IXLCONN request, the connector must take the default for MAXCONN on the IXLCONN REBUILD request.

Action: Specify the same keyword on the initial connect and the rebuild connect.

8 xxxx085B Equate Symbol: IXLRSNCODERECORDLISTATTR

Meaning: Program error. The record data attribute for the structure being rebuilt is not the same as the record data for the original structure.

Action: Specify a value for RECORD on the IXLCONN REBUILD that matches that specified for the original structure.

8 xxxx085C Equate Symbol: IXLRSNCODEINVALIDLISTATTR

Meaning: Program error. A list structure must be allocated with one of the following: lock entries, data elements, or adjunct data. None were specified.

Action: Specify the request with at least one of the following: lock entries, data elements, or adjunct data.

8 xxxx085D Equate Symbol: IXLRSNCODEINVALIDSTGCLASS

Meaning: Program error. NUMSTGCLASS for a cache structure cannot equal zero.

Action: Specify a value for NUMSTGCLASS that is greater than zero.

8 xxxx085E Equate Symbol: IXLRSNCODEINVALIDCOCLASS

Meaning: Program error. NUMCOCLASS for a cache structure cannot equal zero.

Action: Specify a value for NUMCOCLASS that is greater than zero.

8 xxxx085F Equate Symbol: IXLRSNCODEINVALIDVECTORLEN

Meaning: Program error. VECTORLEN for a cache structure cannot equal zero. The request fails.

Action: Specify a value for VECTORLEN that is nonzero for a cache structure.

8 xxxx0860 Equate Symbol: IXLRSNCODEDIRRATIO

Meaning: Program error. DIRRATIO for a cache structure cannot equal zero. Directory entries are required for a cache structure.

Action: Specify a value for DIRRATIO that is greater than zero.

8 xxxx0861 Equate Symbol: IXLRSNCODEENTRYRATIO

Meaning: Program error. When ELEMENTRATIO is greater than zero, ENTRYRATIO must be greater than zero. List entry controls are required for a list structure.

Action: Specify a value for ENTRYRATIO that is greater than zero.

8 xxxx0862 Equate Symbol: IXLRSNCODEMAXELEMNUM
Meaning: Program error.
  • LIST Structure: If ELEMENTRATIO is not zero, then MAXELEMNUM must be greater than or equal to ELEMENTRATIO divided by ENTRYRATIO when allocating a list structure.
  • CACHE Structure: If ELEMENTRATIO is not zero, the MAXELEMNUM for must be greater than or equal to ELEMENTRATIO divided by DIRRATIO when allocating a cache structure.

Action: Modify the value of MAXELEMNUM to meet the required conditions.

8 xxxx0863 Equate Symbol: IXLRSNCODETASKTERM

Meaning: Program error. The IXLCONN request is rejected because the requesting task is going through task termination. IXLCONN cannot be issued from a resource manager.

Action: Examine your protocol to ensure that the IXLCONN macro is not issued from a resource manager.

8 xxxx086B Equate Symbol: IXLRSNCODEELEMINCRNUM

Meaning: Program error. The value specified for ELEMINCRNUM is not valid. It must be nonzero and be a power of 2.

Action: Modify the value of ELEMINCRNUM to meet the required conditions.

8 xxxx086F Equate Symbol: IXLRSNCODEINVALIDCFLEVEL

Meaning: Program error. The request to alter a structure is rejected because ALLOWALTER=YES was specified and a CFLEVEL of zero was either specified or taken as a default. A CFLEVEL of 1 or higher is required when ALLOWALTER=YES is specified.

Action: Ensure that CFLEVEL=1 is specified.

8 xxxx0870 Equate Symbol: IXLRSNCODEREBUILDVECTORLEN

Meaning: Program error. The VECTORLEN value specified for the rebuild structure is not consistent with the VECTORLEN attribute of the original structure.

Action: If you specified VECTORLEN on the IXLCONN request for the original structure, then you must also specify it on the IXLCONN request for the rebuild structure. Or, if you did not specify VECTORLEN on the IXLCONN request for the original structure, then you must not specify it on the IXLCONN request for the rebuild structure.

8 xxxx0871 Equate Symbol: IXLRSNCODEMAXELEMNUMELEMCHAR

Meaning: Program error. The values specified in MAXELEMNUM and ELEMCHAR would result in the structure having greater than 64K entries.

Action: Modify the value(s) of MAXELEMNUM and/or ELEMCHAR to meet the 64K limit.

8 xxxx0872 Equate Symbol: IXLRSNCODEMINENTRY

Meaning: Program error. The value specified for MINENTRY is not valid.

Action: Modify the value of MINENTRY to be within the range of from 0 to 100.

8 xxxx0873 Equate Symbol: IXLRSNCODEMINELEMENT

Meaning: Program error. The value specified in MINELEMENT is not valid.

Action: Modify the value of MINELEMENT to be within the range of from 0 to 100.

8 xxxx087E Equate Symbol: IXLRSNCODEBADFUNCTION

Meaning: Program error. The value specified in the FUNCTION keyword is not valid (bad character, leading blanks, all blank).

Action: Correct the value of FUNCTION.

8 xxxx0881 Equate Symbol: IXLRSNCODEBADCFLEVEL
Meaning: Program error. The request is rejected because the specified parameter is not appropriate for the value specified for CFLEVEL. The specified reason is indicated in the following table. The reason code index is returned in the CONADIAG2 field of the connect answer area mapped by IXLYCONA.
  Rsn Code           Specified               Minimum
  Index              Parameter               CFLEVEL

     1              EMCSTGPCT>0                3
     2              UDFORDER=YES               5
     3              NAMECLASSMASK              7
     4              ENTRYIDTYPE=USER           8
     5              KEYTYPE=SECONDARY          9

Action: Correct the parameter value in error.

8 xxxx0882 Equate Symbol: IXLRSNCODEBADREFOPTION
Meaning: Program error. The request is rejected because the specified parameter is not appropriate for the value specified for REFOPTION.
For PARAMETER
REFOPTION must be
EMCSTGPCT>0
KEY

Action: Correct the parameter value in error.

8 xxxx0883 Equate Symbol: IXLRSNCODEBADEMCSTGPCT

Meaning: Program error. The value specified for EMCSTGPCT is not valid. The value must be between 0 and 10000.

Action: Correct the value of EMCSTGPCT.

8 xxxx0884 Equate Symbol: IXLRSNCODEBADMINEMC

Meaning: Program error. The value specified for MINEMC is not valid. The value must be between 0 and 100.

Action: Correct the value of MINEMC.

8 xxxx088D Equate Symbol: IXLRSNCODEBADENTRYIDTYPE

Meaning: Program error. The requested ENTRYIDTYPE is not consistent with the ENTRYIDTYPE attribute of the allocated structure. Either ENTRYIDTYPE=USER was requested but the structure was previously allocated with ENTRYIDTYPE=SYSTEM, or ENTRYIDTYPE=SYSTEM was requested and the structure was previously allocated with ENTRYIDTYPE=USER.

Action: Correct the value of ENTRYIDTYPE.

8 xxxx088E Equate Symbol: IXLRSNCODEINCONSISTENTPARM
Meaning: Program error. A keyword specification was made that also requires one or more other keywords to be specified. The specific reason is indicated in the following table. The reason code index is returned in the CONADIAG2 field of the connect answer area mapped by IXLYCONA. Start of change
  Rsn Code          Specified                Also
  Index             Parameter              Required
    1            KEYTYPE=SECONDARY        ADJUNCT=YES
    2            LISTCNTLTYPE=ELEMENT     ELEMENTRATIO>0
    3            KEEPRATIOS               TYPE<>LOCK
    4            KEEPRATIOS               ALLOC<>NO
End of change

Action: Correct the parameter value in error.

8 xxxx089E Equate Symbol: IXLRSNCODEBADMINCFLEVEL

Meaning: Program error. Request rejected. The specified MINCFLEVEL value is greater than the specified CFLEVEL value.

Action: Correct the value for MINCFLEVEL or CFLEVEL as appropriate.

8 xxxx08A9 Equate Symbol: IXLRSNCODEBADSUSPENDOPTION

Meaning: Program error. Request rejected. SUSPEND=FAIL is not valid for lock or serialized list structures.

Action: Correct the value either of the SUSPEND parameter.

C xxxx0C02 Equate Symbol: IXLRSNCODENOMORECONNS

Meaning: Environmental error. The structure has the maximum number of permitted connections.

Action: Retry the request at a later time. The ENF signal 35 will be signalled when coupling facility resources become available.

The maximum number of permitted connections may be limited by the value of PLEXCFG.

C xxxx0C04 Equate Symbol: IXLRSNCODEJOINFAILED

Meaning: Environmental error. IXCJOIN has failed. (XES invokes IXCJOIN on behalf of a user of a serialized structure (TYPE=LOCK or TYPE=LIST with LOCKENTRIES). Additional diagnosis information exists in the connect answer area, IXLYCONA. The field CONADIAG1 contains the IXCJOIN return code and CONADIAG2 contains the IXCJOIN reason code.

Action: Use the IXCJOIN return and reason codes to understand why IXCJOIN failed and attempt to resolve the problem.

C xxxx0C05 Equate Symbol: IXLRSNCODENOTINPOLICY

Meaning: Environmental error. The active CFRM policy for the installation does not specify the structure. The request fails.

Action: Specify a structure that is currently defined in the CFRM active policy or switch to a new CFRM policy that contains the structure for which this IXLCONN was invoked.

C xxxx0C06 Equate Symbol: IXLRSNCODENOCONN

Meaning: Environmental error. The system does not have connectivity to the coupling facility that contains the specified structure. This might occur due to operator commands such as VARY PATH,OFFLINE or CONFIG CHP,OFFLINE, or hardware errors such as coupling facility or path failures.

Action: Determine why connectivity was not established and attempt the request again. In IXLYCONA, the field CONACONNECTORCONNECTIVITY is set if at least one active connector has connectivity to the structure.

C xxxx0C08 Equate Symbol: IXLRSNCODENOFAC

Meaning: Environmental error. Allocation of the structure failed because there was no suitable coupling facility to allocate the structure based on the preference list in the active CFRM policy.

Action: In IXLYCONA, the field CONAFACILITYARRAY contains information about each coupling facility in which XES attempted to allocate the structure. Examine each reason code associated with each coupling facility to understand the reason why the allocation failed for that coupling facility.

For additional information about the connect failure, search the hardcopy log for messages IXL013I and IXL015I. For an XCF signalling list structure, search for message IXC463I. Examine the system LOGREC symptom record for details. The symptom record has the information from the IXLCONN parameter list and the connect answer area (IXLYCONA).

C xxxx0C09 Equate Symbol: IXLRSNCODECONNPREVENTED
Meaning: Environmental error. New connections to the requested structure are being prevented at this time for one of the following reasons:
  • All active connectors have confirmed either the Rebuild Quiesce event or the Duplex Complete event. New connections will not be permitted until the rebuild stop or rebuild cleanup is completed.
  • The structure is allocated in a coupling facility that is failed. New connections will not be permitted until the structure is rebuilt, or all connections disconnect causing the structure to be deallocated.
  • The coupling facility containing the structure is not available for use because policy reconciliation is in progress. New connections will not be permitted until policy reconciliation is complete.
  • New structure allocations for this structure name are not permitted because there is a pending policy change for this structure. New connections will not be permitted until the structure cleanup is complete.
  • Structure cleanup is in progress. New connections will not be permitted until the structure cleanup is complete.
  • A system-managed process (for example, system-managed rebuild) is in progress. When the structure is in the Duplex Established phase of a system-managed duplexing rebuild, CONASTRUCTURESMDUPESTAB flag will be set. If the user specified or defaulted to ALLOWAUTO=NO on the connect, the connect will be prevented as long as the structure remains duplexed.
  • Start of change The connect request originated on a system that is not capable of exploiting some functional support with which the target structure was previously allocated. End of change

For each of the reasons listedStart of change , except for the last reason (unable to exploit functional support) End of change, an ENF Event Code 35 will signal when the condition preventing new connections completes.

Action: Determine why connection to the structure was prevented and retry the request at a later time.

Start of change C End of change Start of change xxxx0C0A End of change Start of changeEquate Symbol: IXLRSNCODESTRNOTALLOCATED

Meaning: Environmental error. ALLOC=NO was specified and the structure is not allocated.

Action: Determine why the structure is not allocated. Reissue the IXLCONN request without ALLOC=NO if you wish to allocate the structure.

End of change
C xxxx0C0C Equate Symbol: IXLRSNCODENOCONNDUPLEXNEWSTR

Meaning: Environmental error. This system does not have connectivity to the coupling facility that contains the specified duplexed new structure. This might occur due to operator command such as VARY PATH,OFFLINE or CONFIG CHP,OFFLINE, or hardware errors such as coupling facility or channel path failures. MVS stops the structure duplexing rebuild for the structure.

Action: Determine why connectivity was not established and attempt the request again. In IXLYCONA, the field CONACONNECTORCONNECTIVITY is set if at least one active connector has connectivity to the structure.

C xxxx0C11 Equate Symbol: IXLRSNCODEDEFINE

Meaning: Environmental error. The local vector requested on connect could not be defined on a TYPE=CACHE or TYPE=LIST request.

Action: Retry the request at a later time.

C xxxx0C12 Equate Symbol: IXLRSNCODEDSNOTCREATED

Meaning: Environmental error. The system could not create a data space.

Action: Retry the request at a later time.

C xxxx0C15 Equate Symbol: IXLRSNCODEMAXCONNECTAS

Meaning: Environmental error. The requestor has exceeded the maximum number of serialized connections (limit of 64) for the address space.

Action: Retry the request at a later time. Examine your protocol to determine why the maximum has been exceeded.

C xxxx0C16 Equate Symbol: IXLRSNCODEPASNEXCEEDED

Meaning: Environmental error. An error occurred adding to the PASN access list.

Action: Retry the request at a later time.

C xxxx0C19 Equate Symbol: IXLRSNCODETIMERNOTSET

Meaning: Environmental error. XES DIE could not be established for this system. Specifically, the XES DIE could not be established for this system.

Action: Retry the request at a later time.

C xxxx0C23 Equate Symbol: IXLRSNCODECONNOTINPOL

Meaning: Environmental error. The request failed because there is a failed-persistent connection with the same connection name that has not been reconciled into the CFRM policy.

Action: Examine your active CFRM policy. The CFRM couple data set requires additional CONNECT records. This might require that the CFRM couple data set be reformatted.

C xxxx0C24 Equate Symbol:IXLRSNCODEINCOMPATNUMUSER
Meaning: Environmental error. The composite value of all the NUMUSERS or MAXCONN values specified by connectors to the current structure prevents any additional connections to the structure. This can occur for the following reasons:
  • On initial connect, the available connection identifier is greater than the smallest NUMUSERS or MAXCONN value specified by an existing connection.
  • On initial connect, the available connection identifier is greater than the NUMUSERS or MAXCONN value specified on the current IXLCONN request.
  • On Initial connect, the largest connection identifier in use by an existing connection is greater than the NUMUSERS or MAXCONN value specified on the current IXLCONN request.
  • On a rebuild connect request the largest connection identifier in use by an existing connection to the original structure is greater than the NUMUSERS or MAXCONN value specified on the current IXLCONN REBUILD request.

Action: The installation has implemented an unsafe migration path to greater than 32 connectors to a structure. Retry the request at a later time. Examine your protocol to determine why your specification for the maximum userid limit conflicts with the existing connections.

C xxxx0C25 Equate Symbol: Start of change IXLRSNCODESTRFAILURE End of change

Meaning: Environmental error. Request failed because structure failure has occurred. The request fails.

Action: Retry the request at a later time. The system will issue ENF signal 35 when coupling facility resources become available.

C xxxx0C27 Equate Symbol: IXLRSNCODERSPNOTREC

Meaning: Environmental error. A connector to a structure has either failed or disconnected. All surviving connectors to the structure have not yet responded to the EEPLDISCFAILCONN event. XES cannot perform cleanup processing for a terminating connector until all surviving connectors have responded.

The EEPLDISCFAILCONN event allows users to respond with either a return code in IXLYEEPL or with an IXLYEEPL return code and a later IXLEERSP response. Users are not required to use only IXLEERSP when responding.

Action: Surviving connectors can specify how XES is to perform cleanup processing by responding to the EEPLDISCFAILCONN event in one of three ways:
  • Set return code X'0' in IXLYEEPL (normal processing)
  • Set return code X'1' in IXLYEEPL (used for failed-persistent connections)
  • Set return code X'8' in IXLYEEPL to delay your response and then respond with IXLEERSP.

Examine your protocol to determine why responses have not been issued. The CONADISCFAILEDCONFSTRING field of the IXLYCONA contains a string indicating the connections that must provide a response for the disconnect/failure of the previous instance of the connection. Retry the request at a later time. The ENF signal 35 will be signalled when all responses for the disconnect/failure have been received.

C xxxx0C29 Equate Symbol: IXLRSNCODEXESNOTACTIVE

Meaning: Environmental error. The CFRM function is not active or not available.

Action: Bring the CFRM couple data set in use in the sysplex by issuing the SETXCF COUPLE,TYPE=CFRM,PCOUPLE= command.

C xxxx0C30 Equate Symbol: IXLRSNCODEDUMPINPROGRESS

Meaning: Environmental error. The connection could not be completed because SVC Dump holds serialization on the structure.

Action: Retry the request at a later time. The ENF signal 35 will be signalled when coupling facility resources become available.

C xxxx0C3C Equate Symbol: IXLRSNCODEREBUILDCONNECT

Meaning: Environmental error. The rebuild connection failed because the original connector failed (task was terminated) while processing this IXLCONN REBUILD request. This reason code is only applicable when the IXLCONN REBUILD request is issued from a different task than the task that owns the original connection.

Action: None. The original connect that failed cannot reconnect.

C xxxx0C3D Equate Symbol: IXLRSNCODENOTREBUILDING

Meaning: Environmental error. The connection failed because the requestor issued IXLCONN REBUILD for a structure that is not rebuilding.

Action: Verify that the structure name has been specified correctly.

C xxxx0C44 Equate Symbol: IXLRSNCODEREBUILDCONNEXISTS

Meaning: Environmental error. The connection failed because REBUILD connect already exists for this CONNAME.

Action: Verify that the connection name has been specified correctly.

C xxxx0C45 Equate Symbol: IXLRSNCODEREBUILDBADCONN

Meaning: Environmental error. Either the issuer of IXLCONN with the REBUILD option is not a connector in the address space or system from which this request was issued or the connector is not active.

Action: To issue an IXLCONN REBUILD request, the user must be connected to the original structure and the request must be issued from the same address space and system as the original request.

C xxxx0C47 Equate Symbol: IXLRSNCODEREBUILDCONNPHASE
Meaning: Environmental error. The connection failed because the requestor issued IXLCONN REBUILD during the wrong phase of the rebuild process. The cause is one of the following:
  • The IXLCONN REBUILD was issued before all connections have provided a response to the Rebuild Quiesce event.
  • The IXLCONN REBUILD was issued after all connections have issued IXLREBLD REQUEST=COMPLETE.

Action: Examine your protocol to determine why the request was issued during the wrong phase of the rebuild process.

C xxxx0C4E Equate Symbol: IXLRSNCODEREBUILDCONNECTSTOP

Meaning: Environmental error. The IXLCONN REBUILD request was not successful because a rebuild stop occurred.

Action: Determine why the rebuild stop occurred.

C xxxx0C50 Equate Symbol: IXLRSNCODEREBUILDCONNECTNOPREF

Meaning: Environmental error. The IXLCONN REBUILD request was not successful because there is no policy information for this structure in the active CFRM policy. This structure was reconciled into the policy from the coupling facility when the sysplex was IPLed with a downlevel CFRM couple data set.

Action: Switch to a new CFRM active policy that includes the definition for this structure.

C xxxx0C52 Equate Symbol: IXLRSNCODEALLOWREBLD

Meaning: Environmental error. The connect request was rejected because a connector specified either ALLOWREBLD=NO and structure rebuild is in progress or ALLOWDUPREBLD=NO and structure duplexing is in progress.

Action: Examine your protocol to determine why a user specified that rebuild or duplexing was not to be allowed.

C xxxx0C53 Equate Symbol: IXLRSNCODECFLEVEL

Meaning: Environmental error. The connect request was not successful because the requestor specified a CFLEVEL value that is greater than the maximum CFLEVEL supported by the MVS release on which the IXLCONN was requested.

Action: The maximum CFLEVEL supported by the MVS release is returned in the CONAMVSRELEASEMAXCFLEVEL field of the IXLYCONA. Interrogate this field to determine the supported level.

C xxxx0C64 Equate Symbol: IXLRSNCODESTRALTERNOTALLOW

Meaning: Environmental error. The connect request was rejected because alter is in progress and the connection specified ALLOWALTER=NO on IXLCONN.

Action: Wait until the structure alter is complete and then retry the connect request. The system issues an ENF event code 35 specifying the name of the structure when the structure alter completes.

C xxxx0C65 Equate Symbol: IXLRSNCODESTRALTERRESTRICT

Meaning: The connect request was rejected because alter is in progress and the RATIO, MINENTRY, and/or MINELEMENT specification is more restrictive than the current composite for existing connections.

Action: Wait until the structure alter is complete and then retry the connect request. The system issues an ENF event code 35 specifying the name of the structure when the structure alter completes.

C xxxx0C9A Equate Symbol: IX.RSNCODEINSUFFCFLEVELUSER

Meaning: The connect request was rejected because the user specified a MINCFLEVEL value that is greater than the level of the coupling facility in which the target structure is allocated. The level of the coupling facility in which the target structure is allocated is returned in the CONACFACILITYCFLEVEL field of IXLYCONA.

Action: Determine the level of the coupling facility in which the target structure is allocated. If the IXLCONN request failed because the structure is currently allocated in a coupling facility that is below the program's minimum requirements for CFLEVEL as specified by MINCFLEVEL, have the structure moved to a coupling facility that is at or above that MINCFLEVEL. Attempt the IXLCONN request with the same MINCFLEVEL.

Start of change C End of change Start of change xxxx0CA3 End of change Start of changeEquate Symbol: IXLRSNCODESTRALTERSCM

Meaning: Environmental error. Request rejected because the connector specified ALLOWALTER=NO but the target structure is allocated to support storage-class memory.

Action: If storage-class memory is intended for use with the structure, the application must receive an upgrade so that all connectors support alter.

End of change
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 Equate Symbol: IXLRETCODECOMPERROR

Meaning: Failure in XES processing. Additional diagnostic information might exist in the following fields in IXLYCONA: CONADIAG0, CONADIAG1, CONADIAG2, CONADIAG6, CONADIAG7, CONADIAG8, and CONADIAG9.

When the reason code is 02011007 with diagnostic information:
  • CONADIAG0: 00000002
  • CONADIAG1: 0000000C
  • CONADIAG2: 00021007
The system might not have connectivity to the coupling facility that contains the specified structure. This might occur due to operator commands such as VARY PATH,OFFLINE or CONFIG CHP,OFFLINE, or hardware errors such as coupling facility or path failures. Determine why connectivity was not established and attempt the request again.

Action: Provide the IXLYCONA information listed above to the IBM® support center.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014