Trailing-Edge
-
PDP-10 Archives
-
BB-L289B-RK
-
dmp.mem
There is 1 other file named dmp.mem in the archive. Click here to see a list.
File Dump Utility (DMP)
1.0 INTRODUCTION TO DMP
The File Dump utility (DMP) program produces a printed listing of
the contents of a file or volume. The listing can be directed to
any suitable output device such as line printer, terminal, DECtape,
floppy, or disk. DMP runs in two modes, file mode or device mode.
In file mode, one input file is specified and all, or a specified
range (see /BL:n:m) of virtual blocks, of the named file is dumped.
The input device must be a Files-11 structured volume and must be
mounted via the MOU task.
A virtual block refers to a relative block of data in a file.
Virtual blocks are numbered from 1 through n, where n is the total
number of virtual blocks of the file.
In device mode, only the device is specified, and a specified range
(/BL:n:m) of logical blocks is dumped. /BL:n:m switch is a required
parameter.
A logical block refers to the actual 512-byte block on disk, floppy,
and DECtape. DMP will handle physical records up to 2048 bytes in
length. Logical blocks are numbered from 0 to n-1, where n is the
total number of logical blocks on the device.
Under RSX20F, the volume to be dumped must not be mounted.
DMP can be invoked by using that PARSER's RUN command.
2.0 DMP COMMAND STRINGS
Enter DMP command strings in the following format:
outfile=infile/switch
File specifications are of the form:
dev:[group,member]filename.ext;version
For a complete description refer to the RSX-11M documentation.
Page 2
3.0 DMP SWITCHES
DMP switch specifications consist of a slash (/) followed by a two
character switch name, optionally followed by a value, which is
separated from the switch by a colon (:). DMP functions are
implemented by means of the eleven switches listed below.
Switch Description
Default Word mode octal dump.
/AS Specifies that the data should be dumped in ASCII
mode. The control characters (0-37) are printed
as ^ followed by the alphabetic character
corresponding to the character code +100.
/BA:n:m Specifies a 2-word base block address, where
n=high-order base block address (octal), and
m=low-order base block base block address (octal).
When specified, all future block numbers will be
added to this value to obtain an effective block
number.
/BL:n:m Specifies the range of blocks to be dumped, where
n is the first block and m is the last block.
If the /BL :n:m switch is specified in file mode,
it specifies the range of virtual blocks to be
dumped. If the /BL:n:m switch is specified as
/BL:0 in file mode, no virtual blocks are dumped.
The is useful for dumping only the header portion
of the file (see /HD).
The /BL:n:m switch is a required parameter in
device mode. When used in device mode it specifies
the range of logical blocks to be dumped.
/BY The /BY switch specifies that the data should be
dumped in byte octal format.
/DC Specifies that the data should be dumped in decimal
word format.
/HD This switch is an optional parameter to be used in
file mode. If specified, the /HD switch causes the
file header as well as the specified portion of the
file to be dumped.
Page 3
If you want only the header portion of the file to
be dumped, specify:
/HD/BL:0
The file header is described in an appendix in the
IAS/RSX-11 I/O Operations Reference Manual.
/ID Causes DMP's version to be printed.
/LB Logical block. Only the starting block number and
a contiguous or noncontiguous indication for the
file are displayed when you specify this switch.
/MD[:n] Memory dump. This switch allows control of line
numbers. Line numbers are normally reset to zero
whenever a block boundary is crossed. The /MD[:n]
switch allows lines to be numbered sequentially
for the full extent of the file, i.e., the line
numbers are not reset when block boundaries are
crossed. The optional value (:n) specifies the
value of the first line number. The default is 0.
/R5 Specifies that the data to be dumped is in RADIX-50
format words.
/RC Specifies that data be dumped a record at a time
(rather than a block at a time). The data format
is determined by setting one of the format switches,
/AS, /DC, or /R5. The largest record DMP can
process is limited to 512 (decimal) bytes.
4.0 DMP ERROR MESSAGES
DMP -- BAD DEVICE NAME
Description: An invalid device name in a file specifier
was specified.
Suggested User Action: Reenter the command line specifying
the correct device.
DMP -- BLOCK SWITCH REQUIRED IN LOGICAL BLOCK MODE
Page 4
Description: Self-explanatory -- /BL switch must be
specified.
Suggested User Action: Reenter the command line with the
/BL switch specified.
DMP -- CANNOT FIND INPUT FILE
Description: The requested file cannot be located in
the specified directory.
Suggested User Action: Reenter the command line with the
correct filename and UIC specified.
DMP -- COMMAND SYNTAX ERROR
Description: A command was entered in a format that does
not conform to syntax rules.
Suggested User Action: Reenter the command with the
correct syntax.
DMP -- FAILED TO ASSIGN LUN
Description: An illegal device was entered in a file
specifier.
Suggested User Action: Reenter the command line with the
correct device specified.
DMP -- FAILED TO READ ATTRIBUTES
Description: You have attempted to access a file for
which you do not have read access privileges.
Suggested User Action: If you get this error while running
DMP under RSX20F, you are in deep sneakers.
DMP -- ILLEGAL SWITCH
Description: You have specified a switch that is not a
valid DMP switch or used a legal switch in an invalid
manner.
Suggested User Action: Reenter the command line with the
Page 5
correct switch specified.
DMP -- I/O ERROR ON INPUT FILE
or
DMP -- I/O ERROR ON OUTPUT FILE
Description: One of the following conditions exists:
o A problem exists on the physical device (e.g., device
cycled down).
o File is corrupted or the format is incorrect.
o Output volume is full
Suggested User Action: Determine which condition caused
the message and correct that condition. Reenter the
command line.
DMP -- NO INPUT FILE SPECIFIED
Description: A command line was entered with no input
file specifier.
Suggested User Action: Reenter the command line with an
input file specified.
DMP -- NO LISTS OR WILD CARDS ALLOWED
Description: Either a command with more than one input
or output filename was entered or a wildcard was entered
as a file specifier.
Suggested User Action: Reenter the command line with only
one input file specifier and one output file specifier.
No wildcard specifiers are allowed.
DMP -- OPEN FAILURE ON INDIRECT FILE
Description: The requested indirect command file does
not exist as specified. One of the following conditions
may exist:
o The file is protected against access.
Page 6
o A problem exists on the physical device (e.g., device
cycled down).
o The volume is not mounted.
o The specified directory does not exist.
o The named file does not exist in the specified directory.
Suggested User Action: Determine the condition that
caused the message and correct that condition. Reenter
the command line.
DMP -- OPEN FAILURE ON INPUT FILE
or
DMP -- OPEN FAILURE ON OUTPUT FILE
Description: One of the following conditions may exist:
o The file is protected against access.
o The named file does not exist in the specified directory.
o The volume is not mounted.
o The specified directory does not exist.
o A problem exists on the physical device (e.g., device
cycled down).
Suggested User Action: Determine which condition caused
the message and correct that condition. Reenter the
command line.