Enter your search terms Submit search form
	Web pdp-10.trailing-edge.com

.autoparagraph.flag capital.nofill
.right margin 68

			File Dump Utility (DMP)
.s
.hl 1	INTRODUCTION TO DMP
.s
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.
.s
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.
.s
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.
.s
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.
.s
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.
.s
Under RSX20F, the volume to be dumped must not be mounted.
.s
DMP can be invoked by using that PARSER's RUN command.
.hl 1	DMP COMMAND STRINGS
.s
Enter DMP command strings in the following format:
.s
.nofill
	outfile=infile/switch
.fill
.s
File specifications are of the form:
.s
.nofill
	dev:[group,member]filename.ext;version
.fill
.s
For a complete description refer to the RSX-11M documentation.
.hl 1	DMP SWITCHES
.s
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.
.s
.nofill
.s
Switch				Description
.s
Default		Word mode octal dump.
.s
/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.
.s
.s
/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.
.s
.s
/BL:n:m		Specifies the range of blocks to be dumped, where
		n is the first block and m is the last block.
.s
		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).
.s
		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.
.s
.s
/BY		The /BY switch specifies that the data should be
		dumped in byte octal format.
.s
.s
/DC		Specifies that the data should be dumped in decimal
		word format.
.s
.s
/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.
.s
		If you want only the header portion of the file to
		be dumped, specify:
.s
			/HD/BL:0
.s
		The file header is described in an appendix in the
		IAS/RSX-11 I/O Operations Reference Manual.
.s
.s
/ID		Causes DMP's version to be printed.
.s
.s
/LB		Logical block. Only the starting block number and
		a contiguous or noncontiguous indication for the
		file are displayed when you specify this switch.
.s
.s
/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.
.s
.s
/R5		Specifies that the data to be dumped is in RADIX-50
		format words.
.s
.s
/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.
.s
.s
.fill
.hl 1	DMP ERROR MESSAGES
.s
.nofill
DMP -- BAD DEVICE NAME
.s
	Description:	An invalid device name in a file specifier
	was specified.
.s
	Suggested User Action:	Reenter the command line specifying
	the correct device.
.s
.s
.s
DMP -- BLOCK SWITCH REQUIRED IN LOGICAL BLOCK MODE
.s
	Description:	Self-explanatory -- /BL switch must be
	specified.
.s
	Suggested User Action:	Reenter the command line with the
	/BL switch specified.
.s
.s
.s
DMP -- CANNOT FIND INPUT FILE
.s
	Description:	The requested file cannot be located in
	the specified directory.
.s
	Suggested User Action:	Reenter the command line with the
	correct filename and UIC specified.
.s
.s
.s
DMP -- COMMAND SYNTAX ERROR
.s
	Description:	A command was entered in a format that does
	not conform to syntax rules.
.s
	Suggested User Action:	Reenter the command with the
	correct syntax.
.s
.s
.s
DMP -- FAILED TO ASSIGN LUN
.s
	Description:	An illegal device was entered in a file
	specifier.
.s
	Suggested User Action:	Reenter the command line with the
	correct device specified.
.s
.s
.s
DMP -- FAILED TO READ ATTRIBUTES
.s
	Description:	You have attempted to access a file for
	which you do not have read access privileges.
.s
	Suggested User Action:	If you get this error while running
	DMP under RSX20F, you are in deep sneakers.
.s
.s
.s
DMP -- ILLEGAL SWITCH
.s
	Description:	You have specified a switch that is not a
	valid DMP switch or used a legal switch in an invalid
	manner.
.s
	Suggested User Action:	Reenter the command line with the
	correct switch specified.
.s
.s
.s
DMP -- I/O ERROR ON INPUT FILE
.s
	 or
.s
DMP -- I/O ERROR ON OUTPUT FILE
.s
	Description:	One of the following conditions exists:
.s
	o A problem exists on the physical device (e.g., device
	  cycled down).
.s
	o File is corrupted or the format is incorrect.
.s
	o Output volume is full
.s
.s
	Suggested User Action:	Determine which condition caused
	the message and correct that condition. Reenter the
	command line.
.s
.s
.s
DMP -- NO INPUT FILE SPECIFIED
.s
	Description:	A command line was entered with no input
	file specifier.
.s
	Suggested User Action:	Reenter the command line with an
	input file specified.
.s
.s
.s
DMP -- NO LISTS OR WILD CARDS ALLOWED
.s
	Description:	Either a command with more than one input
	or output filename was entered or a wildcard was entered
	as a file specifier.
.s
	Suggested User Action:	Reenter the command line with only
	one input file specifier and one output file specifier.
	No wildcard specifiers are allowed.
.s
.s
.s
DMP -- OPEN FAILURE ON INDIRECT FILE
.s
	Description:	The requested indirect command file does
	not exist as specified. One of the following conditions
	may exist:
.s
	o The file is protected against access.
.s
	o A problem exists on the physical device (e.g., device
	  cycled down).
.s
	o The volume is not mounted.
.s
	o The specified directory does not exist.
.s
	o The named file does not exist in the specified directory.
.s
.s
	Suggested User Action:	Determine the condition that
	caused the message and correct that condition. Reenter
	the command line.
.s
.s
.s
DMP -- OPEN FAILURE ON INPUT FILE
.s
	 or
.s
DMP -- OPEN FAILURE ON OUTPUT FILE
.s
	Description:	One of the following conditions may exist:
.s
	o The file is protected against access.
.s
	o The named file does not exist in the specified directory.
.s
	o The volume is not mounted.
.s
	o The specified directory does not exist.
.s
	o A problem exists on the physical device (e.g., device
	  cycled down).
.s
.s
	Suggested User Action:	Determine which condition caused
	the message and correct that condition. Reenter the
	command line.
.s