Browsing commands
You can use the browsing commands to locate BTS objects and examine their relationships to each other.
The objects that you can browse include:
- Activities
- Data-containers
- Events
- Processes
- Process-types.
Each browse has three commands associated with it:
- STARTBROWSE
- STARTBROWSE:
- Tells CICS® to begin a browse of a specified type of BTS object.
- Defines the scope of the browse. Except for browses of processes and process-types, an absence of additional arguments indicates that the browse is to have the scope of the current activity.
- Returns a browse token which must be included on the remaining commands within the browse.
- GETNEXT
- Locates the next object within the scope of the browse, or returns
the END condition if there are no more objects found.
GETNEXT always returns sufficient information to allow additional actions to be taken. For example, in a browse of the children of a specified parent activity, the GETNEXT ACTIVITY command returns both the name and the identifier (ACTIVITYID) of the next child activity that it finds. The name could be used to decide where the current browse should be paused. The identifier could be used to start a new browse - which might be containers of the child activity, for instance.
- ENDBROWSE
- Ends the browse.