executorgetconcurrencylevel
executorgetconcurrencylevel |
Purpose
Fetch the currently configured concurrency level of the Xpress Executor component.
Synopsis
function executorgetconcurrencylevel(exec:Executor):integer
Argument
|
exec
|
The Executor to query
|
Return value
The number of executions that can be performed concurrently on a single Xpress Executor gear
Example
declarations
concurrencylevel: integer
end-declarations
concurrencylevel := executorgetconcurrencylevel( myexecutor )
if myexecutor.status<>EXECUTOR_OK then
writeln("Error returned by Executor: ",myexecutor.lasterror)
exit(1)
end-if
Further information
1. After calling, check the value of
exec.status for any errors.
2. "Concurrency Level" is the number of executions that can be performed concurrently on a single gear; if the Xpress Executor component is scaled over multiple gears then the total number of concurrent executions will be concurrencylevel*numgears
3. If you start an execution when the maximum number of executions are concurrently executing, new executions are queued and will start when other executions complete.
4. This will always be 1 if the Executor is configured in local mode.
Related topics