s-dump Command

The s-dump command 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, entering Q at the insert prompt (insert next reel and type "C" to continue), stops 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, because SCT cannot back up. The t-weof (TCL) command and the FlashBASIC weof statement both write the second eod needed to indicate the end of the file. Otherwise, account-restore or sel-restore fail to see the end of the tape.

Syntax

s-dump file.reference {item.list} {selection.criteria} {sort.criteria} {modifiers} {heading "text"} {(options)}

Parameter(s)

c	Allows backward compatibility with older legacy systems when dumping binary data.
h	Suppresses the tape label.
i	Suppresses the display of item-IDs as they are dumped.
p	Directs output to printer.
r{frame.size}	Creates dumps that are to be used on a system with a data frame size different from the system that created the tape. The frame size designates the target system frame size. D3 utilizes 2000-byte frames.

Example(s)

s-dump entity by name

s-dump invoices by date by customer with date <= "1/1/05" heading "Pre-2005 archived invoices"