Copying Items to Backup Media

The T-DUMP and S-DUMP commands create a backup medium label, copy items to backup media, and write an End-Of-File (EOF) marker on the backup media after the operation is complete. These commands may copy any file items except File Definition items.

Format

T-DUMP [DICT] filename [item-list] [selection] [HEADING " text "] [modifiers]

Description

The S-DUMP command uses the same syntax as T-DUMP and additionally allows the user to define sort-keys. This makes it possible to copy items to backup media in sorted order.

The text defined by the HEADING modifier is added to the standard backup medium label produced during the copy operation. The table below shows that there are only two other formatting modifiers that are applicable to the T-DUMP and S-DUMP commands. Any other formatting modifiers included in a query that uses these commands are ignored.

Modifier

Description

HDR-SUPP

Suppresses the creation of a backup medium label. The (H) option may also be used.

HEADING

Defines additional text for the backup medium label.

ID-SUPP

Suppresses the listing of item IDs during the copy operation. The (I) option may also be used.

The next statement copies selected items from the CUSTOMERS file to backup media in sorted order by last name, and creates a backup medium label that reads CUSTOMERS A-K 03/22/98. The system automatically lists the item-IDs of the copied items on the terminal screen:

>S-DUMP CUSTOMERS WITH LAST-NAME < "LAMPSON" BY LAST-NAME HEADING "CUSTOMERS A-K 03/22/98"

BLOCK SIZE: 16896

      1 MASHX5777

      2 JBOHA5422

      3 JBROW6749

      4 JBUCK6498

      5 DEDGE6635

      6 AEDWA5224

      7 HHIGG6849

      8 HJENK7129

      9 AJOHN5396

    10 HJOHN7265

10 ITEMS DUMPED

See Also

Copying Items to and from Backup Media

Copying Items from Backup Media

Tape Format Commands vs. the TAPE Modifier