Displays the contents of a file, a disk volume, or a magnetic tape
   volume in decimal, hexadecimal, or octal format, as well as the
   ASCII conversion.

   Format

     DUMP  filespec [,...]

Additional information available:

PARAMETERQUALIFIERS

Examples

filespec [,...]
   Specifies the file or name of the device being dumped.

   If the specified device is not a disk, a tape, or a network
   device, or if the device is mounted with the /FOREIGN qualifier,
   the file specification must contain only the device name.

   If the specified device is a network device, a disk device, or a
   tape device that is mounted without the /FOREIGN qualifier, the
   file specification can contain wildcards.

Additional information available:

/ALLOCATED/BLOCKS/BYTE/DECIMAL/FILE_HEADER
/FORMATTED/HEADER/HEXADECIMAL/LONGWORD
/NUMBER/OCTAL/OUTPUT/PRINTER/RECORDS/WORD

   Includes in the dump all blocks allocated to the file. (By
   default, the dump does not include blocks following the end-of-
   file [EOF].)

   You can specify the /ALLOCATED qualifier if the input is a disk
   that is mounted without the /FOREIGN qualifier. The /ALLOCATED and
   /RECORDS qualifiers are mutually exclusive.

      /BLOCKS[=(option[,...])]

   Dumps the specified blocks one block at a time, which is the
   default method for all devices except network devices.

   Block numbers are specified as integers relative to the beginning
   of the file. Typically, blocks are numbered beginning with 1. If a
   disk device is mounted the /FOREIGN qualifier, blocks are numbered
   beginning with zero. Select a range of blocks to be dumped by
   specifying one of the following options:

   START:n     Specifies the number of the first block to be dumped;
               the default is the first block.

   END:n       Specifies the number of the last block to be dumped;
               the default is the last block or the end-of-file (EOF)
               block, depending on whether you have specified the
               /ALLOCATED qualifier.

   COUNT:n     Specifies the number of files to be dumped. The COUNT
               option provides an alternative to the END option; you
               can not specify both.

   If you specify only one option, you can omit the parentheses.

   The /BLOCKS and /RECORDS qualifiers are mutually exclusive.

   Use the /BLOCKS qualifier to dump random blocks from Files-11
   volumes. This procedure requires LOG-IO (logical I/O) privilege.

   Formats the dump in bytes. The /BYTE, /LONGWORD, and /WORD
   qualifiers are mutually exclusive. The default format is composed
   of longwords.

   Dumps the file in decimal radix. The /DECIMAL, /HEXADECIMAL
   (default), and /OCTAL qualifiers are mutually exclusive.

   Dumps each data block that is a valid Files-11 header in Files-11
   header format rather than in the selected radix and length
   formats.

      /FORMATTED (default)
      /NOFORMATTED

   Dumps the file header in Files-11 format; the /NOFORMATTED
   qualifier dumps the file header in octal format. This qualifier is
   useful only when the /HEADER qualifier is specified.

   Dumps the file header and access control list (ACL). To dump
   only the file header, and not the file contents, also specify
   /BLOCK=(COUNT:0). The /HEADER qualifier is invalid for devices
   mounted the /FOREIGN qualifier.

   Use the /FORMATTED qualifier to control the format of the display.

   You can use the /FILE_HEADER qualifier with the /HEADER
   qualifier to have Files-11 file headers printed in an interpreted
   representation.

   By default, the file header is not displayed.

      /HEXADECIMAL (default)

   Dumps the file in hexadecimal radix. The /DECIMAL, /HEXADECIMAL
   (default), and /OCTAL qualifiers are mutually exclusive.

      /LONGWORD (default)

   Formats the dump in longwords. The /BYTE, /LONGWORD, and /WORD
   qualifiers are mutually exclusive.

      /NUMBER[=n]

   Specifies how byte offsets are assigned to the lines of output.
   If you specify the /NUMBER qualifier, the byte offsets increase
   continuously through the dump, beginning with n; if you omit the
   /NUMBER qualifier, the first byte offset is zero. By default, the
   byte offset is reset to zero at the beginning of each block or
   record.

   Dumps the file in octal radix. The /DECIMAL, /HEXADECIMAL
   (default), and /OCTAL qualifiers are mutually exclusive.

      /OUTPUT[=filespec]

   Specifies the output file for the dump. If you do not specify
   a file specification, the default is the file name of the file
   being dumped and the file type DMP. If the /OUTPUT qualifier is
   not specified, the dump goes to SYS$OUTPUT. No wildcard characters
   are allowed. The /OUTPUT and /PRINTER qualifiers are mutually
   exclusive.

   Queues the dump to SYS$PRINT in a file named with the file
   name of the file being dumped and the file type DMP. If the
   /PRINTER qualifier is not specified, the dump goes to SYS$OUTPUT.
   No wildcard characters are allowed. The /OUTPUT and /PRINTER
   qualifiers are mutually exclusive.

      /RECORDS[=(option[,...])]

   Dumps the file a record at a time rather than a block at a time.
   (By default, input is dumped one block at a time for all devices
   except network devices.)

   Blocks are numbered beginning with 1.

   Select a range of blocks to be dumped by specifying one of the
   following options:

   START:n     Specifies the number of the first record to be dumped;
               the default is the first record.

   END:n       Specifies the number of the last record to be dumped;
               the default is the last record of the file.

   COUNT:n     Specifies the number of records to be dumped. The
               COUNT option provides an alternative to the END
               option; you can not specify both.

   If you specify only one option, you can omit the parentheses.

   If you specify the /RECORDS qualifier, you cannot specify the
   /ALLOCATED or the /BLOCKS qualifier.

   Formats the dump in words. The /BYTE, /LONGWORD, and /WORD
   qualifiers are mutually exclusive.

   1.  $ DUMP TEST.DAT
       Dump of file DISK0:[NORMAN]TEST.DAT;1 on 19-APR-1990 15:43:26.08
       File ID (3134,818,2)   End of file block 1 / Allocated 3
       Virtual block number 1 (00000001), 512 (0200) bytes
        706D6173 20612073 69207369 68540033 3.This is a samp 000000
        73752065 62206F74 20656C69 6620656C le file to be us 000010
        61786520 504D5544 2061206E 69206465 ed in a DUMP exa 000020
        00000000 00000000 0000002E 656C706D mple............ 000030
        00000000 00000000 00000000 00000000 ................ 000040
        00000000 00000000 00000000 00000000 ................ 000050
        00000000 00000000 00000000 00000000 ................ 000060
                 .
                 .
                 .
        00000000 00000000 00000000 00000000 ................ 0001E0
        00000000 00000000 00000000 00000000 ................ 0001F0

     The DUMP command displays the contents of TEST.DAT both in
     hexadecimal longword format and in ASCII beginning with the
     first block in the file.

   2.  $ DUMP TEST.DAT/OCTAL/BYTE
       Dump of file DISK0:[NORMAN]TEST.DAT;1 on 19-APR-1990 15:45:33.58
       File ID (74931,2,1)   End of file block 1 / Allocated 3
       Virtual block number 1 (00000001), 512 (0200) bytes
        151 040 163 151 150 124 000 063 3.This i 000000
        160 155 141 163 040 141 040 163 s a samp 000010
        040 145 154 151 146 040 145 154 le file  000020
        163 165 040 145 142 040 157 164 to be us 000030
        040 141 040 156 151 040 144 145 ed in a  000040
        141 170 145 040 120 115 125 104 DUMP exa 000050
        377 377 000 056 145 154 160 155 mple.... 000060
        000 000 000 000 000 000 000 000 ........ 000070
        000 000 000 000 000 000 000 000 ........ 000100
        000 000 000 000 000 000 000 000 ........ 000110
                 .
                 .
                 .
        000 000 000 000 000 000 000 000 ........ 000760
        000 000 000 000 000 000 000 000 ........ 000770

     The DUMP command displays the image of the file TEST.DAT,
     formatted both in octal bytes and in ASCII characters beginning
     with the first block.


   3.  $ DUMP NODE3::DISK2:[STATISTICS]RUN1.DAT

     This command line dumps the file RUN1.DAT that is located at
     remote node NODE3. The default DUMP format will be used.