TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10listhistory

This is an old revision of the document!


 
 

TMSS10ListHistory

TMSS10ListHistory lists the Storage History for each 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 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 Server Logon Information.
  • -T Volume target location.
  • -V Volume Filter which can be used to filter the traversal of Customer, Media, Volume, repository and 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.
  • -t Type allows filtering of results by type of database entry.
  • -u User allows filtering of results by User-ID.

If an argument value starts with the value FI:, the value for that attribute will be read from the file name specified immediately after it. For example, if a file named ACME_volumes has the content ACME_*.*, specifying FI:/etc/ACME_volumes will have the same effect as -V ACME.*.*. Using FI: to refer to a file for an attribute value works for all attributes.

If the pattern being matched starts with *LIST: then rather than matching the literal value, each record in the file specified as *LIST:filename will be tested. If one matches the match will succeed.

2025/01/21 22:08

To include multiple Attributes in the report, add the required Attribute indexes separated by a comma (eg. -A 1,2,5).

2025/01/21 22:08

Notes

Mode 1
Report-ID: 104

Mode 2
Report-ID: 105

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 Accessing Technical Support page.

Exit Statuses

  1. zero Program has ended successfully.
  2. 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 Volumes in Customer US02 moved to Repository Offsite by User jsmith between 10 days ago and today.

<sxh> TMSS10ListHistory -S user:-password@server -V “US02.LTO.*” -I “*TapeMaster*” -R “*-10:*” -T “OFFS” -u “jsmith” </sxh>

Output

<sxh>

           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 —————– —– ——————– ——— ———- ———- ———– ———- —— ———————– ———— US02.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]

—————– —– ——————– ——— ———- ———- ———– ———- —— ———————– ————

</sxh>

Command line syntax - Mode 2

List history of all Scanned-In Media in Customer US03, in Mode 2, moving to or from Repositories LIBR and OFFS, within the last month showing Attribute 1 (Long Barcode).

<sxh> TMSS10ListHistory -S user:-password@server -M 2 -V US03.*.* -R M-2:m-0 -t *In* -T “*(OFFS|LIBR)” -C “*(OFFS|LIBR)” </sxh>

Output

<sxh>

           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 US03.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:32             S9  US03.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

———— ——– ————— ——————– —————- ———- ———- —————————————- ———– </sxh>

Changelog

Changelog

Cannot load rss feed.
cli/tmss10listhistory.1625189965.txt.gz · Last modified: 2025/01/21 22:07 (external edit)