N CSCI

本章介绍客户机服务器通信接口 (Client Server Communications Interface, CSCI) 组件。

本章介绍以下主题：

• CSCI 概述

• 错误消息

• 环境变量

必须在安装操作系统及安装和配置 ACSLS 之后安装 CSCI。

注:

要使 ACSLS 能够正常工作，必须将 START_CSCI_PROCESS 配置变量设置为 TRUE。可在 acsss_config 的选项 1 中执行此操作。请参见设置控制 ACSLS 行为的变量。

CSCI 概述

客户机服务器通信接口 (Client Server Communications Interface, CSCI) 是一个独立组件，负责在客户机系统和服务器系统之间传递请求包和响应包。CSCI 是一个可选组件，可让 MVS 或 RMLS/CSC 客户机与 ACSLS 通信。如果不使用 CSCI，默认情况下将使用 CSI 与 ACSLS 通信。

CSCI 连接

CSCI 提供 IPC 和 TCP/IP 连接，用于将 ACSLS 服务器与 MVS 客户机或 RMLS/CSC 客户机链接起来。

体系结构和子系统

下图显示 CSCI 整个体系结构和子系统。

图 N-1 CSCI 体系结构和子系统

下图显示 CSCI 系统如何与网络接口连接。在服务器端，数据通过 TCP/IP 接口从网络集线器流向 CSCI 接口。在这里，数据通过 IPC 接口在两个方向上流到 ACSLS 软件，但处于半双工模式，例如：一次一个方向。

图 N-2 具有令牌环接口的 CSCI 系统

错误消息

CSCI 安装和配置错误消息与以下情况有关：

• 不正确的所有权

• 不正确的访问权限

• 未定义的环境变量

• 其他各种情况

• 不正确的 CSCI 和 TCP/IP 配置

常见错误消息

Communication failure, verb = cmroutine, rc = xx, errno = yyy IPC failure on Socket CSCIzzzzz

解释：命名连接上读取失败。

变量：

• xx 是 IBM CPI 返回码

• yyy 是 /usr/include/sys/errno.h 中的 UNIX errno 值

• CSCIzzzzz 是正在使用的套接字编号

• cmroutine 是失败的 IBM CPI 例程名称

Read failed for connection: connection_name

解释：命名连接上读取失败。

变量：connection_name 是读取失败的连接的名称。

Write failed for connection: connection_name

解释：命名连接上写入失败。

变量：connection_name 是写入失败的连接的名称。

环境变量

CSCI 由 csciTcpServer.sh 调用，后者是 ACSLS 可执行文件所在的 /$ACS_HOME/bin 目录中的事务处理程序名称 (Transaction Program Name, TPN)。此 shell 脚本定义 CSCI 环境变量。

下表介绍服务器子系统的 CSCI 环境变量以及 shell 脚本，该脚本类似在 ACSLS/CSCI 软件的分发中提供的脚本。此 shell 脚本由服务器上的 TCP/IP 启动。

表 N-1 CSCI 服务器子系统环境变量

名称	说明
START_CSCI_PROCESS	在 ACSLS 启动时自动启动 CSCI（TRUE 或 FALSE）
CSCI_TRACE	此变量指示 CSCI 跟踪是 ON 还是 OFF。
CSCI_SLEEP_TIME	此变量指示依次通过连接表进行的循环结束时的 PER 休眠时间（轮询超时）。默认值是 100 毫秒。
CSCI_INITIAL_CONNECTION	此变量指示要首先打开的 CSCI 的初始连接名称。这是在 CSCI 初始启动时需要 I/O 的连接服务名称。客户机通常首先打开 IPC；服务器首先打开 TCP/IP。
CSCI_SERVER_NAME	此变量指示 CSCI 服务器的名称。对于定义到单个 CSCI 服务器的所有 CSCI 客户机，必须将此名称设置为相同的名称。服务器名称必须与其 CSCI 客户机 CSCI_SERVER_NAME 匹配。服务器和客户机 CSCI_SERVER_NAME 的匹配可在计算机之间提供端到端逻辑链接。最后，此名称以后还可用于其他环境变量中的 "connectionname"。分配给 CSCI_SERVER_NAME 的值必须在后续变量的 connectionname 部分中重复。
CSCI_connectionname_NET_TYPE	此变量指示在 CIF 子系统中，为此 CSCI 配置的网络类型。NETTYPE 定义由此 CSCI 使用的传输层。有效分配是 LU62 或 IPC。
CSCI_connectionname_INPUT_ SOCKET	此变量指示要用作此 CSCI 的输入的输入套接字编号。此编号应与服务器或客户机应用程序输出套接字编号匹配。
CSCI_connectionname_CON_ TYPE	此变量指示该 CSCI 类型。该 CON_TYPE 将 CSCI 定义为 SERVER 或 CLIENT。
CSCI_connectionname_ TRANSLATE_TYPE	此变量指示要在执行期间采用的 CSCI XDR 类型。可为其分配 XDR 或 NONE。
CSCI_connectionname_ DESTINATION_SOCKET	此变量指示要由 CSCI 服务器使用的目标或输出套接字编号。该套接字编号应是 CSCI 服务器应用程序的匹配的输入套接字编号。