CICS FILE ENDBR

CICS File Readprev

Advertisements


End the browse of a file.


Syntax:

EXEC CICS 

     ENDBR FILE(file-name)
           REQID(data-value)
           SYSID(system-name)
          
END-EXEC.  

ENDBR command is safe when:

  • Defined as remote and the function shipped over an IPIC connection to a remote CICS region.
  • Defined as local VSAM.

ENDBR ends a browse on a file.

The file can be on a local or a remote CICS region.

For some cases, 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.


FILE(file-name)

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(system-name)

Specifies the name (1–4 characters) of the system the request is directed to.


Frequent ERROR 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.


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.


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.


CICS File Readprev

Advertisements