GDS 问题准备

在 APPC 基本对话(仅限汇编语言和 C® 程序)上发出同步点请求的第一个流程。

语法

GDS ISSUE PREPARE (APPC 基本)

读取语法图跳过可视语法图GDS ISSUE PREPARECONVID( 名称)CONVDATA( data-area)RETCODE( data-area)STATE( CVDA)

NOHANDLERESPRESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.

描述

GDS ISSUE PREPARE 发出同步点请求的第一个流。

返回码在 RETCODE 中给出 (请参阅 表 1)。 有关返回码值的列表,请参阅 APPC 基本对话的返回码。 在 GDS 命令中从不提出 EXEC CICS® 条件。

选项

通常,可以将自变量替换为绝对或可重定位的汇编语言表达式。

CONVDATA (数据区)
指定要将对话相关信息移动到其中的 24 字节应用程序数据区。 在讨论 测试指示符中的 CONVDATA 字段时提供了数据区格式的描述。
CONVID (名称)
标识与命令相关的对话。 4 字符名称标识先前执行的 GDS ALLOCATE 命令返回的令牌,或表示主体会话的令牌 (由先前执行的 GDS ASSIGN 命令返回)。
RETCODE (data-area)
指定要将返回码信息 (如 表 1中所示) 移动到其中的 6 字节应用程序数据区。
状态 (cvda)
获取当前对话的状态。 CICS 返回的 cvda 值为:
  • 已分配
  • 经济及社会理事会
  • 确认
  • 交汇
  • FREE
  • 无暂挂
  • 暂挂接收
  • RECEIVE
  • 回滚
  • SEND
  • 无同步
  • 同步接收
  • 同步发送
表 1. GDS ISSUE PREPARE 返回码
RETCODE (十六进制) 描述
03 00 CONVID 用于不是 APPC 的会话。
03 00 CONVID 用于 CPI 通信正在使用的会话。
03 04 CONVID 用于非基本对话。
03 0C 在非同步级别 2 的对话上发出了该命令。
03 24 发生状态错误。
04 CONVID 用于未分配给任务的会话或作为中继链路的会话。