GDS EXTRACT ATTRIBUTES

在 APPC 基本对话中访问状态信息(仅限汇编语言和 C 程序)。

GDS 抽取属性 (APPC 基本)

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

描述

GDS EXTRACT ATTRIBUTES 访问有关 APPC 基本对话的状态信息。

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

选项

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

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