Differences

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

--- cli:volume_filter [2021/07/21 23:56] – [Command Line Volume Filter Argument] Scott Cunliffe
+++ cli:volume_filter [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-===== Command Line Volume Filter Argument =====
+====== Command Line Volume Filter Argument ======
+The Command Line Volume Filter Argument or Batch Volume filter allows you to only include the Customers, Media Types, Volumes, Repositories and Flags required for the process you are running.
+This allows not only exclusion of unwanted data but lowers the processing time.
 The [[object:volume|Volume]] filter argument sets the [[object:volume|Volume]] Filter which can be used to filter the traversal of [[object:customer|Customer]], [[object:media|Media]] and [[object:volume|Volume]] values. The format of this filter is ''c.m.v@r+f'', where ''c'' is [[object:customer|Customer-ID]] filter, ''m'' is [[object:media|Media-ID]] filter, ''v'' is [[object:volume|Volume-ID]] filter, ''r'' is [[object:repository|Repository-ID]] filter and ''f'' is the [[common:volume_flags|Flag]] filter.
-If the -V filter is not assigned a value it assumes the default of ''-V *.*.*'' which will, by use of wild card value, include all [[object:volume|Volumes]].  Each of the values within the filter can be left as a wild card or assigned a value.
+If the -V filter is not assigned a value it assumes the default of ''-V "*.*.*"'' which will, by use of wild card value, include all [[object:volume|Volumes]].  Each of the values within the filter can be left as a wild card or assigned a value.
 ===== Examples =====
@@ Line 20: / Line 24: @@
 <code plain;>
 -V "US01.LTO.*"
+</code>
+To process all **LTO** [[object:volume|Volumes]] for all except [[object:customer|Customer]] **US01**
+<code plain;>
+-V "!(US01).LTO.*"
+</code>
+To process all **LTO** [[object:volume|Volumes]] for all except [[object:customer|Customer]] **US01** and **US02**
+<code plain;>
+-V "!(US01|US02).LTO.*"
 </code>
@@ Line 26: / Line 40: @@
 -V "US01.LTO.*@ACME+E"
 </code>
+To process all **LTO** [[object:volume|Volumes]] in the offsite Repository that are Scratch and not Encrypted.
+<code>
+-V "*.LTO.*@OFFS+Z!E"
+</code>