Limit Simultaneous Dial Operations
$dial_limit node count [timeout [ratelimit]]
This command limits the number of concurrent dial operations, to reduce the load on a connected telephone switch. Setting this value prevents the switch from becoming overloaded, for example when CopiaFacts first starts up or when a new schedule period starts with a broadcast waiting. The principal use of this command is for PSTN calls.
The parameters on this command are used as follows:
| node | the nodename affected, or * for all nodes. Only a single command may be used for each node. |
| count | The maximum number of simultaneous dial operations on the node. To have no limit, enter 999 (or any number greater than the number of BladeWare channels in the node. |
| timeout | The override time in milliseconds after which the dial is deemed to be complete (BladeWare SIP only). Use 0 to suppress the override. |
| ratelimit | The minimum time in milliseconds to delay between successive dial operations (BladeWare SIP and Copia VoIP only). For example a value of 100 limits dials to ten per second. Enter zero for no rate limit. |
When the count limit is reached, the outbound operation will be delayed. The delay time is varied by reference to the channel number, so that the problem is not repeated after the delay time expires.
Hardware Issues:
The implementation varies depending on the board type:
| Brooktrout | the dial operation is considered complete when call setup API function returns, before call progress starts |
| Dialogic Diva, XCAPI | the dial operation is considered complete when the call progress event 'proceeding' is received. This happens at the start of call progress processing. See also DIVA_DIAL_INTERVAL or XCAPI_DIAL_INTERVAL for an alternative control method. |
| BladeWare SIP | the dial operation is considered complete when the a connection state event is received in which the local connection state is 'initiated'. |
| Copia VoIP Ports | the dial operation is considered complete when the INVITE has been sent. |
| (other boards/ports) | not implemented |
Default: No limit on simultaneous dials.
Example:
Simple limit to 15 simultaneous dial operations:
$dial_limit * 15
No limit on simultaneous dial operations, assume dial completed after 4s, but instead limit (across all channels in the node) to each dial starting no less than 300ms after the previous dial start, for BW line group (BladeWare):
$dial_limit BW 999 4000 300
