VMS Help EXCHANGE, RENAME  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Changes the file specification of an existing file on an RT-11
    volume.

    Format

      RENAME  input-file-spec output-file-spec

1 - Parameters

 input-file-spec

    Specifies the names of one or more files whose specifications are
    to be changed.

    You can use wildcard characters in the file name and file type
    specification; if you do, all files that satisfy the specified
    fields are renamed.

 output-file-spec

    Provides the new file specification to be applied to the input
    file. The RENAME command uses the file name and file type of the
    input file specification to provide defaults for nonspecified
    fields in the output file.

    You can specify an asterisk (*)  in place of the file name
    or file type of the output file; the RENAME command uses the
    corresponding field in the input file specification to name the
    output file. Specifying wildcard characters in corresponding
    fields of the input and output file specifications results in
    multiple rename operations.

    You can omit the device name from the output specification.
    EXCHANGE uses the device name specified for the input, since
    it is not possible to rename a file from one device to another.

2 - Qualifiers

 2.1 - /LOG

       /LOG
       /NOLOG

    Controls whether the RENAME command displays the file
    specification of each file that it renames. The default is
    /NOLOG.

 2.2 - /PROTECT

       /PROTECT
       /NOPROTECT

    Determines whether protection is set for an RT-11 output file.
    The default is /NOPROTECT.

    This qualifier is not valid for Files-11 or DOS-11 output files.
    Protection attributes for Files-11 output are taken from the
    current process default protection.

    EXCHANGE does not attempt to transfer protection attributes
    from the input file to the output file. Protection mechanisms
    of various operating systems do not readily translate to one
    another.

    The owner UIC of the output file is the UIC of the current
    process.

 2.3 - /SYSTEM

       /SYSTEM
       /NOSYSTEM

    Controls whether the RENAME command renames files that have the
    file type SYS. These files are usually files necessary for the
    operation of an RT-11 system. Only RT-11 volumes handle SYS files
    in this manner.

    The default is /NOSYSTEM; the RENAME command does not rename an
    RT-11 file with the type SYS, whether it is matched by a wildcard
    specification or is named explicitly. EXCHANGE displays a message
    when it skips an SYS file during a rename operation.

    EXCHANGE handles files with the file type BAD in a similar
    manner; that is, the rename operation skips BAD files. However,
    EXCHANGE does not warn that BAD files are being skipped, and the
    /SYSTEM qualifier has no effect on BAD files. To rename a file
    with the type BAD, specify the file explicitly instead of using
    wildcards.

 2.4 - /VOLUME_FORMAT

       /VOLUME_FORMAT=option

    Defines the physical format of the volume to be processed.
    EXCHANGE supports the RENAME command on RT-11 volumes only.

3 - Examples

    1.EXCHANGE> RENAME DMA0:AVERAG.OBJ MEAN

      The command in this example changes the file name of the file
      AVERAG.OBJ to MEAN.OBJ.

    2.EXCHANGE> RENAME DLA2:*.TXT *.OLD

      The command in this example renames all files with the file
      type TXT to files with the file type OLD; the file names are
      not changed.

    3.EXCHANGE> RENAME/LOG   DMA0:DATA.*   NEW
      %EXCHANGE-I-RENAMED, _DMA0:DATA.AAA renamed to _DMA0:NEW.AAA
      %EXCHANGE-I-RENAMED, _DMA0:DATA.BBB renamed to _DMA0:NEW.BBB
      %EXCHANGE-I-RENAMED, _DMA0:DATA.CCC renamed to _DMA0:NEW.CCC

      The command in this example illustrates wildcard characters in
      the input file names. The device DMA0 contains three files with
      the file name DATA; the result is the renaming of all three
      files as displayed by the /LOG qualifier.