Explanation
The system attempted to allocate the structure
named strname, but no coupling facility was suitable.
This message is issued for each coupling facility considered.
In
the message text:
- REBUILD
- If REBUILD appears in the message, the connect was requested as
the result of structure rebuild processing. If REBUILD does not appear,
the connect was requested as the result of start path processing.
- strname
- The name of the XES structure defined to XCF for signalling.
- numlist
- The number of lists requested by XCF when connecting to the structure.
- cfname
- Name of the coupling facility that the structure could not be
allocated in.
- reason
- One of the following:
- POLICY INDICATES SYSTEM NOT CONNECTED TO FACILITY
- According to the CFRM active policy, the system on which the connect
was processed is not connected to the coupling facility in which the
structure is allocated. Physical connectivity to the coupling facility
must be re-established.
- COUPLING FACILITY NOT DEFINED IN POLICY
- The structure is not defined in the CFRM active policy. Verify
that the set of facilities actually in use in the sysplex is correct
and matches the CFRM policy most recently activated.
- LOST CONNECTIVITY TO FACILITY
- The system lost connectivity to the coupling facility in which
the structure is allocated. Physical connectivity to the coupling
facility must be re-established.
- COUPLING FACILITY FAILURE
- The coupling facility failed.
- STRUCTURE FAILURE DURING ALLOCATION PROCESS
- The structure failed while being allocated.
- STRUCTURE ATTRIBUTES NOT VALID FOR THIS FACILITY
- The structure attributes were inconsistent with the model dependent
attributes of the coupling facility.
- STRUCTURE SIZE DEFINED IN POLICY IS TOO SMALL. MINIMUM SIZE REQUIRED
TO ALLOCATE THE STRUCTURE IS minsize u.
- The structure size specified in the CFRM active policy is too
small to allocate the structure with the attributes specified. Increase
the structure size defined in the policy. The minimum amount of space
required to allocate the structure is minsize u, where u is
the integer size unit specification of K (kilobytes), M (megabytes),
G (gigabytes), or T (terabytes). Note that the minimum allocatable
size is not sufficient for good signalling performance, so more space
is usually needed.
Note: The size unit displayed may
be converted to the largest size unit that can be used to represent
the size and avoids any rounding. For example, a minsize of
1048576K may be converted to a minsize of 1G for
the purpose of messages. A minsize of 120000K
will not cause the displayed size to be converted because it is not
an even multiple of megabytes, gigabytes, or terabytes.
- POLICY NOT ALLOWING ALLOCATIONS IN THIS FACILITY
- New structures cannot be allocated in this coupling facility according
to the CFRM active policy. The facility is being removed from the
active policy, the facility has failed, or the facility is in the
policy reconciliation process.
- XCF COMPONENT ERROR
- An internal XCF error occurred within the connect service.
- UNKNOWN HARDWARE ERROR
- An unknown hardware error occurred.
- NOT ENOUGH SPACE TO ALLOCATE STRUCTURE IN FACILITY. MINIMUM SIZE
REQUIRED TO ALLOCATE THE STRUCTURE IS minsize u.
- There was not sufficient space available in the coupling facility
to allocate the structure. The minimum amount of space required to
allocate the structure is minsize u, where u is
the integer size unit specification of K (kilobytes), M (megabytes),
G (gigabytes), or T (terabytes). Note that the minimum allocatable
size is not sufficient for good signalling performance, so more space
is usually needed.
- LOCATION=OTHER SPECIFIED ON STRUCTURE REBUILD
- The rebuild request specified that the structure must be allocated
in some other coupling facility. Since the structure is already allocated
in coupling facility cfname, it is not an eligible
facility for the rebuilt structure.
- DOES NOT SUPPORT NUMBER OF USERS NEEDED FOR REBUILD
- The coupling facility was not selected for a rebuild connect request
because it does not support the number of users connected to the original
structure. The number of connectors to the original structure exceeds
the coupling facility model dependent limit on the maximum number
of connectors.
- UNKNOWN REASON: reason-code
- The reason the structure could not be allocated was not expected.
The indicated reason-code comes from the field
ConaFacilityRsnCode in the Connect Answer Area (mapped by IXLYCONA)
returned by the connect service (IXLCONN).
- FACILITY MAX ELEMENT CHARACTERISTIC TOO SMALL
- The coupling facility model dependent limit for the maximum element
characteristic is too small for XCF's needs.
- FACILITY MAX NUMBER OF LISTS TOO SMALL
- The number of lists requested exceeds the coupling facility model
dependent limit for the maximum number of lists in a list structure.
- IXLCONN SERVICE COULD NOT CONNECT
- An unexpected return and reason code was returned by the IXLCONN
service when XCF attempted to connect to the structure.
- COUPLING FACILITY IS IN MAINTENANCE MODE
- The coupling facility is in maintenance mode.
- RC=n, RSN=n
- Diagnostic data that is provided to assist IBM® service personnel with problem determination.
System action
If there is at least one coupling facility for
which the allocation failed due to space constraints, the system decreases
the requested number of lists and attempts to allocate the structure
again. If the structure still cannot be allocated, this process is
repeated until there are so few lists that the structure would not
be suitable for signalling even if it could be allocated. The system
issues message(s) IXC463I for the maximum number of lists requested,
and for the number of lists requested at the point the system deemed
that the structure would not be suitable for signalling. The system
issues message IXC457I if the structure can be allocated during this
process.
If the structure is not successfully allocated for
the REBUILD case, the system will revert to the original structure
if it is still usable and will initiate a stop path request if it
is not usable. The system also initiates a stop path request if the
structure cannot be allocated when it is not a REBUILD case.
System programmer response
Use this information to determine
why a structure was not allocated in a particular coupling facility.
Ensure
that the coupling facility supports the structure attributes required
for it to be used by XCF. As needed, make a suitable coupling facility
available to the sysplex.
Ensure that the correct CFRM policy
is active. As needed, modify the definition of the structure in the
CFRM active policy. For example, change the maximum structure size,
the preference list, or the exclusion list. Also consider modifying
the CFRM active policy for other structures since reducing the size
or number of structures allocated in a coupling facility could free
up space for this structure.
Source
Cross System Coupling Facility (SCXCF)
Module
Routing code
Descriptor code