The Volume Filter (-V) is used in the Command Line programs to filter which Volumes are included in the input process.
The Volume filter is divided up into sections Customer-ID.Media-ID.Volume-ID@Repository-ID+-Flags.
The Customer-ID section filters the Customers that are considered for input into the Command Line programs.
Using * will include all Customer-ID's. Using US01 will only include Customer-ID US01. Using US* will input include Customer-ID's that start with US (eg. US01, US02, US4). Using !*(US01) will include any Customer-ID that does not match US01. Using !*(US*) will include any Customer-ID that does not match any Customer-ID's that start with US (eg. US01, US02, US4 would be excluded).
Example filter to include all Media and Volumes that belong to Customer US01:
-V "US01.*.*"
Example filter to include all Media and Volumes that belong to Customers that start with US (eg US01, US02, US03)
-V "US*.*.*"
Example filter to include all Media and Volumes that belong to Customers US01, US02, US03
-V "*(US01|US02|US03).*.*"
The Media-ID section filters the Media Types that are considered for input into the Command Line programs.
Using * will include all Media-ID's. Using LTO will only include Media-ID LTO. Using LT* will include any Media-IDs that start with LT (eg. LTO, LT02, LTO6). Using !*(LTO) will include all Media-ID's that does not match LTO. Using !*(LT*) will include any Media-IDs that do not start with LT.
Example filter to include all Customer and Volumes that belong to Media-ID Type LTO:
-V "*.LTO.*"
The Volume-ID section filters the Volumes that are considered for input into the Command Line programs.
Using * will include all Volume-ID's Using *JA will include all Volume-ID's that end in JA Using 20* will include all Volume-ID's that start with 20 Using 111000L6 will only include Volume-ID 111000L6
Example filter to include all Customer and Media Type that have a Volume-ID ending in the suffix L6:
-V "*.*.L6*"
The Repository-ID filters the Repositories that are considered for input into the Command Line programs and must be preceded by the @ symbol.
Using @OFFS will include only Volumes at the OFFS Repository. Using @!(OFFS) will include all Volumes not at OFFS Repository. Using @*(LIBR|OFFS) will include all Volume-ID's in the OFFS and LIBR Repositories.
Example filter to include all Customer, Media and Volumes that are in Repository OFFS:
-V "*.*.*@OFFS"
The Flag filters the Flag values that are considered for input into the Command Line programs and must be preceded by the Repository filter (at a minimum@*) and the + symbol.
Using +Z will include all Volumes that have a Z (scratch) Flag. Using +ZN will include all Volumes that have a Z (scratch) Flag and an N (description) Flag. Using +!Z will include all Volumes that don't have a Z (scratch) Flag. Using +!Z!N will include all Volumes that don't have a Z (scratch) Flag and an N (description) Flag. Using +!ZN will include all Volumes that don't have a Z (scratch) Flag and and do have an N (description) Flag.
Example filter to include all Customer, Media and Volumes that have a Z Flag (scratch):
-V "*.*.*@*+Z"
Example filter to include Customer-ID US01, Media Type LTO, Volumes ending in L6, are in Repository OFFS and have a Z (scratch) Flag:
-V "US01.LTO.*L6@OFFS+Z"