qoperation jobcontrol

Description

This command allows you to kill, resume, suspend, or change/set the progress (in percentage) of a given job. To operate on a single job, specify the Job ID. To operate on more than one job in a specific area, specify the client or MediaAgent name. You can also specify additional levels such as the agent, instance, backup set and/or subclient. The -all option can be used to suspend/resume all jobs.

If the operation is successful, no message is displayed on the command prompt. In case of an error, an error code and description are displayed as: "jobcontrol: Error errorcode: errordescription"

Usage

qoperation jobcontrol [-o $[joboperation]] [-j $[jobid] - all [-m $[media_agent]] [-c $[client]] [-a $[dataagenttype]] [-i $[instance]] [-b $[backupset]] [-s $[subclient]] [-p $[priority]] [-tfx $[total files to transfer]] [-fx $[files transferred]] [-ifx $[files transferred since last update]] [-tbx $[total bytes to transfer]][-tf $[tokenfile]] [-tk $[token]] [-h]

Options

-o	Operation to be performed on the job. Valid values are: kill suspend resume changepriority
-j	Job ID
-all	All jobs
-m	MediaAgent name
-c	Client computer name
-a	iDataAgent type installed on client computer (see Argument Values - Agent Types)
-i	Instance name
-b	Backup set name
-s	Subclient name
-p	Job priority
-tfx	Total files to transfer
-fx	Files transferred
-ifx	Files transferred since last update
-tbx	Total bytes to transfer
-tf	Reads token from a file
-tk	Token string
-h	Displays help

Diagnostics

Possible exit status values are:

0 - Successful completion.

1 - CLI usage failures, due to the use of an unsupported option or missing argument.

2 - Any other failure.

Example

Kill a job with job ID 175.

qoperation jobcontrol -j $[75] -o $[kill]

Suspend all jobs under MediaAgent ma1.

qoperation jobcontrol -m $[ma1] -o $[suspend]

Suspend all jobs.

qoperation jobcontrol -all -o $[suspend]

Resume all jobs under client cl1 and dataagent "Q_WIN2K_FS".

qoperation jobcontrol -c $[cl1] -a $[Q_WIN2K_FS] -o $[resume]

Change priority of a job with job ID 175 to 100.

qoperation jobcontrol -j $[75] -p $[100] -o $[changepriority]