dump command

The dump command displays or prints the contents of one or more frames of the VME in ASCII (character), EBCDIC or hexadecimal format.

The frame-IDs (FIDs) can be hexadecimal and decimal references. When preceded by a period, FIDs are considered hexadecimal references. A range of FIDs may also be specified.

Note: The dump command uses the same options interface as the spooler. This means that the options and arguments are not preceded by a left parenthesis.

Syntax

dump fid{-fid} {options}

Parameter(s)

`fid`	Requests the frame by its decimal (integer) address.
`options`	a	Displays output in EBCDIC format.
	g	Dumps entire group. Frames are traced logically forward. The dump terminates when the last frame in the logical chain has been found.
	i	Displays process diagnostic information regarding the retrieval and return of the specified frame from overflow.
	l	Outputs links only; no data displays.
	n	Activates nopage function on output to the terminal.
	p	Directs output to system printer via the spooler.
	u	Upward trace; frames are traced logically backward. The dump terminates when the first frame in the logical chain has been found.
	s	Dumps just the data bytes in a stream without side baggage such as links, offset, colon, and so on—a long byte stream. Works with x, g, and u options. This is mainly for programs wanting to examine memory in straight byte sequence without having to strip out the extraneous information.
	x	Frames are dumped in hexadecimal with corresponding ASCII representation along the right side of the output.

Note: If a FID reference is not specified, this aborts with the message: referencing illegal frame.

Example(s)

dump 12345 g
dump l 12345
dump 12345 (lp
dump 12345-12330
dump xp 12345-12330
dump .3039 g(x’3039’=d’12345’)
dump lu .3039