TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • tmss10listhistory
cli:tmss10listhistory

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.

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

Notes

Mode 1 2 3 4 5
Report-ID 104 105 113 121 122

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 "US04.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        
----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------ 
US04.LTO.000037L6     1 2017-11-18 10:38:45  jsmith    LIBR:0     OFFS:0     Permanent   None       CMn    TapeTrack TapeMaster    [Target]   
US04.LTO.000037L6     2 2017-11-20 12:38:50  jsmith    LIBR:0     OFFS:0     Permanent   None       CnO    TapeTrack TapeMaster    [Scanned-In]   

----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------

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 US04.*.* -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                 US04.LTO.X-539AE4EE  doco             LIBR:0     OFFS:0     [Scanned-In]                             12345678901
              09:05:23             S0  US04.LTO.X-CA93B554  doco             LIBR:0     OFFS:0     [Scanned-In]                             12345678902
              09:05:32             S9  US04.LTO.X-539AE4EE  doco             OFFS:0     LIBR:0     [Scanned-In]                             12345678901
              09:05:32             S0  US04.LTO.X-CA93B554  doco             OFFS:0     LIBR:0     [Scanned-In]                             12345678902
 ------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------

Command line syntax - Mode 3

TMSS10ListHistory -S user:-password@server -V "US03.LTO.*" -R *-30:* -M 3

Output

             System: TapeTrack
          Report ID: 113
 Report Description: TapeTrack Volume History Report (Mode 3)
    Production Time: Thursday, January 05, 2023 - 10:58:59 (AUS Eastern Daylight Time)
       Report Width: 188 bytes

 Barcode              Last-Write           Last-Move            Elapsed          Last-ScanOut         Elapsed          Last-ScanIn          Elapsed          Attribute                      
 -------------------- -------------------- -------------------- ---------------- -------------------- ---------------- -------------------- ---------------- ------------------------------ 
 US03.LTO.000000L4                         2022-12-29 11:54:55               S0                                        2022-12-29 11:56:26            M1:31  desc four                      
 US03.LTO.000001L4                         2022-12-29 11:54:55               S0                                        2022-12-29 11:56:26            M1:31  sample three                   
 US03.LTO.000002L4                         2022-12-29 11:54:55               S0                                        2022-12-29 11:56:26            M1:31  sample one                     
 US03.LTO.000003L4                         2022-12-29 11:54:55               S0                                        2022-12-29 11:56:26            M1:31  sample three                   
 US03.LTO.000004L4                         2022-12-29 11:54:55               S0                                        2022-12-29 11:56:27            M1:32  sample four                    
 US03.LTO.000005L4                         2022-12-29 11:42:19               S0                                        2022-12-29 11:43:06              S47  sample four                    
 US03.LTO.000006L4                         2022-12-29 10:18:16               S0  2022-12-29 10:29:39           M11:23  2022-12-29 10:32:29           M14:13  sample four                    
 US03.LTO.000007L4                         2022-12-29 10:18:16               S0  2022-12-29 10:29:39           M11:23  2022-12-29 10:32:29           M14:13  sample four                    
 US03.LTO.000008L4                         2022-12-29 10:18:16               S0  2022-12-29 10:29:39           M11:23  2022-12-29 10:32:29           M14:13  sample three                   
 US03.LTO.000009L4                         2022-12-29 11:05:12               S0  2023-01-03 11:16:23      D5:00:11:11                                        sample one                     
 US03.LTO.000010L4                         2022-12-29 11:05:12               S0                                                                              sample one                     
 -------------------- -------------------- -------------------- ---------------- -------------------- ---------------- -------------------- ---------------- ------------------------------

Command line syntax - Mode 4

List all Volume Attribute updates for US03 LTO filtered on update date and time, including User-ID and Attribute values. 

TMSS10ListHistory -S user:-password@server -V "US03.LTO.*" -R *-30:* -M 4

Output

             System: TapeTrack
          Report ID: 121
 Report Description: TapeTrack Volume Attribute History Report by Date (Mode 4)
       Report Notes: From 2022-12-06 to 2023-01-05 (31 days)
    Production Time: Thursday, January 05, 2023 - 10:52:42 (AUS Eastern Daylight Time)
       Report Width: 113 bytes

 Barcode              User             Date       Time     Type                                     Attribute    
 -------------------- ---------------- ---------- -------- ---------------------------------------- ------------ 
 US03.LTO.000000L4    doco             2023-01-05 10:38:08 Description                              desc one     
 US03.LTO.000000L4    doco             2023-01-05 10:38:32 Description                              desc two     
 US03.LTO.000000L4    demo             2023-01-05 10:48:30 Description                              desc four    
 US03.LTO.000000L4    demo             2023-01-05 10:48:30 Description                              desc three   
 US03.LTO.000002L4    demo             2023-01-05 10:48:49 Description                              sample one   
 US03.LTO.000010L4    demo             2023-01-05 10:49:07 Description                              sample one   
 US03.LTO.000009L4    demo             2023-01-05 10:49:07 Description                              sample one   
 US03.LTO.000001L4    demo             2023-01-05 10:49:25 Description                              sample one   
 US03.LTO.000003L4    demo             2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000006L4    demo             2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000007L4    demo             2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000004L4    demo             2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000005L4    demo             2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000004L4    demo             2023-01-05 10:49:49 Description                              sample two   
 US03.LTO.000008L4    demo             2023-01-05 10:50:08 Description                              sample three 
 US03.LTO.000005L4    demo             2023-01-05 10:50:08 Description                              sample two   
 US03.LTO.000008L4    demo             2023-01-05 10:50:08 Description                              sample one   
 US03.LTO.000007L4    demo             2023-01-05 10:50:08 Description                              sample two   
 US03.LTO.000006L4    demo             2023-01-05 10:50:08 Description                              sample two   
 US03.LTO.000001L4    doco             2023-01-05 10:51:26 Description                              sample two   
 US03.LTO.000001L4    doco             2023-01-05 10:51:26 Description                              sample three 
 US03.LTO.000003L4    doco             2023-01-05 10:51:26 Description                              sample two   
 US03.LTO.000003L4    doco             2023-01-05 10:51:26 Description                              sample three 
 US03.LTO.000007L4    doco             2023-01-05 10:51:44 Description                              sample three 
 US03.LTO.000007L4    doco             2023-01-05 10:51:44 Description                              sample four  
 US03.LTO.000005L4    doco             2023-01-05 10:51:55 Description                              sample four  
 US03.LTO.000005L4    doco             2023-01-05 10:51:55 Description                              sample three 
 US03.LTO.000004L4    doco             2023-01-05 10:51:55 Description                              sample four  
 US03.LTO.000006L4    doco             2023-01-05 10:51:55 Description                              sample three 
 US03.LTO.000006L4    doco             2023-01-05 10:51:55 Description                              sample four  
 US03.LTO.000004L4    doco             2023-01-05 10:51:55 Description                              sample three 
 -------------------- ---------------- ---------- -------- ---------------------------------------- ------------

Command line syntax - Mode 5

List Volumes Attribute updates filtered by User-ID for US03 LTO in the last 30 days using Mode 5. 

TMSS10ListHistory -S user:-password@server -V "US03.LTO.*" -R *-30:* -M 5

Output

             System: TapeTrack
          Report ID: 122
 Report Description: TapeTrack Volume Attribute History Report by User (Mode 5)
       Report Notes: User demo
    Production Time: Thursday, January 05, 2023 - 10:53:31 (AUS Eastern Daylight Time)
       Report Width: 96 bytes

 Barcode              Date       Time     Type                                     Attribute    
 -------------------- ---------- -------- ---------------------------------------- ------------ 
 US03.LTO.000000L4    2023-01-05 10:48:30 Description                              desc four    
 US03.LTO.000000L4    2023-01-05 10:48:30 Description                              desc three   
 US03.LTO.000002L4    2023-01-05 10:48:49 Description                              sample one   
 US03.LTO.000009L4    2023-01-05 10:49:07 Description                              sample one   
 US03.LTO.000010L4    2023-01-05 10:49:07 Description                              sample one   
 US03.LTO.000001L4    2023-01-05 10:49:25 Description                              sample one   
 US03.LTO.000006L4    2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000007L4    2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000003L4    2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000005L4    2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000004L4    2023-01-05 10:49:36 Description                              sample one   
 US03.LTO.000004L4    2023-01-05 10:49:49 Description                              sample two   
 US03.LTO.000005L4    2023-01-05 10:50:08 Description                              sample two   
 US03.LTO.000007L4    2023-01-05 10:50:08 Description                              sample two   
 US03.LTO.000008L4    2023-01-05 10:50:08 Description                              sample three 
 US03.LTO.000008L4    2023-01-05 10:50:08 Description                              sample one   
 US03.LTO.000006L4    2023-01-05 10:50:08 Description                              sample two   
 -------------------- ---------- -------- ---------------------------------------- ------------ 

             System: TapeTrack
          Report ID: 122
 Report Description: TapeTrack Volume Attribute History Report by User (Mode 5)
       Report Notes: User doco
    Production Time: Thursday, January 05, 2023 - 10:53:31 (AUS Eastern Daylight Time)
       Report Width: 96 bytes

 Barcode              Date       Time     Type                                     Attribute    
 -------------------- ---------- -------- ---------------------------------------- ------------ 
 US03.LTO.000000L4    2023-01-05 10:38:08 Description                              desc one     
 US03.LTO.000000L4    2023-01-05 10:38:32 Description                              desc two     
 US03.LTO.000001L4    2023-01-05 10:51:26 Description                              sample three 
 US03.LTO.000003L4    2023-01-05 10:51:26 Description                              sample two   
 US03.LTO.000003L4    2023-01-05 10:51:26 Description                              sample three 
 US03.LTO.000001L4    2023-01-05 10:51:26 Description                              sample two   
 US03.LTO.000007L4    2023-01-05 10:51:44 Description                              sample three 
 US03.LTO.000007L4    2023-01-05 10:51:44 Description                              sample four  
 US03.LTO.000005L4    2023-01-05 10:51:55 Description                              sample four  
 US03.LTO.000005L4    2023-01-05 10:51:55 Description                              sample three 
 US03.LTO.000004L4    2023-01-05 10:51:55 Description                              sample four  
 US03.LTO.000004L4    2023-01-05 10:51:55 Description                              sample three 
 US03.LTO.000006L4    2023-01-05 10:51:55 Description                              sample three 
 US03.LTO.000006L4    2023-01-05 10:51:55 Description                              sample four  
 -------------------- ---------- -------- ---------------------------------------- ------------
Changelog
Changelog
2021-05-24Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127)
2020-11-24Added support for JSON output
2019-03-25Added -A argument to specify Attribibute Index
2019-03-25Added Report Mode=2
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
2018-07-27Added Interface Filter argument
2018-07-27Added Interface to report
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
2016-08-25Added flags to report
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-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-11-16Changed to standard report format
2014-11-16Added change type filter
2014-10-26Upgraded development environment from Visual Studio 2012 to Visual Studio 2013
 
Command Line Utilities 
 
cli/tmss10listhistory.txt · Last modified: 2023/01/05 06:07 by scunliffe

Page Tools