INGCF ENABLE

Purpose

The ENABLE function of the INGCF command is intended to support the integration AND re-integration 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 coupling facility is not defined in the active policy and a suitable policy is available.

    A suitable CFRM policy must contain:

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

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

Actions

The possible actions and the associated F-keys are:

*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 coupling facility is active.
*MAINTOFF (F5)
Takes the coupling facility out of maintenance mode.
*SWITCH (F5)
Switches to another CFRM policy when the target coupling facility 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 coupling facility
  • Definitions for every active coupling facility and every allocated structure

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

*POPULATE (F10)
Starts a rebuild process by which all structures that have the target coupling facility at the beginning of their preference list but are currently allocated on another coupling facility are allocated on the target coupling facility.

This action requires that the coupling facility be 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 coupling facility although it is the preferred coupling facility 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.