tcl.dump

Verb: Access/TCL, Releases: AP and R83

Dumps frame(s) to screen or printer.

Syntax

dump decfid{-decfid} {options} dump .hexfid{-.hexfid} {options}

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.

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

See Also

Command Name Type Description
sub-value.mark Definition Used to separate subvalues within values.
attribute.mark Definition Used to separate attibutes in items.
system.privileges Definition Description of privilege levels.
meta.characters Definition The term used for the set of Pick reserved delimiters.
segment.mark Definition Used to separate items within frames.
spooler.options Definition Standard Spooler options.
frame Definition Description of a frame.
start.buffer.mark Definition Used primarily to pad tape records.
backward.link.zero Definition Backward link zero is a file system error.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.