STARTBROWSE PROCESS
Start a browse of all processes of a specified type within the CICS® business transaction services system.
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
- 17 IOERR
- RESP2
values:
- 29
- The repository file is unavailable.
- 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:
- 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.