VMS Help  —  DTM  INSERT

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.
Close Help