# 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"
```

## See also

- [AQL command categories](https://d3codex.com/access/aql-command-categories/)
- [Options (Access Query Language)](https://d3codex.com/access/options-access-query-language/)
- [Full restore](https://d3codex.com/definitions/full-restore/)
- [s-dump command](https://d3codex.com/tcl/s-dump-command/)
- [Selection criteria](https://d3codex.com/access/selection-criteria/)
- [t-att command](https://d3codex.com/tcl/t-att-command/)
- [t-copy command](https://d3codex.com/tcl/t-copy-command/)
- [t-load command](https://d3codex.com/tcl/t-load-command/)
- [t-read command](https://d3codex.com/tcl/t-read-command/)
- [Tape handling commands](https://d3codex.com/definitions/tape-handling-commands/)
- [Tape devices overview](https://d3codex.com/tcl/tape-devices-overview/)
- [tape modifier](https://d3codex.com/access/tape-modifier/)
- [tcl-stack file](https://d3codex.com/systemfiles/tcl-stack-file/)
- [y (update stamping) processing code](https://d3codex.com/processingcodes/y-update-stamping-processing-code/)

---
Source: https://d3codex.com/tcl/t-dump-command/ - part of the D3Codex reference.