RESETBR
复位浏览开始。
- 定义为远程，该命令是通过 IPIC 连接提供到远程 CICS® 区域的功能。
- 定义为本地 VSAM 文件， VSAM RLS 文件或耦合设施数据表。
- 定义为远程，并且该命令是通过非 IPIC 连接提供的功能。
- 定义为 NSR。
- 定义为共享数据表或 BDAM 文件。
描述
RESETBR 在浏览期间指定本地或远程系统上的文件或数据表中的记录，您希望在该记录中重新定位浏览。
当浏览 VSAM 文件或数据表时，您可以使用 RESETBR 命令来重新定位浏览 (也可以通过在 READNEXT 或 READPREV 命令上修改 RIDFLD 数据区来实现) ，还可以从 STARTBR 上指定的浏览特征中更改浏览特征，而不结束浏览。 可更改的特征由 GENERIC ， GTEQ 和 RBA 选项指定。
在浏览 BDAM 文件时，您可以随时包含此命令，然后再发出任何其他浏览命令。 它类似于 ENDBR-STARTBR 序列 (但功能较少) ，并通过使用 READNEXT 命令为 BDAM 用户提供可供 VSAM 用户使用的跳过顺序功能。
选项
- 等于
- 指定仅通过具有与 RIDFLD 选项中指定的键相同的键 (完整或通用) 的记录来满足搜索。
- FILE (filename)
- (VSAM 和数据表) 指定要访问的文件的名称。
如果指定了 SYSID ，那么假定此文件所引用的数据集位于远程系统上，而不考虑是否对 CICS定义了该名称。 否则，将使用资源定义来确定数据集是在本地系统上还是在远程系统上。
- 通用
- (VSAM KSDS ，路径或数据表) 指定搜索键是其长度在 KEYLENGTH 选项中指定的通用键。 当找到的记录的起始字符 (通用键) 与指定的开始字符 (通用键) 相同时，将满足对记录的搜索。
- GTEQ
- (VSAM 和数据表) 指定如果搜索具有与 RIDFLD 选项中指定的相同键 (完整或通用) 的记录失败，那么将检索具有更大键的第一个记录。 仅将此选项与键控或 RRN 配合使用。
- KEYLENGTH (data-value)
- 指定 RIDFLD 选项中指定的键的长度 (半字二进制) ，除非指定了 RBA 或 RRN ，在这种情况下， KEYLENGTH 无效。
如果指定了 GENERIC ，那么必须指定此选项，并且每当指定密钥时都可以指定此选项。 如果指定的长度与为数据集定义的长度不同，并且操作不是通用的，那么会出现 INVREQ 条件。
如果 RESETBR 命令指定 GENERIC ，并且 KEYLENGTH 值不小于 VSAM 定义中指定的值，那么也会发生 INVREQ 条件。
如果将 KEYLENGTH (0) 与读取数据集中的第一条记录的对象配合使用，那么还必须指定 GTEQ 选项。 如果显式指定了 EQUAL ，或者缺省情况下指定了 KEYLENGTH (0) ，那么 STARTBR 的结果不可预测。
对于远程文件，可以在 FILE 定义中指定 KEYLENGTH。 如果未在其中定义 KEYLENGTH ，并且未在应用程序中指定 KEYLENGTH ，并且键的长度超过 4 个字符，那么缺省值为 4。
- RBA
- (VSAM KSDS 或 ESDS 基本数据集，或者仅 CICS维护的数据表，而不是路径) 指定 RIDFLD 选项中指定的记录标识字段包含相对字节地址。 仅当浏览 ESDS 或 KSDS 库并使用相对字节地址而不是密钥来标识记录时，才使用此选项。不能将 RBA 用于:
- 用户维护的数据表
- 耦合设施数据表
- 以 RLS 访问方式打开的任何 KSDS 文件
- 使用扩展寻址的 KSDS 文件
- REQID (data-value)
- 将用于控制数据集上的多个浏览操作的浏览的唯一请求标识指定为半字二进制值。 如果未指定此选项，那么将采用缺省值 0。
- RIDFLD (数据区)
- 指定记录标识字段。 内容可以是键，相对字节地址或相对记录号 (对于 VSAM 数据集) ，也可以是块引用，物理键和去块参数 (对于 BDAM 数据集)。 对于相对字节地址或相对记录号，此字段的格式必须是全字二进制。 对于相对字节地址， RIDFLD 值可以大于或等于零。 对于相对记录号， RIDFLD 值可以大于或等于 1。
对于 VSAM ，完整记录标识 X'FF '指示要将浏览定位在数据集的末尾，以准备使用 READPREV 命令进行向后浏览。
- RRN
- (VSAM RRDS) 指定 RIDFLD 选项中指定的记录标识字段包含相对记录号。
- SYSID (systemname)
- 指定请求所定向到的系统的名称。
如果指定 SYSID 并同时省略 RBA 和 RRN ，那么还必须指定 KEYLENGTH; 在资源定义中找不到 KEYLENGTH。
- XRBA
- 指定 RIDFLD 选项中指定的记录标识字段包含扩展的相对字节地址。 当浏览 ESDS 扩展寻址数据集中的记录时，应使用此选项。
除非关联的 STARTBR 命令也指定了 XRBA ，否则不能在 RESETBR 命令上指定 XRBA。
条件
- 12 个 FILENOTFOUND
- RESP2 值：
- 1
- 未对 CICS定义 FILE 选项中引用的文件名。
缺省操作: 异常终止任务。
- 21 ILLOGIC
- RESP2 值 VSAM):
- 110
- 发生不在其他某个 CICS 响应类别中的 VSAM 错误。
请参阅 EXEC 接口块中的 EIBRCODE; 有关详细信息，请参阅 EIB 字段。
缺省操作: 异常终止任务。
- 16 INVREQ
- RESP2 值：
- 25
- 指定了 KEYLENGTH 和 GENERIC 选项，并且在 KEYLENGTH 选项中指定的长度大于或等于完整键的长度。
- 26 日
- 指定了 KEYLENGTH 选项 (但未指定 GENERIC 选项) ，并且指定的长度不等于为此文件引用的数据集定义的长度。
- 36
- REQID ， SYSID 或文件名与任何成功的 STARTBR 命令的名称不匹配。
- 37
- 已更改用于在浏览期间访问数据集的记录标识类型 (例如，键或相对字节地址)。 不能在 STARTBR 上指定一种类型的寻址，也不能在 RESETBR 上指定另一种类型的寻址。
- 42
- 指定了 KEYLENGTH 和 GENERIC 选项，并且在 KEYLENGTH 选项中指定的长度小于零。
- 44
- 该命令不符合用户维护或耦合设施数据表的 RESETBR 格式; 例如，指定了 RBA。
- 51
- 以 RLS 方式访问的 KSDS 文件的 RESETBR 命令指定 RBA 关键字。 RLS 方式不支持 RBA 访问 KSDS 数据集。
缺省操作: 异常终止任务。
- 17 IOERR
- RESP2 值：
- 120
- 文件控制操作期间发生 I/O 错误。 I/O 错误是 CICS 条件未涵盖的任何异常事件。
对于 VSAM 文件， IOERR 通常指示硬件错误。 EXEC 接口块中提供了更多信息; 有关详细信息，请参阅 EIB 字段。
对于耦合设施数据表， IOERR 指示从耦合设施访问返回的响应不正确。
缺省操作: 异常终止任务。
- 54 ISCINVREQ
- RESP2 值：
- 70
- 远程系统指示不符合已知条件的故障。
缺省操作: 异常终止任务。
- 70 NOTAUTH
- RESP2 值：
- 101
- 对 FILE (filename) 执行资源安全性检查失败。
缺省操作: 异常终止任务。
- 13 NOTFND
- RESP2 值：
- 80
- 尝试根据提供的搜索参数检索记录失败。
如果具有 KEYLENGTH ($TAG1) 的通用 RESETBR 指定了 EQUAL 选项，那么也会发生 NOTFND。
- 81
- 指定了 XRBA ，并且 RIDFLD 的值大于 4 GB ，但数据集不是扩展寻址 ESDS。
缺省操作: 异常终止任务。
- 53 个 SYSIDERR
- RESP2 值：
- 130
- SYSID 选项指定的名称既不是本地 CICS 区域，也不是远程系统 (由 CONNECTION 定义定义)。 当与远程系统的链路关闭时，也会发生 SYSIDERR
- 131
- 对于耦合设施数据表，与耦合设施数据表服务器的连接已失败。 这可能是因为服务器本身已发生故障，或者服务器可用，但 CICS 未能连接到该服务器。
- 132
- 针对不再存在的耦合设施数据表发出 RESETBR ，这可能是因为耦合设施发生故障，在这种情况下，耦合设施数据表服务器也会发生故障。 有关重新启动耦合设施数据表服务器和重新装入表的信息，请参阅 设置和运行耦合设施数据表服务器 。
缺省操作: 异常终止任务。