access.t-dump Verb: Access/Access: Verbs

access.t-dump

Command access.t-dump Verb: Access/Access: Verbs
Applicable release versions: AP, R83
Category Access: Verbs (152)
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.
Syntax t-dump file.reference {itemlist} {sellist} {modlist} {heading "text"/options} {(options)}
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"
Purpose
Related tape.handling.verbs
access.t-load
access.s-dump
filename.tcl-stack
tcl.t-att
tape.label
access.modifiers.modlist
access.sellist
access.selection.criteria
access.options
tcl.t-read
access.tape
access.verbs
restore
pc.y.stamp