HELP RENAME — MicroVMS 4.6
Changes all or part of a file specification(s). Format RENAME input-file-spec,... output-file-spec
Additional information available:
Parameters
input-file-spec Specification(s) of file(s) to be renamed. Wildcard characters are allowed. output-file-spec New file specification. Wildcard characters are allowed. Parts of the output file specification which are omitted or replaced by wildcard characters default to the corresponding parts of the input file specification, except for the version number. A version number is determined (1) by the output file version number if specified explicitly, (2) by the input file version if a wildcard is used for the input or output file type, or (3) by the next higher version number or a version number of 1 if the version number is not specified.
Qualifiers
Additional information available:
/BACKUP/BEFORE/BY_OWNER/CONFIRM/CREATED/EXCLUDE(
/EXPIRED/LOG/MODIFIED/NEW_VERSION/SINCE
/BACKUP
/CREATED (default) /EXPIRED /MODIFIED Selects files for the rename 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]
Renames only those files with dates (creation, modification, expiration, or backup) that precede 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]
Renames 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 file is renamed. The following responses are valid: +----------+-----------------------------------------------+ | YES | Rename the file | +----------+-----------------------------------------------+ | NO | Do not rename the file | +----------+-----------------------------------------------+ | TRUE | Rename the file | +----------+-----------------------------------------------+ | FALSE | Do not rename the file | +----------+-----------------------------------------------+ | 1 | Rename the file | +----------+-----------------------------------------------+ | 0 | Do not rename the file | +----------+-----------------------------------------------+ | <RETURN> | Rename the file | +----------+-----------------------------------------------+ | 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.
/EXCLUDE(=file-spec,...)
Excludes the specified file(s) from the rename operation. 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.
/LOG
/NOLOG (default) Displays the file specification of each file as it is renamed.
/MODIFIED
See /BACKUP.
/NEW_VERSION (default)
/NONEW_VERSION Assigns a new version number if an output file specification is the same as that of an existing file. The /NONEW_VERSION qualifier displays an error message if an output file specification is the same as that of an existing file.
/SINCE[=time]
Renames only those files dated (ceation, 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.