CONNECT PROCESS

描述

CONNECT PROCESS 允许应用程序指定要传递到 CICS® 并在连接远程合作伙伴时使用的进程名称和同步级别。

选项

CONVID (名称)

此选项标识与命令相关的对话。 4 字符名称指定先前在 EIB 中的 EIBRSRCE 中执行的 ALLOCATE 命令返回的令牌。

为了与先前发行版兼容，接受 SESSION 作为 CONVID 的同义词。 新程序应使用 CONVID。

PARTNER (名称)

此选项指定一组定义的名称 (8 个字符) ，这些定义包含远程伙伴事务 (TPNAME 或 XTPNAME) 的名称 (或扩展名称)。 您可以使用此选项作为 PROCNAME 和 PROCLENGTH 的替代方法。

PIPL思 (data-value)

此选项指定指定进程初始化参数 (PIP) 列表的总长度 (半字二进制值)。

PIPLIST (数据区)

此选项指定要发送到远程系统的 PIP 数据。 PIP 列表由可变长度记录组成，每个记录都包含一个 PIP。 PIP 以包含 2 字节的长度字段 (LL) 开头，后跟 2 字节的保留字段，然后是参数数据。

PROCLENGTH (data-value)

此选项指定 PROCNAME 选项指定的名称的长度 (作为 1-64 范围内的半字二进制值)。

PROCNAME (数据区)

此选项指定要在远程系统中连接的伙伴进程 (即事务)。

1 字节足以标识 CICS 事务。 APPC 体系结构允许 1-64 字节的范围，但使每个产品都可以设置自己的最大值。 CICS 通过允许 1-64 字节的范围来满足要求。 如果远程系统是 CICS，那么此选项可以指定 4 字节事务标识或相关 TRANSACTION 定义中提供的 TPNAME 值。 或者，您可以通过对用户出口 XZCATT 进行编码来检查完整标识。

CICS不会对 TPN 执行字符检查。

有关用户出口 XZCATT 的编程信息，请参阅 CICS 统计信息记录格式 。

会话 (name)

此选项指定会话 TCTTE 的符号标识 (1-4 个字符)。 此选项指定要使用的备用设施。

状态 (cvda)

此选项获取当前对话的状态。 CICS 返回的 CVDA 值为:

• 已分配
• 经济及社会理事会
• 确认
• 交汇
• FREE
• 无暂挂
• 暂挂接收
• RECEIVE
• 回滚
• SEND
• 无同步
• 同步接收
• 同步发送

SYNCLEVEL (data-value)

此选项指定当前对话的同步级别 (半字二进制值)。 可能的值包括：

• 0 无
• 1 确认
• 2 同步点

条件

16 INVREQ

RESP2 值：

200

分布式程序链接服务器应用程序在 CONVID 选项上指定了函数输送会话 (其主体设施)。

在下列任何情况下也会发生 (未设置RESP2 ):

• 在 SYNCLEVEL 选项中请求了除 0 ， 1 或 2 以外的同步级别。
• 该命令对于正在使用的终端或 LU 无效。
• 该命令位于 CPI 通信正在使用的对话或 APPC 基本对话上。 在后一种情况下，应使用 GDS CONNECT PROCESS。

缺省操作: 异常终止任务。

22 LENGERR

在下列任何情况下，都会发生此情况:

• PROCLENGTH 选项中提供了超出范围的值。
• PIPL思选项中指定的值小于 0。
• PIPL思选项中指定的值超过了 CICS 实现限制 32 763。
• PIPLIST 长度元素 (LL) 的值小于 4。
• PIPLIST 中长度元素 (LLs) 的总和不等于 PIPLLENGTH 指定的值。

缺省操作: 异常终止任务。

61 个 NOTALLOC

如果指定的 CONVID 值与应用程序拥有的对话无关，那么会发生此情况。

缺省操作: 异常终止任务。

97 伙伴derr

如果 CICS无法识别 PARTNER 选项中指定的名称，那么会发生此情况。

缺省操作: 异常终止任务。

81 个 TERMERR

对于与会话相关的错误，将发生此情况。 对该对话执行的除 FREE 以外的任何操作都会导致 ATCV 异常终止。

如果用户节点错误程序 (NEP) 的 CANCEL TASK 请求在节点异常条件程序处理会话错误时有未完成的终端控制请求处于活动状态，那么会导致此情况。

缺省操作: 异常终止任务，异常终止代码为 ATNI。