VA FileMan V. 22.0 Getting Started HTML Manual Banner


 

Main Chapter Getting Started Manual Programmer Manual

Archiving


Move Archived Data to Permanent Storage

Once you have written an archiving activity to temporary storage, you can use the Move Archived Data to Permanent Storage option. If you choose an archiving activity that has not yet been written to temporary storage, a warning is issued.

This option will do several things not necessarily in the order listed here.

  1. It will print an Archive Activity report which prints information from the ARCHIVAL ACTIVITY file (#1.11), such as the archiver (i.e., the person who selected this option), the archival activity number, an index of all archived entries, and the search criteria used during the Select Entries to Archive process, etc.

  2. It will build an index of all archived entries and write this index at the beginning of the archived file. An item in the index contains the .01 value of the entry, along with all PRIMARY KEY and Identifier values for that entry.

    NOTE: The PRIMARY KEY is new with Version 22.0 New/Updated with VA FileMan V. 22.0

  3. It will prompt for Archive Device Label information. This information will usually represent some naming convention that Systems Managers use as physical label for devices such as tape. If using a disk file, the full disk file name will be presented as a default. This device label information along with the index printed on the Archive Activity report should be useful in locating an archived entry and the device to which it was archived.

  4. Lastly, this option will move archive data to permanent storage. Permanent storage is considered any sequential storage media like SDP, VMS file, magnetic tape, or disk data set.

You can send to more than one permanent storage location without having to recreate the archiving activity. When the archived data is moved to permanent storage, every line contained in the temporary storage word processing field is simply read and then written to a sequential medium.

The status of your archiving activity after using this option is ARCHIVED (PERMANENT).

In the example below, the archiving activity is identified by file name, "CHANGE." It is going to be archived to the specified tape:

Select ARCHIVE OPTION: MOVE ARCHIVED DATA TO PERMANENT STORAGE
Select ARCHIVAL ACTIVITY: CHANGE        3 CHANGE  08-30-92     
ARCHIVED(TEMPORARY)     SELECTOR:SMITH,J     ARCHIVING

NOTE:  This option will 1) print an archive activity report to 
specified PRINTER DEVICE and 2) will move archive data to permanent 
storage to specified ARCHIVE STORAGE DEVICE.

Select some type of SEQUENTIAL storage media, such as SDP, TAPE, or 
DISK FILE (HFS) for archival storage.

PRINTER DEVICE: PRINTER

ARCHIVE STORAGE DEVICE: MAGTAPE Parameter ("CAVL":0:2048)
DO YOU WANT YOUR OUTPUT QUEUED?  NO// YES
Requested Start Time:  NOW// 

ARCHIVE DEVICE LABEL:  ISC6V3$MUA0:ARCHIVE;083092;3// 

If the archive storage device is tape, an archive device label is generated for you, as depicted in the previous example. You can override this label by entering your own device label information.

If you select an archive storage device that is non-sequential, a warning is issued. You are given the option to continue the archiving process.

CAUTION: If you specify a device that can be overwritten (e.g., SDP) or that does not electronically store data (e.g., a printer), the data will be forever irretrievable.

Depending on what devices are selected, and whether queueing was requested for either device, different warnings will be issued informing the user of either steps he need to take or steps that the program will take as a result of the queueing request.

Here is an example of an archive activity report:

ARCHIVE ACTIVITY REPORT                         AUG 30,1992  PAGE: 1
--------------------------------------------------------------------
ARCHIVAL ACTIVITY: 3
ARCHIVE DEVICE LABEL INFORMATION:  ISC6V3$MUA0:ARCHIVE;083092;3
PRIMARY ARCHIVED FILE: CHANGE (#16000)
ARCHIVER: SMITH,J
SEARCH CRITERIA: 
     .01 LESS THAN 900
 

INDEX INFORMATION: 
 
NO.        VERSION          PROGRAMMER                 
101        17.10            DOE,JANE
102        17.32            DOE,JOHN
103        17.35            DOE,JOHN
330        17.09            DOE,JULIA
 
*** PLEASE KEEP THIS FOR FUTURE REFERENCE ***

 


Reviewed/Updated: March 4, 2007