Implementing the VTS Export/Import Interface

To implement the VTS Export/Import interface, modify the CTTVTM procedure as follows:

1. Rename the CTTVTM procedure as CTTVTM2.
2. Rename the CTTVTMV procedure as CTTVTM. The new CTTVTM contains steps CTTVVM and CTTVEXP, that you need to modify (as described later in this procedure).
3. The VTSVLTIN member in the CTT PARM library contains control statements with the following syntax:

   Table 24 The VTSVLTIN Member Control Statements

   Statement	Description
   TYPERUN MODE=[FIRSTVLT/ALLVLT]	TYPRUN MODE indicates how logical volumes are to be checked and grouped for export. Valid values are: FIRSTVLT indicates that logical volumes with the same first DO VAULT value and retention specification are grouped together for export. Default. ALLVLT indicates that only logical volumes with the same entire vaulting pattern are grouped together for export.
   RANGE FROM=beg_volser,TO=end_volser	FROM specifies the beginning of the volume serial number (volser) range. TO specifies the end of the volser range.

4. Specify which TYPERUN MODE is used for exporting logical volumes (FIRSTVLT or ALLVLT). For example:

   TYPERUN MODE=FIRSTVLT

   Note: When grouping logical volumes by their entire vaulting patterns with the TYPERUN MODE=ALLVLT statement, only volumes currently located within the first 10 vaults in the vaulting pattern are compared. Logical volumes located in a vault beyond the 10th vault are not exported. Grouping logical volumes by their first VAULT parameter and retention specification (TYPERUN MODE=FIRSTVLT) may prevent exclusion of logical volumes that are vaulted beyond the 10th vault.

   For both TYPERUN MODEs, logical volumes that have non-specific retention specifications (such as MVS CATALOG or LAST ACCESS) are not grouped for export through VTS. Instead, each of these logical volumes are exported to their own separate tapes. This is to avoid the case where logical volumes would be grouped together on the same physical tape, but would possibly be required to be sent to different locations or on different dates due to the different values of their non-specific retention specifications.

   Because logical volumes with non-specific retention specifications are exported to their own physical tapes, physical tapes within the VTS machine would be consumed faster than desirable. It is therefore recommended that you only export tapes with the VTS Export/Import Interface that have specific retention specifications (such as DATE or DAYS), by modifying the appropriate DO VAULT statements.

5. Specify the RANGE of volsers that reside in the Virtual Tape Server (VTS). Add additional RANGE statements as necessary. When Control-M/Tape exports logical volumes, only tapes inside these ranges are compared for export. For example:

   RANGE FROM=VOL001,TO=VOL005

   RANGE FROM=VOL011,TO=VOL015

   RANGE FROM=VOL021,TO=VOL025

   Do the following in the CTTVVM step of the new CTTVTM procedure:

   1. Make the required changes in the EXPLIST DD statement.

      The EXPLIST DD statement should refer to a scratch logical volser inside the VTS. This volser is the Export List Volume used by the VTS Export command.

   2. Make the required changes in the RESFILE and EXPSTAT DD statements.

      These DD statements should refer to the same volser as in EXPLIST.

   3. Make the required changes in the IMPLIST DD statement.

      The IMPLIST DD statement should refer to a scratch logical volser inside the VTS that is not the same scratch logical volser as referred to in step 5A. This volser is the Import List Volume produced during the VTS Export process.

   4. Make the required changes in the IMPSTAT DD statement.

      The IMPSTAT DD statement should refer to the same volser as was referred to in the IMPLIST DD statement, in step 5C.

6. In step CTTVEXP of the new CTTVTM procedure, make the required changes to DD statement EXPSTAT. This DD statement refers to the same Export List Volume as referred to in DD statement EXPLIST in step CTTVVM.