update_job - BAR - Data Stream Architecture - Use the update_job command to update an existing DSA job based on the information from the command line parameters or the XML file if provided. Learn more here.

Purpose

The update_job command updates an existing DSA job based on the information from the command line parameters or the XML file if provided. Parameter values specified in the command line supersede values entered for the same parameters in the XML file.

You cannot use update_job to convert a standard backup or restore job to an incremental restore backup or restore job.

Syntax

update_job -n|-name Name [parameters|File]

Example

dsc update_job -n job1 -f parameters.xml

Parameters

n|name Name

The name of the job on which to perform the action. Must be unique for each job.

Example:  job1

d|description Description

A meaningful description of the job. To allow a multiword description, add \" before and after the description string.

Example:  \"backup web apps\"

t|type Type

[Optional] The type of job. Enter one of the following:

• BACKUP
• RESTORE
• ANALYZE_READ
• ANALYZE_VALIDATE

Example:  backup

o|owner Owner

[This parameter is deprecated after release 15.00. You will receive a warning message if you use this parameter.] The owner of the job. Job ownership is used to determine the appropriate privileges given to DSA users.

Example:  user

b|backup_name BackupName

[Optional] An existing backup job name. For restore, analyze_read, and analyze_validate jobs only.

Example:  backupWeb1

v|backup_version BackupVersion

[Optional] Backup version number. For restore, analyze_read, and analyze_validate jobs only. Enter latest or 0 for the latest save set.

If you specify next_incremental_restore, do not specify a backup version number.

Example:  60

f|file filename

The full file path and file name of the file containing the necessary parameters to create the job. If the same parameters are provided both in the file and on the command line, Teradata DSA uses the values specified in the command line.

Example:  backupjob1.xml

u|user_authentication User

Required when security management is enabled. Supplies the command with the Viewpoint user, and triggers a password prompt for authentication.

Permissions required: DSA Job Permissions: Edit

Usage Notes

You cannot update a retired job.

XML File Example

This command imports information from the XML file created from the export_job command.