IXCH0212E

Explanation
 CHECK(IBMXCF,XCF_CF_STR_AVAILABILITY) found an
availability problem  with one or more CF structures' preference lists
(PREFLIST). A structure's preference list should have at least two
coupling facilities that can be used for structure allocation  with
each coupling facility on a different CEC. For a coupling facility
to be usable for structure allocation,  at least one system must be
connected to the coupling facility, and allocation must be permitted
in the coupling facility.   
 The check uses the preference
list to evaluate structure availability. The preference list is from
the active policy unless there is a pending policy change. When a
policy change is pending, the preference list is from the pending
policy. The result of the evaluating the structure's preference list
is one of the following:Preference list passed checks
The checked preference list has at least two coupling facilities
that are usable for structure allocation and are on different CECs. Note: Structure(s)
with this evaluation result are only shown when the check is run in
verbose mode. The evaluation result is shown once before the structure(s)
are listed. Each     structure listed does not have an evaluation
result shown.

Preference list has only 1 CF
The checked preference list has only one coupling facility.
Preference list does not have at least 2 usable CFs
The checked preference list does not have at least two coupling
facilities that are usable for structure allocation.
Preference list does not have 2 usable CFs each on different CECs
The checked preference list does not have at least two coupling
facilities that are usable for structure allocation and are on different
CECs.

See message IXCH0921I in the message buffer,
for a list of the CF structures including the preference list used,
 the coupling facilities in the preference list, and the result of
evaluating the structure's preference list. 

System action
The system continues processing.

Operator response
Report this problem to the system programmer.

System programmer response
It is preferred that the preference
list for each structure defined in the CFRM active policy should have
at least two coupling facilities located in different CECs that support
structure allocation. To support structure allocation, the coupling
facility should  have at least one system in the sysplex connected
and should be in a state permitting structure allocation.  
 When
a structure listed in message IXCH0921I has an availability problem,
examine the coupling facilities listed from the preference list to
determine any action needed to make the coupling facility usable for
structure allocation.  To obtain the current status for each coupling
facility, use the display command:  DISPLAY XCF,CF,CFNAME=ALL    

When
the coupling facility is not eligible for structure allocation,  the
display command output (message IXC362I) shows this :- "NO SYSTEMS ARE CONNECTED TO THIS COUPLING FACILITY"  
- "ALLOCATION NOT PERMITTED" along with the reasons  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:
     "NO SYSTEMS ARE CONNECTED TO THIS COUPLING FACILITY"   

   On each system issue display command:    

     D CF,CFNAME=cfname         

   to obtain current status of the system accessibility to          

   the coupling facility and correct any problems found.

 "ALLOCATION NOT PERMITTED" based on the reason(s):     

   - 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 then        

     move all the structures currently allocated in the coupling    

     facility to other coupling facilities. Use command:

       SETXCF START,REALLOCATE  

     to accomplish this for structures that support structure       

     rebuild processing.        

     If the coupling facility is to remain in use then start        

     a CFRM administrative policy that includes a definition of     

     the coupling facility. Use 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 on 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.  

 When
the sysplex configuration has only one CEC or a single coupling facility
image, a single point of failure exists. This environment is not consistent
with the best practices. CHECK(IBMXCF,XCF_CF_STR_AVAILABILITY) issues
this exception message each time the check is run. Therefore, when
the sysplex configuration has only one CEC or a single coupling facility
image, the check  should be disabled. 

Problem determination
N/A

Source
         Parallel Sysplex® (XCF)          

Module
         IXCHCSTR   

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