tcl.uvdump Verb: Access/TCL


Command tcl.uvdump Verb: Access/TCL
Applicable release versions: AP 6.2
Category TCL (746)
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 an AP 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 AP.

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 AP, 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 AP.

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 {} {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 AP 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 AP utility 'uvget' (see the Reference Manual entry for 'uvget').
Related tcl.generic-restore