CMS$DW_HELP.HLB  —  M  M_M, I mi
  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.
Close Help