EXTRACT PROCESS
从 APPC 对话附加头检索值。
描述
EXTRACT PROCESS 允许应用程序访问在连接程序时指定给 CICS® 的与对话相关的数据。 除非需要此信息，否则连接接收方不必执行 EXTRACT PROCESS 命令。
EXTRACT PROCESS 命令仅在作为任务主要工具的 APPC 对话上有效。
选项
- CONVID (名称)
- 标识与命令相关的对话。 4 字符名称标识表示主体会话 (EIBTRMID) 的令牌。
为了与先前发行版兼容，接受 SESSION 作为 CONVID 的同义词。 新程序应使用 CONVID。
如果同时省略了 CONVID 和 SESSION ，那么缺省情况下将使用任务的主体设施。
- MAXPROCLEN (data-value)
- 指定 PROCNAME 的缓冲区长度。 如果未指定 MAXPROCLEN ，那么假定缓冲区具有 32 个字节。
- PIPL思 (data-area)
- 指定返回进程初始化参数 (PIP) 列表总长度的半字二进制数据区。
- PIPLIST (ptr-ref)
- 指定一个指针引用，该引用设置为包含 PIP 列表的 CICS提供的数据区的地址。 此列表包含与 CONNECT PROCESS 命令中的列表格式相同的可变长度记录。 返回值为零表示 CICS未接收到任何 PIP 数据。
- PROCLENGTH (数据区)
- 指定由 CICS 设置为进程名称长度的半字数据区。 如果指定了 PROCNAME ，那么必须指定此选项。
- PROCNAME (数据区)
- 指定要接收由导致任务启动的远程系统指定的进程名称的数据区。 数据区的长度可以是 1-64 字节。 如果进程名称太短，那么将在右边用空格填充该进程名称。 PROCNAME 数据区不应短于 MAXPROCLEN 值。
- SYNCLEVEL (数据区)
- 指定由 CICS 设置为 SYNCLEVEL 值的半字数据区。 有关同步级别的更多信息，请参阅 同步。
条件
- 16 INVREQ
- RESP2 值：
- 200
- 分布式程序链接服务器应用程序在 CONVID 选项上指定了函数输送会话 (其主体设施)。
在下列任何情况下也会发生 (未设置RESP2 ):- EXTRACT PROCESS 已用于非 APPC 映射的对话 (例如， LUTYPE6.1， APPC 基本或 CPI 通信)。
- EXTRACT PROCESS 已用于未由网络输入启动且其会话不是主体设施的对话。
- 针对 CPI-Communications 对话发出此命令。
缺省操作: 异常终止任务。
- 22 LENGERR
- 如果 PROCNAME 的实际长度大于 MAXPROCLEN ，或者如果未指定 MAXPROCLEN ，那么将发生超过 32 个字节的情况。
缺省操作: 异常终止任务。
- 61 个 NOTALLOC
- 如果指定的 CONVID 值与应用程序拥有的对话无关，那么将发生此情况。
缺省操作: 异常终止任务。