DELETE VOLHISTORY（删除顺序卷历史信息）

使用此命令来删除不再需要的卷历史记录文件记录（例如，废弃的数据库后备卷的记录）。

删除不在存储池中的卷（例如数据库备份或导出卷）的记录时，即使 Tivoli® Storage Manager 将这些卷作为专用卷获取，这些卷还是会返回到临时状态。 删除设备类型 FILE 的临时卷。 当删除存储池卷的记录时，这些卷仍保留在 Tivoli Storage Manager 数据库中。 从源服务器删除恢复计划文件对象的记录时，目标服务器上的对象将标记为待删除。

使用 DELETE BACKUPSET 命令删除卷历史记录文件中指定的备份集卷信息。 不可使用 DELETE VOLHISTORY 命令删除卷历史记录文件中的备份集卷信息。

对于 DRM 用户，数据库备份迁移到期应以 SET DRMDBBACKUPEXPIREDAYS 命令控制，而不是此 DELETE VOLHISTORY 命令。 使用 DELETE VOLHISTORY 命令除去 Tivoli Storage Manager 的卷记录。 这可能导致丢失 MOVE DRMEDIA 命令管理的卷。 建议使用 SET DRMDBBACKUPEXPIREDAYS 命令管理 DRM 数据库备份卷的自动到期。

注释：
  1. 不删除最新数据库备份系列的卷。
  2. 该命令不自动更新现有卷历史记录文件。
  3. 可使用 DEFINE SCHEDULE 命令周期性地删除卷历史记录。

特权级别

要发出此命令，您必须拥有系统特权。

语法

阅读语法图跳过直观语法图
>>-DELete VOLHistory--TODate--=--date--------------------------->

   .-TOTime--=--23:59:59-.   
>--+---------------------+-------------------------------------->
   '-TOTime--=--time-----'   

>--Type--=--+-All---------------------------------------+------><
            +-DBBackup--+-------------------------+-----+   
            |           '-DEVclass--=--class_name-'     |   
            +-DBSnapshot--+-------------------------+---+   
            |             '-DEVclass--=--class_name-'   |   
            +-DBRpf-------------------------------------+   
            +-EXPort------------------------------------+   
            |         .-DELETELatest--=--No------.      |   
            +-RPFile--+--------------------------+------+   
            |         '-DELETELatest--=--+-No--+-'      |   
            |                            '-Yes-'        |   
            |              .-DELETELatest--=--No------. |   
            +-RPFSnapshot--+--------------------------+-+   
            |              '-DELETELatest--=--+-No--+-' |   
            |                                 '-Yes-'   |   
            +-STGNew------------------------------------+   
            +-STGReuse----------------------------------+   
            '-STGDelete---------------------------------'   

参数

TODate（必填）
指定用于选择被删除的顺序卷历史信息的日期。 Tivoli Storage Manager 只删除那些在您指定的日期或之前的日期的记录。 可以使用以下某个值来指定日期：
值 描述 示例
MM/DD/YYYY 具体日期 01/23/1999
TODAY 当前日期 TODAY
TODAY-days 或 -days 当前日期减去指定天数。 可以指定的最大天数是 9999。 TODAY–30 或 –30。

要删除 30 或超过 30 天的记录，可以指定 TODAY-30 或仅 -30。
EOLM（上个月末） 上个月的最后一天。 EOLM
EOLM-days 上个月的最后一天减去指定的天数。 EOLM-1

将包含在上个月最后一天的前一天处于活动状态的文件。
BOTM（本月开头） 本月的第一天。 BOTM
BOTM+days 本月的第一天加上指定的天数。 BOTM+9

将包含在本月的第 10 天处于活动状态的文件。
TOTime
指定将删除在指定日期的这个时间或之前所创建的记录。 此参数是可选参数。 缺省为当天结束 (23:59:59)。 可以使用以下某个值来指定时间：
值 描述 示例
HH:MM:SS 指定的日期的具体时间。 12:30:22
NOW 指定的日期的当前时间。 NOW
NOW+HH:MM 或 +HH:MM 指定日期的当前时间加上小时和分钟数 NOW+03:00 或 +03:00。

如果在 9:00 发出 DELETE VOLHISTORY 命令，并且指定 TOTIME=NOW+03:00 或 TOTIME=+03:00 ，那么 Tivoli Storage Manager 将删除指定日期 12:00 或 12:00 之前的记录。
NOW-HH:MM 或 -HH:MM 指定日期的当前时间减去小时和分钟数 NOW-03:30 或 -03:30。

如果在 9:00 发出 DELETE VOLHISTORY 命令，并且指定 TOTIME=NOW-3:30 或 TOTIME=-3:30 ，那么 Tivoli Storage Manager 将删除指定日期 5:30 或 5:30 之前的记录。
Type（必需）
指定同时还满足日期和时间标准的记录类型，以从卷历史记录文件中删除。 可能的值包括：
All
指定删除所有记录。
注： DELETE VOLHISTORY 命令不会删除远程卷的记录。
DBBackup
指定仅删除包含用于数据库完全备份和增量备份的卷（即卷类型为 BACKUPFULL 和 BACKUPINCR）的相关信息且满足指定日期和时间条件的记录。 将不会删除最新的数据库完全和增量备份系列。
DEVclass=class_name
指定用于创建数据库备份的设备类名称。 此可选参数可用于删除使用服务器到服务器的虚拟卷设备类创建的数据库备份。 设备类的类型必须为 SERVER。 此参数仅可用于删除 BACKUPFULL、BACKUPINCR 或 DBSNAPSHOT 类型的卷历史记录条目。
如果满足以下所有条件，那么可删除完全、增量或快照数据库备份卷：
  • 用于创建数据库备份卷的设备类与指定设备类一致
  • 卷的创建时间不迟于指定的日期和时间
  • 该卷不是最新完全数据库备份加上增量数据库备份系列的一部分（如果指定的卷类型为 DBBackup），或者不是快照数据库备份系列的一部分（如果指定的卷类型为 DBSnapshot）
DBSnapshot
指定仅删除包含用于快照数据库备份的卷的相关信息且满足指定日期和时间条件的记录。 将不会删除最新的快照数据库备份。
DEVclass=classname
指定用于创建数据库备份的设备类名称。 此可选参数可用于删除使用服务器到服务器的虚拟卷设备类创建的数据库备份。 设备类的类型必须为 SERVER。 此参数仅可用于删除 BACKUPFULL、BACKUPINCR 或 DBSNAPSHOT 类型的卷历史记录条目。
如果满足以下所有条件，那么可删除完全、增量或快照数据库备份卷：
  • 用于创建数据库备份卷的设备类与指定设备类一致
  • 卷的创建时间不迟于指定的日期和时间
  • 该卷不是最新完全数据库备份加上增量数据库备份系列的一部分（如果指定的卷类型为 DBBackup），或者不是快照数据库备份系列的一部分（如果指定的卷类型为 DBSnapshot）
DBRpf
指定仅删除某些日志，这些日志包含完全和增量数据库备份卷及恢复计划文件卷的信息。
EXPort
指定只删除包含导出卷的信息的记录。
RPFile
指定仅删除包含关于存储在目标服务器上的恢复计划文件对象的信息的记录，以及满足指定的日期和时间标准的记录。
DELETELatest
指定最近的恢复计划文件是否适合于删除。 此可选的参数可用于删除使用服务器到服务器的虚拟卷设备类创建的最近的恢复计划文件。

此参数仅可用于删除 RPFILE 类型的卷历史条目（例如，那些以 PREPARE 命令使用 DEVCLASS 参数创建的恢复计划文件）。 如果未指定此参数，那么不删除最近的 RPFILE 条目。

否
指定不删除最近的 RPFILE 文件。
Yes
指定如果最近的 RPFILE 文件满足指定的日期和时间条件，那么将其删除。
RPFSnapshot
指定仅删除包含所创建恢复计划文件对象（假定是快照数据库备份）的相关信息的记录、存储在目录服务器上的记录以及满足指定日期和时间条件的记录。 将不删除最近的 RPFSNAPSHOT 文件，除非它符合指定的日期和时间条件，且 DELETELatest 参数设置为 Yes。
DELETELatest
指定最近的恢复计划文件是否适合于删除。 此可选的参数可用于删除使用服务器到服务器的虚拟卷设备类创建的最近的恢复计划文件。

此参数仅可用于删除 RPFSNAPSHOT 类型的卷历史条目（例如，那些以 PREPARE 命令使用 DEVCLASS 参数创建的恢复计划文件）。 如果未指定此参数，那么不删除最近的 RPFSNAPSHOT 条目。

否
指定不删除最近的 RPFSNAPSHOT 文件。
Yes
指定如果最近的 RPFSNAPSHOT 文件满足指定的日期和时间条件，那么对其进行删除。
STGNew
指定只删除包含新的顺序存取存储器卷信息的记录。
STGReuse
指定只删除包含重复使用的顺序存取存储池卷信息的记录。
STGDelete
指定只删除包含已删除的顺序存取存储池卷信息的记录。

示例：删除恢复计划文件信息

删除在 2005 年 3 月 28 日或之前创建的所有恢复计划文件信息。 
delete volhistory type=rpfile todate=03/28/2005

相关命令

表 1. 与 DELETE VOLHISTORY 相关的命令
命令 描述
BACKUP VOLHISTORY 将卷历史记录信息记录在外部文件中。
DEFINE SCHEDULE 定义用于客户机操作或管理命令的调度。
DELETE VOLUME 从存储池中删除卷。
EXPIRE INVENTORY 手动启动库存到期处理。
MOVE DRMEDIA 在现场以及非现场移动 DRM 介质。
PREPARE 创建恢复计划文件。
QUERY RPFILE 显示有关恢复计划文件的信息。
QUERY VOLHISTORY 显示服务器收集的顺序卷历史记录信息。
SET DRMRPFEXPIREDAYS 设置恢复计划文件到期条件。
SET DRMDBBACKUPEXPIREDAYS 指定数据库备份系列到期的条件。