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