retire_job | Teradata DSA Commands - retire_job - BAR - Data Stream Architecture

Teradata® DSA User Guide

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
VMware
Product
BAR
Data Stream Architecture
Release Number
17.20
Published
November 2022
Language
English (United States)
Last Update
2023-11-30
dita:mapPath
bis1632417576364.ditamap
dita:ditavalPath
vwp1576617377804.ditaval
dita:id
cyv1467242268519
Product Category
Software
Teradata Tools and Utilities

Purpose

The retire_job command retires an active job. It does not retire a running or queued status job, or one that is already in the retired state.

Syntax

retire_job -n|-name Name -S|-skip_prompt

Example

dsc retire_job -n job1 -S

Parameters

n|name Name
The name of the job on which to perform the action. Must be unique for each job.
Example: job1
S|skip_prompt SkipPrompt
[Optional] Skips displaying a confirmation message before performing the command action.
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: Run and Edit

Usage Notes

After a job is retired, no status information is returned for the job. The only commands you can use with a retired job are: delete_job, activate_job and list_jobs (with a retired state parameter).

XML File Example

This command does not support an XML file.