Actions to remove a structure from a coupling facility

There are several ways an active structure instance may be removed from a CF:

Stop structure duplexing - keeping only the structure instance in the other CF
Rebuild the structure into another CF
Delete the structure entirely (use only as the last resort)

The method to remove a structure instance from a CF depends on the state of the structure. The state of the structure is provided in the output of the DISPLAY XCF,STRUCTURE,STRNAME=strname system command.

A duplexed CF structure has two structure instances allocated, in two different coupling facilities. To delete one of the structure instances from a particular CF, stop duplexing and keep the structure instance in the other CF.

When the duplexed structure instance to be deleted is listed as the DUPLEXING REBUILD OLD STRUCTURE, stop duplexing to keep the new structure with the SETXCF STOP,REBUILD,DUPLEX,STRNAME=strname,KEEP=NEW system command.
When the duplexed structure instance to be deleted is listed as the DUPLEXING REBUILD NEW STRUCTURE, stop duplexing to keep the old structure with the SETXCF STOP,REBUILD,DUPLEX,STRNAME=strname,KEEP=OLD system command.

Note that if duplexing is stopped for a user-managed duplexed structure that does not have an active connector (for example, a DB2® cache structure for Group Buffer Pools), the structure cannot be re-duplexed (until a connection becomes active).

An active simplex CF structure may be able to be rebuilt into another CF. See instructions as in Rebuilding a structure into another coupling facility.

When an active simplex structure cannot be rebuilt into another CF, the only other alternative is to delete the structure. See Deleting structures.

If a structure dump exists for the structure, consider making a dump data set available to capture the dump. If an SVC dump is not in progress, deletion of the structure dump can be forced in order to allow the structure to be deallocated with the SETXCF FORCE,STRDUMP,STRNAME=strname,STRDUMPID=strdumpid system command.

If a structure is pending deletion or in transition, restore connectivity to the CF. If connectivity cannot be restored to the CF, the structure can only be removed by deleting the CF from the CFRM active policy. See Removing a coupling facility from the configuration.