Deletes all or part of the library history.
Format:
DELETE HISTORY "remark"
1 – Command Parameters
remark
Specifies a character string to be logged in the history file
with this command, usually used to explain why the command was
entered. The remark is enclosed in quotation marks. If no remark
was entered, a null remark ("") is logged.
2 – Description
The DELETE HISTORY command deletes all or part of the library
history. By default, CMS writes the deleted history records to
a file named HISTORY.DMP in your current default directory. CMS
cannot access this file as a history file.
The DELETE HISTORY command does not delete the library creation
history record.
Whenever you delete some of the library history, CMS records two
transactions. As with other commands that modify the contents of
the library, CMS records the deletion transaction. In addition,
CMS logs a REMARK transaction at the point that corresponds to
the /BEFORE value. If you do not specify the /BEFORE qualifier,
the default is /BEFORE=current-time. The REMARK transaction
record includes the following remark: "PREVIOUS HISTORY DELETED".
Both the REMARK and the DELETE HISTORY transactions are unusual
transactions. When you use the SHOW HISTORY command, CMS
identifies unusual transactions by displaying an asterisk (*)
in the first column of the transaction record.
3 – Qualifiers
3.1 /BEFORE=date-time
Deletes all of the history information before a specified time. A
single entry is made in the history file specifying that a section
of the history data has been removed. This entry is made at the
location in the history file where the lines were deleted.
The time value can be an absolute, delta, or combination time
value, or one of the following keywords: TODAY, TOMORROW, or
YESTERDAY. If the time value is a future value, CMS uses the
current time.
3.2 /CONFIRM (D)
Controls whether CMS prompts you for confirmation before each
transaction.
When you run CMS in interactive mode, CMS prompts you for
confirmation. If you type YES, ALL, TRUE, or 1, CMS executes the
transaction. If you type NO or QUIT or press RETURN, no action
is performed. If you type any other character, CMS continues to
prompt until you type an acceptable response.
CMS does not prompt for confirmation in batch mode.
3.3 /LOG (D)
Controls whether CMS displays success and informational messages
on the default output device. By default, if the command executes
successfully, CMS displays a success message. If you specify
/NOLOG, success and informational messages are suppressed. Any
warning, error, or fatal error messages are displayed regardless
of whether /LOG or /NOLOG is specified.
3.4 /OCCLUDE[=option,...]
Controls whether CMS selects the first instance of the specified
object, or all instances of the specified object in the library
search list. The options field contains one or more keywords
associated with the name of the object. The options field can
contain the following keywords:
ALL--equivalent to OTHER
OTHER (D)
NOOTHER
NONE--equivalent to NOOTHER
You can specify either ALL, NONE, or the [NO]OTHER keyword.
By default, CMS performs occlusion for all objects; that is, CMS
selects only the first occurrence of a specified object.
3.5 /OBJECT=object-expression
Specifies an object about which history information is to be
deleted. The object expression can be one or more class names,
element names, group names, a wildcard expression, or a list of
any of these, separated by commas. If you do not specify an object
expression, CMS deletes all classes, elements, and group
transaction records in the library subject to the constraints
imposed by other qualifiers.
3.6 /OUTPUT[=file-specification]
Directs CMS to write output to the specified file. If you omit the
/OUTPUT qualifier (or if you specify /OUTPUT but do not provide a
file specification), CMS creates a file named HISTORY.DMP in your
current default directory.
3.7 /TRANSACTIONS=(keyword,...)
3.8 /NOTRANSACTIONS=(keyword,...)
Deletes all transaction records generated by a specific command.
You can specify the following keywords with this qualifier:
ACCEPT FETCH REMOVE
ALL INSERT REPLACE
CANCEL MARK RESERVE
COPY MODIFY REVIEW
CREATE REJECT SET
DELETE REMARK UNRESERVE
VERIFY
If you specify more than one keyword, you must enclose the keyword
list in parentheses. The /TRANSACTIONS qualifier directs CMS
to delete transaction records for only the listed keywords. The
/NOTRANSACTIONS qualifier directs CMS to delete transaction records
for all keywords except the listed keywords. If you omit the
/TRANSACTIONS qualifier (or if you specify /TRANSACTIONS but do
not provide any keywords), CMS deletes transaction records for all
transaction types.
3.9 /USER=username
Deletes all transaction records created by the specified user.
4 – Example
CMS> DELETE HISTORY/BEFORE=TODAY "old history in HISTORY.DMP"
Confirm DELETE HISTORY/BEFORE=10-MAY-1988 [Y/N] (N): y
%CMS-S-HISTDEL, 89 history records deleted
This example deletes all of the library history prior to
the current day. The following shows the first few records
contained in the HISTORY.DMP file:
Deleted dump for CMS Library DISKX:[PROJECT.CMSLIB]
6-MAR-1988 17:07:50 SNAKE CREATE ELEMENT OUTPUT.FOR
"ASCII format"
6-MAR-1988 17:26:10 MARTIN CREATE ELEMENT INIT.FOR
"init routines"
8-MAR-1988 12:33:09 LISA RESERVE INIT.FOR(1) "change
header offset"
9-MAR-1988 17:34:04 LISA REPLACE INIT.FOR(2) "header
offset and additional free space added"
.
.
.
The CREATE LIBRARY transaction is not deleted from the library
history.