5
6
7
The command is issued for the program that contains the RELEASE command.
The command is issued for a program that is not loaded.
The command is issued for a program that was loaded, without the
HOLD option, by another task.
Default action: terminate the task abnormally.
NOTAUTH
occurs when a resource security check has failed on PROGRAM(name).
Default action: terminate the task abnormally.
PGMIDERR
RESP2 values:
1
A program, table, or mapset does not have an installed resource definition.
2
3
9
A program, table, or mapset is disabled.
A program, table, or mapset cannot be loaded.
The installed program definition is for a remote program.
Default action: terminate the task abnormally.
Examples
The following example shows how to release an application program, called
PROG4, loaded in response to a LOAD command:
EXEC CICS RELEASE PROGRAM(’PROG4’)
RESETBR
Specify where you want a browse to be repositioned.
(1)
RESETBR FILE (
name
) RIDFLD (
data-area
)
REQID (
data-value
) KEYLENGTH (
data-value
)
RBA
RRN
GENERIC
SYSID (
name
)
GTEQ
EQUAL
Notes:
1
DATASET is also accepted, but FILE is the preferred term (see “DATASET option” on page 311).
Conditions:
FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ, NOTAUTH, NOTFND, SYSIDERR
418
CICS for iSeries Application Programming Guide V5
Description
The RESETBR command specifies, during a browse, the record in a file, where you want the browse to be repositioned. The file may be on a local or a remote system.
When browsing a file, you can use this command not only to reposition the browse
(which can be achieved more simply by modifying the RIDFLD data area on a
READNEXT or READPREV command), but also to change its characteristics from those specified on the previous STARTBR command, without ending the browse.
The characteristics that may be changed are those specified by the GENERIC and
GTEQ options. The RBA and RRN characteristics must not be changed by the
RESETBR command.
Options
EQUAL
specifies that the search is satisfied only by a record having the same key
(complete or generic) as that specified in the RIDFLD option.
FILE(
name
)
specifies the name of the file to be accessed. The name must be alphanumeric, up to 8 characters long, and must have been defined in the file control table
(FCT) unless the SYSID option specifies a remote system.
If a nonlocal SYSID is specified, the underlying file is assumed to be on a remote system irrespective of whether the name is defined in the local FCT.
Otherwise, the FCT entry is used to determine whether the underlying file is on a local or a remote system.
GENERIC
specifies that the search key is a generic key whose length is specified in the
KEYLENGTH option. Use this option only with a KSDS or a path over a KSDS or ESDS. The search for a record is satisfied when a record is found that has the same starting characters (generic key) as those specified.
GTEQ
specifies that if the search for a record having the same key (complete or generic) as that specified in the RIDFLD option is unsuccessful, the first record having a greater key satisfies the search. Use this option only with a KSDS or a path over a KSDS or ESDS.
KEYLENGTH(
data-value
)
specifies as a halfword binary value the length of the key supplied in the
RIDFLD option. If a specified KEYLENGTH value differs from the length defined for the underlying file and the operation is not generic, the INVREQ condition occurs.
The INVREQ condition also occurs if you specify GENERIC, and the
KEYLENGTH value is not less than that defined for the file.
If KEYLENGTH(0) is used with the object of positioning to the first record in the file, the GTEQ option must also be specified; otherwise, the NOTFND condition may occur.
Note that GTEQ is the default for RESETBR.
RBA
specifies that the record identification field specified in the RIDFLD option contains a relative byte address. Use this option only when browsing an ESDS directly. The RIDFLD value can be from 0 upward.
Chapter 32. Application programming commands - reference
419
REQID(
data-value
)
specifies as a halfword binary value a unique request identifier for the browse; it is used to control multiple browse operations on a file. If this option is not specified, a default value of zero is assumed.
RIDFLD(
data-area
)
specifies the record identification field. The contents can be a key, a relative byte address, or a relative record number. For a relative byte address or a relative record number, the format of this field must be fullword binary.
RRN
specifies that the record identification field specified in the RIDFLD option contains a relative record number. Use this option only when browsing an
RRDS. The RIDFLD value can be from 1 upward.
SYSID(
name
)
specifies the name of the system to which the request is directed. The name can be up to 4 characters long.
If you specify SYSID, and omit both RBA and RRN, you must also specify
KEYLENGTH; it cannot be found in the FCT.
Exception Conditions
Note:
RESP2 values are not set for files that are on remote systems.
FILENOTFOUND
RESP2 values:
1
The name specified in the FILE option cannot be found in the FCT.
Default action: Terminate the task abnormally.
ILLOGIC
RESP2 values:
110
There is an error that does not fall within one of the other CICS response categories. (Further information is available in the EIBRCODE
field; refer to Appendix A, “EXEC interface block,” on page 529 for
details.)
Default action: Terminate the task abnormally.
INVREQ
RESP2 values:
25
The KEYLENGTH and GENERIC options are specified, and the length specified in the KEYLENGTH option is greater than or equal to the length of a full key.
26
The KEYLENGTH option is specified (but the GENERIC option is not specified), and the specified length differs from the length defined for the underlying file.
36
42
A RESETBR command is issued for a file for which no previous
STARTBR command has been successfully issued.
The KEYLENGTH and GENERIC options are specified, and the length specified in the KEYLENGTH option is less than zero.
Default action: Terminate the task abnormally.
420
CICS for iSeries Application Programming Guide V5
