Differences

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

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