access.s-dump
Dumps items to tape in sorted order.
Syntax
s-dump file.reference {itemlist} {seqlist} {sellist} {modlist} {heading 'text'} {(options)}
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.
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'
See Also
User Comments
What do you think?
Share your experience or ask a question by using the form below.
Login to leave your comments.