Configuration Groups can be enumerated two different ways. The server can be requested to enumerate groups by name or by object. Enumerating by name, the server passes back an enumeration of strings each containing the name of a group. Enumerating by object, the server passes back an enumeration of group interface pointers (IUnknown), which the client can make use of, by querying for other interfaces. Either way, the client uses both mechanisms to obtain the same results, a list of group names along with the properties of each group.
The client can request only private groups (groups this client added to the server connection), public groups (groups that may have been added by another client but made available to us) or all groups be enumerated. This operation tests the following server functionality: IOPCServer::CreateGroupEnumerator ( )., IOPCServer::GetGroupByName ( ), IOPCGroupStateMgt::GetState ( ). Get Group By Name Select Get Group ByName... from the Tools|Server menu to obtain group properties by name. To request group properties by name; enter the name of the group and press Apply. If the server can resolve the group name, the client will proceed to obtain the properties for that group.
This operation tests the following server functionality: IOPCServer::GetGroupByName ( ), IOPCGroupStateMgt::GetState ( ). Group Operations Clone Group Select Clone Group from the Tools|Group menu to clone the selected group. An OPC server should create a new group, with a unique name, with identical properties to the group that is being cloned. If the cloned group contains items, the items should also be cloned, again with the same properties. The active state of the cloned group and items should be set to an inactive state. This operation tests the following server functionality:
IOPCGroupStateMgt::CloneGroup, SetState ( ), IOPCItemMgt::CreateEnumerator, SetClientHandles ( ), IEnumOPCItemAttributes::Reset, Next ( ). Item Operations Set Active/Inactive Select SetActive/Inactive from the Tools|Item menu to activate/inactivate the selected item(s). Only active items should receive on data change updates (the group must also be set active) TS6120 58 Version: 1.2.0