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

EXCEPT Record

REQUIRED

Use EXCEPT records to specify domains to process differently than specified in the restore job template file; CA VM:Backup processes the domains as described in the exception file.

At least one EXCEPT record is required in an exception file. A file can include multiple EXCEPT records.

In an exception file for a VOLSER restore job, each EXCEPT record must match one INCLUDE record in the job template file, and you can specify only one EXCEPT record for each INCLUDE record.

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

Parms:

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

Definitions

ABSTRACT owner domainname

Specifies the owner and name of an abstract domain the job is to process differently. 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. You must specify a RESTO record for each EXCEPT ABSTRACT 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.

BFSDIRECTORY filespace fulldirpathname

Specifies the file space and full directory pathname of a BFS directory 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

DIRECTORY fqdirname

Specifies the fully-qualified directory name of a 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.

MATCHTAG tag

Specifies an arbitrary string used to identify a specific instance of a domain in a data set on a tape. The tag, tag, can be up to eight non-blank characters; the characters * or % can be used, but they are not used as pattern-matching characters. If a client specifies more than eight characters, CA VM:Backup truncates the tag to eight characters.

To identify a specific domain, a client specifies the exact tag name that was specified with the SETTAG parameter on the EXCEPT record in the exception file for the backup job or the COPY record in an MPC job template file.

If a client specifies the MATCHTAG parameter, CA VM:Backup searches for a domain that has tag associated with it. If the domain is found, but does not have tag associated with it, CA VM:Backup does not restore the data. You cannot use this parameter with the BFSDIRECTORY parameter.

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