GDS CONNECT PROCESS
启动® APPC 基本对话(仅限汇编语言和 C 程序)。
语法
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.
描述
GDS CONNECT PROCESS 允许应用程序指定要在远程系统中运行的伙伴应用程序。
EXEC CICS 条件从不在 GDS 命令中出现。
返回码在 RETCODE 中给出 (请参阅 表 1)。 有关返回码值的列表,请参阅 APPC 基本对话的返回码。
选项
通常,可以将自变量替换为绝对或可重定位的汇编语言表达式。
- CONVDATA (数据区)
- 指定要将对话相关信息移动到其中的 24 字节应用程序数据区。 在讨论 测试指示符中的 CONVDATA 字段时提供了数据区格式的描述。
- CONVID (名称)
- 标识与命令相关的对话。 4 字符名称标识先前执行的 GDS ALLOCATE 命令返回的令牌,或表示主体会话的令牌 (由先前执行的 GDS ASSIGN 命令返回)。
- PARTNER (名称)
- 指定一组定义的名称 (8 个字符) ,这些定义包含远程伙伴事务 (TPNAME 或 XTPNAME) 的名称 (或扩展名称)。 您可以使用此选项作为 PROCNAME 和 PROCLENGTH 的替代方法。
- PIPL思 (data-value)
- 指定在 CONNECT PROCESS 命令上指定的进程初始化参数 (PIP) 列表的总长度。
- PIPLIST (数据区)
- 指定要发送到远程进程的 PIP 数据。
- PROCLENGTH (data-value)
- 指定目标进程名称的长度 (作为 1-64 范围内的半字二进制值)。
- PROCNAME (名称)
- 指定远程应用程序的名称。 APPC 体系结构允许长度名称 (1-64 字节) ,但使每个产品都可以设置自己的最大长度。 如果远程系统是 CICS®,则可以使用标准的 4 字符事务 ID。 您还可以在事务定义中使用 TPNAME 值。
- RETCODE (data-area)
- 指定要将返回码信息 (如 表 1中所示) 移动到其中的 6 字节应用程序数据区。
- 状态 (cvda)
- 获取当前对话的状态。 CICS 返回的 cvda 值为:
- 已分配
- 经济及社会理事会
- 确认
- 交汇
- FREE
- 无暂挂
- 暂挂接收
- RECEIVE
- 回滚
- SEND
- 无同步
- 同步接收
- 同步发送
- SYNCLEVEL (data-value)
- 指定要用于当前对话的同步级别 (半字二进制值)。 可能的值包括:
- 0 无
- 1 确认
- 2 同步点
| RETCODE (十六进制) | 描述 |
|---|---|
| 02 0C 00 | PARTNER 未知。 |
| 03 00 | CONVID 用于不是 APPC 的会话。 |
| 03 00 | CONVID 用于 CPI 通信正在使用的会话。 |
| 03 04 | CONVID 用于非基本对话。 |
| 03 0C | SYNCLEVEL 选项指定 0 , 1 或 2 以外的值。 |
| 03 0C | SYNCLEVEL 选项请求了 1 或 2 ,但它不可用。 |
| 03 08 | 发生状态检查。 |
| 04 | CONVID 用于未分配给任务的会话或作为中继链路的会话。 |
| 05 00 00 00 00 20 | PROCLENGTH 超出范围 1-64。 |
| 05 00 00 00 7F ff | PIPL思值在 4-763 范围之外。 |
| 05 00 00 00 7F ff | 其中一个 PIP 的 2 字节长度字段 (LL) 小于 4。 |
| 05 00 00 00 7F ff | PIP 数据中的 LLs 总数大于PIPL思值。 |
