Previous Topic: VMBMCOPY UtilityNext Topic: Set Up and Run the VMBMCOPY Utility


Definitions

COPYCAT dumpjob filemode

Specifies that the new catalog that DUMPJOB produces is copied to a test CA VM:Backup catalog disk. COPYCAT lets you test the validity of the new catalog and tapes without disrupting the old catalog and tapes that the production server still uses.

dumpjob

Specifies the filename of the DUMPJOB file that the process copies from the VMBMCOPY A-disk to the test catalog disk. (The filename is the number that this product assigns when the catalog is created.) Enter one to eight digits for dumpjob.

filemode

Specifies the filemode of the test catalog disk. The VMBMCOPY user ID must link to the catalog disk in read-write mode.

DUMPJOB dumpjob

Requests a catalog-based media copy. During this process, the production catalog disk is accessed in read-only mode and new catalog data files are written to the VMBMCOPY A-disk. The copy process causes the original DUMPJOB file to be updated on the VMBMCOPY A-disk. New FILE0001 files are written to the A-disk, one for each output tape that is used.

The copy process also writes one DETAIL file for each set of copies that the process creates.

dumpjob

Specifies the filename of the DUMPJOB file that the process copies from the production catalog disk to the VMBMCOPY A-disk. (The filename is the number that this product assigns when the catalog is created.) Enter one to eight digits for dumpjob.

LISTCAT dumpjob

Specifies that a list of associated catalog data files on the production CA VM:Backup catalog disk is displayed on the console. LISTCAT is useful while you are planning to copy backup media. LISTCAT helps to determine the following information:

LISTCAT displays the FILE0001 and DETAIL files that are associated with a DUMPJOB. One DETAIL file exists for every set of tape copies. One FILE0001 file exists for each tape that the backup uses. The filename of a FILE0001 file is the volser of a tape.

The production catalog disk is accessed read-only for this function.

dumpjob

Specifies the filename of the DUMPJOB file that you plan to copy from the production catalog disk to the VMBMCOPY A-disk. (The filename is the number that this product assigns when the catalog is created.) Enter one to eight digits for dumpjob.

RESERVE count

Reserves a range of DETAIL file filenames on the production CA VM:Backup catalog disk for use during DUMPJOB processing. Reserving a range of filenames eliminates potential DETAIL filename collisions and enables production backup jobs to run while this utility copies old media. For more information, see DETAIL Files.

The reserved filename range for each VMBMCOPY user ID is stored in the VMBMCOPY RESERVED file on the catalog disk. Also, a new file with a filetype of $DETAIL is written on the catalog disk. The $DETAIL file creates the upper value of the reserved range. (The filenames of DETAIL files are 8-digit integer values that are unique on the production catalog disk.) The $DETAIL file forces new DETAIL filenames that are created during backup processing to be numerically higher than the reserved range.

The production catalog disk must be write-linkable. Therefore, log off the CA VM:Backup server before issuing the RESERVE function.

Note: A CA VM:Backup cold start erases the $DETAIL file. Do not perform a cold start until after you create a new catalog by running a backup job.

count

Specifies the number of filenames that are reserved for DETAIL files that are created during DUMPJOB processing.

SCRATCH dumpjob

Erases the catalog data files that are associated with one catalog residing on the VMBMCOPY A-disk. Typically, these catalog files refer to the old media. SCRATCH also resets the associated tape retention period to zero so CA VM:Tape scratches the tapes.

dumpjob

Specifies the filename of the DUMPJOB catalog file to scratch. The relevant catalog files have the following characteristics:

  • They were previously on the production CA VM:Backup catalog disk.
  • They were specified as input to DUMPJOB and SWAPCAT processing.
  • They are ready to be deleted permanently and the associated tapes ready to be scratched.

Enter one to eight digits for dumpjob.

SWAPCAT dumpjob

Exchanges the new catalog files with the old catalog files. The new catalog files are on the VMBMCOPY A-disk. The old catalog files are on the production CA VM:Backup catalog disk. The new catalog files are copied to the production catalog disk and erased from the VMBMCOPY A-disk. The old catalog data files are copied from the production catalog disk to the A-disk and are erased from the catalog disk. The production CA VM:Backup server must be logged off and the catalog disk must be linkable read-write.

A catalog swap can be reversed by issuing another SWAPCAT.

Note: Do not erase the old catalog files from the A-disk. SCRATCH processing uses the old catalog files to reset the retention period of each tape that is associated with the old catalog.

dumpjob

Specifies the filename of the DUMPJOB catalog file to swap. This file is on both the VMBMCOPY A-disk and the production catalog disk. (The filename is the number that this product assigns when the catalog is created.) Enter one to eight digits for dumpjob.

TAPESET volser

Copies to new media a set of tapes that is not associated with a CA VM:Backup catalog. This copy procedure does not produce any output catalog files. Use this procedure only with tapes that are not associated with a CA VM:Backup catalog. To scratch the old tapes, reset the retention period of the old tapes manually using the CA VM:Tape CATALOG command.

volser

Specifies the volser in the set of tapes that you want to copy to new media. The tapes must not be associated with a catalog. The volser must be the first tape of any stream in the set of tapes to be copied.

TEST

Verifies the records in the VMBMCOPY CONFIG file for accurate syntax. TEST also verifies the configuration settings that are displayed on the console. TEST does not verify the VMBMCOPY CONFIG file contents against what is in CA VM:Tape.