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: 1. Moves all Volumes with a Scratch Flag to the Repository specified in the -R argument. 2. Sets the Scratch Flag for all Volumes. 3. Lists all Volumes with a Scratch Flag.

This command is particularly helpful for platforms such as Tivoli Storage Manager® which deletes scratch tapes 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.

• -C Scratch capacity of Target repository (default = 1000)
• -R Target repository where scratch volumes will be moved to.
• -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.

1. zero Program has ended successfully.
2. non-zero Program has not ended successfully.

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 logon string 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.

TMSS10MoveScratch -S doco:-doco@localhost -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                    
 ------ -------------------- -------------------- -------------------- ------------ -------------------