Template Programming Interface Guide › Backup Job Exclusion Files

Backup Job Exclusion Files

This chapter describes the structure of backup job exclusion files created using TPI and shows an example file. It then explains each record that TPI backup job exclusion files can include. The records are discussed in alphabetical order. Unless stated otherwise, the records and parameters apply to both full and incremental backup jobs.

This section contains the following topics:

Backup Job Exclusion File Structure and Sample

* Record

COMMENT Record

EXCLUDE Record

Backup Job Exclusion File Structure and Sample

The following table outlines the structure of a backup job exclusion file. The table lists the records in the order you might use them in a file.

¹ When a job is exported from CA VM:Backup, all * records appear in order after the COMMENT record or, if no COMMENT record is specified, at the beginning of the file.

Example Exclusion File

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 backed up. It also excludes all minidisks that belong to the user ID of TEST and the file space VMANAGER in file pool A.

COMMENT EXCLUDES FOR SYSTEM RESOURCES
EXCLUDE DASD SYS001 SYS002
EXCLUDE FILEPOOL SFS
EXCLUDE USERID TEST *
EXCLUDE FILESPACE A:VMANAGER

* Record

Use the * record to add comments to exclusion files in addition to the comment specified on the COMMENT record. When you manage exclusion 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.

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]

Definitions

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 * record to your exclusion file. You want to document in the exclusion file that data for the user ID of DAVE is not included in the backup. Add the following * record in the exclusion file:

* Data for user ID DAVE is not backed up in WEEKLY backup.