ENDBR

End browse of a file.

Read syntax diagramSkip visual syntax diagram
ENDBR

>>-ENDBR--FILE(filename)--+-------------------+----------------->
                          '-REQID(data-value)-'   

>--+-------------------+---------------------------------------><
   '-SYSID(systemname)-'   

Conditions: FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ, NOTAUTH, SYSIDERR

 

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 need not 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 in the FCT. Otherwise, the FCT entry 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

FILENOTFOUND
RESP2 values:
1
The name referred to in the FILE option cannot be found in the FCT.

Default action: terminate the task abnormally.

ILLOGIC (VSAM)
RESP2 values:
110
A VSAM error occurs that does not fall within one of the other CICS response categories.

(See EIBRCODE in the EXEC interface block; refer to EXEC interface block for details.)

Default action: terminate the task abnormally.

INVREQ
RESP2 values:
35
The REQID, if any, does not match that of any successful STARTBR command.

Default action: terminate the task abnormally.

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 normally indicates a hardware error.

(Further information is available in the EXEC interface block; see EXEC interface block for details.)

Default action: terminate the task abnormally.

ISCINVREQ
RESP2 values:
70
The remote system indicates a failure that does not correspond to a known condition.

Default action: terminate the task abnormally.

NOTAUTH
RESP2 values:
101
A resource security check has failed on FILE(filename).

Default action: terminate the task abnormally.

SYSIDERR
RESP2 values:
130
The SYSID option specifies a name that is neither the local system nor a remote system (made known to CICS by defining a CONNECTION). SYSIDERR also occurs when the link to the remote system is closed.

Default action: terminate the task abnormally.