Start a browse of events known to a BTS activity.
Although 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.

STARTBROWSE EVENT
>>-STARTBROWSE--EVENT--BROWSETOKEN(data-area)------------------->
>--+------------------------+----------------------------------><
'-ACTIVITYID(data-value)-'
Conditions: ACTIVITYERR, INVREQ, IOERR, NOTAUTH
Description
STARTBROWSE EVENT initializes a browse
token which can be used to identify each event (including each sub-event and
system event) that is within the scope of a specified BTS activity. If you
do not specify an activity, events within the scope of the current activity
are browsed.
A browse started by STARTBROWSE EVENT returns:
- Atomic events. An atomic event returned on this command may or may not
be included in the predicate of a composite event—that is, it may or may not
be a sub-event.
- Composite events.
- System events.
Options
- ACTIVITYID(data-value)
- specifies
the identifier (1–52 characters) of the activity whose events are to be browsed.
If you omit this option, events known to the current activity are browsed.
- BROWSETOKEN(data-area)
- specifies
a fullword binary data area, into which CICS® will place the browse token.
Conditions
- ACTIVITYERR
- RESP2
values:
- 1
- The activity identifier specified on the ACTIVITYID option does not relate
to any activity that is within the scope of this task.
- 29
- The repository file is unavailable.
- 30
- An input/output error has occurred on the repository file.
- INVREQ
- RESP2
values:
- 1
- There is no current activity within the scope of this task.
- IOERR
- RESP2
values:
- 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.