| useralarm | Index Level | uvget |
| Syntax | UVDUMP |
| Category | TCL |
| Type | Verb |
| Description |
dumps a uniVerse account onto tape as a series of "t-dumps" which can be later read by the "generic-restore" Pick utility, or to a device (Unix pipe or serial line) to be transferred to a D3 system using the 'uvget' utility.
This BASIC program is designed to be transported to a uniVerse machine where it must be compiled and cataloged in the accounts which will be transferred to D3. Once set up, the UVDUMP program provides a menu of options. Option number 1 allows the user to set various destination parameters including the destination frame size, the desired capacity of the files when they are restored on D3, the number of items to sample to derive the expected modulo, and default create-file options. The defaults are set properly for most uses. Option number 2 creates a control file for dumping the account. This must be done prior to actually making the tape. This option scans for relevant files, and determines the modulo of those files once they are moved to D3. Option number 3 allows the user to edit the control item. This control item has a line of information for each file section. The format is as follows: DICT/DATA {file.name} {modulo} {create-file options} Lines may be added, modified, or deleted from this file to change the way the account is later dumped. Option number 4 actually dumps the account based on the information in the control item. Each file section is dumped as a small "t-dump" of a header block followed by a large "t-dump" of the actual data in the section. Note that this option does NOT rewind the tape so that multiple accounts may be placed on the same tape. The tape created by this utility must be read by the D3 utility "generic-restore". Option number 5 transfers the account to a device based on the information in the control item. This option asks for the device name (default '/dev/pipe'). The device can be a pipe (created on Unix by 'mknod devicename p') or a sequential device (tape, serial line, Unix file,...). Before starting this option, the other 'end' of the device (if a pipe or a serial device) must be read by the D3 utility 'uvget' (see REF entry for uvget). |
| Options | |
| See Also | generic-restore R83dump uvget |
| Example | |
| Warnings |
It is important to eliminate any files which may contain binary data from the control file because certain Pick-like systems do not dump such items in a standard format causing the "generic-restore" utility to become confused and abort.
The uniVerse file ERRMSG is not transmitted, since it collides with the D3 messages file. The BASIC program UVDUMP does not compile on Pick due to the usage of uniVerse specific statements. The source is provided 'as is' on 'dm,bp,'. |
| Compatibility | D3 7.0 |
| useralarm | Index Level | uvget |