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
Source
Module
Routing code
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