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

   Deletes a test description from the Digital Test Manager library.

   Format

     DELETE TEST_DESCRIPTION  test-expression [/qualifier...]

            "remark"

1 - Restrictions

   o  You cannot delete a test description if it belongs to a group.
      Use the REMOVE TEST_DESCRIPTION command to remove a test
      description from a group. Use the SHOW TEST_DESCRIPTION/GROUPS
      command to display the groups to which the test description
      belongs.

   o  Do not delete a test description that is part of an existing
      collection. If you delete a test description that is part
      of a collection, you may see error messages when you issue
      other Digital Test Manager commands. For example, if you review
      a collection from which you have deleted a test description
      and its associated benchmark file for a noninteractive test,
      you will see a message indicating that the result description
      contains errors and you will be unable to examine the benchmark
      file for this result description. If you delete the test
      description and benchmark file for an interactive test that
      uses a screen comparison, you will be unable to examine any of
      the files associated with the test.

2 - Command Qualifiers

 2.1 - /CONFIRM

   /CONFIRM (D)
   /NOCONFIRM

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

 2.2 - /LOG

   /LOG (D)
   /NOLOG

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

3 - Examples

   1.  DTM> DELETE TEST_DESCRIPTION/NOCONFIRM RMTEST "Deleting RMTEST"
       %DTM-S-DELETED, test_description RMTEST deleted
       DTM>

   This example deletes the test description RMTEST. The
   /NOCONFIRM qualifier is in effect.

   2.  DTM> DELETE TEST_DESCRIPTION/NOCONFIRM *TEST*
       _Remark: Deleting all MAIL tests
       %DTM-I-DELETED, test_description MAIL_TEST deleted
       %DTM-I-DELETED, test_description RMTEST deleted
       %DTM-I-DELETED, test_description SEND_MAIL_TEST deleted
       %DTM-I-DELETED, test_description TEST_TUBE deleted
       %DTM-S-DELETIONS, 4 test_descriptions deleted
       DTM>

   This example deletes from the current library all the test
   descriptions that contain TEST as part of their name. The
   /NOCONFIRM qualifier is in effect.