Choose the Insert submenu to display a list of the types of objects on which you can perform insertion transactions: o Elements o Groups o Generations
1 – I e
The Insert Element... menu item allows you to place one or more elements or groups into one or more groups. If you specify a group name in the Element field, CMS inserts the elements contained in the group. For example, if you insert group A into group B, group B will contain the elements in group A. If the contents of group A change at a later time, the contents of group B are not affected. To insert a group into another group, choose the Insert Group... menu item.
1.1 – I s
If you click on an object or objects before choosing the Insert Element... menu item, the Selected box contains those objects. CMS performs the insert transaction on the selected objects.
1.2 – I ef
Fill in the Element field with the name of one or more element expressions to be inserted into a group. The element expression can be an element name, a group name, a wildcard expression, or a list of these separated by commas.
1.3 – I g
Fill in the Group field with the name of one or more groups into which the element or elements are to be inserted. You can use a group name, wildcard expression, or a list of these separated by commas.
1.4 – I r
Fill in the Remark field with text to be associated with the transaction and logged in the history file with this insert transaction.
1.5 – I ia
Click on the Insert if Absent button to direct CMS to insert the element only if the group does not already contain that element. If the element already belongs to the group, CMS takes no action and does not return an error.
2 – I gm
Choose the Insert Group... menu item to place one or more groups into one or more other groups. If you insert group A into group B, the elements accessible through group B change as the contents of group A change. A group cannot be a member of itself; that is, it cannot be a subgroup of itself. For example, you cannot insert group A into group B if group A already contains group B.
2.1 – I sf
If you click on an object or objects before choosing the Insert Group... menu item, the Selected box contains those objects. CMS performs the insert transaction on the selected objects.
2.2 – I gf
Fill in the Subgroup field with the name of one or more groups to be inserted into the other group (or groups). The subgroup can be a group name, a wildcard expression, or a list of these separated by commas.
2.3 – I gg
Fill in the Group field with the name of the group expression into which the subgroup is to be inserted. The group expression can be a group name, a wildcard expression, or a list of these separated by commas.
2.4 – I rm
Fill in the Remark field with text to be associated with the transaction and logged in the history file with this insert transaction.
2.5 – I atb
Click on the Insert if Absent button to direct CMS to insert the subgroup into the group only if the group does not already contain it. If the subgroup already belongs to the group, CMS takes no action and does not return an error.
3 – I gi
The Insert Generation... menu item places one or more element generations into one or more classes. A class can contain only one generation of an element.
3.1 – I sfg
If you click on an object or objects before choosing the Insert Generation... menu item, the Selected box contains those objects. CMS performs the insert transaction on the selected objects.
3.2 – I gef
Fill in the Element field with the name of one or more element expressions whose generations are to be inserted into the class. The element expression can be an element name, a group name, a wildcard expression, or a list of these separated by commas.
3.3 – I grp
Fill in the Generation field with the generation number to be inserted into the class. If you omit this field, CMS uses the latest generation on the main line of descent.
3.4 – I igi
Fill in the Class field with the name of the class into which the element generation is to be placed. You can use a class name, a wildcard expression, or a list of these separated by commas.
3.5 – Ibef
Fill in the Before field with a time value indicating the time before which CMS should choose the latest ancestor of the generation specified by the Generation Field that pre-dates the specified time. If no generation pre-dates that time (i.e. generation 1 is later) then no generation is inserted.
3.6 – Igr
Fill in the Remark field with text to be associated with the transaction and logged in the history file with this insert transaction.
3.7 – Ist od
The Insert Option choices enable you to direct CMS to perform the insert transaction only in certain cases.
3.7.1 – Iia
Click on the Always button to direct CMS to insert the element generation into the class in all cases. If the class already contains a generation from the element, that generation is removed before the new one is inserted.
3.7.2 – Ifa
Click on the If Absent button to direct CMS to insert the element generation into the class only if a generation of that element is not already in the class. If a generation of the element is already in the class, CMS takes no action and does not return an error.
3.7.3 – Isp
Click on the Supersede if Present button to direct CMS to remove a generation of the element that exists in the class and replaces it with the specified generation. If you specify Supersede if Present and there is no generation of that element already in the class, CMS issues an error message and does not insert the generation.
3.7.4 – Non
If the None button is activated, CMS places the generation into the class. If a generation of the element is already in the class, CMS issues an error message and does not insert the generation.