Differences

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

--- technote:volume_home_slot [2021/05/25 14:29] – dcumming
+++ technote:volume_home_slot [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Home Slot ======
-When Volumes are slotted by the Command Line Program [[cli:tmss10slotallocation|TMSS10SlotAllocation]] the Slots assigned are determined by the Repository Options setting, either [[concepts:intellislot|IntelliSlot]] or First Available.
+When [[object:volume|Volumes]] are Slotted by the Command Line Program [[cli:tmss10slotallocation|TMSS10SlotAllocation]] the Slots assigned are determined by the [[object:repository|Repository]] Options setting, either ''IntelliSlot'' or ''First Available''.
+Assigning a [[object:volume|Volume]] with a Home Slot will have [[cli:tmss10slotallocation|TMSS10SlotAllocation]] attempt to slot that [[object:volume|Volume]] to its Home Slot first, if that Slot is unavailable the [[object:volume|Volume]]  will be Slotted according to the pre-set protocol.
+When [[object:volume|Volumes]] are Slotted via ''Restore Home Slot'' Option, the [[object:volume|Volumes]] will be Slotted in their Home Slot unless the Home Slot value is zero.
+===== Prerequisites =====
+The required [[object:repository|Repository]] must have an active [[master:repository_assign_zone|Zone assigned]] with adequate Slots.
+See:
+  * [[master:admin_zone|Creating Zones]]
+  * [[master:repository_assign_zone|Assigning Zones]]
-Assigning a Volume with a Home Slot will have [[cli:tmss10slotallocation|TMSS10SlotAllocation]] attempt to slot that Volume to its Home Slot first, if that Slot is unavailable the Volume will be Slotted according to the preset protocol.
 ===== Assigning A Home Slot =====
-To assign a Volume to a Home Slot, from the Inventory window in TapeMaster:
+==== Volume Already Slotted In The Required Home Slot ====
-  * Right-click a Volume and select ''Properties''
-  * Open the ''Options'' tab
+If the [[object:volume|Volume]] is already Slotted in (eg. Volume 000010L6), or assigned to the Slot (eg. Volume 000006L6), right click on the [[object:volume|Volume]] and select ''Special Operations'' > ''Capture Home Slot''.
-  * Expand the ''Home Locations''
-  * In the ''Slot'' field, enter the required Home Slot number
+Using this method you can set the Home Slot of one or multiple [[object:volume|Volumes]] in the one operation.
+{{special_operations_capture_home_slot_menu.gif}}
+If you use this process with a [[object:volume|Volume]] that is not Slotted or assigned to a Slot (eg. Volume 000012L6) the Home Slot will be set to zero (no Home Slot).
+If you use this process on a [[object:volume|Volume]] that already has a Home Slot, the Home Slot value will be set to the Current assigned Slot.
+==== Setting Home Slot Via Volume Properties ====
+To assign a [[object:volume|Volume]] to a Home Slot, from the Inventory window in TapeMaster:
+  * Right-click a [[object:volume|Volume]] and select ''Properties''.
+  * Select the ''Options'' tab.
+  * Expand the ''Home Locations'' by clicking the ''+''.
+  * In the ''Slot'' field enter the required Home Slot number by using the incrementor arrows (eg. 3) or typing in the number (eg. 212).
   * Click ''Save'' to update the data and close the Properties window.
-{{master_volume_home_slot.png}}
+{{volume_properties_set_home_slot.gif}}
+<note>If a [[object:volume|Volume]] is Slotted in multiple [[object:repository|Repositories]]  (eg Offsite Vault and Racking), [[cli:tmss10slotallocation|TMSS10SlotAllocation]] will attempt to assign it to its Home Slot in all [[object:repository|Repositories]].</note>
+===== Slotting Volumes In Home Slot Automatically =====
+==== Slotting Via TMSS10SlotAllocation ====
+Executing [[cli:tmss10slotallocation|TMSS10SlotAllocation]] will attempt to Slot the [[object:volume|Volumes]] in the assigned Home Slot.  If the Home Slot is occupied [[cli:tmss10slotallocation|TMSS10SlotAllocation]] will Slot the [[object:volume|Volume]] in an alternative Slot.
+==== Slotting Via Restore Home Slot Option ====
+If ''Restore Home Slot'' is set to True, the [[object:volume|Volumes]] will be placed in their Home Slot without the need to run TMSS10SlotAllocation.
+To set ''Restore Home Slot'' right click the required [[object:repository|Repository]] and select ''Properties''.
+{{repository_properties_restore_home_slot_true.gif}}
+<note>Ensure each [[object:volume|Volume]] has a unique Home Slot value.  Assigning a Slot to more than one [[object:volume|Volume's]] Home Slot value can result in multiple [[object:volume|Volumes]] being Slotted in the one Slot.</note>
-<note tip>If a Volume is Slotted in multiple Repositories (eg Offsite Vault and Racking), TMSS10SlotAllocation will attempt to assign it to its Home Slot in all Repositories.</note>
+{{tag> update_doco home slot}}