Differences

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

--- cli:volume_filter [2017/09/20 10:02] – 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 volume filter argument sets the Volume Filter which can be used to filter the traversal of Customer, Media and Volume values. The format of this filter is c.m.v@r+f, where c is Customer-ID filter, m is Media-ID filter, v is Volume-ID filter, r is Repository-ID filter and f is the flag filter.
+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.
-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 volumes.  Each of the values within the filter can be left as a wild card or assigned a value.
+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.
 ===== Examples =====
-To process all volumes only in Repository ACME
+To process all [[object:volume|Volumes]] only in [[object:repository|Repository]] ACME
-<code>
+<code plain;>
  -V "*.*.*@ACME"
 </code>
-To process all volumes not in Repository ACME
+To process all [[object:volume|Volumes]] not in [[object:repository|Repository]] ACME
-<code>
+<code plain;>
  -V "*.*.*@!(ACME)"
 </code>
-To process all **LTO** volumes for customer **US01** in repository **ACME** with an **encrypted** flag
+To process all **LTO** [[object:volume|Volumes]] for [[object:customer|Customer]] **US01**
-<code>
+<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>
+To process all **LTO** [[object:volume|Volumes]] for [[object:customer|Customer]] **US01** in repository **ACME** with an **encrypted** flag
+<code plain;>
 -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>