Template Programming Interface Guide › Backup Job Exception Files › EXCEPT Record

EXCEPT Record

REQUIRED

Use the EXCEPT record to identify domains to process differently than specified in the backup job template file. CA VM:Backup processes the domains as described in the exception file rather than as described in the job template file.

A file must include at least one EXCEPT record and can include more than one.

EXCEPT {“Parms”}... [SETTAG tag]

Parms:

  ABSTRACT owner domainname
| DIRECTORY fqdirname
| FILESPACE filepoolid:userid
| USERID userid vaddr
| ACCOUNT acctnumber
| ACIGROUP group

Definitions

ABSTRACT owner domainname

Specifies the owner and name of an abstract domain the job is to back up. Use up to 153 non-blank characters for domainname; you can use the characters * or %, but they will not be used as pattern-matching characters. The abstract domain must be specified on a CREATE record in the job template file. This record must be followed by a FROM record.

Note: This parameter is available only through TPI and can only be specified by an authorized client.

ACCOUNT acctnumber

Specifies the number of an account whose minidisks the job is to process differently. You can use pattern matching. Enter * for acctnumber to indicate all minidisks specified on INCLUDE records in the job template file are to be processed differently.

ACIGROUP group

Specifies an ACI security group whose minidisks the job is to process differently. You can use pattern matching. Enter * for group to indicate all minidisks specified on INCLUDE records in the job template file are to be processed differently.

DIRECTORY fqdirname

Specifies the fully-qualified name of an SFS directory that contains files the job is to process differently. You cannot use pattern matching.

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

FILESPACE filepoolid:userid

Specifies a file space the job is to process differently. You can use pattern matching. To process file spaces for a specified user ID for all file pools specified by INCLUDE FILEPOOL records in the job template file differently, enter * for filepoolid. To process file spaces for all user IDs in a specified file pool differently, enter * for userid.

USERID userid vaddr

Specifies the user ID and virtual address of a minidisk the job is to process differently. You can use pattern matching. Enter * for userid to indicate all minidisks specified on INCLUDE records in the job template file are to be processed differently.

SETTAG tag

Specifies an arbitrary string to associate with the domain. The tag can be up to eight non-blank characters; the characters * and % can be used, but they are not used as pattern-matching characters. If you specify more than eight characters, CA VM:Backup truncates the tag to eight characters. Specify tag in subsequent restore and MPC jobs to identify an instance of a domain in a data set on a tape.

Note: This parameter is available only through TPI and can only be specified by an authorized client.