====== AddSkipOnRepositoryChange =====

Skip the update of a [[object:volume|Volume]] if the Current or Target [[object:repository|Repository]] is equal to a filter value.

===== Phase =====

This instruction is used by the TapeTrack Synchronization Engine.

===== Syntax =====

''AddSkipOnRepositoryChange(proposed, target, current);''

^ Variable ^ Type ^ Description ^ Min Length ^ Max Length ^
|proposed| String | Filter value representing the proposed change to the Target Repository.|1|128|
|target| String | Filter value representing the current Target Repository value.|1|128|
|current| String | Filter value representing the current Current Repository value|1|128|

===== Example =====

Skip an update if the proposed change is HOLD and the current target repository is LIBR.

<code text;>
AddSkipOnRepositoryChange("HOLD", "LIBR", "*");
</code>

Skip an update if the proposed change is HOLD, the target Repository is LIBR  and the current Repository is OFFS,  LEGL or DEST.

<code text;>
AddSkipOnRepositoryChange("HOLD", "LIBR", "*(OFFS|LEGL|DEST)");
</code>

Skip any update that attempts to move a Volume out of Current Repository DEST.

<code text;>
AddSkipOnRepositoryChange("*", "*", "DEST");
</code>

===== See Also =====

[[engine:import|Import Engine Functions]] \\
[[cli:sync_fields|Sync Engine Fields]] \\
[[cli:tmss10sync|TMSS10Sync]]

{{tag> import_engine sync_engine}}