====== Hiding Volumes ======

[[object:volume|Volumes]] can be hidden, or removed from view, in TapeTrack TapeMaster and from Command Line programs (through flag exclusion), cleaning up [[object:volume|Volume]] display without needing to delete volumes and their associated data.  

Reasons for hiding [[object:volume|Volumes]] range from being moved permanently out of rotation, locked from movement for legal reasons or any other reason that operators do not need to see them and would prefer a cleaner display in TapeTrack TapeMaster or Command Line reports.  

Hiding [[object:volume|Volumes]] from display is a two part process:
  * Adding the hidden Attribute (h) Flag to the required [[object:volume|Volumes]].
  * Removing the Hidden [[object:volume|Volumes]] from display via the TapeTrack TapeMaster Preferences.

Hiding [[object:volume|Volumes]] with the hidden Attribute from the Command Line batch programs involves adding a reference to the h flag in the [[object:volume|Volume]] filter.

===== Adding Hidden Attribute To A Volume =====

In the inventory tab of the required Customers Media type:
  * Select the [[object:volume|Volumes]] by left-clicking (or range select volumes with ''Shift'' + ''Click'' or ''Ctrl'' + ''Click)''.
  * Right click the highlighted [[object:volume|Volumes]]  and select ''Special Operations'' -> ''Modify'' -> ''Flags''.

{{volumes_special_modify_flags.gif}}

  * From the **Modify Flags** window expand the flag option ''Hidden'' by clicking the ''+'' icon.
  * Click on the field to the right of **Value** and select ''Add Flag'' from the drop-down list.
  * Click ''Apply Updates''.

{{add_hidden_flag.gif}}

The [[object:volume|Volumes]]  will now display with a h flag in addition to their other assigned flags.

===== Hiding Volumes From Display In TapeTrack TapeMaster =====

<note tip>Removing hidden [[object:volume|Volumes]] from display in TapeTrack TapeMaster affects only the Desktop software the preferences are altered in.  It does not alter any other software's display accessing the server.  The [[object:volume|Volumes]] will, however display the h flag globally.</note>

Open the TapeTrack TapeMaster Preferences by selecting ''File'' -> ''Preferences''.

{{file_preferences.gif}}

Set the ''Show Hidden Volumes'' field to ''false'' via the drop-down box.

Click ''OK'' to close the **Preferences** window and save the updates.

{{show_hidden_volumes_false.gif}}

===== Restoring Hidden Volumes To Display In TapeTrack TapeMaster =====

Open the TapeTrack TapeMaster Preferences by selecting ''File'' -> ''Preferences''.

{{file_preferences.gif}}

Set the ''Show Hidden Volumes'' field to ''True'' via the drop-down box.

Click ''OK'' to close the **Preferences** window and save the updates.

{{show_hidden_volumes_true.gif}}

Resetting the TapeTrack TapeMaster display, may be required depending on the version installed, by  clicking in the Inventory window and pressing ''F5'' on your keyboard.

===== Hiding Volumes From Command Line Programs =====

All Command Line batch programs that use a [[object:volume|Volume]] filter can be set to skip [[object:volume|Volumes]] with the hidden Attribute (h Flag) and exclude them from the results and reports.

==== Example ====

<note important>All [[object:user|User]], server, [[object:customer|Customer]] and [[object:media|Media]] details shown are examples only.  You will need to insert your own values in order to make a successful connection to your server.</note>

Show complete inventory, minus any hidden [[object:volume|Volumes]] for customer US04, media LTO currently in repository OFFS, excluding all [[object:volume|Volumes]] with a Hidden (h) Flag.
<code>
TMSS10Inventory -S user:-password@server -V "US04.LTO.*@OFFS+!h"
</code>


{{tag> technote tapemaster cli volume flags h-flag}}