The Multi Line Hunt Group (MLHG) object defines a set of lines within a Business Group (MLHG Members), so that calls to the group are passed to a non-busy line within the Hunt Group, or may be added to a queue if all lines are busy. It is a child of the Multi Line Hunt Groups object.
A MLHG has up to 32 MLHG Member child objects, each corresponding to a Business Group Line that can accept calls to the MLHG.
You can optionally assign one or more MLHG Pilot Directory Numbers to the Hunt Group. These provide a contact number for the whole group that will always pick a free line, instead of being associated with a specific line within the Hunt Group. This would be useful, for example, if you were using a Multi Line Hunt Group for a call center and wished to provide one number for the public to call. Additionally, calls that are dialed directly to a number within the Hunt Group can be forwarded to a non-busy line within the Hunt Group if the number they are calling is busy, or may be treated as busy if you prefer.
Intercom calls are never hunted. Users who wish to temporarily remove themselves from the Multi Line Hunt Group can use Do Not Disturb to do so. This prevents all calls to them (including intercom calls), not just calls from the Multi Line Hunt Group.
The Multi Line Hunt Group object configures the overall behaviour of the Group. The directory numbers that are part of the Multi Line Hunt Group (MLHG Members), and any Pilot Directory Numbers you wish to assign to the group as a whole, are defined by child objects of the Multi Line Hunt Group. The order of MLHG Member child objects is significant for determining which line is called, see the Distribution algorithm field for details. You can configure the order of the MLHG Member objects using the Move Up and Move Down actions on the MLHG Member object.
Parameter |
Access |
Description |
Name | Change | A text string used in the EMS System Explorer to identify this Multi Line Hunt Group. Specify a string of up to 64 characters. |
Distribution algorithm | Change Inactive | Specifies the method used for determining which non-busy line in the Multi Line Hunt Group will receive a call. Values:
|
Queuing supported | Change Inactive | Specifies whether or not queuing is supported for this Multi Line Hunt Group, if all lines are busy. Values:
|
Maximum queue length | Change Inactive | This field is visible only if Queuing supported is set to True. Specifies the maximum number of calls which can be queued at one time. Range: 1 - 256. The default is 16. |
Limit queuing time | Change Inactive | This field is visible only if Queuing supported is set to True. Specifies whether or not there is a limit to the length of time a call can be held in the queue. Once this time limit is reached, any call services for busy calls (for example, Busy Call Forwarding) are activated based on the configuration of the number originally called. Values:
|
Maximum queue timeout | Change Inactive | This field is visible only if Queuing supported is set to True and Limit queuing time is set to True. Specifies the maximum length of time a call can be queued for. Range: 1 - 3600 seconds. You must supply a value for this field, if it is visible. |
Hunt on direct dialed calls | Change Inactive | Specifies whether external calls directly to a line within the Multi Line Hunt Group are treated to line hunting or not. (Note that this does not apply to intercom calls.) Values:
|
Delivery of called DN as Caller ID | Change Inactive | Specifies whether or not the directory number that was called should be delivered as the caller ID or not. This can be used so that, for example, a helpdesk receiving calls could know whether the "Helpdesk" or "Accounts Enquiries" number had been called. Values:
|
Traffic study | Change | This field specifies whether this Multi Line Hunt Group should have statistics for line traffic usage recorded in the metastats.txt log file. See the MetaSwitch Class 5 Softswitch Ancillary Servers Guide for more details of this file. The child statistics object of a Multi Line Hunt Group always reports line traffic usage. Values:
|
Diagnostics - logging - log level | Change | Specifies the level of logs recorded for this object. Logs with a priority equal to or greater than the priority specified are recorded. Set to Default level to use the system-wide default level. Values:
|
Diagnostics - API trace - enabled | Change | Specifies whether API tracing is enabled for this object. Values:
|
Diagnostics - API trace - trace tag | Change | An optional diagnostics tag inserted into API tracing and PD logging for this object. This tag may include any ASCII characters. |
Diagnostics - API trace - trace remote number | Change | The remote directory number that should be API traced. Outgoing calls made to this number or incoming calls received from this number should be API traced. If a directory number is not specified, all calls made by and received by this subscriber will be API traced. |
Child Call Service Attention Required alarms | Read only | The total number of Call Service children of this object that are in Attention Required state. |
Child Call Service Attention Required alarm events | Read only / Reset | The total number of times that the alarm state for a Call Service child object has gone to Attention Required. |
Child Call Service Attend To Dependent alarms | Read only | The total number of Call Service children of this object that are in Attend To Dependent state. |
Child Call Service Attend To Dependent alarm events | Read only / Reset | The total number of times that the alarm state for a Call Service child object has gone to Attend To Dependent. |
Summary child alarm state | Read only | Summarizes the alarm status for all children of this object. Values:
|
Requested status | Read only | Specifies whether an administrator has attempted to enable the Multi Line Hunt Group. Values:
|
Actual status | Read only | Specifies the current status of the Multi Line Hunt Group. Values:
|