GETNEXT CONTAINER (CHANNEL)
Browse the containers associated with a channel.
Description
GETNEXT CONTAINER (CHANNEL) returns the name of the next container associated with a channel.
Note:
- You can use successive GETNEXT CONTAINER (CHANNEL) commands to retrieve the names of all the channel's containers that existed at the time the STARTBROWSE CONTAINER (CHANNEL) command was executed. However, the names of any containers that are deleted after the STARTBROWSE and before they have been returned by a GETNEXT are not returned.
- The names of any containers that are created on (or moved to) this channel or activity after the STARTBROWSE command is executed may or may not be returned.
- The order in which containers are returned is undefined.
Options
- BROWSETOKEN(data-value)
- specifies, as a fullword binary value, a browse token returned on a previous STARTBROWSE CONTAINER (CHANNEL) command.
- CONTAINER(data-area)
- returns the 16-character name of the next data-container.
Conditions
- 83 END
- RESP2 values:
- 2
- There are no more containers.
- 21 ILLOGIC
- RESP2 values:
- 1
- The value specified in the BROWSETOKEN option matches a current browse token, but not one that is being used for a browse of containers.
- 112 TOKENERR
- RESP2 values:
- 3
- The browse token is not valid.