HELP DUMP — MicroVMS 4.6
Displays the contents of a file, disk volume, or magnetic tape volume in decimal, hexadecimal, or octal format, as well as the ASCII conversion. Format DUMP file-spec Requires the Common Utilities Option.
Additional information available:
Parameters
file-spec Specification of the file or name of the device being dumped.
Qualifiers
Additional information available:
/ALLOCATED/BLOCKS/BYTE/DECIMAL/FILE_HEADER
/FORMATTED/HEADER/HEXADECIMAL/LONGWORD
/NUMBER/OCTAL/OUTPUT/PRINTER/RECORDS/WORD
/ALLOCATED
Includes in the dump all blocks allocated to the file. (By default, the dump does not include blocks following the end-of-file.) /ALLOCATED and /RECORDS are mutually exclusive.
/BLOCKS=(START:n,END:n,COUNT:n)
Dumps the specified blocks. 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 /FOREIGN, blocks are numbered beginning with 0. START specifies the number of the first block to be dumped; the default is the first block. END specifies the number of the last block to be dumped; the default is the last block or the end-of-file block, depending on the /ALLOCATED qualifier. COUNT specifies the number of files to be dumped; provides an alternative to END. /BLOCKS and /RECORDS are mutually exclusive.
/BYTE
Formats the dump in bytes. /BYTE, /LONGWORD, and /WORD are mutually exclusive.
/DECIMAL
Dumps the file in decimal radix. /DECIMAL, /HEXADECIMAL, and /OCTAL are mutually exclusive.
/FILE_HEADER
Dumps each data block that is a valid Files-11 header in Files-11 header format rather than the selected radix and length.
/FORMATTED (default)
/UNFORMATTED Dumps the file header in Files-11 format; /UNFORMATTED dumps the file header in octal format. This qualifier is useful only when /HEADER is specified.
/HEADER
Dumps the file header and access control list. To dump only the file header, also specify /BLOCK=(COUNT:0). /HEADER is invalid for devices mounted /FOREIGN.
/HEXADECIMAL (default)
Dumps the file in hexadecimal radix. /DECIMAL, /HEXADECIMAL, and /OCTAL are mutually exclusive.
/LONGWORD (default)
Formats the dump in longwords. /BYTE, /LONGWORD, and /WORD are mutually exclusive.
/NUMBER[=n]
Specifies how byte offsets are assigned to the lines of output. If you specify /NUMBER, the byte offsets increase continuously through the dump, beginning with n; if you omit /NUMBER, the first byte offset is 0. By default, the byte offset is reset to 0 at the beginning of each block or record.
/OCTAL
Dumps the file in octal radix. /DECIMAL, /HEXADECIMAL, and /OCTAL are mutually exclusive.
/OUTPUT[=file-spec]
Specifies the output file. The default is the file name of the file being dumped and the file type DMP. If this qualifier is not specified, the dump goes to SYS$OUTPUT. No wild card characters are allowed. /OUTPUT and /PRINTER are mutually exclusive.
/PRINTER
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 this qualifier is not specified, the dump goes to SYS$OUTPUT. No wild card characters are allowed. /OUTPUT and /PRINTER are mutually exclusive.
/RECORDS[=START:n,END:n,COUNT:n]
Dumps the file a record at a time rather than a block at a time. Records are number beginning with 1. START specifies the number of the first record to be dumped; the default is the first record. END specifies the number of the last record to be dumped; the default is the last record. COUNT specifies the number of records to be dumped; provides an alternative to END. If you specify /RECORDS, you cannot specify /ALLOCATED or /BLOCKS.
/WORD
Formats the dump in words. /BYTE, /LONGWORD, and /WORD are mutually exclusive.