T-LOAD
Loads items from tape, previously saved by a T-DUMP or ST-DUMP operation, into a specified file. Both binary and ASCII items can be handled.
T-LOAD takes the items in the order they are read from tape and writes them into the groups into which they hash.
Command class
English command.
Restrictions
Executes on the default channel only.
T-LOAD does not perform a tape-to-tape operation - instead you must use the
Syntax
T-LOAD
Syntax elements
The following paragraphs briefly describe the syntax elements shown. For more information on English syntax elements, refer to Sentence Structure in the English Reference.
file-specifier Specifies the file into which file items are to be loaded. This must be defined in the MD of the account being used. DICT is the only file modifier that can be used with T-LOAD.
item-list A list of the item-ids to be loaded, each enclosed in single quotes. If omitted, all items are considered for loading.
The item-list can be supplied by an immediately preceding list-generating command.
selection-criteria Conditions that must be met by an item in order for it to be considered for loading. If omitted, those items specified in 'item-list', or all items, are loaded.
USING file-specifier
Specifies the file to be used as the source of definition items if different from the first file named.
macro-call The name of a macro definition item in the currently active dictionary.
Options
I Displays item-ids as the items are loaded from tape.
O Overwrites all items currently in the file that have item-ids corresponding to those on the tape.
P Printer. Sends item list to the printer instead of the terminal. Used with I option.
S Suppresses the exists on file message.
Comments
Before using T-LOAD, you must attach the required tape units to the port using the default channel.
The tape is positioned at the EOF (end of file) mark at the conclusion of the operation.
To load encrypted data from tape, you must use a tape device that is encrypted using the same key as when saved (see Tape Definitions and T-DEVICE).
Examples
T-LOAD TEST
The previously saved tape file is loaded into the file TEST and no items are overwritten.
T-LOAD DICT TEST (O
The previously saved tape file is loaded into the dictionary of the file TEST, items of the same name are overwritten.
T-LOAD TEST WITH QTY > "100" (P
Items with a QTY attribute greater than 100 are loaded into the file TEST; item-ids of items loaded are output to the printer.