INCLUDE Record

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

INCLUDE Record

OPTIONAL

Use an INCLUDE record to indicate the exact parts of domains specified on the preceding EXCEPT record that the job is to include in the backup. You can specify:

Count-key-data (CKD) cylinders and tracks
Fixed-block-architecture (FBA) blocks
CMS or SFS files

You cannot use this record to include BFS files in a backup.

A file can include multiple INCLUDE records. Multiple INCLUDE records that specify the same parameter can follow one EXCEPT record, but not multiple INCLUDE records that specify different parameters. INCLUDE records that specify extents for CKD or FBA can follow the EXCEPT record in any order.

Either INCLUDE or EXCLUDE records can follow one EXCEPT record, but not both.

INCLUDE {“Parms”}

Parms:

  CKD begcyl begtrk endcyl endtrk
| FBA begin end
| FILE filename filetype [RENAME filename filetype]

Definitions

CKD begcyl begtrk endcyl endtrk

Specifies the numbers of the first and last cylinders and tracks of the minidisk extent the job is to back up. If specified, an INCLUDE CKD record must follow an EXCEPT USERID, EXCEPT ACCOUNT, or EXCEPT ACIGROUP record. Authorized clients can specify * * * * on this parameter.

FBA begin end

Specifies the numbers of the first and last blocks of the minidisk extent the job is to back up. If specified, an INCLUDE FBA record must follow an EXCEPT USERID, EXCEPT ACCOUNT, or EXCEPT ACIGROUP record. Authorized clients can specify * * * * on this parameter.

FILE filename filetype

Specifies CMS or SFS files the job is to back up. You can use pattern matching. Enter * for filename to include all files of the specified filetype in the processing; enter * for filetype to include all files with the specified filename in the processing. If specified, an INCLUDE FILE record must follow an EXCEPT record.

RENAME filename filetype

Specifies the name CA VM:Backup is to store on the tape as the name of the file. If you use the RENAME option, you cannot use pattern matching for either FILE filename filetype or RENAME filename filetype. You can enter = for filename or filetype to keep the existing filename or filetype. The RENAME parameter is only valid after an EXCEPT ABSTRACT record.

Note: The RENAME parameter is available only through TPI and can only be used by authorized clients.