Previous Topic: Record Type and ValueNext Topic: Specifying Special Processing Options


Include/Exclude List

An Include/Exclude List allows you to specify the CMS or SFS files, CKD tracks, or FBA blocks to include in or exclude from the job. By default, all data on the specified minidisk (or SFS file space, for backup jobs) is included.

When you define an include list, CA VM:Backup backs up or restores only the specified CMS files, tracks, or blocks for the indicated minidisks, or the specified SFS files for SFS file spaces. A partial restore of a physically backed-up CKD or FBA minidisk requires a target minidisk of the same disk-type and size as the original minidisk. For example, if a minidisk is backed up as a physical minidisk existing from cylinders 0-49, and you intend to restore cylinders 10 and 11, you must allocate a minidisk of the same disk-type and size (50 cylinders), even though you are restoring only two cylinders.

When you define an exclude list, CA VM:Backup does not back up or restore any of the CMS or SFS files, tracks, or blocks that are specified on that list. CA VM:Backup processes all other files, tracks, or blocks on the indicated minidisks and file spaces according to the specified job processing options.

If no include or exclude list exists, CA VM:Backup displays No list is defined in the Include/Exclude List column on the Work with Exception File filename screen. If you define a list, CA VM:Backup updates this column to identify the type of list that you created.

Note: You cannot specify a list of BFS files to include or exclude from a BFS file space. CA VM:Backup can encounter a BFS file space for which the exception file contains a list of SFS files to include or exclude. The product ignores the list of files.

Screen Commands

To define an include or exclude list, enter one of the commands that are listed below. Select the command that is appropriate for the type of data that the command is to process. When you enter one of these commands in the Command column next to a record type, CA VM:Backup displays an In/Exclude screen. On the In/Exclude screen, select either Include or Exclude to indicate whether to include or exclude data from processing. Then, list the specific files, tracks, or blocks to include or exclude.

CKDLIST

Valid for: CKD minidisk (CMS or non-CMS)

On the In/Exclude screen, specify the range of cylinders and tracks to include or exclude during the processing of the minidisk.

From CYL TRK

Specify the first (or only) cylinder and track to include or exclude. In the CYL field, enter the starting cylinder number; specify a number within the bounds of the minidisk. In the TRK field, enter the starting track number; specify a supported value for the disk type.

To CYL TRK

If more than one cylinder and track is included or excluded, specify the ending cylinder and track numbers. The ending cylinder or track numbers cannot precede the starting cylinder and track numbers.

CMSLIST

Valid for: CMS minidisk

On the In/Exclude screen, specify the filenames and filetypes of the files to include or exclude when the minidisk is processed.

You can use pattern matching.

FBALIST

Valid for: FBA minidisk (CMS or non-CMS)

On the In/Exclude screen, specify the range of blocks to include or exclude during the processing of the minidisk.

From Block

Specify the first (or only) block to include or exclude; this number must be within the boundaries of the minidisk.

To Block

If more than one block is being included or excluded, specify the ending block number. The ending block cannot precede the starting block number.

SFSLIST

Valid for: SFS file space

On the In/Exclude screen, specify the filenames and filetypes of the files to include or exclude during the processing of the file space.

You can use pattern matching.