EXTRACT ATTACH (MRO)

从 MRO 附加头检索值。

语法

EXTRACT ATTACH (MRO)

读取语法图跳过可视语法图EXTRACT ATTACHATTACHID( 名称)CONVID( 名称)SESSION( 名称)PROCESS( data-area)RESOURCE( data-area)RPROCESS( data-area)RRESOURCE( data-area)QUEUE( data-area)IUTYPE( data-area)DATASTR( data-area)RECFM( data-area)

条件: CBIDERR , INVREQ 和 NOTALLOC

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

描述

EXTRACT ATTACH 检索在连接头控制块中保留或先前已构建的一组值。 对于从接收到的连接功能管理头 (FMH) 检索信息的命令,必须在 RECEIVE 或 CONVERSE 命令期间设置 EIBATT。

有关 MRO 和 IRC 的更多信息,请参阅 CICS 相互通信简介

选项

ATTACHID (名称)
指定要从连接头控制块中检索值。 名称 (1-8 个字符) 向本地任务标识此控制块。
CONVID (名称)
标识与命令相关的对话。 4 字符名称标识先前在 EIB 中的 EIBRSRCE 中执行的 ALLOCATE 命令返回的令牌,或表示主体会话的令牌 (由先前执行的 ASSIGN 命令返回)。
DATASTR (数据区)
对应于 LUTYPE6.1 连接 FMH 中的数据流概要文件字段 ATTDSP。

对于两个 CICS® 系统之间的通信, CICS 不会向连接 FMH 中的数据流概要文件字段提供特殊意义。 对于大多数 CICS 应用程序,可以省略该选项。

数据区中返回的值是半字二进制值。 仅使用低阶字节 ;SNA 定义的位的含义如下:
0-7    reserved - must be set to zero
8-11   0000 - user-defined
       1111 - SCS data stream
       1110 - 3270 data stream
       1101 - structured field
       1100 - logical record management
12-15  defined by the user if bits 8-11
       are set to 0000; otherwise reserved
       (must be set to zero)
IUTYPE (数据区)
对应于 LUTYPE6.1 连接 FMH 中的交换单元字段 ATTIU。
对于两个 CICS 系统之间的通信, CICS 不会将任何特殊意义附加到连接 FMH 中的交换单元字段。 对于大多数 CICS 应用程序,可以省略该选项。 数据区中返回的值是半字二进制值。 仅使用低阶 7 位 ;SNA 定义的位含义如下:
0-10   reserved - must be set to zero
11     0 - not end of multichain interchange unit
       1 - end of multichain interchange unit
12,13  reserved - must be set to zero
14,15  00 - multichain interchange unit
       01 - single chain interchange unit
       10 - reserved
       11 - reserved
PROCESS (data-area)
对应于 LUTYPE6.1 连接 FMH 中的进程名称 ATTDPN。

对于两个 CICS 系统之间的通信,在一个系统中运行的事务可以获取与第二个系统的会话,并且可以标识要连接的事务; 在第二个系统中,标识将携带在通过会话发送的第一个数据链中。

通常,前四个字节的数据标识要连接的事务。 但是,可以构建并发送用于标识要连接的事务的连接 FMH。 接收 CICS 系统仅使用进程名称的前四个字节作为事务名称。 CICS 未将任何重要信息附加到在除第一个数据链之外的数据链中发送的附加FMH中的进程名称。

有关 CICS 系统与另一子系统之间的通信,请参阅子系统提供的有关如何在连接 FMH 中使用进程名称字段的文档。

QUEUE (数据区)
对应于连接 FMH 中的队列名称 ATTDQN。 对于两个 CICS 系统之间的通信, CICS 不会将任何重要信息附加到连接 FMH 中的队列名称。

有关 CICS 系统与另一子系统之间的通信,请参阅子系统提供的有关如何在连接 FMH 中使用队列名称字段的文档。

RECFM (data-area)
对应于 LUTYPE6.1 连接 FMH 中的数据块算法字段 ATTDBA。

对于两个 CICS 系统之间的通信, CICS 不会将任何特殊意义附加到附加 FMH 中的去块算法字段。 对于大多数 CICS 应用程序,可以省略该选项。

有关 CICS 系统与另一子系统之间的通信,请参阅子系统提供的有关如何在连接 FMH 中使用交换单元字段的文档。

数据区中返回的值是半字二进制值。 仅使用低阶字节 ;SNA 定义的位的含义如下:
0-7   reserved - must be set to zero
8-15  X'00' - reserved
      X'01' - variable-length
              variable-blocked
      X'02' - reserved
      X'03' - reserved
      X'04' - chain of RUs
      X'05'through X'FF' - reserved
资源 (数据区)
对应于 LUTYPE6.1 连接 FMH 中的资源名称 ATTPRN。

对于两个 CICS 系统之间的通信, CICS 不会将任何重要信息附加到连接 FMH 中的资源名称。

有关 CICS 系统与另一子系统之间的通信,请参阅子系统提供的有关如何在连接 FMH 中使用资源名称字段的文档。

RPROCESS (data-area)
对应于 LUTYPE6.1 连接 FMH 中的返回过程名称 ATTRDPN。

对于两个 CICS 系统之间的通信, CICS 不会将重要信息附加到连接 FMH 中的返回进程名称。

有关 CICS 系统与另一子系统之间的通信,请参阅子系统提供的有关如何在连接 FMH 中使用返回进程名称字段的文档。

资源 (data-area)
对应于 LUTYPE6.1 连接 FMH 中的返回资源名称 ATTRPRN。

对于两个 CICS 系统之间的通信, CICS 与连接 FMH 中的返回资源名称无关。

有关 CICS 系统与另一子系统之间的通信,请参阅子系统提供的有关如何在连接 FMH 中使用返回资源名称字段的文档。

会话 (name)
指定会话 TCTTE 的符号标识 (1-4 个字符)。 此选项指定要使用的备用设施。

条件

62 CBIDERR
如果找不到所请求的连接头控制块,那么将发生此错误。

缺省操作: 异常终止任务。

16 INVREQ
在找到不正确的数据时发生。

缺省操作: 异常终止任务。

61 个 NOTALLOC
如果命令中指定的设施不是由应用程序拥有,那么将发生此情况。

缺省操作: 异常终止任务。