|
|
Table Of Contents
template (voice register pool)
tftp-path (voice register global)
tftp-server-credentials trustpoint
time-format (voice register global)
timeouts interdigit (telephony-service)
timeouts ringing (telephony-service)
time-webedit (telephony-service)
timezone (voice register global)
transfer-attended (voice register template)
transfer-blind (voice register template)
transfer-pattern (telephony-service)
translate-outgoing (voice register pool)
type (voice register dialplan)
Cisco Unified CME Commands: T
Last Updated: September 14, 2007First Published: February 27, 2006
This chapter contains commands to configure and maintain Cisco Unified Communications Manager Express (formally known as Cisco Unified CallManager Express). The commands are presented in alphabetical order. Some commands required for configuring Cisco Unified Communications Manager Express (Cisco Unified CME) may be found in other Cisco IOS command references. Use the command reference master index or search online to find these commands.
telephony-service
To enter telephony-service configuration mode for configuring Cisco Unified CME, use the telephony-service command in global configuration mode. To remove the entire Cisco Unified CME configuration for SCCP IP phones, use the no form of this command.
telephony-service [setup]
no telephony-service
Syntax Description
Defaults
No Cisco Unified CME configuration for SCCP IP phones is present.
Command Modes
Global configuration
Command History
Usage Guidelines
This command enters the telephony-service configuration mode for configuring system wide parameters for SCCP IP phones in Cisco Unified CME
Use the setup keyword to start the interactive setup tool to automatically configure only Cisco Unified IP Phone 7910s, 7940s, and 7960s in Cisco Unified CME.
For alternate methods of automatically configuring Cisco Unified CME, including Cisco Unified IP Phone 7910s, 7940s, and 7960s and other Cisco Unified IP phones, see the Cisco Unified CME Administrator Guide at http://www.cisco.com/en/US/products/sw/voicesw/ps4625/products_documentation_roadmap09186a0080189132.html.
The setup keyword is not stored in the router nonvolatile random-access memory (NVRAM).
If you attempt to use the setup option for a system that already has a nonempty telephony-service configuration, the command is rejected. To use the setup option after an existing telephony-service configuration has been created, first remove the existing configuration using the no telephony-service command.
Table 55 shows a sample dialog with the Cisco CME setup tool and explains possible responses to the Cisco CME setup tool prompts.
Examples
The following example shows how to enter telephony-service configuration mode for manually configuring Cisco Unified CME. This example also includes the command for configuring the maximum number of phones to 12:
Router(config)# telephony-serviceRouter(config-telephony)# max-ephones 12The following example shows how to start the Cisco CME setup tool:
Router(config)# telephony-service setuptemplate (voice register pool)
To apply a template to a SIP phone, use the template command in voice register pool configuration mode. To remove the template, use the no form of this command.
template template-tag
no template template-tag
Syntax Description
template-tag
The template tag that was created with the voice register template command in voice register global configuration mode. Range is 1 to 5.
Defaults
No default behavior or values
Command Modes
Voice register pool configuration
Command History
Usage Guidelines
Apply any one of five previously defined templates to a SIP phone. Only one template is applied to a SIP phone at one time.
Examples
The following example shows how to define templates 1 and 2 and apply template 1 to SIP phones 1, 2, and 3, and template 2 to SIP phone 4:
Router(config)# voice register template 1Router(config-register-temp)# anonymous blockRouter(config-register-temp)# caller-id blockRouter(config-register-temp)# voicemail 5001 timeout 15Router(config)# voice register template 2Router(config-register-temp)# anonymous blockRouter(config-register-temp)# caller-id blockRouter(config-register-temp)# no conferenceRouter(config-register-temp)# no transfer-attendedRouter(config-register-temp)# voicemail 5005 timeout 15Router(config)# voice register pool 1Router(config-register-pool)# template 1Router(config)# voice register pool 2Router(config-register-pool)# template 1Router(config)# voice register pool 3Router(config-register-pool)# template 1Router(config)# voice register pool 4Router(config-register-pool)# template 2Related Commands
tftp-path (voice register global)
To specify the directory to which the configuring files for SIP phones in Cisco Unified CME are written, use the tftp-path command in voice register global configuration mode. To return to the default, use the no form of this command.
tftp-path {system: | flash: | slot0: | tftp://URL}
no tftp-path
Syntax Description
flash:
Router flash memory.
slot0:
Router slot 0 memory.
tftp://
External TFTP server.
URL
URL for external TFTP server.
system:
System memory (system:/cme/sipphone/).
Defaults
The default directory is system memory.
Command Modes
Voice register global configuration (config-register-global)
Command History
Usage Guidelines
Use this command to define the location of the configuration files that are generated by using the create profile command.
Examples
The following example shows how to set the path to an HTTP directory for an external TFTP server:
Router(config)# voice register globalRouter(config-register-global)# tftp-path tftp://mycompany.com/files/Related Commands
tftp-server-credentials trustpoint
To specify the PKI trustpoint that signs the phone configuration files, use the tftp-server-credentials trustpoint command in telephony-service configuration mode. To return to the default, use the no form of this command.
tftp-server-credentials trustpoint label
no tftp-server-credentials trustpoint
Syntax Description
Command Default
No trustpoint is defined for TFTP server communications.
Command Modes
Telephony-service configuration
Command History
12.4(4)XC
Cisco Unified CME 4.0
This command was introduced.
12.4(9)T
Cisco Unified CME 4.0
This command was integrated into Cisco IOS Release 12.4(9)T.
Usage Guidelines
This command is used with Cisco Unified CME phone authentication.
Examples
The following example names the CA trustpoint, server12, as the trustpoint that signs the phone configuration files.
Router(config)# telephony-serviceRouter(config-telephony)# device-security-mode authenticated
Router(config-telephony)# secure-signaling trustpoint server25
Router(config-telephony)# tftp-server-credentials trustpoint server12
Router(config-telephony)# load-cfg-file slot0:Ringlist.xml alias Ringlist.xml sign create
Router(config-telephony)# exit
time-format
To select a 12-hour clock or a 24-hour clock for the time display format on Cisco IP phones in a Cisco CallManager Express (Cisco CME) system, use the time-format command in telephony-service configuration mode. To return to the default, use the no form of this command.
time-format {12 | 24}
no time-format
Syntax Description
Defaults
12
Command Modes
Telephony-service configuration
Command History
Examples
The following example selects a 24-hour clock for the time display on Cisco IP phones:
Router(config)# telephony-serviceRouter(config-telephony)# time-format 24Related Commands
date-format
Selects a format to display the date on Cisco IP phones.
telephony-service
Enters telephony-service configuration mode.
time-format (voice register global)
To set the time display format on SIP phones in a Cisco Unified CME system, use the time-format command in voice register global configuration mode. To display the date in the default format, use the no form of this command.
time-format {12 | 24}
no date-format
Syntax Description
Defaults
12-hour clock
Command Modes
Voice register global configuration
Command History
Examples
The following example shows how to set the time format to a 24-hour clock so that 11:00PM is displayed as 2300.
Router(config)# voice register globalRouter(config-register-global)# time-format 24Related Commands
timeout (ephone-hunt)
To define the number of seconds after which a call that is not answered is redirected to the next number in a hunt-group list in Cisco Unified CME, use the timeout command in ephone-hunt configuration mode. To return to the default, use the no form of this command.
timeout seconds[, seconds...]
no timeout seconds[, seconds...]
Syntax Description
Command Default
The time period set by the timeouts ringing command, which has a default of 180 seconds if it is not set to another value.
Command Modes
Ephone-hunt configuration
Command History
Usage Guidelines
Use this command to set no-answer timeouts for each hop in a hunt group. You can enter a different value for each hop between ephone-dns in a hunt group or you enter a single value to be applied to each hop between ephone-dns in a hunt group list.
If you configure this command and you also configure the max-timeout command for an ephone hunt group, the max-timeout command takes precedence over this command.
Examples
The following example defines a no-answer timeout of 10 seconds for each hop between ephone-dns in hunt group 25. If extension 1001 does not answer in 10 seconds, the call is sent to 1002. If 1002 does not answer in 10 seconds, the call is sent to 1003. If 1003 does not answer in 10 seconds, the call is sent to the final number.
ephone-hunt 25 sequentialpilot 4200list 1001, 1002, 1003timeout 10final 4500The following example shows a hunt-group configuration with separate timeouts, one for each ephone in the hunt-group. If the first extension (1001) does not answer in 7 seconds, the call is sent to the second extension (1002). If the call is not answered by the second extension in 9 seconds, the call is forwarded to the third extension (1003). Extension 1003 has 15 seconds to answer before the call is sent to the final number.
ephone-hunt 3 peerpilot 4200list 1001, 1002, 1003timeout 7, 9, 15final 4500The following example shows the configuration for an ephone hunt group for which the max-timeout command is also configured. using this configuration, if the second number is busy, the third extension, 1003, has only 13 seconds to answer (20 - 7 = 13) because the value for max-timeout command is 20 seconds.
ephone-hunt 3 peerpilot 4200list 1001, 1002, 1003timeout 7, 9, 15max-timeout 20final 4500Related Commands
timeout (voice hunt-group)
To define the number of seconds after which a call that is not answered is redirected to the next number in a hunt-group list, use the timeout command in voice hunt-group configuration mode. To return to the default timeout, use the no form of this command.
timeout seconds
no timeout seconds
Syntax Description
Defaults
180 seconds
Command Modes
Voice hunt-group configuration
Command History
Examples
The following example shows how to define a no-answer timeout of 15 seconds to be applied to each hop between phones in peer hunt-group 25:
Router(config)# voice hunt-group 25 peerRouter(config-voice-hunt-group)# timeout 15Related Commands
timeouts busy
To set the amount of time after which a call is disconnected from a busy signal, use the timeouts busy command in telephony-service configuration mode. To return to the default value, use the no form of this command.
timeouts busy seconds
no timeouts busy
Syntax Description
seconds
Number of seconds after connection before a call is disconnected from a busy signal. Range is from 0 to 30 seconds. Default is 10.
Defaults
10 seconds
Command Modes
Telephony-service configuration
Command History
Examples
The following example sets a busy timeout of 10 seconds:
Router(config)# telephony-serviceRouter(config-telephony)# timeouts busy 10Related Commands
timeouts interdigit (telephony-service)
To set the interdigit timeout value for all Cisco IP phones in a Cisco CallManager Express (Cisco CME) system, use the timeouts interdigit command in telephony-service configuration mode. To return to the default value, use the no form of this command.
timeouts interdigit seconds
no timeouts interdigit
Syntax Description
seconds
Interdigit timeout duration for Cisco IP phones, in seconds. Range is from 2 to 120. Default is 10.
Defaults
10 seconds
Command Modes
Telephony-service configuration
Command History
Usage Guidelines
The interdigit timeout timer is activated when the caller enters a digit and is restarted each time the caller enters subsequent digits until the destination address is identified. This command specifies how long, in seconds, the system waits after a caller enters an initial digit or a subsequent digit of a dialed string. If the configured timeout value is exceeded before the destination address is identified, a tone sounds and the call is terminated. The default is 10 seconds.
To disable the timeouts interdigit timer, set the seconds value to zero.
Examples
The following example sets the interdigit timeout value to 5 seconds for all Cisco IP phones:
Router(config)# telephony-serviceRouter(config-telephony)# timeouts interdigit 5In this example, 5 seconds is also the elapsed time after which an incompletely dialed number times out. For example, if you dial nine digits (408555013) instead of the required ten digits (4085550134), you hear a busy tone after 5 "timeout" seconds.
Related Commands
telephony-service
Enters telephony-service configuration mode.
timeouts interdigit (voice-port)
Configures the interdigit timeout value for a specified voice port.
timeouts ringing (telephony-service)
To set the timeout value for ringing in a Cisco CallManager Express (Cisco CME) system, use the timeouts ringing command in telephony-service configuration mode. To reset the timeout value to the default value, use the no form of this command.
timeouts ringing seconds
no timeouts ringing
Syntax Description
seconds
Duration, in seconds, for which the Cisco CME system allows ringing to continue if a call is not answered. Range is from 5 to 60000. Default is 180.
Defaults
180 seconds
Command Modes
Telephony-service configuration
Command History
12.2(15)ZJ
3.0
This command was introduced.
12.3(4)T
3.0
This command was integrated into Cisco IOS Release 12.3(4)T.
Examples
The following example allows incoming calls to ring for 600 seconds:
Router(config)# telephony-serviceRouter(config-telephony)# timeouts ringing 600Related Commands
time-webedit (telephony-service)
To enable the system administrator to set time on the Cisco CallManager Express (Cisco CME) router through the web interface, use the time-webedit command in telephony-service configuration mode. To disable this feature, use the no form of this command.
time-webedit
no time-webedit
Syntax Description
This command has no arguments or keywords.
Defaults
Time-setting through the web interface is disabled.
Command Modes
Telephony-service configuration
Command History
Usage Guidelines
The time-webedit command allows a local administrator of the Cisco CME router to change and set time through the web-based graphical user interface (GUI).
Note
Cisco discourages this method for setting network time. The router should be set up to automatically synchronize its router clock from a network-based clock source using Network Time Protocol (NTP). In the rare case that a network NTP clock source is not available, the time-webedit command can be used to allow manual setting and resetting of the router clock through the Cisco CME GUI.
Examples
The following example enables web editing of time:
Router(config)# telephony-serviceRouter(config-telephony)# time-webeditRelated Commands
dn-webedit
Enables adding of directory numbers through a web interface.
telephony-service
Enters telephony-service configuration mode.
time-zone
To set Cisco IP Phone 7970G time displays to the correct time zone, use the time-zone command in telephony-service configuration mode. To disable a time-zone setting configured with the time-zone command and return to the default time zone (Pacific Standard Time), use the no form of this command.
time-zone number
no time-zone
Syntax Description
Syntax Description
Defaults
The default is time-zone 5, Pacific Standard/Daylight Time (-480).
Command Modes
Telephony-service configuration
Command History
12.3(11)XL
3.2.1
This command was introduced.
12.3(14)T
3.3
This command was integrated into Cisco IOS Release 12.3(14)T.
Usage Guidelines
The clocks in the Cisco IP Phone 7970G units obtain Coordinated Universal Time (UTC) from their Cisco CME router's clocks. To display the correct local time, nearly all Cisco IP Phone 7970G units' time display must be offset with the time-zone command.
The time-zone command works with the vendorConfig section of the Sep*.conf.xml configuration file, which is read by the phone firmware when a Cisco IP Phone 7970G is booted up. For changes to the time-zone settings take effect, the Sep*.conf.xml file must be updated with the create cnf-files command and the Cisco IP Phone 7970G units must rebooted with the reset command.
Examples
The following example sets the Cisco IP Phone 7970 units to Fiji Standard Time:
Router(config)# telephony-serviceRouter(config-telephony)# time-zone 53Related Commands
timezone (voice register global)
To set the time zone used for SIP phones in a Cisco Unified CME system, use the timezone command in voice register global configuration mode. To return to the default, use the no form of this command.
timezone number
no timezone
Syntax Description
Defaults
5, Pacific Standard/Daylight Time
Command Modes
Voice register global configuration
Command History
Usage Guidelines
Table 56 lists the supported time zone numbers and the corresponding description.
Examples
The following example shows how top set the time zone to 8, Central Standard Daylight Time:
Router(config)# voice register globalRouter(config-register-global)# timezone 8Related Commands
transfer max-length
To prevent a phone user from dialing more than the specified number of digits when transferring calls, use the transfer max-length command in ephone-template configuration mode. To return to the default, use the no form of this command.
transfer max-length digit-length
no transfer max-length
Syntax Description
digit-length
Maximum number of digits that can be dialed when transferring a call. Range is from 3 to 16.
Command Default
Phone users can dial a maximum of 16 digits when transferring calls.
Command Modes
Ephone-template configuration
Command History
12.4(4)XC
Cisco Unified CME 4.0
This command was introduced.
12.4(9)T
Cisco Unified CME 4.0
This command was integrated into Cisco IOS Release 12.4(9)T.
Usage Guidelines
This command can be used to eliminate toll charges on call transfers by limiting the number of digits that phone users can dial when transferring calls. For example, if you specify a maximum of eight digits, that allows users to dial a single external access digit and a seven-digit local number. In most locations this plan will limit transfers to non-toll destinations. Long-distance calls that typically require ten digits or more will not be allowed.
Examples
The following example limits transfers from ephone 6, extension 2977, to numbers of 8 digits or less.
ephone-template 2transfer max-length 8ephone-dn 4number 2977ephone 6button 1:4ephone-template 2transfer-attended (voice register template)
To enable a soft key for attended transfer in a SIP phone template, use the transfer-attended command in voice register template configuration mode. To disable the soft key, use the no form of this command.
transfer-attended
no transfer-attended
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Voice register template configuration
Command History
Usage Guidelines
This command enables a soft key for attended transfer in the specified template which can then be applied to SIP phones in Cisco CME. The attended transfer soft key is enabled by default. To disable the attended transfer soft key, use the no transfer-attended command. To apply the template to a SIP phone, use the template command in voice register pool configuration mode.
A blind transfer is one in which the transferring extension connects the caller to a destination extension before ringback begins. A attended transfer is one in which the transferring party either connects the caller to a ringing phone (ringback heard) or speaks with the third party before connecting the caller to the third party.
Examples
The following example shows how to disable attended transfer in template 1:
Router(config)# voice register template 1Router(config-register-temp)# no transfer-attendedRelated Commands
transfer-blind (voice register template)
To enable a soft key for blind transfer in a SIP phone template, use the transfer-blind command in voice register template configuration mode. To disable the soft key, use the no form of this command.
transfer-blind
no transfer-blind
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Voice register template configuration
Command History
Usage Guidelines
This command enables a soft key for blind transfer in the specified template which can then be applied to SIP phones in Cisco CME. The blind transfer soft key is enabled by default. To disable the blind transfer soft key, use the no transfer-blind command. To apply the template to a SIP phone, use the template command in voice register pool configuration mode.
A blind transfer is one in which the transferring extension connects the caller to a destination extension before ringback begins. A attended transfer is one in which the transferring party either connects the caller to a ringing phone (ringback heard) or speaks with the third party before connecting the caller to the third party.
Examples
The following example shows how to disable blind transfer in template 1:
Router(config)# voice register template 1Router(config-register-temp)# no transfer-blindRelated Commands
transfer-mode
To specify the type of call transfer for an individual IP phone extension that uses the ITU-T H.450.2 standard, use the transfer-mode command in ephone-dn configuration mode. To remove this specification, use the no form of this command.
transfer-mode {blind | consult}
no transfer-mode
Syntax Description
blind
Transfers calls without consultation using a single phone line.
consult
Transfers calls with consultation using a second phone line, if available.
Command Default
The ephone-dn uses the transfer-system value that was set systemwide.
Command Modes
Ephone-dn configuration
Command History
12.2(11)YT
2.1
This command was introduced.
12.2(15)T
2.1
This command was integrated into Cisco IOS Release 12.2(15)T.
Usage Guidelines
This command specifies the type of call transfer for an individual Cisco IP phone extension that is using the ITU-T H.450.2 protocol. It allows you to override the system default transfer-system setting (full-consult or full-blind) for that extension.
Call transfers that use H.450.2 can be blind or consultative. A blind transfer is one in which the transferring phone connects the caller to a destination extension before ringback begins. A consultative transfer is one in which the transferring party either connects the caller to a ringing phone (ringback heard) or speaks with the third party before connecting the caller to the third party.
You can specify blind or consultative transfer on a systemwide basis by using the transfer-system command. The systemwide setting can then be overridden for individual phone extensions by using the transfer-mode command. For example, in a Cisco CallManager Express (Cisco CME) network that is set up for consultative transfer, a specific extension with an auto-attendant that automatically transfers incoming calls to specific extension numbers can be set to use blind transfer, because auto-attendants do not use consultative transfer.
Use this command with Cisco IOS Telephony Services V2.1, Cisco CallManager Express 3.0, or a later version.
Examples
The following example sets blind mode for call transfers from this directory number:
Router(config)# ephone-dn 21354Router(config-ephone-dn)# transfer-mode blindRelated Commands
transfer-park blocked
To prevent extensions on an ephone from parking calls, use the transfer-park blocked command in ephone or ephone-template configuration mode. To return to the default, use the no form of this command.
transfer-park blocked
no transfer-park blocked
Syntax Description
This command has no arguments or keywords.
Command Default
Transfer to park is allowed.
Command Modes
Ephone configuration
Ephone-template configurationCommand History
12.4(4)XC
Cisco Unified CME 4.0
This command was introduced.
12.4(9)T
Cisco Unified CME 4.0
This command was integrated into Cisco IOS Release 12.4(9)T.
Usage Guidelines
This command prevents transfers to park that use the Trnsfer soft key and a call-park slot number, while allowing call-parks that use only the Park soft key. To prevent use of the Park soft key, use an ephone template to remove it from the phone.
An exception to this command is made for phones with dedicated park slots. If the transfer-park blocked command is used on an ephone that has a dedicated park slot, the phone is blocked from parking calls at park slots other than the dedicated park slot, but is still able to park calls at its own dedicated park slot. On an IP phone, the user presses the Trnsfer soft key and the call-park feature access code (FAC) to park a call at the phone's dedicated park slot. On an analog phone, the user presses hookflash and the call-park FAC.
When the transfer-park blocked command is used on an ephone that does not have a dedicated park slot, the phone is blocked from parking any calls.
If you use an ephone template to apply a command to a phone and you also use the same command in ephone configuration mode for the same phone, the value that you set in ephone configuration mode has priority.
Examples
The following example prevents ephone 25 and extensions 234, 235, and 236 from parking calls at any call-park slot.
ephone-dn 11number 234ephone-dn 12number 235ephone-dn 13number 236ephone 25button 1:11 2:12 3:13transfer-park blockedThe following example uses an ephone template to prevent ephone 26 and extension 76589 from parking calls at any call-park slot.
ephone-dn 33number 76589ephone-template 1transfer-park blockedephone 26button 1:33ephone-template 1The following example sets up a dedicated park slot for the extensions on ephone 6 and blocks transfers to call park from extensions 2977, 2978, and 2979 on that phone. Those extensions can still park calls at the phone's dedicated park slot by using the Park soft key or Trnsfer and the call-park FAC.
ephone-dn 3number 2558name Park 2977park-slot reserved-for 2977 timeout 60 limit 3 recall alternate 3754ephone-dn 4number 2977ephone-dn 5number 2978ephone-dn 6number 2979ephone 6button 1:4 2:5 3:6transfer-park blockedtransfer-pattern (telephony-service)
To allow transfer of telephone calls from Cisco IP phones to phones other than Cisco IP phones, use the transfer-pattern command in telephony-service configuration mode. To disable these transfers, use the no form of this command.
transfer-pattern transfer-pattern [blind]
no transfer-pattern
Syntax Description
Defaults
Transfer of calls is enabled only to local Cisco IP phones.
Command Modes
Telephony-service configuration
Command History
Usage Guidelines
This command allows you to transfer calls to "other" phones—that is, to non-IP phones and phones outside of your network. A call is then established between the transferred party and the new recipient. By default, all Cisco IP phone extension numbers are allowed as transfer targets.
The blind keyword is valid only for systems that use Cisco IOS Telephony Services V2.1, Cisco CallManager Express 3.0, or a later version and applies only to consultative transfers made using the H.450.2 standard. The blind keyword forces calls that are transferred to numbers that match the transfer pattern to be executed as blind or full-blind transfers, overriding any settings made using the transfer-system and transfer-mode commands.
When defining transfers to non-local numbers, it is important to note that transfer-pattern digit matching is performed before translation-rule operations. Therefore, you should specify in this command the digits actually entered by phone users before they are translated. For more information, see the "Translation Rules and Profiles" section in the Cisco Unified CallManager Express System Administrator Guide at http://www.cisco.com/en/US/products/sw/voicesw/ps4625/products_documentation_roadmap09186a0080189132.html.
Use of the .T control character for the transfer-pattern argument is not recommended. The .T control character indicates a variable-length dial string, which causes Cisco CME to wait for an interdigit timeout (default is 10 seconds) before transferring a call. To avoid the interdigit timeout, a matching transfer pattern should be used with the transfer-pattern command. For example, use the transfer-pattern 9......... command instead of the transfer-pattern .T command.
Examples
The following example sets a transfer pattern. A maximum of 32 transfer patterns can be entered. In this example, 55501.. (the two periods are wildcards) permits transfers to any number in the range from 555-0100 to 555-0199.
Router(config)# telephony-serviceRouter(config-telephony)# transfer-pattern 55501..Related Commands
transfer-pattern blocked
To prevent extensions on an ephone from transferring calls to patterns defined using the transfer-pattern (telephony-service) command, use the transfer-pattern blocked command in ephone or ephone-template configuration mode. To return to the default, use the no form of this command.
transfer-pattern blocked
no transfer-pattern blocked
Syntax Description
This command has no arguments or keywords.
Command Default
Call transfer is allowed to patterns specified in the transfer-pattern (telephony-service) command.
Command Modes
Ephone configuration
Ephone-template configurationCommand History
12.4(4)XC
Cisco Unified CME 4.0
This command was introduced.
12.4(9)T
Cisco Unified CME 4.0
This command was integrated into Cisco IOS Release 12.4.(9)T.
Usage Guidelines
By default, transfers to all numbers except for those on local ephones are automatically blocked. During configuration, you can allow transfers to non-local numbers using the transfer-pattern (telephony-service) command.
Use the transfer-pattern blocked command to prevent individual phones from transferring calls to non-local numbers that have been globally enabled for transfer.
If you use an ephone template to apply a command to a phone and you also use the same command in ephone configuration mode for the same phone, the value that you set in ephone configuration mode has priority.
Examples
The following example blocks transfers from ephone 6 (extension 2977) to the PSTN.
ephone-dn 4number 2977ephone 6button 1:4transfer-pattern blockedThe following example uses an ephone template to block transfers from ephone 6 (extension 2977) and ephone 7 (extension 2978) to the PSTN.
ephone-template 2transfer-pattern blockedephone-dn 4number 2977ephone-dn 5number 2978ephone 6button 1:4ephone-template 2ephone 7button 1:5ephone-template 2Related Commands
transfer-pattern (telephony service)
Allows call transfers to numbers outside the Cisco Unified CME system.
transfer-system
To specify the call transfer method to be used by Cisco Unified IP phones in Cisco Unified CME, use the transfer-system command in telephony-service configuration mode. To disable the call transfer method, use the no form of this command.
transfer-system {blind | full-blind | full-consult [dss] | local-consult}
no transfer-system
Syntax Description
Command Default
For Cisco Unified CME 4.0 and later versions, the transfer mode is full-consult.
For Cisco CME 3.4 and earlier versions, the transfer mode is blind.Command Modes
Telephony-service configuration
Command History
Usage Guidelines
Direct station select is a functionality that allows a multibutton phone user to transfer calls to an idle monitor line by pressing the Transfer key and the appropriate monitor button. The dss keyword permits consultative call transfer to monitored lines.
Call transfers can be blind or consultative. A blind transfer is one in which the transferring extension connects the caller to a destination extension before ringback begins. A consultative transfer is one in which the transferring party either connects the caller to a ringing phone (ringback heard) or speaks with the third party before connecting the caller to the third party.
The transfer-system command specifies whether the H.450.2 standard or a Cisco proprietary method will be used to communicate call transfer information across the network. When you specify use of the H.450.2 consultative or blind mode of transfer globally by using the transfer-system command (or by using the default), you can override this mode for individual ephones by using the transfer-mode command. For example, in a system that is set up for consultative transfer, a specific extension with an auto-attendant that automatically transfers incoming calls to specific extension numbers can be set to use blind transfer, because auto-attendants do not use consultative transfer.
Prior to Cisco Unified CME 4.0, the default for this command specified the Cisco proprietary method. In Cisco Unified CME 4.0, the default was changed to specify the H.450.2 standard as the transfer method. Consult Table 57 for configuration recommendations for different versions of Cisco Unified CME.
Table 57 Transfer Method Recommendations
Cisco Unified CME 4.0 and later versions
full-consult
full-consult
or
full-blindUse H.450.2 for call transfer. Because this is the default for this version, you do not need to use the transfer-system command unless you want to use the full-blind or dss keyword.
Optionally, you can use the proprietary Cisco method by using the transfer-system command with the blind or local-consult keyword.
Cisco CME 3.0 to 3.3
blind
full-consult
or
full-blindUse H.450.2 for call transfer. You must explicitly configure the transfer-system command with the full-consult or full-blind keyword because H.450.2 is not the default for this version.
Optionally, you can use the proprietary Cisco method by using the transfer-system command with the blind or local-consult keyword.
Cisco ITS 2.1 to 3.0
blind
blind
or
local-consultUse the Cisco proprietary method. Because this is the default for this version, you do not need to use the transfer-system command unless you want to use the local-consult keyword.
Optionally, you can use the H.450.2 standard for call transfer by using transfer-system command with the full-consult or full-blind keyword. You must also configure the router with a Tcl script that is contained in the file called app-h450-transfer.x.x.x.x.zip. This file is posted on the Cisco Unified CME software download website at http://www.cisco.com/cgi-bin/tablebuild.pl/ip-iostsp.
Examples
The following example sets full consultation as the call transfer method:
Router(config)# telephony-serviceRouter(config-telephony)# transfer-system full-consultRelated Commands
transfer-mode
Specifies the type of call transfer for an individual IP phone extension that uses the H.450.2 standard.
translate (ephone-dn)
To apply a translation rule in order to manipulate the digits that are dialed by users of Cisco Unified IP phones, use the translate command in ephone-dn or ephone-dn-template configuration mode. To disable the translation rule, use the no form of this command.
translate {called | calling} translation-rule-tag
no translate {called | calling}
Syntax Description
Command Default
No translation rule is applied.
Command Modes
Ephone-dn configuration
Ephone-dn-template configurationCommand History
Usage Guidelines
This command allows you to select a preconfigured translation rule to modify the number dialed by a specific extension (Cisco Unified IP phone destination number, or ephone-dn). A translation rule is a general-purpose digit-manipulation mechanism that performs operations such as automatically adding telephone area and prefix codes to dialed numbers. The translation rules are applied to the voice ports created by the ephone-dn. The called keyword translates the called number, and the calling keyword translates the calling number.
The translation rule mechanism inserts a delay into the dialing process when digits are entered that do not explicitly match any of the defined translation rules. This delay is set by the interdigit timeout. The translation-rule mechanism uses the delay to ensure that it has acquired all of the digits from the phone user before making a final decision that there is no translation-rule match available (and therefore no translation operation to perform). To avoid this delay, it is recommended that you include a dummy translation rule to act as a pass-through rule for digit strings that do not require translation. For example, a rule like "^5 5" that maps a leading 5 digit into a 5 would be used to prevent the translation rule delay being applied to local extension numbers that started with a 5.
Note
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.
Examples
The following example applies translation rule 20 to numbers called by extension 46839:
Router(config)# translation-rule 20Router(config-translate)# rule 0 1234 2345 abbreviatedRouter(config-translate)# exitRouter(config)# ephone-dn 1Router(config-ephone-dn)# number 46839Router(config-ephone-dn)# translate called 20The following example uses an ephone-dn-template to apply translation rule 20 to numbers called by extension 46839:
Router(config)# translation-rule 20Router(config-translate)# rule 0 1234 2345 abbreviatedRouter(config-translate)# exitRouter(config)# ephone-dn-template 1Router(config-ephone-dn-template)# translate called 20Router(config-ephone-dn-template)# exitRouter(config)# ephone-dn 1Router(config-ephone-dn)# number 46839Router(config-ephone-dn)# ephone-dn-template 1Related Commands
rule
Defines a translation rule.
translation-rule
Creates a translation identifier and enters translation-rule configuration mode.
translate-outgoing (voice register pool)
To allow an explicit setting of translation rules on the VoIP dial peer in order to modify a phone number dialed by any Cisco IP phone user, use the translate-outgoing command in voice register pool configuration mode. To disable translation rules, use the no form of this command.
translate-outgoing {called | calling} rule-tag
no translate-outgoing {called | calling}
Syntax Description
Command Default
None
Command Modes
Voice register pool configuration
Command History
Usage Guidelines
Translation rules are a powerful general-purpose number-manipulation mechanism that perform operations such as automatically adding telephone area and prefix codes to dialed numbers. The translation rules are applied to VoIP dial peers created by Cisco Unified Session Initiation Protocol (SIP) Survivable Remote Site Telephony (SRST) or Cisco Unified CallManager Express (Cisco Unified CME)
.
During registration, a dial peer is created, and that dial peer includes a default translation rule. The translate-outgoing command allows you to change the translation rule, if desired. The translate-outgoing command allows you to select a preconfigured number translation rule to modify the number dialed by a specific extension.
Note
Configure the id (voice register pool) command before any other voice register pool commands, including the translate-outgoing command. The id command identifies a locally available individual SIP phone or set of SIP phones.
Examples
Cisco Unified CME
The following is partial sample output from the show running-config command showing that called-party 1 requires translation.
voice register pool 1id mac 0030.94C2.A22Apreference 5cor incoming call91 1 91011translate-outgoing called 1Cisco Unified SIP SRST
The following is partial sample output from the show running-config command showing that called-party 1 requires translation.
voice register pool 1id mac 0030.94C2.A22Apreference 5cor incoming call91 1 91011translate-outgoing called 1proxy 10.2.161.187 preference 1 monitor probe icmp-pingalias 1 94... to 91011 preference 8voice-class codec 1Related Commands
translation-profile
To assign a translation profile for incoming or outgoing call legs on a Cisco Unified IP phone, use the translation-profile command in ephone-dn or ephone-dn-template configuration mode. To delete the translation profile from the voice port, use the no form of this command.
translation-profile {incoming | outgoing} name
no translation-profile {incoming | outgoing} name
Syntax Description
incoming
Specifies that this translation profile handles incoming calls.
outgoing
Specifies that this translation profile handles outgoing calls.
name
Name of the translation profile.
Command Default
No default behavior or values
Command Modes
Ephone-dn configuration
Ephone-dn-template configurationCommand History
Usage Guidelines
Use the translation-profile command to assign a global predefined translation profile to an incoming or outgoing call leg.
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.
Examples
The following example assigns the translation profile named call_in to handle translation of incoming calls and a translation profile named call_out to handle outgoing calls:
Router(config)# ephone-dn 1Router(config-ephone-dn)# number 2555Router(config-ephone-dn)# translation-profile incoming call_inRouter(config-ephone-dn)# translation-profile outgoing call_outThe following example uses an ephone-dn-template to assign the translation profile named call_in to handle translation of incoming calls and the translation profile named call_out to handle outgoing calls:
Router(config)# ephone-dn-template 10Router(config-ephone-dn-template)# translation-profile incoming call_inRouter(config-ephone-dn-template)# translation-profile outgoing call_outRouter(config-ephone-dn-template)# exitRouter(config)# ephone-dn 1Router(config-ephone-dn)# number 2555Router(config-ephone-dn)# ephone-dn-template 10Related Commands
translation-profile incoming
To assign a translation profile for incoming call legs on a SIP phone, use the translation-profile incoming command in voice-register-dn configuration mode. To delete the translation profile from the directory number, use the no form of this command.
translation-profile incoming name
no translation-profile incoming
Syntax Description
name
Name of the translation profile to apply to incoming calls to this directory number. This is the name argument that was created for the profile with the voice translation-profile command.
Command Default
No translation profile is assigned to the directory number.
Command Modes
Voice-register-dn configuration
Command History
Usage Guidelines
Use this command to assign a predefined translation profile to incoming call legs on the specified directory number. The translation profile that you assign is created by using the voice translation-profile command.
Examples
The following example shows that the translation profile named call_in is assigned to handle translation of incoming calls to directory number 1:
Router(config)# voice register dn 1Router(config-register-dn)# number 2555Router(config-register-dn)# translation-profile incoming call_inRelated Commands
trunk
To associate an ephone-dn with a foreign exchange office (FXO) port, use the trunk command in ephone-dn configuration mode. To disassociate the ephone-dn from the trunk number, use the no form of this command.
trunk digit-string [timeout seconds] [transfer-timeout seconds] [monitor-port port]
no trunk
Syntax Description
Command Default
Ephone-dns are not associated with FXO ports.
Command Modes
Ephone-dn configuration
Command History
Usage Guidelines
This command configures ephone-dns to support FXO lines that allow phones to have private lines connected directly to the PSTN. To bind the ephone-dn to the FXO port, use the destination pattern configured for the FXO line's POTS dial peer for the digit-string argument.
The timeout seconds argument controls the interdigit delay period, during which digits are collected from the user, and the delay before the connection to the FXO port is established. The argument controls the amount of time that Cisco Unified CME waits to collect digits for the dialed number, so that the digits can be included in the redial buffer and the Placed Calls directory of the phone. Digits that are entered after the timeout period are not included in the redial buffer or in the Placed Calls directory on the phone. The timeout parameter does not affect the time used to cut through the connection from the phone's trunk button to the FXO port. The phone user must either enter the pound (#) key or wait for this interdigit timeout to complete digit collection.
The phone user also has the option to use the phone's on-hook dialing feature so that the phone itself performs complete dial-string digit collection before signaling off-hook to the Cisco Unified CME. In this case all digits will be included in the Redial and Placed Calls Directory.
The monitor-port keyword enables direct status monitoring of the FXO port on the line button of the IP phone. The line button indicator, either a lamp or an icon depending on the phone, shows the in-use status of the FXO port during the duration of the call.
The transfer-timeout argument enables a transferred call to be automatically recalled if the transfer target does not answer after the specified number of seconds. The call is withdrawn from the transfer-to phone and the call resumes ringing on the phone that initiated the transfer.
The monitor-port and transfer-timeout keywords are not supported on ephone-dns for analog ports on the Cisco VG 224.
For dual-line ephone-dns, the second channel cannot receive incoming calls when the trunk command is configured.
Examples
The following example shows the configuration for two phones that each have a private FXO line button and a shared-line button.
The shared line's voice ports and dial peers are as follows:
Router(config)# voice-port 1/0/1Router(config-voice-port)# connection plar-opx 1000Router(config)# dial-peer voice 101 potsRouter(config-dial-peer)# destination-pattern 9Router(config-dial-peer)# port 1/0/1The private lines' voice ports and dial peers are as follows:
Router(config)# voice-port 1/1/0Router(config-voice-port)# connection plar-opx 5550111Router(config)# dial-peer voice 110 potsRouter(config-dial-peer)# destination-pattern 80Router(config-dial-peer)# port 1/1/0Router(config)# voice-port 1/1/1Router(config-voice-port)# connection plar-opx 5550112Router(config)# dial-peer voice 111 potsRouter(config-dial-peer)# destination-pattern 81Router(config-dial-peer)# port 1/1/1The following is the configuration for the shared and private ephone-dns:
Router(config)# ephone-dn 1Router(config-ephone-dn)# number 1000Router(config-ephone-dn)# name Line1Router(config-ephone-dn)# no huntstopRouter(config)# ephone-dn 2Router(config-ephone-dn)# number 5550111Router(config-ephone-dn)# name Private lineRouter(config-ephone-dn)# trunk 80Router(config)# ephone-dn 3Router(config-ephone-dn)# number 5550112Router(config-ephone-dn)# name Private lineRouter(config-ephone-dn)# trunk 81The following is the configuration for ephones with button 1 as a shared line and button 2 a private line:
Router(config)# ephone 1Router(config-ephone)# mac-address 1111.1111.1101Router(config-ephone)# button 1:1 2:2Router(config)# ephone 2Router(config-ephone)# mac-address 1111.1111.1102Router(config-ephone)# button 1:1 2:3The following example shows that transferred calls are recalled after 30 seconds if the destination party does not answer and status monitoring is enabled for FXO port 1/1/1.
Router(config)# ephone-dn 5Router(config-ephone-dn)# trunk 801 timeout 5 transfer-timeout 30 monitor-port 1/1/1Related Commands
trustpoint (credentials)
To specify the name of the trustpoint to be associated with a Cisco Unified CME CTL provider certificate or with the Cisco Unified SRST router certificate, use the trustpoint command in credentials configuration mode. To change the specified trustpoint, use the no form of this command.
trustpoint trustpoint-name
no trustpoint
Syntax Description
trustpoint-name
Name of the trustpoint to be associated with the Cisco Unified CME CTL provider certificate or the Cisco Unified SRST device certificate.
Command Default
No default behavior or values.
Command Modes
Credentials configuration
Command History
Usage Guidelines
Cisco Unified CME
This command is used with Cisco Unified CME phone authentication to define the trustpoint for the CTL provider. This trustpoint will be used for TLS sessions with the CTL client.
Cisco Unified SRST
The name of the trustpoint must be consistent with the trustpoint name of the Cisco Unified SRST router.
Examples
Cisco Unified CME
The following example sets up a CTL provider on the Cisco Unified CME router with the IP address 172.19.245.1.
Router(config)# credentials
Router(config-credentials)# ip source-address 172.19.245.1 port 2444
Router(config-credentials)# trustpoint ctlpv
Router(config-credentials)# ctl-service admin user4 secret 0 c89L8o
Cisco Unified SRST
The following example enters credentials configuration mode, sets the IP source address and port, and specifies the trustpoint:
Router(config)# credentialsRouter(config-credentials)# ip source-address 10.6.21.4 port 2445Router(config-credentials)# trustpoint srstcaRelated Commands
trustpoint-label
To specify the PKI trustpoint label to be used for the TLS connection between the CAPF server and the phone, use the trustpoint-label command in CAPF-server configuration mode. To return to the default, use the no form of this command.
trustpoint-label label
no trustpoint-label
Syntax Description
Command Default
No trustpoint label is specified for TLS connections.
Command Modes
CAPF-server configuration
Command History
12.4(4)XC
Cisco Unified CME 4.0
This command was introduced.
Usage Guidelines
This command is used with Cisco Unified CME phone authentication to provide a PKI trustpoint name for the CAPF server. This trustpoint label is used for the TLS connection between the CAPF server and the phone.
Examples
The following example defines the CAPF server trustpoint name as server25.
Router(config)# capf-serverRouter(config-capf-server)# source address 10.10.10.1
Router(config-capf-server)# trustpoint-label server25
Router(config-capf-server)# cert-oper upgrade all
Router(config-capf-server)# cert-enroll-trustpoint server12 password 0 x8oWiet
Router(config-capf-server)# auth-mode auth-string
Router(config-capf-server)# auth-string generate all
Router(config-capf-server)# port 3000
Router(config-capf-server)# keygen-retry 5
Router(config-capf-server)# keygen-timeout 45
Router(config-capf-server)# phone-key-size 2048
type
To define a phone type or to define one or two add-on phone modules for a Cisco Unified IP phone, use the type command in ephone or ephone-template configuration mode. To remove a definition, use the no form of this command.
type phone-type [addon 1 module-type [2 module-type]]
no type phone-type [addon 1 module-type [2 module-type]]
Syntax Description
Command Default
No phone type or add-on module is defined.
Command Modes
Ephone configuration
Ephone-template configurationCommand History
Usage Guidelines
For Cisco Unified CME 4.0 and later versions, the only phone-type to which you can apply an add-on module are 7960, 7961, 7961GE, and 7970. For Cisco Unified CME 3.4 and earlier versions, the only phone-type to which you can apply an add-on module is 7960.
This command must be followed by a phone reboot using the reset command.
If you use an ephone template to apply a command to a phone and you also use the same command in ephone configuration mode for the same phone, the value that you set in ephone configuration mode has priority.
Examples
The following example defines the IP phone with phone-tag 10 as a Cisco Unified IP Phone 7960G with 2 attached Cisco Unified IP Phone 7914 Expansion Modules:
Router(config)# ephone 10Router(config-ephone)# type 7960 addon 1 7914 2 7914The following example defines the IP phone with phone-tag 4 as a Cisco ATA device:
Router(config)# ephone 4Router(config-ephone)# mac 1234.87655.234Router(config-ephone)# type ataRelated Commands
type (voice register dialplan)
To specify a phone type for a SIP dial plan, use the type command in voice register dialplan configuration mode. To remove a phone type, use the no form of this command.
type phone-type
no type
Syntax Description
Command Default
The phone type is not defined.
Command Modes
Voice register dialplan configuration
Command History
Usage Guidelines
This command specifies the type of SIP phone for which the dial plan is defined. You must use this command before defining dial patterns with the pattern command or selecting a dial pattern file in flash with the filename command.
The phone type specified with this command must match the phone type specified with the type command in voice register pool mode. If the dial plan type does not match the type assigned to the phone, the dial-plan configuration file is not generated.
Examples
The following example shows a SIP dial plan being defined for a Cisco Unified IP Phone 7905 or Cisco Unified IP Phone 7912:
Router(config)# voice register dialplan 10Router(config-register-dialplan)# type 7905-7912Router(config-register-dialplan)# pattern 52...Router(config-register-dialplan)# pattern 91.......Related Commands
type (voice register pool)
To define a phone type for a SIP phone, use the type command in voice register pool configuration mode. To remove a phone type, use the no form of this command.
type phone-type
no type phone-type
Syntax Description
Command Default
No phone type is defined.
Command Modes
Voice register pool configuration
Command History
Usage Guidelines
After you use this command, reboot the phone with the restart or reset command.
Examples
The following example shows how to define the SIP phone with phone-tag 10 as a Cisco Unified IP Phone 7960 or Cisco Unified IP Phone 7960G:
Router(config)# voice register pool 10Router(config-register-pool)# type 7960Related Commands
Posted: Fri Sep 14 13:56:38 PDT 2007
All contents are Copyright © 1992--2007 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
