HELP PURGE — MicroVMS 4.5B
Deletes all but the highest-numbered versions of the specified files. Format PURGE [file-spec,...]
Additional information available:
Parameters
file-spec Specification(s) of file(s) to be purged. Wildcard characters are allowed in the directory, file name, and file type fields. Plus signs can be used instead of commas between file specifications. No version number can be specified. The default is all files in the current default directory.
Qualifiers
Additional information available:
/BACKUP/BEFORE/BY_OWNER/CONFIRM/CREATED/ERASE
/EXCLUDE(/EXPIRED/KEEP/LOG/MODIFIED/SINCE
/BACKUP
/CREATED (default) /EXPIRED /MODIFIED Selects files for the purge operation according to the dates of their most recent backups, their creation dates, their expiration dates, or the dates of their last modifications. Relevant only with the /BEFORE and /SINCE qualifiers.
/BEFORE[=time]
Purges only those files created or modified before the specified time. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, and YESTERDAY.
/BY_OWNER[=uic]
Purges only those files with the specified user identification code. The default uic is that of the current process.
/CONFIRM
/NOCONFIRM (default) Issues a request for confirmation before each purge. The following responses are valid: +----------+-----------------------------------------------+ | YES | Purge | +----------+-----------------------------------------------+ | NO | Do not purge | +----------+-----------------------------------------------+ | TRUE | Purge | +----------+-----------------------------------------------+ | FALSE | Do not purge | +----------+-----------------------------------------------+ | 1 | Purge | +----------+-----------------------------------------------+ | 0 | Do not purge | +----------+-----------------------------------------------+ | <RETURN> | Purge | +----------+-----------------------------------------------+ | ALL | Continue execution of the command with no | | | further confirmation prompts | +----------+-----------------------------------------------+ | <CTRL/Z> | Stop execution of the command | +----------+-----------------------------------------------+ | QUIT | Stop execution of the command | +----------+-----------------------------------------------+
/CREATED (default)
See /BACKUP.
/ERASE
/NOERASE (default) Erases the specified file(s) from the disk so that the purged data no longer exists physically on the deallocated disk blocks.
/EXCLUDE(=file-spec,...)
Excludes files from the purge. The qualifier value file-spec cannot include a device name. Wildcard characters are supported for file specifications. However, you cannot use relative version numbers to exclude a specific version.
/EXPIRED
See /BACKUP.
/KEEP=number-of-versions
Retains the specified number of versions (starting with the highest) of each file. The default is 1.
/LOG
/NOLOG (default) Displays the file specifications of the files as they are purged.
/MODIFIED
See /BACKUP.
/SINCE[=time]
Selects for purging only those files dated (creation, modification, expiration, or backup) after the specified time. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, and YESTERDAY.