[Index]

Model: relation/HuntGroupRelation

Hunt Groups

Hunt groups can be configured at the customer or site level.

The purpose of hunt group management is to provide business context for the lines selected as members of line groups and to provide you with a single consolidated view of the following hunting elements.

Note

When selecting a Call Pickup Group from the drop-down list, the available Call Pickup groups to choose from will be:

You must select the lines that belong to line groups or any existing line groups that must be added to the hunt list members.

For hunt groups configured at the customer level:

Searches can be performed on any of the details of the hunt pilot.

A hunt group is a combination of the hunt pilot, hunt list, and line groups that are automatically linked together using unique identifiers for the following:

Certain default values for hunt groups are populated by the site defaults menu item, which can be viewed and edited (depending on your log-in level). See the Default CUCM Hunt Pilot Partition field on the General Defaults tab under the Modify Site Defaults topic in this manual.

Hunt groups can be:

Add a Hunt Group

Use this procedure to add a hunt group in VOSS-4-UC and Cisco Unified Call Manager (CUCM).

  1. Log in as site administrator or higher.
  2. Browse to the hierarchy level (if necessary) to which you want to add the hunt group.
  3. Click Subscriber Management > Hunt Groups. The Hunt Groups list is displayed.
  4. Click Add.
  5. Complete, at minimum, the required fields on each tab (see below).
  6. Click Save

Hunt Pilot

A hunt pilot comprises a string of digits (an address) and a set of associated digit manipulations that route calls to a hunt list. Hunt pilots provide flexibility in network design. They work in conjunction with route filters and hunt lists to direct calls to specific devices and to include, exclude, or modify specific digit patterns.

Hunt List

A Hunt List lists a set of Line groups in a specific order. A hunt list then associates with one or more hunt pilots and determines the order in which those line groups are accessed. The order controls the progress of the search for available directory numbers for incoming calls. A hunt list comprises a collection of directory numbers as defined by line groups.

A hunt list can contain only line groups. Each hunt list should have at least one line group. Each line group includes at least one directory number. A single line group can appear in multiple hunt lists.

Line Groups

A line group allows you to designate the order in which directory numbers are chosen. CUCM distributes a call to idle or available members of a line group based on a call distribution algorithm and on the Ring No Answer (RNA) Reversion Timeout setting.

Note

Although you can configure an empty line group with no members (directory numbers), CUCM does not support this configuration for routing calls. If the line group contains no members, the hunt list stops hunting when the call gets routed to the empty line group. To avoid this, make sure that you configure at least one member in the line group.

You must define one or more directory number before configuring a line group. After you configure or update a line group, you can add or remove members from that line group.

Relation for Hunt Group Elements

Model Details

Title Description Details
Hunt Pilot Group Assigned by FDP
  • Field Name: Hunt Pilot
  • Type: Object
Hunt Pilot Pattern * Enter the Hunt Pilot pattern, including numbers and wildcards. Do not use spaces. For example, for NANP, enter 9.@ for typical local access or 8XXX for a typical private network numbering plan. Valid characters include the uppercase characters A, B, C, and D and \+, which represents the international escape character +. Note: Ensure that the directory hunt pilot, which uses the chosen partition, route filter, and numbering plan combination, is unique. Check the hunt pilot, translation pattern, directory number, call park number, call pickup number, message waiting on/off, or meet me number if you receive an error that indicates duplicate entries. You can also check the route plan report.
  • Field Name: Hunt Pilot.pattern
  • Type: String
  • Cardinality: [1..1]
Route Partition If you want to use a partition to restrict access to the hunt pilot, choose the desired partition from the drop-down list box. All route partitions in the Unified CM are provided in the drop-down. The default value is the default line partition of the site.
  • Field Name: Hunt Pilot.routePartitionName
  • Type: ["String", "Null"]
  • Target: device/cucm/RoutePartition
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
Description Enter a description of the hunt pilot. The description can include up to 50 characters in any language, but it cannot include double-quotes ("), percentage sign (%), ampersand (&), or angle brackets (<>).
  • Field Name: Hunt Pilot.description
  • Type: String
  • Cardinality: [0..1]
Numbering Plan Choose a numbering plan.
  • Field Name: Hunt Pilot.dialPlanName
  • Type: ["String", "Null"]
  • Target: device/cucm/DialPlan
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
Route Filter If your hunt pilot includes the @ wildcard, you may choose a route filter. The optional act of choosing a route filter restricts certain number patterns. The route filters that display depend on the numbering plan that you choose from the Numbering Plan drop-down list box. You can configure the number of items that display in this drop-down list box by using the Max List Box Items enterprise parameter. If more route filters exist than the Max List Box Items enterprise parameter specifies, the Find button displays next to the drop-down list box. Click the Find button to display the Find and List Route Filters window, then find and choose a route filter name. Note    To set the maximum list box items, choose System > Enterprise Parameters and choose Unified CMAdmin Parameters.
  • Field Name: Hunt Pilot.routeFilterName
  • Type: ["String", "Null"]
  • Target: device/cucm/RouteFilter
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
MLPP Precedence Choose an MLPP precedence setting for this hunt pilot from the drop-down list box: Executive Override—Highest precedence setting for MLPP calls. Flash Override—Second highest precedence setting for MLPP calls. Flash—Third highest precedence setting for MLPP calls. Immediate—Fourth highest precedence setting for MLPP calls. Priority—Fifth highest precedence setting for MLPP calls. Routine—Lowest precedence setting for MLPP calls. Default—Does not override the incoming precedence level but rather lets it pass unchanged. Default: Default
  • Field Name: Hunt Pilot.patternPrecedence
  • Type: String
  • Cardinality: [0..1]
  • Default: Default
  • Choices: ["Flash Override", "Flash", "Immediate", "Priority", "Routine", "Default", "Executive Override"]
Hunt List * The value is automatically populated with the hunt list name entered on the 'Hunt List' tab.
  • Field Name: Hunt Pilot.huntListName
  • Type: String
  • Target: device/cucm/HuntList
  • Target attr: name
  • Cardinality: [1..1]
  • Format: uri
Call Pickup Group Choose the number that can be dialed to answer calls to this directory number (in the specified partition). Note    The Call Pickup Group setting has been moved to this section from the Forward settings section.
  • Field Name: Hunt Pilot.callPickupGroupName
  • Type: String
  • Cardinality: [0..1]
Alerting Name Enter an alerting name for the hunt pilot in UNICODE format. This name gets displayed on phones that the hunt pilot dials when it receives an incoming call, along with calling party information. The phone users can use this information to answer the call accordingly. This name also gets displayed on the calling phone. If you do not enter a name, the hunt pilot DN displays on the phones.
  • Field Name: Hunt Pilot.alertingName
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
  • MaxLength: 50
ASCII Alerting Name Enter an alerting name for the hunt pilot in ASCII format. This name gets displayed on phones that the hunt pilot dials when it receives an incoming call, along with calling party information. The phone users can use this information to answer the call accordingly. This name also gets displayed on the calling phone. If you do not enter a name, the hunt pilot DN displays on the phones.
  • Field Name: Hunt Pilot.asciiAlertingName
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
  • MaxLength: 32
Block this pattern If the checkbox is checked, then block this pattern. Also choose the required Release Clause. If the checkbox is unchecked, then route this pattern.
  • Field Name: Hunt Pilot.blockEnable
  • Type: Boolean
  • Cardinality: [1..1]
Release Clause Replaces the 'Route this pattern' and 'Block this pattern' radio buttons in Unified CM. Default: No Error
  • Field Name: Hunt Pilot.releaseClause
  • Type: String
  • Cardinality: [0..1]
  • Default: No Error
  • Choices: ["No Error", "Unallocated Number", "Call Rejected", "Number Changed", "Invalid Number Format", "Precedence Level Exceeded"]
Provide Outside Dial Tone Provide Outside Dial Tone indicates that Cisco Unified Communications Manager routes the calls off the local network. Check this check box for each hunt pilot that routes the call off the local network and provides outside dial tone to the calling device. To route the call in the network, leave the check box unchecked. Default: True
  • Field Name: Hunt Pilot.provideOutsideDialtone
  • Type: Boolean
  • Cardinality: [0..1]
  • Default: True
Urgent Priority If the dial plan contains overlapping hunt lists, Cisco Unified Communications Manager would not route the call until the interdigit timer expires (even if it is possible to dial a sequence of digits to choose a current match). Check this check box to interrupt interdigit timing when Cisco Unified Communications Manager must route a call immediately.
  • Field Name: Hunt Pilot.patternUrgency
  • Type: Boolean
  • Cardinality: [0..1]
Maximum Hunt Timer Enter a value (in seconds) that specifies the maximum time for hunting without queuing. Valid values specify 1 to 3600. The default value specifies 1800 seconds (30 minutes).
  • Field Name: Hunt Pilot.maxHuntduration
  • Type: ["Integer", "Null"]
  • Cardinality: [0..1]
Forward Hunt No Answer
  • Field Name: forwardHuntNoAnswer
  • Type: ["Object", "Null"]
  • Cardinality: [0..1]
Use Forward Settings of Device that Forwarded to Hunt Pilot Use Forward Settings of Line Group Member
  • Field Name: Hunt Pilot.forwardHuntNoAnswer.usePersonalPreferences
  • Type: Boolean
  • Cardinality: [0..1]
CFNA Destination This setting indicates the directory number to which calls are forwarded.
  • Field Name: Hunt Pilot.forwardHuntNoAnswer.destination
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
CSS CFNA This drop-down lists all the CSSs on the system. The default is the default line CSS of the site.
  • Field Name: Hunt Pilot.forwardHuntNoAnswer.callingSearchSpaceName
  • Type: ["String", "Null"]
  • Target: device/cucm/Css
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
Forward Hunt Busy This drop-down lists all the CSSs on the system. The default is the default line CSS of the site.
  • Field Name: forwardHuntBusy
  • Type: ["Object", "Null"]
  • Cardinality: [0..1]
Use Forward Settings of Device that Forwarded to Hunt Pilot Use Forward Settings of Line Group Member
  • Field Name: Hunt Pilot.forwardHuntBusy.usePersonalPreferences
  • Type: Boolean
  • Cardinality: [0..1]
CFB Destination This setting indicates the directory number to which calls are forwarded.
  • Field Name: Hunt Pilot.forwardHuntBusy.destination
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
CSS CFB This drop-down lists all the CSSs on the system. The default is the default line CSS of the site.
  • Field Name: Hunt Pilot.forwardHuntBusy.callingSearchSpaceName
  • Type: ["String", "Null"]
  • Target: device/cucm/Css
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
Queueing Forward Hunt No Answer or Forward Hunt Busy settings are designed to move calls through the route list. Queuing, on the other hand, is used to hold callers in a route list. Therefore, if queuing is enabled, both Forward Hunt No Answer and Forward Hunt Busy are automatically disabled. Conversely, if Forward Hunt No Answer or Forward Hunt Busy are enabled, queuing is automatically disabled.
  • Field Name: queueCalls
  • Type: ["Object", "Null"]
  • Cardinality: [0..1]
Network Hold MOH Source & Announcements Choose a Music On Hold (MoH) source from the drop-down list box, which will be used to play announcements and provide queue hold treatments. The default value is NULL. If nothing is selected, the default Network Hold MoH/MoH Source and Announcements configured on service parameter is used. The MoH source can be configured as unicast or multicast. Caller side's MRGL takes precedence for multicast or unicast. The MoH source announcement locale is used to determine the language used for the announcement. Only one type of language announcement can be played per hunt pilot. When any of the MoH settings are changed, the existing callers in queue are not affected. All future queued callers will listen to MoH and announcements as per the updated settings.
  • Field Name: Hunt Pilot.queueCalls.networkHoldMohAudioSourceID
  • Type: ["String", "Null", "Integer"]
  • Target: device/cucm/MohAudioSource
  • Target attr: sourceId
  • Cardinality: [0..1]
  • Format: uri
Maximum Number of Callers Allowed in Queue * Enter an integer value for the number of callers allowed in the queue for this hunt pilot. The default value is 32. The field range is from 1 to 100. When the maximum number of callers in queue has been reached, and if subsequent calls need to be disconnected, select the “Disconnect the call” radio button. When the maximum number of callers in queue has been reached, and if subsequent calls need to be routed to a secondary destination, select the “Route the call to this destination” radio button. Provide a specific device DN, shared line DN, or another Hunt Pilot DN. You may also select the “Full Queue Calling Search Space” from the drop-down list (optional).
  • Field Name: Hunt Pilot.queueCalls.maxCallersInQueue
  • Type: Integer
  • Cardinality: [1..1]
Queue Full Destination When the maximum number of callers in queue has been reached, and if subsequent calls need to be routed to a secondary destination then configure this field. Calls are disconnected if the destination field is not configured.
  • Field Name: Hunt Pilot.queueCalls.queueFullDestination
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
  • MaxLength: 50
Queue Full Calling Search Space This drop-down lists all the CSSs on the system. This CSS is used when the Queue Full Destination is configured.
  • Field Name: Hunt Pilot.queueCalls.callingSearchSpacePilotQueueFull
  • Type: ["String", "Null"]
  • Target: device/cucm/Css
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
Maximum Wait Time in Queue * Enter an integer value to set the maximum wait time, in seconds, in a queue. The default value is 900 seconds. The field range is from 10 to 3600 seconds. When the maximum wait time in queue has been reached, and if the queued caller needs to be disconnected, select the “Disconnect the call” radio button. When the maximum wait time in queue has been reached, and if the queued caller needs to be routed to a secondary destination, select the “Route the call to this destination” radio button. Provide a specific device DN, shared line DN, or another Hunt Pilot DN. You may also select the “Maximum Wait Time Calling Search Space” from the drop-down list (optional).
  • Field Name: Hunt Pilot.queueCalls.maxWaitTimeInQueue
  • Type: Integer
  • Cardinality: [1..1]
Max Wait Time Destination When the maximum wait time in queue has been reached, and if the queued caller needs to be routed to a secondary destination configured then configure this field. Calls are disconnected if the destination field is not configured.
  • Field Name: Hunt Pilot.queueCalls.maxWaitTimeDestination
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
  • MaxLength: 50
Max Wait Time Calling Search Space This drop-down lists all the CSSs on the system. This CSS is used when the Max Wait Time Destination is configured.
  • Field Name: Hunt Pilot.queueCalls.callingSearchSpaceMaxWaitTime
  • Type: ["String", "Null"]
  • Target: device/cucm/Css
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
No Hunt Members Answer/Available Destination When no line members are logged in or registered at the time of an incoming call, and if that call needs to be routed to a secondary destination then configure this field.
  • Field Name: Hunt Pilot.queueCalls.noAgentDestination
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
  • MaxLength: 50
No Hunt Members Answer/Available Calling Search Space This drop-down lists all the CSSs on the system. This CSS is used when the No Hunt Members Answer/Available Destination is configured.
  • Field Name: Hunt Pilot.queueCalls.callingSearchSpaceNoAgent
  • Type: ["String", "Null"]
  • Target: device/cucm/Css
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
Park Monitoring
  • Field Name: parkMonForwardNoRetrieve
  • Type: ["Object", "Null"]
  • Cardinality: [0..1]
Park Monitoring Forward No Retrieve Destination This setting specifies the directory number to which a parked call is forwarded when the service parameter Park Monitoring Forward No Retrieve Timer expires. Use any dialable phone number, including an outside destination.
  • Field Name: Hunt Pilot.parkMonForwardNoRetrieve.destination
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
  • MaxLength: 50
Park Monitoring Forward No Retrieve Calling Search Space This drop-down lists all the CSSs on the system. This CSS is used when the Park Monitoring Forward No Retrieve Destination is configured.
  • Field Name: Hunt Pilot.parkMonForwardNoRetrieve.callingSearchSpaceName
  • Type: ["String", "Null"]
  • Target: device/cucm/Css
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
Use Calling Party's External Phone Number Mask * Check the check box if you want the full, external phone number to be used for calling line identification (CLID) on outgoing calls. You may also configure an External Phone Number Mask on all phone devices. Note    The calling party transformation settings that are assigned to the line groups in a hunt list override any calling party transformation settings that are assigned to a hunt pilot that is associated with that hunt list. Default: Default
  • Field Name: Hunt Pilot.useCallingPartyPhoneMask
  • Type: String
  • Cardinality: [1..1]
  • Default: Default
  • Choices: ["Off", "On", "Default"]
Calling Party Transform Mask Enter a transformation mask value. Valid entries include the digits 0 through 9, the wildcard character X, asterisk (*), and octothorpe (#); the international escape character +; and blank. If this field is blank and the preceding field is not checked, no calling party transformation takes place.
  • Field Name: Hunt Pilot.callingPartyTransformationMask
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
Prefix Digits Enter prefix digits in the Prefix Digits (Outgoing Calls) field. Valid entries include the digits 0 through 9; the wildcard characters asterisk (*) and octothorpe (#); the international escape character +; and blank. Note    The appended prefix digit does not affect which directory numbers route to the assigned device.
  • Field Name: Hunt Pilot.callingPartyPrefixDigits
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
  • MaxLength: 50
Calling Line ID Presentation Cisco Unified Communications Manager uses calling line ID presentation (CLIP/CLIR) as a supplementary service to allow or restrict the originating caller phone number on a call-by-call basis. Choose whether you want the Cisco Unified Communications Manager to allow or restrict the display of the calling party phone number on the called party phone display for this hunt pilot. Choose Default if you do not want to change calling line ID presentation. Choose Allowed if you want your system to allow the display of the calling number. Choose Restricted if you want your system to block the display of the calling number. Default: Default
  • Field Name: Hunt Pilot.callingLinePresentationBit
  • Type: String
  • Cardinality: [0..1]
  • Default: Default
  • Choices: ["Default", "Allowed", "Restricted"]
Calling Name Presentation Cisco Unified Communications Manager uses calling name presentation (CNIP/CNIR) as a supplementary service to allow or restrict the originating caller name on a call-by-call basis. Choose whether you want the your system to allow or restrict the display of the calling party name on the called party phone display for this hunt pilot. Choose Default if you do not want to change calling name presentation. Choose Allowed if you want your system to display the calling name information. Choose Restricted if you want your system to block the display of the calling name information. Default: Default
  • Field Name: Hunt Pilot.callingNamePresentationBit
  • Type: String
  • Cardinality: [0..1]
  • Default: Default
  • Choices: ["Default", "Allowed", "Restricted"]
Calling Party Number Type Choose the format for the number type in calling party directory numbers. Cisco Unified Communications Manager sets the calling directory number (DN) type. Cisco recommends that you do not change the default value unless you have advanced experience with dialing plans such as NANP or the European dialing plan. You may need to change the default in Europe because your system does not recognize European national dialing patterns. You can also change this setting when you are connecting to a PBX that expects the calling directory number to be encoded to a non-national numbering plan type. Choose one of the following options: Cisco Unified Communications Manager—The Cisco Unified Communications Manager sets the directory number type. Unknown—The dialing plan is unknown. National—Use when you are dialing within the dialing plan for your country. International—Use when you are dialing outside the dialing plan for your country. Subscriber—Use when you are dialing a subscriber by using a shortened subscriber number. Default: Cisco CallManager
  • Field Name: Hunt Pilot.callingPartyNumberType
  • Type: String
  • Cardinality: [0..1]
  • Default: Cisco CallManager
  • Choices: ["Cisco CallManager", "Unknown", "National", "International", "Subscriber"]
Calling Party Numbering Plan Choose the format for the numbering plan in calling party directory numbers. Cisco Unified Communications Manager sets the calling DN numbering plan. We recommend that you do not change the default value unless you have advanced experience with dialing plans such as NANP or the European dialing plan. You may need to change the default in Europe because your system does not recognize European national dialing patterns. You can also change this setting when you are connecting to PBXs by using routing as a non-national type number. Choose one of the following options: Cisco Unified Communications Manager—Use when the Cisco Unified Communications Manager sets the Numbering Plan in the directory number. ISDN—Use when you are dialing outside the dialing plan for your country. National Standard—Use when you are dialing within the dialing plan for your country. Private—Use when you are dialing within a private network. Unknown—Use when the dialing plan is unknown. Default: Cisco CallManager
  • Field Name: Hunt Pilot.callingPartyNumberingPlan
  • Type: String
  • Cardinality: [0..1]
  • Default: Cisco CallManager
  • Choices: ["Cisco CallManager", "ISDN", "National Standard", "Private", "Unknown"]
Connected Line ID Presentation Cisco Unified Communications Manager uses connected line ID presentation (COLP/COLR) as a supplementary service to allow or restrict the called party phone number on a call-by-call basis. Choose whether you want Cisco Unified Communications Manager to allow or restrict the display of the connected party phone number on the calling party phone display for this hunt pilot. Choose Default if you do not want to change the connected line ID presentation. Choose Allowed if you want to display the connected party phone number. Choose Restricted if you want Cisco Unified Communications Manager to block the display of the connected party phone number. If a call that originates from an IP phone on your system encounters a device, such as a trunk, gateway, or route pattern, that has the Connected Line ID Presentation set to Default, the presentation value is automatically set to Allowed. Default: Default
  • Field Name: Hunt Pilot.connectedLinePresentationBit
  • Type: String
  • Cardinality: [0..1]
  • Default: Default
  • Choices: ["Default", "Allowed", "Restricted"]
Display Line Group Member DN as Connected Party Check this check box to display the directory number of the answering phone as the connected party when a call is routed through a hunt list. Uncheck this check box to display the hunt pilot number as the connected party when a call is routed through a hunt list.
  • Field Name: Hunt Pilot.displayConnectedNumber
  • Type: Boolean
  • Cardinality: [0..1]
Connected Name Presentation Cisco Unified Communications Manager uses connected name presentation (CONP/CONR) as a supplementary service to allow or restrict the called party name on a call-by-call basis. Choose whether you want your system to allow or restrict the display of the connected party name on the calling party phone display for this hunt pilot. Choose Default if you do not want to change the connected name presentation. Choose Allowed if you want to display the connected party name. Choose Restricted if you want your system to block the display of the connected party name. Default: Default
  • Field Name: Hunt Pilot.connectedNamePresentationBit
  • Type: String
  • Cardinality: [0..1]
  • Default: Default
  • Choices: ["Default", "Allowed", "Restricted"]
Discard Digits Select the discard digits instructions that you want to associate with this hunt pilot. The discard digits that display depend on the numbering plan that you choose from the Numbering Plan drop-down list box.
  • Field Name: Hunt Pilot.digitDiscardInstructionName
  • Type: ["String", "Null"]
  • Target: device/cucm/DiscardDigitInstruction
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
Called Party Transform Mask Enter a transformation mask value. Valid entries include the digits 0 through 9; the wildcard characters X, asterisk (*), and octothorpe (#); the international escape character +; and blank. If the field is blank, no transformation takes place. Cisco Unified Communications Manager sends the dialed digits exactly as dialed.
  • Field Name: Hunt Pilot.calledPartyTransformationMask
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
Called Party Prefix Digits Enter prefix digits in the Prefix Digits (Outgoing Calls) field. Valid entries include the digits 0 through 9; the wildcard characters asterisk (*) and octothorpe (#); the international escape character +; and blank. Note    The appended prefix digit does not affect which directory numbers route to the assigned device.
  • Field Name: Hunt Pilot.prefixDigitsOut
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
Called Party Number Type Choose the format for the number type in called party directory numbers. Cisco Unified Communications Manager sets the called directory number (DN) type. Cisco recommends that you do not change the default value unless you have advanced experience with dialing plans such as NANP or the European dialing plan. You may need to change the default in Europe because your system does not recognize European national dialing patterns. You can also change this setting when you are connecting to a PBX that expects the called directory number to be encoded to a non-national type numbering plan. Choose one of the following options: Cisco Unified Communications Manager—Use when the Cisco Unified Communications Manager sets the directory number type. Unknown—Use when the dialing plan is unknown. National—Use when you are dialing within the dialing plan for your country. International—Use when you are dialing outside the dialing plan for your country. Subscriber—Use when you are dialing a subscriber by using a shortened subscriber number. Default: Cisco CallManager
  • Field Name: Hunt Pilot.calledPartyNumberType
  • Type: String
  • Cardinality: [0..1]
  • Default: Cisco CallManager
  • Choices: ["Cisco CallManager", "Unknown", "National", "International", "Subscriber"]
Called Party Numbering Plan Choose the format for the numbering plan in called party directory numbers. Cisco Unified Communications Manager sets the called DN numbering plan. Cisco recommends that you do not change the default value unless you have advanced experience with dialing plans such as NANP or the European dialing plan. You may need to change the default in Europe because your system does not recognize European national dialing patterns. You can also change this setting when you are connecting to PBXs by using routing as a non-national type number. Choose one of the following options: Cisco Unified Communications Manager—Use when the Cisco Unified Communications Manager sets the Numbering Plan in the directory number. ISDN—Use when you are dialing outside the dialing plan for your country. National Standard—Use when you are dialing within the dialing plan for your country. Private—Use when you are dialing within a private network. Unknown—Use when the dialing plan is unknown. Default: Cisco CallManager
  • Field Name: Hunt Pilot.calledPartyNumberingPlan
  • Type: String
  • Cardinality: [0..1]
  • Default: Cisco CallManager
  • Choices: ["Cisco CallManager", "ISDN", "National Standard", "Private", "Unknown"]
AAR Group Choose an Automated Alternate Routing (AAR) group from the drop-down list box.
  • Field Name: Hunt Pilot.aarNeighborhoodName
  • Type: ["String", "Null"]
  • Target: device/cucm/AarGroup
  • Target attr: name
  • Cardinality: [0..1]
  • Format: uri
External Number Mask Unified CM uses this mask to format calling line identification for external (outbound) calls. When AAR initiates a reroute, the system applies this external number mask to the hunt pilot number to form a fully qualified DN of the called party, which allows AAR to reroute properly in out-of-bandwidth conditions.
  • Field Name: Hunt Pilot.e164Mask
  • Type: ["String", "Null"]
  • Cardinality: [0..1]
Hunt List Group Assigned by FDP
  • Field Name: Hunt List
  • Type: Object
Name * A name for the Hunt List. This name is used to populate the Hunt List Name field on the 'Hunt Pilot' tab.
  • Field Name: Hunt List.name
  • Type: String
  • Cardinality: [1..1]
Hunt List
  • Field Name: HuntList
  • Type: Object
Name * A name for the Hunt List. This name is used to populate the Hunt List Name field on the 'Hunt Pilot' tab.
  • Field Name: Hunt List.HuntList.name
  • Type: String
  • Cardinality: [1..1]
Description Enter a description to help you identify further details about the hunt list that do not fit into the name.
  • Field Name: Hunt List.HuntList.description
  • Type: String
  • Cardinality: [0..1]
Cisco Unified Communications Manager Group * The default is Default.
  • Field Name: Hunt List.HuntList.callManagerGroupName
  • Type: ["String", "Null"]
  • Target: device/cucm/CallManagerGroup
  • Target attr: name
  • Cardinality: [1..1]
  • Format: uri
Enable this Hunt List Enabled (checked) by default.
  • Field Name: Hunt List.HuntList.routeListEnabled
  • Type: Boolean
  • Cardinality: [0..1]
For Voice Mail Usage If this hunt list is to be used for voicemail, check this check box. If you this check box, the route list control process keeps a count of the setups that are being served to the hunt list, and will not allow more setups than the number of available devices. As a result, each device in the hunt list is treated as if it has a Busy Trigger and related Maximum Number of Calls of one.
  • Field Name: Hunt List.HuntList.voiceMailUsage
  • Type: Boolean
  • Cardinality: [0..1]
Description Enter a description to help you identify further details about the hunt list that do not fit into the name.
  • Field Name: Hunt List.description
  • Type: String
  • Cardinality: [0..1]
Cisco Unified Communications Manager Group * The default is Default.
  • Field Name: Hunt List.callManagerGroupName
  • Type: ["String", "Null"]
  • Target: device/cucm/CallManagerGroup
  • Target attr: name
  • Cardinality: [1..1]
  • Format: uri
Enable this Hunt List Enabled (checked) by default.
  • Field Name: Hunt List.routeListEnabled
  • Type: Boolean
  • Cardinality: [0..1]
For Voice Mail Usage If this hunt list is to be used for voicemail, check this check box. If you this check box, the route list control process keeps a count of the setups that are being served to the hunt list, and will not allow more setups than the number of available devices. As a result, each device in the hunt list is treated as if it has a Busy Trigger and related Maximum Number of Calls of one.
  • Field Name: Hunt List.voiceMailUsage
  • Type: Boolean
  • Cardinality: [0..1]
Line Groups Group Assigned by FDP
  • Field Name: Line Groups
  • Type: Object
Line Group
  • Field Name: LineGroup.[n]
  • Type: Array
Line Group Name * A name for the Line Group.
  • Field Name: Line Groups.LineGroup.[n].name
  • Type: String
  • Cardinality: [1..1]
RNA Reversion Timeout * Enter a time, in seconds, after which Cisco Unified Communications Manager will distribute a call to the next available or idle member of this line group or to the next line group if the call is not answered and if the first hunt option, Try next member; then, try next group in Hunt List, is chosen. The RNA Reversion Timeout applies at the line-group level to all members. Default: 10
  • Field Name: Line Groups.LineGroup.[n].rnaReversionTimeOut
  • Type: Integer
  • Cardinality: [1..1]
  • Default: 10
Distribution Algorithm * Choose a distribution algorithm, which applies at the line-group level, from the options in the drop-down list box: Top Down—If you choose this distribution algorithm, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. Circular—If you choose this distribution algorithm, Cisco Unified Communications Manager distributes a call to idle or available members starting from the (n+1)th member of a route group, where the nth member is the next sequential member in the list who is either idle or busy but not "down." If the nth member is the last member of a route group, Cisco Unified Communications Manager distributes a call starting from the top of the route group. Longest Idle Time—If you choose this distribution algorithm, Cisco Unified Communications Manager only distributes a call to idle members, starting from the longest idle member to the least idle member of a line group. Broadcast—If you choose this distribution algorithm, Cisco Unified Communications Manager distributes a call to all idle or available members of a line group simultaneously. See the Note in the description of the Selected DN/Route Partition field for additional limitations in using the Broadcast distribution algorithm. The default value specifies Longest Idle Time. Default: Longest Idle Time
  • Field Name: Line Groups.LineGroup.[n].distributionAlgorithm
  • Type: String
  • Cardinality: [1..1]
  • Default: Longest Idle Time
  • Choices: ["Top Down", "Circular", "Longest Idle Time", "Broadcast"]
Hunt Options No Answer * For a given distribution algorithm, choose a hunt option for Cisco Unified Communications Manager to use if a call is distributed to a member of a line group that does not answer. This option gets applied at the member level. Choose from the options in the drop-down list box: Try next member; then, try next group in Hunt List—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. If unsuccessful, Cisco Unified Communications Manager then tries the next line group in a hunt list. Try next member, but do not go to next group—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. Cisco Unified Communications Manager stops trying upon reaching the last member of the current line group. Skip remaining members, and go directly to next group—If you choose this hunt option, Cisco Unified Communications Manager skips the remaining members of this line group when the RNA reversion timeout value elapses for the first member. Cisco Unified Communications Manager then proceeds directly to the next line group in a hunt list. Stop hunting—If you choose this hunt option, Cisco Unified Communications Manager stops hunting after trying to distribute a call to the first member of this line group and the member does not answer the call. Default: Try next member; then, try next group in Hunt List
  • Field Name: Line Groups.LineGroup.[n].huntAlgorithmNoAnswer
  • Type: String
  • Cardinality: [1..1]
  • Default: Try next member; then, try next group in Hunt List
  • Choices: ["Try next member; then, try next group in Hunt List", "Try next member, but do not go to next group", "Skip remaining members, and go directly to next group", "Stop hunting"]
Automatically Logout Hunt Member on No Answer If this check box is checked, line members will be logged off the hunt list automatically. Line members can log back in using the "HLOG" softkey or PLK.
  • Field Name: Line Groups.LineGroup.[n].autoLogOffHunt
  • Type: Boolean
  • Cardinality: [0..1]
Hunt Options Busy * For a given distribution algorithm, choose a hunt option for Cisco Unified Communications Manager to use if a call is distributed to a member of a line group that is busy. Choose from the options in the drop-down list box: Try next member; then, try next group in Hunt List—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. If unsuccessful, Cisco Unified Communications Manager then tries the next line group in a hunt list. Try next member, but do not go to next group—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. Cisco Unified Communications Manager stops trying upon reaching the last member of the current line group. Skip remaining members, and go directly to next group—If you choose this hunt option, Cisco Unified Communications Manager skips the remaining members of this line group upon encountering a busy member. Cisco Unified Communications Manager proceeds directly to the next line group in a hunt list. Stop hunting—If you choose this hunt option, Cisco Unified Communications Manager stops hunting after trying to distribute a call to the first busy member of this line group. Default: Try next member; then, try next group in Hunt List
  • Field Name: Line Groups.LineGroup.[n].huntAlgorithmBusy
  • Type: String
  • Cardinality: [1..1]
  • Default: Try next member; then, try next group in Hunt List
  • Choices: ["Try next member; then, try next group in Hunt List", "Try next member, but do not go to next group", "Skip remaining members, and go directly to next group", "Stop hunting"]
Hunt Options Not Available * For a given distribution algorithm, choose a hunt option for Cisco Unified Communications Manager to use if a call is distributed to a member of a line group that is not available. The Not Available condition occurs when none of the phones that are associated with the DN in question is registered. Not Available also occurs when extension mobility is in use and the DN/user is not logged in. Choose from the options in the drop-down list box: Try next member; then, try next group in Hunt List—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. If unsuccessful, Cisco Unified Communications Manager then tries the next line group in a hunt list. Try next member, but do not go to next group—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. Cisco Unified Communications Manager stops trying upon reaching the last member of the current line group. Skip remaining members, and go directly to next group—If you choose this hunt option, Cisco Unified Communications Manager skips the remaining members of this line group upon encountering the first unavailable member. Cisco Unified Communications Manager proceeds directly to the next line group in a hunt list. Stop hunting—If you choose this hunt option, Cisco Unified Communications Manager stops hunting after trying to distribute a call to the first unavailable member of this line group. Default: Try next member; then, try next group in Hunt List
  • Field Name: Line Groups.LineGroup.[n].huntAlgorithmNotAvailable
  • Type: String
  • Cardinality: [1..1]
  • Default: Try next member; then, try next group in Hunt List
  • Choices: ["Try next member; then, try next group in Hunt List", "Try next member, but do not go to next group", "Skip remaining members, and go directly to next group", "Stop hunting"]
Members
  • Field Name: members
  • Type: ["Object", "Null"]
  • Cardinality: [0..1]
Member
  • Field Name: member.[n]
  • Type: Array
Directory Number The uuid attribute is read here
  • Field Name: directoryNumber
  • Type: ["Object", "Null"]
  • Cardinality: [1..1]
Directory Number * Select from the drop-down list. This list includes any patterns that are available from the associated route partition.
  • Field Name: Line Groups.LineGroup.[n].members.member.[n].directoryNumber.pattern
  • Type: String
  • Target: device/cucm/Line
  • Target attr: pattern
  • Cardinality: [1..1]
  • Format: uri
Partition * Select from the drop-down list. The drop-down list includes any route partitions to which the associated pattern belongs, and must match the route partition name for the directory number when it was originally created.
  • Field Name: Line Groups.LineGroup.[n].members.member.[n].directoryNumber.routePartitionName
  • Type: ["String", "Null"]
  • Target: device/cucm/RoutePartition
  • Target attr: name
  • Cardinality: [1..1]
  • Format: uri
Position
  • Field Name: Line Groups.LineGroup.[n].members.member.[n].lineSelectionOrder
  • Type: Integer
  • Cardinality: [1..1]
Hunt List
  • Field Name: HuntList
  • Type: Object
Line Group
  • Field Name: LineGroup.[n]
  • Type: Array
Line Group Name * A name for the Line Group.
  • Field Name: Line Groups.HuntList.LineGroup.[n].name
  • Type: String
  • Cardinality: [1..1]
RNA Reversion Timeout * Enter a time, in seconds, after which Cisco Unified Communications Manager will distribute a call to the next available or idle member of this line group or to the next line group if the call is not answered and if the first hunt option, Try next member; then, try next group in Hunt List, is chosen. The RNA Reversion Timeout applies at the line-group level to all members. Default: 10
  • Field Name: Line Groups.HuntList.LineGroup.[n].rnaReversionTimeOut
  • Type: Integer
  • Cardinality: [1..1]
  • Default: 10
Distribution Algorithm * Choose a distribution algorithm, which applies at the line-group level, from the options in the drop-down list box: Top Down—If you choose this distribution algorithm, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. Circular—If you choose this distribution algorithm, Cisco Unified Communications Manager distributes a call to idle or available members starting from the (n+1)th member of a route group, where the nth member is the next sequential member in the list who is either idle or busy but not "down." If the nth member is the last member of a route group, Cisco Unified Communications Manager distributes a call starting from the top of the route group. Longest Idle Time—If you choose this distribution algorithm, Cisco Unified Communications Manager only distributes a call to idle members, starting from the longest idle member to the least idle member of a line group. Broadcast—If you choose this distribution algorithm, Cisco Unified Communications Manager distributes a call to all idle or available members of a line group simultaneously. See the Note in the description of the Selected DN/Route Partition field for additional limitations in using the Broadcast distribution algorithm. The default value specifies Longest Idle Time. Default: Longest Idle Time
  • Field Name: Line Groups.HuntList.LineGroup.[n].distributionAlgorithm
  • Type: String
  • Cardinality: [1..1]
  • Default: Longest Idle Time
  • Choices: ["Top Down", "Circular", "Longest Idle Time", "Broadcast"]
Hunt Options No Answer * For a given distribution algorithm, choose a hunt option for Cisco Unified Communications Manager to use if a call is distributed to a member of a line group that does not answer. This option gets applied at the member level. Choose from the options in the drop-down list box: Try next member; then, try next group in Hunt List—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. If unsuccessful, Cisco Unified Communications Manager then tries the next line group in a hunt list. Try next member, but do not go to next group—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. Cisco Unified Communications Manager stops trying upon reaching the last member of the current line group. Skip remaining members, and go directly to next group—If you choose this hunt option, Cisco Unified Communications Manager skips the remaining members of this line group when the RNA reversion timeout value elapses for the first member. Cisco Unified Communications Manager then proceeds directly to the next line group in a hunt list. Stop hunting—If you choose this hunt option, Cisco Unified Communications Manager stops hunting after trying to distribute a call to the first member of this line group and the member does not answer the call. Default: Try next member; then, try next group in Hunt List
  • Field Name: Line Groups.HuntList.LineGroup.[n].huntAlgorithmNoAnswer
  • Type: String
  • Cardinality: [1..1]
  • Default: Try next member; then, try next group in Hunt List
  • Choices: ["Try next member; then, try next group in Hunt List", "Try next member, but do not go to next group", "Skip remaining members, and go directly to next group", "Stop hunting"]
Automatically Logout Hunt Member on No Answer If this check box is checked, line members will be logged off the hunt list automatically. Line members can log back in using the "HLOG" softkey or PLK.
  • Field Name: Line Groups.HuntList.LineGroup.[n].autoLogOffHunt
  • Type: Boolean
  • Cardinality: [0..1]
Hunt Options Busy * For a given distribution algorithm, choose a hunt option for Cisco Unified Communications Manager to use if a call is distributed to a member of a line group that is busy. Choose from the options in the drop-down list box: Try next member; then, try next group in Hunt List—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. If unsuccessful, Cisco Unified Communications Manager then tries the next line group in a hunt list. Try next member, but do not go to next group—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. Cisco Unified Communications Manager stops trying upon reaching the last member of the current line group. Skip remaining members, and go directly to next group—If you choose this hunt option, Cisco Unified Communications Manager skips the remaining members of this line group upon encountering a busy member. Cisco Unified Communications Manager proceeds directly to the next line group in a hunt list. Stop hunting—If you choose this hunt option, Cisco Unified Communications Manager stops hunting after trying to distribute a call to the first busy member of this line group. Default: Try next member; then, try next group in Hunt List
  • Field Name: Line Groups.HuntList.LineGroup.[n].huntAlgorithmBusy
  • Type: String
  • Cardinality: [1..1]
  • Default: Try next member; then, try next group in Hunt List
  • Choices: ["Try next member; then, try next group in Hunt List", "Try next member, but do not go to next group", "Skip remaining members, and go directly to next group", "Stop hunting"]
Hunt Options Not Available * For a given distribution algorithm, choose a hunt option for Cisco Unified Communications Manager to use if a call is distributed to a member of a line group that is not available. The Not Available condition occurs when none of the phones that are associated with the DN in question is registered. Not Available also occurs when extension mobility is in use and the DN/user is not logged in. Choose from the options in the drop-down list box: Try next member; then, try next group in Hunt List—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. If unsuccessful, Cisco Unified Communications Manager then tries the next line group in a hunt list. Try next member, but do not go to next group—If you choose this hunt option, Cisco Unified Communications Manager distributes a call to idle or available members starting from the first idle or available member of a line group to the last idle or available member. Cisco Unified Communications Manager stops trying upon reaching the last member of the current line group. Skip remaining members, and go directly to next group—If you choose this hunt option, Cisco Unified Communications Manager skips the remaining members of this line group upon encountering the first unavailable member. Cisco Unified Communications Manager proceeds directly to the next line group in a hunt list. Stop hunting—If you choose this hunt option, Cisco Unified Communications Manager stops hunting after trying to distribute a call to the first unavailable member of this line group. Default: Try next member; then, try next group in Hunt List
  • Field Name: Line Groups.HuntList.LineGroup.[n].huntAlgorithmNotAvailable
  • Type: String
  • Cardinality: [1..1]
  • Default: Try next member; then, try next group in Hunt List
  • Choices: ["Try next member; then, try next group in Hunt List", "Try next member, but do not go to next group", "Skip remaining members, and go directly to next group", "Stop hunting"]
Members
  • Field Name: members
  • Type: ["Object", "Null"]
  • Cardinality: [0..1]
Member
  • Field Name: member.[n]
  • Type: Array
Directory Number The uuid attribute is read here
  • Field Name: directoryNumber
  • Type: ["Object", "Null"]
  • Cardinality: [1..1]
Directory Number * Select from the drop-down list. This list includes any patterns that are available from the associated route partition.
  • Field Name: Line Groups.HuntList.LineGroup.[n].members.member.[n].directoryNumber.pattern
  • Type: String
  • Target: device/cucm/Line
  • Target attr: pattern
  • Cardinality: [1..1]
  • Format: uri
Partition * Select from the drop-down list. The drop-down list includes any route partitions to which the associated pattern belongs, and must match the route partition name for the directory number when it was originally created.
  • Field Name: Line Groups.HuntList.LineGroup.[n].members.member.[n].directoryNumber.routePartitionName
  • Type: ["String", "Null"]
  • Target: device/cucm/RoutePartition
  • Target attr: name
  • Cardinality: [1..1]
  • Format: uri
Position
  • Field Name: Line Groups.HuntList.LineGroup.[n].members.member.[n].lineSelectionOrder
  • Type: Integer
  • Cardinality: [1..1]
API reference for relation/HuntGroupRelation