QUERY RETSET（查询保留集）

在线编辑

使用此命令可显示一个或多个保留集及其属性的信息。您可指定单个保留集标识，或者输入一个或多个保留集属性以过滤保留集。

特权类

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

语法

参数

retset_id

指定要查询的保留集的标识。保留集标识是唯一的数字值。此参数是可选的。如果指定了保留集标识，那么在查询处理期间仅考虑该保留集，您不需要指定任何其他参数。如果未指定保留集标识，那么查询所有保留集。

NOdename

指定节点或节点组。使用此参数将保留集的显示限制为与单个节点或节点组相匹配的保留集，或者限制为与使用通配符（例如，星号）指定的节点模式相匹配的节点。此参数是可选的。

FIlespace

在要查询的虚拟机上指定一个或多个文件空间的名称。此参数是可选的。如果未指定 NAMETYPE 和 CODETYPE 参数，那么文件空间名称可以包含通配符。要指定名称中包含逗号的文件空间，您必须指定文件空间数字标识，然后指定 NAMETYPE=FSID。例如，如果文件空间名称为 2，请指定 filespace=2 nametype=fsid。

提示: 发出 QUERY FILESPACE 命令以确定为服务器上的节点定义了哪些文件空间和文件空间标识。

NAMEType

指定希望服务器如何解释所输入的文件空间名称。此参数在服务器具有支持 Unicode 的客户机时有用。可以将此参数用于具有 Windows ， Macintosh OS X 和 NetWare 操作系统的支持 Unicode 的 IBM Storage Protect 客户机。此参数是可选的。

缺省值是 SERVER。如果指定了虚拟文件空间映射名称，则必须使用 SERVER。您可指定下列其中一个值：

SERVER: 服务器使用服务器的代码页来解释文件空间名称。
UNIcode: 服务器会将输入的文件空间名称从服务器代码页转换为 UTF-8 代码页。转换是否成功取决于名称中的字符以及服务器代码页。如果字符串中包含服务器代码页中不可用的字符，或者服务器无法访问系统转换例程，那么转换可能会失败。
FSID: 服务器将文件空间名称解释为文件空间标识 (FSID)。

CODEType

指定要包含在节点处理中的文件空间的类型。缺省值是 BOTH，即不考虑代码页类型仍包含文件空间。仅当为文件空间名称输入一个单一的通配符字符时，才使用此参数。此参数是可选的。您可指定下列其中一个值：

UNIcode: 仅指定 Unicode 类型的文件空间。
NONUNIcode: 仅指定非 Unicode 类型的文件空间。
BOTH: 指定所有文件空间而不考虑代码页类型。

RETRulename

指定触发创建保留集的保留规则的名称。此参数是可选的。使用 RETRULENAME 参数将保留集的显示限制为由此保留规则创建的保留集。如果您已将保留规则重命名，那么使用先前名称创建的所有保留集也将匹配。如果未指定此参数，那么查询输出可包含所有保留规则。

State

指定要查询的保留集的状态。使用 STATE 参数将保留集的显示限制为处于特定状态的保留集。此参数是可选的。缺省值是 ANY。您可指定下列其中一个值：

ANy: 指定查询所有状态下的保留集。
ACtive: 指定查询处于 ACTIVE 状态的保留集。创建保留集后，它自动处于 ACTIVE 状态。
Deleted: 指定查询处于 DELETED 状态的保留集。处于 DELETED 状态的保留集不包含任何文件，因为所有文件都已删除。
为了提供可用于跟踪删除的审计跟踪，将会根据活动日志保留设置，保留每个已删除的保留集的记录（及其完整的活动日志）。
Expired: 指定查询处于 EXPIRED 状态的保留集。在到期处理运行并确定保留集的到期日期已过后，保留集到期。
为了提供可用于跟踪到期的审计跟踪，将会根据活动日志保留设置，保留每个已到期的保留集的记录（及其完整的活动日志）。
COPIed: 指定查询处于 COPIED 状态的保留集。保留集在成功复制到磁带存储器之后，就会处于 COPIED 状态。
为提供审计跟踪，将会根据活动日志保留设置，保留每个已复制到磁带的保留集的记录及其完整活动日志。
Incomplete: 指定查询处于 INCOMPLETE 状态的保留集。在将保留集复制到磁带的操作终止之后，该保留集不完整。磁带设备上的保留集不完整，因为未成功复制所有相关文件，因此未包含在该保留集中。
为提供审计跟踪，将会根据活动日志保留设置，保留每个不完整保留集的记录及其完整活动日志。
COPYing: 指定查询处于 COPYING 状态的保留集。在将保留集复制到磁带存储器的操作执行期间，该保留集处于 COPYING 状态。
提示: 保留集将保持处于 "正在复制" 状态，直到状态更改为 "已复制" 状态或 "未完成" 状态为止。
要提供审计跟踪，将根据活动日志保留设置来保留要（连同其完整活动日志一起）复制到磁带的每个保留集的记录。

PITBEGINDate

指定一组时间点日期中的开始日期。将显示时间点日期属于指定范围的所有保留集。缺省值为第一个保留集创建作业启动的最早日期。此参数是可选的。可将此参数与 PITBEGINTIME 参数一起使用，以指定一个日期和时间范围。如果您指定了开始日期，而未指定开始时间，那么时间设置为所指定日期的午夜 12 点。

可以使用以下某个值来指定日期：

值	描述	示例
月/日/年	特定日期	05/15/2018
TODAY	当前日期	TODAY
TODAY +天或 +天	当前日期加上指定的天数。	TODAY+3 或 +3
TODAY-天或 -天	当前日期减去指定的天数。	TODAy-3 或 -3
EOLM（上个月末）	上个月的最后一天。	EOLM
EOLM-天	上个月的最后一天减去指定的天数。	EOLM-1 包括在上个月最后一天的前一天处于活动状态的文件。
BOTM（本月开头）	本月的第一天。	BOTM
BOTM +天	本月的第一天加上指定的天数。	BOTM+9 包括在本月的第 10 天处于活动状态的文件。

PITBEGINTime

指定时间点范围中的开始时间。将显示时间点时间属于指定范围的所有保留集。缺省值为 00:00:00。此参数是可选的。可将此参数与 PITBEGINDATE 参数一起使用，以指定一个日期和时间范围。如果您指定了开始时间，而未指定开始日期，那么日期将设置为您运行该命令的日期。

可以使用以下某个值来指定时间：

值	描述	示例
HH:MM:SS	特定时间	10:30:08
NOW	当前时间	NOW
NOW+HH:MM 或 +HH:MM	当前时间加上指定的小时数和分钟数。	NOW+02:00 或 +02:00
NOW-HH:MM 或 -HH:MM	当前时间减去指定的小时数和分钟数。	NOW-02:00 或 –02:00

PITENDDate

指定时间点范围中的结束日期。将显示时间点结束日期直至此日期为止（包含此日期）的所有保留集。此参数是可选的。可将此参数与 PITENDTIME 参数一起使用，以指定结束日期和时间。如果您指定了结束日期，而未指定结束时间，那么时间将设置为所指定结束日期的晚上 11:59:59。

可以使用以下某个值来指定日期：

值	描述	示例
月/日/年	特定日期。	05/15/2018
TODAY	当前日期。	TODAY
TODAY +天或 +天	当前日期加上指定的天数。可以指定的最大天数是 9999。	TODAY+3 或 +3
TODAY-天或 -天	当前日期减去指定的天数。	TODAY-3 或 -3
EOLM（上个月末）	上个月的最后一天。	EOLM
EOLM-天	上个月的最后一天减去指定的天数。	EOLM-1 包括在上个月最后一天的前一天处于活动状态的文件。
BOTM（本月开头）	本月的第一天。	BOTM
BOTM +天	本月的第一天加上指定的天数。	BOTM+9 包括在本月的第 10 天处于活动状态的文件。

PITENDTime

指定时间点范围中的结束时间。将显示时间点结束时间直至此时间为止（包含此时间）的所有保留集。此参数是可选的。可将此参数与 PITENDDATE 参数一起使用，以指定一个日期和时间范围。缺省值为当前时间。

可以使用以下某个值来指定时间：

值	描述	示例
HH:MM:SS	特定时间	10:30:08
NOW	当前时间	NOW
NOW+HH:MM 或 +HH:MM	当前时间加上指定的小时数和分钟数。	NOW+02:00 或 +02:00
NOW-HH:MM 或 -HH:MM	当前时间减去指定的小时数和分钟数。	NOW-02:00 或 –02:00

EXPBEGINDate

指定一组到期日期中的开始日期。将显示到期日期属于此范围的所有保留集。此参数是可选的。可将此参数与 EXPBEGINTIME 参数一起使用，以指定一个日期和时间范围。如果您指定了开始日期，而未指定开始时间，那么时间将设置为您所指定日期的午夜 12:00 点。缺省值为第一个保留集创建作业到期的最早日期。

可以使用以下某个值来指定日期：

值	描述	示例
月/日/年	特定日期	05/15/2018
TODAY	当前日期	TODAY
TODAY +天或 +天	当前日期加上指定的天数。	TODAY+3 或 +3
TODAY-天或 -天	当前日期减去指定的天数。	TODAY-3 或 -3
EOLM（上个月末）	上个月的最后一天。	EOLM
EOLM-天	上个月的最后一天减去指定的天数。	EOLM-1 包括在上个月最后一天的前一天处于活动状态的文件。
BOTM（本月开头）	本月的第一天。	BOTM
BOTM +天	本月的第一天加上指定的天数。	BOTM+9 包括在本月的第 10 天处于活动状态的文件。

EXPBEGINTime

指定一组到期时间中的开始时间。将显示到期时间属于此范围的所有保留集。可将此参数与 EXPBEGINDATE 参数一起使用，以指定一个日期和时间范围。如果您指定了开始时间，而未指定开始日期，那么日期将设置为您所指定时间的当前日期。此参数是可选的。缺省值为 00:00:00。

可以使用以下某个值来指定时间：

值	描述	示例
HH:MM:SS	特定时间	10:30:08
NOW	当前时间	NOW
NOW+HH:MM 或 +HH:MM	当前时间加上指定的小时数和分钟数。	NOW+02:00 或 +02:00
NOW-HH:MM 或 -HH:MM	当前时间减去指定的小时数和分钟数。	NOW-02:00 或 –02:00

EXPENDDate

指定一组到期日期中的结束日期。将显示到期结束日期直至此日期为止（包含此日期）的所有保留集。此参数是可选的。可将此参数与 EXPENDTIME 参数一起使用，以指定结束日期和时间。如果您指定了结束日期，而未指定结束时间，那么时间将设置为所指定结束日期的晚上 11:59:59。

可以使用下列其中一个值来指定日期：

值	描述	示例
月/日/年	特定日期。	05/15/2018
TODAY	当前日期。	TODAY
TODAY +天或 +天	当前日期加上指定的天数。可以指定的最大天数是 9999。	TODAY+3 或 +3
TODAY-天或 -天	当前日期减去指定的天数。	TODAY-3 或 -3
EOLM（上个月末）	上个月的最后一天。	EOLM
EOLM-天	上个月的最后一天减去指定的天数。	EOLM-1 包括在上个月最后一天的前一天处于活动状态的文件。
BOTM（本月开头）	本月的第一天。	BOTM
BOTM +天	本月的第一天加上指定的天数。	BOTM+9 包括在本月的第 10 天处于活动状态的文件。

EXPENDTime

指定一组到期时间中的结束时间。将显示到期结束时间直至此时间为止（包含此时间）的所有保留集。此参数是可选的。可将此参数与 EXPENDDATE 参数一起使用来指定日期和时间。如果您指定了结束时间，而未指定结束日期，那么日期将设置为您所指定时间的当前日期。

可以使用以下某个值来指定时间：

值	描述	示例
HH:MM:SS	特定时间	10:30:08
NOW	当前时间	NOW
NOW+HH:MM 或 +HH:MM	当前时间加上指定的小时数和分钟数。	NOW+02:00 或 +02:00
NOW-HH:MM 或 -HH:MM	当前时间减去指定的小时数和分钟数。	NOW-02:00 或 –02:00

Held

指定在所要查询的保留集上是否已施加保留暂挂。此参数是可选的。缺省值是 ANY。以下是可能的值：

Yes: 指定仅显示当前已施加保留暂挂的保留集。
No: 指定仅显示未施加保留暂挂的保留集。
ANy: 指定显示所有保留集。

LISTVOLumes

指定是否显示此保留集所在的存储池卷的相关信息。此参数是可选的。缺省值为 No。以下是可能的值：

Yes: 指定显示此保留集所在的存储池卷的名称。
No: 指定不显示此保留集所在的存储池卷的相关信息。

示例：显示有关保留集的详细信息

显示保留集 36 的详细信息。请参阅字段描述以获取字段描述。

query retset 36

 
              Retention Set ID: 36
           Retention Rule Name: WEEKLY
            Point-In-Time Date: 05/07/2018 08:44:48
              Retention Period: 3
               Expiration Date: 10/28/2023 08:44:48
           Retention Set State: Active
         Total File Sizes (MB): 0
Last Update by (administrator):
         Last Update Date/Time:
                         Holds: court_docket_987204
                   Description:
         Retention Destination: RETPOOL
                        Stack: Yes
       Maximum Copy Processes: Storage Rule
        Retention Set Contents: FILEMAN:\\lambo\k$ TAPEMAN:\\lambo\k$

示例：显示从特定时间点创建的所有保留集

显示在特定时间点启动的保留集创建作业已创建的所有保留集的详细信息。请参阅字段描述以获取字段描述。

query retset pitbegindate=05/12/2018 pitbegintime=18:00


              Retention Set ID: 42
           Retention Rule Name: MONTHLY2
            Point-In-Time Date: 05/13/2018 22:18:46
              Retention Period: 3
               Expiration Date: 05/13/2019 22:18:46 
           Retention Set State: Active
         Total File Sizes (MB): 0
Last Update by (administrator):
         Last Update Date/Time:
                         Holds:
                   Description:
        Retention Destination: RETPOOL
                       Stack: Yes
      Maximum Copy Processes: Storage Rule
        Retention Set Contents: FILEMAN:\\lambo\k$ TAPEMAN:\\lambo\k$

              Retention Set ID: 46
           Retention Rule Name: WEEKLY
            Point-In-Time Date: 05/14/2018 08:44:50
              Retention Period: 7
               Expiration Date: 11/04/2023 08:44:50
           Retention Set State: Active
         Total File Sizes (MB): 0
Last Update by (administrator):
         Last Update Date/Time:
                         Holds:
                   Description:
         Retention Destination: RETPOOL
                        Stack: Yes
       Maximum Copy Processes: Storage Rule
        Retention Set Contents: FILEMAN:\\lambo\k$ TAPEMAN:\\lambo\k$

              Retention Set ID: 97
           Retention Rule Name: NODGRP
            Point-In-Time Date: 05/28/2018 06:10:01
              Retention Period: 6  
               Expiration Date: 05/29/2018 06:10:01 
           Retention Set State: Expired
         Total File Sizes (MB): 32964
Last Update by (administrator): FRED
         Last Update Date/Time: 05/29/2018 21:00:25
                         Holds:
                   Description: 3 nodes in nodegroup
        Retention Destination:
                       Stack: Yes
      Maximum Copy Processes: Storage Rule
 Retention Set Contents: LAMBO:\\lambo\k$ LAMBO:\\lambo\c$(*) LAMBO:\\lambo\e$ 
                                LAMBO:\\lambo\f$ LAMBO:\\lambo\g$ LAMBO:\\lambo\h$ 
                                LAMBO:\\lambo\i$ LAMBODDENCR:\\lambo\j$ 
                                LAMBODDENCR:\\lambo\k$(*)

示例：显示保留集所在的卷

显示保留集的相关详细信息，包括其所在卷的详细信息。请参阅字段描述以获取字段描述。

query retset nodename=weekly listvol=yes

 
              Retention Set ID: 4
           Retention Rule Name: WEEKLY
            Point-In-Time Date: 07/23/2019 08:52:48
              Retention Period: 3
               Expiration Date: 12/28/2023 08:52:48
           Retention Set State: Copied
         Total File Sizes (MB): 0 
               Number of Files: 11
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 07/23/2019 08:57:48
                         Holds: 
                   Description:
         Retention Destination: RETPOOL2
                         Stack: Yes
        Maximum Copy Processes: Storage Rule
          Storage Pool Volumes: D:\STGP\0000000A.BFS D:\STGP\0000000C.BFS
        Retention Set Contents: FILEMAN:\\lambo\k$ TAPEMAN:\\lambo\k$

示例：显示保留集所在的卷

显示保留集的相关详细信息，包括其所在卷的详细信息。请参阅字段描述以获取字段描述。

query retset nodename=weekly listvol=yes

 
              Retention Set ID: 431
           Retention Rule Name: WEEKLY
            Point-In-Time Date: 07/23/2019 08:52:48
              Retention Period: 3
               Expiration Date: 12/28/2023 08:52:48
           Retention Set State: Copying
         Total File Sizes (MB): 56 
               Number of Files: 34
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 07/23/2019 08:57:48
                         Holds: 
                   Description:
         Retention Destination: RETPOOL2
                         Stack: No
        Maximum Copy Processes: 1
          Storage Pool Volumes: C:\JUNK\STORAGE\D81A\00000018.BFS C:\JUNK\STORAGE\D81A\00000019.BFS 
                                C:\JUNK\STORAGE\D81A\0000001A.BFS C:\JUNK\STORAGE\D81A\0000001B.BFS 
         Retention Set Contents: FILEMAN:\\lambo\k$ TAPEMAN:\\lambo\k$

示例：显示有关已删除的保留集的详细信息

显示有关保留集 82（已删除）的详细信息。保留集中包含的客户机节点和文件空间都将被删除，并以指示符 "(*)" 表示。请参阅字段描述以获取字段描述。

query retset 82

 
              Retention Set ID: 82
           Retention Rule Name: WEEKLY
            Point-In-Time Date: 05/07/2020 12:44:32
              Retention Period: 3
               Expiration Date: 10/07/2020 14:01:48
           Retention Set State: Deleted
         Total File Sizes (MB): 16091
Last Update by (administrator): 
         Last Update Date/Time: 10/07/2020 14:01:48
                         Holds: 
                   Description:
         Retention Destination: RETPOOL1
                         Stack: Yes
        Maximum Copy Processes: Automatic
        Retention Set Contents: FILEMAN:\\lambo\k$(*) TAPEMAN:\\lambo\k$(*) TAPE2MAN:\\lambo\k$(*)

字段描述

保留集标识: 与保留集关联的编号。
保留规则名称: 创建保留集的保留规则的名称。
时间点日期: 客户机数据的时间点快照的日期和时间。
保留期: 由保留规则创建的任何保留集被服务器保留的时间长度（以天数计）。如果不指定保留期，那么显示值 No Limit。
到期时间: 保留集的到期日期和时间。
保留集状态: 保留集的当前状态。
文件总大小: 保留集中包含的文件的大小。; 对于未使用重复数据删除功能的存储池（如磁盘和FILEPOOL），该字段显示保留集内文件的实际总大小。对于使用重复数据删除功能的存储池（如目录容器和云存储），该字段始终显示为0。
文件数: 保留集中包含的文件数。
提示: 如果要使用复制的数据创建保留集，那么直到复制操作成功完成后，才会更新该保留集中包含的文件数。但是，即使复制操作未完成，保留集中复制的任何数据都将由保留集保留并阻止删除。
上次更新者（管理员）: 定义或最近一次更新保留规则的管理员的名称。
上次更新日期/时间: 管理员定义或最近一次更新保留规则的日期和时间。
保留: 与该保留集相关联的保留暂挂列表。
描述: 保留集描述。
目标: 由保留规则指定的保留存储池，所保留数据的副本就存储在此保留存储池中。保留存储池必须是磁带设备。
堆栈: 指示保留集是否由配置为允许将保留集复制到共享磁带卷的存储规则创建，而共享磁带卷中包含来自一个或多个其他保留集的数据。
限制: 仅当将保留数据复制到磁带卷时， STACK 参数才适用。当您将保留数据复制到云存储器时，将忽略该参数。
最大复制进程数: 可以并行运行的最大“复制到磁带”进程数。
存储池卷: 存储池卷的名称。
保留集内容: 保留集中包含的客户机。如果使用了通配符来指定节点和/或文件空间，那么此值反映与这些指定匹配的客户机。
提示: 从保留集中删除的任何客户机节点或文件空间都由指示符 "(*)" 表示。例如， FILEMAN: \\lambo\k$ (*)。如果删除整个保留集，那么将针对保留集中包含的所有客户机节点和文件空间显示 "(*)" 指示符。

命令	描述
删除重置	删除保留时间集合。
更新 RETSET	更改保留时间集合的属性。
查询重置内容	显示有关保留时间集合内容的信息。

QUERY RETSET（查询保留集）

特权类

语法

参数

示例：显示有关保留集的详细信息

示例：显示从特定时间点创建的所有保留集

示例：显示保留集所在的卷

示例：显示保留集所在的卷

示例：显示有关已删除的保留集的详细信息

字段描述

相关命令