GDS CONNECT PROCESS

启动® APPC 基本对话(仅限汇编语言和 C 程序)。

语法

GDS CONNECT PROCESS (APPC 基本)

读取语法图跳过可视语法图GDS CONNECT PROCESSCONVID( 名称)PROCNAME( 名称)PROCLENGTH( data-value)PARTNER( 名称)PIPLIST( data-area)PIPLENGTH( data-value)SYNCLEVEL( data-value)CONVDATA( data-area)RETCODE( data-area)STATE( CVDA)

NOHANDLERESPRESP2是常用选项,可添加到所有 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 同步点
表 1. GDS CONNECT PROCESS 返回码
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思值。