To create a PSTN number that replaces a 911 caller’s extension, use the elin command in voice emergency response location configuration mode. To remove the number, use the no form of this command.

Syntax Description

Command Default

No replacement number is created.

Command Modes

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

Command History

Usage Guidelines

Use this command to specify an ELIN, a PSTN number that will replace the caller’s extension.

The PSAP will see this number and use it to query the ALI database to locate the caller. The PSAP also uses this command for callbacks.

You can configure a second ELIN using the elin 2 command. If two ELINs are configured, the system selects an ELIN using a round-robin algorithm. If an ELIN is not defined for the ERL, the PSAP sees the original calling number.

Related Commands

To create a default ELIN that is used if no ERL has a subnet mask that matches the current 911 caller’s IP phone address, use the elin command in voice emergency response settings configuration mode. To remove the number, use the no form of this command.

Syntax Description

Command Default

No default ELIN number is created.

Command Modes

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

Command History

Usage Guidelines

Use this command to specify an E.164 number to be the default ELIN if the 911 caller’s IP phone address does not match the subnet of any location in any ERL zone. The default ELIN can be an existing ELIN already defined in an ERL or it can be unique.

Related Commands

To remove the login page under the Extension Mobility option from the Services menu on IP phones in Cisco Unified CME, use the em external command in telephony-service configuration mode. To return to default, use the no form of this command.

Syntax Description

This command has no keywords or arguments.

Command Default

Login page for Extension Mobility is accessible under the Extension Mobility option in the Services menu.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Usage Guidelines

This command removes the Extension Mobility login page from the Sevices menu on all IP phones registered in a Cisco Unified CME system on which Extension Mobility is enabled.

Related Commands

To disable Automatic Clear Call History for Extension Mobility phones in Cisco Unified CME, use the em keep-history command in telphony-service configuration mode. To return to the default, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

Call history record is automatically cleared when a user logs out from an Extension Mobility phone.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Usage Guidelines

This command disables Automatic Clear Call History for Extension Mobility phones in Cisco Unified CME.

In Cisco Unified CME 4.3 and later versions, the EM manager in Cisco Unified CME sends commands to a phone to clear call history anytime a user is logs out from Extension Mobility. Use this command in telephony-service configuration mode to disable this feature at a system-level.

To configure up to three time-of-day based timers for automatically logging out all Extension Mobility users, use the em logout command in telephony-service configuration mode. To disable the timer, use the no form of this command.

Syntax Description

Command Default

No time-of-day timer is created for automatically logging out Extension Mobility users.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Usage Guidelines

This command creates up to three time-of-day timers for automatically logging out all Extension Mobility users. If an Extension Mobility user is using the phone when automatic logout occurs, the user is logged out after the active call is completed.

The call history record is automatically cleared when a user logs out from an Extension Mobility phone. To disable Automatic Clear Call History on all Extension Mobility phones, use the em keep-history command in telephony-service configuration mode.

Related Commands

To permit an external application to log into a Cisco Unified IP phone that is enabled for Extension Mobility in Cisco Unified CME, use the emadmin login command in privileged EXEC mode.

Syntax Description

Command Default

External application cannot log into an Extension Mobility phone.

Command Modes

Privileged EXEC (#)

Command History

Usage Guidelines

This command enables an external application, such as a CSTA client application, to log into an Extension Mobility phone.

Before using this command, configure a credential in Extension Mobility by using the user command in voice-user-profile configuration mode.

The IP phone to be accessed must be enabled for Extension Mobility.

The application remains logged into the phone until it is manually or automatically logged out from the Extension Mobility phone

This command does not have a no form.

Related Commands

To manually log out an external application from Extension Mobility, use the emadmin logout command in privileged EXEC mode. To return to default, use the no form of this command.

Syntax Description

Command Default

Application remains logged into the Extension Mobility phone until logged out.

Command Modes

Privileged EXEC (#)

Command History

Usage Guidelines

This command enables an external application, such as a CSTA client application, to log out of an Extension Mobility phone.

Related Commands

To define a dial peer that is used for 911 callbacks from the PSAP, use the emergency response callback command in voice dial-peer configuration mode. To remove the definition of the dial peer as an incoming link from the PSAP, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

The dial peer is not defined as an incoming link from the PSAP.

Command Modes

Dial-peer configuration (config-dial-peer)

Command History

Usage Guidelines

Use this command to define which dial peer is used for 911 callbacks from the PSAP. You can define multiple dial peers with this command.

Related Commands

To associate an emergency response location (ERL) for Enhanced 911 Services with a dial peer, ephone, ephone-template, voice register pool, or voice register template, use the emergency response location command in dial peer, ephone, ephone-template, voice register pool, or voice register template configuration mode. To remove the association, use the no form of this command.

Syntax Description

Command Default

No ERL tag is associated with a dial peer, ephone, ephone-template, voice register pool, or voice register template.

Command Modes

Dial-peer configuration (config-dial-peer)
Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Voice register pool configuration (config-register-pool)
Voice register template configuration (config-register-template)

Command History

Usage Guidelines

Use this command to assign an ERL to phones individually. Depending on the type of phones (endpoints) that you have, you can assign an ERL to a phone’s:

• Dial-peer configuration
• Ephone
• Ephone-template
• Voice register pool
• Voice register template

Note	The ephone-template and voice register template modes are not for Cisco Unified SRST or Cisco Unified SIP SRST. Voice register pool mode is not available for Cisco Unified SRST.

These methods of associating a phone with an ERL are alternatives to assigning a group of phones that are on the same subnet as an ERL.

The tag used by this command is an integer from 1 to 2147483647 and refers to an existing ERL tag that is defined by the voice emergency response location command. If the tag does not refer to a valid ERL configuration, the phone is not associated to an ERL. For Cisco Unified IP phones, the IP address is used to find the inclusive ERL subnet. For phones on a VoIP trunk or FXS/FXO trunk, the PSAP gets a reorder tone.

Related Commands

To define a dial peer that is used by the system to route emergency calls to a PSAP, use the emergency response zone command in voice dial-peer configuration mode. To remove the definition of the dial peer as an outgoing link to the PSAP, use the no form of this command.

Syntax Description

Command Default

The dial peer is not defined as an outgoing link to the PSAP. Therefore, E911 services are not enabled.

Command Modes

Dial-peer configuration (config-dial-peer)

Command History

Usage Guidelines

Use this command to specify that any calls using this dial peer are processed by the E911 software. To enable any E911 processing, the emergency response zone command must be enabled under a dial peer.

If no zone tag is specified, the system looks for a matching ELIN to the E911 caller’s phone by searching each emergency response location that was configured using the emergency response location command.

If a zone tag is specified, the system looks for a matching ELIN using sequential steps according to the contents of the configured zone. For example, if the E911 caller’s phone has an explicit ERL assigned, the system first looks for that ERL in the zone. If not found, it then searches each location within the zone according to assigned priority numbers, and so on. If all steps fail to find a matching ELIN, the default ELIN is assigned to the E911 caller’s phone. If no default ELIN is configured, the E911 caller’s automatic number identification (ANI) number is communicated to the Public Safety Answering Point (PSAP).

This command can be defined in multiple dial peers. The zone tag option allows only ERLs defined in that zone to be routed on this dial peer. Also, this command allows callers dialing the same emergency number to be routed to different voice interfaces based on the zone that includes their ERL.

Related Commands

To enter Ethernet phone (ephone) configuration mode for an IP phone for the purposes of creating and configuring an ephone, use the ephone command in global configuration mode. To disable the ephone and remove the IP phone configuration, use the no form of this command.

Syntax Description

Command Default

No Cisco IP phone is configured.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

Use the ephone command to enter ephone configuration mode. Use ephone configuration mode to create and configure Cisco Unified IP phones in Cisco Unified CME.

Before this command can be used for the first time, you must set the maximum number of ephones using the max-ephones command in telephony-service configuration mode. The maximum number of ephones varies by router platform and software version.

Related Commands

To enter ephone-dn configuration mode to configure a directory number for an IP phone line, intercom line, paging line, voice-mail port, or message-waiting indicator (MWI), use the ephone-dn command in global configuration mode. To delete an ephone-dn, use the no form of this command.

Syntax Description

Command Default

No ephone-dn is configured.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

Use this command to enter ephone-dn configuration mode to create directory numbers. In ephone-dn configuration mode, you assign an extension number using the number command, a name to appear in the local directory using the name command, and other parameters using various commands.

Before using the ephone-dn command, you must set the maximum number of ephone-dns to support in your system by using the max-dn command. The maximum number of ephone-dns that you can create depends on the software version, router platform, and amount of memory that you have installed.

A dual-line ephone-dn has one virtual voice port and two channels to handle two independent calls. This capacity allows call waiting, call transfer, and conference functions within a single directory number. Dual-line mode is supported on all phone types, but is not appropriate for voice-mail numbers, intercoms, or ephone-dns used for message-waiting indicators, paging, loopback, or hunt groups. Overlays of single-line hunt groups onto dual-line buttons are supported.

An octo-line directory number supports up to eight active calls, both incoming and outgoing, on a single phone button. Unlike a dual-line directory number, which is shared exclusively among phones, an octo-line directory number can split its channels among the phones sharing the directory number. All phones sharing the octo-line directory number are allowed to initiate or receive calls on the idle channels of the directory number.

Ephone-dns are created in single-line mode if the dual-line or octo-line keyword is not used. To change an ephone-dn from one mode to another, for example from dual-line mode to single-line mode, you must delete the ephone-dn and then re-create it.

Related Commands

To enter ephone-dn-template configuration mode and create an ephone-dn template containing a standard set of ephone-dn features, use the ephone-dn-template command in global configuration mode. To delete an ephone-dn template, use the no form of this command.

Syntax Description

Command Default

No ephone-dn template is created.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

Use this command to create an ephone-dn template. An ephone-dn template contains a set of ephone-dn attributes that you can easily apply to one or more ephone-dns.

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.

Type? in ephone-dn-template configuration mode to see the commands that are available in this mode. The following example shows CLI help for ephone-dn-template configuration mode:

Router(config-ephone-dn-template)# ?
Ephone Dn template configuration commands:
  call-forward         Define E.164 telephone number for call forwarding
  call-waiting         Config call-waiting option
  caller-id            Configure port caller id parameters
  corlist              Class of Restriction on dial-peer for this dn
  default              Set a command to its defaults
  description          dn desc, for DN Qualified Display Name
  exit                 Exit from ephone-dn-template configuration mode
  hold-alert           Set Call On-Hold timeout alert parameters
  huntstop             Stop hunting on Dial-Peers
  mwi                  set message waiting indicator options (mwi)
  no                   Negate a command or set its defaults
  pickup-group         set the call pickup group number for the DN
  translate            Translation rule
  translation-profile  Translation profile

After creating an ephone-dn template, apply the template to one or more ephone-dns using the ephone-dn-template command in ephone-dn configuration mode. Even though you can define up to 15 different ephone templates, you cannot apply more than one template to a particular ephone-dn.

If you try to apply a second ephone-dn template to an ephone-dn that already has a template applied to it, the second template will overwrite the first ephone-dn template configuration after you use the restart command to reboot the phone.

To view your ephone-dn-template configurations, use the show telephony-service ephone-dn-template command. To see which ephone-dns have templates applied to them, use the show running-config command.

Related Commands

To apply an ephone-dn template to an ephone-dn, use the ephone-dn-template command in ephone-dn configuration mode. To remove the ephone-dn template, use the no form of this command.

Syntax Description

Command Default

No ephone-dn template is applied to the ephone-dn.

Command Modes

Ephone-dn configuration (config-ephone-template)

Command History

Usage Guidelines

Use the ephone-dn-template command in ephone-dn configuration mode to apply an ephone-dn template to an ephone. You cannot apply more than one ephone-dn template to an ephone-dn.

If you try to apply a second ephone-dn template to an ephone-dn that already has an ephone-dn template applied to it, the second template will overwrite the first ephone-dn template configuration.

To view your ephone-dn-template configurations, use the show telephony-service ephone-dn-template command.

Related Commands

To enter ephone-hunt configuration mode for the purposes of creating and configuring a hunt group for use in a Cisco Unified CME system, use the ephone-hunt command in global configuration mode. To delete a hunt group, use the no form of this command.

Syntax Description

Command Default

No hunt group is defined.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

Use the ephone-hunt command to enter ephone-hunt configuration mode. Use ephone-hunt configuration mode to create ephone hunt groups in a Cisco Unified CME system.

A hunt group is a list of phone numbers that are assigned to take turns receiving incoming calls for one number, a pilot number that is defined with the pilot command. The list of numbers in the hunt group is defined using the list command. If a number in the list is busy or does not answer, the call is redirected to the next number in the list. The last number tried is the final number, which is defined using the final command.

The order in which the numbers are chosen can be longest-idle, peer, or sequential.

• If the order is longest-idle, each hop is directed to the ephone-dn that has been idle the longest. Idle time is determined from the last time that a phone registered, reregistered, or went on-hook.
• If the order is peer, the first number to which calls are directed is the number to the right of the number in the list that was the last number to ring on the previous occasion that the hunt group was called. If that number is busy or does not answer, the call is directed to the next number in the list and, in the process, circles back to the beginning of the list. In peer hunt groups, the hops command specifies how many times a call can hop from number to number before going to the final number, after which the call is no longer forwarded.
• If the order is sequential, the first number to which calls are directed is always the first number in the list. If that number is busy or does not answer, the call is redirected to the next available number in the list, from left to right.

Note	If the number of times that a call is redirected to a new number exceeds five, the max-redirect command must be used to increase the allowable number of redirects in the Cisco Unified CME system.

To configure a new hunt group, you must specify the longest-idle, peer, or sequential keyword. To change an existing ephone hunt group configuration, the keyword is not required. To change the type of hunt group from peer to sequential or sequential to peer, you must remove the existing hunt group first using the no form of the command and then recreate it.

Related Commands

To authorize an ephone-dn to dynamically join and leave an ephone hunt group, use the ephone-hunt login command in ephone-dn configuration mode. To disable this capability, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Command Default

An ephone-dn is not allowed to dynamically join and leave ephone hunt groups.

Command Modes

Ephone-dn configuration (config-ephone-dn)

Command History

Usage Guidelines

Use the show ephone-hunt command to display current hunt group members, including those who joined the group dynamically.

Related Commands

Effective with Cisco Unified CME 9.0, the ephone-hunt statistics write-all command is replaced by the hunt group statistics write-all command in privileged EXEC mode. For more information, see the hunt group statistics write-all command.

To write ephone-hunt statistics information to a file, use the ephone-hunt statistics write-all command in privileged EXEC mode.

Syntax Description

Command Modes

Privileged EXEC (#)

Command History

Usage Guidelines

Use this command to write out, in hourly increments, all the ephone hunt group statistics for the past seven days. This command is intended be used when normal hunt group statistics collection is interrupted, perhaps due to TFTP server failure. The commands that are normally used to provide hunt-group statistics are hunt-group report delay hours, hunt-group report every hours, hunt-group report url, and statistics collect. These commands allow you to specify shorter, more precise reporting periods and file-naming conventions.

Note	Each year on the day that daylight saving time adjusts the time back by one hour at 2 a.m., the original 1 a.m. to 2 a.m. statistics for that day are lost because they are overwritten by the new 1 a.m. to 2 a.m. statistics.

Related Commands

To create an ephone template to configure a set of phone features and to enter ephone-template configuration mode, use the ephone-template command in global configuration mode. To delete an ephone template, use the no form of this command.

Syntax Description

Command Default

No ephone template is created.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

Use this command to create an ephone template containing a set of ephone commands. The template can then be easily applied to one or more ephones.

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.

Type ? in ephone-template configuration mode to see the commands that are available in this mode and that can be included in an ephone-template. The following example shows CLI help for ephone-template configuration mode at the time that this document was written:

Router(config-ephone-template)#?
Ephone template configuration commands:
  after-hour        ephone exempt from after-hour blocking
  codec             Set preferred codec for calls with other phones on this
                    router
  default           Set a command to its defaults
  exit              Exit from ephone-template configuration mode
  fastdial          Define ip-phone fastdial number
  features          define features blocked
  keep-conference   Do not disconnect conference when conference initiator
                    hangs-up.Connect remaining parties together directly using
                    call transfer.
  keepalive         Define keepalive timeout period to unregister IP phone
  keyphone          Identify an IP phone as keyphone
  mtp               Always send media packets to this router
  network-locale    Select the network locale for this template.  
  night-service     Define night-service bell
  no                Negate a command or set its defaults
  paging-dn         set audio paging dn group for phone
  service           Service configuration in ephone template
  softkeys          define softkeys per state
  speed-dial        Define ip-phone speed-dial number
  transfer          transfer related configuration
  transfer-park     customized transfer to park configuration
  transfer-pattern  customized transfer-pattern configuration
  type              Define ip-phone type
  user-locale       Select the user locale for this template. 
 

After creating an ephone template, apply the template to one or more ephones using the ephone-template command in ephone configuration mode. Even though you can define up to 20 different ephone templates, you cannot apply more than one template to a particular ephone.

After applying a template to an ephone or removing a template from an ephone, use the following commands:

• restart—Performs a fast reboot of the phone.
• create cnf-files—Rebuilds configuration files.

If you try to apply a second ephone template to an ephone that already has an ephone template applied to it, the second template will overwrite the first ephone template configuration after you use the restart command to reboot the phone.

To view your ephone-template configurations, use the show telephony-service ephone-template command. To see which ephones have templates applied to them, use the show running-config command.

Related Commands

To apply an ephone template to a particular SCCP phone in Cisco Unified CME, use the ephone-template command in ephone configuration mode. To remove the ephone template, use the no form of this command.

Syntax Description

Command Default

No ephone template is applied to a phone.

Command Modes

Ephone configuration (config-ephone)

Command History

Usage Guidelines

This command in ephone configuration mode applies an ephone template to a particular phone.

In Cisco Unified CME 4.3 and later versions, an ephone template cannot be applied to a particular phone unless its configuration file includes its MAC address. If you attempt to apply a template to a phone for which the MAC address in not configured, a message appears. To configure the MAC address for a Cisco Unified IP phone, use the mac-address command in ephone configuration mode.

After applying an ephone template, use the restart command to perform a fast reboot of the phone.

You cannot apply more than one ephone template at a time to any phone. If you attempt to apply a second ephone template to phone to which an ephone template is already applied, the second template will overwrite the first ephone template configuration after you reboot the phone.

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 set in ephone configuration mode has priority over the value set in ephone-template configuration mode.

To view your ephone-template configurations, use the show telephony-service ephone-template command.

Related Commands

To add a Cisco Unified IP phone type by defining an ephone-type template, use the ephone-type command in global configuration mode. To remove an ephone type, use the no form of this command.

Syntax Description

Command Default

Ephone type is not defined.

Command Modes

Global configuration (config)

Command History

Usage Guidelines

This command adds a user-defined template for a phone type to a Cisco Unified CME system. This configuration template defines a set of attributes that describe the features of the new phone type. Use this command to add phone types that are not already defined in the system.

If you use a phone-type argument that matches a system-defined phone type, a message displays notifying you that the ephone-type is built-in and cannot be changed. For a list of system-defined phone types, see the type command.

Use the create cnf-files command for the new phone type to take effect.

Related Commands

To exclude the availability of local services on a phone’s user interface such as, Extension Mobility (EM), My Phone Apps, and Local Directory from the phone’s configuration, use the exclude command in ephone or ephone-template mode.

Syntax Description

Command Default

Local services are enabled.

Command Modes

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

Command History

Usage Guidelines

Use this command to exclude the availability of local services such as, EM, my phone apps, and local directory services from the phone configuration.

Related Commands

To exclude from the Cisco Unified SIP IP phone’s user interface the availability of local services such as Extension Mobility (EM), My Phone Apps, and Local Directory, use the exclude command in voice register pool or voice register template configuration mode.

Syntax Description

Command Default

Local services are enabled.

Command Modes

Voice register pool configuration (config-register-pool)

Voice register template configuration (config-register-temp)

Command History

Related Commands

To set the time after which emergency callback history expires, use the expiry command in voice emergency response settings configuration mode. To remove the number, use the no form of this command.

Syntax Description

Command Default

The default expiry time is 180 minutes.

Command Modes

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

Command History

Usage Guidelines

Use this command to specify the amount of time (in minutes) to keep emergency caller history for each ELIN. The time can be an integer in the range of 2 to 2880 minutes. The default value is 180 minutes.

Related Commands

To enable provision tags for identifying ephone configurations when using the extension assigner application, use the extension-assigner tag-type command in telephony-service configuration mode. To return to the default setting of using the ephone tag, use the no form of this command.

Syntax Description

Command Default

Ephone tags are used to identify ephone configurations for the extension assigner application.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Usage Guidelines

This command enables you to use provision tags for identifying ephone configurations to be assigned by the extension application application.

A provision tag is an unique number other than an ephone tag, such as a jack number or an extension number, for identifying the ephone configuration to be assigned to a particular IP phone by the extension assigner application.

Use this command to specify which type of tag, ephone tag or provision tag, is to be used to identify ephone configurations for the extension assigner application. The default configuration is ephone tag.

If you use this command with the provision-tag keyword, use the provision-tag command to create provision tags.

Related Commands

To define a range of extension numbers for a specific MOH group in Cisco Unified CME or Cisco Unified SRST, use the extension-range command in voice-moh-group configuration mode. To define a range of extension numbers for a specific directory number in Cisco Unified CME, use the extension-range command in ephone-dn configuration mode. To disable the extension-range command, use the no form of this command.

Syntax Description

Command Default

No extension- range is configured.

Command Modes

Voice MOH group configuration (config-voice-moh-group)
Ephone-dn configuration (config-ephone-dn)

Command History

Usage Guidelines

This command configured in voice moh-group configuration mode identifies MOH clients calling extension numbers specified under the extension range configured for a MOH group in Cisco Unified CME or Cisco Unified SRST. This command in ephone-dn configuration mode identifies MOH clients calling extension numbers specified under the extension range configured for a directory number in Cisco Unified CME

You can define multiple extension-ranges in the same MOH group or directory number.

The extension can be expressed in hexadecimal digits ranging from 0-9 or A-F and should not exceed the limit of 32 digits.

The starting-extension and ending-extension numbers must contain the same number of digits.

The ending extension number must be of a greater value than the starting extension number.

Extension-range for a MOH group must not overlap with any other extension-range configured in any other MOH group.

Note	If an extension range is defined in a MOH group and it is also defined under ephone-dn, the extension range defined under ephone-dn takes precedence.

Related Commands

To specify the type of ring sound used on Cisco Session Initiation Protocol (SIP) or Cisco SCCP IP phones for external calls, use the external-ring command in voice register global configuration mode. To return to the default ring sound, use the no form of this command.

Syntax Description

Command Default

The default ring sound is an internal ring pattern.

Command Modes

Voice register global configuration (config-register-global)

Command History

Usage Guidelines

When set, this command defines varying ring tones so that you can discriminate between internal and external calls from Cisco SIP or Cisco SCCP IP phones.