Copyright Digital Equipment Corp. All rights reserved.
Command_Qualifiers
/BENCHMARK
/BENCHMARK=file-specification
/NOBENCHMARK
Specifies whether the benchmark file should be replaced or
disassociated from a test description.
The /BENCHMARK qualifier adds the specified benchmark file
specification to the test description. This benchmark file
supersedes any benchmark currently associated with the test
description.
The new file specification cannot contain a directory
specification that points to the Digital Test Manager library.
However, you can use DTM$LIB without a file name. The new file
specification can specify a directory (other than the Digital Test
Manager library) or a CMS library. The new file specification
overrides any benchmark directory specified with an earlier
CREATE TEST_DESCRIPTION command.
The new file specification need not specify the same type of
directory as the file specification you are overriding. For
example, if you have been storing your benchmark files in a CMS
library, you can specify a directory that is not a CMS library.
If you specify a file name for a benchmark file that does not
exist, Digital Test Manager treats the test like a new test when a
collection that contains this test executes. When a benchmark
file is created, it will have the file name you specify.
The /NOBENCHMARK qualifier removes the benchmark file
specification from the test description and replaces it with
the default, test-name.BMK.
/COMMAND
/COMMAND="DCL-command"
/NOCOMMAND
Specifies a new command to be executed before the recording
and execution of a DECwindows test begins. If you specify the
/NOCOMMAND qualifier, the command is disassociated from the test
description. The qualifier applies to DECwindows tests only.
/COMPARISON_TYPE
/COMPARISON_TYPE=keyword
Specifies how the result and benchmark files are to be compared.
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.
The /NOCOMPARISON_TYPE qualifier disassociates any comparison type
from the test description.
/EPILOGUE
/EPILOGUE=file-specification
/NOEPILOGUE
Specifies whether the test epilogue file should be replaced or
disassociated from a test description.
The /EPILOGUE qualifier adds the specified test epilogue file
specification to the test description. The test epilogue file
is run whenever the test description is run; it does not affect
any collection epilogue file run with the test. The /NOEPILOGUE
qualifier removes the current test epilogue file specification
from the test description.
/FILTER
/FILTER=(keyword,...)
/NOFILTER=(keyword,...)
Selects one or more filters to remove run-time variables from the
result file produced from the collection run. The following table
shows the valid values for keywords:
Filter type Description
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. The /FILTER qualifier
associates the specified filters with the test description.
The /NOFILTER qualifier removes the specified filters from the
test description.
Digital Test Manager does not replace the filters associated with the
test description.
/LOG
/LOG (D)
/NOLOG
Controls whether Digital Test Manager displays informational and
success messages on your screen.
/PROLOGUE
/PROLOGUE=file-specification
/NOPROLOGUE
Specifies whether the test prologue file should be replaced or
disassociated from the test description.
The /PROLOGUE qualifier adds the specified test prologue file
specification to the test description. The test prologue is run
whenever the test description is run and does not affect any
collection prologue run with the test. The /NOPROLOGUE qualifier
removes the current test prologue file specification from the test
description.
/REMARK
/REMARK="string"
/NOREMARK
Specifies whether to replace or delete the remark associated with
the test description.
The /REMARK qualifier associates the specified remark with the
test description being modified. This string replaces any previous
remark. The remark parameter specifies the remark associated with
this MODIFY TEST_DESCRIPTION command and is logged with it in the
history file.
The /NOREMARK qualifier deletes the remark string from the test
description.
/TEMPLATE
/TEMPLATE=file-specification
/NOTEMPLATE
Specifies whether to replace or disassociated from the template
file. A test description must always have a template file.
/VARIABLE
/VARIABLE=(variable-name[=variable-value],...)
Enables you to associate existing variables with the test
description you are modifying. 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.
The /NOVARIABLE qualifier disassociates the specified variables
from the test description.