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