3 XCMD XAPI 配置和管理命令

本章介绍了 XCMD 支持的 XAPI 配置和管理命令。这些命令可启用 ACSLS 发行版 8.4 中 ELS 兼容的卷池功能。支持的命令包括：

使用 XCMD 命令从 ACSLS user_proc 发出这些命令。有关更多信息，请参见第 2 章 XCMD 命令约定。

有关以下各个命令部分中包括的语法流程图中使用的约定，请参见语法约定。

DEFINE POOL_Name

以下部分介绍 DEFINE POOL_Name 命令。

说明

DEFINE POOL_NAME 命令将池类型和池名称与 ACSLS 池 ID 关联起来。

语法

下图显示 DEFINE POOL_Name 命令的语法：

图 3-1 DEFINE POOL_Name 命令语法

周围的文本说明了 图 3-1 。

参数

如图 3-1中所示，DEFINE POOL_Name 命令包括以下参数：

pool_name

池名称最多包含 13 个字符。池名称可包含除以下字符以外的任意字符：百分号 ("%")、下划线 ("_") 或星号 ("*")。

POOLTYpe

池类型，可以是 Scratch（默认值）或 Mvc。

POOLId (nnnnn)

（可选）指定池 ID (nnnnn)。

  • 如果您选择指定该参数，则必须指定当前不存在的池 ID。

  • 如果未指定该参数，系统将自动分配一个池 ID 作为从 10000 开始的第一个未使用的值。

示例

在下面的示例中，用户发出了 DEFINE POOL_Name 命令以定义暂存池 SCRPOOL1：

XCMD DEFINE POOL_NAME SCRPOOL1 POOLTYPE SCRATCH

DEFINE POOL_Access

以下部分介绍 DEFINE POOL_Access 命令。

说明

DEFINE POOL_Access 命令定义允许指定主机对 pool_name 的访问权限。如果没有为特定 pool_name 定义池访问权限，则允许所有访问权限。

语法

下图显示 DEFINE POOL_Access 命令的语法：

图 3-2 DEFINE POOL_Access 命令语法

周围的文本说明了 图 3-2 。

参数

如图 3-2中所示，DEFINE POOL_Access 命令包括以下参数：

pool_name

池名称最多包含 13 个字符。池名称可包含除以下字符以外的任意字符：百分号 ("%")、下划线 ("_") 或星号 ("*")。先前必须已使用 DEFINE POOL_Name 命令定义了指定的 pool_name，且池类型为 SCRATCH（没有为 MVC 池定义访问权限）。有关更多信息，请参见DEFINE POOL_Name。

HOSTid host_name

指定最多包含 31 个字符的主机名。该参数是必需的。

指定的 HOSTid 是 Internet 全限定域名的主机名部分。例如，如果全限定域名是 myhost.plus.domain.name，则指定的 HOSTid 是 myhost。

ALLOWMount

（可选）指定挂载访问权限。可以指定 True 或 False。该参数仅对定义为 POOLTYPE MVC 的池有效。

ALLOWSELscratch

（可选）为 XAPI 命令 query_scr_mnt_info、sel_scratch 和 mount 指定对暂存卷的访问权限。可以指定 True 或 False。如果未指定该参数，默认情况下将其设置为 True。

该参数仅对定义为 POOLTYPE SCRATCH 的池有效。如果为定义为 MVC 的池指定该参数，此参数将自动默认设置为 False。

ALLOWSCRatch

（可选）指定暂存访问权限。可以指定 True 或 False。如果未指定该参数，默认情况下将其设置为 True。

该参数仅对定义为 POOLTYPE SCRATCH 的池有效。如果为定义为 MVC 的池指定该参数，此参数将自动默认设置为 False。

示例

在下面的示例中，用户发出 DEFINE POOL_Access 命令以为暂存池名称 SCRPOOL1 定义集访问权限，其中主机是 PRODMVS，ALLOWMOUNT 和 ALLOWSCRATCH 是 True：

XCMD DEFINE POOL_ACCESS SCRPOOL1 HOSTID PRODMVS ALLOWMOUNT TRUE ALLOWSCRATCH TRUE

DELETE POOL_Name

以下部分介绍 DELETE POOL_Name 命令。

说明

DELETE POOL_Name 命令将删除池。该命令与 ACSLS delete pool 命令类似，其区别如下：

  • 输入指定 pool name 而不是 pool ID。

  • 用户可以选择将分配给池的卷重新分配给池 0。

有关 ACSLS delete pool 命令的更多信息，请参阅《StorageTek Automated Cartridge System Library Software (ACSLS) 管理员指南》。

语法

下图显示 DELETE POOL_Name 命令的语法：

图 3-3 DELETE POOL_Name 命令语法

周围的文本说明了 图 3-3 。

参数

如图 3-3中所示，DELETE POOL_Name 命令包括以下参数：

pool_name

池名称最多包含 13 个字符。池名称可包含除以下字符以外的任意字符：百分号 ("%")、下划线 ("_") 或星号 ("*")。先前必须已使用 DEFINE POOL_Name 命令定义了指定的 pool_name。有关更多信息，请参见DEFINE POOL_Name

RESETvols

指示当前已分配到要删除的池的卷应重新分配到池 0。如果未指定该参数，并且卷当前存在于池中，则 delete pool-name 命令将失败。

示例

在下面的示例中，用户发出 DELETE POOL_Name 命令以删除池 SCRPOOL1，并将其卷重新分配到池 0（默认池）：

XCMD DELETE POOL_NAME SCRPOOL_TEST1 RESETVOLS

DELETE POOL_Access

以下部分介绍 DELETE POOL_Access 命令。

说明

DELETE POOL_Access 命令将删除与单个主机名 (host_id) 关联的池访问权限规则，或删除所有主机的所有池访问权限规则。

  • 如果指定了主机名 (host_id)，则只从指定池中删除指定主机的访问权限规则。

  • 如果指定了 ALLhost，则将删除池的所有池访问权限规则。

语法

下图显示 DELETE POOL_Access 命令的语法：

图 3-4 DELETE POOL_Access 命令语法

周围的文本说明了 图 3-4 。

参数

如DELETE POOL_Access 命令语法中所示，DELETE POOL_Access 命令包括以下参数：

pool_name

池名称最多包含 13 个字符。池名称可包含除以下字符以外的任意字符：百分号 ("%")、下划线 ("_") 或星号 ("*")。先前必须已使用 DEFINE POOL_Name 命令定义了指定的 pool_name。有关更多信息，请参见DEFINE POOL_Name。

HOSTid host_name

（可选）指定最多包含 31 个字符的主机名，并指示应删除该主机 ID 的访问权限限制（任何其他主机 ID 的访问权限规则保持不变）。该参数与 ALLhost 互斥

ALLhost

（可选）指定删除所有主机 ID 的特定 pool_name 的所有访问权限限制。该参数与 HOSTid 互斥。

示例

在下面的示例中，用户发出 DELETE POOL_Access 命令以删除从主机 PRODMVS 到 SCRPOOL1 的池访问权限：

XCMD DELETE POOL_ACCESS SCRPOOL1 HOSTID PRODMVS

SET POOL_Name

以下部分介绍 SET POOL_Name 命令。

说明

SET POOL_Name 命令将卷分配到池名称，或设置池名称的低水位标志。

注:

如果命令语法有效，即使无法将指定卷范围内的某些卷添加到池，也会将卷范围添加到数据库。如果属于以下情况之一，则无法将卷添加到池：

  • 卷已锁定。

  • 卷已在其他池中，除非指定了 FORCE。

  • 卷在逻辑磁带库中。

  • 卷有 ACSLS 所有者，并且访问权限控制已生效。

语法

下图显示 SET POOL_Name 命令的语法：

图 3-5 SET POOL_Name 命令语法

周围的文本说明了 图 3-5 。

参数

如图 3-5中所示，SET POOL_Name 命令包括以下参数：

pool_name

池名称最多包含 13 个字符。池名称可包含除以下字符以外的任意字符：百分号 ("%")、下划线 ("_") 或星号 ("*")。先前必须已使用 DEFINE POOL_Name 命令定义了指定的 pool_name。有关更多信息，请参见DELETE POOL_Name。

LOWwater nnnnnnn

（可选）定义池必须包含的可用卷的最小数目。如果可用卷的数目降至低水位标志以下，ACSLS 系统将生成警告消息。

VOLumes 或 VOLSer (volser-list, volser-range, range-list)

（可选）指定卷序列号列表、卷序列号范围或卷序列号范围列表。最多可以指定 16 个卷或范围。

根据 ACSLS 格式卷序列号范围来评估卷范围：ACSII 整理序列，不必符合 HSC 卷模式范围；但是，单个范围内的两个卷序列号必须包含相同的字符数，只有字符数匹配的卷序列号才会被认为在该范围内。例如，范围 1234-12356 是无效的。在范围 1234-2345 中，不会认为卷序列号 123567 在该范围内。如果指定的范围有效，即使无法将该范围内的某些卷分配到池，也会将该范围添加到数据库。指定的卷范围不能与任何现有的卷范围重叠，彼此之间也不能重叠。

根据 ACSLS 格式卷序列号范围评估卷范围：

  • 范围中指定的两个卷序列号必须包含相同的字符数。

  • 范围中的第一个卷序列号元素必须严格小于第二个卷序列号元素。

  • 如果指定的卷序列号长度小于 6 个字符，则对卷序列号进行评估，就好像它们是用空白填充的一样，并向左对齐 6 个字符域。

  • 在使用 ASCII 整理序列评估范围时，只有严格大于或等于第一个卷序列号元素，以及严格小于或等于第二个卷序列号元素的卷序列号才会在该范围内。例如，卷序列号范围 123456-234567 包含卷序列号 12345A。

如果指定的范围有效，即使无法将该范围内的某些卷分配到池，也会将该范围添加到 pool_name 数据库。指定的卷范围不能与任何现有的卷范围重叠，彼此之间也不能重叠。

ADD

指示要将指定的卷范围添加到池的现有范围。这是默认选项。如果指定，还必须指定 VOLumes。ADD 与 REPLace 互斥。

REPlace

指示指定的卷范围将替换当前指定的任何卷范围，以前范围内的卷将重新分配到池 0。如果指定，还必须指定 VOLumes（或 VOLSer）。REPlace 与 ADD 互斥。

FORCE

（可选）指示应将已分配到其他池的卷重新分配到新池。如果未指定该参数，则不会更新当前分配到其他池的任何卷。如果指定，还必须指定 VOLumes（或 VOLSer）。

APPLY

（可选）指示应将先前定义的卷范围应用于数据库中的卷。如果由于上面列出的限制而导致某些卷未更新，则可以使用该参数。如果指定，还必须指定 VOLumes（或 VOLSer）。

示例

在下面的示例中，命令将卷 DRL001-DRL999 添加到 SCRPOOL1：

XCMD SET POOL_NAME SCRPOOL_TEST1 VOLUMES DRL001-DRL999

QUERY POOL_Name

以下部分介绍 QUERY POOL_Name 命令。

说明

QUERY POOL_Name 命令显示所有池，以指定字符开头的池，或单个池。

语法

下图显示 QUERY POOL_Name 命令的语法：

图 3-6 QUERY POOL_Name 命令语法

周围的文本说明了 图 3-6 。

参数

如图 3-6中所示，QUERY POOL_Name 命令包括以下参数：

pool_name

最多包含 13 个字符的现有池名称，或普通名称，末尾有星号 ('*') 字符。该参数是必需的。

pool_name 格式确定了输出显示，如下所示：

  • 如果 pool_name 不是普通名称，所显示的池信息将包括已定义的卷序列号和单个匹配池的卷序列号范围。

  • 如果 pool_name 是普通名称（包括结尾 ’*’），所显示的池信息不包括已定义的卷序列号和匹配池的卷序列号范围。

示例

在下面的示例中，用户发出 QUERY POOL_Name 命令以显示有关 pool1 的信息，包括关联的卷范围。

XCMD QUERY POOL_NAME POOL1

在下一个示例中，用户发出 QUERY POOL_Name 以显示有关所有已命名池的信息（不包括卷范围）：

XCMD QUERY POOL_NAME *

在下一个示例中，用户发出 QUERY POOL_Name 命令以显示有关以 "A" 开头的所有池的信息（不包括卷范围）：

XCMD QUERY POOL_NAME A*

QUERY POOL_Access

以下部分介绍 QUERY POOL_Access 命令。

说明

QUERY POOL_Access 命令显示单个主机或与某个池名称关联的所有主机的池访问权限规则。

语法

下图显示 QUERY POOL_Access 命令的语法：

图 3-7 QUERY POOL_Access 命令语法

周围的文本说明了 图 3-7 。

参数

如图 3-7中所示，QUERY POOL_Access 命令包括以下参数：

pool_name

池名称最多包含 13 个字符。池名称可包含除以下字符以外的任意字符：百分号 ("%")、下划线 ("_") 或星号 ("*")。先前必须已使用 DEFINE POOL_Name 命令定义了指定的 pool_name。有关更多信息，请参见DEFINE POOL_Name。

HOSTid host_id

（可选）指定包含 1-31 个字符的 host_name。先前必须已使用 DEFINE_POOL_Access 命令为 pool_name 定义了指定的 host_id。有关更多信息，请参见DEFINE POOL_Access。

如果未指定该参数，则将显示与池关联的所有主机的访问权限规则。

示例

在下面的示例中，用户发出 QUERY POOL_Access 命令以查询与 pool_name SCRPOOL1 关联的所有主机的访问权限规则：

XCMD QUERY POOL_ACCESS SCRPOOL1