Differences

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

--- cli:tmss10listhistory [2020/01/07 01:38] – [Options] Scott Cunliffe
+++ cli:tmss10listhistory [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== 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]''
-===== Description =====
-TMSS10ListHistory lists the Storage History for each [[object:repository|Repository]]  within the specified date range.
 ===== Options =====
@@ Line 16: / Line 14: @@
   * ''-M'' Report mode (default = 1).
   * ''-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.
-  * ''-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.
   * ''-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.
+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 ====
@@ Line 43: / Line 53: @@
 ===== 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.
-<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 ===
-<sxh>
+<code>
              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
 ----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------
-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 ===
-<sxh>
+<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)
@@ Line 86: / Line 99: @@
  Date         Time     Difference      Barcode              User             Old        New        Notes                                    Attribute
  ------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------
--03-26   09:05:23                 US03.LTO.X-539AE4EE  doco             LIBR:0     OFFS:0     [Scanned-In]                             12345678901
+-03-26   09:05:23                 US04.LTO.X-539AE4EE  doco             LIBR:0     OFFS:0     [Scanned-In]                             12345678901
-:05:23             S0  US03.LTO.X-CA93B554  doco             LIBR:0     OFFS:0     [Scanned-In]                             12345678902
+:05:23             S0  US04.LTO.X-CA93B554  doco             LIBR:0     OFFS:0     [Scanned-In]                             12345678902
-:05:32             S9  US03.LTO.X-539AE4EE  doco             OFFS:0     LIBR:0     [Scanned-In]                             12345678901
+:05:32             S9  US04.LTO.X-539AE4EE  doco             OFFS:0     LIBR:0     [Scanned-In]                             12345678901
-:05:32             S0  US03.LTO.X-CA93B554  doco             OFFS:0     LIBR:0     [Scanned-In]                             12345678902
+: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^ ->