End the browse of a file.
ENDBR
>>-ENDBR--FILE(filename)--+-------------------+----------------->
'-REQID(data-value)-'
>--+-------------------+---------------------------------------><
'-SYSID(systemname)-'
Conditions: FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ,
NOTAUTH, SYSIDERR
This command is threadsafe if the file to which it refers
is:
- 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.
This command is not threadsafe if the file to which it
refers is:
- 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.