Changes specified field values in existing test descriptions.
Format
MODIFY TEST_DESCRIPTION test-group-expression [/qualifier...]
"remark"
1 – Restrictions
o The /COMMAND qualifier applies to DECwindows tests only.
o The /FILTER qualifier applies to noninteractive and terminal
tests only.
2 – Command Qualifiers
2.1 /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.
2.2 /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.
2.3 /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.
2.4 /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.
2.5 /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.
2.6 /LOG
/LOG (D) /NOLOG Controls whether Digital Test Manager displays informational and success messages on your screen.
2.7 /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.
2.8 /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.
2.9 /TEMPLATE
/TEMPLATE=file-specification /NOTEMPLATE Specifies whether to replace or disassociated from the template file. A test description must always have a template file.
2.10 /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.
3 – Parameter Qualifiers
3.1 /GROUP
Identifies the immediately preceding item in the parameter as a group expression. The default is /TEST_DESCRIPTION. If a test group expression comprises a list, use this qualifier after each item that designates a group.
3.2 /TEST_DESCRIPTION
Identifies the immediately preceding item in the parameter as a test expression. This is the default.
4 – Examples
1. DTM> MODIFY TEST_DESCRIPTION RMTEST/BENCHMARK=RMTEST.BMK
_Remark: Replacing old benchmark file
%DTM-S-MODIFIED, test description RMTEST modified.
DTM>
This example replaces a benchmark file specification for the
test description RMTEST.
2. DTM> MODIFY TEST_DESCRIPTION SEND_MAIL_TEST -
_DTM> /NOBENCHMARK/TEMPLATE=NEWSENDTEST.COM
_Remark: Replacing template file and removing benchmark file
%DTM-S-MODIFIED, test description SEND_MAIL_TEST modified.
DTM>
This example replaces the template file specification for
the test description SEND_MAIL_TEST and removes the existing
benchmark file specification.