STARTBROWSE ACTIVITY

Start a browse of the child activities of a BTS activity, or of the descendant activities of a process.

STARTBROWSE ACTIVITY

Read syntax diagramSkip visual syntax diagramSTARTBROWSE ACTIVITYACTIVITYID( data-value)PROCESS( data-value)PROCESSTYPE( data-value)BROWSETOKEN( data-area)

Conditions: ACTIVITYERR, NOTAUTH, PROCESSERR

Description

STARTBROWSE ACTIVITY initializes a browse token which can be used to identify either:

  • Each child activity of a specified BTS parent activity
  • Each descendant activity of a specified BTS process.

If you specify the ACTIVITYID option, the children (but not the grandchildren nor other descendants) of the specified activity can be browsed. This option takes as its argument an activity identifier. This identifier may, for example, have been returned on a previous GETNEXT ACTIVITY command. If it was, the command starts a browse of child activities one level down the activity tree.

If you specify the PROCESS and PROCESSTYPE options, all the descendant activities of the specified process can be browsed. This type of browse is known as a flat browse. A flat browse is one which can return every descendant activity exactly once. A parent activity is always returned before its children. The value returned in the LEVEL option of a GETNEXT ACTIVITY command indicates the depth at which the activity lies in the process's activity-tree, with the root activity having a level of zero.

If you specify neither the ACTIVITYID nor the PROCESS and PROCESSTYPE options, the children of the current activity can be browsed.

Options

ACTIVITYID(data-value)
specifies the identifier (1–52 characters) of the activity whose child activities are to be browsed.

Typically, the activity identifier specified on this option has been returned on a previous GETNEXT ACTIVITY command (or, in the case of a root activity, on a GETNEXT PROCESS command). ACTIVITYID allows you to start a browse of child activities one level down the activity tree.

If you omit both this and the PROCESS option, the children of the current activity are browsed.

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 descendant activities are to be browsed.
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
Because neither the ACTIVITYID nor the PROCESS options were specified, a browse of the children of the current activity was implied—but there is no current activity associated with the request.
19
The request timed out. It may be that another task using this activity-record has been prevented from ending.
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 the file whose data set contains the records to be browsed.
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.