ENDBR

结束浏览文件。

ENDBR

读取语法图跳过可视语法图ENDBRFILE( filename)REQID( data-value)SYSID( 系统名称)

条件: FILENOTFOUND , ILLOGIC , INVREQ , IOERR , ISCINVREQ , NOTAUTH 和 SYSIDERR

如果此命令所引用的文件是:
  • 定义为远程,该命令是通过 IPIC 连接提供到远程 CICS® 区域的功能。
  • 定义为本地 VSAM 文件, VSAM RLS 文件或耦合设施数据表。
如果此命令所引用的文件是:
  • 定义为远程,并且该命令是通过非 IPIC 连接提供的功能。
  • 定义为 NSR。
  • 定义为共享数据表或 BDAM 文件。

描述

ENDBR 结束对本地或远程 CICS 区域上的文件或数据表的浏览。

在浏览中提供了 UPDATE 选项,因此建议您使用此选项,否则需要在使用 READ UPDATE 之前发出 ENDBR 命令以避免自死锁异常终止。 出于类似原因,建议在同步点之前发出 ENDBR。

如果 STARTBR 未成功,那么无需发出 ENDBR。

选项

FILE (filename)
指定要浏览的文件的名称。

如果指定了 SYSID ,那么假定此文件所引用的数据集位于远程系统上,而不考虑是否对 CICS定义了该名称。 否则,将使用文件的资源定义来确定数据集是在本地系统上还是在远程系统上。

REQID (data-value)
指定用于浏览的唯一 (半字二进制值) 请求标识,用于控制数据集上的多个浏览操作。 如果未指定此选项,那么将采用缺省值 0。
SYSID (systemname)
指定请求所指向的系统的名称 (1-4 个字符)。

条件

12 个 FILENOTFOUND
RESP2 值:
1
FILE 选项中引用的名称未定义到 CICS。

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

21 ILLOGIC (VSAM)
RESP2 值:
110
发生不在其他某个 CICS 响应类别中的 VSAM 错误。

请参阅 EXEC 接口块中的 EIBRCODE; 有关详细信息,请参阅 EIB 字段

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

16 INVREQ
RESP2 值:
35
REQID , SYSID 或文件名与任何成功的 STARTBR 命令的名称不匹配。

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

17 IOERR
RESP2 值:
120
文件控制操作期间发生 I/O 错误。 I/O 错误是 CICS 条件未涵盖的任何异常事件。

对于 VSAM 文件, IOERR 通常指示硬件错误。 EXEC 接口块中提供了更多信息; 有关详细信息,请参阅 EIB 字段

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

54 ISCINVREQ
RESP2 值:
70
远程系统指示不符合已知条件的故障。

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

70 NOTAUTH
RESP2 值:
101
对 FILE (filename) 执行资源安全性检查失败。

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

53 个 SYSIDERR
RESP2 值:
130
SYSID 选项指定的名称既不是本地系统,也不是由 CONNECTION 或 IPCONN 定义定义的远程系统。 当到远程系统的链接已知但不可用时,也会发生 SYSIDERR。 对于 IPCONN ,如果链路已知,但本地或远程系统不支持使用 IP 互连交付的功能的文件控制命令,那么将发生 SYSIDERR。

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