| roll-on | Index Level | sampling |
| Syntax | s-dump file.reference {itemlist} {seqlist} {sellist} {modlist} {heading "text"} {(options)} |
| Category | Access |
| Type | Verb |
| 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 FlashBASIC "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 |
| See Also | itemlist seqlist sellist selection criteria t-dump t-load Access verbs |
| Example |
s-dump entity by name
s-dump invoices by date by customer with date <= "1/1/92" heading "Pre-1992 archived invoices" |
| Warnings | R83 used a frame size of 512. D3 utilizes 2000-byte frames. |
| Compatibility | D3 7.0 AP R83 |
| roll-on | Index Level | sampling |