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

access.s-dump

Command access.s-dump Verb: Access/Access: Verbs
Applicable release versions: AP, R83
Category Access: Verbs (152)
Description writes items from a given file to the attached peripheral storage device in sorted order.

The "heading" or "header" 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.

When saving to multiple reels, at the "insert" prompt (insert next reel and type "C" to continue), entering a "Q" will stop the process.

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 and the Pick/BASIC "weof" statement both write the second eod needed to indicate end-of-file. Otherwise, "account-restore" or "sel-restore" fail to see the end of the tape.
Syntax s-dump file.reference {itemlist} {seqlist} {sellist} {modlist} {heading "text"} {(options)}
Options 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 printer.

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 table under "warnings" for various frame sizes
Example
s-dump entity by name

s-dump invoices by date by customer with date <= "1/1/92" heading 
"Pre-1992 archived invoices"
Purpose
Related access.itemlist
access.seqlist
access.sellist
access.selection.criteria
access.t-dump
access.t-load
access.verbs