The S-DUMP command transfers a copy of all or selected file items in sorted order to backup medium. This command also creates a label and writes an End-Of-File (EOF) mark on the backup medium after the transfer is complete.
Format
|
S-DUMP [DICT] filename [item-list] [selection] [sort-keys] [HEADING "text"] [modifiers] [(options)] |
Parameter(s)
|
DICT |
Specifies the file dictionary. When copying dictionary items, S-DUMP does not copy any File Definition items to backup medium. |
|
|
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 to be copied. For a complete description of selection expression syntax, see the LIST Command. |
|
|
sort-keys |
Specifies which attributes to sort and whether to sort them in ascending or descending order. You can use the following modifiers with sort-keys: |
|
|
BY |
Sorts items in ascending order by the specified attribute. |
|
|
BY-DSND |
Sorts items in descending order by the specified attribute. |
|
|
BY-EXP |
Sorts a MultiValued attribute in ascending order and produces a separate line for each value. BY-EXP is not usually used with S-DUMP. |
|
|
BY-EXP-DSND |
Sorts a MultiValued attribute in descending order and produces a separate line for each value. BY-EXP-DSND is not usually used with S-DUMP. |
|
|
If more than one sort-key is specified in an S-DUMP command line, the system sorts these attributes from left to right (the leftmost sort-key is the most significant). |
||
|
text |
Added to the standard backup medium label via the HEADING modifier. |
|
|
modifiers |
Consist of one or more keywords that modify the copy operation. These include the following: |
|
|
HDR-SUPP |
Suppresses the creation of a backup medium label. |
|
|
ID-SUPP |
Suppresses listing of item-IDs. |
|
|
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 Connectives, Modifiers, and Options section in the INFO/ACCESS User Reference Guide. |
|
Before using S-DUMP, use T-ATT to attach the tape unit or floppy disk drive and set the record length. You can select a block length, or you can accept the system default block length of 16,896 bytes for 1/4-inch cartridge tape or 500 bytes for a floppy disk. In addition, the logical tape unit or floppy disk drive should already have been selected with the T-SELECT command.
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.
S-DUMP automatically writes a label to the backup medium in the following format:
|
[DICT] filename |
You can add text to this label with the text parameter, or you can suppress the backup medium label completely by including the HDR-SUPP keyword in the S-DUMP command line.
For information about reading backup medium created with S-DUMP, see the T-LOAD Command.
Transferring Sorted 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 items are copied in ascending sorted order by item-ID. The tape label includes an addition to the standard text that reads "OLD ORDERS".
|
>S-DUMP ORDERS WITH DATE < "12/31/87" HEADING "OLD ORDERS"
BLOCK SIZE: 16896 1 10102 2 10108 3 10112 4 10114 4 ITEMS DUMPED.
> |