STARTBROWSE PROCESS

Start a browse of all processes of a specified type within the CICS business transaction services system. Start of changeAlthough 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.End of change

Read syntax diagramSkip visual syntax diagram
STARTBROWSE PROCESS

>>-STARTBROWSE--PROCESS -PROCESSTYPE(data-value)---------------->

>--BROWSETOKEN(data-area)--------------------------------------><

Conditions: IOERR, NOTAUTH, PROCESSERR

Description

STARTBROWSE PROCESS initializes a browse token which can be used to identify each process of a specified type within the CICS business transaction services system.

When you add a process to the BTS system, you use the PROCESSTYPE option of the DEFINE PROCESS command to categorize it. You specify the name of a PROCESSTYPE resource definition, which in turn names a CICS® file definition that maps to a physical VSAM data set (the repository) on which details of the process and its constituent activities will be stored. (Records for multiple process-types can be stored on the same repository data set.)

The STARTBROWSE PROCESS command enables you to start a browse of processes of a specified type.

Options

BROWSETOKEN(data-area)
specifies a fullword binary data area, into which CICS will place the browse token.
PROCESSTYPE(data-value)
specifies the process-type (1–8 characters) of the processes to be browsed.

Conditions

IOERR
RESP2 values:
29
The repository file is unavailable.
30
An input/output error has occurred on the repository file.
NOTAUTH
RESP2 values:
101
The user associated with the issuing task is not authorized to access this resource in the way requested.
PROCESSERR
RESP2 values:
1
No processes of this process-type could 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.