The T-DUMP command transfers a copy of all or selected file items in random order to magnetic tape. This command also creates a tape label and writes an End-Of-File (EOF) mark on the tape after the transfer is complete.
Format
T-DUMP [DICT] filename [item-list] [selection] [HEADING "text"] [modifiers] [(options)] |
Parameter(s)
DICT |
Specifies the file dictionary. When copying dictionary items, the T-DUMP command does not copy any File Definition items to tape. |
|
filename |
Name of the file. |
|
item-list |
List of individual item-IDs. Enclose each item-ID in single quotes. |
|
selection |
Specifies one or more conditions that an item must meet in order to be copied. For a complete description of selection expression syntax, see the LIST Command. |
|
text |
Added to the standard tape label via the HEADING modifier. |
|
modifiers |
Includes one or more keywords that specify the report format. These parameters affect headers, footers, spacing, totalling column figures, control breaks, and more. For complete information about using these keywords, see the section, Connectives, Modifiers, and Options in the INFO/ACCESS User Reference Guide. The following modifiers operate differently with T-DUMP: |
|
HDR-SUPP |
Suppresses the creation of a tape label. |
|
ID-SUPP |
Suppresses listing of item-IDs during the copy-to-tape operation. |
|
options |
Include one or more single-character codes that specify the report format and direct or modify output. They must be enclosed in parentheses, can be entered in any order, and need not be separated by spaces or any delimiters such as commas. For complete information about using these parenthetical options, see the section, Connectives, Modifiers, and Options in the INFO/ACCESS User Reference Guide. The C option may be used when a backward compatible tape is to be produced (and later restored on an earlier system). The C option converts items in the dictionary of a DC-type file to CL items. |
|
Description
Before using the T-DUMP command, select the logical tape unit using the T-SELECT command. Then, attach the tape unit and set the tape record length by entering the T-ATT command. You can either select a block length, or accept the system default:
For 1/4-inch tape drives: |
16,896 bytes |
For Floppy tape drives: |
500 bytes |
If the tape’s write protection is on or if no write ring is present, the following message is displayed:
WRITE PROTECTED CONTINUE/QUIT (C/Q)? |
Remove the write protection or install a write ring, then type C to continue, or type Q to quit.
The T-DUMP command automatically writes a label to the tape in the following format:
You can add text to this label with the text parameter or suppress the tape label completely by including the HDR-SUPP keyword in the T-DUMP command line.
For information about reading a tape created with the T-DUMP command, see the T-LOAD Command.
Transferring Items to Magnetic Tape
The following example copies to magnetic tape all items from the ORDERS file whose date is before December 31, 1987. The tape label includes an addition to the standard text that reads "OLD ORDERS":
>T-DUMP ORDERS WITH DATE LT "12/31/87" HEADING "OLD ORDERS" 1 10117 2 10232 3 10089 . . . 24 ITEMS DUMPED. |