GETNEXT ACTIVITY

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

Read syntax diagramSkip visual syntax diagram
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.