Description
This command displays the following information about all the media used by a given job, storage policy, storage policy copy, and library:
-
Barcode
-
Location
-
Library
-
Storage policy
-
Storage policy copy
-
Status
-
Retain until date
-
Last export time
-
Creation time
-
Scratch pool (for example, Cleaning Media and Default Scratch)
-
Media type (for example, ULTRIUM V4 and ULTRIUM V5)
-
Total data (GB)
-
Last backup time
-
Last restore time
Since barcodes are not applicable for disk libraries, CV_MAGNETIC is displayed if the job uses a disk library. Whenever more than one media is used by a job, each media is listed on its own line on the command prompt. The message "No media have been allocated for this job" is displayed whenever media is not used by the job.
In case of an error, an error code and description are displayed as: "media: Error errorcode: errordescription"
Usage
qlist media -j <jobid> [-sp <storagepolicy> [-spc <copy>]] -l <library> [-srp <scratchpool>] -loc <exportlocation> -sp <storagepolicy> [-spc <copy>][-tf <tokenfile>] [-tk <token>] [-h]
Options
-j |
Job ID |
-sp |
Storage policy name |
-spc |
Storage policy copy name |
-l |
Library name |
-srp |
Scratch pool name |
-loc |
Export Location |
-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
-
To display all the media associated with job 74:
E:\commandline>qlist media -j 74
-
To display the media in a library named STK9730 and scratch pool Spares:
E:\commandline>qlist media -l STK9730 -srp Spares
-
To display the media in an export location named Shelf_A:
E:\commandline>qlist media -loc Shelf_A
-
To display the media in a storage policy named STK_Tape and storage policy copy TapeCopyTwo:
E:\commandline>qlist media -sp STK_Tape -spc TapeCopyTwo
-
An example output to display the media in a library named STK9730 and scratch pool Spares:
BARCODE LOCATION LIBRARY STORAGEPOLICY COPYNAME STATUS RETAIN UNTILL DATE LAST EXPORT TIME CREATION TIME SCRATCH POOL MEDIA TYPE TOTAL DATA(GB) LAST BACKUP TIME LAST RESTORE TIME
------- -------- ------- ------------- -------- ------ ------------------ ---------------- ------------- ------------ ---------- -------------- ---------------- -----------------
sa0000WW Shelf_A STK9730 STK_Tape Copy1 Idle now Mon Dec 11 14:40:02 2017 Wed Oct 4 11:41:16 2017 Spares Virtual Tape 0.00 Mon Jun 25 11:25:54 2018 Mon Jun 27 11:35:34 2018