Template Programming Interface Guide › Backup Job Exclusion Files › EXCLUDE Record

EXCLUDE Record

REQUIRED

Use the EXCLUDE record to specify DASD volumes, file pools, or domains the job should not back up.

At least two EXCLUDE records are required in a file. For jobs that back up minidisks, one record must specify the DASD parameter and another must specify the USERID, ACCOUNT, or ACIGROUP parameter. For jobs that back up SFS or BFS 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”}...

Parms:

  ACCOUNT account
| ACIGROUP group
| DASD volsers…
| DIRECTORY fqdirname
| FILEPOOL filepools…
| FILESPACE filepoolid:userid
| USERID userid vaddr

Definitions

ACCOUNT account

Specifies the number of an account whose minidisks the job should not back up. You can use pattern matching. Enter * for account to specify all account numbers.

ACIGROUP group

Specifies an ACI security group whose minidisks the job should not back up. You can use pattern matching. Enter * for group to specify all ACI security groups.

DASD volsers...

Lists the volsers of volumes the job should not back up. 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 12 volumes.

DIRECTORY fqdirname

Specifies the fully-qualified name of an SFS directory the job should not back up. 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.

This parameter is only available through TPI. Using this parameter will prevent you from managing the exclusion file through CA VM:Backup screens.

FILEPOOL filepools...

Lists file pools the job should not back up. 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 12 file pools.

FILESPACE filepoolid:userid

Specifies the name of a file space the job should not back up. 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 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

USERID userid vaddr

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.