TMSS10MoveScratch [-C scratch capacity] [-R target repository] [-S logon string] [-V volume filter] [-a skip move] [-b skip scratch] [-c config file] [-m scratch maximum]
Resets the Scratch Flag of each Volume and move Scratch Volumes to another Repository.
TMSS10MoveScratch is used to manage Scratch Volumes, it performs 3 functions:
This command is particularly helpful for platforms such as Tivoli Storage Manager, which deletes Scratch Volume from its Volume Table, as you can schedule the command to run once per week to reset all Volumes to Scratch then remove the Scratch Flag using TMSS10Sync during the week. Then when the program is run subsequently the next week, it will move each Volume that still has the Scratch Flag set to a new Repository.
TMSS10MoveScratch with the -R argument set you must be sure that the process that sets the Scratch Flag to false has run. In the event that this is multiple processes (where you have multiple backup catalogs) you must be sure that all processes would have run. In the event that not all Scratch Flags that should have been removed have not been removed, it is possible that non-Scratch Volumes will be moved.
-C Scratch capacity of Target Repository (default = 1000)-S The Logon string argument sets the Server Logon Information-V Volume Filter which can be used to filter the traversal of Customer, Media, Volume, Repository and Flag values.-a Skip move step (default = false)-b Skip Scratch step (default = false)-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. Configuration File capabilities vary from program to program but the syntax remains the same. In the event that logic is not supported it will simply be ignored.-m Scratch maximum ( default = 1000000)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.
TMSSSERVERPROXY: If defined the program will route all TapeTrack TCP/IP traffic through a HTTPS proxy. The value of the variable should be in the format user:password@host:port. To debug the proxy connection use variable TMSSAPILOGDIR.
TMSSAPILOGDIR: If defined the program will write out a trace file to this directory.
TMSSPWPATH: When no password value is passed in the logonstring the program will look for the password in file \etc\tapetrack\user, where user is the user value passed in the logonstring. If you wish to change this default path, you can set the path in TMSSPWPATH.
stdout: Output Reports.
stderr: Diagnostic messages.
stdin: Program input.
Move maximum of 1 Scratch Volume to Repository LIBR for Customer US04, Media LTO and set Scratch Flag for the rest of Volumes.
TMSS10MoveScratch -S user:-password@server -C 1 -R LIBR -V "US04.LTO.*"
System: TapeTrack
Report Description: Scratch List
Production Time: Monday, May 21, 2018 - 11:13:58 (AUS Eastern Standard Time)
Report Width: 165 bytes
Seq. Barcode Current Target New Target Age Message
------ -------------------- -------------------- -------------------- ------------ -------------------
1 US04.LTO.000011L5 Scratch Volumes Library M31:14
------ -------------------- -------------------- -------------------- ------------ -------------------
TMSS10MoveScratch -S user:-password@server -b -V "US04.LTO.*"
System: TapeTrack
Report Description: Scratch List
Production Time: Monday, May 21, 2018 - 11:33:41 (AUS Eastern Standard Time)
Report Width: 165 bytes
Seq. Barcode Current Target New Target Age Message
------ -------------------- -------------------- -------------------- ------------ --------------------------------------------------------------------------------
1 US04.LTO.000001L3 Scratch Volumes N/A M58:49
2 US04.LTO.000001L5 Scratch Volumes N/A M58:49
3 US04.LTO.000002L5 Scratch Volumes N/A M58:49
4 US04.LTO.000003L5 Scratch Volumes N/A M58:49
5 US04.LTO.000004L5 Scratch Volumes N/A M58:49
6 US04.LTO.000004L6 Scratch Volumes N/A M58:49
7 US04.LTO.000005L5 Scratch Volumes N/A M58:49
8 US04.LTO.000005L6 Scratch Volumes N/A M58:49
9 US04.LTO.000006L5 Scratch Volumes N/A M58:49
10 US04.LTO.000006L6 Scratch Volumes N/A M58:49
11 US04.LTO.000007L5 Scratch Volumes N/A M58:49
12 US04.LTO.000007L6 Scratch Volumes N/A M58:49
13 US04.LTO.000008L5 Scratch Volumes N/A M58:49
14 US04.LTO.000008L6 Scratch Volumes N/A M58:48
15 US04.LTO.000009L5 Scratch Volumes N/A M50:57
16 US04.LTO.000009L6 Scratch Volumes N/A M50:57
17 US04.LTO.000010L5 Scratch Volumes N/A M50:57
18 US04.LTO.000010L6 Library N/A S15
19 US04.LTO.000011L5 Library N/A M19:42
20 US04.LTO.000012L5 Library N/A S15
21 US04.LTO.000013L5 Library N/A S15
------ -------------------- -------------------- -------------------- ------------ --------------------------------------------------------------------------------
| 2021-05-24 | Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127) |
| 2020-11-24 | Added support for JSON output |
| 2019-04-24 | Fixed bug that was stopping scratch phase from running |
| 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 |
| 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-10 | Added Age column to report |
| 2015-03-10 | Added Maximum and Cap arguments. |
| 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 |