P XAPI 客户机接口

本章介绍连接到 ACSLS 的 XAPI 客户机接口。

连接到 ACSLS 服务器的 XAPI 客户机接口

XML API (XAPI) 是一个 API，允许 StorageTek 客户机和服务器使用公共协议通过 TCP/IP 进行通信。ACSLS 8.4 及更高发行版可配置有 XAPI 支持。

要求使用基于 MVS 的服务器（HSC 用于实际磁带以及/或者 VTCS 用于虚拟磁带）的客户机现在可使用 ACSLS 来管理 StorageTek 磁带库。

请参阅 ELS 文档集中的 StorageTek Enterprise Library Software XAPI Client Interface to ACSLS Server（连接到 ACSLS 服务器的 StorageTek Enterprise Library Software XAPI 客户机接口）文档，了解有关 XAPI 和 XCMD 配置、管理和操作员命令以及支持的 XAPI 用户请求和 ACSLS XAPI 控制变量的详细信息。

ACSLS XAPI 服务

请参阅 StorageTek ACSLS 8.4 安装指南，以了解安装和卸载 ACSLS XAPI 服务的过程。

安装后，可使用 ACSLS 启动和停止 XAPI 组件。

要启动具有 XAPI 服务的 ACSLS，请在 Unix 命令提示符处输入以下命令：
```
acsss enable
```
要停止 ACSLS 和 XAPI 服务，请在 Unix 命令提示符处输入以下命令：
```
acsss disable
```
要停止 ACSLS、XAPI 服务、ACSLS 数据库及所有 ACSLS 组件，请在 Unix 命令提示符处输入以下命令：
```
acsss shutdown
```

XAPI 变量

使用 ACSLS acsss_config 或 dv_config 实用程序来显示并设置 ACSLS XAPI 静态变量。

必须重新启动 ACSLS 才能使更改生效。

dv_config
- dv_config -d 可显示所有 ACSLS 变量。
- dv_config -p <variable_name> 可更新 XAPI 变量。
请参见设置控制 ACSLS 行为的变量。

acsss_config

选择选项 9 以显示和更改 XAPI 变量。只有在安装了 XAPI 服务器后才会显示该选项。

ACSLS Feature Configuration

Enter the number followed by Return for your choice from the following menu to configure product behavior in that area.

Press ? followed by the Return key for help.

   1: Set CSI tuning variables
   2: Set event logging variables
   3: Set general product behavior variables
   4: Set access control variables
   5: Set automatic backup parameters
   6: Rebuild Access Control information
   7: Event Notification settings
   8: Define or Change Library Configuration
   9: Set XAPI server variables
   E: Exit

Menu choice:

XAPI 变量包括：

XAPI_PORT

提示：只有在重新启动 XAPI 服务器后，对 XAPI 服务器的用户定义的入站端口的更改才会生效。XAPI 服务器接收传入 XAPI 请求所使用的端口号。 [50020]：

该选项指定由 XAPI 服务器用于从客户机传入的 TCP 请求的端口。输入介于 1024 和 65535 之间的数字，以定义由 XAPI 服务器使用的端口。不要指定端口 50003。

要使此变量生效，必须重新启动 XAPI 服务器。
XAPI_WORK_PATH

提示：只有在 XAPI 服务器重新启动后，对 XAPI 工作目录的更改才会生效。将 XAPI 日志和跟踪信息放在目录中。[$ACS_HOME/log/xapi]:

选择将放置 XAPI 服务器工作文件的目录。安装后，XAPI 服务器将信息记录到 $ACS_HOME/log/xapi 目录中。在正常使用时，此变量的值不会更改。如果包含 $ACS_HOME 的文件系统中存在磁盘空间问题，则可指定备用路径。给定的路径必须是绝对路径（以 / 或 $ACS_HOME 开头的路径）。

要使此变量生效，必须重新启动 XAPI 服务器。
XAPI_LOG_SIZE

提示：只有在 XAPI 服务器重新启动后，对 XAPI 日志大小的更改才会生效。最大 XAPI 日志大小 (MB)。 [20]：

该选项指定 XAPI 日志的阈值大小，以 MB 为单位表示（此处定义为“1048576 字节”）。请输入非负数。此选项的默认值为 20。

要使此变量生效，必须重新启动 XAPI 服务器。
XAPI_LOG_FILE_NUM

提示：要保留的 XAPI 日志归档文件数。 [10]：

该选项指定要保留的归档 XAPI 日志文件数。如果当前 vlog.file 的大小超过了阈值大小，则将使用 0 至 n 后缀对日志文件重命名。0 是最新的文件，n 是最早的文件。归档文件保存在 API_WORK_PATH 目录中。达到了归档日志的指定数量后，每次将新日志添加到该目录时，会从归档目录删除最早的文件。您可以保留不少于 1 个不超过 99 个归档文件。输入介于 1 和 99 之间的数字，指定要保留的归档日志文件的数量。

要使此变量生效，必须重新启动 XAPI 服务器。
XAPI_TRACE_SIZE

提示：只有在 XAPI 服务器重新启动后，对 XAPI 跟踪大小的更改才会生效。最大 XAPI 跟踪大小 (MB)。 [50]：

该选项指定 XAPI 跟踪的阈值大小，以 MB 为单位表示（此处定义为“1048576 字节”）。请输入非负数。此选项的默认值为 50。

要使此变量生效，必须重新启动 XAPI 服务器。
XAPI_TRACE_FILE_NUM

提示：要保留的 XAPI 跟踪归档文件数。 [10]：

该选项指定要保留的归档 XAPI 跟踪文件数。如果当前 vtrace.file 的大小超过了阈值大小，则将使用 0 至 n 后缀对跟踪文件重命名。0 是最新的文件，n 是最早的文件。归档文件保存在 XAPI_WORK_PATH 目录中。达到了归档日志的指定数量后，每次将新日志添加到该目录时，会从归档目录删除最早的文件。您可以保留不少于 1 个不超过 99 个归档文件。输入介于 1 和 99 之间的数字，指定要保留的归档日志文件的数量。

要使此变量生效，必须重新启动 XAPI 服务器。
XAPI_STARTUP_FILE

提示：只有在 XAPI 服务器重新启动后，对 XAPI 启动文件名称的更改才会生效。带控制参数的 XAPI 启动文件的名称。[xapi_startup_file]:

该选项指定 XPI 启动文件的名称。该文件位于 XAPI_WORK_PATH 目录中，并包括 XAPI 启动参数。

要使此变量生效，必须重新启动 XAPI 服务器。
XAPI_TAPEPLEX_NAME

提示：只有在 XAPI 服务器重新启动后，对 XAPI Tapeplex 名称的更改才会生效。XAPI Tapeplex 的名称。 [ ]：

该选项指定 XAPI Tapeplex 的名称。要使此变量生效，必须重新启动 XAPI 服务器。

请输入长度不超过 8 个字符的文本。