executorsetconcurrencylevel
executorsetconcurrencylevel |
Purpose
Configure the concurrency level of the Xpress Executor component.
Synopsis
procedure executorsetconcurrencylevel(exec:Executor, newlevel:integer)
Arguments
exec
|
The Executor to configure
|
level
|
The new concurrency level, must be an integer greater than 1
|
Example
executorsetconcurrencylevel( myexecutor, 4) 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. In local mode, the concurrency level cannot be modified and calling this procedure will do nothing.
5. This can only be used with the design instance of the Xpress Executor component, or with an Executor initialized using
executorinitlocal.
Related topics