TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace:
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 [2020/01/07 01:39] – [Technical Support] 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 [[object:repository|Repository]]  within the specified date range. 
  
 ===== Options ===== ===== Options =====
Line 16: Line 14:
   * ''-M'' Report mode (default = 1).   * ''-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'' [[object:volume|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 [[object:customer|Customer]], [[object:media|Media]] and [[object:volume|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 ====
  
Line 45: Line 53:
 ===== Example ===== ===== Example =====
  
-=== Command line syntax - Mode 1 ===+==== 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. 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> +<code> 
-TMSS10ListHistory -S user:-password@server -V "US02.LTO.*" -I "*TapeMaster*" -R "*-10:*" -T "OFFS" -u "jsmith"  +TMSS10ListHistory -S user:-password@server -V "US04.LTO.*" -I "*TapeMaster*" -R "*-10:*" -T "OFFS" -u "jsmith"  
-</sxh>+</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>
  
-=== 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). 
  
-<sxh> +==== Command line syntax - Mode 2 ==== 
-TMSS10ListHistory -S user:-password@server -M 2 -V US03.*.* -R M-2:m-0 -t *In* -T "*(OFFS|LIBR)" -C "*(OFFS|LIBR)" + 
-</sxh>+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 === === Output ===
-<sxh>+<code>
              System: TapeTrack              System: TapeTrack
 +          Report ID: 105
  Report Description: TapeTrack Volume History Report (Mode 2)  Report Description: TapeTrack Volume History Report (Mode 2)
        Report Notes: From 2019-03-01 to 2019-03-31 (31 days)        Report Notes: From 2019-03-01 to 2019-03-31 (31 days)
Line 88: Line 99:
  Date         Time     Difference      Barcode              User             Old        New        Notes                                    Attribute  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 + 2019-03-26   09:05:23                 US04.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:23             S0  US04.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             S9  US04.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+              09:05:32             S0  US04.LTO.X-CA93B554  doco             OFFS:0     LIBR:0     [Scanned-In]                             12345678902
  ------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------  ------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------
-</sxh>+</code>
  
-===== Changelog =====+==== Command line syntax - Mode 3 ====
  
-[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10ListHistory]+<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.1578361141.txt.gz · Last modified: 2025/01/21 22:07 (external edit)