GDS SEND
在 APPC 基本对话中发送数据(仅限汇编语言和 C 程序)。
描述
GDS SEND 发送数据。
返回码在 RETCODE 中给出 (请参阅 表 1)。 有关返回码值的列表,请参阅 APPC 基本对话的返回码。 在 GDS 命令中从不提出 EXEC CICS® 条件。
选项
通常,可以将自变量替换为绝对或可重定位的汇编语言表达式。
- 确认
- 允许处于同步级别 1 或 2 的应用程序将其处理与远程系统中的进程的处理同步。 同步处理所执行的操作由所涉及的应用程序定义。 CONFIRM 选项导致将 RQD2 添加到已发送的数据中,并强制进行 WAIT。 接收到该指示符时,远程进程将执行商定的操作,然后发送响应。 当 WAIT 完成时,如果已收到相应的响应,那么 CDBERR 将设置为 X'00 ' 。
- CONVDATA (数据区)
- 指定要将对话相关信息移动到其中的 24 字节应用程序数据区。 在讨论 测试指示符中的 CONVDATA 字段时提供了数据区格式的描述。
- CONVID (名称)
- 标识与命令相关的对话。 4 字符名称标识先前执行的 GDS ALLOCATE 命令返回的令牌,或表示主体会话的令牌 (由先前执行的 GDS ASSIGN 命令返回)。
- FLENGTH (data-value)
- 指定 FROM 选项中指定的数据的长度 (作为 1-32 767 范围内的全字二进制值)。
- FROM (数据区)
- 指定要发送的数据。
- 邀请函
- 允许应用程序向已发送到已连接 APPC 系统中的进程的数据添加更改方向指示符。 在后续执行 WAIT 或 SYNCPOINT 命令之前, $TAG1 CICS $TAG2 不会传输控制数据,除非在 GDS SEND INVITE 命令上也编码 CONFIRM 或 WAIT。
- 最后一个
- 允许应用程序将首协会添加到已发送到已连接 APPC 系统中的进程的数据。 除非在 GDS SEND LAST 命令上也编码了 CONFIRM 或 WAIT ,否则在后续执行 WAIT 或 SYNCPOINT 命令之前, CICS 不会传输行政首长协调会。 请注意,如果其中一个命令由于与对话相关的错误而失败,那么对话将保留在方括号中。 在这种情况下,应用程序应该执行 GDS RECEIVE 命令。 但是, GDS SEND LAST WAIT (无数据) 始终会导致取消分配对话。
- RETCODE (data-area)
- 指定要将返回码信息 (如 表 1中所示) 移动到其中的 6 字节应用程序数据区。
- 状态 (cvda)
- 获取当前对话的状态。 CICS 返回的 cvda 值为:
- 已分配
- 经济及社会理事会
- CONFRECEIVE
- 交汇
- FREE
- 无暂挂
- 暂挂接收
- RECEIVE
- 回滚
- SEND
- 无同步
- 同步接收
- SYNCSEND
- WAIT
- 确保从伙伴事务中擦除到目前为止在对话上发送的所有数据和指示符。
如果未使用 WAIT 选项,那么来自连续 SEND 命令的数据将由 CICS与任何指示符一起在内部缓冲区中累积。 如果缓冲区变满,那么大部分累积的数据将传输到远程系统,但累积的指示符不是。 通过 GDS SEND 命令的 WAIT 或 CONFIRM 选项或 GDS WAIT 命令强制传输累积数据和指示符。
| RETCODE (十六进制) | 描述 |
|---|---|
| 03 00 | CONVID 用于不是 APPC 的会话。 |
| 03 00 | CONVID 用于 CPI 通信正在使用的会话。 |
| 03 04 | CONVID 用于非基本对话。 |
| 03 08 | 已发生状态检查。 |
| 03 14 | 已在同步级别 0 对话上使用 CONFIRM 选项。 |
| 03 10 | LL 错误 (不正确或不完整)。 |
| 04 | CONVID 用于未分配给任务的会话或作为中继链路的会话。 |
| 05 00 00 00 7F FF | FLENGTH 值超出范围 0 到 32 767。 |
