TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10zonelist
 
 

TMSS10ZoneList

TMSS10ZoneList lists each Zone and the Volumes assigned to them.

Synopsis

TMSS10ZoneList [-S logon string] [-V volume filter] [-f report format]

Options

If an argument value starts with the value FI:, the value for that attribute will be read from the file name specified immediately after it. For example, if a file named ACME_volumes has the content ACME_*.*, specifying FI:/etc/ACME_volumes will have the same effect as -V ACME.*.*. Using FI: to refer to a file for an attribute value works for all attributes.

If the pattern being matched starts with *LIST: then rather than matching the literal value, each record in the file specified as *LIST:filename will be tested. If one matches the match will succeed.

Technical Support

The TapeTrack Software is commercially supported by a full time help desk staff.

If you are experiencing problems or want some advice on how to configure or use the product please see the Accessing Technical Support page.

Exit Statuses

  1. zero Program has ended successfully.
  2. non-zero Program has not ended successfully.

Environment

Files

stdout: Output Reports.
stderr: Diagnostic messages.
stdin: Program input.

Example

Zone List Report - format 1

Command line syntax

TMSS10ZoneList -S user:-password@server -f 1

Output

             System: TapeTrack
 Report Description: Zone Inventory
       Report Notes: ZoneID(1:1) Description(Drawer 1 divider 1)
 
       Report Width: 113 bytes
 
 Seq.   Customer                                 Media Type           Barcode              Slot       Next Move  
 ------ ---------------------------------------- -------------------- -------------------- ---------- ---------- 
      1 North Carolina Data Center               LTO Cartridge        US03.LTO.000000L5           1.1            
      2 North Carolina Data Center               LTO Cartridge        US03.LTO.000001L5           1.2            
      3 North Carolina Data Center               LTO Cartridge        US03.LTO.000002L5           1.3            
      4 North Carolina Data Center               LTO Cartridge        US03.LTO.000003L5           1.4            
      5 North Carolina Data Center               LTO Cartridge        US03.LTO.000004L5           1.5            
      6 North Carolina Data Center               LTO Cartridge        US03.LTO.000005L5           1.6            
      7 North Carolina Data Center               LTO Cartridge        US03.LTO.000006L5           1.7            
      8 North Carolina Data Center               LTO Cartridge        US03.LTO.000007L5           1.8            
 ------ ---------------------------------------- -------------------- -------------------- ---------- ---------- 
 
             System: TapeTrack
 Report Description: Zone Inventory
       Report Notes: ZoneID(GEMTRAC1) Description(GemTrac Rack 1)
 
       Report Width: 113 bytes
 
 Seq.   Customer                                 Media Type           Barcode              Slot       Next Move  
 ------ ---------------------------------------- -------------------- -------------------- ---------- ---------- 
      1 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000001L6           1.1            
      2 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000005L6          1.16 1970-01-05 
      3 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000024L6          1.19            
      4 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000025L6          1.20            
      5 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000027L6          1.21            
      6 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000028L6          1.22            
      7 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000029L6          1.23            
      8 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000030L6          1.24            
      9 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000031L6          1.25            
     10 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000032L6          1.26            
     11 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000033L6          1.27            
     12 Los Angeles Data Center                  LTO Cartridge        US02.LTO.000034L6          1.28            
 ------ ---------------------------------------- -------------------- -------------------- ---------- ---------- 

Zone List Report - format 2 (default)

Command line syntax

TMSS10ZoneList -S user:-password@server -f 2

Output

             System: TapeTrack
 Report Description: Zone Allocation
    
       Report Width: 112 bytes

 Seq.   Customer                                 Media Type           Repository           Zone                 
 ------ ---------------------------------------- -------------------- -------------------- -------------------- 
      1 Los Angeles Data Center                  LTO Cartridge        Offsite Vault        GEMTRAC1             
      2 -                                        -                    -                    GEMTRAC2             
      3 North Carolina Data Center               LTO Cartridge        Offsite Vault        GEMTRAC4             
           
 ------ ---------------------------------------- -------------------- -------------------- -------------------- 
Changelog
2021-05-24Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127)
2020-12-23Added 3rd reporting option to display detailed Zone Usage
2020-11-24Added support for JSON output
2019-02-25Added support for HTML output
2019-02-09Added support for Excel output
2019-01-06Added return code list to end of all command line programs that use the TapeTrack API
2016-11-18Added fast forward code to reduce runtime
2016-11-18Enhanced argument parser to allow arguments in format *FI:filename that allows loading of arguments from a file
2015-12-26Added flags to Volume Filter syntax (customer.media.volume@repository+flags)
2015-08-24Changed hascontents to contentcount and change contentcount to a filter rather than bool
2015-08-24Added iscontainer and hascontents to the config file filter logic
2015-05-16Added environmental varialbe TMSSCANFILEUNQUALIFIED which will load and check volumes without Customer-ID and Media-ID qualifiers
2015-05-16Added environmental varialbe TMSSSCANFILENOPARSE which will presume scanfile items are only Volumes and not parse them, saving time
2015-05-16When loading scanfile from import definition, added CUSTOMER and MEDIA keywords to set defaults
2015-05-16When loading scanfile from import definition, changed keyword from VOLUME to BARCODE
2015-05-16Added TMSSUNQUALIFIEDVOLUME environmental variable which forces all barcodes to be printed without Customer-ID and Media-ID
2015-05-06Added 2nd reporting option to display Zone Allocation
2015-05-04Added support for AD passwords to all command line programs (check for environmental variable TMSSNOMD5)
2014-11-19Changed server argument parser to allow colon in password to support z/OS DD name files
2014-10-26Upgraded development environment from Visual Studio 2012 to Visual Studio 2013
cli/tmss10zonelist.txt · Last modified: 2022/05/31 03:17 by scunliffe