EXEC CICS GETNEXT CONTAINER command (EXCI)

Browse the containers that are associated with a channel.

GETNEXT CONTAINER (EXCI)

Read syntax diagramSkip visual syntax diagramGETNEXTCONTAINER( data-area)BROWSETOKEN( data-value)RETCODE( data-area)

Conditions: END, TOKENERR

Description

GETNEXT CONTAINER (EXCI) returns the name of the next container that is associated with a channel.

Note:
  1. You can use successive GETNEXT CONTAINER (EXCI) commands to retrieve the names of all the channel's containers that existed when the STARTBROWSE CONTAINER (EXCI) command was run. However, the names of any containers that are deleted after the STARTBROWSE command and before they were returned by a GETNEXT command 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 run might, or might not, be returned.
  3. The order in which containers are returned is undefined and might change. As best practice, applications should not rely on the order of returned containers.

Options

BROWSETOKEN(data-value)
Specifies, as a fullword binary value, a browse token returned on a previous STARTBROWSE CONTAINER (EXCI) command.
CONTAINER(data-area)
Returns the 16-character name of the next data-container.
RETCODE(data-area)
Specifies a 20-byte area into which the external CICS® interface places return information. This area is formatted into five 1–word fields. This command will return information in the first two words. These words will contain the RESP and RESP2 codes. The other three words will be set to nulls.
RESP
The primary response code, which indicates whether the external CICS interface GETNEXT CONTAINER command caused an exception condition during its execution.
RESP2
The secondary response code that further qualifies, where necessary, some of the conditions that are raised in the RESP parameter.

Conditions

83 END
RESP2 values:
2
There are no more containers.
112 TOKENERR
RESP2 values:
3
The browse token is not valid.