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 |