run_repository_job | Teradata DSA Commands - 17.20 - run_repository_job - BAR - Data Stream Architecture

Teradata® DSA User Guide

Data Stream Architecture
Release Number
November 2022
Last Update
Content Type
User Guide
Publication ID
English (United States)
Last Update


The run_repository_job command runs a job in the DSC repository.

DSA 17.02.00 adds replication so your repository backup goes to a landing zone and is then replicated to third party storage.

  • The run_repository_job command can only be initiated if no operational jobs are running.
  • The -n parameter is no longer supported.
  • The -v parameter is only supported for backup jobs when used with the -r parameter. It is also supported for the new replicate job type. It is an optional parameter for restore and analyze jobs. If -v is not entered for a restore or analyze job, it defaults to the latest successful backup job version.
  • You do not need to specify a target name for restore or analyze jobs; if you do not, the command takes the target name configured in config_repository_backup.


run_repository_job -t|-type Type

run_repository_job -t|-type backup -r|repository_replication rep_tg_name

run_repository_job -v|backup_version

run_repository_job -v|backup_version -n|name


dsc run_repository_job -t backup

dsc run_repository_job -t backup -r replication-tg-aws (back up repository to landing zone and replicate to target group)

dsc run_repository_job -t replicate-to -r replication-tg-aws -v 157838495 (replicate the particular backup saveset to the target group

dsc run_repository_job -t replicate_from -r replication-tg-aws -v 157838495 (replicate the particular backup saveset from the target group to the landing zone)


t|type Type
Enter backup, replicate_to, replicate_from, restore, analyze_validate, or analyze_read.
r|replication_target rep_tg_name
[Optional] Target group for replication. If not specified, backs up the repository only to landing zone.
v|backup_version BackupVersion
[Optional] Backup version number to be replicated to or from third party storage. This number is visible in the backup filename (bar_123456789.out)

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

Example: 123456789
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: Administrator

Usage Notes

This command automatically generates backup, restore, and analyze jobs based on the repository backup target group configuration the user created.

XML File Example

This command does not support an XML file.