TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • tapemaster_user • tmss10liststoragehistory • tmss10zonelist
cli:tmss10listhistory

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
cli:tmss10listhistory [2019/03/25 23:27] – [Synopsis] Scott Cunliffecli:tmss10listhistory [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== TMSS10ListHistory ====== ====== TMSS10ListHistory ======
 +
 +TMSS10ListHistory lists the Storage History for each [[object:repository|Repository]]  within the specified date range.
  
 ===== Synopsis ===== ===== 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]'' ''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]''
- 
-===== Description ===== 
- 
-TMSS10ListHistory lists the storage history for each repository within the specified date range. 
  
 ===== Options ===== ===== Options =====
  
-  * ''-C'' Current volume location. +  * ''-A'' Extended Attribute index (default = 0). 
-  * ''-I'' Interface Filter allows filtering of results by desktop software interface.+  * ''-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.    * ''-R'' Specifies the date range. 
-  * ''-S'' The logon string argument sets the [[cli:server_argument|Server logon information]]. +  * ''-S'' The Logon string argument sets the [[cli:server_argument|Server Logon Information]]. 
-  * ''-T'' Volume target location. +  * ''-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 flag values. +  * ''-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 Customer, Media and Volumes, perform advanced barcode pre and post processing and route program output to syslogd. +  * ''-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..+  * ''-t'' Type allows filtering of results by type of database entry.
   * ''-u'' User allows filtering of results by [[object:user|User-ID]].   * ''-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 ==== ==== 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.+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 ==== ==== Exit Statuses ====
Line 41: Line 53:
 ===== Example ===== ===== Example =====
  
-=== Command line syntax ===+==== 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. +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. 
-<sxh> + 
-TMSS10ListHistory -S user:-password@server -V "US02.LTO.*" -I "*TapeMaster*" -R "*-10:*" -T "OFFS" -u "jsmith"  +<code> 
-</sxh>+TMSS10ListHistory -S user:-password@server -V "US04.LTO.*" -I "*TapeMaster*" -R "*-10:*" -T "OFFS" -u "jsmith"  
 +</code>
 === Output === === Output ===
-<sxh>+<code>
  
              System: TapeTrack              System: TapeTrack
- Report Description: TapeTrack Volume History Report +          Report ID: 104 
-       Report Notes: From 2017-11-10 to 2017-11-20 (11 days) + 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: 244 bytes+       Report Width: 300 bytes
  
 Barcode           Seque Time                 User      Old        New        Move Date   Container  Flags  Interface               Notes         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]    +US04.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]   +US04.LTO.000037L6     2 2017-11-20 12:38:50  jsmith    LIBR:0     OFFS:0     Permanent   None       CnO    TapeTrack TapeMaster    [Scanned-In]   
  
 ----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------ ----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------
-  </sxh>+  </code>
  
-===== Changelog ===== 
  
-[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10ListHistory] 
  
 +==== 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>
 +--> 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^ -> <- ^ cli:introduction|Command Line Utilities^ ->
cli/tmss10listhistory.1553556452.txt.gz · Last modified: 2025/01/21 22:07 (external edit)