====== 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.
TMSS10ListHistory -S user:-password@server -V "US04.LTO.*" -I "*TapeMaster*" -R "*-10:*" -T "OFFS" -u "jsmith"
=== Output ===
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]
----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------
==== 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).
TMSS10ListHistory -S user:-password@server -M 2 -V US04.*.* -R M-2:m-0 -t *In* -T "*(OFFS|LIBR)" -C "*(OFFS|LIBR)"
=== Output ===
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
------------ -------- --------------- -------------------- ---------------- ---------- ---------- ---------------------------------------- -----------
==== Command line syntax - Mode 3 ====
TMSS10ListHistory -S user:-password@server -V "US03.LTO.*" -R *-30:* -M 3
=== Output ===
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
-------------------- -------------------- -------------------- ---------------- -------------------- ---------------- -------------------- ---------------- ------------------------------
==== 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.
TMSS10ListHistory -S user:-password@server -V "US03.LTO.*" -R *-30:* -M 4
=== Output ===
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
-------------------- ---------------- ---------- -------- ---------------------------------------- ------------
==== Command line syntax - Mode 5 ====
List Volumes Attribute updates filtered by User-ID for US03 LTO in the last 30 days using Mode 5.
TMSS10ListHistory -S user:-password@server -V "US03.LTO.*" -R *-30:* -M 5
=== Output ===
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
-------------------- ---------- -------- ---------------------------------------- ------------
--> 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^ ->