GETNEXT PROCESS

Browse all processes of a specified type within the CICS® business transaction services system.

GETNEXT PROCESS

Read syntax diagramSkip visual syntax diagramGETNEXTPROCESS( data-area)BROWSETOKEN( data-value)ACTIVITYID( data-area)

Conditions: END, ILLOGIC, IOERR, PROCESSERR, TOKENERR

Description

GETNEXT PROCESS returns the name of the next process of a specified type within the CICS business transaction services system.

Options

ACTIVITYID(data-area)
returns the 52-character identifier of the next process's root activity.
BROWSETOKEN(data-value)
specifies, as a fullword binary value, a browse token returned on a previous STARTBROWSE PROCESS command.
PROCESS(data-area)
returns the 36-character name of the next process.

Conditions

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 a process browse.
17 IOERR
RESP2 values:
30
An input/output error has occurred on the repository file.
108 PROCESSERR
RESP2 values:
13
The request timed out. It may be that another task using this process-record has been prevented from ending.
112 TOKENERR
RESP2 values:
3
The browse token is not valid.