QUERY VOLUME（查询存储池卷）
使用此命令显示关于一个或多个存储池卷的信息。
特权级别
任何管理员都可以发出此命令。
语法
.-*-----------. >>-Query Volume--+-------------+--------------------------------> '-volume_name-' >--+--------------------------------+---------------------------> | .-,---------------. | | V | | '-ACCess--=----+-READWrite---+-+-' +-READOnly----+ +-UNAVailable-+ +-OFfsite-----+ '-DEStroyed---' .-STGpool--=--*---------. >--+----------------------------+--+-----------------------+----> | .-,-----------. | '-STGpool--=--pool_name-' | V | | '-STatus--=----+-ONline--+-+-' +-OFfline-+ +-EMPty---+ +-PENding-+ +-FILling-+ '-FULl----' .-DEVclass--=--*-----------------. >--+--------------------------------+---------------------------> '-DEVclass--=--device_class_name-' .-Format--=--Standard-----. >--+-------------------------+--------------------------------->< '-Format--=--+-Standard-+-' '-Detailed-'
参数
- volume_name
- 指定要查询的卷。 此参数是可选参数。 可以使用通配符指定名称。 如果未指定名称，那么所有存储池卷都包含在此查询中。
- ACCess
- 指定用卷访问方式来限制输出。 此参数是可选参数。 可指定多个访问方式，以逗号分开方式且其中无空格。 如果不为此参数指定值，那么输出将不受访问方式的限制。
可能的值有：
- READWrite
- 显示存取方式为 READWRITE 的卷。 客户机节点和服务器进程可以从存储在卷中的文件读取或向该处写入。
- READOnly
- 显示访问方式为 READONLY 的卷。 客户机节点和服务器进程仅可读取存储在卷中的文件。
- UNAVailable
- 显示访问方式为 UNAVAILABLE 的卷。 客户机节点和服务器进程不能访问存储在卷中的文件。
- OFFsite
- 显示访问方式为 OFFSITE 的副本存储池卷。 这些卷处于不能从该处安装它们的越位位置。
- DEStroyed
- 显示访问方式为 DESTROYED 的主存储池卷。 这些卷已指定为永久性损坏。
- STatus
- 指定按卷状态限制输出。 此参数是可选参数。 可以通过使用逗号且不间插任何空格分隔此各值而指定多个状态值。 如果不为此参数指定值，那么输出不受卷状态的限制。
可能的值有：
- ONline
- 显示服务器可以使用的随机存取卷。
- OFfline
- 显示服务器不能使用的随机存取卷。
- EMPty
- 显示没有任何数据的顺序存取卷。
- PENding
- 显示状态为 PENDING 的卷。 这些卷可能是如下顺序存取卷：从中删除了所有文件，但由 DEFINE STGPOOL 命令中 REUSEDELAY 参数指定的时间尚未过去。 这些卷也可能是已删除的随机存取磁盘卷，但是仍包含等待销毁的已废弃数据。 粉碎数据后，实际上将删除卷。
- FILling
- 显示服务器已写入但尚未填满容量的顺序存取卷。
- FULl
- 显示服务器已填满的顺序存取卷。
- STGPool
- 指定要查询的存储池。 此参数是可选参数。 可以使用通配符指定名称。 如果未指定存储池名称，那么所有存储池都包含在此查询中。
- DEVclass
- 指定要查询的设备类。 此参数是可选参数。 可以使用通配符指定名称。 如果未指定设备类名称，那么所有设备都包含在此查询中。
- Format
- 指定如何显示信息。 此参数是可选参数。 缺省值为 STANDARD。 可能的值包括：
- Standard
- 指定显示部分信息。
- Detailed
- 指定显示完整的信息。
示例：列出所有文件存储池卷
显示设备类名称为 FILE 的所有存储池卷的信息。 有关字段描述，请参阅字段描述。query volume devclass=fileVolume Name Storage Device Estimated Pct Volume
Pool Name Class Name Capacity Util Status
----------------------- ----------- ---------- --------- ----- -------
/FCT/SERVER/COVOl1 COPYSTG FILE 0.0 M 0.0 Pending
/FCT/SERVER/COVOl2 COPYSTG FILE 0.0 M 0.0 Empty
/FCT/SERVER/COVOl3 COPYSTG FILE 0.0 M 0.0 Empty
/FCT/SERVER/PRVOl1 PRIMESTG FILE 0.0 M 0.0 Empty
/FCT/SERVER/PRVOl2 PRIMESTG FILE 0.0 M 0.0 Empty
示例：列出具有同一前缀的所有存储池卷
显示以 ATF 名称为前缀的所有存储池卷的信息。 有关字段描述，请参阅字段描述。
query volume atf*Volume Name Storage Device Estimated Pct Volume
Pool Name Class Name Capacity Util Status
----------------------- ----------- ---------- --------- ----- -------
ATF001 8MMPOOL 8MMTAPE 4.8 G 18.2 填充
ATF002 8MMPOOL 8MMTAPE 4.8 G 18.2 填充示例：显示关于特定存储池卷的详细信息
显示关于称为 /fct/server/covol1 的存储池卷的详细信息。 有关字段描述，请参阅字段描述。query volume covol1 format=detailed Volume Name: /FCT/SERVER/COVOl1
Storage Pool Name: COPYSTG
Device Class Name: DISK
Estimated Capacity: 10.0 M
Scaled Capacity Applied:
Pct Util: 6.7
Volume Status: On-line
Access: Read/Write
Pct. Reclaimable Space: 3.2
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 11
Write Pass Number: 1
Approx. Date Last Written: 04/14/1998 16:17:26
Approx. Date Last Read: 04/01/1998 13:26:18
Date Became Pending:
Number of Write Errors: 0
Number of Read Errors: 0
Volume Location:
Volume is MVS Lanfree Capable: No
Last Update by (administrator): COLLIN
Last Update Date/Time: 05/01/1998 14:07:27
Begin Reclaim Period:
End Reclaim Period:
Logical Block Protection:
Drive Encryption Key Manager:示例：显示关于特定存储池卷的详细信息
显示存储池卷 WPDV00 的详细信息。 有关字段描述，请参阅字段描述。query volume wpdv00 format=detailed Volume Name: WPDV00
Storage Pool Name: TAPEPOOL
Device Class Name: TAPE
Estimated Capacity: 5.8 M
Scaled Capacity Applied:
Pct Util: 0.1
Volume Status: On-line
Access: Read/Write
Pct. Reclaimable Space: 3.2
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 11
Write Pass Number: 1
上次读取 Date Last Written: 04/14/1998 16:17:26
上次读取 Date Last Read: 04/01/1998 13:26:18
Date Became Pending:
Number of Write Errors: 0
Number of Read Errors: 0
Volume Location:
Volume is MVS Lanfree Capable: No
Last Update by (administrator): COLLIN
Last Update Date/Time: 05/01/1998 14:07:27
Begin Reclaim Period:
End Reclaim Period:
Logical Block Protection:
Drive Encryption Key Manager:示例：显示有关具有特定设备类的存储池卷的详细信息
显示存储池中有关某个设备类名称为 FILECLASS 的卷的详细信息。 有关字段描述，请参阅字段描述。query volume devclass=fileclass format=detailed Volume Name: Z:\WORM_CFS\0000000E.BFS
Volume Name: /WORM_FILESYS/0000000E.BFS
Storage Pool Name: FILEPOOL
Device Class Name: FILECLASS
Estimated Capacity: 2.0 G
Scaled Capacity Applied:
Pct Util: 0.0
Volume Status: Filling
Access: Read/Write
Pct. 可回收空间：00
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 1
Write Pass Number: 1
上次读取 大致日期：03/22/2004 15:23:46
上次读取 大致日期：03/22/2004 15:23:46
Date Became Pending:
Number of Write Errors: 0
Number of Read Errors: 0
Volume Location:
Volume is MVS Lanfree Capable: No
Last Update by (administrator):
Last Update Date/Time: 03/22/2004 15:23:46
Begin Reclaim Period: 03/22/2005
End Reclaim Period: 04/22/2005
Logical Block Protection:
Drive Encryption Key Manager:示例：显示关于特定存储池卷的详细信息
显示有关名为 000642 的存储池卷的详细信息。 该卷位于与 3592 设备类关联的存储池中。 有关字段描述，请参阅字段描述。query volume 000642 format=detailed Volume Name: 000642
Storage Pool Name: 3592POOL
Device Class Name: 3592CLASS
Estimated Capacity: 2.0 G
Scaled Capacity Applied:
Pct Util: 0.0
Volume Status: Filling
Access: Read/Write
Pct. 可回收空间：00
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 1
Write Pass Number: 1
上次读取 大致日期：03/22/2004 15:23:46
上次读取 大致日期：03/22/2004 15:23:46
Date Became Pending:
Number of Write Errors: 0
Number of Read Errors: 0
Volume Location:
Volume is MVS Lanfree Capable: No
Last Update by (administrator):
Last Update Date/Time: 03/22/2004 15:23:46
Begin Reclaim Period: 03/22/2005
End Reclaim Period: 04/22/2005
Logical Block Protection: Yes
Drive Encryption Key Manager: Tivoli Storage Manager 字段描述
- 卷名
- 存储池卷的名称。
- 存储池名称
- 定义卷的存储池名称。
- 设备类名称
- 分配给存储池的设备类。
- 估计容量
- 卷的估算容量，以兆字节 (M)、千兆字节 (G) 或太字节 (T) 为单位。
对于 DISK 设备，此值是卷的容量。
对于顺序存取设备，此值是基于设备类的卷的总可用空间估算值。
- 所测量的容量已应用
- 卷被调定到的容量百分比。 例如，对于最大容量为 300 GB 的卷，值 20 表示卷只能存储 300 GB 的 20%，即 60 GB。 此属性仅适用于 IBM® 3592 设备。
- 利用率
- 卷的利用率的估计值。 利用率包含文件和聚集所占用的所有空间，包括聚集中的可用空间。
对于 DISK 卷，利用率还包含高速缓存数据占用的空间。
- 卷状态
- 卷的状态。
- 访问权
- 卷是否对服务器可用。
- 可回收空间 （仅限顺序存取卷）百分比
- 此卷上由于数据已过期或已被删除而可以回收的空间量。 该值与存储池的回收阈值相比较以确定是否需要回收。 可回收空间包括聚集中的可用空间。
确定存储池中要回收的卷时，Tivoli® Storage Manager 服务器首先确定回收阙值。 回收阙值通过 RECLAIM STGPOOL 命令上的 THRESHOLD 参数的值来指定，或者，如果未指定此值，将使用存储池定义中的 RECLAIM 参数值。 之后，服务器将检查存储池中各卷的可回收空间百分比。 如果某个卷上的可回收空间百分比大于存储池的回收阙值，那么该卷将成为候选回收的卷。
例如，假定存储池 FILEPOOL 的回收阈值为 70%。 此值表示服务器可回收存储池中可回收空间百分比超过 70% 的任何卷。 存储池有三个卷：- FILEVOL1，可回收空间百分比为 65%
- FILEVOL2，可回收空间百分比为 80%
- FILEVOL3，可回收空间百分比为 95%
回收开始时，服务器将各卷的可回收空间百分比与回收阈值 70% 相比较。 在此示例中，FILEVOL2 和 FILEVOL3 是可进行回收的候选卷，因为它们的可回收空间百分比都超过了 70%。
对于属于 SnapLock 存储池的卷，显示但不使用该值。
- 临时卷？ （仅限顺序存取卷）
- 当卷为空时是否将该卷返回临时卷。
- 处于错误状态？
- 是否此卷处于错误状态。 错误状态下服务器不能向卷写入数据。
- 可写面数
- 为 IBM Tivoli Storage Manager 保留此信息。
- 已安装的次数
- 服务器打开卷以进行使用的次数。 服务器打开卷的次数不总是与将卷物理安装到磁带机中的次数相同。 物理安装某卷后，服务器可因为不同操作（例如，不同的客户机备份会话）多次打开相同的卷。
- 写入通过数（仅限顺序存取卷）
- 此卷从头到尾写入的次数。
- 上次写入 的大致日期
- 上次写卷时的近似日期。
- 上次读取 的大致日期
- 上次读卷时的近似日期。
- 日期变为未确定
- 卷状态更改为暂挂的日期。
- 写入错误数
- 卷上已发生的写入错误数。
- 读取错误数
- 卷上已发生的读取错误数。
- 卷位置
- 卷的位置。
- 卷具有 MVS 不依赖 LAN 的能力
- 卷是否有不依赖 LAN 的能力。 具有不依赖 LAN 的能力的卷是指由 Tivoli Storage Manager z/OS® 数据管理服务器定义并使用（至少一次）的卷。
- 上次更新者（管理员）
- 定义或最近更新此卷的管理员。
- 上次更新日期/时间
- 定义或最近更新此卷的时间。
- 开始回收周期
- 表示一个日期，在此日期后 Tivoli Storage Manager 开始回收此卷，但该日期不得晚于结束回收周期表示的日期。 回收周期开始时，如果卷上有未过期的文件，那么这些文件在回收处理期间将移到新的 WORM 卷上。 仅当此卷在 RECLAMATIONTYPE 参数值为 SNAPLOCK 的存储池中时，此字段才显示日期。
如果同一个卷上存储了多个归档，那么将根据最新归档的日期开始卷的回收周期。 对于 SnapLock 卷，DEFINE COPYGROUP 命令的 RETVer 参数确定存储归档的时间。 如果将 RETVer 设置为 100 天，那么卷的回收周期就是在卷上存储第一个归档后的 100 天。 如果在同一个卷上存储了第二个归档，那么在存储新归档后，会将回收开始日期调整为 100 天。 如果在存储了第一个归档后更改了 RETVer 值，那么将对卷上的所有归档应用最新的回收日期。 例如，对于初始归档，假设 RETVer 被设置为 100，但是随后更改为 50。 如果在存储了第一个归档后的三天在卷上存储了第二个归档，那么只有在存储了第一个归档后的 100 天后，回收周期才能开始。
- 结束回收周期
- 表示一个日期，Tivoli Storage Manager 必须于此日期之前在该卷上完成回收处理以确保继续保护数据。 它也表示 NetApp 文件中的“上次访问日期”物理文件属性，该属性将防止在该日期之前删除文件。 仅当此卷在 RECLAMATIONTYPE 参数值为 SNAPLOCK 的存储池中时，此字段才显示日期。
- 逻辑块保护
- 指定是否对卷启用了逻辑块保护。 只能对以下类型的磁带机和介质使用逻辑块保护：
- IBM LTO5 和更高版本
- 带有 3592 第二代介质和更高版本的 IBM 3592 第三代磁带机和更高版本
- Oracle StorageTek T10000C 和 T10000D 磁带机
- 磁带机加密密钥管理器
- 磁带机加密密钥管理器。 该字段仅适用于与 3592、LTO 或 ECARTRIDGE 设备类型关联的存储池中的卷。
相关命令
| 命令 | 描述 |
|---|---|
| DEFINE DEVCLASS | 定义设备类。 |
| DEFINE VOLUME | 分配将在指定存储池中用于存储的卷。 |
| DELETE VOLUME | 从存储池中删除卷。 |
| UPDATE DEVCLASS | 更改设备类的属性。 |
| UPDATE VOLUME | 更新存储池卷的属性。 |
| VARY | 指定服务器是否可使用磁盘卷。 |