tcl.dump Verb: Access/TCL

tcl.dump

Command tcl.dump Verb: Access/TCL
Applicable release versions: AP, R83
Category TCL (746)
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).
Syntax dump decfid{-decfid} {options}
dump .hexfid{-.hexfid} {options}
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.
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
Purpose
Related sub-value.mark
attribute.mark
system.privileges
meta.characters
segment.mark
spooler.options
frame
start.buffer.mark
backward.link.zero