Enable CF

The ENABLE function of the INGCF command is intended to support the integration and reintegration of a coupling facility into a sysplex. With this option, you can:

  1. Activate the target coupling facility.
  2. Connect the systems of the sysplex with the coupling facility.
  3. Take the coupling facility out of maintenance mode when it is in this mode and the MAINT function is supported.
  4. Switch to another CFRM policy if the target CF is not defined in the active policy and a suitable policy is available.

    A suitable CFRM policy must contain:

    • A definition of the target CF
    • Appropriate definitions for every active CF and every allocated structure
  5. Rebuild all structures on the target CF whose preference list starts with this CF, unless this is excluded by other requirements.

The ENABLE CF option ensures that these actions are performed in the correct order, as specified above.

The following function keys support these actions:

*ACTIVATE (F11)
This action activates the CFCC (Coupling Facility Control Code) through the BCP internal interface by an ACTIVATE command.
Note: This function key is unavailable when running on a z/OS image that runs under z/VM®.
*ENABLE (F4)
Sets the sender paths of all systems of the sysplex to ONLINE. This action is enabled when the CF is active.
*MAINTOFF (F5)
Takes the coupling facility out of maintenance mode.
*SWITCH (F5)
Switches to another CFRM policy when the target CF is not defined in the active CFRM policy and a suitable policy is available. When there is more than one suitable policy you can choose one of these from a selection panel.

A CFRM policy is suitable when it contains:

  • A definition of the target CF
  • Definitions for every active CF and every allocated structure

This action is only available when the target CF is active, but not defined in the current CFRM policy.

*POPULATE (PF10)
Starts a rebuild process where all structures that have the target CF at the beginning of their preference list, but are currently allocated on another CF, are allocated on the target CF.

This action requires that the CF is enabled, connected to all members of the sysplex, and defined in the current CFRM policy. The action is offered whenever INGCF ENABLE detects that a structure is not allocated on the target CF although it is the preferred CF of that structure.

Note: When you have drained a coupling facility with INGCF DRAIN and then reintegrate it with INGCF ENABLE, be aware that the set of structures that are allocated on the target coupling facility after population can be different from the original set before the draining. Typically, this happens when the original set does not contain exactly those structures that have the target coupling facility at the first position in their preference list.

Note that these actions can only be performed when INGCF ENABLE is called in full mode. In line mode, only the display function is available.

In the following example, a coupling facility that has already been activated is reintegrated into the sysplex in two steps:

  1. The coupling facility is connected to all systems of the sysplex.
  2. All structures that have the target coupling facility as the first coupling facility in their preference list are allocated on the target coupling facility.

If you issue INGCF with the option ENABLE, you can specify the coupling facility to be reintegrated, for example by entering INGCF ENABLE CF02. If you do not specify a coupling facility name, INGCF shows a selection panel with all coupling facilities that are defined in the sysplex.

After selection of CF02, INGCF displays a panel that shows that the selected CF has already been activated manually, therefore its status, as shown on the right of the panel, is DRAINED. The authorization type of the operator (ALL) is also displayed on the right of the panel. The main part of the panel is empty because no structures are allocated in CF02. The only action that is activated is ENABLE with PF4. If you press PF4 a confirmation panel is displayed.

After pressing PF10 on the confirmation panel, the command dialog shows that the status has changed to NORMAL, and you can populate the CF with PF10. This implies that the target CF is defined in the active CFRM policy.

The structure list contains three entries with the condition 'Structure is currently allocated in CF01.'. These are the structures that are currently allocated in CF01, but have CF02 at the first position in their preference list.

Pressing PF10 populates the CF, and the refreshed panel shows that the POPULATE action is no longer available because all structures whose preference list starts with CF02 are now allocated in CF02.