RESETBR Command in cics

The RESETBR command EXEC CICS                 RESETBR DATASET(file-name)                RIDFLD(data-area)                [ RRN | RBA ] ...

The RESETBR command

EXEC CICS

                RESETBR DATASET(file-name)

               RIDFLD(data-area)

               [ RRN | RBA ]

               [ GTEQ | EQUAL ]

                [ KEYLENGTH(data-value) [ GENERIC ] ]

                [ REQID(data-value) ]

                 [ SYSID(name) ]

END-EXEC

Options

DATASET Specifies the file name as defined using CEDA DEFINE FILE(file-name) GROUP(group-name)

RIDFLD For a KSDS specifies the key of the record where the browse

Will start. For a RRDS it specifies the relative record number and for an ESDS it specifies the RBA (PIC S9(8) COMP). If RRN or RBA is not specified, key is assumed.

RRN Specifies that the file is a RRDS and the RIDFLD should be interpreted as a relative record number.

RBA Specifies that the file is an ESDS and the RIDFLD should be interpreted as a Relative Byte Address.

GTEQ Specifies that the browse operation will start with a record whose key is greater than or equal to the RIDFLD.

EQUAL Specifies that the browse operation will start with a record whose key is equal to the RIDFLD.

GENERIC Specifies that only a part of the key (left part, whose length is indicated by KEYLENGTH) is supplied in the RIDFLD. The first record that matches this key is the point of start of the browse.

KEYLENGTH is a PIC S9(4) COMP field that specifies the length of the generic key. The value must be less than the length of the key defined for the file. Also needed if SYSID is specified. Not valid if RBA or RRN is specified.

REQID Specifies a binary half word or literal value that identifies this browse operation. Useful when more than one browse is started on same file. You can then explicitly direct further browse operations to a specific operation.

SYSID Specifies a 1 to 4 character connection name that represents a remote system.

Conditions

The RESP field can have the following values:-

DISABLED file is disabled using CEMT SET

DSIDERR File is not defined to CICS

ILLOGIC A serious VSAM error occurred

INVREQ The browse operation was not started on this file or the KEYLENGTH is invalid.

IOERR An IOERR occurred

NOTAUTH The transactions definition specified resource Checking and the operator is not authorized to Access the data set.

NOTFND The specified record could not be located.

NOTOPEN the data set is not open

SYSIDERR The system identified by SYSID could not be found.

Notes

• You can issue RESETBR only after a STARTBR.

• To browse via a alternate index specify a path name for the data set when you define the file.

• You can skip records when browsing simply by changing the RIDFLD value when you browse using READNEXT or READPREV on the file. This is called skip sequential processing. This is an alternative to using RESETBR.

• RESETBR has the same effect as issuing an ENDBR and a STARTBR. However if you take this path, the VSAM resources (string) is released and then reacquired when you issue STARTBR. For this reason RESETBR is more efficient. However, your program could go into a string wait!!.