Template Programming Interface Guide › Backup Job Template Files › JOBOPTIONS Record

JOBOPTIONS Record

REQUIRED

Use the JOBOPTIONS record to specify job processing options for the job.

A file can include multiple JOBOPTIONS records. Each record can specify more than one parameter; however, a file can include only one of each parameter.

You can override parameter values specified on this record when you submit the job.

Note: Parameters on this record replace the STREAMS record and equivalent parameters on the OPTIONS record. However, CA VM:Backup will continue to accept already imported job template files that include the STREAMS record and the OPTIONS parameters.

JOBOPTIONS {“Parms”}...

Parms:

  EXCLUSIVE {YES | NO}
| HOLD {YES | NO}
| JOBEND {NOTIFY | QUIET}
| ONETIME {YES | NO}
| PRIORITY {YES | NO}
| REDUCE {REMOUNTS | TAPEUSE}
| STREAMS number

Definitions

EXCLUSIVE {YES | NO}

Specifies whether CA VM:Backup is to prevent other jobs from running while this job runs. CA VM:Backup will not start an exclusive job until all running jobs have completed and will not allow other jobs to start until the exclusive job has completed.

Jobs that back up CA VM:Backup are always exclusive and ignore this parameter.

Note: This parameter is available only through TPI. Using EXCLUSIVE YES will prevent you from managing the job template file through the CA VM:Backup screens.

HOLD {YES | NO}

Specifies whether CA VM:Backup is to place the job in the job queue in hold status. To run a held job, the operator or system administrator must release it using the Manage System Activity operator screen or the RELEASE command.

Note: This parameter is available only through TPI. Using HOLD YES will prevent you from managing the job template file through the CA VM:Backup screens

JOBEND {NOTIFY | QUIET}

Specifies whether CA VM:Backup is to issue the JOBEND command to the submitting user ID to inform it that the job completed or was canceled. NOTIFY tells CA VM:Backup to notify the submitting user ID. QUIET tells CA VM:Backup not to notify the submitting user ID.

Note: This parameter is available only through TPI. Using JOBEND NOTIFY will prevent you from managing the job template file through the CA VM:Backup screens.

ONETIME {YES | NO}

Specifies whether CA VM:Backup is to erase the job template file and any associated exception and exclusion files from the CA VM:Backup 191 minidisk when the job either runs successfully or is canceled.

Note: This parameter is available only through TPI. Using ONETIME YES will prevent you from managing the job template file through the CA VM:Backup screens.

PRIORITY {YES | NO}

Specifies whether to submit the job at the top of the job queue, after any existing priority jobs. CA VM:Backup runs priority jobs before any other job in the queue. The only way another job can run ahead of a priority job is when the jobs are reordered using the ORDER command.

Note: This parameter is available only through TPI. Using PRIORITY YES will prevent you from managing the job template file through the CA VM:Backup screens.

REDUCE {REMOUNTS | TAPEUSE }

Indicates whether CA VM:Backup is to remount tapes already written to.

REMOUNTS prevents CA VM:Backup from remounting tapes in most situations, which can make backup jobs run more quickly. If your data center uses automatic cartridge loaders (ACLs), you might want to specify REMOUNTS. Depending on the control setting for your ACL, it might not be able to remount a tape that has already been mounted in the currently running job. This is true if the control setting on the ACL is set to AUTOMATIC. This might also be true if the control setting is set to SYSTEM and the software you use to mount tapes cannot handle this situation.

TAPEUSE allows CA VM:Backup to remount tapes that have already been written to in the currently running backup job, minimizing the number of tapes needed for the job.

For more information about tape remounts, see the chapter "Managing Tape and DASD Resources" in the System Programmer Reference Guide.

STREAMS number

Specifies the number of output streams the job is to use. Specify an integer from 1 through 15. The default is 1.

You might need to increase the virtual storage size for CA VM:Backup if you are submitting jobs that have a large number of streams. For more information about virtual storage requirements, see the chapter "Customizing CA VM:Backup" in the System Programmer Reference Guide.