This chapter describes the structure of restore job exclusion files created using TPI and shows an example file. It then explains each record TPI restore job exclusion files can include. The records are listed in alphabetical order. Unless stated otherwise, the records and parameters apply to all types of restore jobs (CATSEARCH, VOLSEARCH, and VOLSER).
This section contains the following topics:
Restore Job Exclusion File Structure and Sample
The following table outlines the structure of a restore job exclusion file. The table lists the records in the order you might use them in a file.
|
Record |
Information Specified |
Required |
Quantity Allowed |
|
COMMENT |
Comment |
No |
1 |
|
* |
Additional comments |
No |
Multiple |
|
EXCLUDE |
DASD volumes, file pools, and domains to not restore |
Yes |
Multiple; at least 2 |
Example Restore Job Exclusion
The following example shows an exclusion file named WEEKLY $XCLUDE. This file excludes DASD volumes SYS001 and SYS002 and the file pool SFS from being restored. It also excludes all minidisks that belong to user ID TEST and all file spaces in file pool A.
COMMENT EXCLUDES FOR SYSTEM RESOURCES EXCLUDE DASD SYS001 SYS002 EXCLUDE FILEPOOL SFS EXCLUDE USERID TEST * EXCLUDE FILESPACE A:*
OPTIONAL
Use the * record to add comments to exclusion files in addition to the comment specified on the COMMENT record. When you manage job template files through the CA VM:Backup screens, CA VM:Backup displays the comment on the COMMENT record on the screen; comments on * records are not displayed on the screen.
You can use * records with the COMMENT record or by themselves, and you can include as many as you need. You can place * records anywhere in the file; however, when the file is exported, CA VM:Backup places all * records in order after the COMMENT record or, if no COMMENT record exists, at the beginning of the file.
Note: This record is available only through TPI. Using this record will not prevent you from managing the exclusion file through the CA VM:Backup screens
* [text]
Can include up to 80 characters of comment text; any additional text is truncated. You must enter the asterisk (*) in column 1 of the record. You can use uppercase and lowercase letters; when you import or export the file, text case is preserved.
Example
You added an EXCLUDE USERID DAVE 0193 record to your exclusion file. You want to document in the exclusion file that data from DAVE 193 is not included in the restore job. Include the following * record in the exclusion file:
* Do not restore data for minidisk DAVE 0193.
OPTIONAL
Use the COMMENT record to enter a comment in a file.
You can include only one COMMENT record in a file. When you want to specify more than one comment, use * records. When managing the exclusion file using CA VM:Backup screens, the comment specified on the COMMENT record is displayed on the screen; comments specified on * records are not displayed on the screen.
COMMENT [text]
Can include up to 50 characters of comment text; any additional text is truncated. You can use uppercase and lowercase letters; when you import or export the file, text case is preserved.
REQUIRED
Use the EXCLUDE record to specify DASD volumes, file pools, or domains the job should not restore.
At least two EXCLUDE records are required in an exclusion file. For jobs that restore minidisks, one record must specify the DASD parameter and another must specify the USERID, ACCOUNT, or ACIGROUP parameter. For jobs that restore SFS data, one record must specify the FILEPOOL parameter and one must specify the FILESPACE or DIRECTORY parameter. Each record can specify only one of these parameters.
EXCLUDE {"Parms"}...
Options:
ACCOUNT account | ACIGROUP group | DASD volsers... | DIRECTORY fqdirname | FILEPOOL filepools... | FILESPACE filepoolid:userid | USERID userid vaddr
Specifies the number of an account whose minidisks the job should not restore. You can use pattern matching. Enter * for account to specify all account numbers.
Specifies an ACI security group whose minidisks the job should not restore. You can use pattern matching. Enter * for group to specify all ACI security groups.
Lists the volsers of volumes the job should not restore. You can use pattern matching. Enter * for volser to specify all DASD volumes.
Note: If you want to be able to work with a file through CA VM:Backup screens, do not list more than 24 volumes.
Specifies the fully-qualified name of an SFS directory the job should not restore. You cannot use pattern matching.
Note: EXCLUDE DIRECTORY records apply only to INCLUDE DIRECTORY records in job template files with which the exclusion file is associated.
You cannot use EXCLUDE DIRECTORY and EXCLUDE FILESPACE records in the same file.
The DIRECTORY parameter is available for restores only through TPI
Lists file pools the job should not restore. You can use pattern matching. Enter * for filepool to specify every file pool identified to CA VM:Backup.
Note: If you want to be able to work with a file through CA VM:Backup screens, do not list more than 24 file pools.
The FILEPOOL parameter is available for restores only through TPI.
Specifies the name of a file space the job should not restore. You can use pattern matching. Enter * for filepoolid to specify all file spaces for the specified user IDs in all file pools listed on the corresponding INCLUDE FILEPOOL record. Enter * for userid to specify all file spaces for all user IDs in the specified file pool.
Note: EXCLUDE FILESPACE records apply only to INCLUDE FILESPACE records in job template files with which the exclusion file is associated.
The FILESPACE parameter is available for restores only through TPI.
Specifies a user ID and vaddr of a minidisk the job should not restore. You can use pattern matching. Enter * for userid to specify the minidisks of all user IDs with the specified virtual address. Enter * for vaddr to specify all minidisks for the specified user IDs.
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|