TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • tmss10inventory
cli:tmss10inventory
← Adding and Maintaining Barcode Definitions  
 Adding and Maintaining Stock Control Items →

This is an old revision of the document!

← Adding and Maintaining Barcode Definitions  
Advanced Usage  
 Adding and Maintaining Stock Control Items →

Table of Contents

 
 

TMSS10Inventory

TMSS10Inventory produces an Inventory Report of all selected Volumes.

By default, this program accepts pairs of Integers as arguments, with each successive pair representing the next column within a CSV file.

The first Integer is the zero-based offset within the output file, and the second is the length of the field that is output.

Alternatively, if the first argument of the first pair contains a colon, the Integer on the left-hand side of the colon will set the relative column, and any future pair will be offset from that column. In the event that other pairs also start with a colon, this too will set the column and future columns from that column index.

In the event that the program is run with no arguments, the program will display a suggested calling syntax taking into account the maximum values calculated by processing the supplied data.

Synopsis

TMSS10Inventory [-A attribute index] [-M mode] [-N no relative resolve] [-R output a scan list file] [-S logon string] [-V volume filter] [-c configuration file]

Options

  • -A Attribute Index (default = 0)
  • -M Sets the output mode.
  • -N No relative resolve.
  • -R Outputs results to a scan list file.
  • -S The Logon string argument sets the Server Logon Lnformation.
  • -V Volume Filter which can be used to filter the traversal of Customer, Media, Volume, Repository and Flag values.
  • -c The config file argument specifies the path to the Batch Configuration File. The Batch Configuration File allows you to perform advanced traversal of Customer, Media and Volumes, perform advanced Barcode pre and post-processing and route program output to syslogd.

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.

2021/06/16 02:14 · Scott Cunliffe

To include multiple Attributes in the report, add the required Attribute indexes separated by a comma (eg. -A 1,2,5).

2021/07/02 01:35 · Scott Cunliffe

Notes

Running TMSS10Inventory in mode 1 (default) will produce a report with the values: Sequence, Barcode, Location, Repository, Next Move, Days, Last Move, GDup (Global Duplicate), CDup (Customer Duplicate) and Container.

Running TMSS10Inventory in mode 2 will produce a report with the values: Sequence, Customer, Media, Total and Moving total.

TMSS10Inventory output can include up to twenty attributes in the one report. To include more than one attribute, include attribute indexes seperated by commas using -A in the program call. For example to add attributes 0, 1 and 3 in the report use -A “0,1,3.

If the report is output to text, CSV, PDF attribute values over 30 characters long will be truncated to 28 characters and two full stops to indicate a truncated value (eg ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890 will show as ABCDEFGHIJKLMNOPQRSTUVWXYZ12..). Reports output to Excel will show full attribute values irrespective of character length.

Mode 1
Report-ID: 100

Mode 2
Report-ID: 101

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

Customer US03 LTO inventory - Report Format 1

Command line syntax

TMSS10Inventory -S user:-password@server -V "US03.LTO.*" -M 1

Output

             System: TapeTrack
          Report ID: 100
 Report Description: Inventory List
       Report Notes: Customer(North Carolina Data Center) Media Type(LTO Cartridge)
    Production Time: Wednesday, September 27, 2017 - 12:27:33 (AUS Eastern Standard Time)
       Report Width: 161 bytes
 Seq.   Barcode              Location           Repository         Next Move  Days    Last Move        GDup CDup Container            
 ------ -------------------- ------------------ ------------------ ---------- ------ ---------------- ---- ---- -------------------- 
      1 US03.LTO.000000L5    1:2 [1.1]          Offsite Vault [21]                    2017-07-28 01:26    1    1                      
      2 US03.LTO.000001L5    1:2 [1.2]          Offsite Vault [22]                    2017-07-28 01:26    1    1                      
      3 US03.LTO.000002L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
      4 US03.LTO.000003L5    1:2 [1.3]          Offsite Vault [23]                    2017-07-28 02:03    1    1                      
      5 US03.LTO.000004L5    1:2 [1.4]          Offsite Vault [24]                    2017-07-28 01:26    1    1                      
      6 US03.LTO.000005L5    No-Alloc [0]       Library                               2017-07-28 02:04    1    1                      
      7 US03.LTO.000006L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
      8 US03.LTO.000007L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
      9 US03.LTO.000008L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     10 US03.LTO.000009L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     11 US03.LTO.000010L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     12 US03.LTO.000011L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     13 US03.LTO.000012L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     14 US03.LTO.000014L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     15 US03.LTO.000015L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     16 US03.LTO.000016L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     17 US03.LTO.000017L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     18 US03.LTO.000018L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     19 US03.LTO.000019L5    No-Alloc [0]       Library                               2017-07-28 01:26    1    1                      
     20 US03.LTO.000020L5    No-Alloc [0]       Library                               2017-06-08 05:58    1    1                      
     21 US03.LTO.000021L5    No-Alloc [0]       Library                               2017-06-08 06:01    1    1                      
     22 US03.LTO.000022L5    No-Alloc [0]       Library                               2017-07-11 01:45    1    1                      
     23 US03.LTO.000023L5    No-Alloc [0]       Library                                                   1    1                          
-----------------------------------------------------------------------------------------------------------------
Column Heading Description
Seq Record sequence number
BarcodeVolume-ID. Default is fully qualified barcode, use TMSSUNQUALIFIEDVOLUME to list unqualified Volume-ID's
LocationVolume location: No-Alloc [0] = no Slot allocated, 1:2 [1.3] = Zone-ID 1:2, Shelf 1, Slot 3
RepositoryRepository Volume is currently located in
ExpiryExpiry of retention date
Next MoveDate of next move, Permanent = No next move
Last MoveLast date the Volume was moved
GDupGlobal wide number of the Volume-ID, 1 = one instance or no duplicates
CDupCustomer wide number of the Volume-ID, 1 = one instance or no duplicates
ContainerContainer-ID if Volume is assigned to a Container, blank = not assigned to a container.

Customer US03 LTO inventory - Report Format 2

Command line syntax

TMSS10Inventory -S user:-password@server -V "US03.LTO.*" -M 2

Output

             System: TapeTrack
 Report Description: Volume Inventory Extract
    Production Time: Wednesday, September 27, 2017 - 12:28:26 (AUS Eastern Standard Time)
       Report Width: 92 bytes
 
 Seq.   Customer                                 Media                Total      Moving     
 ------ ---------------------------------------- -------------------- ---------- ---------- 
      1 North Carolina Data Center               LTO Cartridge               102         20

Changelog

Cannot load rss feed.
 
Command Line Utilities 
 
cli/tmss10inventory.1642728323.txt.gz · Last modified: 2025/01/21 22:07 (external edit)