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

1 - TEST_DESCRIPTION

   Copies an existing test description.

   Format

     COPY TEST_DESCRIPTION  test-name1 test-name2 [/qualifier...]

            "remark"

 1.1 - Restrictions

   o  The /COMMAND qualifier applies to DECwindows tests only.

   o  The /NOFILTERS qualifier applies to interactive and
      noninteractive terminal tests only.

 1.2 - Command Qualifiers

 1. 2.1 - /COMMAND

   /COMMAND=command

   By default, the new test description has the same command as the
   copied test description. If you specify the /COMMAND qualifier,
   you associate a new command with the new test description. If
   you specify the /NOCOMMAND qualifier, the associated command is
   not copied with the test description. The qualifier applies to
   DECwindows tests only.

 1. 2.2 - /COMPARISON_TYPE

   /COMPARISON_TYPE=keyword

   Specifies how the result and benchmark files are to be compared. A
   comparison type is not associated with the test description. The
   valid values for keyword are as follows:

     Keyword     Meaning

     CHARACTERS  Compares files character by character.

     RECORDS     Compares files record by record. This is the
                 default for noninteractive terminal tests.

     SCREENS     Compares files screen by screen; screens not
                 marked are not compared. This is the default for
                 interactive terminal and DECwindows tests.

   DECwindows tests can only use the SCREENS comparison type. The
   SCREENS comparison type is also the default comparison type for
   interactive terminal tests. If you specify the /COMPARISON_
   TYPE=SCREENS qualifier for a noninteractive test, this value is
   ignored.

 1. 2.3 - /EPILOGUE

   /EPILOGUE=file-specification
   /NOEPILOGUE

   Determines whether a test epilogue file is associated with the
   test description. The epilogue file associated with the existing
   test description is also associated with the new test description.

   The /EPILOGUE qualifier causes the specified epilogue file to
   replace the existing epilogue file. The /NOEPILOGUE qualifier
   specifies that no epilogue file be associated with the new test
   description.

 1. 2.4 - /NOFILTERS

   Specifies that no filters be associated with the new test
   description. By default, the filters associated with the existing
   interactive or noninteractive terminal test descriptions are also
   associated with the new test descriptions.

 1. 2.5 - /NOGROUPS

   Specifies that the new test description does not belong to
   any groups. If you do not specify this qualifier, the new test
   description belongs to the same group (or groups) as the previous
   test description.

 1. 2.6 - /LOG

   /LOG (D)
   /NOLOG

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

 1. 2.7 - /PROLOGUE

   /PROLOGUE=file-specification
   /NOPROLOGUE

   Determines whether a test prologue file is associated with the
   test description. The prologue file associated with the existing
   test description is also associated with the new test description.

   The /PROLOGUE qualifier causes the specified prologue file to
   replace the existing prologue file. The /NOPROLOGUE qualifier
   specifies that no prologue file be associated with the new test
   description.

 1. 2.8 - /REMARK

   /REMARK="string"
   /NOREMARK

   Determines whether a remark is associated with the new test
   description. By default, the remark associated with the new
   test description will be a copy of the remark associated with
   the existing test description. This remark is associated with the
   test description you are creating; it is not the remark logged
   with the COPY TEST_DESCRIPTION command.

   The /REMARK qualifier replaces the remark currently associated
   with the test description with the remark you specify. The
   /NOREMARK qualifier specifies that no remark be associated with
   the new test description.

 1. 2.9 - /TEMPLATE

   /TEMPLATE=file-specification
   /NOTEMPLATE

   If you do not specify this qualifier, the existing template
   file is copied for the new test. If you specify the /TEMPLATE
   qualifier, the existing template file is replaced by the specified
   template file. If you specify the /NOTEMPLATE qualifier, Digital Test
   Manager creates the template file name in the form test-name.COM
   for a noninteractive test and test-name.SESSION for an interactive
   or DECwindows test.

 1. 2.10 - /NOVARIABLES

   Specifies that no variables be associated with the new test
   description. If you do not specify this qualifier, the variables
   associated with the old test description are associated with the
   new test description.

 1.3 - Example

   DTM> COPY TEST_DESCRIPTION MAIL_TEST SHOW_ALL_TEST/PROLOGUE=NEWPRO.COM
   _Remark:SHOW ALL test with new prologue file
   %DTM-I-DEFAULTED, benchmark file name defaulted to SHOW_ALL_TEST.BMK
   %DTM-S-COPIED, test description MAIL_TEST copied
   -DTM-S-CREATED, test description SHOW_ALL_TEST created
   DTM>

   This example creates a copy of the existing test description,
   MAIL_TEST, and names the copy, SHOW_ALL_TEST. The prologue file
   named NEWPRO.COM is associated with the new test description.