Home > MultiValue Central > Online D3 Reference > Access: Verbs > access.t-dump

access.t-dump

Verb: Access/Access: Verbs, Releases: AP and R83

Dumps items to tape.

Syntax

t-dump file.reference {itemlist} {sellist} {modlist} {heading 'text'/options} {(options)}

Description

copies items from a given file to the attached peripheral storage device.

The 'heading' modifier allows specifying the contents of the tape label written to the tape prior to the dump.

The tape must already be at load point in order to write the tape label.

If no selection criteria are specified, the entire file is written.

In all multi-reel operations, if the process detects end of media before completing the dump, it prompts for the next reel with the message:

Load volume #X and type 'C'
label 08:00:00 16 Jan 1991 ... #

When the next 'reel' is inserted or mounted, 'c' continues the process, or 'q' stops it and returns control to TCL.

If the dump is being done to streaming cartridge tape (SCT), an explicit end-of-data sequence must be written at the end since SCT cannot back up. The 't-weof' (TCL) command or the Pick/BASIC 'weof' statement may be used to write the second eod needed to indicate end-of-file. Otherwise, 'account-restore' or 'sel-restore' may fail to see the end of the tape.

Options

a Make pre-6.2 AP compatible tapes.
c Allows compatibility with R83 systems when dumping binary data
h Suppresses the tape label.
i Suppresses the display of item-id's as they are dumped.
p Directs output to the printer, via the Spooler.
r{frame.size} This option is used to create dumps that are to be used on a system with a data frame size different from the system which created the tape. 'frame.size' designates the 'target' system frame size. See the chart listed under warnings for the current AP frame sizes.

Example

t-dump entity

t-dump invoices with date <= '1/1/92' heading 'Pre-1992
archived invoices'

See Also

Command Name Type Description
tape.handling.verbs Definition 'Tape' is a generic reference to the currently attached peripheral storage device.
access.t-load Verb: Access Loads data from t-dump format magnetic media.
access.s-dump Verb: Access Dumps items to tape in sorted order.
filename.tcl-stack File Description of the TCL command stack.
tcl.t-att Verb: Access Attaches magnetic media unit to current process.
tape.label Definition Description of Pick tape labels.
access.modifiers.modlist Definition Defines list of modifiers.
access.sellist Definition Defines selection criteria portion of an Access sentence.
access.selection.criteria Definition Description of Access selection criteria.
access.options Definition Standard options: b,c,d,h,i,j,k,n,p,r,s,u,y
tcl.t-read Verb: Access Reads and displays contents of magnetic media.
access.tape Modifier Produces Access report from magnetic media.
access.verbs Definition General form of Access sentences.
restore Definition
pc.y.stamp Processing Code stamps user, pib, and time/date update information into an internal item header from all processors.

User Comments

What do you think?

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

Login to leave your comments.