TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10movescratch

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
cli:tmss10movescratch [2019/04/02 22:18] – [Description] Scott Cunliffecli:tmss10movescratch [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 7: Line 7:
 ===== Description ===== ===== Description =====
  
-Resets the Scratch flag of each [[object:volume|Volume]] and move Scratch [[object:volume|Volumes]] to another [[object:repository|Repository]].+Resets the Scratch [[common:volume_flags|Flag]] of each [[object:volume|Volume]] and move Scratch [[object:volume|Volumes]] to another [[object:repository|Repository]].
  
-''TMSS10MoveScratch;; is used to manage Scratch [[object:volume|Volumes]], it performs 3 functions:+''TMSS10MoveScratch'' is used to manage Scratch [[object:volume|Volumes]], it performs 3 functions:
  
-  - Moves all [[object:volume|Volumes]] with a Scratch Flag to the [[object:repository|Repository]] specified in the ''-R'' argument. +  - Moves all [[object:volume|Volumes]] with a Scratch [[common:volume_flags|Flag]] to the [[object:repository|Repository]] specified in the ''-R'' argument. 
-  - Sets the Scratch Flag for all [[object:volume|Volumes]]. +  - Sets the Scratch [[common:volume_flags|Flag]] for all [[object:volume|Volumes]]. 
-  - Lists all [[object:volume|Volumes]] with a Scratch Flag.+  - Lists all [[object:volume|Volumes]] with a Scratch [[common:volume_flags|Flag]].
  
-This command is particularly helpful for platforms such as Tivoli Storage Manager, which deletes Scratch [[object:volume|Volume]] from its [[object:volume|Volume]] Table, as you can schedule the command to run once per week to reset all [[object:volume|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 [[object:volume|Volume]] that still has the Scratch Flag set to a new [[object:repository|Repository]].+This command is particularly helpful for platforms such as Tivoli Storage Manager, which deletes Scratch [[object:volume|Volume]] from its [[object:volume|Volume]] Table, as you can schedule the command to run once per week to reset all [[object:volume|Volumes]] to Scratch then remove the Scratch [[common:volume_flags|Flag]] using TMSS10Sync during the week. Then when the program is run subsequently the next week, it will move each [[object:volume|Volume]] that still has the Scratch [[common:volume_flags|Flag]] set to a new [[object:repository|Repository]].
  
-<note important>Please note that when running ''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 [[object:volume|Volumes]] will be moved.+<note important>Please note that when running ''TMSS10MoveScratch'' with the ''-R'' argument set you must be sure that the process that sets the Scratch [[common:volume_flags|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 [[common:volume_flags|Flags]] that should have been removed have not been removed, it is possible that non-Scratch [[object:volume|Volumes]] will be moved.
  
 </note> </note>
Line 24: Line 24:
   * ''-C'' Scratch capacity of Target [[object:repository|Repository]] (default = 1000)   * ''-C'' Scratch capacity of Target [[object:repository|Repository]] (default = 1000)
   * ''-R'' Target [[object:repository|Repository]] where Scratch [[object:volume|Volumes]] will be moved to.   * ''-R'' Target [[object:repository|Repository]] where Scratch [[object:volume|Volumes]] will be moved to.
-  * ''-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]] 
-  * ''-V'' [[cli:volume_filter|Volume Filter]] which can be used to filter the traversal of [[object:customer|Customer]], [[object:media|Media]], [[object:volume|Volume]], [[object:repository|Repository]] and flag values.+  * ''-V'' [[cli:volume_filter|Volume Filter]] which can be used to filter the traversal of [[object:customer|Customer]], [[object:media|Media]], [[object:volume|Volume]], [[object:repository|Repository]] and [[common:volume_flags|Flag]] values.
   * ''-a'' Skip move step (default = false)   * ''-a'' Skip move step (default = false)
   * ''-b'' Skip Scratch step (default = false)   * ''-b'' Skip Scratch step (default = false)
Line 63: Line 63:
 ==== Example ==== ==== Example ====
  
-Move maximum of 1 Scratch [[object:volume|Volume]] to [[object:repository|Repository]] LIBR for [[object:customer|Customer]] US04, [[object:media|Media]] LTO and set Scratch flag for rest of [[object:volume|Volumes]].+Move maximum of 1 Scratch [[object:volume|Volume]] to [[object:repository|Repository]] LIBR for [[object:customer|Customer]] US04, [[object:media|Media]] LTO and set Scratch [[common:volume_flags|Flag]] for the rest of [[object:volume|Volumes]].
    
 === Command line syntax === === Command line syntax ===
-<sxh plain;>+<code plain;>
 TMSS10MoveScratch -S user:-password@server -C 1 -R LIBR -V "US04.LTO.*" TMSS10MoveScratch -S user:-password@server -C 1 -R LIBR -V "US04.LTO.*"
-</sxh>+</code>
  
 === Output === === Output ===
  
-<sxh>+<code>
              System: TapeTrack              System: TapeTrack
  Report Description: Scratch List  Report Description: Scratch List
Line 82: Line 82:
       1 US04.LTO.000011L5    Scratch Volumes      Library                    M31:14                           1 US04.LTO.000011L5    Scratch Volumes      Library                    M31:14                    
  ------ -------------------- -------------------- -------------------- ------------ -------------------  ------ -------------------- -------------------- -------------------- ------------ -------------------
-</sxh>+</code>
  
  
Line 90: Line 90:
    
 === Command line syntax === === Command line syntax ===
-<sxh plain;>+<code plain;>
 TMSS10MoveScratch -S user:-password@server -b -V "US04.LTO.*" TMSS10MoveScratch -S user:-password@server -b -V "US04.LTO.*"
-</sxh>+</code>
  
 === Output === === Output ===
  
-<sxh>+<code text;>
  
              System: TapeTrack              System: TapeTrack
Line 128: Line 128:
  ------ -------------------- -------------------- -------------------- ------------ --------------------------------------------------------------------------------   ------ -------------------- -------------------- -------------------- ------------ -------------------------------------------------------------------------------- 
  
-</sxh>+</code>
  
-===== Changelog =====+--> Changelog
  
 [filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10MoveScratch] [filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10MoveScratch]
 +<--
 <- ^ cli:introduction|Command Line Utilities^ -> <- ^ cli:introduction|Command Line Utilities^ ->
cli/tmss10movescratch.1554243521.txt.gz · Last modified: 2025/01/21 22:07 (external edit)