The VMBMCOPY CONFIG file controls how VMBMCOPY works. Create this configuration file before you issue the VMBMCOPY command.
Create a VMBMCOPY CONFIG file on the A-disk for each user ID that is created to run the VMBMCOPY utility. Do not change the configuration after you have started processing a catalog with the utility.
When editing the records, remember the following points:
Example: VMBMCOPY Configuration File
The following display shows a sample VMBMCOPY CONFIG file. This configuration uses the standard CA VM:Backup and CA VM:Tape user IDs. The configuration specifies that VMBMCOPY creates two copies of all output tapes.
* This is a sample VMBMCOPY CONFIG file used for copying
* CA VM:Backup backups to two copies of new media output
* tapes.
COPIES 2
* The keyword 'vmbmcopy' in the dsname identifies these
* tapes as being copied from other media.
DSNAME 1 VMBMCOPY.VMBACKUP.PRIMARY
DSNAME 2 VMBMCOPY.VMBACKUP.COPY
* Different media and densities are used for both copies.
* The IBM media is mounted from the general scratch pool
* while the STK media comes from a defined scratch pool
* named OFFSITE.
RESOURCE 1 GENERALSCRATCHTAPE XPT XPTC
RESOURCE 2 OFFSITE STK1R 1R35
* The primary copy is kept for 1000 days while the other
* copy is kept until 2015.
RETAIN 1 RETPD 1000
RETAIN 2 EXPDT 2015/001
The VMBACKUP record identifies the user ID of the CA VM:Backup server whose tape sets you plan to copy. If no record is specified, VMBACKUP is the default. Only one VMBACKUP record can be specified.
VMBACKUP serverid
Definitions
Specifies the name of the CA VM:Backup server whose tape sets you plan to copy.
The VMTAPE record identifies the user ID of the CA VM:Tape server that manages the tapes that belong to the CA VM:Backup server. If no record is specified, then VMTAPE is the default. Only one VMTAPE record can be specified.
VMTAPE serverid
Definitions
Specifies the name of the CA VM:Tape server that manages the tape sets to be copied. The serverid also provides the scratch tapes for output in the DUMPJOB function.
The CATMDISK record identifies the virtual address of the CA VM:Backup catalog minidisk. If no record is specified, 1B0 is the default. Only one CATDISK record may be specified.
CATMDISK vaddr
Definitions
Specifies the virtual address of the CA VM:Backup catalog minidisk.
The COPIES record specifies the number of output tape copies that the DUMPJOB or TAPESET function creates (maximum 5). The COPIES record is required. Specify only one COPIES record.
COPIES count
Note: The output tape count in this record determines the number of DSNAME, RESOURCE, and RETAIN records that must be specified. If a stream has more than one output tape, the stream requires one more available drive per media type. Normal CA VM:Backup processing requires that the volser of the next tape is written in the trailer label of the current tape.
Definitions
Specifies the number of output tape copies. This value ranges from 1 to 5.
The DSNAME record specifies the dataset name for each copy of output tapes. The dataset name is written to the tape labels and the FILE0001 catalog files. Specify one DSNAME record for each output tape copy. The maximum number of copies is five. DSNAME is a required record.
DSNAME copy dsname
Definitions
Specifies which tape of a set of output tape copies this record pertains to. The number of copies in the output tape set is determined in the COPIES record of that set. This value ranges from 1 to 5.
Specifies a data set name. VMBMCOPY uses the specified dsname when mounting output scratch tapes.
CA VM:Backup imposes no restrictions on data set names, nor does this product check them in any way. Recommended practice is to assign a dsname that indicates that the tapes were copied. Data set names have a maximum length of 44 characters and are restricted to alphanumeric characters and the symbols #, @, and $. If other characters or embedded blanks are used, the dsname must be enclosed within apostrophes or quotes. A dsname longer than 44 characters is truncated.
This record specifies the POOL, DEN, and media options that the MOUNT command sends to CA VM:Tape. VMBMCOPY does not validate the parameters. Specify one to five records; one for each copy of output tape sets indicated by the copy parameter. RESOURCE is a required record.
Note: For more information, see the CA VM:Tape for z/VM Administration Guide.
RESOURCE copy poolname media density
Definitions
Specifies which tape of a set of output tape copies this record pertains to. The number of copies in the output tape set is determined in the COPIES record of that set. This value ranges from 1 to 5.
Specifies the name of the tape pool from which to select scratch tapes. The tape pool is defined on CA VM:Tape. If your CA VM:Tape does not use pools, specify GENERALSCRATCHTAPE as the poolname. This poolname tells the product to mount scratch tapes from the general scratch pool. The poolname has 1-16 characters.
Specifies the type of media that the DUMPJOB function requests from CA VM:Tape.
Note: For information on media, see the CA VM:Tape for z/VM Administration Guide, Chapter 8, VMTAPE CONFIG File Reference, DEFMEDIA and DEFDENS records.
Specifies the density that the DUMPJOB function requests from CA VM:Tape. For information on density, see the CA VM:Tape for z/VM Administration Guide, Chapter 8, VMTAPE CONFIG File Reference, DEFDEN record.
This record specifies the expiration date option that the MOUNT command sends to CA VM:Tape. Specify one to five records; one for each copy of output tape sets indicated by the copy parameter. RETAIN is a required record.
RETAIN copy {EXPDT julian | RETPD days}
Definitions
Specifies which tape of a set of output tape copies this record pertains to. The number of copies in the output tape set is determined in the COPIES record of that set. This value ranges from 1 to 5.
Specify one expression of expiration date. Specify either EXPDT and a specific julian date in CA VM:Tape format (yyyy/ddd) or RETPD and the number of days from the current date. Either EXPDT or RETPD is required.
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|