CTTVTM – Perform vault management

The CTTVTM utility performs vault management functions. Run this utility on a regular basis using the CTTDAY job.

The utility checks each volume record’s vault specifications in the Media database and determines which volumes to move to a new location according to their vault patterns. The current volume location in the volume record is updated.

This utility can produce a distribution report at the end of processing, which lists all volumes that are moved to a new location or assigned a new slot number.

Note: Inventory report INVENT is no longer produced by the CTTVTM utility. Instead, this report can be produced as part of the GENERAL report by the CTTRPT utility. For more information, see CTTRPT – Database extraction and report utility. The CTTVTM utility requires exclusive access to the Media database. Real-time jobs that access tapes can be run at the same time as the CTTVTM utility, However, other utilities that access the Media database (for example, CTTRTM or CTTIDB) cannot run concurrently with this utility.

Since the utility handles a large number of Media database records, a CANCEL operation, job abend or system crash can lead to logical inconsistencies in the database. After any of these situations, the next execution of the utility automatically operates in Restart mode. In Restart mode, the utility completes execution of the failed process, thereby eliminating the logical errors from the Media database. The utility does not move any additional volumes during Restart execution.

Certain installation parameters (specified in member CTTPARM) determine how the CTTVTM utility operates. Table 398 describes these parameters.

Table 398 Relevant Control-M/Tape Installation Parameters

Parameter	Description
VLTBYDS1	Specifies which data set can determine how the vaulting pattern of a volume is chosen. Valid values are: Yes – Only the first data set of the volume determines the vaulting pattern for the volume. This improves performance of CTTVTM (and is compatible with other tape management system’s vaulting methods). Default. No – Any data set can determine the vaulting pattern for the volume.
SLOTRNG1	Specifies how Control-M/Tape performs the slot assignment in the vault. Valid values are: No — Each media type is assigned to a separate slot range. Default. Yes — All different media types are assigned to a single slot range in each vault. When using this option in the TV screen, all vault (slot and box) definitions must be defined only with the ALLMEDIA media. When you create box definitions under MAINLIB, specify the actual media type and do not specify ALLMEDIA. After modifying the SLOTRNG1 parameter, you must invoke CTTVTM in SLOTBLD mode to build the in-use slot bitmap inside the Media database.
SLOTRNG1	Note: Before setting this parameter to Y, make sure that no slot number is being used by more than one volume in the same vault. Use the CTTMUP utility to assign new slots to duplicate in-use slots.
CYCLECNT	Defines how to handle cyclic data sets.
EXPDTYPE	Determines expiration logic depending on the type of retention criteria and value specified: When DATE or DAYS retention criteria are assigned to a data set: CA1 – CA-1 expiration logic applies. DATE or DAYS specifies the day on that the data set volumes with "vault until date" are moved to the next vault or are returned to the Active Library (MAINLIB) on the same day as mentioned in the rule. Default. TLMS – TLMS expiration logic applies. DATE or DAYS specifies the last day of retention. Volumes only move to the next vault on the next day, one day later than mentioned in rule. NONE – Expiration date in standard MVS format.

For additional information refer to "Retention and Vault Parameters" in the INCONTROL for z/OS Installation Guide.

Parent Topic

Control-M/Tape Utilities