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_configdv_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 个字符的文本。