Previous Topic: Extensive ReportingNext Topic: Execute VMS


VMS Overview

VMS consists of the following batch utilities:

TMSVMEDT

TMSVMEDT is the first utility executed in the VMS cycle. It processes the VPD, validating and cross-referencing the site-defined movement data to generate a VPD work file. TMSVMEDT then selects the TMC records eligible for VMS control and generates a TMC work file. TMS Report 23 - Vault Pattern Data Set is created to describe the VPD and any errors it contains.

Note: TMSVMEDT should be executed only after all tapes to be vaulted have been created. Otherwise, movement may not be complete, especially when a multivolume data set is still in creation. When TMSVMEDT selects the TMC records, only those volumes that have already been created and the volume still on the drive can be moved. Volumes created subsequently are not moved until the next VMS execution. However, a second execution of TMSVMEDT will pick up those volumes created subsequent to the first execution.

The CYD parameter in member TMOOPTxx of hlq.CTAPOPTN determines cycling options. A PARM=TEST can be used to validate new entries prior to implementation. Optionally, a maximum number of slots may be specified at the VAULT level. TMSVMVLT indicates when this level has been reached. The ADGDG option allows ABARs pseudo GDG files to be treated the same as normal GDGs during the vaulting process.

TMSVMVLT

TMSVMEDT passes the VPD information and the selected TMC records to the TMSVMVLT program, which determines the movement of volumes between locations. TMSVMVLT creates a data set describing this movement for CA Earl to use in reporting, and for the TMSVMUPD program to use in updating the TMC. The VMSOUT data set created by TMSVMVLT should be saved for a reasonable period in the event the reports generated by CA Earl need to be reprinted. TMS Report 24 - Exceptional Conditions Encountered During Processing is produced to inform you of any problems or possible errors associated with the movement of volumes.

TMSVMUPD

Using the data from TMSVMVLT, TMSVMUPD updates the TMC to reflect the new vaulting configuration. TMSVMUPD compares the data set created by TMSVMVLT against the TMC and, if a change is present in the input, performs the update. If the data set name has been changed or the tape has been marked as scratch in the interim between the execution of TMSVMVLT and TMSVMUPD, that TMC record is not updated, and an error message is issued. The updates and any errors are listed on TMS Report 26 - Vault Update Listing.

CA Earl

Using the data from TMSVMVLT, CA Earl can generate the Picking List, Distribution List, and Inventory List. These reports detail the decisions made by TMSVMVLT regarding tape volume movement. TMEVLT01-03 are used to produce these reports. Site-specific CA Earl control statements determine the sort sequences and optional report headings.