QUERY VOLUME（查询存储池卷）
使用此命令显示关于一个或多个存储池卷的信息。
特权类
任何管理员都可以发出此命令。
语法
参数
- 卷名称
- 指定要查询的卷。 此参数是可选的。 可以使用通配符来指定名称。 如果未指定名称，那么所有存储池卷都包含在此查询中。
- 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
- 指定显示完整的信息。
- LISTRetsets
- 指定将显示在指定保留存储池卷上有数据的所有保留集。 此参数是可选的。 缺省值为 NO。 以下是可能的值：
- Yes
- 指定将显示在指定存储池卷上存储了数据的所有保留集。
- No
- 指定不会显示在指定存储池卷上有数据的保留集。
示例：列出所有文件存储池卷
显示设备类名称为 FILE 的所有存储池卷的信息。 请参阅 字段描述 以获取字段描述。query volume devclass=file
Volume 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 名称为前缀的所有存储池卷的信息。 请参阅 字段描述 以获取字段描述。
ANR2017I Administrator SERVER_CONSOLE issued command: QUERY VOLUMEVolume Name Storage Device Estimated Pct Volume
Pool Name Class Name Capacity Util Status
---------------------- ----------- ---------- --------- ----- -------
/data/diskpool/dp1.dsm MYDISKSTG DISK 50.0 G 28.0 On-Line
000201L9 DISKL9RETPOOL L9RWDC 17.2 T 1.0 Filling
000202L9 L9RETPOOL L9RWDC 17.2 T 0.1 Filling
PU2053 JAG3592POOL JAGRWC 20.0 T 0.2 Filling示例：显示关于特定存储池卷的详细信息
显示有关名为 /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 Protected:
Drive Encryption Key Manager:
Encrypted:
Compressed:
Compressed Capacity:示例：显示关于特定存储池卷的详细信息
显示存储池卷 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
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 Protected:
Drive Encryption Key Manager:
Encrypted:
Compressed:
Compressed Capacity:示例：显示有关具有特定设备类的存储池卷的详细信息
显示存储池中有关某个设备类名称为 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. Reclaimable Space: 0.0
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 1
Write Pass Number: 1
Approx. Date Last Written: 03/22/2004 15:23:46
Approx. Date Last Read: 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 Protected:
Drive Encryption Key Manager:
Encrypted:
Compressed:
Compressed Capacity:示例：显示关于特定存储池卷的详细信息
显示有关名为 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. Reclaimable Space: 0.0
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 1
Write Pass Number: 1
Approx. Date Last Written: 03/22/2004 15:23:46
Approx. Date Last Read: 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 Protected: Yes
Drive Encryption Key Manager: IBM Storage Protect
Encrypted:
Compressed:
Compressed Capacity: 示例：显示保留集所在的卷
显示有关在指定保留存储池卷上有数据的保留集的信息。 请参阅 字段描述 以获取字段描述。 对于保留存储池卷 PT68LJL6，发出以下命令：query volume PT68LJL6 listretset=yes
Volume Name Storage Device Estimated Pct Volume Retention
Pool Name Class Name Capacity Util Status Set IDs
----------- -------- -------- -------- ------ ------------ ------------
PT68LJL6 RETPOOL VTLDEVC 30.0 G 100.0 Full 377 379 380
383 384
385 409 410
字段描述
- 卷名
- 存储池卷的名称。
- 存储池名称
- 定义卷的存储池名称。
- 设备类名称
- 分配给存储池的设备类。
- 估计容量
- 卷的估算容量，以兆字节 (M)、千兆字节 (G) 或太字节 (T) 为单位。
对于 DISK 设备，此值是卷的容量。
对于顺序存取设备，此值是基于设备类的卷的总可用空间估算值。
- 所测量的容量已应用
- 卷被调定到的容量百分比。 例如，对于最大容量为 300 GB 的卷，值 20 表示卷只能存储 300 GB 的 20%，即 60 GB。 此属性仅适用于 IBM® 3592 设备。
- 利用率百分比
- 卷的利用率的估计值。 利用率包含文件和聚集所占用的所有空间，包括聚集中的可用空间。
对于 DISK 卷，利用率还包含高速缓存数据占用的空间。
- 卷状态
- 卷的状态。
- Retention Set ID
- 在指定的保留存储池卷上存储了数据的保留集的列表。
- 访问权
- 卷是否对服务器可用。
- 百分比 Reclaimable Space (sequential access volumes only)
- 此卷上由于数据已过期或已被删除而可以回收的空间量。 该值与存储池的回收阈值相比较以确定是否需要回收。 可回收空间包括聚集中的可用空间。
确定存储池中要回收的卷时，服务器首先确定回收阈值。 回收阈值由 RECLAIM STGPOOL 命令上 THRESHOLD 参数的值指示，或者如果未指定该值，那么由存储池定义中 RECLAIM 参数的值指示。 之后，服务器将检查存储池中各卷的可回收空间百分比。 如果某个卷上的可回收空间百分比大于存储池的回收阈值，那么该卷将成为候选回收的卷。
例如，假定存储池 FILEPOOL 的回收阈值为 70%。 此值表示服务器可回收存储池中可回收空间百分比超过 70% 的任何卷。 存储池有三个卷：- FILEVOL1，可回收空间百分比为 65%
- FILEVOL2，可回收空间百分比为 80%
- FILEVOL3，可回收空间百分比为 95%
回收开始时，服务器将各卷的可回收空间百分比与回收阈值 70% 相比较。 在此示例中，FILEVOL2 和 FILEVOL3 是可进行回收的候选卷，因为它们的可回收空间百分比都超过了 70%。
对于属于 SnapLock 存储池的卷，显示但不使用该值。
- 临时卷？ （仅限顺序存取卷）
- 当卷为空时是否将该卷返回临时卷。
- 处于错误状态？
- 是否此卷处于错误状态。 错误状态下服务器不能向卷写入数据。
- 可写面数
- 此信息是为 IBM Storage Protect保留的。
- 已安装的次数
- 服务器打开卷以进行使用的次数。 服务器打开卷的次数不总是与将卷物理安装到磁带机中的次数相同。 物理安装卷后，服务器可以多次打开同一卷以进行不同操作，例如不同的客户机备份会话。
- Write Pass Number（仅限顺序存取卷）
- 从开始到结束写入卷的次数。
- 上次写入大致日期
- 上次写卷时的近似日期。
- 上次读取大致日期
- 上次读卷时的近似日期。
- 日期变为未确定
- 卷状态更改为暂挂的日期。
- 写入错误数
- 卷上已发生的写入错误数。
- 读取错误数
- 卷上已发生的读取错误数。
- 卷位置
- 卷的位置。
- 卷具有 MVS 不依赖 Lan 的能力
- 卷是否有不依赖 LAN 的能力。 不依赖 LAN 的卷是由 IBM Storage Protect z/OS® 数据管理器服务器定义并使用 (至少一次) 的卷。
- 上次更新者（管理员）
- 定义或最近一次更新此卷的管理员。
- 上次更新日期/时间
- 定义或最近一次更新此卷的时间。
- 开始回收周期
- 表示一个日期，在此日期后服务器开始回收此卷，但该日期不得晚于结束回收周期表示的日期。 回收周期开始时，如果卷上有未过期的文件，那么这些文件在回收处理期间将移到新的 WORM 卷上。 仅当此卷在 RECLAMATIONTYPE 参数值为 SNAPLOCK 的存储池中时，此字段才显示日期。
如果同一个卷上存储了多个归档，那么将根据最新归档的日期开始卷的回收周期。 对于 SnapLock 卷，DEFINE COPYGROUP 命令的 RETVer 参数确定存储归档的时间。 如果将 RETVer 设置为 100 天，那么卷的回收周期就是在卷上存储第一个归档后的 100 天。 如果在同一个卷上存储了第二个归档，那么在存储新归档后，会将回收开始日期调整为 100 天。 如果在存储了第一个归档后更改了 RETVer 值，那么将对卷上的所有归档应用最新的回收日期。 例如，对于初始归档，假设 RETVer 被设置为 100，但是随后更改为 50。 如果在存储了第一个归档后的三天在卷上存储了第二个归档，那么只有在存储了第一个归档后的 100 天后，回收周期才能开始。
- 结束回收周期
- 表示 IBM Storage Protect 必须在此卷上完成回收处理以确保继续保护数据的日期。 它也表示 NetApp 文件中的“上次访问日期”物理文件属性，该属性将防止在该日期之前删除文件。 仅当此卷在 RECLAMATIONTYPE 参数值为 SNAPLOCK 的存储池中时，此字段才显示日期。
- 驱动器加密密钥管理器
- 磁带机加密密钥管理器。 该字段仅适用于与 3592、LTO 或 ECARTRIDGE 设备类型关联的存储池中的卷。
- 逻辑块受保护
- 指定是否对卷启用了逻辑块保护。 只能对以下类型的磁带机和介质使用逻辑块保护：
- IBM LTO5 和更高版本
- 带有 3592 代 2 介质和更高版本的 IBM 3592 代 3 磁带机和更高版本
- Oracle StorageTek T10000C 和 T10000D 磁带机