IXCH0921I
Lists structures which have an availability problem based on evaluation of the structure's preference list.

text

Explanation

Where text is:
When the structure does not have a policy change pending, the check uses 
   the preference list from the active policy (ACTIVE). When the structure 
   has a policy change pending, the check uses the preference list from 
   the pending policy (PENDING).

An asterisk (*) before the coupling facility name from the preference 
   list indicates that the coupling facility is not usable for structure 
   allocation.

NOTE: When the check is run in verbose mode, all defined structures are 
   listed. The structures that do not have an availability problem are 
   listed after any that have an availability problem.


Structure name    PREFLIST used    PREFLIST (preference list)
   (evaluation result)
--------------    -------------    -------------------------------
structure_name    preflist_used    cfname_1 *cfname_2 *cfname_3
   (evaluation result)

structure_name    preflist_used    *cfname_1 cfname_2 *cfname_3
                                   *cfname_4 *cfname_5 *cfname_6
                                   *cfname_7 *cfname_8
   (evaluation result)

CHECK(IBMXCF,XCF_CF_STR_AVAILABILITY) found CF structure(s) with a preference list that could limit availability of the structure.

A structure's preference list should have at least two coupling facilities located in different CECs with each usable for structure allocation. To be usable for structure allocation, the coupling facility must have at least one system connected and have allocation permitted.

The check writes the list to the message buffer when an exception is discovered (see message IXCH0212E) or when the check is run in verbose mode. When the check is run in verbose mode, all structures defined in the CFRM active policy are listed.The structures without an availability problem are listedafter any that currently have an availability problem.

In the message text:
structure_name
The name of the CF structure.
preflist_used
Identifies which preference list was used for evaluation.
  • ACTIVE - the PREFLIST information is from the active policy.
  • PENDING - the PREFLIST information is from the pending policy.
cfname
The name of the coupling facility in the preference list.
  • An asterisk (*) in front of the coupling facility name indicates that the coupling facility is not usable for structure allocation. To be usable for structure allocation, the coupling facility must be defined in the CFRM active policy and permit structure allocation with at least one system connected.
  • When the coupling facility name is all asterisks (*********), then the preference list is empty. The preference list can be empty when a persistent CF structure was reconciled into the CFRM active policy that did not have a definition for the named structure.
  • Up to three coupling facility names are listed per line.
(evaluation_result)
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. Structures with this evaluation result are shown only when the check is run in verbose mode. Theevaluation result is shown once before the structures are listed. Each structure listed does not have an evaluationresult 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.

Exception message IXCH0212E follows in the message buffer when the check finds structures with availability problem.

System action

The system continues processing.

Operator response

N/A

System programmer response

N/A

Problem determination

See IXCH0212E.

Source

Parallel Sysplex® (XCF)

Module

IXCHCSTR

Routing code

N/A

Descriptor code

N/A

Reference Documentation

See IXCH0212E.