Start a browse of the containers associated with a
channel
, or with a BTS activity or process.
Although 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.
STARTBROWSE CONTAINER >>-STARTBROWSE--CONTAINER---------------------------------------> >--+----------------------------------------------+-------------> +-ACTIVITYID(data-value)-----------------------+ +-PROCESS(data-value)--PROCESSTYPE(data-value)-+ '-CHANNEL(data-value)--------------------------' >--BROWSETOKEN(data-area)--------------------------------------><
Conditions: ACTIVITYERR, CHANNELERR,
IOERR,
NOTAUTH, PROCESSERR
If
you specify none of the ACTIVITYID, PROCESS, or CHANNEL options, CICS examines
the context (channel or BTS) of the request. If a current channel exists,
its containers are browsed. If a current activity exists, its containers are
browsed. If neither exists, an ACTIVITYERR 2 is raised: see the description
of the ACTIVITYERR condition, below.
Typically, the identifier specified on this option has been returned on a previous GETNEXT ACTIVITY command.
If this option is not specified, and the current context is channel, the current channel's containers are browsed.
The order in which containers
are returned is undefined.