TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • tmss10zonelist • tapemaster_user • tmss10listhistory • otp
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 [2022/01/21 01:14] – [Example] Scott Cunliffecli:tmss10listhistory [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 16: Line 16:
   * ''-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.
Line 26: Line 26:
 ===== Notes ===== ===== Notes =====
  
-Mode 1 \\ 
-Report-ID: 104 
  
-Mode 2 \\ +^ Mode | 1 | 2 | 3 | 4 | 5 | 
-Report-ID: 105+^ Report-ID | 104 | 105  | 113  | 121  | 122  | 
  
-   
 ==== Technical Support ==== ==== Technical Support ====
  
Line 55: 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.
  
 <code> <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" 
 </code> </code>
 === Output === === Output ===
Line 74: Line 72:
 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]   
  
 ----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------ ----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------
   </code>   </code>
  
-== Report Columns == 
  
-^ Column Heading ^ Description ^ 
-| Seq | Record sequence number | 
-|Barcode|Volume-ID.  Default is fully qualified barcode, use [[variable:tmssunqualifiedvolume|TMSSUNQUALIFIEDVOLUME]] to list unqualified Volume-ID's| 
  
-=== Command line syntax - Mode 2 ===+==== 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). 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> <code>
-TMSS10ListHistory -S user:-password@server -M 2 -V US03.*.* -R M-2:m-0 -t *In* -T "*(OFFS|LIBR)" -C "*(OFFS|LIBR)"+TMSS10ListHistory -S user:-password@server -M 2 -V US04.*.* -R M-2:m-0 -t *In* -T "*(OFFS|LIBR)" -C "*(OFFS|LIBR)"
 </code> </code>
  
Line 105: 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
  ------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------  ------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------
 </code> </code>
  
-===== Changelog =====+==== 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]] [[http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10ListHistory|Changelog]]
 [filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10ListHistory] [filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10ListHistory]
 +<--
 <- ^ cli:introduction|Command Line Utilities^ -> <- ^ cli:introduction|Command Line Utilities^ ->
cli/tmss10listhistory.1642727646.txt.gz · Last modified: 2025/01/21 22:07 (external edit)