| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| cli:tmss10listhistory [2017/11/20 01:39] – Scott Cunliffe | cli:tmss10listhistory [2025/01/21 22:07] (current) – external edit 127.0.0.1 |
|---|
| ====== TMSS10ListHistory ====== | ====== TMSS10ListHistory ====== |
| | |
| | TMSS10ListHistory lists the Storage History for each [[object:repository|Repository]] within the specified date range. |
| |
| ===== Synopsis ===== | ===== Synopsis ===== |
| |
| ''TMSS10ListHistory [-R date range] [-S logon string] [-V volume filter]'' | ''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 ===== |
| |
| | * ''-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. | * ''-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]]. |
| * ''-V'' [[cli:volume_filter|Volume Filter]] which can be used to filter the traversal of Customer, Media, Volume, repository and flag values. | * ''-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 ==== | ==== 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 ==== |
| ===== Example ===== | ===== Example ===== |
| |
| === Command line syntax === | ==== 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. |
| <code> | <code> |
| TMSS10ListHistory -S user:-password@server -V "US02.LTO.*" -R "*-10:*" -T "OFFS" -u "tapemaster | TMSS10ListHistory -S user:-password@server -V "US04.LTO.*" -I "*TapeMaster*" -R "*-10:*" -T "OFFS" -u "jsmith" |
| </code> | </code> |
| === Output === | === Output === |
| <code> | <code> |
| |
| | 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] |
| | |
| | ----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ----------------------- ------------ |
| </code> | </code> |
| |
| |
| <- cli:introduction|Command Line Utilities^ master:starting|Getting Started ^ -> | |
| | ==== 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^ -> |
