STARTBROWSE CONTAINER (BTS)
Start a browse of the containers associated with a BTS activity or process.
STARTBROWSE CONTAINER >>-STARTBROWSE--CONTAINER---------------------------------------> >--+----------------------------------------------+-------------> +-ACTIVITYID(data-value)-----------------------+ '-PROCESS(data-value)--PROCESSTYPE(data-value)-' >--BROWSETOKEN(data-area)--------------------------------------><
Conditions: ACTIVITYERR, IOERR, NOTAUTH, PROCESSERR
This command is threadsafe.
Description
STARTBROWSE CONTAINER initializes
a browse token which can be used to identify the name of each data-container
associated with a specified BTS activity or process.
Note: The browse
token should be used only by the program that issues the STARTBROWSE
command.
If you do not specify the ACTIVITYI or the PROCESS option, CICS® examines the context (channel or BTS) of the request. If a current channel exists, the command is assumed to be a STARTBROWSE CONTAINER (CHANNEL) command. 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.
Options
- ACTIVITYID(data-value)
- specifies
the identifier (1–52 characters) of the activity whose containers
are to be browsed.
Typically, the identifier specified on this option has been returned on a previous GETNEXT ACTIVITY command.
- BROWSETOKEN(data-area)
- specifies a fullword binary data area, into which CICS will place the browse token.
- PROCESS(data-value)
- specifies
the name (1–36 characters) of the process whose containers are
to be browsed. Note: The containers associated with a process (process containers) are globally available throughout the process. They are not the same as the root activity's containers.
- PROCESSTYPE(data-value)
- specifies the process-type (1–8 characters) of the process named on the PROCESS option.
Conditions
- 109 ACTIVITYERR
- RESP2 values:
- 1
- The activity indicated by the ACTIVITYID option could not be found.
- 2
- None of the ACTIVITYID, PROCESS, or CHANNEL options were specified and there is no current channel and no current activity associated with the request.
- 29
- The repository file is unavailable.
- 30
- An input/output error has occurred on the repository file.
- 17 IOERR
- RESP2
values:
- 30
- An input/output error has occurred on the repository file.
- 70 NOTAUTH
- RESP2
values:
- 101
- The user associated with the issuing task is not authorized to access this resource in the way requested.
- 108 PROCESSERR
- RESP2 values:
- 3
- The process specified on the PROCESS option could not be found.
- 4
- The process-type specified on the PROCESSTYPE option could not be found.
- 13
- The request timed out. It may be that another task using this process-record has been prevented from ending.
