Both sides previous revisionPrevious revisionNext revision | Previous revision |
technote:add_remove_flags_by_last_read [2021/07/30 00:42] – Scott Cunliffe | technote:add_remove_flags_by_last_read [2025/01/21 22:07] (current) – external edit 127.0.0.1 |
---|
====== Add Remove Flags Based Off Last Read Time ====== | ====== Add Or Remove Flags Based Off Last Read Time ====== |
| |
Add or Remove Flags based off last read time of [[object:volume|Volumes]] using TMSS10ModifyFlags and a config file. | Add or Remove [[common:volume_flags|Flags]] based off last read time of [[object:volume|Volumes]] using [[cli:tmss10modifyflags|TMSS10ModifyFlags]] and a config file. |
| |
The purpose of this method allows you to lock any [[object:volume|Volumes]] in your Library that have been recalled for data restoration and then automatically remove the move lock once the last read time passes a set number of days. The Sync can then place the [[object:volume|Volumes]] in a move back to the offsite vault until the data expires. | One purpose of this method allows you to lock any [[object:volume|Volumes]] in your Library that have been recalled for data restoration and then automatically remove the move lock once the last read time passes a set number of days. The Sync can then place the [[object:volume|Volumes]] in a move back to the Offsite Vault until the data expires. |
| |
The process involves TMSS10ModifyFlags loading an input file, using a definition file, to extract the [[object:volume|Volume-ID's]]s. The [[object:volume|Volume-ID's]] are then filtered using the configuration file and adding any qualifying [[object:volume|Volumes]] to a scan file. | The process involves [[cli:tmss10modifyflags|TMSS10ModifyFlags]] loading an input file, using a definition file, to extract the [[object:volume|Volume-ID's]]. The [[object:volume|Volume-ID's]] are then filtered using the configuration file and adding any qualifying [[object:volume|Volumes]] to a scan file. |
| |
The scan file is then processed, adding or removing the defined Flags against the scan list [[object:volume|Volumes]]. | The scan file is then processed, adding or removing the defined [[common:volume_flags|Flags]] against the scan list [[object:volume|Volumes]]. |
| |
===== Sample Files ===== | ===== Sample Files ===== |
| |
| |
The definition file provides the information on how to extract the [[object:volume|Volume-ID]] from the input file into the barcode field, as well as setting the Customer-ID and Media-ID. | The definition file provides the information on how to extract the [[object:volume|Volume-ID]] from the input file into the barcode field, as well as setting the [[object:customer|Customer-ID]] and [[object:media|Media-ID]]. |
| |
# Set input file (use full path if not in current directory) | # Set input file (use full path if not in current directory) |
| |
| |
Configuration file sets definition file for translating and extracting [[object:volume|Volume-ID's]] and filters input by Customer-ID (0002), Media-ID (LTO). The last read time is then compared to the lastreadtime filter, if the last read time is 30 or more days ago, the [[object:volume|Volume]] is added to the scan file, if not it is discarded. | Configuration file sets definition file for translating and extracting [[object:volume|Volume-ID's]] and filters input by [[object:customer|Customer-ID]] (0002), [[object:media|Media-ID]] (LTO). The last read time is then compared to the lastreadtime filter, if the last read time is 30 or more days ago, the [[object:volume|Volume]] is added to the scan file, if not it is discarded. |
| |
traversal = | traversal = |
| |
| |
Run TMSS10ModifyFlags to remove lock flag from all [[object:volume|Volumes]] in the input file with a last read date of 30 or more days ago. Using the Volume filter (-V) to only read in Customer-ID 0002 to save processing time by avoiding reading in all other Customer-ID's. Output from the process being written to modify_flags_stdout.txt and modify_flags_stderr.txt. The output files can written to any directory by using full directory paths. | Run [[cli:tmss10modifyflags|TMSS10ModifyFlags]] to remove lock flag from all [[object:volume|Volumes]] in the input file with a last read date of 30 or more days ago. Using the Volume filter (-V) to only read in [[object:customer|Customer-ID]] 0002 to save processing time by avoiding reading in all other [[object:customer|Customer-ID's]]. Output from the process being written to modify_flags_stdout.txt and modify_flags_stderr.txt. The output files can written to any directory by using full directory paths. |
| |
TMSS10ModifyFlags -S user:-password@server -F "!l" -c last_read.cfg -V 0002.LTO.* > modify_flags_stdout.txt 2> modify_flags_stderr.txt | TMSS10ModifyFlags -S user:-password@server -F "!l" -c last_read.cfg -V 0002.LTO.* > modify_flags_stdout.txt 2> modify_flags_stderr.txt |