STARTBROWSE CONTAINER (CHANNEL)
Start a browse of the containers associated with a channel.
Description
STARTBROWSE CONTAINER (CHANNEL) initializes a browse token which can be used to identify the name
of each data-container associated with a specified channel.
Note: The browse token should be used
only by the program that issues the STARTBROWSE command.
If you do not specify the CHANNEL option, CICS® examines the channel of the request. If a current channel exists, its containers are browsed. If no current channel exists, the command is assumed to be a STARTBROWSE CONTAINER (BTS) command.
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 either the current channel or 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.
If this option is not specified, and the current context is channel, the current channel's containers are browsed.
The order in which containers are returned is undefined.
Conditions
- 122 CHANNELERR
- RESP2 values:
- 2
- The channel specified on the CHANNEL option could not be found.