ENDBR
End the browse of a file.
Conditions: FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ, NOTAUTH, SYSIDERR
- Defined as remote and the command is function shipped over an IPIC connection to a remote CICS® region.
- Defined as either local VSAM or RLS.
- Defined as remote and the command is function shipped over a non-IPIC connection.
- Defined as a shared data table, coupling facility data table, or BDAM file.
Description
ENDBR ends a browse on a file or data table on a local or a remote CICS region.
The UPDATE option is available within browse so we recommend that you use this because otherwise you would need to issue an ENDBR command before using READ UPDATE to avoid self deadlock abends. We recommend issuing an ENDBR before syncpoint for similar reasons.
If STARTBR was not successful, you do not need to issue ENDBR.
Options
- FILE(filename)
- Specifies
the name of the file being browsed.
If SYSID is specified, the data set to which this file refers is assumed to be on a remote system irrespective of whether the name is defined to CICS. Otherwise, the resource definition for the file is used to find out whether the data set is on a local or a remote system.
- REQID(data-value)
- Specifies a unique (halfword binary value) request identifier for a browse, used to control multiple browse operations on a data set. If this option is not specified, a default value of zero is assumed.
- SYSID(systemname)
- Specifies the name (1–4 characters) of the system the request is directed to.
Conditions
- 12 FILENOTFOUND
- RESP2
values:
- 1
- The name referred to in the FILE option is not defined to CICS.
Default action: terminate the task abnormally.
- 21 ILLOGIC (VSAM)
- RESP2
values:
- 110
- A VSAM error occurs that is not in one of the other CICS response categories.
See EIBRCODE in the EXEC interface block; for details, see EIB fields.
Default action: terminate the task abnormally.
- 16 INVREQ
- RESP2
values:
- 35
- The REQID, SYSID, or file name does not match that of any successful STARTBR command.
Default action: terminate the task abnormally.
- 17 IOERR
- RESP2
values:
- 120
- There is an I/O error during the file control operation. An I/O
error is any unusual event that is not covered by a CICS condition.
For VSAM files, IOERR usually indicates a hardware error. Further information is available in the EXEC interface block; for details, see EIB fields.
Default action: terminate the task abnormally.
- 54 ISCINVREQ
- RESP2
values:
- 70
- The remote system indicates a failure that does not correspond to a known condition.
Default action: terminate the task abnormally.
- 70 NOTAUTH
- RESP2
values:
- 101
- A resource security check has failed on FILE(filename).
Default action: terminate the task abnormally.
- 53 SYSIDERR
- RESP2
values:
- 130
- The SYSID option specifies a name that is neither the local system nor a remote system that is defined by a CONNECTION or IPCONN definition. SYSIDERR also occurs when the link to the remote system is known but unavailable. In the case of an IPCONN, SYSIDERR occurs if the link is known but either the local or remote systems do not support file control commands that are function shipped using IP interconnectivity.
Default action: terminate the task abnormally.