Ets_Nt_Subnet_Grouping_Perform()
Abstract
Creates a new subnet hierarchy by applying a grouping settings file to a list of nodes.
Syntax
Ets_Nt_Subnet_Grouping_Perform (nodes_lptr, settings_fname, dest_subnet_hndl, option)
| Argument | Type | Description |
|---|---|---|
nodes_lptr |
EtsT_Obj_List * |
List of nodes to be grouped. |
settings_fname |
const char * |
Name of grouping settings (.grf) file to use. |
dest_subnet_hndl |
EtsT_Obj_Handle |
Subnet in which the new subnet hierarchy should be installed. |
option |
int |
Not used; should be 0. |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if the grouping is performed and the subnet created; EtsC_Compcode_Failure otherwise.
Header
ets_api_nt.h
Details
This function allows the Group Nodes into Subnets operation to be performed programatically. It applies a grouping settings file (specified by settings_fname) to the nodes in nodes_lptr. The result, which might be a single subnet or a hierarchy of subnets, is installed in the subnet specified by dest_subnet_hndl. The grouping settings file is described in “Group Nodes into Subnets“ on page 223.