GETNEXT ACTIVITY
Browse the child activities of a BTS activity, or the descendant activities of a BTS process.
Description
GETNEXT ACTIVITY returns either:
- The name and identifier of the next child activity of a BTS activity (if the PROCESS and PROCESSTYPE options were omitted from the STARTBROWSE ACTIVITY command)
- The name and identifier of the next descendant activity of a BTS process (if the PROCESS and PROCESSTYPE options were specified on the STARTBROWSE ACTIVITY command).
You can use the INQUIRE ACTIVITYID command to query the identified activity.
Options
- ACTIVITYID(data-area)
- returns the 52-character identifier of the next activity.
- ACTIVITY(data-area)
- returns the 16-character name of the next activity.
- BROWSETOKEN(data-value)
- specifies, as a fullword binary value, a browse token returned on a previous STARTBROWSE ACTIVITY command.
- LEVEL(data-area)
- returns
a fullword value indicating the depth in the activity-tree at which
the next activity lies.
On a browse of the descendant activities of a process, a value of '0' indicates the root activity, '1' a child of the root activity, '2' a grandchild of the root activity, and so on.
On a browse of the child activities of an activity, the value returned is always 0.
Conditions
- 109 ACTIVITYERR
- RESP2
values:
- 19
- The request timed out. It may be that another task using this activity-record has been prevented from ending.
- 83 END
- RESP2
values:
- 2
- There are no more resource definitions of this type.
- 21 ILLOGIC
- RESP2
values:
- 1
- The value specified in the BROWSETOKEN option matches a current browse token, but not one that is being used for an activity browse.
- 17 IOERR
- RESP2
values:
- 29
- The repository file is unavailable.
- 30
- An input/output error has occurred on the repository file.
- 112 TOKENERR
- RESP2
values:
- 3
- The browse token is not valid.