GETNEXT CONTAINER (CHANNEL)

Browse the containers associated with a channel.

Read syntax diagramSkip visual syntax diagram
GETNEXT CONTAINER

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

Conditions: END, ILLOGIC, TOKENERR

Description

GETNEXT CONTAINER (CHANNEL) returns the name of the next container associated with a channel.

Note:
  1. 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.
  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. 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.


dfhp4_getnextcontainerchannel.html | Timestamp icon Last updated: Thursday, 27 June 2019