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

1 - /BENCHMARK

   /BENCHMARK=file-specification

   Specifies the file to contain the expected output from the test's
   execution. Digital Test Manager supplies a file name of the form
   test-name.BMK. If your file specification includes a directory
   specification, it overrides the default benchmark directory
   for the library. Benchmark files may be located in the Digital Test
   Manager library, in another directory, or in a CMS library.

2 - /COMMAND

   /COMMAND="DCL-command"

   Specifies a command to be executed before the test is recorded or
   executed. Use this qualifier to start applications for inclusion
   in the test. This qualifier applies to DECwindows tests only.

3 - /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.

4 - /DECWINDOWS

   Specifies that the test being created is marked as a DECwindows
   test.

5 - /EPILOGUE

   /EPILOGUE=file-specification

   Adds the specified epilogue file to the test description. The
   test epilogue file is run immediately after the test template file
   is executed. This epilogue file is unrelated to the collection
   epilogue file.

   You cannot store epilogue files in the Digital Test Manager library;
   store them in another directory or in a CMS library.

6 - /FILTER

   /FILTER=(keyword,...)

   Available for interactive and noninteractive terminal tests only,
   the /FILTER qualifier selects one or more filters to remove
   run-time data from the result file that the test run produces.
   The valid values for keyword are as follows:

     Keyword       Filter

     ALL           Specifies that all the filters in this table be used

     DATE          Where the date form is abbreviated, the date filter
                   replaces date stamps by substituting a "d" for each
                   displayed number of the day of the month, an "m" for
                   each displayed letter of the month, and a "y" for
                   each displayed number of the year. Where the date
                   form is spelled out, the month name is replaced by
                   "month", the numeric day is replaced by "day", and
                   the year is replaced by "year".

                   The following list shows some examples of the date
                   filtering functions; this list is not all inclusive.

                     17-OCT-1998 with dd-mmm-yyyy
                     17 OCT 98 with dd mmm yy
                     98.OCT.17 with yy.mmm.dd
                     10/17/98 with mm/dd/yy
                     1998/10/17 with yyyy/mm/dd
                     October 17, 1998 with month day, year
                     Oct. 17, 1998 with month day, year
                     17.October.1998 with day.month.year
                     98-October-17 with year-month-day

     TIME          Replaces time stamps with the following forms:

                     15:37:53.22 with hh:mm:ss.xxxx
                     15:37:53 with hh:mm:ss
                     15:37 with hh:mm
                     3:37 PM with hh:mm xm
                     15H37m with hhHmmm
                     15H37' with hhHmm'
                     15.37 h with hh.mm h
                     15 h 37"53 s with hh h mm"ss s
                     15 h 37 min with hh h mm min
                     kl 15.37 with kl hh.mm
                     h 15.37 with h hh.mm

     FILE_NAMES    Replaces the file names with FILENAME.EXT

     DIRECTORIES   Replaces the directory specification field in
                   the file specification with DISK:[DIRECTORY]

     TRACE_BACK    Replaces 32-bit memory addresses with xxxxxxxx and
                   64-bit memory addresses with xxxxxxxx xxxxxxxx.

     VERSION       Replaces file versions with VERSION

   If you specify more than one keyword, separate the keywords with
   commas and enclose the list in parentheses. If you specify only
   one keyword, omit the parentheses.

7 - /INTERACTIVE

   /INTERACTIVE
   /NOINTERACTIVE (D)

   Specifies whether the test being created is marked as an
   interactive terminal test.

   The /INTERACTIVE qualifier marks a test description as containing
   an interactive terminal test. The /NOINTERACTIVE qualifier marks a
   test description as containing a noninteractive test.

8 - /LOG

   /LOG (D)
   /NOLOG

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

9 - /PROLOGUE

   /PROLOGUE=file-specification

   Adds the specified prologue file to the test description.

   The test prologue file is run immediately before the test
   template file is executed. This prologue file is unrelated to
   the collection prologue file.

   You cannot store prologue files in the Digital Test Manager library;
   store them in another directory or in a CMS library.

10 - /TEMPLATE

   /TEMPLATE=file-specification

   Specifies the command file that runs a test, the file containing
   an interactive terminal or DECwindows session. Digital Test Manager
   supplies a template file name of the form test-name.COM for
   noninteractive tests and test-name.SESSION for interactive and
   DECwindows tests. If your file specification includes a directory
   specification, Digital Test Manager ignores the default template
   directory.

   You cannot store template files that you create, except SESSION
   files, in the Digital Test Manager library; store them in another
   directory, or in a CMS library.

11 - /VARIABLE

   /VARIABLE=(variable-name[=variable-value],...)

   Enables you to associate existing variables with the test
   description you are creating. The variables you specify must
   be defined in the Digital Test Manager library by using the CREATE
   VARIABLE command. A variable associated with a test description
   by this qualifier is local in scope.

   The /VARIABLE qualifier also enables you to redefine values for
   the variables you specify. If you specify an optional value, the
   variable takes on that value only for this test description; the
   value of the original variable is unaffected.

   If you specify more than one variable name, separate the names
   with commas and enclose the list in parentheses. If you specify
   only one variable name, omit the parentheses. You cannot use
   wildcards.