VOLSER Restore Job Template File

Template Programming Interface Guide › Restore Job Template Files › VOLSER Restore Job Template File

VOLSER Restore Job Template File

The following table outlines the structure of a VOLSER restore job template file. The table lists the records in the order you or an authorized client might use them in a file.

Record	Information Specified	Required	Quantity Allowed
JOB	Type of job set up in file	Yes	1; first in file
COMMENT	Comment	No	1
*¹	Additional comments	No	Multiple
JOBOPTIONS	General job processing options	No	Multiple
OPTIONS	Domain-level job processing options	No	Multiple
REPORT	Report options	No	Multiple
EXCEPTIONS	Name of exception file for job	Yes	1
EXCLUSIONS	Name of exclusion file for job	No	1
INCLUDE	DASD volumes, file pools, or domains that contain data to restore	Yes	At least 2
CHECKSUM	Number that protects file from manual modification²	No	1; last in file

¹ When a job is exported from CA VM:Backup, all *records appear in order after the COMMENT record or, if no COMMENT record is specified, at the beginning of the file

² Used by authorized clients only.

Example VOLSER Restore Template File

The following example shows a VOLSER restore job template file named VOLSER $TEMPLAT. This file defines a restore job that restores four minidisks belonging to three user IDs and two SFS directories residing in different file pools. Exceptions are defined in the VMAE0003 $XCEPT file that will be applied during the restore.

JOB RESTORE TYPE VOLSER
* Define general job processing options
JOBOPTIONS ONETIME YES
JOBOPTIONS JOBEND NOTIFY

* Define domain-level restore options 
OPTIONS DIRSCAN NO
OPTIONS RESLINK MULT
OPTIONS RESDEV EXCEPTION

REPORT REPDETAIL FILE
REPORT REPDEST VMARCH
REPORT REPCLASS A
REPORT KEYWORD YES

EXCEPTIONS VMAE0003
INCLUDE DASD *
INCLUDE FILEPOOL *
INCLUDE USERID TEST1 191
INCLUDE USERID TEST2 200
INCLUDE USERID VMARCH 200
INCLUDE USERID VMARCH 210
INCLUDE DIRECTORY SFS:TEST1.FIRST.SECOND
INCLUDE DIRECTORY VMSYSU:TEST1.TEST.SCRIPTS

* Record

OPTIONAL

Use the * record to add comments to job template files in addition to the comment specified on the COMMENT record. When you manage job template files through the CA VM:Backup screens, CA VM:Backup displays the comment on the COMMENT record on the screen; comments on * records are not displayed on the screen.

You can use * records with the COMMENT record or by themselves, and you can include as many as you need. You can place * records anywhere in the file after the JOB record; however, when the file is exported, CA VM:Backup places all * records in order after the COMMENT record or, if no COMMENT record exists, after the JOB. This record is available only through TPI. However, using it will not prevent you from managing the template through the CA VM:Backup screens record.

Note: The record is available only through TPI. However, using it will not prevent you from managing the template through the CA VM:Backup screens.

* [text]

Definitions

text: Can include up to 80 characters of comment text; any additional text is truncated. You must enter the asterisk (*) in column 1 of the record. You can use uppercase and lowercase letters; when you import or export the file, text case is preserved.