Browse the containers associated with a BTS activity or process.
GETNEXT CONTAINER
>>-GETNEXT--CONTAINER(data-area)--BROWSETOKEN(data-value)------><
Conditions: END, ILLOGIC, TOKENERR
Description
GETNEXT CONTAINER returns the name of the next container associated with a BTS activity or
process. You can use the INQUIRE CONTAINER command to query the returned container.
Note: - You can use successive GETNEXT CONTAINER commands to retrieve the names of all the process's or
activity's containers that existed at the time the STARTBROWSE CONTAINER 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 process 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 command.
- CONTAINER(data-area)
- returns
the 16-character name of the next data-container.
Conditions
- 83 END
- RESP2
values:
- 2
- The are no more containers for this process or activity.
- 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.