IXCH0215E
One or more coupling facilities do not permit structure allocation.

Explanation

CHECK(IBMXCF,XCF_CF_ALLOCATION_PERMITTED) found allocation not permitted in one or more coupling facilities.

It is preferred that a coupling facility should be eligible for allocating structures whenever the CFRM active policy has a definition for the coupling facility.

See message IXCH0214I in the message buffer for the name of the coupling facility for which structure allocation is not permitted. These are the possible reasons for structure allocation not permitted:
  • The coupling facility is in maintenance mode.
  • There is a pending policy change to delete the coupling facility from the CFRM active policy.
  • The coupling facility has failed.
  • The coupling facility is in cleanup processing in preparation for use by the sysplex.

For a coupling facility to be eligible for structure allocation, the state of the coupling facility must permit structure allocation.

System action

The system continues processing.

Operator response

Report this problem to the system programmer.

System programmer response

It is preferred that coupling facilities should be eligible for structure allocation whenever the coupling facility is defined in the CFRM active policy. If a particular coupling facility is not eligible for structure allocation, it might be due to planned reconfiguration or service activities that are in progress. But if the service activity has completed, it might be an oversight that leaves the coupling facility in maintenance mode, or might be an indication of a problem with the coupling facility as a result of service activities.

To obtain the current status for all coupling facilities, use the display command:

D XCF,CF,CFNAME=ALL          

To obtain current status for a specific coupling facility listed by message IXCH0214I, use the display command:

D XCF,CF,CFNAME=cfname      

When the coupling facility is not eligible for structure allocation, the display command output (message IXC362I) shows this:

"ALLOCATION NOT PERMITTED" along with the reason(s)  that structure allocation is currently not permitted.  

When the coupling facility is now eligible for structure allocation, no further action is needed. When the coupling facility is not eligible for structure allocation, take the necessary actions based on the reason specified:
The coupling facility is in maintenance mode.
To take a coupling facility out of maintenance mode use command: SETXCF STOP,MAINTMODE,CFNAME=cfname
There is a pending policy change to delete the coupling facility from the CFRM active policy.
If the coupling facility is to be removed from use, move all the structures currently allocated in the coupling facility to other coupling facilities. Use the command to accomplish this for structures that support structure rebuild processing: SETXCF START,REALLOCATE
If the coupling facility is to remain in use, start a CFRM administrative policy that includes a definition of the coupling facility.
Use the command: SETXCF START,POLICY,TYPE=CFRM,POLNAME=policy_name
The coupling facility has failed.
Reactivate the coupling facility partition. See the PR/SM™ Planning Guide for information about activating partitions. If the coupling facility remains failed, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM® Support Center.
The coupling facility is in cleanup processing in preparation for use by the sysplex.
The cleanup processing must complete on some system in the sysplex before the coupling facility can be used by any system. If the coupling facility remains in cleanup, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.

Problem determination

N/A

Source

Parallel Sysplex® (XCF)

Module

IXCHCCF

Routing code

See note 35.

Descriptor code

3 is the default set by this check. See note 1.

Reference Documentation

z/OS MVS Setting Up a Sysplex

PR/SM Planning Guide