STARTBROWSE CONTAINER (BTS)

Start a browse of the containers associated with a BTS activity or process.

Read syntax diagramSkip visual syntax diagram
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.


dfhp4_startbrowsecontainer.html | Timestamp icon Last updated: Monday, 5 June 2017