LABEL LIBVOLUME（标号库卷）

使用此命令可对磁带卷添加标签，或者在自动库中，在卷检入时自动对卷添加标签。使用此命令，服务器就可以使用全长标签，卷通常都预先加注了全长标签。

限制：此命令仅用于 MANUAL、SCSI、ACSLS 和 349X 库。此命令的处理不会等待磁带器变为可用，即使驱动器只是处于空闲状态也是如此。如有必要，可以发出 DISMOUNT VOLUME 命令卸载该特定磁带机中的卷，以使库磁带机可用。当库磁带机变为可用时，可以再次发出 LABEL LIBVOLUME 命令。

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

要使用 LABEL LIBVOLUME 命令，必须至少存在一个未由另一 Tivoli® Storage Manager 进程使用的磁带机。这包括已安装的空闲卷。必要时，请使用 DISMOUNT VOLUME 命令卸装空闲卷，以使该磁带机可用。

缺省情况下，LABEL LIBVOLUME 命令不会覆盖现有标签。但是，如果您要覆盖现有标签，那么可以指定 OVERWRITE=YES 选项。

注意：

通过覆盖卷标，您将破坏该卷上的所有数据。覆盖卷标时请务必谨慎，以避免删除有效数据。
VolSafe 卷上的标签只能覆盖一次。因此，仅对 VolSafe 卷使用 LABEL LIBVOLUME 命令一次。通过将 OVERWRITE=NO 选项与 LABEL LIBVOLUME 命令配合使用，您可以防止覆盖标签。

使用 LABEL LIBVOLUME 命令时，您可以通过下列其中一种方式识别要添加标签的卷：

以显示方式命名某个卷。
使用 VOLRANGE 参数来输入一系列卷。
使用 VOLLIST 参数指定包含一列卷名的文件或以显示方式命名一个或多个卷。

对于自动化库，系统会提示您在该库的入口/出口槽中插入卷。如果没有可用的 I/O 便利站，请将卷插入空槽中。对于手动库，系统会提示您将卷直接装入磁带机中。

提示：要自动对磁带卷添加标签，您可以对 DEFINE LIBRARY 和 UPDATE LIBRARY 命令使用 AUTOLABEL 参数。通过使用 AUTOLABEL 参数，无需对一组磁带预先添加标签。此方法的效率高于使用 LABEL LIBVOLUME 命令，后者要求您分别安装卷。如果您将 AUTOLABEL 参数与 SCSI 库配合使用，那么必须通过对 CHECKIN LIBVOLUME 命令指定 CHECKLABEL=BARCODE 来检入磁带。对于所有非 SCSI 库，AUTOLABEL 参数的缺省值为 YES；对于 SCSI 库，其缺省值为 NO。

要使用 LABEL LIBVOLUME 命令对卷添加标签，请指定 CHECKIN 参数。

要自动对 SCSI 类型库中的磁带卷添加标签，请对 DEFINE LIBRARY 和 UPDATE LIBRARY 命令使用 AUTOLABEL 参数。通过使用此参数，无需对一组磁带预先添加标签。此方法的效率也高于使用 LABEL LIBVOLUME 命令，后者要求您分别安装卷。如果您使用 AUTOLABEL 参数，那么必须通过对 CHECKIN LIBVOLUME 命令指定 CHECKLABEL=BARCODE 来检入磁带。

标签不能包含嵌入空白或句点，并且它在介质上用作文件名时必须有效。

您必须使用制造商提供的设备实用程序或 Windows 实用程序对 CD-ROM、Zip 或 Jaz 卷添加标签。其原因在于，Tivoli Storage Manager 未提供用于对这些介质类型进行格式化或添加标签的实用程序。操作系统实用程序包含“磁盘管理器”程序（图形用户界面）和标签命令。

特权级别

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

手动库的语法


>>-LABEl LIBVolume--library_name------volume_name--------------->

   .-OVERWRITE--=--No------.  .-WAITTime--=--60----.   
>--+-----------------------+--+--------------------+-----------><
   '-OVERWRITE--=--+-No--+-'  '-WAITTime--=--value-'   
                   '-Yes-'

SCSI 库的语法


>>-LABEl LIBVolume--library_name-------------------------------->

>----+-volume_name----------------------------------------------------+---->
     '-SEARCH--=--+-Yes--| A |--+--LABELSource--=--+-Barcode--------+-'     
                  '-Bulk--| A |-'                  +-Prompt---------+       
                                                   '-Vollist--| B |-'       

                                .-OVERWRITE--=--No------.   
>--+-------------------------+--+-----------------------+------->
   '-CHECKIN--=--+-SCRatch-+-'  '-OVERWRITE--=--+-No--+-'   
                 '-PRIvate-'                    '-Yes-'     

   .-WAITTime--=--60----.   
>--+--------------------+--------------------------------------><
   '-WAITTime--=--value-'   

A (SEARCH=Yes, SEARCH=Bulk)

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

B (LABELSource=Vollist)

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

349X 库的语法


>>-LABEl LIBVolume--library_name-------------------------------->

>----+-volume_name---------------+------------------------------>
     '-SEARCH--=--Yes----| A |---'     

                                .-OVERWRITE--=--No------.   
>--+-------------------------+--+-----------------------+------->
   '-CHECKIN--=--+-SCRatch-+-'  '-OVERWRITE--=--+-No--+-'   
                 '-PRIvate-'                    '-Yes-'     

   .-WAITTime--=--60----.   
>--+--------------------+--------------------------------------><
   '-WAITTime--=--value-'   

A (SEARCH=Yes)

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

ACSLS 库的语法


>>-LABEl LIBVolume--library_name-------------------------------->

>----+-volume_name---------------+------------------------------>
     '-SEARCH--=--Yes----| A |---'     

                                .-OVERWRITE--=--No------.   
>--+-------------------------+--+-----------------------+------->
   '-CHECKIN--=--+-SCRatch-+-'  '-OVERWRITE--=--+-No--+-'   
                 '-PRIvate-'                    '-Yes-'     

   .-WAITTime--=--60----.   
>--+--------------------+--------------------------------------><
   '-WAITTime--=--value-'   

A (SEARCH=Yes)

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

参数

library_name（必需）

指定包含存储卷的库名。

volume_name

指定要标记的卷的名称。

对于 SCSI 库：服务器请求将卷插入到库中的插槽，或者插入到进入/退出端口（如果可用）。服务器使用插槽的单元地址来确定插槽。如果要对具有多个进入/退出端口的 SCSI 库中的卷进行标注，那么将标注编号最小的插槽中的卷。
警告：如果您指定卷名称，那么指定的名称将覆盖磁带盒上打印的标签。
对于 MANUAL 库：服务器请求将卷插入驱动器。
对于 349X 库：卷可能已在库中，或者可能提示您将其放入 I/O 站。

切记：如果指定的卷名称已在存储池或卷历史记录文件中定义，那么将不会标记该卷，并且将显示相应的消息。

CHECKIN

指定服务器是否检入卷。此参数是可选参数。以下是可能的值：

SCRatch: 指定服务器检入卷并将它们添加到库的临时池中。如果卷在卷历史记录中有对应的条目，那就不能将该卷作为临时卷检入。
PRIvate: 指定服务器检入卷并把它们指定为专用卷。仅当通过名称申请专用卷时，专用卷才是可用的。

如果未对此参数指定值，那么命令将对卷添加标签，但不会将其检入。如果不为此参数指定值，并且希望检入卷，那么必须发出 CHECKIN LIBVOLUME 命令。

SEARCH

指定服务器从库中搜索可用的卷以进行标号。此参数适用于 SCSI、349X 和 ACSLS 库。

以下值有效：

Yes: 指定服务器仅对存储在库中的卷进行标号，除非该卷已标号或它的条形码无法读取。
如果指定了 LABELSOURCE=PROMPT 选项，那么卷将从它在库或进入端口和退出端口中的位置移入磁带机中。服务器将提示您发出包含标签字符串的 REPLY 命令，然后该标签将写入磁带中。
Bulk: 指定服务器搜索库进入/退出端口以查找要添加标签的可用卷。此选项仅对 SCSI 库有效。
如果指定了 LABELSOURCE=BARCODE，那么将读取卷条形码。然后，磁带将从它在库或进入/退出端口中的位置移至写入条形码标签的磁带机中。对磁带添加标签后，如果指定了 CHECKIN 选项，那么该磁带将移回它在库中的位置、进入/退出端口或存储器槽。要使条形码支持能够正常用于 Tivoli Storage Manager 支持的库，Tivoli Storage Manager 服务器与设备驱动程序必须处于相同级别。条形码支持可用于 Tivoli Storage Manager 支持的库以及使用 Tivoli Storage Manager 设备驱动程序、IBM® Magstar® 或 LTO Ultrium 设备驱动程序的库。

提示：您可以使用 VOLRANGE 或 VOLLIST 参数来限制搜索。

VOLRange

指定一系列以逗号分隔的卷名。当指定 SEARCH=YES（349X、ACSLS 和 SCSI 库）或 SEARCH=BULK（仅限 SCSI 库）时，使用此参数来限制对要标号的卷的搜索。如果该库中没有指定范围的卷，那么此命令完成时没有错误。

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

参数	描述
`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

指定卷的列表。当指定 SEARCH=YES（349X、ACSLS 和 SCSI 库）或 SEARCH=BULK（仅限 SCSI 库）时，使用此参数来限制对要标号的卷的搜索。如果库中没有列表中的卷，那么此命令完成时没有错误。如果 LABELSOURCE 参数设置为 VOLLIST，那么 VOLLIST 参数也可以是要用于对卷添加标签的名称的来源。如果 LABELSOURCE=VOLLIST，那么您必须指定 VOLLIST 参数。

以下值有效：

volume_name

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

FILE:file_name

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

TAPE01
TAPE02
TAPE03

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

切记：文件名区分大小写。

LABELSource

指定服务器如何读取或是否读取卷的顺序介质标签。此选项仅对 SCSI 库有效。只有当 SEARCH=YES 或 SEARCH=BULK 时才指定此参数。

可指定以下值：

Prompt: 服务器可在需要时提示卷名。
Barcode: 服务器尝试读取条形码标签。如果尝试失败，那么服务器不会对卷添加标签并显示一条消息。
要点：要使条形码支持正常工作，必须为这些库安装相应的设备驱动程序。
Vollist: 此选项仅适用于 SCSI 库。服务器尝试读取指定文件或文件列表。如果尝试失败，那么服务器不会对卷添加标签并显示一条消息。

OVERWRITE

指定服务器是否尝试覆盖现有标签。此参数是可选参数。缺省值是 NO。可指定以下值：

No: 指定服务器仅标号尚未标号的卷。对于 StorageTek VolSafe 卷，此值必须为 NO。
Yes: 指定仅当尚未在服务器存储池或卷历史记录列表中定义现有标签和提示标签或条形码标签的情况下，服务器才会覆盖现有标签。

WAITTime

指定服务器等待您回复或响应请求的分钟数。请指定 0 到 9999 之间的一个值。如果您希望由服务器进行提示，请指定一个大于零的等待时间。缺省值是 60 分钟。例如，假定服务器提示您将磁带插入库的进入/退出端口中。如果指定的等待时间为 60 分钟，那么服务器将发出请求并在 60 分钟内等待您回复。或者，假定您指定的等待时间为 0。如果您插入了磁带，那么等待时间为零将导致操作继续执行，而不会显示提示。如果您未插入磁带，那么等待时间为零将导致操作失败。

示例：自动对库卷添加标签

在检入卷时，自动对名为 AUTO 的 SCSI 库中的磁带添加标签。

label libvolume auto checkin=scratch search=yes labelsource=barcode
overwrite=yes

示例：对顺序库卷添加标签

对名为 ABC 的 SCSI 库中从 bar11a 到 bar13a 的 3 个卷添加标签。在您发出以下命令后，这三个卷的标签分别为 bar11a、bar12a 和 bar13a。

label libvolume abc checkin=scratch search=yes volrange=bar11a,bar13a 
labelsource=barcode

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