Provides a list of files or information  about  a  file  or  group  of
 files.   The  files must reside on a foreign volume, EXCHANGE does not
 list directories of Files-11 volumes.

 Format
           EXCHANGE>  DIRECTORY   [file-spec[,...]]

 Prompts
           None.

Additional information available:

ParametersDescriptionQualifiersExamples

 file-spec[,...]

      Specifies one or more files to  be  listed.   The  /VOLUME_FORMAT
      qualifier determines the syntax of a file specification.

      If  you  specify  more  than  one   file,   separate   the   file
      specifications with either commas (,) or plus signs (+).  You can
      use wild card characters in  the  directory  specification,  file
      name, file type, or version number fields of a file specification
      to list all files that satisfy the components you specify.

      The output of the DIRECTORY command depends on the volume  format
      and  on  certain formatting qualifiers and their defaults.  These
      qualifiers are:  /ALL, /BLOCKS, /BRIEF, /COLUMNS,  /DATE,  /FULL,
      /OCTAL,  and  /SIZE.   The files that are listed always appear in
      the order they appear in the volume directory, or the order  they
      are on a magnetic tape.

Additional information available:

/ALL/BADBLOCKS/BLOCKS/BRIEF/COLUMNS/DATE
/DELETED/FREE/FULL/OCTAL/OUTPUT/OWNER/PRINTER
/SIZE/SUMMARY/VOLUME_FORMAT

 /ALL
 /NOALL

      The /ALL qualifier is used to list all deleted or unused files on
      an  RT-11  volume,  in  addition  to  other files selected by the
      command.  For example, the command

           EXCHANGE> DIRECTORY  DMA0:*.MAC/ALL

      lists all MACRO-11 source files, plus deleted and unused files.

 /BADBLOCKS
 /NOBADBLOCKS

      The /BADBLOCKS qualifier initiates a scan of the volume to find
      any blocks which return read errors.  The data on the volume is
      not modified.  If a bad-block replacement table is present, the
      contents of  the table  will be  displayed.  This  is valid for
      RT-11 volumes only.

 /BLOCKS
 /NOBLOCKS

      The /BLOCKS qualifier lists the  starting  block  number  of  the
      file.   This  is  only valid for directories of block-addressable
      devices.  The first block of the device is block number 0.

 /BRIEF
 /NOBRIEF

      Includes only the file name of each file to  be  listed.   /BRIEF
      format is equivalent to /NODATE/NOSIZE.

 /COLUMNS=n

      Lists the files using the specified number  of  columns  on  each
      line  of the display.  This qualifier is used in conjunction with
      the /BRIEF qualifier  (either  explicitly  or  by  default).   By
      default,  the number of columns is dependent on the volume format
      and the information requested.  EXCHANGE DIRECTORY  will  attempt
      to  use  as  many  columns  as possible.  If too many columns are
      requested, a message will be printed and the  number  of  columns
      will be reduced to the number that will fit on the listing.

 /DATE
 /NODATE

      Includes the date  for  each  file  listed.   If  you  omit  this
      qualifier, the default is /DATE.

 /DELETED
 /NODELETED

      This qualifier lists a directory of files that have been  deleted
      from  an  RT-11  device,  but whose file name information has not
      been destroyed.

      The listing icludes the file names, types, sizes, creation  dates
      and  starting block numbers (in decimal unless /OCTAL is used) of
      the deleted files.  The file  names  that  print  also  represent
      tentative files.

      The /DELETED  qualifier  is  only  valid  with  block-addressable
      volumes with volume formats of RT11.

 /FREE
 /NOFREE

      The /FREE qualifier is  used  to  include  unused  areas  in  the
      directory  listing.   The /FREE qualifier is only valid with RT11
      format volumes.

      The /FULL qualifier lists all the available information for  each
      file.   The  exact  format  of  the listing depends on the volume
      format qualifier.

      The /FULL qualifier overrides the default brief listing format.

 /OCTAL
 /NOOCTAL

      Controls whether numeric information is  printed  in  decimal  or
      octal  format.   The  default is /NOOCTAL, numbers are printed in
      decimal radix.  Dates are always printed in decimal format.

 /OUTPUT[=file-spec]

      Requests that the DIRECTORY command output be written to the file
      specified  rather  than to the current SYS$OUTPUT device.  If you
      specify the /OUTPUT qualifier without a file  specification,  the
      output  is  directed to SYS$OUTPUT.  If you omit the file type in
      the file specification, the default file type  is  LIS.   If  you
      specify a file type and omit the file name, the default file name
      is EXCHDIRE.

      No wild card characters are allowed in the file specification.

 /OWNER
 /NOOWNER

      The /OWNER qualifier includes information about the owner of
      the  files.  For DOS-11 magtapes, the owner field is the UIC
      of the files owner.  For RT-11 disks, the owner  information
      is a single line listing the volume owner as recorded in the
      volume home block.

      Queues the command output for printing under the  name  given  by
      the  /OUTPUT  qualifier.   If  you  specify  /PRINTER without the
      /OUTPUT qualifier,  the  output  is  directed  to  a  file  named
      EXCHDIRE.LIS,  which  is  spooled  for printing automatically and
      then deleted.

 /SIZE
 /NOSIZE

      Provides the file size in blocks used for each file  listed.   If
      you omit this qualifier, the default is /SIZE.

 /SUMMARY
 /NOSUMMARY

      This  qualifier lists a  summary of the usage  of the directory
      segments for an RT-11 volume.  If a bad-block replacement table
      is present, the contents of the table will be displayed.

 /VOLUME_FORMAT=option

      The /VOLUME_FORMAT qualifier defines the physical format  of  the
      volume   to  be  processed.   The  default  format  qualifier  is
      dependent on the device type.  The default  is  /VOLUME=RT11  for
      block-addressable  devices mounted foreign, and /VOLUME=DOS11 for
      magnetic tape devices mounted foreign.  DIRECTORY  is  not  valid
      for devices mounted native.

           Option                       Function

           RT11           Identifies   an   RT-11   formatted    block-
                          addressable volume
           DOS11          Identifies a DOS-11 formatted  magnetic  tape
                          volume

      The volume format qualifier also determines  the  format  of  the
      directory listing.

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

                                      .
      1.  EXCHANGE>  DIRECTORY   DLA2:.OBJ/FULL

          The DIRECTORY command lists all files with the type  OBJ
          on  the  RT-11  volume mounted on DLA2:.  The file sizes
          and dates will be listed along with the names.

      2.  EXCHANGE>  DIRECTORY   MFA0:

          The DIRECTORY command lists all files on the DOS-11 tape
          mounted on MFA0:.

      3.  EXCHANGE>  DIRECTORY   DYA0:/BLOCKS

          The DIRECTORY command lists the  files  on  the  floppy,
          along  with  the  logical  block  number where each file
          starts.