GETNEXT CONTAINER (BTS)

Browse the containers associated with a BTS activity or process.

GETNEXT CONTAINER

Read syntax diagramSkip visual syntax diagramGETNEXTCONTAINER( 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:
  1. 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.
  2. 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.
  3. 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.