CHECKOUT LIBVOLUME（从库中检出一个存储卷）

使用此命令从自动库的服务器库存中除去顺序存取存储卷。此命令将创建后台进程，可使用 CANCEL PROCESS 命令取消此后台进程。要显示有关后台进程的信息，请使用 QUERY PROCESS 命令。

限制：

检出处理不会等待磁带机变为可用，即使磁带机处于空闲状态也是如此。如有必要，可使用 DISMOUNT VOLUME 命令卸载卷来使库磁带机可用。磁带机可用之后，可以重新发出 CHECKOUT LIBVOLUME 命令。
在从 349X 库检出卷之前，请确保“349x 磁带盒输入和输出”设备具有足够的空槽供给检出的卷。 “3494 库管理器”不会通知应用程序“磁带盒输入和输出”设备已满。在返回服务器之前，它接受退出磁带盒的请求并等待到“磁带盒输入和输出”设备为空。否则，Tivoli® Storage Manager可能表现为挂起。应检查库并清除一切干涉请求。
将卷检出 ACSLS 库之前，确保 ACSLS 中的 CAP 优先级大于零。如果 CAP 优先级为零，那么必须在 CHECKOUT LIBVOLUME 命令中为 CAP 参数指定一个值。

有关详细和当前磁带机和库支持信息，请参阅您操作系统的支持设备 Web 站点：

特权级别

要发出此命令，必须具有系统特权或无限制的存储特权。

SCSI 库的语法


>>-CHECKOut LIBVolume--library_name----+-volume_name-+---------->
                                       '-| A |-------'     

   .-REMove--=--Bulk-----.  .-CHECKLabel--=--Yes-----.   
>--+---------------------+--+------------------------+---------->
   '-REMove--=--+-Yes--+-'  '-CHECKLabel--=--+-Yes-+-'   
                +-No---+                     '-No--'     
                '-Bulk-'                                 

   .-FORCE--=--No------.   
>--+-------------------+---------------------------------------><
   '-FORCE--=--+-No--+-'   
               '-Yes-'     

A 

|--+-VOLRange--=----volume_name1,volume_name2---+---------------|
   |               .-,-----------.              |   
   |               V             |              |   
   '-VOLList--=--+---volume_name-+--+-----------'   
                 '-FILE:--file_name-'

349X 库的语法


>>-CHECKOut LIBVolume--library_name----+-volume_name-+---------->
                                       '-| A |-------'     

   .-REMove--=--Bulk-----.   
>--+---------------------+-------------------------------------><
   '-REMove--=--+-Yes--+-'   
                +-No---+     
                '-Bulk-'     

A 

|--+-VOLRange--=----volume_name1,volume_name2---+---------------|
   |               .-,-----------.              |   
   |               V             |              |   
   '-VOLList--=--+---volume_name-+--+-----------'   
                 '-FILE:--file_name-'

ACSLS 库的语法


>>-CHECKOut LIBVolume--library_name----+-volume_name-+---------->
                                       '-| A |-------'     

   .-REMove--=--Yes------.                          
>--+---------------------+--+-------------------+--------------><
   '-REMove--=--+-Yes--+-'  '-CAP--=----x,y,z---'   
                +-No---+                            
                '-Bulk-'                            

A 

|--+-VOLRange--=----volume_name1,volume_name2---+---------------|
   |               .-,-----------.              |   
   |               V             |              |   
   '-VOLList--=--+---volume_name-+--+-----------'   
                 '-FILE:--file_name-'

参数

library_name（必需）

指定库名。

volume_name

指定卷名。

VOLRange

指定两个由逗号分隔的卷名。此参数是要检出的卷的范围。如果该库中没有指定范围的卷，那么此命令完成时没有错误。

只指定可按数字增加的卷名。除了增量区域外，卷名可包括字母数字前缀和字母数字后缀，例如：

参数	描述
`volrange=bar110,bar130`	检出 21 个卷：bar110、bar111、bar112、...bar129、bar130。
`volrange=bar11a,bar13a`	以下 3 卷已检出：bar11a, bar12a, bar13a。
`volrange=123400,123410`	已检出 11 个卷：123400、123401、...123409 和 123410。

VOLList

指定要检出的卷的列表。如果库中没有列表中的卷，那么此命令完成时没有错误。

可能的值包括：

volume_name

指定此命令所用的一个或多个值的名称。示例：VOLLIST=TAPE01,TAPE02。

FILE:file_name

为命令指定包含卷列表的文件的名称。在文件中，每个卷名必须位于不同的行。忽略空行和以星号开始的注释行。例如，要使用卷 TAPE01、TAPE02 和 TAPE03，可创建文件 TAPEVOL，该文件包含这些行：

TAPE01
TAPE02
TAPE03

可以如下为命令指定卷：VOLLIST=FILE:TAPEVOL。

注意：文件名区分大小写。

REMove

指定服务器尝试将卷移出库并移入便利 I/O 站或进/出端口。此参数是可选参数。其值可能为 YES、BULK 和 NO，视库的类型而定。下列各节描述了服务器对各选项的响应以及缺省值。

349X 库：缺省值是 BULK。下表显示服务器是如何对 349X 库作出响应的。

表 1. Tivoli Storage Manager 服务器如何响应 349X 库
REMOVE=YES	REMOVE=BULK	REMOVE=NO
3494 库管理器将磁带盒弹出到便利 I/O 站。	3494 库管理器将磁带盒弹出到高容量的输出设备。	3494 库管理器不弹出卷。服务器将磁带盒留在 INSERT 类别的库中，供其他应用程序使用。

SCSI 库：缺省值是 BULK。下表显示服务器如何响应 SCSI 库。

表 2. Tivoli Storage Manager 服务器如何响应 SCSI 库
如果库... . .	且 REMOVE=YES，那么...	且 REMOVE=BULK，那么...	且 REMOVE=NO，那么...
没有进入/退出端口	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器随后将提示您从插槽中取出磁带盒并发出 REPLY 命令。	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器不会提示您取出磁带盒，并且不需要 REPLY 命令。	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器不会提示您取出磁带盒，并且不需要 REPLY 命令。
有进入/退出端口，并且有一个进入/退出端口可用	服务器将磁带盒移到可用的进入/退出端口，并在消息中指定端口地址。服务器随后将提示您从插槽中取出磁带盒并发出 REPLY 命令。	服务器将磁带盒移到可用的进入/退出端口，并在消息中指定端口地址。服务器不会提示您取出磁带盒，并且不会请求 REPLY 命令。	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器不会提示您取出磁带盒，并且不需要 REPLY 命令。
有进入/退出端口，但没有端口可用	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器随后将提示您从插槽中取出磁带盒并发出 REPLY 命令。	服务器等待进入/退出端口变得可用。	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器不会提示您取出磁带盒，并且不需要 REPLY 命令。

ACSLS 库：缺省值为 YES。如果此参数设置为 YES，并且盒带存取端口 (CAP) 的自动选择优先级值为 0，那么您必须指定 CAP 标识。下表显示服务器如何响应 ACSLS 库。

表 3. Tivoli Storage Manager 服务器如何响应 ACSLS 库
REMOVE=YES 或 REMOVE=BULK	REMOVE=NO
服务器将磁带盒弹出到便利 I/O 站，并从服务器库清单中删除卷条目。	服务器不弹出磁带盒。服务器从服务器库清单中删除卷条目并将卷留在库中。

CHECKLabel

指定服务器如何读取或是否读取卷的顺序介质标签。

注意：此参数不适用于 IBM® 349X 或者 ACSLS 库。

此参数是可选参数。缺省值为 YES。可能的值为：

Yes: 指定服务器尝试通过读取介质标号可验证是否正在检出正确卷。
No: 指定在检出期间不读取介质标号。由于不进行读进程，这样做可以改善性能。

FORCE

指定如果在读取标签时发生输入/输出 (I/O) 错误，服务器是否检出卷。

注意：此参数不适用于 IBM 349X 或者 ACSLS 库。

此参数是可选参数。缺省值是 NO。可能的值包括：

No: 如果在读取标号时出现 I/O 错误，那么服务器将不检出存储卷。
Yes: 即使出现 I/O 错误，服务器也会检出存储卷。

CAP

指定在指定 REMOVE=YES 的情况下要使用哪个磁带盒访问端口 (CAP) 来弹出卷。此参数仅适用于 ACSLS 库中的卷。如果 CAP 优先级值在库中设置为 0，那么此参数为必需。如果在库中设置了大于 0 的 CAP 优先级值，那么此参数为可选。缺省情况下，所有 CAP 都初始具有优先级值 0，这意味着 ACSLS 不会自动选择 CAP。

要显示有效的 CAP 标识 (x,y,z)，可以从 ACSLS 服务器主机上的自动化磁带盒系统系统管理员 (ACSSA) 控制台发出 QUERY CAP 命令，并在命令中指定 ALL 选项。标识如下：

x: “自动化磁带盒系统”(ACS) 标识。此标识可以是范围 0 - 126 内的数字。
y: “库存储模块”(LSM) 标识。此标识可以是范围 0 - 23 内的数字。
z: CAP 标识。此标识可以是范围 0 - 11 内的数字。

有关更多信息，请参阅 StorageTek 文档。

示例：检出卷并检查标签

从名为 FOREST 的库中检出名为 EXB004 的卷。读取标号以验证卷名，但不要将卷移出库。

checkout libvolume forest exb004 checklabel=yes remove=no

如果库... . .	且 REMOVE=YES，那么...	且 REMOVE=BULK，那么...	且 REMOVE=NO，那么...
没有进入/退出端口	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器随后将提示您从插槽中取出磁带盒并发出 REPLY 命令。	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器不会提示您取出磁带盒，并且不需要 REPLY 命令。	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器不会提示您取出磁带盒，并且不需要 REPLY 命令。
有进入/退出端口，并且有一个进入/退出端口可用	服务器将磁带盒移到可用的进入/退出端口，并在消息中指定端口地址。服务器随后将提示您从插槽中取出磁带盒并发出 REPLY 命令。	服务器将磁带盒移到可用的进入/退出端口，并在消息中指定端口地址。服务器不会提示您取出磁带盒，并且不会请求 REPLY 命令。	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器不会提示您取出磁带盒，并且不需要 REPLY 命令。
有进入/退出端口，但没有端口可用	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器随后将提示您从插槽中取出磁带盒并发出 REPLY 命令。	服务器等待进入/退出端口变得可用。	服务器将磁带盒留在库内其当前插槽中并在消息中指定插槽地址。服务器不会提示您取出磁带盒，并且不需要 REPLY 命令。

命令	描述
AUDIT LIBRARY	确保自动库处于一致状态。
CANCEL PROCESS	取消后台服务器进程。
CHECKIN LIBVOLUME	将存储卷检入自动化库。
DEFINE LIBRARY	定义自动化库或手动库。
DEFINE VOLUME	分配将在指定存储池中用于存储的卷。
LABEL LIBVOLUME	标注手动库或自动化库中的卷。
QUERY LIBRARY	显示有关一个或多个库的信息。
QUERY LIBVOLUME	显示有关库卷的信息。
QUERY PROCESS	显示有关后台进程的信息。
REPLY	允许请求继续进行处理。
UPDATE LIBVOLUME	更改存储卷的状态。