-
Cisco Unified Communications Manager Express Command Reference
-
Preface
-
Commands List by Config Mode
-
New, Modified, and Removed Commands in Cisco Unified CME 4.0 and Later
-
Cisco Unified CME Commands: A
-
Cisco Unified CME Commands: B
-
Cisco Unified CME Commands: C
-
Cisco Unified CME Commands: D
-
Cisco Unified CME Commands: Debug
-
Cisco Unified CME Commands: E
-
Cisco Unified CME Commands: F
-
Cisco Unified CME Commands: G
-
Cisco Unified CME Commands: H
-
Cisco Unified CME Commands: I
-
Cisco Unified CME Commands: K
-
Cisco Unified CME Commands: L
-
Cisco Unified CME Commands: M
-
Cisco Unified CME Commands: N
-
Cisco Unified CME Commands: O
-
Cisco Unified CME Commands: P
-
Cisco Unified CME Commands: R
-
Cisco Unified CME Commands: sast1 trustpoint through show fb-its-log
-
Cisco Unified CME Commands: show presence global through system message
-
Cisco Unified CME Commands: T
-
Cisco Unified CME Commands: U
-
Cisco Unified CME Commands: V
-
Cisco Unified CME Commands: W
-
Cisco Unified CME Commands: X
-
Table Of Contents
Cisco Unified CME Commands: sast1 trustpoint through show fb-its-log
sdspfarm conference mute-on mute-off
semi-attended enable (voice register template)
service-domain midcall-mismatch
show ephone attempted-registrations
Cisco Unified CME Commands: sast1 trustpoint through show fb-its-log
Revised: ONovember 3, 2009.
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 references. Use the reference master index or search online to find these commands.
sast1 trustpoint
To specify the name of the SAST1 trustpoint, use the sast1 trustpoint command in CTL-client configuration mode. To return to the default, use the no form of this command.
sast1 trustpoint label
no sast1
Syntax Description
Command Default
No SAST1 trustpoint name is specified
Command Modes
CTL-client configuration (config-ctl-client)
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.
The sast1 trustpoint and sast2 trustpoint commands are used to set up the System Administrator Security Token (SAST) credentials, which are used to sign the CTL file. The SAST1 and SAST2 certificates must be different from each other, but to conserve memory either one of them can use the same certificate as Cisco Unified CME. The CTL file is always signed by SAST1 credentials. The SAST2 credentials are included in the CTL file so that if the SAST1 certificate is compromised, the CTL file can be signed by SAST2 to prevent the phones from being reset to their factory defaults.
Examples
The following example names sast1tp as the SAST1 trustpoint.
Router(config)# ctl-client
Router(config-ctl-client)# server capf 10.2.2.2 trustpoint capftrust
Router(config-ctl-client)# server cme 10.2.2.3 trustpoint cmetp
Router(config-ctl-client)# server tftp 10.2.2.4 trustpoint tftptp
Router(config-ctl-client)# sast1 trustpoint sast1tp
Router(config-ctl-client)# sast2 trustpoint sast2tp
Router(config-ctl-client)# regenerate
Related Commands
sast2 trustpoint
To specify the name of the SAST2 trustpoint, use the sast2 trustpoint command in CTL-client configuration mode. To return to the default, use the no form of this command.
sast2 trustpoint label
no sast2
Syntax Description
Command Default
No SAST2 trustpoint name is specified.
Command Modes
CTL-client configuration (config-ctl-client)
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.
The sast1 trustpoint and sast2 trustpoint commands are used to set up the System Administrator Security Token (SAST) credentials, which are used to sign the CTL file. The SAST1 and SAST2 certificates must be different from each other, but to conserve memory either one of them can use the same certificate as Cisco CME. The CTL file is always signed by SAST1 credentials. The SAST2 credentials are included in the CTL file so that if the SAST1 certificate is compromised, the CTL file can be signed by SAST2 to prevent the phones from being reset to their factory defaults.
Examples
The following example names sast2tp as the SAST2 trustpoint.
Router(config)# ctl-client
Router(config-ctl-client)# server capf 10.2.2.2 trustpoint capftrust
Router(config-ctl-client)# server cme 10.2.2.3 trustpoint cmetp
Router(config-ctl-client)# server tftp 10.2.2.4 trustpoint tftptp
Router(config-ctl-client)# sast1 trustpoint sast1tp
Router(config-ctl-client)# sast2 trustpoint sast2tp
Router(config-ctl-client)# regenerate
Related Commands
sdspfarm conference mute-on mute-off
To define mute-on and mute-off DTMF digits for use during conferencing, use the sdspfarm conference mute-on mute-off command in telephony-service configuration mode. To disable the mute-on and mute-off digits, use the no form of this command.
sdspfarm conference mute-on mute-on-digits mute-off mute-off-digits
no sdspfarm conference mute-on mute-on-digits mute-off mute-off-digits
Syntax Description
Command Default
No mute-on or mute-off digits are defined.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
You must define mute-on and mute-off digits to mute or unmute your phone using the keypad during a conference. The mute-on digits and mute-off digits can be the same or different. You can mute and unmute your phone using the phone's mute button also. You must unmute the phone in the same way that you muted it, either with the keypad or the mute button.
Examples
The following example configures #5 as the buttons to press to mute and unmute the phone during a conference:
Router(config-telephony)# sdspfarm conference mute-on #5 mute-off #5
sdspfarm tag
To permit a digital-signal-processor (DSP) farm to be to registered to Cisco Unified CME and associate it with a Skinny Client Control Protocol (SCCP) client interface's MAC address, use the sdspfarm tag command in telephony-service configuration mode. To delete a tag generated by the sdspfarm tag command, use the no form of this command.
sdspfarm tag number device-name
no sdspfarm tag number device-name
Syntax Description
number
Numeric name for a DSP farm. Number from 1 to 5.
device-name
MAC address of the SCCP client interface that is preceded by the Message Transfer Part (MTP).
Command Default
DSP farm is not created.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
DSP farms are sets of DSP resources used for conferencing and transcoding only. DSP farms do not include voice termination resources. Use the show interface command to find the MAC address of the SCCP client interface.
Examples
The following example declares tag 1 as the MAC address of mac000a.8aea.ca80. The show interface command is used to obtain the MAC address.
Router# show interface FastEthernet 0/0
.
.
.
FastEthernet0/0 is up, line protocol is up
Hardware is AmdFE, address is 000a.8aea.ca80 (bia 000a.8aea.ca80)
.
.
.
Router(config)# telephony-service
Router(config-telephony)# sdspfarm tag 1 mac000a.8aea.ca80
Related Commands
sdspfarm transcode sessions
To specify the maximum number of transcoding sessions allowed per Cisco CallManager Express (Cisco CME) router, use the sdspfarm transcode sessions command in telephony-service configuration mode. To return to the default transcode session of 0, use the no form of this command.
sdspfarm transcode sessions number
no sdspfarm transcode sessions number
Syntax Description
Command Default
The default is 0.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
The transcoding is allowed between G.711 and G.729. A session consists of two transcode streams. To configure this information, you must know how many digital-signal-processor (DSP) farms are configured on the network module (NM) farms in your Cisco CME router. DSP farms are sets of DSP resources used for conferencing and transcoding only. DSP farms do not include voice termination resources. To learn how many DSP farms have been configured on your Cisco CME router, use the show sdspfarm command.
Examples
The following example sets the maximum number of transcoding sessions allowed on the Cisco CME router to 20:
Router(config)# telephony-service
Router(config-telephony)# sdspfarm transcode sessions 20
Related Commands
sdspfarm units
To specify the maximum number of digital-signal-processor (DSP) farms that are allowed to be registered to the Skinny Client Control Protocol (SCCP) server, use the sdspfarm units command in telephony-service configuration mode. To set the number of DSP farms to the default value of 0, use the no form of this command.
sdspfarm units number
no sdspfarm units number
Syntax Description
Command History
The default number is 0.
Command Modes
Telephony-service configuration
Command History
Usage Guidelines
DSP farms are sets of DSP resources used for conferencing and transcoding only. DSP farms do not include voice termination resources.
Examples
The following example configures a Cisco CME router to register one DSP farm:
Router(config)# telephony-service
Router(config-telephony)# sdspfarm units 1
Related Commands
sdspfarm unregister force
To remove all transcoding streams associated with active calls, use the sdspfarm unregister force command in telephony-service configuration mode. To deactivate the removal of transcoding streams, use the no form of this command.
sdspfarm unregister force
no sdspfarm unregister force
Syntax Description
This command has no arguments or keywords.
Command Default
The default is transcoding streams are not removed.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
If any of the SCCP server's associated streams are functioning in active calls, the default response for the sdspfarm unregister force command is to reject them. If no stream is used in a call, all of the transcoding streams associated with the DSP farm will be released, and SCCP server can recycle those streams for other DSP farms.
Examples
The following example removes all transcoding streams for active calls.
Router(config)# telephony-service
Router(config-telephony)# sdspfarm unregister force
Related Commands
secondary start
To specify the ephone hunt group agent to receive parked calls that are forwarded to the secondary pilot number, use the secondary start command in ephone-hunt configuration mode. To disable this setting, use the no form of this command.
secondary start [current | next | list-position]
no secondary start [current | next | list-position]
Syntax Description
Command Default
No hunt-group agent is specified for receiving parked calls that are forwarded to the secondary pilot number.
Command Modes
Ephone-hunt configuration (config-ephone)
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
When a call that has been parked by a hunt group agent meets either of these conditions, the hunt group agent to receive the call can be specified with the secondary start command:
•
The call is recalled from call park to the hunt group secondary pilot number.
•
Examples
The following example specifies that the third hunt group member (3031) will receive calls that are recalled or forwarded to the secondary group hunt pilot number (3001) after the calls have been parked by an ephone-dn.
ephone-hunt 17 sequential
pilot 3000 secondary 3001
list 3011, 3021, 3031
timeout 10
final 7600
secondary start 3
Related Commands
ephone-hunt
Defines an ephone hunt group and enters ephone-hunt configuration mode.
list
Creates a list of extensions that are members of an ephone hunt group
secondary-dialtone
To activate a secondary dial tone when a Cisco IP phone user dials a defined public switched telephone network (PSTN) access prefix, use the secondary-dialtone command in telephony-service configuration mode. To disable the secondary dial tone, use the no form of this command.
secondary-dialtone digit-string
no secondary-dialtone
Syntax Description
Command Default
No secondary dial tone is enabled.
Command Modes
Telephony-service configuration (config-ephone)
Command History
12.2(15)ZJ
Cisco CME 3.0
This command was introduced.
12.3(4)T
Cisco CME 3.0
This command was integrated into Cisco IOS Release 12.3(4)T.
Usage Guidelines
The secondary dial tone is turned off when the next number after the access prefix is pressed. For example, if 8 is the access prefix and a person dials 8 555-0145, the secondary dial tone is turned off when the digit 5 is pressed.
Examples
The following example enables a secondary dial tone when a Cisco IP phone users press the digit 9 to get an outside line:
Router(config)# telephony-service
Router(config-telephony)# secondary-dialtone 9
Related Commands
secure-signaling trustpoint
To specify the name of the PKI trustpoint with the certificate to use for TLS handshakes with IP phones on TCP port 2443, use the secure-signaling trustpoint command in telephony-service configuration mode. To return to the default, use the no form of this command.
secure-signaling trustpoint label
no secure-signaling trustpoint
Syntax Description
Command Default
No trustpoint is specified.
Command Modes
Telephony-service configuration (config-telephony)
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 to name the trustpoint that enables handshaking between Cisco Unified CME and a phone to ensure secure SCCP signaling on TCP port 2443.
Examples
The following example names server25, the CAPF server, as the trustpoint to enable secure SCCP signaling:
Router(config)# telephony-service
Router(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
security (ephone-type)
To define whether a phone type supports security features, use the security command in ephone-type configuration mode. To disable security support, use the no form of this command.
security
no security
Syntax Description
This command has no arguments or keywords.
Command Default
Enabled (phone type supports security features).
Command Modes
Ephone-type configuration (config-ephone-type)
Command History
Usage Guidelines
This command specifies whether security features are supported by the type of phone being added with a phone-type template.
Examples
The following example shows that support for security is disabled for the Nokia E61 when creating the ephone-type template:
Router(config)# ephone-type E61
Router(config-ephone-type)# no security
Related Commands
device-id
Specifies the device ID for a phone type.
type
Assigns a phone type to an SCCP phone.
semi-attended enable (voice register template)
To enable call transfer at the alert call stage for supported SIP phones in Cisco Unified CME, use the semi-attended enable command in the voice register template mode. To disable call transfer, use the no form of this command.
semi-attended enable
no semi-attended enable
Syntax Description
This command has no arguments or keywords.
Command Default
Call transfer at the alert call stage is enabled.
Command Modes
Voice register template (config-register-temp)
Command History
Usage Guidelines
This command enables a call transfer at the alert stage in the specified template which can then be applied to SIP phones in Cisco Unified CME. Semi-attended call transfer is enabled by default. To disable semi-attended call transfer, use the no semi-attended command.
To apply the template to a SIP phone, use the template command in voice register pool configuration mode.
Examples
The following partial output from the show-running config command shows that the semi-attended call transfer is disabled in voice register template 1:
Router# show running-config
!
.
.
.
!
voice register template 1
no semi-attended enabled
!
The following example shows how to enable semi-attended call transfer in a template:
Router(config)# voice register template 1
Router(config-register-temp)# semi-attend enable
Related Commands
server (CTL-client)
To enter trustpoint information for the CAPF server, Cisco Unified CME router, or TFTP server into the router configuration, use the server command in CTL-client configuration mode. To return to the default, use the no form of this command.
server {capf | cme | cme-tftp | tftp} ip-address trustpoint label
no server {capf | cme | cme-tftp | tftp} ip-address
Syntax Description
Command Default
Trustpoint information about the CAPF server, Cisco Unified CME router, or TFTP server is not present in the security configuration.
Command Modes
CTL-client configuration (config-ctl-client)
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. Cisco IOS software stores credential information in a trustpoint. The trustpoint label in this command names the specified PKI trustpoint.
Note
Examples
The following example defines trustpoint names and IP addresses for the CAPF server, the Cisco Unified CME router, and the TFTP server:
Router(config)# ctl-client
Router(config-ctl-client)# server capf 10.2.2.2 trustpoint capftrust
Router(config-ctl-client)# server cme 10.2.2.3 trustpoint cmetp
Router(config-ctl-client)# server tftp 10.2.2.4 trustpoint tftptp
Router(config-ctl-client)# sast1 trustpoint sast1tp
Router(config-ctl-client)# sast2 trustpoint sast2tp
Router(config-ctl-client)# regenerate
server (presence)
To specify the IP address of a presence server for sending presence requests from internal watchers to external presence entities, use the server command in presence configuration mode. To remove the server, use the no form of this command.
server ip-address
no server
Syntax Description
Command Default
A remote presence server is not used.
Command Modes
Presence configuration (config-presence)
Command History
12.4(11)XJ
This command was introduced.
12.4(15)T
This command was integrated into Cisco IOS Release 12.4(15)T.
Usage Guidelines
This command specifies the IP address of a presence server that handles presence requests when the watcher and presence entity (presentity) are not collocated. The router acts as the presence server and processes all presence requests and status notifications when a watcher and presentity are both internal. If a subscription request is for an external presentity, the request is sent to the remote server specified by this command.
Examples
The following example shows a presence server with IP address 10.10.10.1:
Router(config)# presence
Router(config-presence)# allow subscribe
Router(config-presence)# server 10.10.10.1
Related Commands
server-security-mode
To change the security mode of the Cisco Unified CME phone authentication server, use the server-security-mode command in telephony-service configuration mode. To change the mode from secure to nonsecure, use the no form of this command.
server-security-mode {erase | non-secure | secure}
no server-security-mode
Syntax Description
erase
Deletes the certificate trust list (CTL) file.
non-secure
Enables nonsecure mode.
secure
Secure mode.
Command Default
When the CTL file is initially generated, the mode is set to secure.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
This command is used with Cisco Unified CME phone authentication.
This command has no effect until the CTL file is initially generated by the CTL client. When the CTL file is successfully generated, the CTL client automatically sets the server security mode to secure. You can then toggle the mode from secure to nonsecure using this command.
After toggling between secure and non-secure mode, you must use the regenerate command in CTL-client configuration mode to generate the CTL file. This is necessary because if the security mode is nonsecure, its credentials are zeroed out in the CTL file. If the security mode is secure, the CTL file contains the server's credentials.
The no version of this command sets the mode to non-secure; it does not remove the command from your configuration.
To remove this command from your configuration and revert to the state before the Cisco Unified CME security feature was activated, use the erase keyword and follow the instructions displayed on the console. When you use this command with the erase keyword, the router checks whether the Cisco IOS CTL-provider process is running, and if not, it deletes the CTL file from router storage. After using this command to delete the CTL file, you must manually delete the CTL file from any SCCP phones that had downloaded it previously.
Examples
The following example changes the mode of the server to non-secure.
telephony-service
server-security-mode non-secure
Related Commands
regenerate
Creates a new CTLFile.tlv file after changes are made to the CTL client configuration.
service-digit
To enable phone users to dial a service digit to request off-net services, use the service-digit command in voice MLPP configuration mode. To reset to the default, use the no form of this command.
service-digit
no service-digit
Syntax Description
This command has no arguments or keywords.
Command Default
Service digit is disabled.
Command Modes
Voice MLPP configuration (config-voice-mlpp)
Command History
15.0(1)XA
Cisco Unified CME 8.0
This command was introduced.
Usage Guidelines
This command enables users to request off-net services by dialing a service digit, after dialing the MLPP access digit. The service digit provides information to the switch when connecting calls to government or public telephone services or networks that are not part of the Defense Switched Network (DSN).
Phone users request a service by dialing the access code NS, where N is the preconfigured MLPP access digit and S is the service digit. The service digit is a number from 5 to 9.
In Cisco Unified CME, the dial plan must be configured to play secondary dial-tone and the rest of the dialed digits are collected and passed to the off-net trunk. The digits that follow the prefix NS must be E.164 compliant.
Examples
The following example shows how to enable users to dial a service digit:
Router(config)# voice mlppRouter(config-voice-mlpp)# service-digitRelated Commands
access-digit
Defines the access digit that phone users dial to request a precedence call.
mlpp preemption
Enables preemption capability on an SCCP phone or analog FXS port.
service directed-pickup
To enable Directed Call Pickup and modify the function of the GPickUp and PickUp soft keys, use the service directed-pickup command in telephony-service configuration mode. To disable Directed Call Pickup, use the no form of this command.
service directed-pickup [gpickup]
no service directed-pickup [gpickup]
Syntax Description
Command Default
For SCCP phones, Directed Call Pickup using the PickUp soft key is enabled.
For SIP phones, Directed Call Pickup is not enabled.Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
This command modifies the function of the GPickUp and PickUp soft keys for the Directed Call Pickup and Local Group Pickup features.
To globally disable Directed Call Pickup on all phones, use the no form of this command. The no form of this command also changes the behavior of the PickUp soft key on IP phones so that a user pressing it invokes Local Group Pickup instead of Directed Call Pickup.
To selectively remove the PickUp soft key from one or more SCCP phones, use the features blocked command in ephone-template mode. The features blocked command removes the PickUp soft key from SCCP IP phones and blocks Directed Call Pickup on analog phones to which you apply the template.
Table 16 describes the use of the GPickUp and PickUp soft keys for each feature depending on the setting of this command.
Table 16 service directed-pickup Command Comparison
Directed Call Pickup
(Call on any ringing extension)GPickUp soft key and extension
Local Group Pickup
(Call in same group)GPickUp soft key and * or PickUp soft key
Other Group Pickup
(Call in different group)GPickUp soft key and pickup group number
Directed Call Pickup
PickUp soft key and extension
Local Group Pickup
GPickUp soft key and *
GPickUp soft key and *
or Pickup soft keyOther Group Pickup
GPickUp soft key and pickup group number
Directed Call Pickup
—
Local Group Pickup
GPickUp soft key and * or PickUp soft key
Other Group Pickup
GPickUp soft key and pickup group number
1 Supported in Cisco Unified CME 7.1 and later versions.
Examples
The following example shows that Directed Call Pickup is disabled globally:
telephony-service
no service directed-pickup
The following example shows that Directed Call Pickup, Group Pickup, and Local Group Pickup can be performed using the GPickUp soft key:
telephony-service
service directed-pickup gpickup
Related Commands
service dnis dir-lookup
To allow the display of names associated with called numbers for incoming calls on IP phones, use the service dnis dir-lookup command in telephony-service configuration mode. To deactivate directory lookup, use the no form of this command.
service dnis dir-lookup
no service dnis dir-lookup
Command Default
The default is directory service lookup is inactive.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
The service dnis dir-lookup command provides a called number to the name-lookup service to support display of the name associated with the called number for incoming calls to IP phones. The display name is obtained from the Cisco CME system's list of Cisco CME directory names created using the directory entry command in the telephony-service configuration mode.
Called numbers can be displayed for overlaid ephone-dn and for ephone-dns that are not overlaid. Secondary line are supported.
To allow a single ephone-dn to receive calls for multiple different called numbers (with different names), you must use wildcard "." characters in the number field for the ephone-dn.
To use the service dnis dir-lookup command in conjunction with the ephone-hunt, you can configure the ephone-hunt group to use a pilot number that contains wildcard "." characters. This command allows the ephone-hunt group to receive calls from different numbers. Individual ephone-dns that are configured as members of the hunt group with the ephone-hunt list must not have wildcard characters in their number fields.
If the service dnis dir-lookup is used at the same time as the service dnis overlay, the directory-lookup service takes precedence in resolving the name for the called number.
Examples
The following is an example of an overlaid ephone-dn configuration, where the service dnis dir-lookup allows one of three directory entry names to be displayed on three IP phones when a call is placed to a number declared in the directory entry command.
telephony-service
service dnis dir-lookup
directory entry 1 0001 name dept1
directory entry 2 0002 name dept2
directory entry 3 0003 name dept3
ephone-dn 1
number 0001
ephone-dn 2
number 0002
ephone-dn 2
number 0002
ephone 1
button 1o1,2,3
ephone 2
button 1o1,2,3
ephone 3
button 1o1,2,3
The following is an example of an ephone-dn configuration in which the overlay function is not in use. There are three IP phones, each with two buttons. Button 1 receives calls from user1, user2, and user3; button 2 receives calls from user4, user5, and user6.
telephony-service
service dnis dir-lookup
directory entry 1 5550001 name user1
directory entry 2 5550002 name user2
directory entry 3 5550003 name user3
directory entry 4 5550010 name user4
directory entry 5 5550011 name user5
directory entry 6 5550012 name user6
ephone-dn 1
number 555000.
ephone-dn 2
number 5552001.
ephone 1
button 1:1
button 2:2
mac-address 1111.1111.1111
ephone 2
button 1:1
button 2:2
mac-address 2222.2222.2222
The following is an example of a hunt-group configuration. There are three phones, each with two buttons, and each button is assigned two numbers. When a person calls 5550341, Cisco CME matches the hunt-group pilot secondary number (555....) and rings button 1 on one of the two phones and displays "user1." The selection of the phone is dependent on the ephone-hunt settings.
telephony-service
service dnis dir-lookup
max-redirect 20
directory entry 1 5550341 name user1
directory entry 2 5550772 name user2
directory entry 3 5550263 name user3
directory entry 4 5550150 name user4
ephone-dn 1
number 1001
ephone-dn 2
number 1002
ephone-dn 3
number 1003
ephone-dn 4
number 1004
ephone 1
button 1o1,2
button 2o3,4
mac-address 1111.1111.1111
ephone 2
button 1o1,2
button 2o3,4
mac-address 2222.2222.2222
ephone-hunt 1 peer
pilot 1000 secondary 555....
list 1001, 1002, 1003, 1004
final 5556000
hops 5
preference 1
timeout 20
no-reg
The following is an example of a secondary-line configuration. Ephone-dn 1 can accept calls from extension 1001 and from 5550000, 5550001, and 5550002.
telephony-service
service dnis dir-lookup
directory entry 1 5550000 name doctor1
directory entry 2 5550001 name doctor2
directory entry 3 5550002 name doctor3
ephone-dn 1
number 1001 secondary 555000.
ephone 1
button 1:1
mac-address 2222.2222.2222
Related Commands
service dnis overlay
To allow incoming calls to an ephone-dn overlay to display called ephone-dn names, use the service dnis overlay command in telephony-service configuration mode. To deactivate the service dialed number identification service (DNIS) overlay, use the no form of this command.
service dnis overlay
no service dnis overlay
Defaults
The ephone-dn names in an ephone-dn overlay are not displayed on IP phones.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
The service dnis overlay allows phone users to determine which ephone-dn within an overlay set is being called. Up to ten ephone-dns are allowed per overlay set. When an incoming call is presented under a service dnis overlay configuration, the phone displays the name of the individual ephone-dn according to the name configured under the ephone-dn configuration mode. Note that for an ephone-dn name to be displayed on IP phones, you must first assign ephone-dn names with the name command in ephone-dn configuration mode.
The number of the first ephone-dn listed in the button is the default display for all phones using the same set of overlaid ephone-dns. Calls to the first ephone-dn display the caller ID. Calls to the remaining ephone-dns display ephone-dn names. For example, if there are three phones with one overlay set containing five ephone-dns, the first ephone-dn's number listed is the default display for all three phones. A call to the first ephone-dn displays the caller ID on all phones until the call is picked up. When the call is answered by phone 1, the displays in phone 2 and phone 3 return to the default display. Calls to the last four ephone-dns display ephone-dn names.
If the service dnis overlay is used at the same time as the service dnis dir-lookup, the service dnis dir-lookup takes precedence in determining the name to be displayed.
Examples
The following is an overlay configuration for two phones with button 1 assigned to pick up three 800 numbers from three ephone-dns that have been assigned names. The default display for button 1 is 18005550100. A call to 18005550100 displays the caller ID. Calls to 18005550001 and 18005550002 display "name1" and "name2," respectively.
telephony-serviceservice dnis overlayephone-dn 1name mainnumbernumber 18005550100ephone-dn 2name name1number 18005550001ephone-dn 3name name2number 18005550002ephone 1button 1o1,2,3ephone 2button 1o1,2,3Related Commands
name
Associates a name with a Cisco CME extension (ephone-dn).
service dnis dir-lookup
Allows directory entry lookup for the display of directory entry names on IP phones.
service-domain
To set the global MLPP domain type and number, use the service-domain command in voice MLPP configuration mode. To reset to the default, use the no form of this command.
service-domain {drsn | dsn} identifier domain-number
no service-domain
Syntax Description
Command Default
Domain type is dsn; domain number is 0.
Command Modes
Voice MLPP configuration (config-voice-mlpp)
Command History
15.0(1)XA
Cisco Unified CME 8.0
This command was introduced.
Usage Guidelines
This command sets the global domain type and number in Cisco Unified CME. Use the mlpp service-domain command to assign registered phones to different service domains. Any phone not configured with a specific service domain uses this global domain for MLPP calls.
Examples
The following example shows the global domain set to DSN with identifier 0010:
Router(config)# voice mlppRouter(config-voice-mlpp)# service-domain dsn identifier 0010Related Commands
service-domain (voice class)
To set the service domain name in the MLPP voice class, use the service-domain command in voice class configuration mode. To reset to the default, use the no form of this command.
service-domain {drsn | dsn}
no service-domain
Syntax Description
Command Default
Domain name is dsn.
Command Modes
Voice class configuration (config-class)
Command History
15.0(1)XA
Cisco Unified CME 8.0
This command was introduced.
Usage Guidelines
This command sets the domain name that is used for off-net MLPP calls.
After using this command, assign the voice class to an outbound POTS or VoIP dial peer by using the voice-class mlpp command.
Examples
The following example shows the domain name set to DSN:
Router(config)# voice class mlpp
Router(config-class)# service-domain dsn
Related Commands
service-domain midcall-mismatch
To define the behavior when there is a domain mismatch between the two legs of a call, use the service-domain midcall-mismatch command in voice MLPP configuration mode. To reset to the default, use the no form of this command.
service-domain midcall-mismatch {method1 | method2 | method3 | method4}
no service-domain midcall-mismatch
Syntax Description
Command Default
The default is method1.
Command Modes
Voice MLPP configuration (config-voice-mlpp)
Command History
15.0(1)XA
Cisco Unified CME 8.0
This command was introduced.
Usage Guidelines
This command determines the service domain and precedence level to apply in the case of a mismatch of these values between the two connections (call legs) of a call. This typically occurs when supplementary services such as Call Transfer or Conferencing are invoked during a call.
Examples
The following example shows the domain mismatch method set to 2:
Router(config)# voice mlppRouter(config-voice-mlpp)# service-domain midcall-mismatch method2Related Commands
service dss
To enable DSS (Direct Station Select) in a Cisco Unified CME system, use the service dss command in telephony-service configuration mode. To globally disable the DSS feature, use the no form of this command.
service dss
no service dss
Syntax Description
This command has no arguments or keywords.
Command Default
DSS service is disabled.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
This command enables phone users to quickly transfer calls to an extension selected by a speed-dial or monitor line button without having to press the Transfer button. If this command is enabled, a user can transfer a call when the call is in the connected state by simply pressing a speed-dial or monitor line button to select the transfer destination. The transfer action is automatically implied by CME if the service dss is enabled.
This feature is supported only on phones on which monitor-line buttons for speed dial or speed-dial line buttons are configured.
Using the no form of the changes the behavior of the speed-dial line button on all IP phones so that a user pressing a speed-dial button in the middle of a connected call will play out the speed-dial digits into the call without transferring the call. If the service dss is disabled, the phone user must press the Transfer button before pressing the speed-dial line button or monitor line button to transfer the call.
For Cisco Unified CME 4.0 and earlier, the transfer-system full-consult dss is used to select between blind transfers and consult transfers for the DSS case.
Examples
The following example globally enables directed call pickup.
telephony-service
service dss
Related Commands
service local-directory
To enable the availability of the local directory service on IP phones served by the Cisco CallManager Express (Cisco CME) router, use the service local-directory command in telephony service configuration mode. To disable the display, use the no form of this command.
service local-directory [authenticate]
no service local-directory [authenticate]
Syntax Description
Command Default
Local directory service is available on IP Phones.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines
Use this command with Cisco IOS Telephony Services V2.1, Cisco CME 3.0, or a later version.
Examples
The following example specifies that the directory service should not be available on the IP phones served by this ITS router:
Router(config)# telephony-service
Router(config-telephony-service)# no service local-directory
Related Commands
service phone
To modify the vendorConfig parameters in the configuration file, use the service phone command in telephony-service or ephone-template configuration mode. To disable a setting, use the no form of this command.
service phone parameter-name parameter-value
no service phone parameter-name parameter-value
Syntax Description
parameter-name
Name of the vendorConfig parameter in the configuration file. For valid parameter names, see Table 17. Parameter names are word and case-sensitive and must be entered exactly as shown.
parameter-value
Value for the vendorConfig parameter. For valid values and defaults, see Table 17.
Command Default
The vendorConfig parameters in phone configuration files are set to default values.
Command Modes
Telephony-service configuration (config-telephony)
Ephone-template configuration (config-ephone-template)Command History
Usage Guidelines
This command in telephony-service configuration mode modifies vendorConfig parameters in configuration file for phones in a Cisco Unified CME system.
The vendorConfig section of a configuration file is read by a phone's firmware when that Cisco Unified IP phone is booted. The number and type of parameters may vary from one firmware version to the next.
If a firmware version does not support a particular parameter, that parameter cannot be implemented. For example, Cisco phone firmware 8.2.1 or a later version is required to support the G.722-64K codec on G.722-capable SCCP phones and Cisco phone firmware 8.3.1 or a later version is required to support the G.722-64K codec on G.722-capable SIP phones. If your phones are loaded with an earlier version of phone firmware, they cannot support the G.722-64K codec regardless of how the g722CodecSupport parameter is configured.
The IP phone that downloads the configuration file will implement only those parameters that it can support and ignore configured parameters that it cannot implement. For example, a Cisco IP phone without a backlit display cannot implement backlight parameters regardless of how they are configured.
In Cisco Unified CME 4.0 and later versions, support for creating configuration files at a phone level was added for SCCP phones. This command in ephone-template configuration mode creates an template of vendorConfig parameters that can be applied to individual SCCP phones in Cisco Unified CME. This command in ephone-template configuration mode does not work for all vendorConfig parameters. See Table 17 for information about individual parameters.
In Cisco Unified CME 4.0 and later versions, if you use an ephone template to apply this command to one or more phones, you must also configure the cnf-file perphone command so that a separate configuration file is created for each phone, by MAC address. To apply this command in telephony-service mode to all phones of a particular type in Cisco Unified CME 4.0 and later versions, you can configure the cnf-file perphonetype command to specify that configuration files are generated by phone type.
To apply this command in telephony-service configuration mode to all phones in your Cisco Unified CME system, ensure that the system is configured for the default single per-system configuration file for all phones.
If you use an ephone template to apply this command to a phone and you also use this command in telephony-service configuration mode for the same phone, the value that you set in ephone-template configuration mode has priority.
After modifying the vendorConfig parameters, you must generate new configuration files.
After generating configuration files, reset or reboot the IP phone to be configured to download the new configuration file.
Use the show telephony-service tftp-binding command to view the SEP*.cnf.xml files that are associated with individual phones. The following example entry from a Sep*.conf.xml file disables the PC port on a phone:
<vendorConfig><pcPort>1</pcPort></vendorConfig>Table 17 lists the basic vendorConfig parameters in alphabetical order.
Note
Examples
The following example shows how to configure multiple service phone parameters. This configuration is applied only in as much as IP phone firmware supports each parameter.
Router(config)# telephony-service
Router(config-telephony)# service phone disableSpeaker true
Router(config-telephony)# service phone disableSpeakerAndHeadset true
Router(config-telephony)# service phone forwardingDelay 1
Router(config-telephony)# service phone garp 1
Router(config-telephony)# service phone pcPort 1
Router(config-telephony)# service phone voiceVlanAccess 0
Router(config-telephony)# service phone settingsAccess 1
Router(config-telephony)# service phone videoCapability 1
Router(config-telephony)# service phone daysDisplayNotActive 1,7
Router(config-telephony)# service phone displayOnTime 07:30
Router(config-telephony)# service phone displayOnDuration 10:00
Router(config-telephony)# service phone displayIdleTimeout 01:00
Router(config-telephony)# service phone daysBacklightNotActive 1,7
Router(config-telephony)# service phone backlightOnTime 07:30
Router(config-telephony)# service phone backlightOnDuration 10:00
Router(config-telephony)# service phone backlightIdleTimeout 01:00
Router(config-telephony)# create cnf-files
Router(config-telephony)# reset all
The following example shows how to set the default values for backlighting the phone display for all Cisco Unified IP phones with backlight capabilities in Cisco Unified CME:Router(config)# telephony-service
Router(config-telephony)# service phone daysBacklightNotActive 1,7
Router(config-telephony)# service phone backlightOnTime 07:30
Router(config-telephony)# service phone backlightOnDuration 10:00
Router(config-telephony)# service phone backlightIdleTimeout 01:00
Router(config-telephony)# create cnf-files
Router(config-telephony)# reset all
The following example shows how to set the backlighting parameters so that there is no backlighting of the phone display for all Cisco Unified IP phones with backlight capabilities until there is user interaction with the phone. The backlightIdleTimeout parameter is configured so that the backlight will switch off again after 60 seconds of inactivity.
Router(config)# telephony-service
Router(config-telephony)# service phone daysBacklightNotActive 1,2,3,4,5,6,7
Router(config-telephony)# service phone backlightOnTime 07:30
Router(config-telephony)# service phone backlightOnDuration 10:00
Router(config-telephony)# service phone backlightIdleTimeout 00.01
Router(config-telephony)# create cnf-files
Router(config-telephony)# reset all
The following example shows how to set the display parameters so that the phone display for all Cisco Unified IP phones with luminous displays are blank on Sunday (1), Monday (2), and Saturday (7):
Router(config)# telephony-service
Router(config-telephony)# service phone daysDisplayNotActive 1,2,7
Router(config-telephony)# create cnf-files
Router(config-telephony)# reset all
The following example shows how to disable the PC port on an individual IP phone (ephone 15) using an ephone template:
Router(config)# ephone-template 8
Router(config-ephone-template)# service phone pcPort 1
Router(config-ephone-template)# exit
Router(config)# ephone 15
Router(config-ephone)# ephone-template 8
Router(config-ephone)# exit
Router(config)# telephony-service
Router(config-telephony)# create cnf-files
Router(config-telephony)# exit
Router(config)# ephone 15
Router(config-ephone)# reset
Related Commands
session-server
To specify a session manager to manage and monitor Register and Subscribe messages during a feature-server session, use the session-server command in voice register dn configuration mode, voice register pool configuration mode, or ephone-dn configuration mode. To return to the default, use the no form of this command.
session-server session-server-tag [, ...session-server-tag]
no session-server session-server-tag
Syntax Description
Command Default
Session manager is not assigned.
Command Modes
Ephone-dn configuration (ephone-dn)
Voice register dn configuration (voice-register-dn)
Voice register pool configuration (voice-register-pool)Command History
Usage Guidelines
Cisco Unified CME 4.2 and later versions provide a general interface for interoperating with external feature servers, such as the Cisco Unified CCX application on Cisco CRS, including call monitoring and device monitoring based on SIP presence and dialog event package. A session manager in Cisco Unified CME can manage and monitor Register and Subscribe messages.
Before configuring this command, a session manager must already configured in Cisco Unified CME by using the voice register session-server command.
Use the session-server command in voice register pool configuration mode to specify that Register and Subscribe messages for an external feature-server route point must contain a Cisco-referenceID field. Registration or subscription will be granted only for the specified route point. The route point for which Register and Subscribe messages are to be managed by this session manager must already be configured as a SIP endpoint in Cisco Unified CME. Typically, the configuration for the route point is provided from the feature server. If the configuration for the route point is deleted or must be modified, it can be reconfigured directly in Cisco Unified CME by using Cisco IOS commands. Each route point can be managed by only one session manager. Each session manager can manage multiple route points.
Use the session-server command in ephone-dn configuration mode or in voice register dn configuration mode to specify that Subscribe messages for a directory number must contain a Cisco-referenceID field. Registration or subscription will be granted only for the specified directory number. The directory number for which Subscribe messages are to be monitored by this session manager must already be configured in Cisco Unified CME. Each directory number can be monitored by up to eight session managers. Each session manager can subscribe for multiple directory numbers.
Examples
The following example shows the configuration for specifying that session manager 1 can control a route point (voice register pool) for an external feature server:
voice register pool 1
session-server 1
The following example shows the configuration specifying which session managers can monitor Register and Subscribe messages to directory numbers associated with Cisco Unified CCX agent phones. Notice that several session managers (1, 3, 5, and 7) can subscribe for both directory numbers.
ephone-dn 1
session-server 1,2,3,4,5,6,7,8
.
ephone-dn 2
session-server 1,3,5,7
Related Commands
voice register session-server
Enters voice register session configuration mode for the purpose of configuring a session manager.
session-transport
To specify the transport layer protocol that a SIP phone uses to connect to Cisco Unified CME, use the session-transport command in voice register pool or voice register template configuration mode. To reset to the default value, use the no form of this command.
session-transport {tcp | udp}
no session-transport
Syntax Description
tcp
Transmission Control Protocol (TCP) is used.
udp
User Datagram Protocol (UDP) is used. This is the default.
Command Default
UDP is the default protocol.
Command Modes
Voice register pool configuration (config-register-pool)
Voice register template configuration (config-register-temp)Command History
Usage Guidelines
This command sets the transport layer protocol parameter in the phone's configuration file.
If you use a voice register template to apply a to a phone and you also use the same command in voice register pool configuration mode for the same phone, the value that you set in voice register pool configuration mode has priority.
This command is not supported on the Cisco Unified IP Phone 7905, 7912, 7940, or 7960.
Note
Examples
The following example sets the transport layer protocol to TCP for SIP phone 10:
Router(config)# voice register pool 10
Router(config-register-pool)# session-transport tcp
Related Commands
shared-line
To create a directory number to be shared by multiple SIP phones, use the shared-line command in voice register dn configuration mode. To return to the default, use the no form of this command.
shared-line [max-calls number-of-calls]
no shared-line
Syntax Description
max-calls number-of-calls
(Optional) Maximum number of active calls allowed on the shared line. Range: 2 to 16. Default: 2.
Command Default
Directory number is not a shared line.
Maximum number of calls on a shared line is 2.Command Modes
Voice register dn configuration
Command History
Usage Guidelines
This command enables a shared line on an individual SIP phone directory number.
This command is supported only on the Cisco Unified IP Phone 7911G, 7941G, 7941GE, 7961G, 7961GE, 7970G, and 7971GE.
Examples
The following example shows that extension 5001 associated with directory number 2 is defined as a shared line and can support up to four calls:
Router(config)# voice register dn 2
Router(config-register-dn)# number 5001
Router(config-register-dn)# shared-line max-calls 4
Related Commands
show capf-server
To display CAPF server configuration and session information, use the show capf-server command in privileged EXEC configuration mode.
show capf-server {auth-string | sessions | summary}
Syntax Description
auth-string
Display authentication strings for ephones.
sessions
Display information about active CAPF sessions.
summary
Display CAPF server configuration details.
Command Modes
Privileged EXEC
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 output displays CAPF server parameters:
Router# show capf-server summaryCAPF Server Configuration DetailsTrustpoint for TLS With Phone: cmeserverTrustpoint for CA operation: iosraSource Address: 10.1.1.1Listening Port: 3804Phone Key Size: 1024Phone KeyGen Retries: 100Phone KeyGen Timeout: 120 minutesDevice Authentication Mode: Auth-StringThe following example output displays the authentication strings that have been defined for the phones with the listed MAC addresses:
Router# show capf-server auth-stringAuthentication Strings for configured EphonesMac-Addr Auth-String-------- -----------000CCE3A817C 7012001121116BDD 922000D299D50DF 9182000ED7B10DAC 3114000F90485077 33280013C352E7F1 0678The following example output displays active sessions between phones (identified by their MAC addresses) and the CAPF server. The phone ID field lists standard phone identifications, which include the letters "SEP" plus the MAC addresses of the phones. Table 18 defines the session states that can appear in the output.
Router# show capf-server sessionsActive CAPF SessionsPhone ID StateSEP000CCE3A817C AWAIT-KEYGEN-RES
show credentials
To display the credentials settings that have been configured for use during Cisco Unified CME phone authentication communications or secure Cisco Unified SRST fallback, use the show credentials command in privileged EXEC mode.
show credentials
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Cisco Unified CME
This command displays the credentials settings on a Cisco Unified CME router that has been configured with a CTL provider to be used with Cisco Unified CME phone authentication.
Cisco Unified SRST
This command displays the credentials settings on the Cisco Unified SRST router that are supplied to Cisco Unified CallManager for use during secure SRST fallback.
Examples
The following is sample output from the show credentials:
Router# show credentialsCredentials IP: 10.1.1.22Credentials PORT: 2445Trustpoint: srstcaTable 19 describes the fields in the sample output.
Related Commands
show cti
To display the status of the CTI subsystem, use the show cti command in privileged EXEC mode.
show cti {call | gcid | line node | session}
Syntax Description
call
Details for active (ACT) calls only.
gcid
List of Global Call IDs for active calls only.
line node
List of line nodes.
session
Details for active CTI sessions.
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
This commands displays status information for the CTI subsystem in Cisco Unified CME.
Examples
The following sample output is for each command when there are no active calls.
Router#show cti gcidGCID callIDs=================================== =================no active GCIDRouter#show cti callDN CallID GCID Calling Called State========= ====== =================================== ========== ========== =====201204A line-node is the internal data structure of a directory number. Once a line-node is created, the structure remains until the CTI interface is shut down.Router#show cti line-nodeline dn number of call instance================ =======================1001 0201 0202 0203 0204 0233 06789 0A0001 0Router#The following is sample output from the show cti gcid command for one call. This sample contains a single Gcid with two callIDs, one for each call leg.
Router#show cti gcidGCID callIDs=================================== =================1E2E3483-5ACB11DE-BA9EF925-DF2AFB55 59291, 59292,The following is sample output from the show cti call command. This samples shows that a call was placed from (DN) 201 to (DN) 204 and both directory numbers are now Active (ACT). Note that the Gcid and callIDs in this sample correspond to those in the output from the show cti gcid command.
Router#show cti callDN CallID GCID Calling Called State========= ====== =================================== ========== ========== ======20159291 1E2E3483-5ACB11DE-BA9EF925-DF2AFB55 201 204 ACT20459292 1E2E3483-5ACB11DE-BA9EF925-DF2AFB55 201 204 ACTThe following is sample output from the show cti line-node command. In the following sample, there are eight line-nodes and two (201 and 204) are in use.
Router#show cti line-nodeline dn number of call instance================ =======================01001 0201 1callID 59291(C7C ), *cg = 201, cd = 204202 0203 0204 1callID 59292(C7C ), cg = 201, *cd = 204233 06789 0A0001 0<<Table number>> describes the significant fields shown in the display.
Related Commands
clear cti session
Clears the session between a CSTA client application and Cisco Unified CME.
show ctl-client
To display information about the certificate trust list (CTL) client, use the show ctl-client command in privileged EXEC configuration mode.
show ctl-client
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
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 displays trustpoints and IP addresses known to the CTL client.
Router# show ctl-clientCTL Client Information-----------------------------SAST 1 Certificate Trustpoint: cmeserverSAST 1 Certificate Trustpoint: sast2List of Trusted Servers in the CTLCME 10.1.1.1 cmeserverTFTP 10.1.1.1 cmeserverCAPF 10.1.1.1 cmeservershow ephone
To display information about registered Cisco Unified IP phones, use the show ephone command in user EXEC or privileged EXEC mode.
show ephone [mac-address | phone-type]
Syntax Description
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Examples
Significant fields in the output from this command are described in Table 18.
The following sample output shows general information for registered phones:
Router# show ephone
ephone-8[7] Mac:000A.B7B1.444A TCP socket:[5] activeLine:0 whisperLine:0 REGISTERED in SCCP ver 11/9 max_streams=1
mediaActive:0 whisper_mediaActive:0 startMedia:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0 caps:8 privacy:0
IP:10.4.188.99 * 50007 Telecaster 7940 keepalive 8424 max_line 2 available_line 2
button 1: cw:1 ccw:(0 0)
dn 6 number 6006 CH1 IDLE CH2 IDLE overlay shared
button 2: cw:1 ccw:(0 0 0 0 0 0 0 0)
dn 42 number 6042 CH1 IDLE CH2 IDLE CH3 IDLE CH4 IDLE CH5 IDLE CH6 IDLE CH7 IDLE CH8 IDLE shared
overlay 1: 6(6006) 7(6007) 8(6008)
Preferred Codec: g711ulaw
Lpcor Type: local Incoming: ephone_group1 Outgoing: ephone_group1
Table 18 describes significant fields in the output.
Related Commands
show ephone attempted-registrations
To display the log of ephones that unsuccessfully attempt to register with Cisco Unified CME, use the show ephone attempted-registrations command in privileged EXEC mode.
show ephone attempted-registrations
Syntax Description
This command has no keywords or arguments.
Command Modes
Privileged EXEC (#)
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
The no auto-reg-ephone 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 to view the list of phones that have attempted to register but have been blocked. The clear telephony-service ephone-attempted-registrations clears the list.
Examples
The following example displays ephones that unsuccessfully attempted to register with Cisco Unified CME:
Router# show ephone attempted-registrationsAttempting Mac address:Num Mac Address DateTime DeviceType-----------------------------------------------------------------------------1 C863.8475.5417 22:52:05 UTC Thu Apr 28 2005 SCCP Gateway (AN)2 C863.8475.5408 22:52:05 UTC Thu Apr 28 2005 SCCP Gateway (AN).....25 000D.28D7.7222 22:26:32 UTC Thu Apr 28 2005 Telecaster 796026 000D.BDB7.A9EA 22:25:59 UTC Thu Apr 28 2005 Telecaster 7960...47 C863.94A8.D40F 22:52:17 UTC Thu Apr 28 2005 SCCP Gateway (AN)48 C863.94A8.D411 22:52:18 UTC Thu Apr 28 2005 SCCP Gateway (AN)49 C863.94A8.D400 22:52:15 UTC Thu Apr 28 2005 SCCP Gateway (AN)Table 22 describes the significant fields shown in the display.
Related Commands
show ephone cfa
To display status and information on the registered phones that have call-forward-all set on one or more of their extensions (ephone-dns), use the show ephone cfa command in privileged EXEC mode.
show ephone cfa
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Examples
The following is sample output from the show ephone cfa command:
Router# show ephone cfaephone-1 Mac:0007.0EA6.353A TCP socket:[2] activeLine:0 REGISTEREDmediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0IP:1.2.205.205 52491 Telecaster 7960 keepalive 14 max_line 6button 1: dn 11 number 60011 cfa 60022 CH1 IDLEbutton 2: dn 17 number 60017 cfa 60021 CH1 IDLEThe show ephone describes significant fields in this output.
Related Commands
show ephone dn
To display phone information for specified dn-tag or for all dn-tags, use the show ephone dn command in privileged EXEC mode.
show ephone dn [dn-tag]
Syntax Description
dn-tag
(Optional) Unique sequence number that is used during configuration to identify a particular extension (ephone-dn).
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Use this command to identify the phone on which a particular dn-tag has been assigned.
Examples
The following is sample output for the two appearances of DN 5:
Router# show ephone dn 5Tag 5, Normal or Intercom dnephone 1, mac-address 0030.94C3.CAA2, line 2ephone 2, mac-address 0030.94c2.9919, line 3The show ephone describes significant fields in this output.
Related Commands
show ephone dnd
To display information on the registered phones that have "do not disturb" set on one or more of their extensions (ephone-dns), use the show ephone dnd command in privileged EXEC mode.
show ephone dnd
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
This command does not apply to Cisco Unified SRST.
Examples
The following is sample output from the show ephone dnd command:
Router# show ephone dndephone-1 Mac:0007.0EA6.353A TCP socket:[1] activeLine:0 REGISTEREDmediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0IP:1.2.205.205 52486 Telecaster 7960 keepalive 2729 max_line 6 DnDbutton 1: dn 11 number 60011 CH1 IDLEThe show ephone describes significant fields in this output.
Related Commands
show ephone login
To display the login states of all local IP phones, use the show ephone login command in privileged EXEC mode.
show ephone login
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
The show ephone login command displays whether an ephone has a personal identification number (PIN) and whether its owner is logged in.
In Cisco Unified CME 7.1 and earlier versions, FALSE is displayed if there is no PIN configured for the specified ephone. TRUE is displayed if there is a PIN configured for the specified ephone.
In Cisco Unified CME 8.0 and later versions, the show output is modified as follows:
•
•
•
Examples
Cisco Unified CME 8.0 or later versions
The following is sample output from the show ephone login command. It shows that a PIN is defined for ephone 1 and that its owner has not logged in. The other phones do not have PINs associated with them.
Router# show ephone loginephone 1 Pin enabled:LOCAL Logged-in:FALSEephone 2 Pin enabled:FALSEephone 3 Pin enabled:FALSE
The following is sample output from the show ephone login command. It shows that a PIN is defined for ephone 1 and that its owner has not logged in. A global PIN is defined also defined for this system. If the pin command is configured in ephone configuration mode and telephony-service configuration mode, the command in ephone configuration mode takes precedence.
Router# show ephone loginephone 1 Pin enabled:LOCAL Logged-in:FALSEephone 2 Pin enabled:GLOBAL Logged-in:TRUEephone 3 Pin enabled:GLOBAL Logged-in:TRUE
The following is sample output from the show ephone login command. It shows that neither a local nor a global PIN is enabled for ephones 1 to 3.
Router# show ephone loginephone 1 Pin enabled:FALSEephone 2 Pin enabled:FALSEephone 3 Pin enabled:FALSE
Cisco CME 3.0 to Cisco Unified CME 7.1
The following is sample output from the show ephone login command. It shows that a PIN is enabled for ephone 1 and that its owner has not logged in. The other phones do not have PINs associated with them.
Router# show ephone loginephone 1 Pin enabled:TRUE Logged-in:FALSEephone 2 Pin enabled:FALSEephone 3 Pin enabled:FALSEephone 4 Pin enabled:FALSEephone 5 Pin enabled:FALSEephone 6 Pin enabled:FALSEephone 7 Pin enabled:FALSEephone 8 Pin enabled:FALSEephone 9 Pin enabled:FALSETable 23 describes significant fields in this output.
Related Commands
show ephone offhook
To display information and packet counts for the phones that are currently off hook, use the show ephone offhook command in privileged EXEC mode.
show ephone offhook
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following sample output is displayed when no phone is off hook:
Router# show ephone offhookNo ephone in specified type/condition.The following sample output displays information for a phone that is off hook:
Router# show ephone offhookephone-5 Mac:000A.8A2C.8C6E TCP socket:[20] activeLine:1 REGISTEREDmediaActive:0 offhook:1 ringing:0 reset:0 reset_sent:0 paging 0 debug:0IP:10.22.84.71 51228 Telecaster 7960 keepalive 43218 max_line 6button 1:dn 9 number 59943 CH1 SIEZE silent-ringbutton 2:dn 10 number 59943 CH1 IDLEbutton 3:dn 42 number A4400 auto dial A4500 CH1 IDLEbutton 4:dn 96 number 69943 auto dial 95259943 CH1 IDLEbutton 5:dn 75 number 49943 auto dial 49943 CH1 IDLEspeed dial 1:57514 marketingActive Call on DN 9 chan 1 :59943 0.0.0.0 0 to 0.0.0.0 2000 via 172.30.151.1G711Ulaw64k 160 bytes vadTx Pkts 0 bytes 0 Rx Pkts 0 bytes 0 Lost 0Jitter 0 Latency 0 callingDn -1 calledDn -1Username:user1 Password:newuserThe following sample output displays information for a phone that has just completed a call:
Router# show ephone offhookephone-5 Mac:000A.8A2C.8C6E TCP socket:[20] activeLine:1 REGISTEREDmediaActive:1 offhook:1 ringing:0 reset:0 reset_sent:0 paging 0 debug:0IP:10.22.84.71 51228 Telecaster 7960 keepalive 43224 max_line 6button 1:dn 9 number 59943 CH1 CONNECTED silent-ringbutton 2:dn 10 number 59943 CH1 IDLEbutton 3:dn 42 number A4400 auto dial A4500 CH1 IDLEbutton 4:dn 96 number 69943 auto dial 95259943 CH1 IDLEbutton 5:dn 75 number 49943 auto dial 49943 CH1 IDLEspeed dial 1:57514 marketingActive Call on DN 9 chan 1 :59943 10.23.84.71 22926 to 172.30.131.129 2000 via 172.30.151.1G711Ulaw64k 160 bytes no vadTx Pkts 0 bytes 0 Rx Pkts 0 bytes 0 Lost 0Jitter 0 Latency 0 callingDn -1 calledDn -1 (media path callID 19288 srcCallID 19289)Username:user1 Password:newuserThe show ephone describes significant fields in this output.
Related Commands
show ephone overlay
To display information for the registered phones that have overlay ephone-dns associated with them, use the show ephone overlay in privileged EXEC mode.
show ephone overlay
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
This command does not apply to Cisco Unified SRST.
Examples
The following is sample output from the show ephone overlay command:
Router# show ephone overlayephone-1 Mac:0007.0EA6.353A TCP socket:[1] activeLine:0 REGISTEREDmediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0IP:10.2.225.205 52486 Telecaster 7960 keepalive 2771 max_line 6button 1: dn 11 number 60011 CH1 IDLE overlaybutton 2: dn 17 number 60017 CH1 IDLE overlaybutton 3: dn 24 number 60024 CH1 IDLE overlaybutton 4: dn 30 number 60030 CH1 IDLE overlaybutton 5: dn 36 number 60036 CH1 IDLE CH2 IDLE overlaybutton 6: dn 39 number 60039 CH1 IDLE CH2 IDLE overlayoverlay 1: 11(60011) 12(60012) 13(60013) 14(60014) 15(60015) 16(60016)overlay 2: 17(60017) 18(60018) 19(60019) 20(60020) 21(60021) 22(60022)overlay 3: 23(60023) 24(60024) 25(60025) 26(60026) 27(60027) 28(60028)overlay 4: 29(60029) 30(60030) 31(60031) 32(60032) 33(60033) 34(60034)overlay 5: 35(60035) 36(60036) 37(60037)overlay 6: 38(60038) 39(60039) 40(60040)The show ephone command describes significant fields in this output. Table 24 describes a field that is not in that table.
Table 24 show ephone overlay Field Descriptions
overlay number
Displays the contents of an overlay set, including each dn-tag and its associated extension number.
Related Commands
show ephone phone-load
To display information about the phone firmware that is loaded on registered phones, use the show ephone phone-load command in privileged EXEC mode.
show ephone phone-load
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output that displays the phone firmware versions for all phones in the system:
Router# show ephone phone-loadDeviceName CurrentPhoneload PreviousPhoneload LastReset=====================================================================SEP0002B9AFC49F 3.2(2.14) 3.2(2.14) TCP-timeoutSEP003094C2D0B0 3.2(2.14) 3.2(2.14) TCP-timeoutSEP000C30F03707 3.2(2.14) 3.2(2.14) TCP-timeoutSEP003094C2999F 3.2(2.14) 3.2(2.14) TCP-timeoutSEP000A8A2C8C6E 3.2(2.14) 3.2(2.14) InitializedSEP0002B9AFBB4D 3.2(2.14) 3.2(2.14) TCP-timeoutSEP00075078627F 3.2(2.14) 3.2(2.14) TCP-timeoutSEP0002FD659E59 3.2(2.14) 3.2(2.14) TCP-timeoutSEP00024BCCD626 3.2(2.14) CM-closed-TCPSEP0008215F88C1 3.2(2.14) 3.2(2.14) TCP-timeoutSEP000C30F0390C 3.2(2.14) 3.2(2.14) TCP-timeoutSEP003094C30143 3.2(2.14) 3.2(2.14) TCP-timeoutTable 25 describes significant fields in this output.
Related Commands
show ephone registered
To display the status of registered phones, use the show ephone registered command in privileged EXEC mode.
show ephone registered
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show ephone registered command:
Router# show ephone registeredephone-12[11] Mac:001A.A11B.7D6D TCP socket:[5] activeLine:0 whisperLine:0 REGISTERED in SCCP ver 15/12 max_streams=1mediaActive:0 whisper_mediaActive:0 startMedia:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0 caps:7IP:10.10.1.17 * 35177 6941 keepalive 3593 max_line 4 available_line 3button 1: cw:1 dn 11 number 1001 CH1 IDLE CH2 IDLEbutton 2: cw:1 dn 56 number 6971 auto dial 6970 CH1 IDLEbutton 3: cw:1 dn 10 number 1000 CH1 IDLE CH2 IDLE1 feature buttons enabled: dndPreferred Codec: g711ulawLpcor Type: noneTable 26 describes significant fields in this output.
Related Commands
show ephone remote
To display nonlocal phones (phones with no Address Resolution Protocol [ARP] entry), use the show ephone remote command in privileged EXEC mode.
show ephone remote
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Phones without ARP entries are suspected not to be on the LAN. Use the show ephone remote command to identify phones without ARP entries that might have operational issues.
Examples
The following is sample output that identifies ephone 2 as not having an ARP entry:
Router# show ephone remoteephone-2 Mac:0185.047C.993E TCP socket:[4] activeLine:0 REGISTEREDmediaActive:1 offhook:0 ringing:0 reset:0 reset_sent:0 paging 1 debug:0IP:10.50.50.20 49231 Telecaster 7910 keepalive 112 max_line 2 dual-linebutton 1:dn 3 number 95021 CH1 IDLEpaging-dn 25The show ephone describes significant fields in this output.
Related Commands
show ephone ringing
To display information on phones that are ringing, use the show ephone ringing command in privileged EXEC mode.
show ephone ringing
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show ephone ringing command:
Router# show ephone ringingephone-1 Mac:0005.5E37.8090 TCP socket:[1] activeLine:0 REGISTEREDmediaActive:0 offhook:0 ringing:1 reset:0 reset_sent:0 paging 0 debug:0IP:10.50.50.10 49329 Telecaster 7960 keepalive 17602 max_line 6button 1:dn 1 number 95011 CH1 RINGING CH2 IDLEbutton 2:dn 2 number 95012 CH1 IDLEThe show ephone describes significant fields in this output.
Related Commands
show ephone socket
To display IP addresses (IPv4, IPv6, or dual-stack) being used by ephone sockets, use the show ephone socket command in privileged EXEC mode.
show ephone socket
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
12.4(24)YF
Cisco Unified CME 8.0
Cisco Unified SRST 8.0This command was introduced.
Usage Guidelines
Use the show ephone socket command to verify if IPv4 only, IPv6 only, or dual-stack (IPv4/IPv6) is configured on Cisco Unified CME. In the following example, skinny_tcp_listen_socket fd = 0 and skinny_tcp_listen_socket fd = 1 verify that dual-stack configuration. When IPv6 only is configured show ephone socket command displays skinny_tcp_listen_socket fd = -1 and skinny_tcp_listen_socket fd = 0 values. When IPv4 only is configured the show ephone socket command displays skinny_tcp_listen_socket fd = 0 and skinny_tcp_listen_socket (ipv6) fd = -1 values.
Examples
The following is sample output from the show ephone socket command:
Router# show ephone ssocketskinny_tcp_listen_socket fd = 0
skinny_tcp_listen_socket (ipv6) fd = 1
skinny_secure_tcp_listen_socket fd = -1
skinny_secure_tcp_listen_socket (ipv6) fd = -1
skinny_open_sockets = 3:
Phone 3,
skinny_sockets[0] fd = 1
read_buffer 0x480061E8, read_offset 0, read_header N, read_length 0
resend_queue 0x47CE8178, resend_offset 0, resend_flag N, resend_Q_depth 0
Phone 2,
skinny_sockets[1] fd = 2
read_buffer 0x48006A24, read_offset 0, read_header N, read_length 0
resend_queue 0x47CE8104, resend_offset 0, resend_flag N, resend_Q_depth 0
Phone 1,
skinny_sockets[2] fd = 3
read_buffer 0x48007260, read_offset 0, read_header N, read_length 0
resend_queue 0x47CE8090, resend_offset 0, resend_flag N, resend_Q_depth 0
Related Commands
show ephone summary
To display brief information about Cisco IP phones, use the show ephone summary command in privileged EXEC mode.
show ephone summary
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Examples
The following is sample output from the show ephone summary command:
Router# show ephone summaryephone-1 Mac:0030.94C3.37CB TCP socket:[-1] activeLine:0 REGISTEREDmediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 debug:0IP:10.1.1.1 Telecaster 7910 keepalive 45 1:1sp1:5002 sp2:5003ephone-2 Mac:0030.94C3.F96A TCP socket:[-1] activeLine:0 REGISTEREDmediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 debug:0IP:10.1.1.2 Telecaster 7960 keepalive 45 1:2 2:3 3:4sp1:5004 sp2:5001ephone-3 Mac:0030.94C3.F946 TCP socket:[-1] activeLine:0 REGISTEREDmediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 debug:0IP:10.2.1.2 Telecaster 7960 keepalive 59ephone-4 Mac:0030.94C3.F43A TCP socket:[-1] activeLine:0 REGISTEREDmediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 debug:0IP:10.2.1.1 Telecaster 7960 keepalive 59Max 48, Registered 1, Unregistered 0, Deceased 0, Sockets 1Max Conferences 4 with 0 active (4 allowed)Skinny Music On Hold StatusActive MOH clients 0 (max 72), Media Clients 0No MOH file loadedThe show ephone command describes significant fields in this output.
Related Commands
show ephone tapiclients
To display status of ephone Telephony Application Programming Interface (TAPI) clients, use the show ephone tapiclients command in privileged EXEC mode.
show ephone tapiclients
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show ephone tapiclients command:
Router# show ephone tapiclientsephone-4 Mac:0007.0EA6.39F8 TCP socket:[2] activeLine:0 REGISTEREDmediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0IP:192.168.1.18 50291 Telecaster 7960 sub=3 keepalive 728 max_line 20button 1:dn 6 number 1004 CH1 IDLE CH2 IDLEbutton 2:dn 1 number 1000 CH1 IDLE sharedbutton 3:dn 2 number 1000 CH1 IDLE sharedbutton 7:dn 3 number 1001 CH1 IDLE CH2 IDLE monitor-ring sharedbutton 8:dn 4 number 1002 CH1 IDLE CH2 IDLE monitor-ring sharedbutton 9:dn 5 number 1003 CH1 IDLE CH2 IDLE monitor-ringbutton 10:dn 91 number A00 auto dial A01 CH1 IDLEspeed dial 1:2000 PAGE-STAFFspeed dial 2:2001 HUNT-STAFFpaging-dn 90Username:userB Password:ge30qeTapi client informationUsername:userB status:REGISTERED Socket :[5]Tapi Client IP address: 192.168.1.5 Port:2295The show ephone command describes significant fields in this output.
Related Commands
show ephone telephone-number
To display information for the phone associated with a specified number, use the show ephone telephone-number command in privileged EXEC mode.
show ephone telephone-number number
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Use this command to find the phone on which a particular telephone number appears.
Examples
The following is sample output from the show ephone telephone-number:
Router# show ephone telephone-number 91400DP tag: 0, primaryTag 1, Normal or Intercom dnephone 1, mac-address 000A.0E51.19F0, line 1The show ephone command describes significant fields in this output.
Related Commands
show ephone unregistered
To display information about unregistered phones, use the show ephone unregistered command in privileged EXEC mode.
show ephone unregistered
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
There are two ways that an ephone can become unregistered. The first way is when an ephone is listed in the running configuration but no physical device has been registered for that ephone. The second way is when an unknown device was registered at some time after the last router reboot but has since unregistered.
Examples
The following is sample output from the show ephone unregistered:
Router# show ephone unregisteredephone-1 Mac:0007.0E81.10F0 TCP socket:[-1] activeLine:0 UNREGISTEREDmediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0IP:0.0.0.0 0 Unknown 0 keepalive 0 max_line 0The show ephone command describes significant fields in this output.
Related Commands
show ephone-dn
To display status and information for a Cisco IP phone destination number or for extensions (ephone-dns) in a Cisco Unified CallManager Express (Cisco Unified CME) or Cisco Unified Survivable Remote Site Telephony (SRST) environment, use the show ephone-dn command in privileged EXEC mode.
show ephone-dn [dn-tag]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
Examples
Cisco Unified CME
The following Cisco Unified CME sample output displays status and information for all ephone-dns:
Router# show ephone-dn50/0/1 CH1 DOWNEFXS 50/0/1 Slot is 50, Sub-unit is 0, Port is 1Type of VoicePort is EFXSOperation State is UPAdministrative State is UPNo Interface Down FailureDescription is not setNoise Regeneration is enabledNon Linear Processing is enabledNon Linear Mute is disabledNon Linear Threshold is -21 dBMusic On Hold Threshold is Set to -38 dBmIn Gain is Set to 0 dBOut Attenuation is Set to 0 dBEcho Cancellation is enabledEcho Cancellation NLP mute is disabledEcho Cancellation NLP threshold is -21 dBEcho Cancel Coverage is set to 8 msPlayout-delay Mode is set to adaptivePlayout-delay Nominal is set to 60 msPlayout-delay Maximum is set to 200 msPlayout-delay Minimum mode is set to default, value 40 msPlayout-delay Fax is set to 300 msConnection Mode is normalConnection Number is not setInitial Time Out is set to 10 sInterdigit Time Out is set to 10 sCall Disconnect Time Out is set to 60 sRinging Time Out is set to 180 sWait Release Time Out is set to 30 sCompanding Type is u-lawRegion Tone is set for USStation name None, Station number 91400Caller ID Info Follows:Standard BELLCORETranslation profile (Incoming):Translation profile (Outgoing):Digit Duration Timing is set to 100 ms50/0/2 CH1 IDLE CH2 IDLEEFXS 50/0/2 Slot is 50, Sub-unit is 0, Port is 2Type of VoicePort is EFXSOperation State is DORMANTAdministrative State is UPNo Interface Down FailureDescription is not setNoise Regeneration is enabledNon Linear Processing is enabledNon Linear Mute is disabledNon Linear Threshold is -21 dBMusic On Hold Threshold is Set to -38 dBmIn Gain is Set to 0 dBOut Attenuation is Set to 0 dBEcho Cancellation is enabledEcho Cancellation NLP mute is disabledEcho Cancellation NLP threshold is -21 dBEcho Cancel Coverage is set to 8 msPlayout-delay Mode is set to adaptivePlayout-delay Nominal is set to 60 msPlayout-delay Maximum is set to 200 msPlayout-delay Minimum mode is set to default, value 40 msPlayout-delay Fax is set to 300 msConnection Mode is normalConnection Number is not setInitial Time Out is set to 10 sInterdigit Time Out is set to 10 sCall Disconnect Time Out is set to 60 sRinging Time Out is set to 180 sWait Release Time Out is set to 30 sCompanding Type is u-lawRegion Tone is set for USStation name None, Station number 91450Caller ID Info Follows:Standard BELLCORETranslation profile (Incoming):Translation profile (Outgoing):Digit Duration Timing is set to 100 msCisco Unified SRST
The following SRST sample output displays status and information for all ephone-dns:
Router# show ephone-dn 750/0/7 INVALIDEFXS 50/0/7 Slot is 50, Sub-unit is 0, Port is 7Type of VoicePort is EFXSOperation State is UPAdministrative State is UPNo Interface Down FailureDescription is not setNoise Regeneration is enabledNon Linear Processing is enabledNon Linear Mute is disabledNon Linear Threshold is -21 dBMusic On Hold Threshold is Set to -38 dBmIn Gain is Set to 0 dBOut Attenuation is Set to 0 dBEcho Cancellation is enabledEcho Cancellation NLP mute is disabledEcho Cancellation NLP threshold is -21 dBEcho Cancel Coverage is set to 8 msPlayout-delay Mode is set to defaultPlayout-delay Nominal is set to 60 msPlayout-delay Maximum is set to 200 msPlayout-delay Minimum mode is set to default, value 4 msPlayout-delay Fax is set to 300 msConnection Mode is normalConnection Number is not setInitial Time Out is set to 10 sInterdigit Time Out is set to 10 sCall Disconnect Time Out is set to 60 sRinging Time Out is set to 8 sWait Release Time Out is set to 30 sCompanding Type is u-lawRegion Tone is set for USStation name None, Station number NoneCaller ID Info Follows:Standard BELLCOREVoice card specific Info Follows:Digit Duration Timing is set to 100 msTable 27 describes significant fields in the output from this command.
The following table lists the PSTN cause codes that can be sent as an ISDN cause information element (IE) and the corresponding SIP event for each. These are the far-end disconnect cause codes listed in the output for the show ephone-dn statistics command.
Related Commands
show ephone-dn callback
To display information about pending callbacks in a Cisco Unified CallManager Express (Cisco Unified CME) or a Cisco Unified Survivable Remote Site Telephony (Cisco Unified SRST) environment, use the show ephone-dn callback command in privileged EXEC mode.
show ephone-dn callback
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following sample output shows a callback placed by ephone-dn 1 against ephone-dn 3. Ephone-dn 3 has its channel 1 on hold and has just seized dial tone on its channel 2.
Router# show ephone-dn callbackDN 3 (95021) CallBack pending to DN 1 (95021) for ephone-1 age 7 secondsState for DN 3 is CH1 HOLD CH2 SIEZEThe following sample output shows a callback placed by ephone-dn 1 against ephone-dn 3. Ephone-dn 3 has a call in progress on channel 1.
Router# show ephone-dn callbackDN 3 (95021) CallBack pending to DN 1 (95021) for ephone-1 age 8 secondsState for DN 3 is CH1 CONNECTEDSignificant fields in the output from this command are described in Table 29.
Related Commands
show ephone-dn
Displays status and information for a Cisco IP phone destination number or for extensions (ephone-dns) in a Cisco Unified CME or a Cisco Unified SRST environment.
show ephone-dn conference
To display information about ad hoc and meet-me conferences in a Cisco Unified CallManager Express (Cisco Unified CME) environment, use the show ephone-dn conference command in privileged EXEC mode.
show ephone-dn conference [ad-hoc | meetme | number number]
Syntax Description
ad-hoc
(Optional) Ad hoc conferences.
meetme
(Optional) Meet-me conferences.
number number
(Optional) Conference telephone or extension number.
Command Modes
Privileged EXEC
Command History
Examples
The following sample output displays information for the 1234 conference number. There are three directory numbers and six inactive parties.
Router# show ephone-dn conference number 1397type active inactive numbers==================================Meetme 0 6 1397DN tags: 10, 11, 12Unlocked DN tags: 2/3Meetme 0 4 2486DN tags: 13, 14All DN tags unlocked.Meetme 0 4 1111DN tags: 15, 16Ad-hoc 0 4 7777DN tags: 20, 21Table 30 describes the significant fields shown in the display.
Related Commands
show ephone-dn
Displays status and information for a Cisco IP phone destination number or for extensions (ephone-dns) in a Cisco Unified CME or a Cisco Unified SRST environment.
show ephone-dn loopback
To display information about loopback ephone-dns that have been created in a Cisco Unified CallManager Express (Cisco Unified CME) or a Cisco Unified Survivable Remote Site Telephony (Cisco Unified SRST) environment, use the show ephone-dn loopback command in privileged EXEC mode.
show ephone-dn loopback
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following example displays information for a loopback using ephone-dn 21 and ephone-dn 22:
Router# show ephone-dn loopbackLOOPBACK DN status (min 21, max 22):DN 21 51... Loopback to DN 22 CH1 IDLECallingDn -1 CalledDn -1 Called Calling G711Ulaw64kStrip NONE, Forward 2, prefix 10 retry 10 Media 0.0.0.0 0callID 0 srcCallID 0 ssrc 0 vector 0DN 22 11... Loopback to DN 21 CH1 IDLECallingDn -1 CalledDn -1 Called Calling G711Ulaw64kStrip NONE, Forward 2, prefix 50 retry 10 Media 0.0.0.0 0callID 0 srcCallID 0 ssrc 0 vector 0Significant fields in the output from this command are described in Table 31, in alphabetical order.
Related Commands
show ephone-dn park
To display information about call-park slots in the system, use the show ephone-dn park command in privileged EXEC mode.
show ephone-dn park
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following example shows information for a single call-park slot that uses an ephone-dn identifier of 50 and an extension number of 1560.
Router# show ephone-dn parkDN 50 (1560) park-slot state IDLENotify to () timeout 15 limit 20Table 32 describes the significant fields shown in the display.
Related Commands
park-slot
Creates a floating extension (ephone-dn) at which calls can be temporarily held (parked).
show ephone-dn statistics
To display call statistics for a Cisco IP destination or for extensions (ephone-dns) in a Cisco Unified CallManager Express (Cisco Unified CME) or a Cisco Unified Survivable Remote Site Telephony (Cisco Unified SRST) environment, use the show ephone-dn command in privileged EXEC mode.
show ephone-dn [dn-tag] statistics
Syntax Description
Command Modes
Privileged EXEC
Command History
Examples
The following sample output displays statistics for all extensions (ephone-dns) in a Cisco Unified CME system. There are two ephone-dns (DN1 and DN3) in this example.
Router# show ephone-dn statisticsTotal Calls 103Stats may appear to be inconsistent for conference or shared line casesDN 1 chan 1 incoming 36 answered 21 outgoing 60 answered 30 busy 6Far-end disconnect at:connect 29 alert 18 hold 7 ring 15Last 64 far-end disconnect cause codes17 17 17 17 17 17 16 16 16 16 16 16 16 16 16 1616 16 16 16 65 16 65 65 65 65 16 65 65 65 16 1616 16 16 16 16 16 16 16 16 16 16 16 16 65 47 6547 47 16 16 16 16 16 16 16 16 16 16 16 16 16 16local phone on-hookDN 1 chan 1 (95011) voice quality statistics for last callCall Ref 103 called 91500 calling 95011Total Tx Pkts 0 bytes 0 Rx Pkts 0 bytes 0 Lost 0Final Jitter 30 Latency 0 Lost 0Signal Level to phone 0 (-78 dB) peak 0 (-78 dB)Packets counted by router 0DN 1 chan 2 incoming 0 answered 0 outgoing 1 answered 0 busy 0Far-end disconnect at:connect 0 alert 0 hold 0 ring 0Last 64 far-end disconnect cause codes0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0local phone on-hookDN 1 chan 2 (95011) voice quality statistics for last callCall Ref 86 called callingTotal Tx Pkts 0 bytes 0 Rx Pkts 0 bytes 0 Lost 0Final Jitter 0 Latency 0 Lost 0Signal Level to phone 0 (-78 dB) peak 0 (-78 dB)Packets counted by router 0DN 3 chan 1 incoming 0 answered 0 outgoing 1 answered 1 busy 0Far-end disconnect at:connect 0 alert 0 hold 0 ring 0Last 64 far-end disconnect cause codes0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0DN 3 chan 1 (95021) voice quality statistics for current callCall Ref 102 called 94011 calling 95021Current Tx Pkts 241 bytes 3133 Rx Pkts 3304 bytes 515023 Lost 0Jitter 30 Latency 0Worst Jitter 30 Worst Latency 0Signal Level to phone 201 (-39 dB) peak 5628 (-12 dB)Packets counted by router 3305The following sample output displays voice quality statistics for the ephone-dn with dn-tag 2:
Router# show ephone-dn 2 statisticsDN 2 chan 1 incoming 0 answered 0 outgoing 2 answered 0 busy 0Far-end disconnect at: connect 0 alert 0 hold 0 ring 0Last 64 far-end disconnect cause codes28 0 0 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0local phone on-hookDN 2 chan 1 (91450) voice quality statistics for last callCall Ref 2 called callingTotal Tx Pkts 0 bytes 0 Rx Pkts 0 bytes 0 Lost 0Final Jitter 0 Latency 0 Lost 0Signal Level to phone 0 (-78 dB) peak 0 (-78 dB)Packets counted by router 0The show ephone-dn command describes significant fields in the output from this command.
Related Commands
show ephone-dn
Displays status and information for a Cisco IP phone destination number or for extensions (ephone-dns) in a Cisco Unified CME or a Cisco Unified SRST environment.
show ephone-dn summary
To display brief information about Cisco IP phone destination numbers or for extensions (ephone-dns) in a Cisco Unified CallManager Express (Cisco Unified CME) or a Cisco Unified Survivable Remote Site Telephony (Cisco Unified SRST) environment, use the show ephone-dn summary command in privileged EXEC mode.
show ephone-dn summary
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Examples
The following is example output from the show ephone-dn summary:
Router# show ephone-dn summaryPORT DN STATE CODEC VAD VTSP STATE VPM STATE======== ========== ======== === ===================== =========50/0/1 DOWN - - - EFXS_ONHOOK50/0/2 DOWN - - - EFXS_ONHOOK50/0/3 DOWN - - - EFXS_ONHOOK50/0/4 INVALID - - - EFXS_INIT50/0/5 INVALID - - - EFXS_INIT50/0/6 INVALID - - - EFXS_INITTable 33 describes significant fields in the output from this command.
Related Commands
show ephone-dn
Displays status and information for a Cisco IP phone destination number or for extensions (ephone-dns) in a Cisco Unified CME or a Cisco Unified SRST environment.
show ephone-dn whisper
To display information about whisper intercom ephone-dns that have been created in Cisco Unified CME, use the show ephone-dn whisper command in privileged EXEC mode.
show ephone-dn whisper
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Examples
The following is sample output from the show ephone-dn whisper command showing an active whisper intercom call between extension 6001 and 6002:
Router# show ephone-dn whisper
DN DN NUMBER LABEL SPEED DIAL DN STATE PHONE
== ========= ===== ========== ======== =====
101 8881 wi_8881 - IDLE 35 w36
102 8882 - - IDLE 36
103 8883 wi_8883 - IDLE m35 38
104 8884 wi_8884 - IDLE 38
105 8885 wi_8885_sd_8888882 IDLE
106 8886 wi_8886_sd_8888883 IDLE 36
107 8887 - 8888 IDLE 35
108 8888 Mary_sd_Peter 8887 IDLE 36
109 8889 - - IDLE
110 8890 wi_8890 - IDLE
111 4441 4441_wi_sd_4444442 IDLE
112 4442 wi_4442 - IDLE
113 4443 - - IDLE
114 4444 4444_sd-8882 8882 IDLE
141 5551 -
