GETNEXT CONTAINER

Browse the containers associated with a channel, or with a BTS activity or process. Start of changeAlthough this command appears in the Application Programming set of topics, to use it you must specify the system programming (SP) parameter in the EXEC statement of the translate step of your compile job. See Technote 1265081 for further information.End of change

Read syntax diagramSkip visual syntax diagram
GETNEXT CONTAINER

>>-GETNEXT--CONTAINER(data-area)--BROWSETOKEN(data-value)------><

Conditions: END, ILLOGIC, TOKENERR

Description

Start of changeGETNEXT CONTAINER returns the name of the next container associated with a channel, or with a BTS activity or process.End of change You can use the INQUIRE CONTAINER command to query the returned container.

Note: Start of change
  1. You can use successive GETNEXT CONTAINER commands to retrieve the names of all the channel'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 channel or activity after the STARTBROWSE command is executed may or may not be returned.
  3. Start of changeThe order in which containers are returned is undefined.End of change
End of change

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

END
RESP2 values:
2
There are no more resource definitions of this type.
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.
TOKENERR
RESP2 values:
3
The browse token is not valid.