Differences

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

--- technote:add_remove_flags_by_last_read [2021/07/20 01:05] – [Sample Files] Scott Cunliffe
+++ technote:add_remove_flags_by_last_read [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 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 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 process involves TMSS10ModifyFlags loading an input file, using a definition file, to extract the Volume-ID's.  The Volume-ID's are then filtered using the configuration file and adding any qualifying Volumes to a scan file.
+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 scan file is then processed, adding or removing the defined Flags against the scan list Volumes.
+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 [[common:volume_flags|Flags]] against the scan list [[object:volume|Volumes]].
 ===== Sample Files =====
-Input file - Volumes.csv
+==== Input file - Volumes.csv ====
-,OFFS,2021/07/15 22:10:33
+<code>
-,OFFS,2021/07/15 22:10:34
+L5,OFFS,2021/07/15 22:10:33
-,OFFS,2021/07/15 22:10:35
+L5,OFFS,2021/07/25 22:10:34
-,OFFS,2021/07/15 22:10:36
+L5,OFFS,2021/07/25 22:10:35
-,OFFS,2021/07/15 22:10:37
+L5,OFFS,2021/07/25 22:10:36
-,OFFS,2021/06/15 22:10:38
+L5,OFFS,2021/07/28 22:10:37
-,OFFS,2021/06/16 22:10:39
+L5,OFFS,2021/06/15 22:10:38
-,OFFS,2021/06/17 22:10:40
+L5,OFFS,2021/06/16 22:10:39
-,OFFS,2021/06/18 22:10:41
+L5,OFFS,2021/06/17 22:10:40
-,OFFS,2021/06/19 22:10:42
+L5,OFFS,2021/06/18 22:10:41
+L5,OFFS,2021/06/19 22:10:42
+</code>
-Definition file - default.ttidef
+=== Definition file - default.ttidef ===
+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)
@@ Line 37: / Line 44: @@
   # Extract Volume-ID into BARCODE field
-  extract(BARCODE, 1, 3, 0);
+  extract(BARCODE, 1, 8, 0);
+== Configuration file - last_read.cfg ==
+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 =
+  {
+     scanfile= { file="default.ttidef"; };
+     customer =
+     (
+        {
+           id="0002";
+           media =
+           (
+              {
+                 id="LTO";
+                 volume =
+                 (
+                     {
+                        id="*";
+                        lastreadtime = "P:*-30";
+                        skip=false;
+                     },
+                     {
+                        id="*";
+                        skip=true;
+                     }
+                 );
+              }
+           );
+        }
+     );
+  };
+== Batch file - run_remove_lock_flag.bat ==
+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
+==== Example Output ====
+modify_flags_std.txt
+<code>
+             System: TapeTrack
+ Report Description: Scan-File Load Report
+    Production Time: Friday, July 30, 2021 - 10:36:51 (AUS Eastern Standard Time)
+       Report Width: 149 bytes
+ Seq.   Record Barcode                                  Resolved As          Status Notes
+ ------ ------ ---------------------------------------- -------------------- ------ ----------------------------------------------------------------
+      1 100001L5                                 US02.LTO.100001L5    OK
+      2 100002L5                                 US02.LTO.100002L5    OK
+      3 100003L5                                 US02.LTO.100003L5    OK
+      4 100004L5                                 US02.LTO.100004L5    OK
+      5 100005L5                                 US02.LTO.100005L5    OK
+      6 100006L5                                 US02.LTO.100006L5    OK
+      7 100007L5                                 US02.LTO.100007L5    OK
+      8 100008L5                                 US02.LTO.100008L5    OK
+      9 100009L5                                 US02.LTO.100009L5    OK
+     10 100010L5                                 US02.LTO.100010L5    OK
+ ------ ------ ---------------------------------------- -------------------- ------ ----------------------------------------------------------------
+             System: TapeTrack
+ Report Description: Flag Modification Report
+    Production Time: Friday, July 30, 2021 - 10:36:51 (AUS Eastern Standard Time)
+       Report Width: 156 bytes
+ Seq.   Barcode              Old Flags                        New Flags                        Message
+ ------ -------------------- -------------------------------- -------------------------------- ------------------------------------------------------------
+US02.LTO.100006L5    ClMn                             CMn                              Request OK
+US02.LTO.100007L5    ClMn                             CMn                              Request OK
+US02.LTO.100008L5    ClMn                             CMn                              Request OK
+US02.LTO.100009L5    ClMn                             CMn                              Request OK
+US02.LTO.100010L5    ClMn                             CMn                              Request OK
+ ------ -------------------- -------------------------------- -------------------------------- ------------------------------------------------------------
+</code>
+{{tag> technote config cli report}}