qlist jobhistory

Updated

Description

This command displays the backup job history of a given subclient. It displays job details such as job ID, status and the associated storage policy.

When more than one backup job is found, the jobs are listed one job per line in the command prompt. The system displays the message "No job history found" when no job history is found.

In case of an error, an error code and the error description are displayed in the following format: "jobhistory: Error errorcode: errordescription"

Usage

qlist jobhistory [-cs <commserve_host_name>] -c <client> -a <iDataAgent> -i <instance> -b <backupset> -s <subclient> [-js <jobstatus>] [-st <start time>] [-et <end time>] [-dispJobTime <displays job time>] [-dispJobTimeUnix <displays unix time>] [-tf <tokenfile>] [-tk <token>] [-h]
    

Options

-cs

CommServe host 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

-js

Filters the jobs by status. Valid values are:

  • Completed

  • Failed

  • Killed

-st

Start time

The time must be entered in the following format: mm/dd/yyyy hh:mm[:ss] or yyyy/mm/dd hh:mm[:ss].

-et

End time

The time must be entered in the following format: mm/dd/yyyy hh:mm[:ss] or yyyy/mm/dd hh:mm[:ss].

-dispJobTime

Displays the job start and end time

-dispJobTimeUnix

Displays the job start and end time in Unix time format

-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

Lists the backup job history of subclient subclient1 for a File System Agent:

E:\commandline>qlist jobhistory -c client1 -a Q_WIN2K_FS -b backupset1 -s subclient1
JOBID  STATUS     Subclient   STORAGEPOLICY
-----  ---------  ---------   ------------- 
160    Completed  subclient1  SP_12
 161    Completed  subclient1  SP_12
    

Was this page helpful?