| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| cli:tmss10listhistory [2018/06/25 21:39] – [Example] dcumming | cli:tmss10listhistory [2025/01/21 22:07] (current) – external edit 127.0.0.1 |
|---|
| ====== TMSS10ListHistory ====== | ====== TMSS10ListHistory ====== |
| |
| ===== Synopsis ===== | TMSS10ListHistory lists the Storage History for each [[object:repository|Repository]] within the specified date range. |
| |
| ''TMSS10ListHistory [-C current location] [-R date range] [-S logon string] [-T target location] [-V volume filter] [-c configuration file] [-t type] [-u user]'' | ===== Synopsis ===== |
| |
| ===== Description ===== | ''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 lists the storage history for each repository within the specified date range. | |
| |
| ===== Options ===== | ===== Options ===== |
| |
| * ''-C'' Current volume location. | * ''-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]]. |
| * ''-T'' 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 Customer, Media and 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. | * ''-t'' Type allows filtering of results by type of database entry. |
| * ''-u'' User. | * ''-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 ==== |
| <sxh> | |
| TMSS10ListHistory -S user:-password@server -V "US02.LTO.*" -R "*-10:*" -T "OFFS" -u "jsmith" | 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 "US04.LTO.*" -I "*TapeMaster*" -R "*-10:*" -T "OFFS" -u "jsmith" |
| | </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: 300 bytes |
| |
| Report Width: 244 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> |
| | |
| | |
| | |
| | ==== 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 Seque Time User Old New Move Date Container Flags Notes | Barcode Date Time Type Attribute |
| ----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ------------ | -------------------- ---------- -------- ---------------------------------------- ------------ |
| US02.LTO.000037L6 1 2017-11-18 10:38:45 gnicol LIBR:0 OFFS:0 Permanent None CMn [Target] | US03.LTO.000000L4 2023-01-05 10:38:08 Description desc one |
| US02.LTO.000037L6 2 2017-11-20 12:38:50 gnicol LIBR:0 OFFS:0 Permanent None CnO [Scanned-In] | US03.LTO.000000L4 2023-01-05 10:38:32 Description desc two |
| ----------------- ----- -------------------- --------- ---------- ---------- ----------- ---------- ------ ------------ | US03.LTO.000001L4 2023-01-05 10:51:26 Description sample three |
| </sxh> | 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 |
| |
| <- cli:introduction|Command Line Utilities^ master:starting|Getting Started ^ -> | [[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^ -> |
