TapeTrack Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== TMSS10ListHistory ======

TMSS10ListHistory lists the Storage History for each [[object:repository|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 [[object:volume|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 [[cli:server_argument|Server Logon Information]].
  * ''-T'' [[object:volume|Volume]] target location.
  * ''-V''  [[cli:volume_filter|Volume Filter]] which can be used to filter the traversal of Customer, Media, Volume, repository and [[common:volume_flags|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 [[object:customer|Customer]], [[object:media|Media]] and [[object:volume|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 [[object:user|User-ID]].

{{page>cli:fi}}

{{page>cli:attribute}}
===== 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 [[common:support_details|Accessing Technical Support]] page.

==== Exit Statuses ====

  - **zero** Program has ended successfully.
  - **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 [[object:volume|Volumes]] in [[object:customer|Customer]] US02 moved to [[object:repository|Repository]] Offsite by [[object:user|User]] jsmith between 10 days ago and today.

<code>
TMSS10ListHistory -S user:-password@server -V "US04.LTO.*" -I "*TapeMaster*" -R "*-10:*" -T "OFFS" -u "jsmith" 
</code>
=== Output ===
<code>

             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]   

----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------
  </code>



==== Command line syntax - Mode 2 ====

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

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

=== Output ===
<code>
             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
 ------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------
</code>

==== Command line syntax - Mode 3 ====

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

=== Output ===
<code>
             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                     
 -------------------- -------------------- -------------------- ---------------- -------------------- ---------------- -------------------- ---------------- ------------------------------ 

</code>

==== 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.
<code>
TMSS10ListHistory -S user:-password@server -V "US03.LTO.*" -R *-30:* -M 4
</code>

=== Output ===

<code>
             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 
 -------------------- ---------------- ---------- -------- ---------------------------------------- ------------ 
</code>

==== Command line syntax - Mode 5 ====

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

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

=== Output ===

<code>

             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  
 -------------------- ---------- -------- ---------------------------------------- ------------ 

</code>

==== Command line syntax - Mode 6 ====

Lists the history of Volumes, showing when the Volume was added and the last date the Volumes were scanned in at all Repositories.

<code>
TMSS10ListHistory -S tapemaster:-@localhost -M 6 -R *-100:* -V US02.*.*
</code>

=== Output ===

<code>

             System: TapeTrack
          Report ID: 124
 Report Description: TapeTrack Volume History Report (Scanned-In)
       Report Notes: Customer(North Carolina) Media(LTO Cartridge)
    Production Time: Thursday, May 08, 2025 - 11:18:42 (AUS Eastern Standard Time)
       Report Width: 148 bytes

 Barcode              Added                Customer             Library              Offsite Vault        
 -------------------- -------------------- -------------------- -------------------- -------------------- 
 US02.LTO.120042L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.121541L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.122042L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.122142L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.122345L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.122448L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.122746L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.123144L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.123844L6    2025-05-08 10:35:28  2025-05-08 10:37:04  Never                2025-05-08 
 US02.LTO.124145L6    2025-05-08 10:35:28  2025-05-08 10:37:04  Never                2025-05-08 
 US02.LTO.124542L6    2025-05-08 10:35:28  2025-05-08 10:37:04  Never                2025-05-08 
 US02.LTO.124740L6    2025-05-08 10:35:28  2025-05-08 10:37:05  Never                2025-05-08 
 US02.LTO.125449L6    2025-05-08 10:35:28  2025-05-08 10:37:05  Never                2025-05-08 
 US02.LTO.125942L6    2025-05-08 10:35:28  2025-05-08 10:37:05  Never                2025-05-08 
 US02.LTO.126940L6    2025-05-08 10:35:28  2025-05-08 10:37:05  Never                2025-05-08 
 US02.LTO.127242L6    2025-05-08 10:35:28  2025-05-08 10:37:05  Never                2025-05-08 
 US02.LTO.127546L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.128848L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.129344L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 US02.LTO.129545L6    2025-05-08 10:35:28  2025-05-08 10:35:49  Never                2025-05-08 
 -------------------- -------------------- -------------------- -------------------- --------------------
</code>

</code>
--> Changelog

[[http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10ListHistory|Changelog]]
[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10ListHistory]
<--
<- ^ cli:introduction|Command Line Utilities^ ->