UPDATE VOLUME（更改存储池卷）

在线编辑

使用此命令可改变存储池中一个或多个卷的访问方式。

通过将卷更新为 READWRITE 访问方式，可更正与卷关联的错误状态。 还可以使用此命令来更改顺序存取存储池中的一个或多个卷的位置信息。

特权类

要发出此命令，您必须具有系统特权或操作员特权。

语法

读取语法图跳过可视语法图UPDate Volume1volume_nameACCess=READWriteREADOnlyUNAVailableDEStroyed2OFfsite3LOcation4=位置WHERESTGpool=*WHERESTGpool=Pool_NameWHEREDEVclass=*WHEREDEVclass=设备类名称WHEREACCess=,READWriteREADOnlyUNAVailableOFfsiteDEStroyedWHERESTatus=,ONlineOFflineEMPtyPENdingFILlingFULlPreview=NoPreview=NoYes
注：
  • 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 相关的命令
命令 描述
定义卷 分配将在指定存储池中用于存储的卷。
删除卷 从存储池删除卷。
查询卷 显示有关存储池卷的信息。
变化 指定服务器是否可使用磁盘卷。