qlist media

Updated

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
        
    

Was this page helpful?