Browse the child activities of a BTS activity, or the descendant
activities of a BTS process.
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.

GETNEXT ACTIVITY
>>-GETNEXT--ACTIVITY(data-area)--BROWSETOKEN(data-value)-------->
>--+-----------------------+--+------------------+-------------><
'-ACTIVITYID(data-area)-' '-LEVEL(data-area)-'
Conditions: ACTIVITYERR, END, ILLOGIC, IOERR, TOKENERR
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
- ACTIVITYERR
- RESP2
values:
- 19
- The request timed out. It may be that another task using this activity-record
has been prevented from ending.
- END
- RESP2
values:
- 2
- There are no more resource definitions of this type.
- 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.
- IOERR
- RESP2
values:
- 29
- The repository file is unavailable.
- 30
- An input/output error has occurred on the repository file.
- TOKENERR
- RESP2
values:
- 3
- The browse token is not valid.