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

## See also

- [AQL command categories](https://d3codex.com/access/aql-command-categories/)
- [Item list](https://d3codex.com/access/item-list/)
- [Selection criteria](https://d3codex.com/access/selection-criteria/)
- [t-dump command](https://d3codex.com/tcl/t-dump-command/)
- [t-load command](https://d3codex.com/tcl/t-load-command/)

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