GDS EXTRACT PROCESS

从 APPC 基本对话中读取数值（仅限汇编语言和 C® 程序）。

语法

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

GDS EXTRACT PROCESS 从 APPC 基本对话中检索值。仅当针对 APPC 基本主体设施发出命令时，检索的数据才有效。

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

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

CONVID (名称)

标识与该命令相关的对话。 4 字符名称标识表示主体会话的令牌 (由先前执行的 GDS ASSIGN 命令返回)。

MAXPROCLEN (data-value)

指定 PROCNAME 数据区的长度 (1-64 个字符)。如果未指定 MAXPROCLEN ，那么假定缓冲区具有 32 个字节。

PIPL思 (data-area)

指定要接收 GDS EXTRACT PROCESS 命令接收的 PIPLIST 长度的半字二进制数据区。

PIPLIST (pointer-ref)

指定要设置为 GDS EXTRACT PROCESS 命令接收的 PIPLIST 地址的指针引用。零设置指示未接收到 PIPLIST。

PROCLENGTH (数据区)

指定设置为进程名称的实际长度的半字二进制数据区。

PROCNAME (数据区)

指定要将 APPC 连接功能管理头中指定的进程名称移动到其中的应用程序目标数据区 (1-64 字节)。如果需要，将用空格填充该区域。

RETCODE (data-area)

指定要将返回码信息 (如表 1中所示) 移动到其中的 6 字节应用程序数据区。

SYNCLEVEL (数据区)

指定半字二进制数据区，该数据区设置为指示对当前对话生效的同步级别。可能的值包括：

表 1. GDS EXTRACT PROCESS 返回码
RETCODE (十六进制)	描述
03 00	CONVID 用于不是 APPC 的会话。
03 00	CONVID 用于 CPI 通信正在使用的会话。
03 00	CONVID 用于不是主要设施的会话。
03 00	主体设施未由终端数据启动。
03 04	CONVID 用于非基本对话。
04	CONVID 用于未分配给任务的会话或作为中继链路的会话。
05 00 00 00 00 20	返回的 PROCLENGTH 值大于 MAXPROCLEN 值。