TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • liststoragehistory • admin_barcode • tmss10listhistory
cli:tmss10listhistory

This is an old revision of the document!

Table of Contents

 
 

TMSS10ListHistory

TMSS10ListHistory lists the Storage History for each Repository within the specified date range.

Synopsis

TMSS10ListHistory [-A attribute index] [-C current location] [-I interface filter] [M mode] [-R date range] [-S logon string] [-T target location] [-V volume filter] [-c configuration file] [-t type] [-u user]

Options

  • -A Extended Attribute index (default = 0).
  • -C Current Volume location.
  • -I Interface Filter allows filtering of results by Desktop Software Interface.
  • -M Report mode (default = 1).
  • -R Specifies the date range.
  • -S The Logon string argument sets the Server Logon Information.
  • -T Volume target location.
  • -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.
  • -t Type allows filtering of results by type of database entry.
  • -u User allows filtering of results by User-ID.

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

Mode 1
Report-ID: 104

Mode 2
Report-ID: 105

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

Command line syntax - Mode 1

List history of all LTO Volumes in Customer US02 moved to Repository Offsite by User jsmith between 10 days ago and today. 

TMSS10ListHistory -S user:-password@server -V "US02.LTO.*" -I "*TapeMaster*" -R "*-10:*" -T "OFFS" -u "jsmith"

Output

             System: TapeTrack
          Report ID: 104
 Report Description: TapeTrack Volume History Report (Mode 1)
       Report Notes: From 2020-07-02 to 2020-07-03 (2 days)
    Production Time: Friday, July 03, 2020 - 10:01:51 (AUS Eastern Standard Time)
       Report Width: 300 bytes

Barcode           Seque Time                 User      Old        New        Move Date   Container  Flags  Interface               Notes        
----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------ 
US02.LTO.000037L6     1 2017-11-18 10:38:45  jsmith    LIBR:0     OFFS:0     Permanent   None       CMn    TapeTrack TapeMaster    [Target]   
US02.LTO.000037L6     2 2017-11-20 12:38:50  jsmith    LIBR:0     OFFS:0     Permanent   None       CnO    TapeTrack TapeMaster    [Scanned-In]   

----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------
Report Columns
Column Heading Description
Seq Record sequence number
BarcodeVolume-ID. Default is fully qualified barcode, use TMSSUNQUALIFIEDVOLUME to list unqualified Volume-ID's

Command line syntax - Mode 2

List history of all Scanned-In Media in Customer US03, in Mode 2, moving to or from Repositories LIBR and OFFS, within the last month showing Attribute 1 (Long Barcode). 

TMSS10ListHistory -S user:-password@server -M 2 -V US03.*.* -R M-2:m-0 -t *In* -T "*(OFFS|LIBR)" -C "*(OFFS|LIBR)"

Output

             System: TapeTrack
          Report ID: 105
 Report Description: TapeTrack Volume History Report (Mode 2)
       Report Notes: From 2019-03-01 to 2019-03-31 (31 days)
    Production Time: Friday, April 26, 2019 - 08:42:13 (AUS Eastern Standard Time)
       Report Width: 152 bytes

 Date         Time     Difference      Barcode              User             Old        New        Notes                                    Attribute
 ------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------
 2019-03-26   09:05:23                 US03.LTO.X-539AE4EE  doco             LIBR:0     OFFS:0     [Scanned-In]                             12345678901
              09:05:23             S0  US03.LTO.X-CA93B554  doco             LIBR:0     OFFS:0     [Scanned-In]                             12345678902
              09:05:32             S9  US03.LTO.X-539AE4EE  doco             OFFS:0     LIBR:0     [Scanned-In]                             12345678901
              09:05:32             S0  US03.LTO.X-CA93B554  doco             OFFS:0     LIBR:0     [Scanned-In]                             12345678902
 ------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------
TMSS10ListHistory Changelog
Changelog Cannot load rss feed.
 
Command Line Utilities 
 
cli/tmss10listhistory.1653448645.txt.gz · Last modified: 2025/01/21 22:07 (external edit)