QUERY FILESPACE(查询一个或多个文件空间)

使用此命令显示客户节点上的一个或多个文件空间的信息。 此命令的输出包含上次增量备份或复制的结果。

提示: 如果节点拥有超过一个的文件空间,那么可以为其中一个文件空间发出 DELETE FILESPACE 命令。 但是,在删除过程中对该节点发出 QUERY FILESPACE 命令,那么输出不显示任何文件空间。 要获取关于剩余文件空间的正确信息,请在删除过程结束后发出 QUERY FILESPACE 命令。

特权级别

任何管理员都可以发出此命令。

语法

阅读语法图跳过直观语法图
                    .-*--*---------------------------.   
>>-Query FIlespace--+--------------------------------+---------->
                    |            .-*---------------. |   
                    '-node_name--+-----------------+-'   
                                 '-file_space_name-'     

   .-Format--=--Standard-----.  .-NAMEType--=--SERVER------.   
>--+-------------------------+--+--------------------------+---->
   '-Format--=--+-Standard-+-'  '-NAMEType--=--+-SERVER--+-'   
                '-Detailed-'                   +-UNIcode-+     
                                               '-FSID----'     

   .-CODEType--=--BOTH-----------.   
>--+-----------------------------+-----------------------------><
   '-CODEType--=--+-UNIcode----+-'   
                  +-NONUNIcode-+     
                  '-BOTH-------'     

参数

node_name
指定文件空间所属的客户机节点。 可以使用通配符指定这个名称。 此参数是可选的。 缺省值是所有客户机节点名。

如果指定文件名,那么必须为此参数指定值。

file_space_name
指定要查询的文件空间的名称。 可以使用通配符指定这个名称。 此参数是可选的。 如果不指定值,将查询所有文件空间。

如果服务器包含使用支持 Unicode 文件空间的客户机,那么服务器可能需要转换输入的名称。 例如,服务器可能需要将输入的文件空间名称从服务器的代码页转换为 Unicode。 有关更多信息,请参阅 NAMETYPE 参数。 如果未指定文件空间名称,或者仅指定一个通配符来代表名称,那么可以使用 CODETYPE 参数将操作限制在 Unicode 文件空间或非 Unicode 文件空间范围内。

文件空间名称是区分大小写的。 可以使用 QUERY FILESPACE 命令来确定要查询的文件空间的正确大小写。

格式
指定如何显示信息。 此参数是可选的。 缺省值为 STANDARD。 可指定下列某个值:
Standard
指定显示指定文件空间的部分信息。
Detailed
指定显示指定文件空间的详细信息。
NAMEType
指定想要服务器如何来解释所输入的文件空间名称。 此参数在服务器具有支持 Unicode 的客户机时有用。 对于支持 Unicode 并具有 Windows、Macintosh OS X 和 NetWare 操作系统的 Tivoli® Storage Manager 客户机,可以使用此参数。

仅在输入了部分限定文件空间名称或完全限定文件空间名称的情况下使用此参数。 缺省值是 SERVER。 可指定下列某个值:

SERVER
服务器使用服务器代码页来解释文件空间名称。
UNIcode
服务器会将输入的文件空间名称从服务器代码页转换为 UTF-8 代码页。 转换是否成功依赖于名称的字符和服务器代码页。 如果字符串中包含服务器代码页中不可用的字符,或者服务器访问系统转换例程时出现问题,转换都可能会失败。
FSID
服务器将文件空间名称解释为其文件空间标识 (FSID)。
CODEType
指定包含在此操作中的文件空间类型。 缺省值为 BOTH,即不考虑代码页类型仍包含文件空间。 仅当为文件空间名称输入一个单一的通配符字符时,才使用此参数。 可指定下列某个值:
UNIcode
仅包含 Unicode 类型的文件空间。
NONUNIcode
仅包含非 Unicode 类型的文件空间。
BOTH
包含文件空间而不考虑代码页类型。

示例:列出所有文件空间

查询与所有客户机节点关联的所有文件空间。
query filespace
Node   Filespace   FSID  Platform  Filespace    Is     Capacity Pct
Name   Name                        Type      Filespace     (MB) Util
                                             Unicode?               
------ ----------- ----  -------  --------- --------- --------- ----
JOE    \\joe\c$       1  WinNT     NTFS        Yes     2,502.3  75.2
JOE       \\joe\d$      2  WinNT    NTFS        Yes     6,173.4  59.6
有关字段描述,请参阅字段描述

示例:显示虚拟文件空间的详细文件空间信息

显示文件路径 /HomeDir 的详细信息,它是一个虚拟文件空间映射并且属于 NAS 节点 NAS1。
query filespace nas1 /HomeDir
Node   Filespace   FSID  Platform  Filespace     Is     Capacity Pct 
Name   Name                        Type      Filespace     (MB)  Util
                                              Unicode?               
------ ----------- ----  -------  ---------  --------- --------- ----
NAS1   /HomeDir     1    NetApp   WAFL (VFS)     No     2,502.3  75.2
有关字段描述,请参阅字段描述
要点: 可能在请求详细格式后看不到期望的结果,因为一些字段必须由 API 应用程序完成。 这些字段包括:
  • 文件空间类型
  • 平台
  • 容量(MB)
  • 利用率
  • 上次备份开始日期/时间
  • 上次备份完成日期/时间
关于由 API 更新的特定字段的更多信息,请参阅《IBM® Tivoli Storage Manager: Using the Application Programming Interface》。

示例:显示特定文件空间和节点的详细文件空间信息

显示有关属于客户机节点 JOE 的 \\joe\c$ 文件空间的详细信息。
query filespace joe \\joe\c$ nametype=unicode format=detailed
                                            Node Name: JOE
                                       Filespace Name: \\joe\c$
                           Hexadecimal Filespace Name: 5c5c6a6f655c6324
                                                 FSID: 1
                               Collocation Group Name: FSGRP1
                                             Platform: WinNT
                                       Filespace Type: NTFS
                                Is Filespace Unicode?: Yes
                                        Capacity (MB): 2,502.3
                                             Pct Util: 75.2
                          Last Backup Start Date/Time:
                       Days Since Last Backup Started:
                     Last Backup Completion Date/Time:
                     Days Since Last Backup Completed:
                     Last Replication Start Date/Time: 12/02/2012, 12:42:00
             Days Since Last Node Replication Started: 30
                       Last Replication End Date/Time: 12/02/2012, 12:42:00
                    Days Since Last Replication Ended: 30
              Last Backup Date/Time From Client (UTC): 06/02/2013, 09:10:00
             Last Archive Date/Time From Client (UTC): 06/02/2013, 09:10:00
                              Backup Replication Rule: ACTIVE_DATA
                   Backup Data-Type Replication State: ENABLED
                             Archive Replication Rule: DEFAULT
                  Archive Data-Type Replication State: ENABLED
                       Space-Managed Replication Rule: NONE
            Space-Managed Data-Type Replication State: DISABLED
                                         At-risk type: Custom interval
                                     At-risk interval: 2,222
                                       Decommissioned: No
                                  Decommissioned Date: 
                                          MAC Address:
有关字段描述,请参阅字段描述

字段描述

要点: 您请求详细格式后可能看不到预期的结果,因为一些字段必须由 API 应用程序完成。 这些字段包括:
  • 文件空间类型
  • 平台
  • 容量(MB)
  • 利用率
  • 上次备份开始日期/时间
  • 上次备份完成日期/时间
关于由 API 更新的特定字段的更多信息,请参阅《IBM Tivoli Storage Manager: Using the Application Programming Interface》。
节点名
指定客户机节点的名称。
文件空间名称

属于此节点的文件空间的名称。

文件空间名称可以使用与服务器不同的代码页或语言环境。 如果是这样,那么 Operations Center 中的名称和管理命令行界面中的名称可能无法正确显示。 数据已备份并可手动进行恢复,但文件空间名称或文件名称可能显示为无效字符或空格的组合。

如果文件空间名称启用了 Unicode,那么 Tivoli Storage Manager 将把名称转换为服务器代码页以便显示。 转换是否成功取决于操作系统、名称中的字符以及服务器代码页。 如果字符串中包含服务器代码页中不可用的字符,或者服务器无法访问系统转换例程,那么转换可能不完整。 如果转换不完整,那么名称可能包含问号、空格、不可打印的字符或省略号 (...).

十六进制文件空间名称
以 UTF-8 格式指定客户机节点的文件空间的十六进制名称。
FSID
指定文件空间的文件空间标识。
并置组名
文件空间所属的并置组(如果存在)的名称。
平台
指定客户机节点的平台。
文件空间类型
指定文件空间的类型。

追加了“(VFS)”的文件空间类型,表示此文件空间名称是 NAS 设备上的目录路径的虚拟文件空间映射。

文件空间是否为 Unicode?
表示文件空间是否为 Unicode。
容量(MB)
指定客户机节点上分配给此文件空间的空间量,以兆字节为单位。

如果文件空间是目录路径的虚拟文件空间映射,那么此字段表示目录路径所在的文件空间的容量。

利用率
指定占用的文件空间的百分比。

对于是目录路径的虚拟文件空间映射的文件空间,使用率是按上次完整备份时目录所占文件空间的容量本分比来计算的。

上次备份开始日期/时间
指定此文件空间上次增量备份的开始日期和时间。
上次备份开始至今的天数
指定从文件空间上次增量备份启动以来的天数。
上次备份完成日期/时间
指定此文件空间上次增量备份的完成日期和时间。
上次备份完成至今的天数
指定从文件空间上次增量备份完成以来的天数。
上次复制开始日期/时间
指定启动上次文件空间时间复制的日期和时间。
上次复制开始至今的天数
指定从上次文件空间数据复制开始以来的天数。
上次复制结束日期/时间
指定结束上次文件空间数据复制的日期和时间。
从上次复制结束至今的天数
指定从上次文件空间数据复制结束以来的天数。
上次客户机备份的日期/时间 (UTC)
此文件空间上次执行备份操作的日期和时间,以全球标准时间 (UTC) 表示。
上次客户机归档的日期/时间 (UTC)
此文件空间上次执行归档操作的日期和时间,以全球标准时间 (UTC) 表示。
备份复制规则
指定适用于文件空间中的备份数据的复制规则。 以下是可能的值:
ALL_DATA
复制活动和不活动的备份数据。 以正常优先级复制该数据。
ACTIVE_DATA
仅复制活动的备份数据。 以正常优先级复制该数据。
注意: 如果您指定 ACTIVE_DATA 并且以下一个或多个条件成立,将删除目标复制服务器上的不活动备份数据,并且不复制源复制服务器上的不活动备份数据。
  • 在源或目标复制服务器上安装的 Tivoli Storage Manager 版本低于 V7.1.1。
  • REPLICATE NODE 命令和 FORCERECONCILE=YES 参数一起使用。
  • 在配置复制、复原数据库或从低于 Tivoli Storage Manager V7.1.1 的版本升级源和目标复制服务器之后运行文件空间的初始复制。
如果上述条件不成立,将复制自上次复制之后的所有新文件和更改的文件(包括不活动的文件),并删除到期文件。
ALL_DATA_HIGH_PRIORITY
复制活动和不活动的备份数据。 以高优先级复制该数据。
ACTIVE_DATA_HIGH_PRIORITY

此规则与 ACTIVE_DATA 复制规则相同,不同之处在于使用高优先级复制数据。

DEFAULT
根据备份数据的客户机节点规则来复制备份数据。 如果备份数据的客户机节点规则为 DEFAULT,那么将根据备份数据的服务器规则来复制备份数据。
NONE
将不复制文件空间中的备份数据。
备份数据类型复制状态
指定启用还是禁用文件空间中的备份数据复制。 如果状态为 ENABLED,那么备份文件可用于复制。 如果状态为 DISABLED,那么备份文件不可用于复制。
归档复制规则
指定适用于文件空间中的归档数据的复制规则。 以下是可能的值:
ALL_DATA
复制归档数据。 以正常优先级复制该数据。
ALL_DATA_HIGH_PRIORITY
复制归档数据。 以高优先级复制该数据。
DEFAULT
根据归档数据的客户机规则来复制归档数据。 如果归档数据的客户机规则为 DEFAULT,那么将根据归档数据的服务器规则来复制归档数据。
NONE
将不复制文件空间中的归档数据。
归档数据类型复制状态
指定启用还是禁用文件空间中的归档数据复制。 如果状态为 ENABLED,那么归档文件可用于复制。 如果状态为 DISABLED,那么归档文件不可用于复制。
空间受管复制规则
指定适用于文件空间中的空间受管数据的复制规则。 以下是可能的值:
ALL_DATA
复制空间受管数据。 以正常优先级复制该数据。
ALL_DATA_HIGH_PRIORITY
复制空间受管数据。 以高优先级复制该数据。
DEFAULT
根据空间受管数据的客户机规则来复制空间受管数据。 如果空间受管数据的客户机规则为 DEFAULT,那么将根据空间受管数据的服务器规则来复制空间受管数据。
NONE
不复制文件空间中的空间受管数据。
空间受管数据类型复制状态
指定启用还是禁用文件空间中的空间受管数据的复制。 如果状态为 ENABLED,那么空间受管文件可用于复制。 如果状态为 DISABLED,那么空间受管文件不可用于复制。
有风险类型
指定有风险评估类型。 值可以是“Default”、“Bypassed”或“Custom”。 “Default”指示节点使用与通过 SET STATUSATRISKINTERVAL 命令为节点分类指定的相同时间间隔进行评估。 “Bypassed”指示节点不通过状态监视器评估有风险状态。 “Custom”指示节点使用通过 SET VMATRISKINTERVAL 命令指定的时间间隔进行评估,而不是通过 SET STATUSATRISKINTERVAL 命令指定的时间间隔。
有风险时间间隔
指定在状态监视器认为客户机有风险之前,客户机备份活动之间的时间长度(以小时计)。 此字段仅在有风险类型为“Custom”时适用。
已停用
指定文件空间所表示的虚拟机是否已停用。
停用日期
指定文件空间所表示的虚拟机停用的日期。
MAC 地址
指定针对 VMware 虚拟机备份的文件空间的介质访问控制 (MAC) 地址。 如果虚拟机具有多个 MAC 地址,那么这是值最小的地址。

相关命令

表 1. 与 QUERY FILESPACE 相关的命令
命令 描述
DEFINE VIRTUALFSMAPPING 定义虚拟文件空间映射。
DELETE FILESPACE 删除与客户机文件空间相关联的数据。 如果文件空间是并置组的组成部分,那么从节点中除去该文件空间时还将从此并置组中除去该文件空间。
REGISTER NODE 向服务器定义客户机节点并为该用户设置选项。
REMOVE NODE 从特定策略域的已注册节点列表中除去客户机。
RENAME FILESPACE 重命名服务器上的客户机文件空间。
UPDATE FILESPACE 更改文件空间节点复制规则。
UPDATE NODE 更改与客户机节点相关联的属性。