Start a browse of the child activities of a BTS activity, or of the descendant activities of a process.
STARTBROWSE ACTIVITY >>-STARTBROWSE ACTIVITY-----------------------------------------> >--+----------------------------------------------+-------------> +-ACTIVITYID(data-value)-----------------------+ '-PROCESS(data-value)--PROCESSTYPE(data-value)-' >--BROWSETOKEN(data-area)--------------------------------------><
Conditions: ACTIVITYERR, NOTAUTH, PROCESSERR
STARTBROWSE ACTIVITY initializes a browse token which can be used to identify either:
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.
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.