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.
- d|description Description
- A meaningful description of the job. To allow a multiword description, add \" before and after the description string.
- t|type Type
-
[Optional] The type of job. Enter one of the following:
- BACKUP
- RESTORE
- ANALYZE_READ
- ANALYZE_VALIDATE
- 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.
- b|backup_name BackupName
- [Optional] An existing backup job name. For restore, analyze_read, and analyze_validate jobs only.
- 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.
- 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.
- 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.