HP Operations Manager for Windows

OV_NodeGroup::Remove()
OV_NodeGroup::Remove_Trans()


void Remove(
[in] string Name)
void Remove_Trans(
[in] string TransId,
[in] string Name)

Parameters

TransId
Transaction ID returned from OV_Transaction::Start().
Name
The Name property of the instance of OV_NodeGroup to be removed.

Calling Convention

These methods can be called from a WMI class or instance object.

Description

Removes the specified node group (instance of OV_NodeGroup).

Caution CAUTION:
This method also removes all child node groups that are not contained in any other node group (except special node groups). If nodes that are contained in this node group are not contained in any other node group (except special node groups), they are also removed. (To find out what else is removed, see the description of the Remove class method of OV_ManagedNode.) If the management server is also removed, the method fails with MDLAPI_E_NODE_IS_MANAGEMENT_SERVER. In addition, associated reports and associations to Auto-Deploy policies and tools are removed. (Only associations, not objects, are removed.)
Note NOTE:
You cannot remove root or special node groups. Attempts fail with MDLAPI_E_NODEGROUP_IS_ROOT / MDLAPI_E_NODEGROUP_IS_SPECIAL_GROUP.

Return Value

None.

Extended Status Codes

MDLAPI_E_NODE_IS_MANAGEMENT_SERVER
Management server cannot be removed.
MDLAPI_E_NODEGROUP_NOT_EXIST
Node Group does not exist.
MDLAPI_E_NODEGROUP_IS_ROOT
Root Node Group cannot be removed from or added to another node group.
MDLAPI_E_NODEGROUP_IS_SPECIAL_GROUP
Special Node Group cannot be removed from or added to another node group.
MDLAPI_E_TRANSACTION_NOT_EXIST
Transaction with the specified ID does not exist.