Define Contents
- Last UpdatedMay 25, 2022
- 2 minute read
The contents of a shared collection are defined by adding or removing references to or from the list part of the shared collection.
In order to use the commands described in this section, the current element must be the shared collection whose member list you wish to modify. Specified elements are then added to the list part of the current element starting from the current list position or are removed from the list part of the current element such that the current list position becomes the Head position.
The elements to be added to, or removed from, the shared collection’s member list may be specified in any of the following ways:
-
Explicitly, by name or (system-assigned) reference number.
-
As members of specified elements, where a member of an element is defined as any element immediately below it in the DB hierarchy
-
As items of specified elements, where an item of an element is any element anywhere below it in the hierarchy which has no list part (such as a Valve, Point, Box, etc.)
-
By type (such as Equipment, Branch, Pipe, etc.)
Examples
GADD /ZONE1 /VALVE2
Adds /ZONE1 and /VALVE2 to the current shared collection, starting from the current list position
GREMOVE /ZONE1 /BOX3
Removes /ZONE1 and /BOX3 from the current shared collection and moves the current list position pointer to the Head position
GADD MEM OF /BRANCH1 /BRANCH2
Adds all the pipe Components in Branches /BRANCH1 and /BRANCH2 to the current shared collection, starting from the current list position
GREM MEM OF /PIPE100 MEM OF /EQUI-B
Removes all Branches of the Pipe /PIPE100 and all members of Equipment /EQUI-B from the current shared collection
GREM ITEMS OF /ZONE2
Removes from the current shared collection all occurrences of those offspring of /ZONE2 which are items
GADD ALL EQU BRAN OF /ZONE1 /ZONE2
Adds all offspring of /ZONE1 and /ZONE2 which are of types Equip or Branch to the current shared collection, starting from the current list position
Command Syntax
>--+-- GADD -----. .-------------.
| | / |
‘-- GREMove --+---*-- <selatt> ---+--->