t-dump command

The t-dump command 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.

Syntax

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

Parameter(s)

options a Makes backward compatible tapes.
c Allows backward compatibility with older legacy systems when dumping binary data.
Note: This option should only be used on binary files.
h Suppresses the tape label.
i Suppresses the display of item-IDs as they are dumped.
p Directs output to the printer, via the spooler.
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.

Description

If no selection criteria is specified, the entire file is written. In all multireel 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 14 Feb 2004... #

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 TCL t-weof command or the FlashBASIC weof statement may be used to write the second eod needed to indicate the end of the file. Otherwise, account-restore or sel-restore may fail to see the end of the tape.

Note: The t-dump command 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 must:
t-dump dict inventory
t-dump inventory
t-dump inventory,old *if there are any other data-portions
Manually write down the information in each of the file’s D-pointers. On the subsequent t-load, you must:
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 FlashBASIC programs, the file where those programs reside must also be dumped, loaded, and compiled. The frame size for all D3 platforms is 2000.

Example(s)

t-dump entity
t-dump invoices with date <= "1/1/05" heading "Pre-2005 archived invoices"