CL Command Reference - RMVCRGDEVE

CL Command List > RMVCRGDEVE Reference

Description:

The Remove Cluster Resource Group Device Entry (RMVCRGDEVE) command removes one or more configuration objects from a device cluster resource group. All configuration object entries can be removed but at least one configuration object entry must exist before the Start Cluster Resource Group (STRCRG) command can be called.

Ownership of the hardware associated with the configuration object being removed is not affected. The hardware is still owned by whatever node owned it before this command was called.

If an exit program is specified for the cluster resource group, the cluster resource group exit program is called with an action code of Remove Device Entry on all active nodes in the recovery domain. The cluster resource group status is set to Remove Device Entry Pending. If the exit program completes successfully, the cluster resource group status is reset to its value at the time the command was called. If the exit program fails and the cluster resource group cannot be restored to its original condition, the cluster resource group status is set to Indoubt.

Restrictions:

1. You must have input/output system configuration (*IOSYSCFG) special authority to run this command.

2. This command cannot be called from a cluster resource group exit program.

3. Cluster Resource Services must be active on the node processing the request.

4. At least one node in the recovery domain must be active.

5. If the cluster resource group is Active, the last device entry cannot be removed. The cluster resource group must be ended first.



Examples:

RMVCRGDEVE CLUSTER(MYCLUSTER) CRG(MYCRG) CFGOBJ((IASP01 *DEVD))

This command removes configuration object IASP01 from an existing cluster resource group MYCRG in cluster MYCLUSTER.