Differences

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

--- engine:sync:addrepositoryonwritetime [2018/08/14 16:56] – dcumming
+++ engine:sync:addrepositoryonwritetime [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-addrepositoryonwritetime
+====== AddRepositoryOnWriteTime ======
-==== AddRepositoryOnWriteTime ====
+Set a [[object:repository|Repository]] value based upon a range of Write Times.
-Set a Repository value based upon a range of Write Times.
-==== Phase ====
+===== Phase =====
 This instruction is used by the TapeTrack Synchronization Engine.
-==== Special Considerations ====
-<note tip>This instruction will not be invoked by the Synchronization Engine if a matching
+<note important>This instruction will not be invoked by the Synchronization Engine if a matching
-AddRepositoryOnMoveDate entry has been used to change the Repository</note>
+[[engine:sync:addrepositoryonmovedate|AddRepositoryOnMoveDate]] entry has been used to change the Repository</note>
-==== Syntax ====
-AddRepositoryOnWriteTime(field, filter, time, target, movedate);
+===== Syntax =====
-//string field;//\\
+''AddRepositoryOnWriteTime(field, filter, time, target, movedate);''
-//string filter;//\\
-//string time;//\\
+^ Variable ^ Type ^ Description ^ Min Length ^ Max Length ^
-//string target;//\\
+|field| String | A field for comparison.|1|40|
-//string movedate;//\\
+|filter| String | A filter to compare against.|1|256|
-field A field for comparison.
+|time| String | Number of hours, days, months and years from the Write Date.|1|30|
-filter A filter to compare against.
+|target| String | The Target Repository.|1|4|
-time Number of hours, days, months and years from the Write Date.
+|movedate| String | Number of hours, days, months and years from the Write Date to set the Move Date.|1|30|
-target The Target Repository.
-movedate Number of hours, days, months and years from the Write Date to set the Move Date.
+===== Example =====
-Examples
+Set the [[object:repository|Repository]] based upon time from Write Date.
-Example 2.2. AddRepositoryOnWriteTime: Set the Repository based upon time
-from Write Date.
+<code>
+#
+# Extract the WRITEDATE from column 10, length 20.
 Extract(WRITEDATE, 10, 20, 0);
-TapeTrack Synchronization Suite
+#Set the WRITEDATE format.
 SetWriteDateFormat("%%H:%%M:%%S %%d/%%m/%%Y");
+# Extract the DESCRIPTION from column 11, length 100.
 Extract(DESCRIPTION, 11, 100, 0);
+# If the DESCRIPTION contains YEARLY and the WRITEDATE is within one day
+# move the Volume to LIBR and give it a one day MOVEDATE.
 AddRepositoryOnWriteTime(DESCRIPTION, "*YEARLY*", "0:1", "LIBR", "0:1");
+# If the DESCRIPTION contains YEARLY and the WRITEDATE is within one year
+# move the Volume to OFFS and give it a one year MOVEDATE.
 AddRepositoryOnWriteTime(DESCRIPTION, "*YEARLY*", "0:0:1", "OFFS", "0:1:1");
-Extract the WRITEDATE from column 10, length 20.
+</code>
-Set the WRITEDATE format.
-Extract the DESCRIPTION from column 11, length 100.
+Set the Repository to OFFS, based on Volume-ID if last write time is within 7 days ago with no next move date.
-If the DESCRIPTION contains YEARLY and the WRITEDATE is within one day move the Volume
-to LIBR and give it a one day MOVEDATE.
+<code>
-If the DESCRIPTION contains YEARLY and the WRITEDATE is within one year move the Volume
+AddRepositoryOnWriteTime(VOLUME, "SC*", "7", "OFFS", "0");
-to OFFS and give it a one year MOVEDATE.
+</code>
+===== See Also =====
+[[engine:import|Import Engine Functions]] \\
+[[cli:sync_fields|Sync Engine Fields]] \\
+[[cli:tmss10sync|TMSS10Sync]]
+{{tag> import_engine sync_engine}}