cli:tmss10listmovehistory
Table of Contents
TMSS10ListMoveHistory
Synopsis
TMSS10ListMoveHistory [-A audit flag] [-H hours] [-M moving volumes] [-S logon string] [-T target repository] [-V volume filter] [-c configuration file]
Description
TMSS10ListMoveHistory lists the movement history of each volume within the specified time frame.
Options
-ASets audit flag when volume overdue.-HNumber of hours to go back in time (default 24 Hours).-MInclude all moving volumes.-SThe Logon string argument sets the Server Logon Information.-TTarget repository filter.-VVolume Filter which can be used to filter the traversal of Customer, Media, Volume, repository and Flag values.-cThe 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.
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.
To include multiple Attributes in the report, add the required Attribute indexes separated by a comma (eg. -A 1,2,5).
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
- 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
TMSS10ListMoveHistory -S user:-password@server -V "US02.LTO.*" -H 48 -T "OFFS"
Output
System: TapeTrack
Report Description: User Scan Report
Report Notes: Period 2017-11-18 11:47:11 through 2017-11-20 11:47:11
Production Time: Monday, November 20, 2017 - 11:47:11 (AUS Eastern Daylight Time)
Report Width: 96 bytes
Seq. User-ID Scans First Scan Time Last Scan Time Minutes Scans/Min
------ ---------------- ------ -------------------- -------------------- ---------- ----------
1 tapemaster 19 2017-11-20 10:17:48 2017-11-20 10:17:49 1 19.00
------ ---------------- ------ -------------------- -------------------- ---------- ----------
System: TapeTrack
Report Description: Historical Movement Report
Report Notes: Period 2017-11-18 11:47:11 through 2017-11-20 11:47:11
Production Time: Monday, November 20, 2017 - 11:47:11 (AUS Eastern Daylight Time)
Report Width: 146 bytes
Total Number of Volumes Complete: 19
Total Number of Volumes Incomplete: 0
Total Number of Volumes Overdue: 0
Seq. Barcode Target Repository Out Move Status Overdue Move Time Time Scan User-ID Scan Time
------ -------------------- -------------------- --- ----------- ------- ------------------- -------------- ---------------- -------------------
1 US02.LTO.000040L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:16 tapemaster 2017-11-20 10:17:48
2 US02.LTO.000041L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:16 tapemaster 2017-11-20 10:17:48
3 US02.LTO.000042L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:16 tapemaster 2017-11-20 10:17:48
4 US02.LTO.000043L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:16 tapemaster 2017-11-20 10:17:48
5 US02.LTO.000044L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:16 tapemaster 2017-11-20 10:17:48
6 US02.LTO.000045L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:17 tapemaster 2017-11-20 10:17:49
7 US02.LTO.000046L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:17 tapemaster 2017-11-20 10:17:49
8 US02.LTO.000047L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:17 tapemaster 2017-11-20 10:17:49
9 US02.LTO.000048L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:17 tapemaster 2017-11-20 10:17:49
10 US02.LTO.000049L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:17 tapemaster 2017-11-20 10:17:49
11 US02.LTO.000050L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:17 tapemaster 2017-11-20 10:17:49
12 US02.LTO.000051L6 Offsite Vault No Complete No 2017-11-20 10:16:32 M1:17 tapemaster 2017-11-20 10:17:49
13 US02.LTO.000053L6 Offsite Vault No Complete No 2017-11-20 10:16:33 M1:16 tapemaster 2017-11-20 10:17:49
14 US02.LTO.000054L6 Offsite Vault No Complete No 2017-11-20 10:16:33 M1:16 tapemaster 2017-11-20 10:17:49
15 US02.LTO.000055L6 Offsite Vault No Complete No 2017-11-20 10:16:33 M1:16 tapemaster 2017-11-20 10:17:49
16 US02.LTO.000056L6 Offsite Vault No Complete No 2017-11-20 10:16:33 M1:16 tapemaster 2017-11-20 10:17:49
17 US02.LTO.000057L6 Offsite Vault No Complete No 2017-11-20 10:16:33 M1:16 tapemaster 2017-11-20 10:17:49
18 US02.LTO.000058L6 Offsite Vault No Complete No 2017-11-20 10:16:33 M1:16 tapemaster 2017-11-20 10:17:49
19 US02.LTO.000052L6 Offsite Vault No Complete No 2017-11-20 10:16:33 M1:16 tapemaster 2017-11-20 10:17:49
------ -------------------- -------------------- --- ----------- ------- ------------------- -------------- ---------------- -------------------
- Changelog
-
2021-05-24 Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127) 2021-05-07 Changed report so that it sorts by customer, media, volume first to ensure minimal attribute updates 2021-05-07 Added z read-only argument 2021-05-07 Added support for multiple attributes in report 2021-05-07 Changed -A argument to -a to accomodate standard attribute argument 2020-11-24 Added support for JSON output 2019-02-25 Added support for HTML output 2019-02-09 Added support for Excel output 2019-01-06 Added return code list to end of all command line programs that use the TapeTrack API 2016-11-18 Added fast forward code to reduce runtime 2016-11-18 Enhanced argument parser to allow arguments in format *FI:filename that allows loading of arguments from a file 2016-08-03 Fixed bug where Move Time field was sometimes not being reset 2016-03-11 Fixed bug where wrong duration was reported when move was cancelled 2015-12-26 Added flags to Volume Filter syntax (customer.media.volume@repository+flags) 2015-08-24 Changed hascontents to contentcount and change contentcount to a filter rather than bool 2015-08-24 Added iscontainer and hascontents to the config file filter logic 2015-05-16 Added environmental varialbe TMSSCANFILEUNQUALIFIED which will load and check volumes without Customer-ID and Media-ID qualifiers 2015-05-16 Added environmental varialbe TMSSSCANFILENOPARSE which will presume scanfile items are only Volumes and not parse them, saving time 2015-05-16 When loading scanfile from import definition, added CUSTOMER and MEDIA keywords to set defaults 2015-05-16 When loading scanfile from import definition, changed keyword from VOLUME to BARCODE 2015-05-16 Added TMSSUNQUALIFIEDVOLUME environmental variable which forces all barcodes to be printed without Customer-ID and Media-ID 2015-05-04 Added support for AD passwords to all command line programs (check for environmental variable TMSSNOMD5) 2015-03-25 Changed elapsed time for complete Volumes to reflect the time scanned-in and not the end time value 2014-11-19 Changed server argument parser to allow colon in password to support z/OS DD name files 2014-10-26 Upgraded development environment from Visual Studio 2012 to Visual Studio 2013
cli/tmss10listmovehistory.txt · Last modified: 2023/05/24 00:30 by scunliffe