TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:command_line_filters_volume

Volume Filter

The Volume Filter (-V) is used in the Command Line programs to filter which Volumes are included in the input process.

Volume Filter Sections

The Volume filter is divided up into sections Customer-ID.Media-ID.Volume-ID@Repository-ID+-Flags.

The following sections refer to each individual part of the Volume filter such as -V Customer-ID, use of the filter requires the individual parts to be combined into either -V CUST.MEDIA.VOLUME or CUST.MEDIA.VOL@REP+FLAG

Customer-ID

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).*.*"

Media-ID

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.*"

Volume-ID

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*"

Repository-ID

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"

Flags

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

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"

See Also

cli/command_line_filters_volume.txt · Last modified: 2024/05/27 23:23 by scunliffe