在 INSTALL 上自动安装用户程序

当为安装 IPCONN 资源调用自动安装用户程序时, CICS® 会在 DFHEICAP 寻址的通信区域中向其传递参数列表。

用于 IPCONN 的 INSTALL 通信区域

通信区域由汇编程序 DSECT DFHISAIC 映射,后者在 CICSTS54.CICS.SDFHSAMP 中提供。
图 1。 在 INSTALL 上自动安装用户程序的通信区域。 对于 IPCONN。
ISAIC_FUNCTION         DS CL1    Function code (X'F0' for Install)
ISAIC_RESPONSE         DS CL1    Response code
                       DS CL2    Reserved
ISAIC_IPCONN           DS CL8    Name for the autoinstalled IPCONN
ISAIC_APPLID           DS CL8    The applid of remote system
ISAIC_SUGGESTED_APPLID DS CL8    Suggested applid, if isaic_applid
*                                is blank
ISAIC_NETWORKID        DS CL8    Network ID of remote system
ISAIC_TCPIPSERVICE     DS CL8    Name of the TCPIPSERVICE on which
*                                this connect flow arrived
ISAIC_TEMPLATE         DS CL8    Name of the template IPCONN
ISAIC_HOST             DS CL116  Host name of remote system
ISAIC_PORT             DS F      Call back port number of
*                                remote system
ISAIC_RECEIVECOUNT     DS F      Number of receive sessions wanted
*                                by remote system
isaic_applid (输入/输出)
8 字符字段,包含尝试连接的远程系统的 APPLID (在连接流上发送)。 仅当用户程序在输入上为空时 (这指示连接系统可能是 Java 客户机) ,用户程序才能更改此值。 如果输出为空白,那么 CICS 将使用isaic_另有建议的 applid 字段所指向的 applid
isaic_function (输入)
1 字符代码,指示已为其调用自动安装用户程序的函数。 包含用于安装的 X'F0'。
isaic_host (输入/输出)
116 个字符的字段,其中包含在连接流中传递的远程系统的主机名。 允许自动安装用户程序对此进行修改,因为它可能比系统本身更清楚连接系统在本地被称为什么。
isaic_ipconn (输出)
包含要用于自动安装的 IPCONN 连接的名称的 8 字符字段。 用户程序必须提供名称。
isaic_networkid (输入)
8 字符字段,包含尝试连接的系统的网络标识 (在连接流上发送)。
isaic_port (输入/输出)
客户机的回调端口号。 -1 表示不允许回调。 自动安装用户程序可以修改此主机名的原因与它可以修改主机名的原因相同,除非它是 -1 ,在这种情况下不能更改它。 也不允许自动安装用户程序将此值更改为 -1。
isaic_receivecount (输入)
包含远程系统希望由此 IPCONN 支持的接收会话数的 4 字节二进制字段。 (这些是远程系统端的发送会话。)
isaic_response (输出)
响应代码: 零表示正常。
isaic_suggested_applid (输入)
包含远程系统应用程序标识 建议 的 8 字符字段 (按 CICS)。 如果 isaic_applid 指向的远程系统的 applid 为空,那么 CICS 使用计数器生成格式为 00000027的 8 字符十进制数字名称。
isaic_tcpipservice (输入)
8 字符字段,其中包含此连接流到达的 TCPIPSERVICE 的名称。
isaic_template (输入/输出)
8 字符字段,其中包含要用作新 IPCONN 资源模板的已安装 IPCONN 的名称。
缺省情况下,此字段为空, CICS 提供创建 IPCONN 资源所需的信息。
自动安装用户程序可以修改此字段以命名模板 IPCONN 资源。 如果模板 IPCONN 资源超出服务范围,那么将拒绝自动安装请求。