Explanation
An attempt to connect to a coupling facility structure
via the IXLCONN macro failed. In the message text:
- requesttype
- One of the following request types:
- IXLCONN
- IXLCONN macro service
- IXLCONN REBUILD
- IXLCONN macro service for a REBUILD connect
- structure-name
- Name of the structure for which information is being recorded.
- jobname
- Jobname of the application issuing the IXLCONN.
- asid
- ASID of the application issuing the IXLCONN.
- connector-name
- Connection name specified by the application issuing the IXLCONN,
if applicable.
- return-code
- IXLCONN return code
- reason-code
- IXLCONN reason code
- errortype
- One of the following:
- CONNECTOR WITH SAME NAME ALREADY CONNECTED TO STRUCTURE
- The ConName specified is not unique. There is an active connection
to this structure with the specified name.
- NOT AUTHORIZED TO CONNECT TO STRUCTURE
- The user does not have proper SAF authorization.
- IXLCONN PARAMETER ERROR
- The IXLCONN request had a parameter error.
- REBUILD PROTOCOL ERROR
- An IXLCONN REBUILD was requested but the structure is either not
in rebuild or in the wrong phase of rebuild.
- STRUCTURE HAS THE MAXIMUM NUMBER OF PERMITTED CONNECTORS
- The structure has the maximum number of permitted connections.
- IXCJOIN FAILED
- IXCJOIN return and reason codes are in ConaDiag1 and ConaDiag2.
- ALL SYSPLEX COUPLE DATA SET GROUP RECORDS IN USE
- The maximum number of groups already exist.
- ALL SYSPLEX COUPLE DATA SET MEMBER RECORDS FOR GROUP IN USE
- The maximum number of members in the group already exist.
- STRUCTURE NOT DEFINED IN THE CFRM ACTIVE POLICY
- The CFRM active policy for the installation does not specify the
structure.
- NO CONNECTIVITY TO THE STRUCTURE
- The system does not have connectivity to the coupling facility
containing the specified structure.
- NO CONNECTIVITY TO THE DUPLEXING REBUILD OLD STRUCTURE
- There is no connectivity to the coupling facility that contains
the specified duplex old structure.
- NO SUITABLE COUPLING FACILITY IN PREFERENCE LIST
- Structure allocation failed because no suitable
coupling facility was found in the structure's preference list. See
message IXL015I to determine the reason why the coupling facilities
listed in the preference list were not suitable.
- NO CONNECTIVITY TO THE DUPLEXING REBUILD NEW STRUCTURE
- There is no connectivity to the coupling facility containing the
specified duplex new structure.
- FAILURE DEFINING LOCAL VECTOR
- The local vector requested on the connect could not be defined.
- FAILURE CREATING DATA SPACE
- Storage management could not create a data space.
- THE MAXIMUM NUMBER OF CONNECTORS IN THIS ADDRESS SPACE EXIST
- The maximum number of serialized connections for this address
space are already active.
- FAILURE ADDING ENTRY TO PASN ACCESS LIST
- There was an error adding a dataspace to the PASN access list.
- MORE CONNECT RECORDS REQUIRED IN CFRM COUPLE DATA SET
- There is a failed-persistent connection with the same connection
name that has not been reconciled into the policy.
- STRUCTURE FAILURE
- Structure failure has occurred.
- COUPLE DATA SET FOR CFRM NOT AVAILABLE
- XES function is not active or the CFRM couple data set is not
available to this system.
- REBUILD CONNECT NOT SUCCESSFUL BECAUSE REBUILD STOP OCCURRED
- The IXLCONN REBUILD request was not successful because a rebuild
stop occurred.
- STRUCTURE HAS NO INFORMATION IN THE CFRM ACTIVE POLICY
- The IXLCONN REBUILD request was not successful because there is
no policy information for this structure in the CFRM active policy.
Start a CFRM policy that includes the definition for this structure.
- CONNECTOR DOES NOT SUPPORT THE CURRENTLY ACTIVE REBUILD PROCESS
- The connect request was not successful either because the connector
specified ALLOWREBLD=NO and a rebuild is in progress, or because
the connector specified ALLOWDUPREBLD=NO and a duplexing rebuild is
in progress.
- CFLEVEL REQUESTED EXCEEDS MAX SUPPORTED CFLEVEL
- The user specified a CFLEVEL that is greater than what is supported
by this system.
- ALLOCATED STRUCTURE DOES NOT MEET MINCFLEVEL REQUIREMENT
- The minimum CFLEVEL requested is greater than the level of the
coupling facility where the structure is allocated.
- XES FUNCTION NOT AVAILABLE
- XES functions are not available. This can be because the hardware
necessary to provide XES functions is not present.
- XES COMPONENT ERROR
- Failure has occurred in XES processing. If the conditions that
caused the error cannot be determined, contact the IBM® Support Center. Supply the error data included
in the message, along with other data from the system log including
the IXLYCONA from the LOGREC symptom record, if any.
- CONNECTIONS TO THE STRUCTURE ARE BEING PREVENTED AT THIS TIME
- Connections to the requested structure are being prevented at
this time.
- IXLCONN ENVIRONMENTAL ERROR
- The IXLCONN request had an environmental error.
- CONADIAGdiagn
- diagn specifies the number used to determine
the specific diagnostic field form the IXLYCONA. The diagnostic field
name is CONADIAGn when diagn is concatenated to
the end of the string CONADIAG. For example, if diagn is
9 then the diagnostic field from the IXLYCONA is CONADIAG9.
- diagvalue
- Optional diagnostic information. Based on the IXLCONN return and
reason codes additional diagnostic information from the IXLYCONA
is provided. See the explanation in IXLCONN of the specified return
and reason codes in order to analyze the value provided by diagvalue which
is from IXLYCONA field CONADIAGn, when n is obtained from diagn.
See z/OS MVS Programming: Sysplex Services Reference for
a detailed explanation of the return and reason codes for IXLCONN
failures.
System action
The system continues. The program that issued
the IXLCONN will not be able to use this structure.
Operator response
Notify the system programmer of this failure.
System programmer response
Examine the system LOGREC
symptom record which contains detailed information in the form of
the IXLCONN parameter list and the Connect Answer Area (IXLYCONA).
Based on the return code from the IXLCONN macro service, additional
information from diagnostic fields in IXLYCONA may also be provided
in the message text to aid in problem determination. Determine the
reason why the connect request could not be satisfied. Make the appropriate
corrections. If needed, restart or reinitialize the program so that
the IXLCONN request is attempted again.
Source
Cross System Extended Services (XES)
Module
Routing code
Descriptor code