VMS Help DTM, INSERT  *Conan The Librarian (sorry for the slow response - running on an old VAX)

1 - GROUP

   Places one or more groups in one or more other groups.

   Format

     INSERT GROUP  group-expression1 group-expression2

         [/qualifier...] "remark"

 1.1 - Restrictions

   o  Digital Test Manager does not insert the same group into another
      group more than once. If the first group is already a subgroup
      of the second group, Digital Test Manager informs you that the
      INSERT operation has already been done.

   o  Digital Test Manager does not create recursive group structures.
      If group B is a subgroup of group A, then group A cannot be a
      subgroup of group B.

 1.2 - Command Qualifiers

 1. 2.1 - /CONFIRM

   /CONFIRM
   /NOCONFIRM (D)

   Controls whether Digital Test Manager prompts you to confirm each
   insertion. Valid responses are Yes, No, All, or Quit.

 1. 2.2 - /LOG

   /LOG (D)
   /NOLOG

   Controls whether Digital Test Manager displays informational and
   success messages on your screen.

 1.3 - Examples

   1.  DTM> INSERT GROUP MARGINS BOUNDARIES
       _Remark: Inserting group MARGINS into group BOUNDARIES
       %DTM-S-INSERTED, group MARGINS inserted into group BOUNDARIES
       DTM>

   This example inserts the MARGINS group into the BOUNDARIES
   group.

   2.  DTM> INSERT GROUP RIGHTMARGIN BOUNDARIES,MARGINS
       _Remark: Inserting RIGHTMARGIN into MARGINS and BOUNDARIES
       %DTM-I-INSERTED, group RIGHTMARGIN inserted into group MARGINS
       %DTM-I-INSERTED, group RIGHTMARGIN inserted into group BOUNDARIES
       %DTM-S-INSERTIONS, 2 insertions completed
       DTM>

   This example inserts the RIGHTMARGIN group into both the
   MARGINS and BOUNDARIES groups.

2 - TEST_DESCRIPTION

   Places one or more test descriptions into one or more groups.

   Format

     INSERT TEST_DESCRIPTION  test-group-expression group-expression

            [/qualifier...] "remark"

 2.1 - Command Qualifiers

 2. 1.1 - /CONFIRM

   /CONFIRM
   /NOCONFIRM (D)

   Controls whether Digital Test Manager prompts you to confirm each
   insertion. Valid responses are Yes, No, All, or Quit.

 2. 1.2 - /LOG

   /LOG (D)
   /NOLOG

   Controls whether Digital Test Manager displays informational and
   success messages on your screen.

 2.2 - Parameter Qualifiers

 2. 2.1 - /GROUP

   Identifies the immediately preceding item in a parameter as
   a group. If the test group expression is a list, use this
   qualifier after each item that designates a group. The default
   is /TEST_DESCRIPTION.

 2. 2.2 - /TEST_DESCRIPTION

   Identifies the immediately preceding item in a parameter as a
   test. This is the default.

 2.3 - Example

   DTM> INSERT TEST_DESCRIPTION MARGINS/GROUP BOUNDARIES
   _Remark: Inserting tests in MARGINS into BOUNDARIES
   %DTM-I-INSERTED, test description BOTTOMEDGE inserted into group BOUNDARIES
   %DTM-I-INSERTED, test description LMARGIN inserted into group BOUNDARIES
   %DTM-I-INSERTED, test description RMARGIN inserted into group BOUNDARIES
   %DTM-I-INSERTED, test description TOPEDGE inserted into group BOUNDARIES
   %DTM-S-INSERTIONS, 4 insertions completed
   DTM>

   This example inserts all the test descriptions in the MARGINS
   group into the BOUNDARIES group. However, the MARGINS group
   itself is not inserted.