GDS FREE
将 APPC 会话返回到 CICS® (仅限汇编语言和 C 程序)。
描述
GDS FREE 将会话返回到 CICS。 仅当对话完成时，即对话状态为 FREE 时，此命令的问题才有效。
返回码在 RETCODE 中给出 (请参阅 表 1)。 有关返回码值的列表，请参阅 APPC 基本对话的返回码。 在 GDS 命令中从不提出 EXEC CICS 条件。
选项
通常，可以将自变量替换为绝对或可重定位的汇编语言表达式。
- CONVDATA (数据区)
- 指定要将对话相关信息移动到其中的 24 字节应用程序数据区。 在讨论 测试指示符中的 CONVDATA 字段时提供了数据区格式的描述。
- CONVID (名称)
- 标识要释放的对话。 4 字符名称标识先前执行的 GDS ALLOCATE 命令返回的令牌，或表示主体会话的令牌 (由先前执行的 GDS ASSIGN 命令返回)。
- RETCODE (data-area)
- 指定要将返回码信息 (如 表 1中所示) 移动到其中的 6 字节应用程序数据区。
- 状态 (cvda)
- 获取当前对话的状态。 如果不再存在活动对话，那么 FREE 命令上的 STATE 将返回 cvda 代码 00。 其他输出 cvda 值为:
- 已分配
- 经济及社会理事会
- CONFRECEIVE
- 交汇
- FREE
- 无暂挂
- 暂挂接收
- RECEIVE
- 回滚
- SEND
- 无同步
- 同步接收
- SYNCSEND
| RETCODE (十六进制) | 描述 |
|---|---|
| 03 00 | CONVID 用于不是 APPC 的会话。 |
| 03 00 | CONVID 用于 CPI 通信正在使用的会话。 |
| 03 04 | CONVID 用于非基本对话。 |
| 03 08 | 已发生状态检查。 |
| 04 | CONVID 用于未分配给任务的会话或作为中继链路的会话。 |