| supp | Index Level | t-load |
| Syntax | t-dump file.reference {itemlist} {sellist} {modlist} {heading "text"/options} {(options)} |
| Category | Access |
| Type | Verb |
| 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 FlashBASIC "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. |
| Options |
a Make pre-D3 release 7.0 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 Also | tape handling verbs t-load s-dump tcl-stack t-att tape label modlist sellist selection criteria options: t-read tape Access verbs restore y t-copy |
| Example |
t-dump entity
t-dump invoices with date <= "1/1/92" heading "Pre-1992 archived invoices" |
| Warnings |
"t-dump" does not save all of the information necessary to recreate a file on another system. To save the information in a file called "inventory", you will have to:
t-dump dict inventory t-dump inventory t-dump inventory,old (if there are any other data-portions) and manually write down the information in each of the file's d-pointers. On the subsequent t-load, you will have to: create-file inventory <dict-mod>, <data-mod> edit the d-pointer, and insert any subsequent correlative, macro and hotkey information, create-index any indexes, t-load dict inventory t-load inventory t-load inventory,old (if there are any other data-portions) Of course, if the correlatives call any basic programs, the file where those programs reside must also be t-dump'ed / t-loaded, and compiled. The frame size for all D3 platforms is 2000. |
| Compatibility | D3 7.0 AP R83 |
| supp | Index Level | t-load |