Open_Pipe
使 IRC 将分配的管道连接到接收会话。
Open_Pipe 会使 IRC 将分配的管道连接到在 Allocate_Pipe 命令或 DFHXCURM 中指定的 CICS® 区域中定义的相应连接的接收会话。 相应的连接为以下任一项:
- 具有与 Initialize_User 命令上的 user_name 参数相等的 NETNAME 值的 EXCI 连接 (即，您正在使用专用于此客户机程序的特定连接)
- 定义为通用的 EXCI 连接
在 XCF 环境中， Open_Pipe 命令使区域间通信程序 DFHIRP 连接到接收请求的 LPAR。 此请求是异步的，因此尽管 Open_Pipe 命令可以接收到良好的返回码，但后续 DPL_Request 调用可能会失败。
如果在不支持所提供的关闭辅助事务 (CESD) 或同等事务的情况下关闭 CICS ，并且会话保持打开状态，那么 CICS 可能无法有序地关闭其 IRC 设施。 如果未关闭任何 EXCI 会话，那么在不支持关闭辅助事务的情况下正常关闭 CICS 将等待。 CICS 发出消息 DFHIR2321 ，指示以下信息:
- 会话的网络名 (如果它在特定连接上)
- 如果打开的会话在通用连接上，那么为 GENERIC 字
如果使用提供的关机辅助事务 CESD，仍未关闭的会话不会对正常关机造成问题，因为 CESD 会立即关闭 IRC。 如果至少在会话上发出了一个 DPL_Request 调用，那么消息 DFHIR2321 还会显示正在使用会话的客户机作业的作业名，步骤名和过程名，以及正在运行客户机程序的 z/OS 映像的 z/OS® 标识。
语法
CALL DFHXCIS,(version_number,return_area,user_token,call_type,
pipe_token),VL,MF=(E,(1))
参数
- 版本数
- 一个全字二进制输入区域，指示正在使用的外部 CICS 接口参数列表的版本。 必须在客户机程序中将其设置为 1。
CICS提供的副本 DFHXCPL x (其中 x 指示语言) 中此参数的等同值为 VERSION_1。 请参阅主题 表 1 以获取副本详细信息。
- 返回区域
- 用于接收响应和原因码的 5 字输出区域以及消息指针字段。 更多详情，请参阅 EXCI CALL 接口的返回区域。
- 用户令牌
- 在 Initialize_User 命令上返回的 1 字标记。
- call_type
- 指示命令功能的 1 字输入区域。 必须在客户机程序中设置为 3 ，以指示这是 Open_pipe 命令。
CICS提供的副本 DFHXCPL x (其中 x 指示语言) 中此调用的等同值为 OPEN_PIPE。 请参阅主题 表 1 以获取副本详细信息。
- 管道令牌
- 包含 CICS 在 Allocate_Pipe 命令上传递的令牌的 1 字输出区域。 它表示在此命令上打开的管道。
响应和原因码
对于所有非零响应代码，唯一原因码值标识响应的原因。
注: 所有数字响应和原因码值都采用十进制。
以下是外部 CICS 接口可以在 Open_Pipe 调用上返回的响应和原因码的摘要:
- 响应正常
- 已成功执行命令 (RC 0)。
原因码:
- 0
- 正常
- 响应警告
- 成功执行了该命令，但发生了错误 (RC 4)。
原因码:
- 1
- 管道已打开
- 响应 RETRYABLE
- 由于设置错误，该命令失败，但可以重新发出 (RC 8)。
原因码:
- 202
- 无管道
- 203
- NO_CICS
- 响应 USER_ERROR
- 由于客户机或服务器 (RC 12) 中存在错误，因此该命令失败。
原因码:
- 401
- 无效呼叫类型
- 402
- 版本号无效
- 404
- 用户令牌无效
- 418
- 无效管道令牌
- 421
- 运行在 IRB 下
- 响应 SYSTEM_ERROR
- 命令失败 (RC 16)。
原因码:
- 608
- 登录失败
- 609
- 连接失败
- 621
- 管道故障恢复
- 622
- 设置失败
- 623
- 已调用ESTAE_调用
有关响应代码的信息，请参阅 EXCI 调用响应代码值。
有关原因码的信息，请参阅 EXCI 调用时返回的响应和原因码。