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

   Format

     RENAME  input-file-spec output-file-spec
 

2  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
 

/LOG

      /LOG
      /NOLOG

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

/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.
 

/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.
 

/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.
 

2  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.