Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Qualifiers

/BACKUP

/BEFORE

/BY_OWNER

/CONFIRM

/CREATED

/EXCLUDE(

/EXPIRED

/LOG

/MODIFIED

/NEW_VERSION

/SINCE

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:

ParametersQualifiers

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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026