Display Structures

The STRUCTURE function of the INGCF displays the allocated structures of a coupling facility. You can initiate a rebuild or deallocation of a selected structure if the conditions for these actions are satisfied.

  • If you have specified INGCF with the STR parameter, the Coupling Facility field is an input field. To display the structure list of another coupling facility, specify the name of the coupling facility in this field and press Enter.
  • The Include Condition field is an input field. By entering Yes or No in this field you determine whether the conditions of the structures are displayed in the Structure column.
  • The Permission field shows your authorization level. There are two possible values, ALL and DISPLAY. DISPLAY indicates that you can only use the display functions. ALL indicates that you can also rebuild and delete structures.

    You can specify an action code before every structure entry. The codes you can enter depend on your authorization level

  • The Structure column shows the names of the structures.
  • The letter P in the P column indicates that policy changes are pending for the structure.

    A structure has policy changes pending when it was allocated at the time of a CFRM policy switch, and XES could not bring the switch into effect for that structure. One reason for a pending policy change is that the old and the new policy define the structure differently, for example, with different preference lists.

  • The D column indicates the type of duplexing that is possible. The following values are possible:
    U
    User-managed duplexing
    S
    System-managed duplexing
    B
    User-managed and system-managed duplexing
  • The Condition column shows the status of the structures. You can switch the display of the conditions on and off with the Include Condition field.
The following command codes are available:
D
Displays detail information about the structure.
*F
Forces the deallocation of the structure if it has one of the following conditions:
  • No connection exists.
  • No alternate CF for structure with no active connections.
  • No alternate CF for structure with no connections.

When you try to force the deallocation of a structure that can be rebuilt, an error message is issued.

*P
Stops duplexing of the selected structure.
*R
Starts the rebuild of the selected structure. Depending on the PENDING status, the automation starts the rebuild with a different LOCATION parameter (PENDING uses the parameter LOCATION=NORMAL, otherwise LOCATION=OTHER). A rebuild with the parameter LOCATION=OTHER is only initiated for structures whose preference list contains more than one coupling facility.

There are two methods for rebuild, user-managed and system-managed rebuild. User-managed rebuild is supported for all release levels. System-managed rebuild is only available with systems that have z/OS 2.8 or above. It must have been enabled by formatting the CFRM couple data sets with the specification

ITEM NAME(SMREBLD) NUMBER(1)

System-managed rebuild is only performed when the requirements for user-managed rebuild are not met. This applies, for example, to structures without active connectors.

INGCF STRUCTURE accepts a rebuild request for structures with the condition 'No active connection exists.', but deallocates them. See the section Structure Conditions in the description of the INGCF command in IBM Z® System Automation Operator's Commands.

The rebuild function works differently depending on the status of the structure (PENDING calls LOCATION=NORMAL, otherwise LOCATION=OTHER).

*S
Starts duplexing of the selected structure.

There are two methods for duplexing, user-managed and system-managed duplexing. User-managed duplexing is supported for all release levels. System-managed duplexing is only available when all systems in the Parallel Sysplex have been upgraded to z/OS 1.2 or later with APAR OW41617, and appropriate APARs listed in the CFDUPLEX PSP bucket (for more information, see System-Managed CF Structure Duplexing, GM13-0103-03). System-managed duplexing must have been enabled by formatting the CFRM couple data sets with the specification

ITEM NAME(SMDUPLEX) NUMBER(1)

System-managed duplexing is only performed when the requirements for user-managed duplexing are not met. This applies, for example, to structures without active connectors.

Starting the duplex rebuild of a structure requires at least the policy entry allowing the duplex rebuild of the structure. If there is no entry the duplex rebuild is disabled. The other requirements depend on the type of the duplex rebuild. When all connectors to a structure allow user-managed duplex rebuild, this type takes precedence over system-managed duplex rebuild. However, user-managed rebuild also requires at least one active connector. Thus, when the operator starts the duplex rebuild for a structure allowing user-managed duplex rebuild as well as system-managed rebuild but without having active connectors, XCF tries to initiate a system-managed duplex rebuild. System-managed duplex rebuild has the following requirements:

  • System-managed rebuild must be supported by all connectors.
  • The structure must be allocated in a coupling facility supporting system-managed duplexing and another coupling facility supporting system-managed duplexing must be defined in its preference list.
  • The CFRM couple data set must support system-managed duplex rebuild and the structure must not have a policy change pending.
  • The structure must be defined in the active CFRM policy when any connection state is not active.