EXEC CICS STARTBROWSE CONTAINER command (EXCI)
Start a browse of the containers that are associated with a channel.
Description
STARTBROWSE CONTAINER (EXCI) initializes a browse token that can be used to identify the name of each data-container that is associated with a specified channel.
Note: The browse token should be used only by the program that issues the STARTBROWSE command.
The order in which containers are returned is undefined and might change. As best practice, applications should not rely on the order of returned containers.
Options
- BROWSETOKEN(data-area)
- Specifies a fullword binary data area, into which CICS® will place the browse token.
- CHANNEL(data-value)
- Specifies the name (1-16 characters) of the channel whose containers are to be browsed. This must be the name of a channel created by the program that issues the STARTBROWSE CONTAINER command. You can specify the channel name DFHTRANSACTION to use the transaction channel.
The order in which containers are returned is undefined.
- RETCODE(data-area)
-
Specifies a 20-byte area into which the external CICS
interface places return information. This area is formatted into
five 1–word fields. This command
will return information in the first two words. These words will
contain the RESP and RESP2 codes.
The other three words will be set to nulls.
- RESP
- The primary response code, which indicates whether the external CICS interface STARTBROWSE CONTAINER command caused an exception condition during its execution.
- RESP2
- The secondary response code that further qualifies, where necessary, some of the conditions that are raised in the RESP parameter.
Conditions
- 122 CHANNELERR
- RESP2 values:
- 2
- The channel specified on the CHANNEL option could not be found.