| dtx | Index Level | ecc (D3/RS6000) |
| Syntax |
dump decfid{-decfid} {options}
dump .hexfid{-.hexfid} {options} |
| Category | TCL |
| Type | Verb |
| Description |
displays or prints the contents of one or more frames in ASCII ("character") or hexadecimal format.
Frame-id's (FID's) preceded by a "." 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). |
| Options |
fid Requests frame by its decimal (integer) address. Preceding the fid reference with a "." (period) designates a hexadecimal address.
a Displays output in EBCDIC format. c Dumps entire frame, beginning with byte zero. g Dumps entire group. Frames are traced logically "forward". The dump terminates when the last frame in the logical chain has been found. l Outputs links only; no data is displayed. 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, ':', etc. -- just 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 The frames are dumped in hexadecimal with corresponding ASCII representation along the right side of the output. |
| See Also | subvalue mark attribute mark system privileges meta characters segment mark options: Spooler frame start buffer mark backward link zero |
| Example |
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 |
| Warnings | If no fid reference is provided, this aborts with the message "referencing illegal frame". |
| Compatibility | D3 7.0 AP R83 |
| dtx | Index Level | ecc (D3/RS6000) |