1 – COLLECTION
Deletes the specified collection and any associated difference and
result files from the Digital Test Manager library.
Format
DELETE COLLECTION collection-expression [/qualifier...]
"remark"
1.1 – Command Qualifiers
1.1.1 /CONFIRM
/CONFIRM (D) /NOCONFIRM Controls whether Digital Test Manager prompts you to confirm each deletion. Valid responses are Yes, No, All, or Quit.
1.1.2 /LOG
/LOG (D) /NOLOG Controls whether Digital Test Manager displays informational and success messages on your screen. The default is /LOG.
1.2 – Examples
1. DTM> DELETE COLLECTION MAIL_COLL "No longer needed"
Confirm deletion of collection MAIL_COLL [Y/N] (N): y
%DTM-I-DELETED, collection MAIL_COLL deleted
%DTM-S-DELETIONS, 1 deletion completed
DTM>
This example deletes the collection MAIL_COLL. The default
/CONFIRM qualifier is in effect.
2. DTM> DELETE COLLECTION *MAIL* "Deleting all MAIL collections"
Confirm deletion of collection MAIL_COLL [Y/N] (N): Y
%DTM-I-DELETED, collection MAIL_COLL deleted
Confirm deletion of collection DELETE_MAIL_COLL [Y/N] (N): Y
%DTM-I-DELETED, collection DELETE_MAIL_COLL deleted
%DTM-S-DELETIONS, 2 deletions completed
DTM>
This example deletes all the collections that contain MAIL
as part of their name. The default /CONFIRM qualifier is in
effect.
2 – GROUP
Deletes a group from the Digital Test Manager library.
Format
DELETE GROUP group-expression [/qualifier...] "remark"
2.1 – Restrictions
o You cannot delete a group if it contains any test descriptions
or other groups, or if it is a subgroup of another group. If
any test descriptions or groups are still in the group when you
issue the DELETE GROUP command, Digital Test Manager reports that
the specified group has not been deleted.
2.2 – Command Qualifiers
2.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.2 /LOG
/LOG (D) /NOLOG Controls whether Digital Test Manager displays informational and success messages on your screen.
2.3 – Examples
1. DTM> DELETE GROUP MAIL_NONINT/NOCONFIRM "Getting rid of this group"
%DTM-S-DELETED, group MAIL_NONINT deleted
DTM>
This example deletes the group MAIL_NONINT. You are not
prompted for confirmation because the /NOCONFIRM qualifier
is in effect.
2. DTM> DELETE GROUP * "Deleting all groups"
Confirm deletion of group MATH [Y/N] (N): ALL
%DTM-I-DELETED, group MATH deleted
%DTM-I-DELETED, group RELOP deleted
%DTM-I-DELETED, group VARS deleted
%DTM-S-DELETIONS, 3 deletions completed
DTM>
This example deletes all the groups in the library. The default
/CONFIRM qualifier is in effect. By typing ALL, you indicate
that all groups can be deleted without further requests for
confirmation.
3 – HISTORY
Deletes history information from the history file.
Format
DELETE HISTORY [/qualifier...] "remark"
3.1 – Command Qualifiers
3.1.1 /BEFORE
/BEFORE=time Deletes all history information from the history file dated prior to the specified date. The deleted information is replaced by a single entry stating that history information has been deleted from the history file. If you omit the /BEFORE qualifier, the default is to remove information that was logged prior to the time you enter the command. If you include the /BEFORE qualifier and do not specify a time, the default is TODAY. You can specify the time as an absolute, delta, or combination time value, or as one of the following keywords: TODAY, TOMORROW, or YESTERDAY. Digital Test Manager interprets TOMORROW as the time at which you enter the DELETE HISTORY command.
3.1.2 /CONFIRM
/CONFIRM (D) /NOCONFIRM Controls whether Digital Test Manager prompts you to confirm each deletion. Valid responses are Yes, No, All, or Quit.
3.1.3 /LOG
/LOG (D) /NOLOG Controls whether Digital Test Manager displays informational and success messages on your screen.
3.1.4 /OUTPUT
/OUTPUT[=file-specification] Sends output from the DELETE HISTORY command to the specified file. The output is written to a file called HISTORY.OUT in your current directory if you do not specify the /OUTPUT qualifier. If you specify the file name without the file type, the file type defaults to .LIS.
3.2 – Example
DTM> DELETE HISTORY /BEFORE=08-JAN "Deleting old information" Confirm DELETE HISTORY/BEFORE=8-Jan-1998 [Y/N] (N): Y %DTM-S-HISTDEL, 150 history records deleted DTM> This example deletes all history records in the history file recorded before January 8, 1998. The deleted information is replaced with the following record: * 8-JAN-1998 00:00:00 SMITH REMARK "PREVIOUS HISTORY DELETED"
4 – TEST_DESCRIPTION
Deletes a test description from the Digital Test Manager library.
Format
DELETE TEST_DESCRIPTION test-expression [/qualifier...]
"remark"
4.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.
4.2 – Command Qualifiers
4.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.
4.2.2 /LOG
/LOG (D) /NOLOG Controls whether Digital Test Manager displays informational and success messages on your screen.
4.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.
5 – VARIABLE
Deletes specified variables from the Digital Test Manager library.
Format
DELETE VARIABLE variable-expression [/qualifier...] "remark"
5.1 – Restrictions
o If you attempt to delete several variables and one or more
of them are associated with test descriptions, Digital Test
Manager deletes only those variables not associated with a
test description.
5.2 – Command Qualifiers
5.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.
5.2.2 /LOG
/LOG (D) /NOLOG Controls whether Digital Test Manager displays informational and success messages on your screen.
5.3 – Example
DTM> DELETE VARIABLE INPUT_FILE "Deleting variable INPUT_FILE" Confirm deletion of variable INPUT_FILE [Y/N] (N): y %DTM-S-DELETED, variable INPUT_FILE deleted. DTM> This example deletes the variable INPUT_FILE. The default /CONFIRM qualifier is in effect.