Cisco IOS Software Releases 12.1 T

Table Of Contents

Enhancement to Rotary Dial Peer Voice Hunting

Benefits

Restrictions

Related Documents

Supported Platforms

Supported Standards, MIBs, and RFCs

Configuration Tasks

Configuring Rotary Dial-Peer Hunting Settings

Command Reference

voice hunt

Enhancement to Rotary Dial Peer Voice Hunting

---

Feature History

Release	Modification
12.0(5)T	This command was introduced as the voice hunt user-busy command on the Cisco 2600 series, 3600 series, and 7200 series routers, for VoFR. It was also supported for VoIP on the 2600 series and 3600 series routers.
12.0(7)T	This command was first supported on the Cisco AS5300 and Cisco AS5800 for VoIP.
12.0(7)XK	This command was first used for VoIP on the Cisco MC3810 multiservice concentrator.
12.1(2)T	The support for VoIP on the Cisco MC3810 multiservice concentrator was integrated into Cisco IOS Release 12.1(2)T.
12.1(3)XI	The invalid-number and unassigned-number keywords were added, and the command name was changed to voice hunt.
12.1(5)T	The changes made in the Cisco IOS 12.1(3)XI release were first implemented on the T train.

In previous releases, using the voice-hunt user-busy command, you could set an originating or tandem router to continue dial-peer hunting if it received a user-busy disconnect cause code from a destination router. In this release, this functionality has been enhanced to control dial-peer hunting for other disconnect cause codes from a destination router.

Benefits

These enhancements provide the following improvements:

•Allows you to set the router to continue or stop rotary dial-peer hunting if it receives an invalid-number disconnect cause code from a destination router.

•Allows you to set the router to continue or stop rotary dial-peer hunting if it receives an unassigned-number disconnect cause code from a destination router.

Restrictions

None

Related Documents

Cisco IOS Multiservice Applications Configuration Guide, Cisco IOS Release 12.1

Cisco IOS Multiservice Applications Command Reference, Cisco IOS Release 12.1

Supported Platforms

Cisco AS5300

Supported Standards, MIBs, and RFCs

None

Configuration Tasks

The following task is used for this enhancement

•Configuring Rotary Dial-Peer Hunting Settings

Configuring Rotary Dial-Peer Hunting Settings

To configure an originating or tandem router to continue or discontinue rotary dial-peer hunting based on specific disconnect cause codes, use the following command beginning in global configuration mode:

	Command	Purpose
Step 1	router(config)# voice hunt {user-busy | invalid-number | unassigned-number}	Specifies whether the originating router will continue or discontinue rotary dial-peer hunting if the originating router receives a user-busy, invalid-number, or an unassigned-number disconnect cause code from a destination router.

Command Reference

This section documents the following modified command:

•voice hunt

voice hunt

To configure how an originating or tandem router handles rotary dial-peer hunting if it receives specific disconnect cause codes from a destination router, use the voice hunt global-configuration command. To set the router to stop dial-peer hunting if it receives a specific disconnect cause code, use the no form of the command.

voice hunt {user-busy | invalid-number | unassigned-number}

no voice hunt {user-busy | invalid-number | unassigned-number}

Syntax Description

user-busy	Sets the router to continue dial-peer hunting if it receives a user-busy disconnect cause code from a destination router.
invalid-number	Sets the router to stop dial-peer hunting if it receives a an invalid-number disconnect cause code from a destination router.
unassigned-number	Sets the router to stop dial-peer hunting if it receives an unassigned-number disconnect cause code from a destination router.

Defaults

The default depends on the disconnect cause code. By default, the router stops dial-peer hunting if it receives the user-busy disconnect cause code. By default, the router continues dial-peer hunting if it receives an invalid-number, or an unassigned-number disconnect cause code.

Command Modes

Global configuration

Command History

Release	Modification
12.0(5)T	This command was introduced as the voice hunt user-busy command on the Cisco 2600 series, 3600 series, and 7200 series routers, for VoFR. It was also supported for VoIP on the 2600 series and 3600 series routers.
12.0(7)T	This command was first supported on the Cisco AS5300 and Cisco AS5800 for VoIP.
12.0(7)XK	This command was first used for VoIP on the Cisco MC3810 multiservice concentrator.
12.1(2)T	The support for VoIP on the Cisco MC3810 multiservice concentrator was integrated into Cisco IOS Release 12.1(2)T.
12.1(3)XI	The invalid-number and unassigned-number keywords were added, and the command name was changed to voice hunt.
12.1(5)T	The changes made in the Cisco IOS 12.1(3)XI release were first implemented on the T train.

Usage Guidelines

This command applies to routers acting as originating or tandem nodes in a Voice over IP, Voice over Frame Relay, or Voice over ATM environment.

This command is used for a configuration in which an originating or tandem router is configured with multiple dial peer entries that route a call to the same destination number, but on different destination routers. In this configuration, after all routes to the first router entry in the dial-peer list are active, a new call will not "roll over" to the next router in the dial-peer list.

This failure to route to the second destination router happens when the bandwidth on the voice interface is greater than the maximum capacity of the first destination router. This condition allows the originating or tandem router to attempt to place a new call to the first destination router because it has indications from the first destination router that there is more capacity based on the bandwidth setting. When the first destination router receives the call, if all of the ports are in use, the destination router returns a "user-busy" disconnect reason code to the originating or tandem router. The originating or tandem router interprets the disconnect reason code as "unavailable destination" for the call and returns a busy tone to the initiating caller.

The originating or tandem router fails to try other routers in the dial-peer list after receiving a "user disconnect" reason code, and so it terminates the call attempt. Using this command, you can perform dial-peer hunting on multiple destination routers even if the originating or tandem router receives a "user-busy" disconnect reason code from one of the destination routers.

Examples

The following example displays configuring the originating or tandem router to continue dial-peer hunting if it receives a "user-busy" disconnect code from a destination router:

Router(config)# voice hunt user-busy

The following example displays configuring the originating or tandem router to continue dial-peer hunting if it receives an "invalid-number" disconnect code from a destination router:

Router(config)# voice hunt invalid-number

Related Commands

Command	Description
huntstop	Disables all further dial-peer hunting if a call fails when using hunt groups.
preference	Indicates the preferred order of a dial peer within a rotary hunt group.