本章介绍连接到 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 控制变量的详细信息。
请参阅 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
使用 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 个字符的文本。