UPDATE VOLUME（變更儲存區磁區）

請使用這個指令來變更儲存區中一或多個磁區之存取模式。

您可以藉由將磁區更新為 READWRITE 存取模式，來更正與磁區相關聯的錯誤狀況。 您也可以使用這個指令來變更循序存取儲存區內一或多個磁區的位置資料。

專用權類別

如果要發出這個指令，您必須具有系統專用權或操作員專用權。

語法

讀取語法圖表略過語法圖表
                 (1)                
>>-UPDate Volume------volume_name------------------------------->

>--+------------------------------+----------------------------->
   '-ACCess--=--+-READWrite-----+-'   
                +-READOnly------+     
                +-UNAVailable---+     
                |           (2) |     
                +-DEStroyed-----+     
                |         (3)   |     
                '-OFfsite-------'     

>--+---------------------------+-------------------------------->
   |          (4)              |   
   '-LOcation------=--location-'   

   .-WHERESTGpool--=--*---------.   
>--+----------------------------+------------------------------->
   '-WHERESTGpool--=--pool_name-'   

   .-WHEREDEVclass--=--*-----------------.   
>--+-------------------------------------+---------------------->
   '-WHEREDEVclass--=--device_class_name-'   

>--+-------------------------------------+---------------------->
   |                 .-,---------------. |   
   |                 V                 | |   
   '-WHEREACCess--=----+-READWrite---+-+-'   
                       +-READOnly----+       
                       +-UNAVailable-+       
                       +-OFfsite-----+       
                       '-DEStroyed---'       

>--+---------------------------------+-------------------------->
   |                 .-,-----------. |   
   |                 V             | |   
   '-WHERESTatus--=----+-ONline--+-+-'   
                       +-OFfline-+       
                       +-EMPty---+       
                       +-PENding-+       
                       +-FILling-+       
                       '-FULl----'       

   .-Preview -=--No------.   
>--+---------------------+-------------------------------------><
   '-Preview--=--+-No--+-'   
                 '-Yes-'     
註:
  1. 您必須至少更新一種屬性 （ACCESS 或 LOCATION）。
  2. 這個值只對主要儲存區中的磁區有效。
  3. 這個值只對副本儲存區、儲存器副本儲存區及作用中資料儲存區中的磁區有效。
  4. 這個參數只對循序存取儲存區中的磁區有效。

參數

volume_name（必要）
指定要更新的儲存區磁區。 您可以使用萬用字元來指定名稱。
ACCess
指定用戶端節點與伺服器處理程序（如移轉）如何存取儲存區磁區中的檔案。 此為選用參數。 可能的值為：
READWrite
指定用戶端節點與伺服器處理程序可以讀取及寫入儲存在磁區上的檔案。

如果要更新的磁區是具有離站存取模式的空白暫存磁區，則伺服器會將磁區從資料庫中刪除。

READOnly
指定用戶端節點與系統處理程序只能讀取磁區上的檔案。

如果要更新的磁區是具有離站存取模式的空白暫存磁區，則伺服器會將磁區從資料庫中刪除。

UNAVailable
指定用戶端節點及伺服器處理程序都不能存取儲存在磁區上的檔案。

在使隨機存取磁區變成無法使用之前，您必須先使磁區離線。 使隨機存取磁區變成無法使用之後，您就不能將磁區上線。

若您將循序存取磁區變成無法使用，伺服器就不會試圖裝載磁區。

如果要更新的磁區是具有離站存取模式的空白暫存磁區，則伺服器會將磁區從資料庫中刪除。

DEStroyed
指定主要儲存區磁區已永久損壞。 用戶端節點及伺服器處理程序都無法存取儲存在磁區上的檔案。 請使用這個存取模式來指出需要以 RESTORE STGPOOL 指令還原的整個磁區。 當毀損磁區上的所有檔案已還原到其他磁區之後，伺服器會從資料庫自動刪除毀損的磁區。

只有主要儲存區中的磁區才能更新成 DESTROYED。

在將隨機存取磁區更新為 DESTROYED 存取之前，您必須先使磁區變為離線。 將隨機存取磁區更新為 DESTROYED 之後，就不能使磁區上線。

若您將循序存取磁區更新為 DESTROYED，則伺服器不會試圖裝載磁區。

若磁區不含檔案，而您將存取模式變成 DESTROYED，則伺服器會將磁區從資料庫刪除。

OFfsite
指定副本儲存區磁區、儲存器副本儲存區磁區或作用中資料儲存區磁區位於遠端位置，並且無法由此裝載。 只有副本儲存區、儲存器副本儲存區及作用中資料儲存區中的磁區才具有 OFFSITE 存取模式。

若您同時為 ACCESS 及 LOCATION 參數指定值，但無法更新特定磁區的存取模式，則也不會更新該磁區的位置屬性。 例如，若您為主要儲存區磁區指定 ACCESS=OFFSITE 和 LOCATION 值，則存取值或位置值均不會更新，因為您不能為主要儲存區磁區給定 OFFSITE 存取模式。

LOcation
指定磁區的位置。 此為選用參數。 在循序存取儲存區上僅有磁區方面可指定。 位置的長度上限為 255個字元。 若位址包含任何空白字元，則位置應以引號括住。 如果要移除先前所定義的位置，請指定空字串 ("")。
WHERESTGpool
指定為更新磁區的儲存區名稱。 使用這個參數來限制儲存區所作的更新。 此為選用參數。 您可以使用萬用字元來指定名稱。 若您不指定儲存區名稱，所有儲存區的磁區均會更新。
WHEREDEVclass
指定要更新的裝置類別名稱。 使用這個參數來限制裝置類別所作的更新。 此為選用參數。 您可以使用萬用字元來指定名稱。 若您不指定裝置類別名稱，所有裝置類別的磁區均會更新。
WHEREACCess
指定被更新磁區的現有存取模式。 使用這個參數來限制對目前具有指定存取模式的磁區進行更新。 此為選用參數。 您可以指定多個存取節點，方法是以逗號將模式隔開，而且中間沒有空格。 若您沒有為這個參數指定一個值，則更新不限制於磁區現行的存取模式。 可能的值為：
READWrite
更新具有 READWRITE 存取模式的磁區。
READOnly
更新具有 READONLY 存取模式的磁區。
UNAVailable
更新具有 UNAVAILABLE 存取模式的磁區。
OFfsite
更新具有 OFFSITE 存取模式的磁區。
DEStroyed
更新具有 DESTROYED 存取模式的磁區。
WHERESTatus
指定被更新磁區的狀態。 使用這個參數來限制更新具有指定狀態的磁區。 此為選用參數。 您可以指定多個狀態值，方法是以逗號將值隔開，而且中間沒有空格。 若您沒有為這個參數指定一個值，則更新不受限於磁區狀態。 可能的值為：
ONline
更新具有 ONLINE 狀態的磁區。
OFfline
更新具有 OFFLINE 狀態的磁區。
EMPty
更新具有 EMPTY 狀態的磁區。
PENding
更新具有 PENDING 狀態的磁區。 所有的檔案就是從這些磁區上刪除，但是由 REUSEDELAY 參數所指定的時間尚未結束。
FILling
更新具有 FILLING 狀態的磁區。
FULl
更新具有 FULL 狀態的磁區。
Preview
指定您是否只要預覽更新作業，而不要更新磁區。 此為選用參數。 預設值為 NO。 可能的值為：
No
指定更新磁區。
Yes
指定您只要預覽更新作業。 若您執行更新作業，則此選項會顯示將更新的磁區。

範例：使磁帶磁區變成無法使用

更新名稱為 DSMT20 的磁帶磁區，使它無法供用戶端節點與伺服器處理程序使用。
update volume dsmt20 access=unavailable

範例：更新特定儲存區中所有離站磁區的存取模式

更新 TAPEPOOL2 儲存區中所有空白的遠地磁區。 將存取模式設定為 READWRITE，並為已更新磁區刪除位置資訊。
update volume * access=readwrite location="" wherestgpool=tapepool2
whereaccess=offsite wherestatus=empty

相關指令

表 1. UPDATE VOLUME 的相關指令
指令 說明
DEFINE VOLUME 指定磁區為指定儲存區之內所使用的儲存體。
DELETE VOLUME 刪除儲存區中的磁區。
QUERY VOLUME 顯示儲存區磁區的相關資訊。
VARY 指定磁區是否可供伺服器使用。