| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| cli:tmss10movescratch [2018/05/21 01:34] – [Example] Scott Cunliffe | cli:tmss10movescratch [2025/01/21 22:07] (current) – external edit 127.0.0.1 |
|---|
| ===== Description ===== | ===== Description ===== |
| |
| Resets the scratch flag of each Volume and move scratch Volumes to another 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 Volumes, it performs 3 functions: | ''TMSS10MoveScratch'' is used to manage Scratch [[object:volume|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. | - 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 [[common:volume_flags|Flag]] for all [[object:volume|Volumes]]. |
| | - Lists all [[object:volume|Volumes]] with a Scratch [[common:volume_flags|Flag]]. |
| |
| <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 tapes will be moved. | 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 [[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> |
| ===== Options ===== | ===== Options ===== |
| |
| * ''-C'' Scratch capacity of Target repository (default = 1000) | * ''-C'' Scratch capacity of Target [[object:repository|Repository]] (default = 1000) |
| * ''-R'' Target repository where scratch 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 Customer, Media, Volume, 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) |
| * ''-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. | * ''-c'' The config file argument specifies the path to the Batch Configuration File. The Batch Configuration File allows you to perform advanced traversal of [[object:customer|Customer]], [[object:media|Media]] and [[object:volume|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) | * ''-m'' Scratch maximum ( default = 1000000) |
| | |
| | |
| ==== Technical Support ==== | ==== Technical Support ==== |
| |
| ==== Environment ==== | ==== Environment ==== |
| |
| **TMSSSERVERPROXY** If defined the program will route all TapeTrack TCP/IP traffic through | [[variable:tmssserverproxy|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**. | a HTTPS proxy. The value of the variable should be in the format user:password@host:port. To debug the proxy connection use variable [[variable:tmssapilogdir|TMSSAPILOGDIR]]. |
| |
| **TMSSAPILOGDIR** If defined the program will write out a trace file to this directory. | [[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. | [[variable:tmsspwpath|TMSSPWPATH]]: When no password value is passed in the [[cli:server_argument|logonstring]] the program will look for the password in file \etc\tapetrack\user, where user is the user value passed in the [[cli:server_argument|logonstring]]. If you wish to change this default path, you can set the path in [[variable:tmsspwpath|TMSSPWPATH]]. |
| |
| |
| ==== Example ==== | ==== Example ==== |
| |
| Move maximum of 1 scratch volume to repository LIBR for customer US04, media LTO and set scratch flag for rest of 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 doco:-doco@localhost -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 |
| 1 US04.LTO.000011L5 Scratch Volumes Library M31:14 | 1 US04.LTO.000011L5 Scratch Volumes Library M31:14 |
| ------ -------------------- -------------------- -------------------- ------------ ------------------- | ------ -------------------- -------------------- -------------------- ------------ ------------------- |
| </sxh> | </code> |
| |
| |
| ---- | ---- |
| |
| Produce scratch report only for Customer US04, media LTO. | Produce Scratch report only for [[object:customer|Customer]] US04, [[object:media|Media]] LTO. |
| | |
| === Command line syntax === | === Command line syntax === |
| <sxh plain;> | <code plain;> |
| TMSS10MoveScratch -S doco:-doco@localhost -b -V "US04.LTO.*" | TMSS10MoveScratch -S user:-password@server -b -V "US04.LTO.*" |
| </sxh> | </code> |
| |
| === Output === | === Output === |
| |
| <sxh> | <code text;> |
| |
| System: TapeTrack | System: TapeTrack |
| ------ -------------------- -------------------- -------------------- ------------ -------------------------------------------------------------------------------- | ------ -------------------- -------------------- -------------------- ------------ -------------------------------------------------------------------------------- |
| |
| </sxh> | </code> |
| | |
| | --> Changelog |
| |
| | [filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10MoveScratch] |
| | <-- |
| | <- ^ cli:introduction|Command Line Utilities^ -> |
