Effective with Cisco IOS Release 12.3(14)T and later, the call application voice aa-hunt command is replaced by the param aa-hunt command. See the param aa-hunt command for more information.

To declare a Cisco Unified CME basic automatic call distribution (B-ACD) menu number and associate it with the pilot number of an ephone hunt group, use the call application voice aa-hunt command in global configuration mode. To remove the menu number and the ephone hunt group pilot number, use the no form of this command.

Syntax Description

Command Default

Cisco CME B-ACD menu number 1 is configured, but it has no pilot number.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD call queue scripts. Up to three menu options are allowed per call queue script. You can use any of the allowable numbers in any order.

The call application voice aa-hunt command allows each of the menu options to be associated with the pilot number of an ephone hunt group. The menu options are announced by the en_bacd_options_menu.au audio file, which you can rerecord. When a caller presses a number, the call will go to the pilot number of an ephone hunt group so it can be transferred to one of the ephone hunt group’s ephone-dns. It will not go to any other ephone hunt group. The order in which ephone-dns are selected depends on the ephone hunt group’s search method, which is configured with the ephone-hunt command, and whether an ephone-dn is busy or not.

If only one menu option is configured, callers will hear a greeting and be transferred directly to the pilot number of the corresponding ephone hunt group. They do not have to enter a number.

The highest aa-hunt number will automatically be set to zero (0) for the operator. In the following example, aa-hunt8 supports the menu option of 0 and 8.

call application voice queue aa-hunt1 1111
call application voice queue aa-hunt3 3333
call application voice queue aa-hunt8 8888
 

If a phone user presses 0 or 8, their call be sent to pilot number 3333.

For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.

Related Commands

Effective with Cisco IOS Release 12.3(14)T and later, the call application voice aa-name command is not available in Cisco IOS software.

To associate the queue script for Cisco Unified CME basic automatic call distribution (B-ACD) with the Cisco Unified CME B-ACD auto-attendant (AA) script, use the call application voice aa-name command in global configuration mode. To remove the queue script and AA script association, use the no form of this command.

Syntax Description

Command Default

No call queue script and AA script association is configured.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD call queue scripts. Only one AA script can be associated with one call queue script.

For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.

Related Commands

Effective with Cisco IOS Release 12.3(14)T and later, the call application voice aa-pilot command is replaced by the param aa-pilot command. See the param aa-pilot command for more information.

To assign a pilot number to the Cisco Unified CME basic automatic call distribution (B-ACD) service, use the call application voice aa-pilot command in global configuration mode. To remove the Cisco Unified CME B-ACD pilot number, use the no form of this command.

Syntax Description

Command Default

No Cisco Unified CME B-ACD pilot number is configured.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco CME B-ACD AA scripts. Only one pilot number can be used for each Cisco Unified CME B-ACD service, and the voice ports handling AA must have dial peers that will send calls to the pilot number.

For any configuration changes to take effect, you must reload the Cisco Unified CME B-ACD scripts.

Related Commands

Effective with Cisco IOS Release 12.3(14)T and later, the call application call-retry-timer command is replaced by the param call-retry-timer command. See the param call-retry-timer command for more information.

To assign the length of time that calls to Cisco Unified CME basic automatic call distribution (B-ACD) must wait before attempting to transfer to an ephone hunt group pilot number, use the call application voice call-retry-timer command in global configuration mode. To remove the retry time, use the no form of this command.

Syntax Description

Command Default

The retry interval is 15 seconds.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco CME B-ACD AA scripts. The following sequence of events might occur:

• An outside call comes into a system configured with Cisco CME B-ACD.
• A menu option is selected that attempts to transfer the call to an ephone hunt group pilot number.
• All of the ephone hunt group’s ephone-dns are busy.

In that case, the call will wait in a queue for the period of time set by the call application voice call-retry-timer command and retry to the pilot number.

For any configuration changes to take effect, you must reload the Cisco Unified CME B-ACD scripts.

Related Commands

Effective with Cisco IOS Release 12.3(14)T and later, the call application dial-by-extension-option command is replaced by the param dial-by-extension-option command. See the param dial-by-extension-option command for more information.

To enable direct extension access and set the access number for Cisco Unified CME basic automatic call distribution (B-ACD), use the call application voice dial-by-extension-option command in global configuration mode. To disable direct dial extension access and remove the access number, use the no form of this command.

Syntax Description

Command Default

Direct dial access is disabled. No access number is configured.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. It enables the en_bacd_enter_dest.au audio file. The default announcement says, “Please enter the extension number you want to reach.” The call application voice dial-by-extension-option command also allows for the configuration of the number that callers must press before they can enter the extension number that they want to call.

Callers who select the extension access option can then dial any extension. If they dial an ephone hunt group ephone-dn or pilot number, their call will not be sent to the ephone hunt-group call queue.

Related Commands

Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases, the call application voice drop-through-option command has been replaced by the param drop-through-option command.

Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases, the call application voice drop-through-prompt command has been replaced by the param drop-through-prompt command.

Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases, the call application voice handoff-string command has been replaced by the param handoff-string command.

Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases, the call application voice max-extension-length command has been replaced by the param max-extension-length command.

Effective with Cisco IOS Release 12.3(14)T and later, the call application voice max-time-call-retry command is replaced by the param max-time-call-retry command. See the param max-time-call-retry command for more information.

To assign the maximum length of time for which calls to Cisco Unified CME basic automatic call distribution (B-ACD) can stay in a call queue, use the call application voice max-time-call-retry command in global configuration mode. To remove the maximum length of time, use the no form of this command.

Syntax Description

Command Default

The default maximum length of time that calls can stay in a call queue is 600 seconds.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. The call application voice max-time-retry command allows you set a time limit for the redialing of pilot numbers under the following circumstances:

• An outside call comes into a system configured with Cisco Unified CME B-ACD.
• A menu option is selected that transfers the call to an ephone hunt-group pilot number.
• All of the ephone hunt group’s ephone-dns are busy.
• The call is sent to a queue and tries the pilot number at intervals of time set by the call application voice call-retry-timer command.

When the time period set by the call application voice max-call-retry command expires, one of the following two events will occur:

• If a voice-mail pilot number has been configured in Cisco Unified CME and mail boxes for hunt group pilot numbers have been configured in a voice-mail application, calls will be transferred to voice mail.
• If voice mail has not been configured, a default message will be played that says, “We are unable to take your call at this time. Please try again at a later time. Thank you for calling.”

Related Commands

Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases, the call application voice max-time-vm-retry command has been replaced by the param max-time-vm-retry command.

Effective with Cisco IOS Release 12.3(14)T and later, the call application voice number-of-hunt-grps command is replaced by the param number-of-hunt-grps command. See the param number-of-hunt-grps command for more information.

To declare the maximum number of ephone hunt-group menus supported by Cisco Unified CME basic automatic call distribution (B-ACD), use the call application voice number-of-hunt-grps command in global configuration mode. To remove the maximum number of ephone hunt-group menus supported by Cisco CME B-ACD, use the no form of this command.

Syntax Description

Command Default

Three ephone hunt-group menus are supported by Cisco CME B-ACD.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. The number argument declares the number of ephone hunt groups only. The menu option for direct extension access (see the call application voice dial-by-extension-option command) is not included.

Related Commands

Effective with Cisco IOS Release 12.3(14)T and later, the call application queue-len command is replaced by the param queue-len command. See the param queue-len command for more information.

To set the maximum number of calls allowed for each ephone hunt group’s call queue that is used by Cisco Unified CME basic automatic call distribution (B-ACD), use the call application voice queue-len command in global configuration mode. To remove the queue-length setting, use the no form of this command.

Command Default

Command Default

Thirty calls are allowed in each call queue.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD call queue scripts. The following sequence of events might occur:

• An outside call comes into a system configured with Cisco Unified CME B-ACD.
• A menu option is selected that transfers the call to an ephone hunt-group pilot number.
• All of the ephone hunt group’s ephone-dns are busy.

In that case, the call will be sent to a queue for that individual hunt group. The number of calls that each ephone hunt group can hold in its queue is configured by the call application voice queue-len command.

In the following configuration example, ephone hunt group 1 supports two ephone-dns; ephone hunt group 2 supports three ephone-dns; and the queue length is 10 for both ephone hunt groups:

ephone-hunt 1 peer
 pilot 1111
 list 1001, 1002
ephone-hunt 2 peer
 pilot 2222
 list 2001, 2002, 2003
call application voice queue flash:app-b-acd-x.x.x.x.tcl
call application voice callqueuescriptfilename queue-len 10

If ephone hunt group 1’s ephone-dns are busy, ten more calls can be made to ephone hunt group 1. During that time, the calls in the queue would periodically retry the pilot numbers (call application voice max-time-retry-timer command) and receive secondary greetings (call application voice second-greeting-time command). If none of the calls has hung up or connected to an ephone-dn, the eleventh caller would hear the en_bacd_disconnect.au message and a busy signal. The default message is, “We are unable to take your call at this time. Please try again at a later time. Thank you for calling.” Includes a four-second pause after the message.

For ephone hunt group 2, three calls can be connected to ephone-dns 2001, 2002, and 2003, and ten calls can be waiting in ephone hunt group 2’s queue. If the status remains unchanged, the fourteenth caller hears the disconnect message and a busy signal. But if one of the earlier calls disconnects (either by leaving the queue or by ending a call), the fourteen call enters the queue.

The maximum number of calls allowed in the queues of ephone hunt groups must be based on the number of ports or trunks available. For example, if you had 20 foreign exchange office (FXO) ports and two ephone hunt groups, you could configure a maximum of ten calls per ephone hunt-group queue with the call application voice queue-len 10 command. You could use the same configuration if you had a single T1 trunk, which supports 23 channels.

Related Commands

Effective with Cisco IOS Release 12.3(14)T and later, the call application queue-manager-debugs command is replaced by the param queue-manager-debugs command. See the param aa-hunt command for more information.

To enable or disable the collection of call queue debug information from Cisco CallManager Express (Cisco CME) basic automatic call distribution (B-ACD), use the call application voice queue-manager-debugs command in global configuration mode. To remove the current setting, use the no form of this command with the keyword that was used in the previous occurrence of the call application voice queue-manager-debugs command.

Syntax Description

Command Default

The collection of call queue debug information from Cisco CME B-ACD is disabled.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco CME B-ACD call queue scripts. It enables the collection of data regarding call queue activity. It is used in conjunction with the debug voip ivr script command. Both commands must be enabled at the same time.

For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.

Related Commands

Effective with Cisco IOS Release 12.3(14)T and later, the call application voice second-greeting-time command is replaced by the param second-greeting-time command. See the param second-greeting-time command for more information.

To set the delay before the second greeting is played after a caller joins a Cisco Unified CME basic automatic call distribution (B-ACD) calling queue and set the interval of time at which the second-greeting message is repeated, use the call application voice second-greeting-time command in global configuration mode. To remove the second-greeting time, use the no form of this command.

Syntax Description

Command Default

The second-greeting delay time is 60 seconds.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. A second greeting is an audio message of up to 15 seconds in length. The default announcement is, “All agents are currently busy assisting other customers. Continue to hold for assistance. Someone will be with you shortly.” The second-greeting message is only presented to callers waiting in a CME B-ACD call queue.

The second-greeting time is clocked when the second-greeting message begins, not after it ends. For example, if the second greeting were 15 seconds in length and the configured second-greeting time were 70 seconds, the greeting would begin every 70 seconds, not 85 seconds as if to allow for the 15-second message.

For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.

Related Commands

Cisco IOS Release 12.3(14)T and later releases support Cisco CME Basic Automatic Call Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases, the call application voice service-name command has been replaced by the param service-name command.

Effective with Cisco IOS Release 12.3(14)T and later, the call application voice voice-mail command is replaced by the param voice-mail command. See the param voice-mail command for more information.

To assign a pilot number for the Cisco Unified CME basic automatic call distribution (B-ACD) service’s voice mail, use the call application voice voice-mail command in global configuration mode. To remove the voice-mail pilot number, use the no form of the command.

Syntax Description

Command Default

No voice-mail pilot number is configured for Cisco Unified CME B-ACD.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. Only one pilot number is allowed per Cisco CME B-ACD service. Calls to the service will be sent to this voice mail number.

For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.

Related Commands

Effective with Cisco IOS Release 12.3(14)T and later, the call application voice welcome-prompt command is replaced by the param welcome-prompt command. See the param welcome-prompt command for more information.

To assign an audio file that is used by the Cisco Unified CME basic automatic call distribution (B-ACD) auto-attendant (AA) script for the welcome greeting, use the call application welcome-prompt command in global configuration mode. To remove the audio file assignment, use the no form of this command.

Syntax Description

Command Default

The welcome audio file downloaded with Cisco Unified CME B-ACD is used for the welcome prompt.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier than 2.1.0.0 and is valid only for the configuration of Cisco CME B-ACD AA scripts. The welcome greeting is the initial AA response to a caller. The default audio file used is en_bacd_welcome.au, which is is downloaded with Cisco CME B-ACD and announces, “Thank you for calling,” and includes a two-second pause after the message.

The filename must be preceded by an underscore (_) character. In addition, it must not contain a language-code prefix, such as “en” for English. For example, for en_bacd_welcome.au, you must configure welcome-prompt _bacd_welcome.au instead of welcome-prompt _en_bacd_welcome.au.

For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.

Related Commands

To route an E911 callback to another number (for example, the company operator) if the callback cannot find the last 911 caller associated to the ELIN, use the callback command in voice emergency response settings configuration mode. This command is optional.

Syntax Description

Command Default

A callback number is not defined.

Command Modes

Voice emergency response settings configuration (cfg-emrgncy-resp-settings)

Command History

Usage Guidelines

Use this command to specify the default number to contact if a 911 callback cannot find the last 911 caller associated with an ELIN. If no default callback number is configured, and the expiry time is exceeded, the 911 operator may hear a reorder tone or be incorrectly routed.

Related Commands

To specify whether to pass the local caller ID or the original caller ID with calls from an extension in Cisco Unified CME that is using loopback, use the callerid command in ephone-dn configuration mode. To return to the default, use the no form of this command.

Syntax Description

Command Default

Default is passthrough.

Command Modes

Ephone-dn configuration (config-ephone)

Command History

Usage Guidelines

This command is valid only for ephone-dns that are being used for loopback.

This command with the local keyword is applied as follows:

• For transferred calls, caller ID is provided by the original caller-ID information source, such as from a separate loopback-dn that handles inbound calls or from a public switched telephone network interface.
• For forwarded calls, caller ID is provided by the original caller-ID information source or, for local IP phones, is extracted from the redirected information associated with the call.

This command with the passthrough keyword is applied as follows:

• For transferred calls, the caller ID is provided by the original caller-ID information that is obtained from the inbound side of the loopback-dn.
• For forwarded calls, the caller ID is provided by the original caller-ID information of the incoming call.

Related Commands

To specify caller-ID blocking for outbound calls from a specific extension, use the callerid block command in ephone-dn or ephone-dn-template configuration mode. To disable caller-ID blocking for outbound calls, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Caller-ID display is not blocked on calls originating from a Cisco Unified IP phone.

Command Modes

Ephone-dn configuration
Ephone-dn-template configuration

Command History

Usage Guidelines

This command sets caller-ID blocking for outbound calls originating from a specific extension (ephone-dn). This command requests the far-end gateway device to block the display of the calling party information for calls received from the ephone-dn that is being configured. This command does not affect the ephone-dn calling party information display for inbound calls received by the ephone-dn.

If you want caller-ID name or number to be available on local calls but not on external calls, use the clid strip name command or the clid strip command in dial-peer configuration mode to remove caller-ID name or number from calls to VoIP. In this case, do not also use the caller-id block command, which blocks caller-ID information on all calls.

Note	This command is not valid for ephone-dns that are being used for loopback.

If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn configuration mode has priority.

Related Commands

Note	Effective with Cisco IOS Release 12.4(11)XJ, the callerid block (voice register template) command is not available in Cisco IOS software.

To enable caller-ID blocking for outbound calls from a specific SIP phone, use the callerid block command in voice register template configuration mode. To disable caller-ID blocking, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Caller ID blocking is disabled.

Command Modes

Voice register template configuration (config-register-temp)

Command History

Usage Guidelines

This command sets caller-ID blocking for outbound calls originating from any SIP phone that uses the specified template. This command requests the far-end gateway device to block the display of the calling party information for calls received from the specified SIP phone. This command does not affect the calling party information displayed for inbound calls received by the SIP phone. To apply a template to a SIP phone, use the template command in voice register pool configuration mode.

Related Commands

To set a code for a user to dial to block the display of caller ID on selected outgoing calls from Cisco IP phones, use the caller-id block code command in telephony-service configuration mode. To remove the code, use the no form of this command.

Syntax Description

Command Default

No caller-ID blocking code is defined.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Usage Guidelines

Once the caller-ID blocking code has been defined using this command, phone users should enter the caller-ID blocking code before dialing any call on which they want their caller ID not to display.

Related Commands

To specify the uniform resource identifier (URI) for soft keys on SIP phones registered to a Cisco Unified CME router, use the call-feature-uri command in voice register global configuration mode. To remove a URI association, use the no form of this command.

Syntax Description

Command Default

No URI is associated with the soft key.

Command Modes

Voice register global configuration (config-register-global)

Command History

Usage Guidelines

This command updates the service URI for soft keys in the configuration file that is downloaded from the Cisco Unified CME router to the SIP phones during phone registration.

For Call Forward All, this URI and the call forward number is sent to Cisco Unified CME when a user enables Call Forward All from the phone using the CfwdAll soft key.

After you configure this command, restart the phone by using the reset or restart command.

This command is not supported on the Cisco Unified IP Phone 7905, 7912, 7940, or 7960.

Related Commands

To globally apply dialplan-pattern expansion to redirecting numbers for extension numbers associated with SCCP IP phones in Cisco Unified CME, use the call-forward system command in telephony-service configuration mode. To disable the call-forward system command, use the no form of this command.

Syntax Description

Command Default

The redirecting number is not expanded.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Usage Guidelines

Use this command to apply dialplan-pattern expansion on a per-system basis to individual nonSIP redirecting numbers, including original called and last reroute numbers, in a Cisco Unified CME system.

When A calls B, and B forwards the call to C; B is the original called number and the last reroute number. If C then forwards or transfers the call to another number, C becomes the original called number and the last reroute number. The dial-plan pattern expansion is applied to both redirecting numbers. Once the number is expanded, it remains expanded during the entire call instance.

The dial-plan pattern to be matched must be configured using the dialplan-pattern command.

Related Commands

To globally apply dialplan-pattern expansion to redirecting numbers for extension numbers associated with SIP IP phones in Cisco Unified CME, use the call-forward system command in voice register global configuration mode. To disable the call-forward system command, use the no form of this command.

Syntax Description

Command Default

The redirecting number is not expanded.

Command Modes

Voice register global configuration (config-register-global)

Command History

Usage Guidelines

Use this command to apply dialplan-pattern expansion on a per-system basis to individual SIP redirecting numbers, including original called and last reroute numbers, in Cisco Unified CME.

When A calls B, and B forwards the call to C; B is the original called number and the last reroute number. If C then forwards or transfers the call to another number, C becomes the original called number and the last reroute number. The dial-plan pattern expansion is applied to both redirecting numbers. Once the number is expanded, it remains expanded during the entire call instance.

This command supports call forward using B2BUA only.

The dial-plan pattern to be matched must be configured using the dialplan-pattern command.

Related Commands

To configure call forwarding so that all incoming calls to a directory number are forwarded to another directory number, use the callforward all command in ephone-dn or ephone-dn-template configuration mode. To disable call forwarding, use the no form of this command.

Syntax Description

Command Default

Call forwarding for all calls is not set.

Command Modes

Ephone-dn configuration (config-ephone-dn)
Ephone-dn-template configuration (config-ephone-dn-template)

Command History

Usage Guidelines

The call forwarding mechanism applies to the individual directory number and cannot be configured for individual Cisco Unified IP phones.

Note	The callforward all command takes precedence over the call-forward busy and call-forward noan commands.

If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn configuration mode has priority.

Related Commands

To enable call forwarding for a Session Initiation Protocol (SIP) back-to-back user agent (B2BUA) so that all incoming calls are forwarded to another extension, use the callforward b2bua all command in voice register dn or voice register pool configuration mode. To disable call forwarding, use the no form of this command.

Syntax Description

Command Default

Feature is disabled.

Command Modes

Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)

Command History

Usage Guidelines

This command in voice register dn configuration mode applies the call forward mechanism to a individual SIP extension in Cisco Unified CME or Cisco Unified SIP SRST. This command in voice register pool configuration mode is for Cisco Unified SIP SRST only and applies to SIP IP phones on which the extension appears.

If this command is configured in both the voice register dn and voice register pool configuration modes, the configuration under voice register dn takes precedence.

We recommend that you do not use this command to configure a SIP extension or SIP IP phone that is a member of a hunt group. If this command is configured for a member of a hunt group, remove the phone from any hunt group to which it is assigned to avoid forwarding calls to all phones in the hunt group.

The call-forward b2bua all command takes precedence over the call-forward b2bua busy and call-forward b2bua noan commands.

Note	This command in voice register dn configuration mode is not commonly used for Cisco Unified SIP SRST.

Related Commands

To enable call forwarding for a Session Initiation Protocol (SIP) back-to-back user agent (B2BUA) so that incoming calls to a busy extension are forwarded to another extension, use the callforward b2bua busy command in voice register dn or voice register pool configuration mode. To disable call forwarding, use the no form of this command.

Syntax Description

Command Default

Feature is disabled.

Command Modes

Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)

Command History

Usage Guidelines

This command in voice register dn configuration mode applies the call forward mechanism to a individual SIP extension in Cisco Unified CME or Cisco Unified SIP SRST that is off-hook. This command in voice register pool configuration mode is for Cisco Unified SIP SRST only and applies to SIP IP phones on which the extension appears.

In Cisco Unified CME, call forward busy is also invoked when a call arrives for a destination that is configured but unregistered. A destination is considered to be configured if its number is listed under the voice register dn configuration.

If this command is configured in both voice register dn and voice register pool configuration modes, the configuration under voice register dn takes precedence.

We recommend that you do not use this command to configure a SIP extension or SIP IP phone that is a member of a hunt group. If this command is configured for a member of a hunt group, remove the phone from any hunt group to which it is assigned to avoid forwarding calls to all phones in the hunt group.

The call-forward b2bua all command takes precedence over the call-forward b2bua busy and call-forward b2bua noan commands.

Note	This command in voice register dn configuration mode is not commonly used for Cisco Unified SIP SRST.

Related Commands

To control the specific voice-mail box selected in a voice-mail system at the end of a call forwarding exchange, use the callforward b2bua mailbox command in voice register dn or voice register pool configuration mode. To disable call forwarding, use the no form of this command.

Syntax Description

Command Default

Feature is disabled.

Command Modes

Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)

Command History

Usage Guidelines

This command is used to denote the voice-mail box to use at the end of a chain of call forwards to busy or no answer destinations. It can be used to forward calls to a voice-mail box that has a different number than the forwarding extension, such as a shared voice-mail box.

This command in voice register dn configuration mode applies the call forward mechanism to a individual SIP extension in Cisco Unified CME or Cisco Unified SIP SRST. This command in voice register pool configuration mode is for Cisco Unified SIP SRST only and applies to SIP IP phones on which the extension appears.

If this command is configured in both the voice register dn and voice register pool configuration modes, the configuration under voice register dn takes precedence.

We recommend that you do not use this command to configure a SIP extension or SIP IP phone that is a member of a hunt group. If this command is configured for a member of a hunt group, remove the phone from any hunt group to which it is assigned to avoid forwarding calls to all phones in the hunt group.

This command is used in conjunction with the call-forward b2bua all, call-forward b2bua busy, and call-forward b2bua noan commands.

Note	This command in voice register dn configuration mode is not commonly used for Cisco Unified SIP SRST.

Related Commands

To automatically forward calls to another number during night-service hours, use the call-forward b2bua night-service command in voice register dn configuration mode. To remove the code, use the no form of this command.

Syntax Description

Command Default

Calls are not forwarded during night-service hours.

Command Modes

Voice register dn configuration: (config-register-dn)

Command History

Usage Guidelines

You need to configure the night-service bell command under voice register dn. Night-service hours are defined using the night-service date and night-service day commands.

A voice register dn can have all other types of call forwarding defined at the same time: all-calls, no-answer, busy, and night-service. Each type of call forwarding can have a different forwarding destination defined in its target-number argument. If more than one type of call forwarding is in effect (is active) at one time, the precedence order for evaluating the different types is as follows:

• call forward night-service (only during night service hours)

• call forward all

• call forward busy and call forward no answer

Related Commands

To enable call forwarding for a Session Initiation Protocol (SIP) back-to-back user agent (B2BUA) so that incoming calls to an extension that does not answer after a configured amount of time are forwarded to another extension, use the callforward b2bua noan command in voice register dn or voice register pool configuration mode. To disable call forwarding, use the no form of this command.

Syntax Description

Command Default

Feature is disabled.

Command Modes

Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)

Command History

Usage Guidelines

This command in voice register dn configuration mode applies the call forward mechanism to a individual SIP extension in Cisco Unified CME or Cisco Unified SIP SRST that remains unanswered after a specified length of time. This command in voice register pool configuration mode is for Cisco Unified SIP SRST only and applies to SIP IP phones on which the extension appears.

If this command is configured in both the voice register dn and voice register pool configuration modes, the configuration under voice register dn takes precedence.

We recommend that you do not use this command to configure a SIP extension or SIP IP phone that is a member of a hunt group. If this command is configured for a member of a hunt group, remove the phone from any hunt group to which it is assigned to avoid forwarding calls to all phones in the hunt group.

The call-forward b2bua all command takes precedence over the call-forward b2bua busy and call-forward b2bua noan commands.

Note	This command in voice register dn configuration mode is not commonly used for Cisco Unified SIP SRST.

Related Commands

Note	Effective with Cisco IOS Release 12.4(11)XJ, the callforward b2bua unreachable command is not available in Cisco IOS software.

To forward calls to a phone that is not registered to Cisco Unified CME, use the callforward b2bua unreachable command in voice register dn or voice register pool configuration mode. To disable call forwarding, use the no form of this command.

Syntax Description

Command Default

Feature is disabled

Command Modes

Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)

Command History

Usage Guidelines

Call forward unreachable is triggered when a call arrives for a destination that is configured but unregistered with Cisco CME. A destination is considered to be configured if its number is listed under the voice register pool or voice register dn configurations.

If call forward unreachable is not configured for a pool or directory number (DN) register, any calls that match the numbers in that pool or DN register will use call forward busy instead.

We recommend that you do not use this command with hunt groups. If the command is used, consider removing the phone from any assigned hunt groups, unless you want to forward calls to all phones in the hunt group.

Related Commands

To configure call forwarding so that incoming calls to a busy extension (ephone-dn) are forwarded to another extension, use the callforward busy command in ephone - dn or ephone-dn-template configuration mode. To disable call forwarding, use the no form of this command.

Syntax Description

Command Default

Call forwarding for a busy extension is not enabled.

Command Modes

Ephone-dn configuration (config-dn-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)

Command History

Usage Guidelines

The call forwarding mechanism is applied to an individual extension (ephone-dn) and is not applied to the phone on which the extension appears.

Normally, call forwarding is applied to all dial peers that are created by the ephone-dn. An ephone-dn can create up to four dial peers:

• A dial peer for the primary number
• A dial peer for the secondary number
• A dial peer for the primary number as expanded by the dialplan-pattern command
• A dial peer for the secondary number as expanded by the dialplan-pattern command

The primary, secondary, and dialplan-pattern keywords allow you to apply call forwarding selectively to one or more dial peers based on the exact called number that was used to route the call to the ephone-dn. If none of the optional keywords is used, call forwarding applies to all dial-peers that are defined for the ephone-dn.

An ephone-dn can have all four types of call forwarding defined at the same time: all-calls, no-answer, busy, and night-service. Each type of call forwarding can have a different forwarding target defined in its target-number argument. If more than one type of call forwarding is in effect (is active) at one time, the precedence order for evaluating the different types is as follows:

1. call forward night service
2. call forward all
3. call forward busy and call forward no answer

If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn configuration mode has priority.

Related Commands

To restrict the number of digits that can be entered using the CfwdALL soft key on an IP phone, use the callforward max-length command in ephone-dn or ephone-dn-template configuration mode. To remove a restriction on the number of digits that can be entered, use the no form of this command.

Syntax Description

Command Default

There is no restriction on the number of digits that can be entered.

Command Modes

Ephone-dn configuration (config-dn-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)

Command History

Usage Guidelines

This command can be used to prevent a phone user from using the CfwdALL soft key on an IP phone to forward calls to numbers that will incur toll charges when they receive forwarded calls.

If the length argument is set to 0, the CfwdALL soft key is completely disabled. If the ephone-dn associated with the first line button has an active call forward number when this command is used to set the length argument to 0, the CfwdALL soft key will be disabled after the next phone restart.

The restriction created by this command does not apply to destinations that are entered using the Cisco IOS command-line interface (CLI) or the Cisco Unified CME GUI.

If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn configuration mode has priority.

Related Commands

To automatically forward calls to another number during night-service hours, use the call-forward night-service command in ephone-dn or ephone-dn-template configuration mode. To disable automatic call forwarding during night service, use the no form of this command.

Syntax Description

Command Default

Calls are not forwarded during night-service hours.

Command Modes

Ephone-dn configuration (config-dn-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)

Command History

Usage Guidelines

You must also configure the night-service bell command for this ephone-dn.

Night-service hours are defined using the night-service date and night-service day commands.

An ephone-dn can have all four types of call forwarding defined at the same time: all-calls, no-answer, busy, and night-service. Each type of call forwarding can have a different forwarding destination defined in its target-number argument. If more than one type of call forwarding is in effect (is active) at one time, the precedence order for evaluating the different types is as follows:

1. call forward night-service
2. call forward all
3. call forward busy and call forward no answer

If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn configuration mode has priority.

Related Commands

To configure call forwarding so that incoming calls to an extension (ephone-dn) that does not answer are forwarded to another number, use the callforward noan command in ephone - dn or ephone-dn-template configuration mode. To disable call forwarding, use the no form of this command.

Syntax Description

Command Default

Call forwarding for an extension that does not answer is not enabled.

Command Modes

Ephone-dn configuration (config-dn-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)

Command History

Usage Guidelines

The call forwarding mechanism is applied to an individual extension (ephone-dn) and is not applied to the phone on which the extension appears.

Normally, call forwarding is applied to all dial peers that are created by the ephone-dn. An ephone-dn can create up to four dial peers:

• A dial peer for the primary number
• A dial peer for the secondary number
• A dial peer for the primary number as expanded by the dialplan-pattern command
• A dial peer for the secondary number as expanded by the dialplan-pattern command

The primary, secondary, and dialplan-pattern keywords allow you to apply call forwarding selectively to one or more dial peers based on the exact called number that was used to route the call to the ephone-dn. If none of the optional keywords is used, call forwarding applies to all dial-peers that are defined for the ephone-dn.

An ephone-dn can have all four types of call forwarding defined at the same time: all-calls, no-answer, busy, and night-service. Each type of call forwarding can have a different forwarding target defined in its target-number argument. If more than one type of call forwarding is in effect (is active) at one time, the precedence order for evaluating the different types is as follows:

1. call forward night service
2. call forward all
3. call forward busy and call forward no answer

If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn configuration mode has priority.

Related Commands

To specify a pattern for calling - party numbers that are able to support the ITU-T H.450.3 standard for call forwarding, use the callforward pattern command in telephony-service configuration mode. To remove the pattern, use the no form of this command.

Syntax Description

Command Default

No call-forward pattern is defined.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Usage Guidelines

Use this command with Cisco IOS Telephony Services (ITS) V2.1, Cisco CallManager Express 3.0, or a later version.

When H.450.3 call forwarding is selected, the router must be configured with a Tool Command Language (Tcl) script that supports the H.450.3 protocol. The Tcl script is loaded on the router by using the call application voice command.

The pattern match in this command is against the phone number of the calling party. When an extension number has forwarded its calls and an incoming call is received for that number, the router sends an H.450.3 response back to the original calling party to request that the call be placed again using the forward-to destination.

Calling numbers that do not match the patterns defined using this command are forwarded using Cisco-proprietary call forwarding for backward compatibility.

Related Commands

To replace a calling-party number and name with the forwarding-party number and name (the local number and name) in calls forwarded using local hairpin call routing, use the calling-number local command in telephony-service configuration mode. To reset to the default, use the no form of this command.

Syntax Description

Command Default

Calling-party numbers and names are used in forwarded calls.

Command Modes

Telephony-service configuration

Command History

Usage Guidelines

In Cisco CME 3.2 and earlier versions, this command is used with the Tool Command Language (Tcl) script app-h450-transfer.2.0.0.7 or a later version.

In Cisco CME 3.3 and later versions, this command can be used without the TCL script because the functionality is integrated into the default IOS voice application framework.

If the ephone-dn used by a forwarding party has a secondary number in addition to its primary number and neither number is registered with the gatekeeper, the primary number is the number that appears as the calling number on hairpin-forwarded calls when the calling-number local command is used. If only one of the numbers is registered with the gatekeeper, the registered number is the number that appears as the calling number. If both numbers are registered with the gatekeeper, the primary number is the number that appears as the calling number.

If the ephone-dn used by a forwarding party has a secondary number in addition to its primary number and the calling-number local secondary command is used, the secondary number is the number that appears as the calling number on hairpin-forwarded calls if both numbers are registered with the gatekeeper or if both numbers are not registered. If only one number is configured to register with the gatekeeper, the number that is registered appears as the calling number.

To replace a calling-party number and name with the forwarding-party number and name (the local number and name) in calls forwarded using local hairpin call routing, use the calling-number local command in voice register global configuration mode. To reset to the default, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Calling-party numbers and names are used in forwarded calls. The command is disabled by default.

Command Modes

Voice register global configuration (config-register-global)

Command History

Usage Guidelines

Use the CLI Command calling-number local in voice register global configuration mode so that the number and name of the forwarding party appears as the calling number on hairpin-forwarded calls. Once calling-number local is configured under voice register global, the calls forwarded from local SIP phones will have the calling-number and name of the last forwarded party.

To configure call waiting notification display on the agent phone as continuous, periodic, or off, use the callqueue display command. To set the call waiting notification display to the default state of periodic (for voice hunt group) and continuous (for ephone hunt group), use the default form of this command.

Command Default

Call waiting notification is set to periodic for phones in voice hunt group, and to continuous for phones in ephone hunt group. The no form of this command also sets the call waiting display to default state.

Command Modes

Ephone-hunt configuration (config-ephone-hunt)

Voice hunt group configuration (config-voice-hunt-group)

Command History

Usage Guidelines

The callqueue display command is valid for both voice hunt group as well as ephone hunt group.

To define system parameters for the Call Park feature, use the call-park system command in telephony-service configuration mode. To reset to the default, use the no form of this command.

Syntax Description

Command Default

H.323 and SIP calls use hairpin call forwarding or transfer to park calls and to pick up calls from park.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Usage Guidelines

The application keyword selects the enhanced Call Park method supported in Cisco Unified CME 7.1 and later versions for SCCP and SIP phones.

Related Commands

To enable call-waiting option on a SIP phone, use the call-waiting command in voice register pool configuration mode. To disable call waiting, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Feature is enabled.

Command Modes

Voice register pool configuration (call-waiting)

Command History

Usage Guidelines

The call waiting feature is enabled by default on SIP phones. To disable call waiting, use the no call-waiting command.

Related Commands

To allow call-waiting beeps to be accepted by or generated from an ephone-dn, use the call-waiting beep command in ephone-dn or ephone-dn-template configuration mode. To disable the acceptance and generation of call-waiting beeps by an ephone-dn, use the no form of this command.

Syntax Description

Command Default

Call-waiting beeps are accepted and generated.

Command Modes

Ephone-dn configuration (config-ephone-dn)
Ephone-dn-template configuration (config-ephone-dn-template)

Command History

Usage Guidelines

The call-waiting beep command must be used with the ephone-dn command. The call-waiting beep command is used like a toggle and can be switched on and off for each ephone-dn.

A beep can be heard only if both sending and receiving ephone-dns are configured to accept call-waiting beeps.

To display how call-waiting beeps are configured, use the show running-config command in the privileged EXEC configuration mode. If the no call-waiting beep generate and no call-waiting beep accept commands are configured, the show running-config output will display the no call-waiting beep command.

If you configure a button to have a silent ring using the s option of the button command, you will not hear a call-waiting beep regardless of whether the ephone-dn associated with the button is configured to generate a call-waiting beep.

If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn configuration mode has priority.

Related Commands

To allow an ephone-dn to use a ring sound for call-waiting notification, use the call-waiting ring command in ephone-dn or ephone-dn-template configuration mode. To disable the ring notification, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

The ephone-dn accepts call waiting and uses beeps for notification.

Command Modes

Ephone-dn configuration (config-ephone-dn)
Ephone-dn-template configuration (config-ephone-dn-template)

Command History

Usage Guidelines

To use a ring sound for call-waiting notification on an ephone-dn, you must ensure that the ephone-dn will accept secondary calls while it is connected to another line. The acceptance of call waiting is the default ephone-dn behavior. However, the no call-waiting beep accept command can change this default so an ephone-dn does not accept call waiting. This command must be removed for ringing notification to work.

The call-waiting ring command will automatically disable a call-waiting beep configuration.

If you configure a button to have a silent ring using the s option of the button command, you will not hear a call-waiting ring regardless of whether the ephone-dn associated with the button is configured to generate a call-waiting ring.

Note	The call-waiting ring option cannot be used on the Cisco Unified IP Phone 7902, Cisco Unified IP Phone 7905, or Cisco Unified IP Phone 7912. Do not use the call-waiting ring command for ephone-dns associated with these types of phones.

If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn configuration mode has priority.

Related Commands

To enable USB camera capability on Cisco Unified IP Phones 9951 and 9971, use the camera command in voice register global, voice register template, and voice register pool configuration modes. To disable video capabilities on Cisco Unified IP Phones 9951 and 9971, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

USB camera capability is disabled on Cisco Unified IP Phones 9951 and 9971.

Command Modes

Voice register global
Voice register template
Voice register pool

Command History

Usage Guidelines

Use this command to enable USB camera capability on Cisco Unified IP Phones 9951 and 9971. You need to create profile and apply-config or restart to the phone to enable the video capability on phones.

Related Commands

To define a string of digits that a user enters at the phone for CAPF authentication, use the capf-auth-str command in ephone configuration mode. To return to the default, use the no form of this command.

Syntax Description

Command Default

No authentication string exists for the phone.

Command Modes

Ephone configuration (config-ephone)

Command History

Usage Guidelines

This command is used with Cisco Unified CME phone authentication to create or remove an authentication string (Personal Identification Number or PIN) for the specified secure ephone. Use this command if the auth-string keyword is specified in the auth-mode command. Once you specify a CAPF authentication string, it becomes part of the ephone configuration. This value can also be set globally or per ephone using the auth-string command in CAPF configuration mode.

Use the show capf-server auth-str command to display configured authentication strings.

When a phone is configured for a certificate upgrade that requires auth-string authentication, the CAPF initiation needs to be performed manually by the phone user using the following steps:

1. Press the Settings button.
2. If the configuration is locked, press **# (asterisk, asterisk, pound sign) to unlock it.
3. Scroll down the menu and select Security Configuration.
4. Scroll down the next menu to LSC and press the Update soft key.
5. When prompted for the authentication string, enter the string provided by the system administrator.

Related Commands

To enter CAPF-server configuration mode to set CAPF server parameters, use the capf-server command in global configuration mode. To remove the CAPF server configuration, use the no form of this command.

Syntax Description

This command has no keywords or arguments.

Command Default

No CAPF server configuration is present.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command is used with Cisco Unified CME phone authentication.

To enroll the CAPF with the CA or RA, use the cert-enroll-trustpoint command in CAPF-server configuration mode. To remove an enrollment, use the no form of this command.

Syntax Description

Command Default

The CAPF server is not enrolled with the CA or RA.

Command Modes

CAPF-server configuration (config-capf-server)

Command History

Usage Guidelines

This command is used with Cisco Unified CME phone authentication.

To tear down the connection between a CSTA client application and Cisco Unified CME, use the clear cti session command in privileged EXEC configuration mode.

Syntax Description

Command Default

The CTI session between the application and the router is active.

Command Modes

Privileged EXEC (#)

Command History

Usage Guidelines

This command gracefully disassociates the connection between a CSTA application and Cisco Unified CME. Use this command to direct Cisco Unified CME to send a SIP BYE for the CSTA call to the application and to clean up the session internally. This command does not reset the IP phone.

To disassociate the connection without using this command, you must reboot the router or the CSTA client application.

This command has a no form, but the no form has no effect.

To determine the ID for an active CTI session, use the show cti session command.

Related Commands

To drop all conference parties and clear the conference call, use the clear telephony-service conference hardware number command in privileged EXEC mode.

Syntax Description

Command Default

The conference call continues with all current parties.

Command Modes

Privileged EXEC (#)

Command History

Usage Guidelines

Use the show telephony-service conference hardware command to display the active hardware conferences. Use the clear telephony-service conference hardware number command to clear the desired conference.

Related Commands

To empty the log of ephones that unsuccessfully attempt to register with Cisco Unified CME, use the clear telephony-service ephone-attempted-registrations command in privileged EXEC configuration mode.

Syntax Description

This command has no keywords or arguments.

Command Default

The log continues to accumulate attempted ephone registrations.

Command Modes

Privileged EXEC (#)

Command History

Usage Guidelines

The no auto-reg-ephone command blocks the automatic registration of ephones whose MAC addresses are not explicitly listed in the configuration. When automatic registration is blocked, Cisco Unified CME records the MAC addresses of phones that attempt to register but cannot because they are blocked.

Use the show ephone attempted-registrations command to view the list of phones that have attempted to register but have been blocked. The clear telephony-service ephone-attempted-registrations command clears the list.

Related Commands

To clear the event table used for the Cisco Unified CME XML application, use the clear telephony-service xml-event-log command in privileged EXEC mode.

Syntax Description

This command has no keywords or arguments.

Command Default

The XML event table is not cleared.

Command Modes

Privileged EXEC (#)

Command History

Usage Guidelines

The show fb-its-log command displays the contents of the XML event table.

Related Commands