TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:command_line_filters_volume

This is an old revision of the document!


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-IDs. 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).

Example filter to include all Media and Volumes that belong to customer US01:

-V "US01.*.*"

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 thatt does not match LTO. Using !*(LT*) will include any Media-IDs that do not start with LT.

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-IDs that end in JA Using 20* will include all Volume-IDs that start with 20 Using 111000L6 will only include Volume-ID 111000L6

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-IDs in the OFFS and LIBR Repositories.

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.

See Also

cli/command_line_filters_volume.1579911093.txt.gz · Last modified: 2025/01/21 22:07 (external edit)