Changes the file  specification  of  an  existing  file  on  a  block-
 addressable foreign volume.

 Format
         EXCHANGE>  RENAME   input-file-spec   output-file-spec

 Prompts
         From:  input-file-spec
         To:    output-file-spec

Additional information available:

ParametersQualifiersExamples

 input-file-spec

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

      You can use wild card characters in the file name and  file  type
      specification.   In  this  case,  all  files whose specifications
      satisfy the fields that are specified 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-spec parameter;  the RENAME command uses
      the corresponding field in the input file specification  to  name
      the output file.  Wild card characters in corresponding fields of
      the input and output file specification result in multiple rename
      operations.

      The device name can be omitted  from  the  output  specification.
      EXCHANGE  will use the device name specified for the input, since
      it is impossible to rename a file from one device to another.

Additional information available:

/LOG/SYSTEM/VOLUME_FORMAT

 /LOG
 /NOLOG

      Controls  whether  the   RENAME   command   displays   the   file
      specification of each file that it renames.

      By default, the RENAME command does  not  display  the  names  of
      files after it renames them.

 /SYSTEM
 /NOSYSTEM

      Controls whether the EXCHANGE RENAME command renames files  which
      have a file extension of ".SYS".  These files are typically files
      which are necessary for the operation of an RT-11  system.   Only
      RT-11 volumes treat .SYS files in this special manner.

      By default, the RENAME command will not rename an RT-11 file with
      a  .SYS  extension,  whether  it is matched by a wildcard spec or
      explicitly named.  EXCHANGE will  print  a  message  whenever  it
      skips over a a .SYS file during a rename operation.

      EXCHANGE also treats files with ".BAD" extensions as special, but
      the /SYSTEM qualifier does not affect the operations against .BAD
      files.  To rename a .BAD file, specify the  filename  explicitly,
      rather  than  using  wildcards.  EXCHANGE does not warn that .BAD
      files are being skipped.

 /VOLUME_FORMAT=option

      The /VOLUME_FORMAT qualifier defines the physical format  of  the
      volume  to  be  processed.   Currently RT-11 volumes are the only
      volumes on which RENAME is supported.

           Option                       Function

           RT11           Identifies   an   RT-11   formatted    block-
                          addressable volume

      See section 6.0 for a complete description of the  /VOLUME_FORMAT
      qualifier and the defaults.

      1.  EXCHANGE>  RENAME  DMA0:AVERAG.OBJ  MEAN

          The  RENAME  command  changes  the  file  name  of  the  file
          AVERAG.OBJ to MEAN.OBJ.

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

          The RENAME command renames all files with file types  of  TXT
          to have file types of 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

          Three files exist with the file name of  DATA.   This  RENAME
          command  illustrates  wild  card characters in the input file
          names.  The result is the renaming  of  all  three  files  as
          displayed by the /LOG qualifier.