version 3
Process state (process) Number
Parameter | Type | Description | |
process | Number | Process number | |
Function result | Number | State of the process |
Description
The Process state command returns the state of the process whose number you pass in process.
The function result can be one of the values provided by the following predefined constants:
Constant | Type | Value |
Aborted | Long Integer | -1 |
Delayed | Long Integer | 1 |
Does not exist | Long Integer | -100 |
Executing | Long Integer | 0 |
Hidden modal dialog | Long Integer | 6 |
Paused | Long Integer | 5 |
Waiting for input output | Long Integer | 3 |
Waiting for internal flag | Long Integer | 4 |
Waiting for user event | Long Integer | 2 |
If the process does not exist (which means you did not pass a number in the range 1 to Count tasks), Process state returns Does not exist (-100).
Example
The following example puts the name and process reference number for each process into the asProcName and aiProcNum arrays. The method checks to see if the process has been aborted. In this case, the process name and number are not added to the arrays:
$vlNbTasks:=Count tasks ARRAY STRING(31;asProcName; $vlNbTasks) ARRAY INTEGER(aiProcNum; $vlNbTasks) $vlActualCount:=0 For ($vlProcess;1; $vlNbTasks) If (Process state($vlProcess)>=Executing) $vlActualCount:=$vlActualCount+1 PROCESS PROPERTIES($vlProcess; asProcName{$vlActualCount};$vlState;$vlTime) aiProcNum{$vlActualCount}:=$vlProcess End if End for ` Eliminate unused extra elements ARRAY STRING(31;asProcName;$vlActualCount) ARRAY INTEGER(aiProcNum;$vlActualCount)
See Also
Count tasks, PROCESS PROPERTIES.