# 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
```

---
Source: https://d3codex.com/tcl/dump-command/ - part of the D3Codex reference.
