Table Of Contents
Cisco Unified CME Commands: show presence global through subnet
show presence global
show presence subscription
show sdspfarm
show shared-line
show telephony-service admin
show telephony-service all
show telephony-service bulk-speed-dial
show telephony-service conference hardware
show telephony-service directory-entry
show telephony-service ephone
show telephony-service ephone-dn
show telephony-service ephone-dn-template
show telephony-service ephone-template
show telephony-service fac
show telephony-service security-info
show telephony-service tftp-bindings
show telephony-service voice-port
show voice emergency
show voice emergency addresses
show voice emergency all
show voice emergency callers
show voice emergency zone
show voice fac statistics
show voice hunt-group statistics
show voice lpcor
show voice moh-group
show voice moh-group statistics
show voice register all
show voice register credential
show voice register dial-peers
show voice register dialplan
show voice register dn
show voice register global
show voice register hfs
show voice register pool
show voice register pool after-hour-exempt
show voice register pool attempted-registrations
show voice register pool cfa
show voice register pool connected
show voice register pool ip
show voice register pool mac
show voice register pool on-hold
show voice register pool phone-load
show voice register pool registered
show voice register pool remote
show voice register pool ringing
show voice register pool telephone-number
show voice register pool type
show voice register pool unregistered
show voice register profile
show voice register session-server
show voice register statistics
show voice register template
show voice register tftp-bind
show voice hunt-group
shutdown(telephony-service)
snr
snr answer-too-soon
snr answer-too-soon (voice register dn)
snr calling-number local
snr calling-number local (voice register dn)
snr mode
snr ring-stop
snr ring-stop (voice register dn)
snr (voice register dn)
softkeys alerting
softkeys connected
softkeys connected (voice register template)
softkeys hold
softkeys idle
softkeys idle (voice register template)
softkeys remote-in-use
softkeys remote-in-use (voice register template)
softkeys ringin (voice register template)
softkeys ringing
softkeys seized
softkeys seized (voice register template)
source-addr
source-address (voice register global)
speed-dial
speed-dial (voice logout-profile and voice user-profile)
speed-dial (voice register pool)
srst dn line-mode
srst dn template
srst ephone description
srst ephone template
srst mode auto-provision
standby username password
statistics collect
statistics collect (voice hunt-group)
system message
subnet
Cisco Unified CME Commands: show presence global through subnet
Revised: July 13, 2012
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.
show presence global
To display configuration information about the presence service, use the show presence global command in user EXEC or privileged EXEC mode.
show presence global
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
|
Modification
|
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 displays the configuration settings for presence.
Examples
The following example displays output from the show subscription global:
Router# show subscription global
Presence Global Configuration Information:
=============================================
Presence feature enable : TRUE
Presence allow external watchers : FALSE
Presence max subscription allowed : 100
Presence number of subscriptions : 0
Presence allow external subscribe : FALSE
Presence call list enable : TRUE
Presence server IP address : 0.0.0.0
Presence sccp blfsd retry interval : 60
Presence sccp blfsd retry limit : 10
Presence router mode : CME mode
Table 43 describes the significant fields shown in the display.
Table 42 show subscription global Field Descriptions
Field
|
Description
|
Presence feature enable
|
Indicates whether presence is enabled on the router with the presence command.
|
Presence allow external watchers
|
Indicates whether internal presentities can be watched by external watchers, as set by the watcher all
|
Presence max subscription allowed
|
Maximum number of presence subscriptions allowed by the max-subscription command.
|
Presence number of subscriptions
|
Current number of active presence subscriptions.
|
Presence allow external subscribe
|
Indicates whether internal watchers are allowed to subscribe to status notifications from external presentities, as set by the allow subscribe command.
|
Presence call list enable
|
Indicates whether the Busy Lamp Field (BLF) call-list feature is enabled with the presence call-list command.
|
Presence server IP address
|
Displays the IP address of an external presence server defined with the server command.
|
Presence sccp blfsd retry interval
|
Retry timeout, in seconds, for BLF speed-dial numbers on SCCP phones set by the sccp blf-speed-dial retry interval command.
|
Presence sccp blfsd retry limit
|
Maximum number of retries allowed for BLF speed-dial numbers on SCCP phones set by the sccp blf-speed-dial retry interval command.
|
Presence router mode
|
Indicates whether the configuration mode is set to Cisco Unified CME or Cisco Unified SRST by the mode command.
|
Related Commands
Command
|
Description
|
allow watch
|
Allows a directory number on a phone registered to Cisco Unified CME to be watched in a presence service.
|
allow subscribe
|
Allows internal watchers to monitor external presence entities (directory numbers).
|
debug presence
|
Displays debugging information about the presence service.
|
presence enable
|
Allows the router to accept incoming presence requests.
|
server
|
Specifies the IP address of a presence server for sending presence requests from internal watchers to external presence entities.
|
show presence subscription
|
Displays information about active presence subscriptions.
|
watcher all
|
Allows external watchers to monitor internal presence entities (directory numbers).
|
show presence subscription
To display information about active presence subscriptions, use the show presence subscription command in user EXEC or privileged EXEC mode.
show presence subscription [details | presentity telephone-number | subid subscription-id |
summary]
Syntax Description
details
|
(Optional) Displays detailed information about presentities, watchers, and presence subscriptions.
|
presentity telephone-number
|
(Optional) Displays information on the presentity specified by the destination telephone number.
|
subid subscription-id
|
(Optional) Displays information for the specific subscription ID.
|
summary
|
(Optional) Displays summary information about active subscription requests.
|
Command Default
Information for all active presence subscriptions is displayed.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.4(11)XJ
|
This command was introduced.
|
12.4(15)T
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
12.4(24)T
|
This command was integrated into Cisco IOS Release 12.4(24)T.
|
Usage Guidelines
This command displays details about the currently active presence subscriptions
Examples
The following is sample output from the show presence subscription details command:
Presence Active Subscription Records Details:
=============================================
Watcher : 6002@10.4.171.60
Presentity : 6005@10.4.171.34
Subscription Duration : 1751 seconds
Watcher phone type : SIP Phone
subscription type : Incoming Indication
watcher dial peer tag : 40001
Watcher : 6002@10.4.171.60
Presence Active Subscription Records:
=============================================
Watcher : 4085550103@10.4.171.34
Presentity : 5001@10.4.171.20
Watcher phone type : SCCP [BLF Call List]
subscription type : Outgoing Request
watcher dial peer tag : 0
The following is sample output from the show presence subscription summary command:
Router# show presence subscription summary
Presence Active Subscription Records Summary: 15 subscription
Watcher Presentity SubID Expires SibID Status
======================== ======================== ====== ======= ====== ======
6002@10.4.171.60 6005@10.4.171.34 1 3600 0 idle
6005@10.4.171.81 6002@10.4.171.34 6 3600 0 idle
6005@10.4.171.81 6003@10.4.171.34 8 3600 0 idle
6005@10.4.171.81 6002@10.4.171.34 9 3600 0 idle
6005@10.4.171.81 6003@10.4.171.34 10 3600 0 idle
6005@10.4.171.81 6001@10.4.171.34 12 3600 0 idle
6001@10.4.171.61 6003@10.4.171.34 15 3600 0 idle
6001@10.4.171.61 6002@10.4.171.34 17 3600 0 idle
6003@10.4.171.59 6003@10.4.171.34 19 3600 0 idle
6003@10.4.171.59 6002@10.4.171.34 21 3600 0 idle
6003@10.4.171.59 5001@10.4.171.34 23 3600 24 idle
6002@10.4.171.60 6003@10.4.171.34 121 3600 0 idle
6002@10.4.171.60 5002@10.4.171.34 128 3600 129 idle
6005@10.4.171.81 1001@10.4.171.34 130 3600 131 busy
6005@10.4.171.81 7005@10.4.171.34 132 3600 133 idle
The following is sample output from the show presence subscription summary command showing that device-based BLF monitoring is enabled on two phones.
Watcher Presentity SubID Expires SibID Status
========================== ======================== ====== ======= ====== ======
D 2036@10.6.2.6 2038@10.6.2.254 33 3600 0 idle
2036@10.6.2.6 2038@10.6.2.254 35 3600 0 idle
D 2036@10.6.2.6 8883@10.6.2.254 37 3600 0 unknown
The following is sample output from the show presence subscription subid command:
Router# show presence subscription subid 133
Presence Active Subscription Records:
=============================================
Watcher : 6005@10.4.171.34
Presentity : 7005@10.4.171.20
Watcher phone type : SIP Phone
subscription type : Outgoing Request
watcher dial peer tag : 0
Table 43 describes the significant fields shown in the display.
Table 43 show presence subscription Field Descriptions
Field
|
Description
|
Watcher
|
IP address of the watcher.
|
Presentity
|
IP address of the presentity.
|
Expires
|
Number of seconds until the subscription expires. Default is 3600.
|
line status
|
Status of the line:
• Idle—Line is not being used.
• In-use—User is on the line, whether or not this line can accept a new call.
• Unknown—Phone is unregistered or this line is not allowed to be watched.
|
watcher type
|
Whether the watcher is local or remote.
|
presentity type
|
Whether the presentity is local or remote.
|
Watcher phone type
|
Type of phone, either SCCP or SIP.
|
subscription type
|
The type of presence subscription, either incoming or outgoing.
|
retry limit
|
Maximum number of times the router attempts to subscribe for the line status of an external SCCP phone when either the presentity does not exist or the router receives a terminated NOTIFY from the external presence server. Set with the sccp blf-speed-dial retry-interval command.
|
sibling subID
|
Sibling subscription ID if presentity is remote. If value is 0, presentity is local.
|
sdb
|
Voice port of the presentity.
|
dp
|
Dial peer of the presentity.
|
watcher dial peer tag
|
Dial peer tag of the watcher device.
|
Related Commands
Command
|
Description
|
allow watch
|
Allows a directory number on a phone registered to Cisco Unified CME to be watched in a presence service.
|
blf-speed-dial
|
Enables BLF monitoring for a speed-dial number on a phone registered to Cisco Unified CME.
|
debug ephone blf
|
Displays debugging information for BLF presence features.
|
debug presence
|
Displays debugging information about the presence service.
|
presence
|
Enables presence service and enters presence configuration mode.
|
presence enable
|
Allows the router to accept incoming presence requests.
|
show presence global
|
Displays configuration information about the presence service.
|
show sdspfarm
To display the status of the configured digital signal processor (DSP) farms and transcoding streams, use the show sdspfarm command in privileged EXEC mode.
show sdspfarm {units | sessions {active | callID number | statistics | summary}}
Syntax Description
units
|
Displays the configured and registered DSP farms.
|
sessions
|
Displays the transcoding streams.
|
active
|
Displays all active sessions.
|
callID
|
Displays activities for a specific caller ID.
|
number
|
Displays caller ID number displayed by the show voip rtp connection command.
|
statistics
|
Displays session statistics.
|
summary
|
Displays summary information.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Products
|
Modification
|
12.3(11)T
|
Cisco CME 3.2
|
This command was introduced.
|
Examples
The following is sample output from the show sdspfarm units :
Router# show sdspfarm units
mtp-1 Device:MTP123456782012 TCP socket:[-1] UNREGISTERED
actual_stream:0 max_stream 0 IP:0.0.0.0 0 Unknown 0 keepalive 0
mtp-2 Device:MTP000a8aeaca80 TCP socket:[5] REGISTERED
actual_stream:40 max_stream 40 IP:10.5.49.160 11001 MTP YOKO keepalive 12074
max-mtps:2, max-streams:240, alloc-streams:40, act-streams:0
The following is sample output from the show sdspfarm sessions active :
Router# show sdspfarm sessions active
Stream-ID:3 mtp:2 1.5.49.160 20174 Local:2000 START
usage:MoH (DN=3 , CH=1) FE=TRUE
codec:G729 duration:20 vad:0 peer Stream-ID:4
Stream-ID:4 mtp:2 1.5.49.160 17072 Local:2000 START
usage:MoH (DN=3 , CH=1) FE=FALSE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:3
The following is sample output from the show sdspfarm sessions callID :
Router# show sdspfarm sessions callid 51M
Stream-ID:6, srcCall-ID:51, codec:G729AnnexA , dur:20ms, vad:0, dstCall-ID:52, confID:5,
mtp:2^
Peer Stream-ID:5, srcCall-ID:52, codec:G711Ulaw64k , dur:20ms, vad:0, dstCall-ID:51,
confID:5, mtp:2^
Router-2015# show sdspfarm sessions callid 52
Stream-ID:5, srcCall-ID:52, codec:G711Ulaw64k , dur:20ms, vad:0, dstCall-ID:51, confID:5,
mtp:2
Peer Stream-ID:6, srcCall-ID:51, codec:G729AnnexA , dur:20ms, vad:0, dstCall-ID:52,
confID:5, mtp:2
The following is sample output from the show sdspfarm sessions statistics :
Router# show sdspfarm sessions statistics
Stream-ID:1 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:1014 in-pak:0 discard:0
Stream-ID:2 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:3 mtp:2 10.5.49.160 20174 Local:2000START MoH (DN=3 , CH=1) FE=TRUE
codec:G729 duration:20 vad:0 peer Stream-ID:4
recv-pak:0 xmit-pak:0 out-pak:4780 in-pak:0 discard:0
Stream-ID:4 mtp:2 10.5.49.160 17072 Local:2000START MoH (DN=3 , CH=1) FE=FALSE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:3
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:5 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:6 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:7 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:8 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:9 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:10 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:11 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:12 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:13 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:14 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:15 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:16 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:17 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:18 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:19 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:20 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:21 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:22 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:23 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:24 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:25 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:26 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:27 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:28 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:29 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:30 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:31 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:32 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:33 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:34 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:35 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:36 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:37 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:38 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:39 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:40 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
The following is sample output from the show sdspfarm sessions summary :
Router# show sdspfarm sessions summary
max-mtps:2, max-streams:240, alloc-streams:40, act-streams:2
ID MTP State CallID confID Usage Codec/Duration
==== ===== ====== =========== ====== ============================= ==============
1 2 IDLE -1 0 G711Ulaw64k /20ms
2 2 IDLE -1 0 G711Ulaw64k /20ms
3 2 START -1 3 MoH (DN=3 , CH=1) FE=TRUE G729 /20ms
4 2 START -1 3 MoH (DN=3 , CH=1) FE=FALSE G711Ulaw64k /20ms
5 2 IDLE -1 0 G711Ulaw64k /20ms
6 2 IDLE -1 0 G711Ulaw64k /20ms
7 2 IDLE -1 0 G711Ulaw64k /20ms
8 2 IDLE -1 0 G711Ulaw64k /20ms
9 2 IDLE -1 0 G711Ulaw64k /20ms
10 2 IDLE -1 0 G711Ulaw64k /20ms
11 2 IDLE -1 0 G711Ulaw64k /20ms
12 2 IDLE -1 0 G711Ulaw64k /20ms
13 2 IDLE -1 0 G711Ulaw64k /20ms
14 2 IDLE -1 0 G711Ulaw64k /20ms
15 2 IDLE -1 0 G711Ulaw64k /20ms
16 2 IDLE -1 0 G711Ulaw64k /20ms
17 2 IDLE -1 0 G711Ulaw64k /20ms
18 2 IDLE -1 0 G711Ulaw64k /20ms
19 2 IDLE -1 0 G711Ulaw64k /20ms
20 2 IDLE -1 0 G711Ulaw64k /20ms
21 2 IDLE -1 0 G711Ulaw64k /20ms
22 2 IDLE -1 0 G711Ulaw64k /20ms
23 2 IDLE -1 0 G711Ulaw64k /20ms
24 2 IDLE -1 0 G711Ulaw64k /20ms
25 2 IDLE -1 0 G711Ulaw64k /20ms
26 2 IDLE -1 0 G711Ulaw64k /20ms
27 2 IDLE -1 0 G711Ulaw64k /20ms
28 2 IDLE -1 0 G711Ulaw64k /20ms
29 2 IDLE -1 0 G711Ulaw64k /20ms
30 2 IDLE -1 0 G711Ulaw64k /20ms
31 2 IDLE -1 0 G711Ulaw64k /20ms
32 2 IDLE -1 0 G711Ulaw64k /20ms
33 2 IDLE -1 0 G711Ulaw64k /20ms
34 2 IDLE -1 0 G711Ulaw64k /20ms
35 2 IDLE -1 0 G711Ulaw64k /20ms
36 2 IDLE -1 0 G711Ulaw64k /20ms
37 2 IDLE -1 0 G711Ulaw64k /20ms
38 2 IDLE -1 0 G711Ulaw64k /20ms
39 2 IDLE -1 0 G711Ulaw64k /20ms
40 2 IDLE -1 0 G711Ulaw64k /20ms
Table 44 describes the fields shown in the show sdspfarm display.
Table 44 show sdspfarm Field Descriptions
Field
|
Description
|
act-streams
|
Active streams that are currently involved in calls.
|
alloc-streams
|
Number of transcoding streams that are actually allocated to all DSP farms that are registered to Cisco CME.
|
callID
|
Caller ID that the active stream is in.
|
Codec
|
Codec in use.
|
confID
|
ConfID that is used to communicate with DSP farms.
|
discard
|
Number of packets that are discarded.
|
dstCall-ID
|
Caller ID of the destination IP call leg.
|
Duration or dur
|
Packet rates, in milliseconds.
|
ID
|
Transcoding stream sequence number in Cisco CME.
|
in-pak
|
Number of incoming packets from the source call leg.
|
Local
|
Local port for voice packets.
|
max-mtps
|
Maximum number of Message Transfer Parts (MTPs) that are currently allowed to register in Cisco CME.
|
max-streams
|
Maximum number of transcoding streams that are currently allowed in Cisco CME.
|
mtp or MTP
|
MTP sequence number where the transcoding stream is located.
|
out-pak
|
Number of outgoing packets sending to source call leg.
|
peer Stream-ID
|
Stream sequence number of the other stream paired in the same transcoding session. (Two transcoding streams make up a transcoding session).
|
recv-pak
|
Number of voice packets received from DSP farm.
|
srcCall-ID
|
Source caller ID of the source IP call leg.
|
State
|
Current state of the transcoding stream, could be IDLE, SEIZE, START, STOP, or END.
|
Stream-ID
|
Transcoding stream sequence number in Cisco CME.
|
TCP-socket
|
Socket number for DSP farm (similar to TCP socket for show ephone output).
|
usage
|
Current usage of the stream; for example, Ip-Ip (IP to IP transcoding), MOH (for MOH transcoding) and Conf (conference).
|
vad
|
Voice-activity detection (VAD) flag for the transcoding stream. It should always be 0 (False).
|
xmit-pak
|
Number of packets that are sent to DSP farm.
|
Related Commands
Command
|
Description
|
sdspfarm tag
|
Permits a DSP farm to be to registered to Cisco CME and be associated with an SCCP client interface's MAC address.
|
sdspfarm transcode sessions
|
Specifies the maximum number of transcoding sessions allowed per Cisco CME router.
|
sdspfarm units
|
Specifies the maximum number of DSP farms that are allowed to be registered to Cisco CME.
|
show shared-line
To display information about the Session Initiation Protocol (SIP) shared lines, use the show shared-line command in user EXEC or privileged EXEC mode.
show shared-line {call | details | subscription | summary}
Syntax Description
call
|
Displays information about all active calls on shared lines.
|
details
|
Displays detailed information about each shared line.
|
subscription
|
Displays information for specific subscriptions to shared lines.
|
summary
|
Displays summary information about active subscriptions to shared lines.
|
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.4(24)T
|
This command was introduced.
|
Examples
The following is sample output from the show shared-line call command:
Router# show shared-line call
Shared-Line active call info:
Shared-Line: '20141', active calls: 3
Local User Local Address Remote User Remote Address CallID
========== ===================== =========== ===================== ====
20141 20141@10.6.0.2 20143 20143@10.10.0.1 3168
20141 20141@10.6.0.1 Barge 20143@10.10.0.1 3209
20141 20141@10.6.0.2 20141 20141@10.10.0.1 3210
The following is sample output from the show shared-line details command:
Router# show shared-line details
Shared-Line info details:
Shared-Line: '20141', subscribed users: 2, max calls limit: 10
Index Users sub_id peer_tag Status
===== ===== ====== ======== ======
1 20141@10.6.0.1 5 40001 ACTIVE
2 20141@10.6.0.2 6 40002 ACTIVE
Free call queue size: 7, Active call queue size: 3
Message queue size: 20, Event queue size: 64
The following is sample output from the show shared-line subscription command:
Router# show shared-line subscription
Shared-Line Subscription Info:
Subscriptions to: '20141', total subscriptions: 2
SubID Subscriber Expires Sub-Status
===== ========== ======= ==========
5 20141@10.6.0.1 3600 NOTIFY_ACKED
6 20141@10.6.0.2 3600 NOTIFY_ACKED
The following is sample output from the show shared-line summary command:
Router# show shared-line summary
Shared-Line info summary:
Shared-Line: '20141', subscribed users: 2, max calls limit: 10
Table 45 describes the significant fields shown in the displays.
Table 45 show shared-line Field Descriptions
Field
|
Description
|
Expires
|
Number of seconds until the subscription expires.
|
Local Address
|
IP address of the local phone involved in the shared line call.
|
Local User
|
Extension number of the shared line.
|
Remote Address
|
IP address of the remote phone involved in the shared line call.
|
Remote User
|
Extension of the remote phone involved in the shared line call.
|
SubID
|
Subscription ID.
|
Subscriber
|
Extension number of the shared line and the IP address of the phone subscriber.
|
Sub-Status
|
Status of the subscription.
|
Users
|
IP addresses of the phones using the shared line.
|
Related Commands
Command
|
Description
|
debug shared-line
|
Displays debugging information about SIP shared lines.
|
show telephony-service admin
To display information about the Cisco CallManager Express (Cisco CME) system administrator, use the show telephony-service admin command in user EXEC or privileged EXEC mode.
show telephony-service admin
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco CME Version
|
Modification
|
12.2(2)XT
|
2.0
|
This command was introduced.
|
12.2(8)T
|
2.0
|
This command was integrated into Cisco IOS Release 12.2(8)T.
|
Examples
The following is sample output from this command:
Router# show telephony-service admin
edit DN through Web: enabled.
edit TIME through Web: enabled.
Table 46 describes the significant fields in this output.
Table 46 show telephony-service admin Field Descriptions
Field
|
Description
|
admin_username
|
Username of system administrator.
|
admin_password
|
Password of system administrator.
|
edit DN through Web
|
Whether editing of extensions through the GUI has been enabled using the dn-webedit command.
|
edit TIME through Web
|
Whether changing the router time through the GUI has been enabled using the time-webedit command.
|
Related Commands
Command
|
Description
|
dn-webedit
|
Enables adding of extensions (ephone-dns) through the web interface.
|
time-webedit
|
Enables setting of time through the web interface.
|
show telephony-service all
To display detailed configuration for phones, voice ports, and dial peers in a Cisco Unified Communications Manager Express (Cisco Unified CME) system, use the show telephony-service all command in user EXEC or privileged EXEC mode.
show telephony-service all
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco CME Version
|
Modification
|
12.1(5)YD
|
Cisco Unified CME 1.0
|
This command was introduced.
|
12.2(8)T
|
Cisco Unified CME 2.0
|
This command was integrated int Cisco IOS Release 12.2(8)T.
|
15.2(2)T
|
Cisco Unified CME 9.0
|
This command was modified to display the total number of data collected from both ephone and voice hunt groups.
|
Usage Guidelines
Use the show telephony-service all command to display the total number of ephone and voice hunt groups that have statistics collection turned on.
Examples
The following is a sample output from the show telephony-service all command:
Router# show telephony-service all
ip source-address 10.0.0.1 port 2000
dialplan-pattern 1 408734....
transfer-pattern 510734....
call-forward noan 5001 timeout 8
mac-address 0030.94C3.37CB
mac-address 0030.94C3.F96A
dial-peer voice 20025 pots
dial-peer voice 20026 pots
dial-peer voice 20027 pots
The following is a sample output from the show telephony-service all command. The output shows that call statistics are collected for 14 hunt groups, including 6 ephone and 8 voice hunt groups.
Router# show telephony-service all
Max phoneload sccp version 17
Max dspfarm sccp version 18
Cisco Unified Communications Manager Express
For on-line documentation please see:
http://www.cisco.com/en/US/products/sw/voicesw/ps4625/tsd_products_support_series_home.htm
l
ip source-address 1.4.190.80 port 2000
ef (the MS 6 bits, 46, in ToS, 0xB8) for media
cs3 (the MS 6 bits, 24, in ToS, 0x60) for signal
af41 (the MS 6 bits, 34, in ToS, 0x88) for video
default (the MS 6 bits, 0, in ToS, 0x0) for serviceservice directed-pickup
load 6921 SCCP69xx.9-0-3-0
load 6961 SCCP69xx.8-5-3-0
max-conferences 4 gain -6
dspfarm transcode sessions 0
hunt-group report url prefix tftp://223.255.254.254/ngm/huntgp/uc500/test
hunt-group report url suffix 0 to 20
hunt-group report every 1 hours
# of hunt-group collect data: 14
hunt-group report delay 0 hours
Number of ephone hunt-group configured: 6
cnf-file location: system:
cnf-file option: PER-PHONE-TYPE
The following is another sample output from the show telephony-service all command. The output shows that call statistics are collected for seven hunt groups, including three ephone and four voice hunt groups.
Router# show telephony-service all
hunt-group report url prefix tftp://223.255.254.254/ngm/huntgp/uc500/test
hunt-group report url suffix 0 to 20
hunt-group report every 1 hours
# of hunt-group collect data: 7
hunt-group report delay 0 hours
Number of ephone hunt-group configured: 3
Table 47 describes significant fields in this output, in alphabetical order.
Table 47 show telephony-service all Field Descriptions
Field
|
Description
|
button
|
Button on the Cisco IP phone.
|
call-forward noan
|
Call forward no answer is set.
|
cnf-file location
|
Storage location for phone configuration files. System (default), flash or slot 0 memory, and external TFTP server.
|
cnf-file option
|
Specifies the use of different phone configuration files by type of phone or by individual phone.
|
cos
|
Not applicable; unused.
|
destination-pattern
|
Destination pattern (telephone number) configured for this dial peer.
|
dial-peer voice
|
Voice dial peer.
|
dialplan-pattern
|
Dial-plan pattern is set to expand the abbreviated extension numbers to fully qualified E.164 numbers.
|
ephone
|
Cisco IP phone.
|
ephone-dn
|
Cisco IP phone directory number.
|
huntstop
|
Huntstop is set.
|
ip source-address
|
IP address used by Cisco IP phones to register with the router for service.
|
keepalive
|
IP phone keepalive period, in seconds.
|
mac-address
|
MAC address.
|
max-dn
|
Maximum directory numbers.
|
max-ephones
|
Maximum numbers of Cisco IP phones.
|
number
|
Cisco IP phone number.
|
port
|
TCP port number used by Cisco IP phones to communicate with the router.
|
pots
|
POTS dial peer set.
|
speed-dial
|
Speed-dial is set.
|
station-id number
|
Number used for caller ID purposes when calls are made using the line.
|
timeout
|
Timeout is set.
|
timeout ringing
|
Maximum amount of time that the phone is allowed to ring before the call is disconnected.
|
transfer-pattern
|
Transfer pattern is set to allow transfer of calls to a specified number.
|
type
|
Not applicable; unused.
|
voicemail
|
A voice-mail (speed-dial) number is set.
|
voice-port
|
(Virtual) voice port designator.
|
# of hunt-group collect data
|
Total number of data collected from both ephone and voice hunt groups.
|
Related Commands
Command
|
Description
|
show telephony dial-peer
|
Displays dial peers for extensions in a Cisco Unified CME system.
|
show telephony voice-port
|
Displays virtual voice-port configuration for extensions in a Cisco Unified CME system.
|
show telephony-service bulk-speed-dial
To display information about bulk speed-dial lists, use the show telephony-service bulk-speed-dial command in privileged EXEC mode.
show telephony-service bulk-speed-dial {global list-id index-id [all] | local phone-tag list-id
index-id [all] | summary}
Syntax Description
global
|
Global lists that can be accessed by all users.
|
local
|
Personal lists that can be accessed by users configured to use the lists.
|
list-id
|
Digit that identifies the list. Range is from 0 to 9.
|
index-id
|
Identification number for an entry.
|
phone-tag
|
Ephone identifier (phone-tag).
|
summary
|
List of registered bulk speed-dial text files.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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.
|
Examples
The following example displays the list of bulk speed-dial text files that have been configured in the system:
Router# show telephony-service bulk-speed-dial summary
List-id Entries Size Reference url
0 40 3840 Global tftp://192.168.254.254/phonedirs/uut.csv
1 20 1920 Global phoneBook.csv
8 15 1440 Global tftp://192.168.254.254/phonedirs/big.txt
9 20 1920 Global tftp://192.168.254.254/phonedirs/phoneBook.csv
6 24879 2388384 ephone-2 tftp://192.168.254.254/phonedirs/big.txt1
7 20 1920 ephone-2 phoneBook.csv
6 24879 2388384 ephone-3 big.txt1
7 20 1920 ephone-3 phoneBook.csv
4 Global List(s) 4 Local List(s)
The following example displays the single entry 1234 from list 9:
Router# show telephony-service bulk-speed-dial global 9 1234
Number: 1800 200 1345 name: Jay Smith Private: yes Extension: No
The following example displays all index entries starting with 1 for personal list number 7 for ephone 2:
Router# show telephony-service bulk-speed-dial local 2 7 1 all
Index Number Name Hide Append
1000 918005550164 ABC Co Front Desk no no
1003 919005550167 ABC Co File room no no
1200 918005550184 ABC Co President no no
1342 91800,5550185 ABC Co Sales no no
1682 91800555,,0115 ABC Co Service no no
Table 48 describes the significant fields shown in the display.
Table 48 show telephony-service bulk-speed-dial Field Descriptions
Field
|
Description
|
List-id
|
Digit that identifies the list. Range is from 0 to 9.
|
Entries
|
Number of entries in the speed-dial file.
|
Size
|
Size of the file, in KB.
|
Reference
|
Assignment of the list: global if assigned to all ephones, or a specific ephone number.
|
url
|
Location of the text file, in URL format.
|
Index
|
Identification number for an entry.
|
Number
|
Number to be dialed and displayed on the phone.
|
Name
|
Name to be displayed on the phone.
|
Hide
|
Yes indicates that this number should not be displayed when it is dialed.
|
Append
|
Yes indicates that additional digits can be dialed by the user after this number has been speed-dialed before the call is completed.
|
Related Commands
Command
|
Description
|
bulk-speed-dial list (ephone)
|
Enables a personal bulk speed-dial list for an ephone.
|
bulk-speed-dial list (telephony-service)
|
Enables a global bulk speed-dial list for all users of a Cisco Unified CME system.
|
bulk-speed-dial prefix
|
Sets the prefix code that phone users dial to access speed-dial numbers from a bulk speed-dial list.
|
show telephony-service conference hardware
To display information about hardware conferences in a Cisco Unified Communications Manager Express (Cisco CME) system, use the show telephony-service conference hardware command in privileged EXEC mode.
show telephony-service conference hardware [ad-hoc [detail | video] | detail [video] | meetme
[detail | video] | number telephone-number]
Syntax Description
ad-hoc
|
(Optional) Ad-hoc hardware conferences.
|
detail
|
(Optional) Detailed information for all conferences.
|
video
|
(Optional) Video conferences.
|
meetme
|
(Optional) Meet-me hardware conferences.
|
number
|
(Optional) Conference number.
|
telephone-number
|
(Optional) Telephone or extension number.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Cisco Product
|
Modification
|
12.4(11)XJ2
|
Cisco Unified CME 4.1
|
This command was introduced.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
15.1(4)M
|
Cisco Unified CME 8.6
|
This command was modified to include the video option.
|
15.2(2)T
|
Cisco Unified CME9.0
|
This command was modified to add hardware conference information on Cisco Unified SIP IP phones to the output display.
|
Usage Guidelines
Use the show telephony-service conference hardware command to display ad-hoc and meet-me hardware conferences information, including which parties are still in the conference.
Examples
The following is a sample output that displays information for a four-party ad-hoc hardware conference. Extension 8044 created the conference by calling extension 8012, then adding extension 8004 to the conference. The conference administrator, extension 8006, called into the conference after it was established.
Router# show telephony-service conference hardware detail
Conference Type Active Max Peak Master MasterPhone Last
cur(initial)
=================================================================================
8893 Ad-hoc 4 8 4 8044 29 ( 29) 8006
Conference parties:
8006 (admin)
8004
8012
The following is a sample output that displays information for a meet-me video conference:
Router# show telephony-service conference hardware detail video
Conference Type Active Max Peak Master MasterPhone Last
================================================================================
9999 Meetme-Video 10 16 10 n/a 0 ( 0) 9012
Conference parties (number:phone)
The following is another sample output from the show telephony-service conference hardware detail command. The output shows an ad-hoc video hardware conference among three participants, two of which are Cisco Unified SIP IP phones.
Router# show telephony-service conference hardware detail
Conference Type Active Max Peak Master MasterPhone Last
========================================================================
B000 Ad-hoc Video 3 4 3 3915 SIP3915 15(15)
5801 RM5801
Conference parties (number:phone)
3916 SIPPHONE3916 :16 :Video
3915 SIPPHONE3915 :15 (admin):Video
The following is a sample output from the show telephony-service conference hardware ad-hoc command:
Router# show telephony-service conference hardware ad-hoc
Conference Type Active Max Peak Master MasterPhone Last
========================================================================
B000 Ad-hoc Video 3 4 3 3915 SIP3915 15(15)
5801 RM5801
The following is a sample output from the show telephony-service conference hardware meetme command:
Router# show telephony-service conference hardware meetme
Conference Type Active Max Peak Master MasterPhone
Last
========================================================================
7788 Meetme Video 4 4 4 3916 SIP3916 16(16)
5802 RM5802
The following is a sample output from the show telephony-service conference hardware number command:
Router# show telephony-service conference hardware number B000
Conference Type Active Max Peak Master MasterPhone
Last
========================================================================
B000 Ad-hoc Video 3 4 3 3915 SIP3915 15(15)
5801 RM5801
The following is another sample output from the show telephony-service conference hardware number command:
Router# show telephony-service conference hardware number 7788
Conference Type Active Max Peak Master MasterPhone
Last
========================================================================
7788 Meetme Video 4 4 4 3917 SIP3917 17(17)
4801 SCCP4801
Table 49 describes the significant fields shown in the display, listed in alphabetical order.
Table 49 show telephony-service conference hardware Field Descriptions
Field
|
Description
|
Active
|
Number of active parties in the conference.
|
admin
|
Ad hoc and meet-me hardware conference administrator. The administrator can:
• Dial in to any conference directly through the conference number.
• Use the ConfList soft key to list conference parties.
• Remove any party from any conference.
|
Conference
|
Conference directory number (DN).
|
Conference parties
|
DNs in the conference.
|
Last
|
Last participant to join the conference.
|
Master
|
Conference creator.
|
MasterPhone cur(initial)
|
cur—Current master phone. The phone that currently hosts the conference creator.
(initial)—Initial master phone. The phone that hosted the conference creator when the conference was created.
Because you can transfer the conference creator, the current master phone may be different from the initial master phone.
|
Max
|
Maximum number of participants allowed in the conference.
|
Peak
|
Maximum number of participants in the conference at any time.
|
Type
|
Type of conference: meet-me or ad hoc.
|
show telephony-service directory-entry
To display the entries made using the directory entry , use the show telephony-service directory-entry command in user EXEC or privileged EXEC mode.
show telephony-service directory-entry
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco CME Version
|
Modification
|
12.2(15)ZJ
|
3.0
|
This command was introduced.
|
12.3(4)T
|
3.0
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
Usage Guidelines
This command lists directory entries that are made using the directory entry but does not list entries that are made using the name and number commands in ephone-dn configuration mode.
Examples
The following is sample output from this command:
Router# show telephony-service directory-entry
directory entry 1 4085550123 name Smith, John
Table 50 describes significant fields in this output, in alphabetical order.
Table 50 show telephony-service directory-entry Field Descriptions
Field
|
Description
|
directory directory-tag (shown as 1 in the example)
|
Sequence number or unique identifier for a directory entry.
|
name (shown as Smith, John)
|
Name that appears in the directory associated with the number.
|
number (shown as 4085550123 in the example)
|
Telephone number or extension for the directory entry.
|
Related Commands
Command
|
Description
|
directory entry
|
Adds an entry to a local phone directory that can be displayed on IP phones.
|
show telephony-service all
|
Displays detailed configuration of a Cisco CME system.
|
show telephony-service ephone-dn
|
Displays information for extensions (ephone-dns) in a Cisco CME system.
|
show telephony-service ephone
To display configuration for the Cisco IP phones, use the show telephony-service ephone command in user EXEC or privileged EXEC mode.
show telephony-service ephone
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.1(5)YD
|
Cisco CME 1.0
|
This command was introduced.
|
12.2(8)T
|
Cisco CME 2.0
|
This command was integrated into Cisco IOS Release 12.2(8)T.
|
12.4(11)XJ2
|
Cisco Unified CME 4.1
|
The conference add-mode, conference drop-mode, and conference admin fields were added.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
15.0(1)XA
|
Cisco Unified CME 8.0
|
This command was modified. The output was enhanced to include the setting of the feature-button command and information about logical partitioning class of restriction (LPCOR).
|
15.1(1)T
|
Cisco Unified CME 8.0
|
This command was integrated into Cisco IOS Release 15.1(1)T.
|
Examples
The following is sample output from this command:
Router# show telephony-service ephone
Number of Configured ephones 2 (Registered 2)
ephone 1
Device Security Mode: Non-Secure
mac-address 1234.4321.7000
type 7960
button 1:1
keepalive 30 auxiliary 30
multicast-moh
max-calls-per-button 8
busy-trigger-per-button 0
Always send media packets to this router: No
Preferred codec: g711ulaw
conference drop-mode never
conference add-mode all
conference admin: No
privacy: Yes
feature-button 1 Dnd
user-locale US
network-locale US
lpcor type: remote
lpcor (incoming): ephone_group2 (outgoing): ephone_group2
!
ephone 2
Device Security Mode: Non-Secure
mac-address 1234.4321.6000
type 7960
button 1:2
keepalive 30 auxiliary 30
multicast-moh
max-calls-per-button 8
busy-trigger-per-button 0
Always send media packets to this router: No
Preferred codec: g711ulaw
conference drop-mode never
conference add-mode all
conference admin: No
privacy: Yes
feature-button 1 Dnd
user-locale US
network-locale US
lpcor type: local
lpcor (incoming): ephone_group1 (outgoing): ephone_group1
!
Table 53 describes significant fields in this output, in alphabetical order.
Table 51 show telephony-service ephone Field Descriptions
Field
|
Description
|
button
|
Button number on IP phone, separator to denote ring characteristics and ephone-dn tag. A colon (:) separator denotes a normal ring.
|
conference add-mode
|
Who can add parties to a conference:
• creator—Only the creator can add parties.
• all—Any party can add other parties if the creator remains in the conference.
|
conference drop-mode
|
When conferences are dropped:
• creator—Conference terminates when the creator hangs up.
• local—Conference terminates when the last local party in the conference hangs up or drops out of the conference.
• never—Conference is not dropped, even if the creator hangs up, as long as three parties remain in the conference.
|
conference admin
|
Ad hoc and meet-me hardware conference administrator. The administrator can:
• Dial in to any conference directly through the conference number
• Use the ConfList soft key to list conference parties
• Remove any party from any conference
|
ephone
|
Cisco IP phone.
|
feature-button
|
Displays the type of feature button on the ephone. Feature type can be configured with privacy or DND.
|
lpcor (incoming)
|
Setting of the lpcor incoming command.
|
lpcor (outgoing)
|
Setting of the lpcor outgoing command.
|
lpcor type
|
Setting of the lpcor type command.
|
mac-address
|
MAC address of the Cisco IP phone.
|
speed-dial
|
Speed-tag (unique identifier) and the number that is programmed for that speed-tag.
|
type
|
Model type of phone.
|
Related Commands
Command
|
Description
|
show telephony-service all
|
Displays detailed configuration for a Cisco Unified CME system.
|
show telephony-service dial-peer
|
Displays dial-peer information for extensions in Cisco Unified CME.
|
show telephony-service ephone-dn
|
Displays information for extensions in Cisco Unified CME.
|
show telephony-service voice-port
|
Displays configurations for virtual voice ports in Cisco Unified CME.
|
show telephony-service ephone-dn
To display information about extensions (ephone-dns) in a Cisco CallManager Express (Cisco CME) system, use the show telephony-service ephone-dn command in user EXEC or privileged EXEC mode.
show telephony-service ephone-dn
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco CME Version
|
Modification
|
12.1(5)YD
|
1.0
|
This command was introduced
|
12.2(8)T
|
2.0
|
This command was integrated into Cisco IOS Release 12.2(8)T.
|
Examples
The following is sample output from this command:
Router# show telephony-service ephone-dn
call-forward noan 5001 timeout 8
Table 52 describes significant fields in this output, in alphabetical order.
Table 52 show telephony-service ephone-dn Field Descriptions
Field
|
Description
|
call-forward noan
|
Call forwarding is set to no answer. Other available options are call-forward busy and call-forward all.
|
ephone-dn
|
Cisco IP phone directory number.
|
huntstop
|
Huntstop is set.
|
number
|
Cisco IP phone number.
|
timeout
|
Timeout setting for call forwarding when an extension does not answer.
|
Related Commands
Command
|
Description
|
show telephony-service all
|
Displays the detailed configuration of all the Cisco IP phones.
|
show telephony-service dial-peer
|
Displays dial peer information for extensions (ephone-dns) in a Cisco CME system.
|
show telephony-service voice-port
|
Displays configurations for virtual voice ports in a Cisco CME system.
|
show telephony-service ephone-dn-template
To display information about ephone-dn-template configurations, use the show telephony-service ephone-dn-template command in user EXEC or privileged EXEC mode.
show telephony-service ephone-dn-template
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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 displays contents of ephone-dn templates. Use the show running-config to display the association of templates to particular ephone-dns.
Examples
The following is sample output from this command:
Router# show telephony-service ephone-dn-template
softkeys idle Newcall Redial Cfwdall Dnd Pickup Gpickup Login
softkeys idle Redial Newcall Dnd Cfwdall Pickup Gpickup Login
Related Commands
Command
|
Description
|
ephone-dn-template
|
Creates an ephone-dn template and enters ephone-dn-template configuration mode.
|
show telephony-service ephone-template
To display the contents of ephone-templates, use the show telephony-service ephone-template command in user EXEC or privileged EXEC mode.
show telephony-service ephone-template
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.3(11)T
|
Cisco CME 3.2
|
This command was introduced.
|
12.4(11)XJ2
|
Cisco Unified CME 4.1
|
The conference add-mode, conference drop-mode, and conference admin fields were added.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
12.4(15)XY
|
Cisco Unified CME 4.2(1)
|
Emergency response location (ERL) information assigned to an ephone displays in the output.
|
12.4(20)T
|
Cisco Unified CME 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
15.0(1)XA
|
Cisco Unified CME 8.0
|
This command was modified. Logical partitioning class of restriction (LPCOR) information was added to the output.
|
15.1(1)T
|
Cisco Unified CME 8.0
|
This command was integrated into Cisco IOS Release 15.1(1)T.
|
Usage Guidelines
Use this command to display the contents of each ephone template that is defined. Use the show running-config command to display the association of templates to specific ephones.
Examples
The following is sample output from this command:
Router# show telephony-service ephone-template
ephone-template 1
softkey idle Cfwdall Dnd Gpickup Join Pickup RmLstC
softkey connected Acct ConfList Confrn Endcall Hold Join Park
conference drop-mode never
conference add-mode all
conference admin: No
max-calls-per-button 8
busy-trigger-per-button 0
privacy default
MLPP max precedence level -1
MLPP indication Enabled
MLPP preemption Enabled
Always send media packets to this router: No
Preferred codec: g711ulaw
keepalive 30 auxiliary 30
User Locale: US
Network Locale: US
Emergency Response Location: 6
lpcor type: remote
lpcor (incoming): local_sccp_phone_1 (outgoing): local_sccp_phone_1
Table 53 describes significant fields in this output.
Table 53 show telephony-service ephone Field Descriptions
Field
|
Description
|
ephone-template
|
Identifier for the ephone template.
|
softkey hold
|
Soft keys displayed during the hold call stage.
|
softkey idle
|
Soft keys displayed during the call-idle call stage.
|
softkey seized
|
Soft keys displayed during the call-seized call stage.
|
softkey alerting
|
Soft keys displayed during the call-alerting call stage.
|
softkey connected
|
Soft keys displayed during the call-connected call stage.
|
conference drop-mode
|
When conferences are dropped:
• creator: Conference terminates when the creator hangs up.
• local: Conference terminates when the last local party in the conference hangs up or drops out of the conference.
• never: Conference is not dropped, even if the creator hangs up, if three parties remain in the conference.
|
conference add-mode
|
Who can add parties to a conference:
• creator: Only the creator can add parties.
• all: Any party can add other parties if the creator remains in the conference.
|
conference admin
|
Ad hoc and meet-me hardware conference administrator. The administrator can:
• Dial in to any conference directly through the conference number.
• Use the ConfList soft key to list conference parties.
• Remove any party from any conference.
|
Always send media packets to this router
|
Always send media packets to this Cisco Unified CME router, which acts as a proxy and forwards the packets to the destination, instead of sending them directly to the destination IP phone.
|
Preferred codec
|
Codec to use when initiating a call.
|
button-layout
|
Type of IP phone and number of fixed line or feature set.
• 1: Button 24=Menu. Button 23=Headset.
• 2: Button 24=Menu. Button 23=Headset. Button 22=Directories. Button 21=Messages.
|
User Locale
|
Locale that is associated with the phone user interface. The user locale identifies a set of detailed information, including language and font, to support users.
|
Network Locale
|
Locale that is associated with the phone. The network locale contains a definition of the tones and cadences that are used by the phones and gateways in the device pool in a specific geographic area.
|
Emergency response location
|
Identification of the ERL defined with the emergency response location command.
|
lpcor (incoming)
|
Setting of the lpcor incoming command.
|
lpcor (outgoing)
|
Setting of the lpcor outgoing command.
|
lpcor type
|
Setting of the lpcor type command.
|
Related Commands
Command
|
Description
|
ephone-template
|
Creates an ephone template.
|
show telephony-service fac
To display current feature access codes (FACs), use the show telephony-service fac command in privileged EXEC mode.
show telephony-service fac
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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
Phone users dial FACs to access phone features. The set of standard FACs must be enabled using the fac standard before phone users can use them. Individual FACs can be changed using the fac custom command.
Examples
The following example displays the set of standard FACs:
Router# show telephony-service fac
telephony-service fac standard
Related Commands
Command
|
Description
|
fac
|
Enables standard FACs or creates a custom FAC.
|
show telephony-service security-info
To display the security-related information that is configured under telephony-service, use the show telephony-service security-info command in privileged EXEC configuration mode.
show telephony-service security-info
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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 security information that was configured under telephony-service.
Router# show telephony-service security-info
Skinny Server Trustpoint for TLS: cisco1
TFTP Credentials Trustpoint: cisco1
Server Security Mode: Secure
Global Device Security Mode: Authenticated
show telephony-service tftp-bindings
To display the current configuration files accessible to IP phones, use the show telephony-service tftp-bindings command in user EXEC or privileged EXEC mode.
show telephony-service tftp-bindings
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco CME Version
|
Modification
|
12.2(11)YT
|
2.1
|
This command was introduced.
|
12.2(15)T
|
2.1
|
This command was integrated into Cisco IOS Release 12.2(15)T.
|
Usage Guidelines
Use this command with Cisco IOS Telephony Services V2.1, Cisco CallManager Express 3.0, or a later version.
This command provides a list of configuration files that are accessible to IP phones using TFTP, including the dictionary, language, and tone configuration files that are associated with the ISO-3166 codes that have been selected using the user-locale and network-locale commands.
Examples
The following is sample output from the show telephony-service tftp-bindings when the ISO-3166 code for Germany has been selected for both language and tones:
Router(config)# show telephony-service tftp-bindings
tftp-server system:/its/SEPDEFAULT.cnf
tftp-server system:/its/SEPDEFAULT.cnf alias SEPDefault.cnf
tftp-server system:/its/XMLDefault.cnf.xml alias XMLDefault.cnf.xml
tftp-server system:/its/ATADefault.cnf.xml
tftp-server system:/its/XMLDefault7960.cnf.xml alias SEP00036B54BB15.cnf.xml
tftp-server system:/its/germany/7960-font.xml alias German_Germany/7960-font.xml
tftp-server system:/its/germany/7960-dictionary.xml alias
German_Germany/7960-dictionary.xml
tftp-server system:/its/germany/7960-kate.xml alias German_Germany/7960-kate.xml
tftp-server system:/its/germany/SCCP-dictionary.xml alias
German_Germany/SCCP-dictionary.xml
tftp-server system:/its/germany/7960-tones.xml alias Germany/7960-tones.xml
Related Commands
Command
|
Description
|
network-locale
|
Sets the definition of the tones and cadences on the Cisco IP Phones 7940 and 7940G and the Cisco IP Phones 7960 and 7960G for a specific geographic area.
|
user-locale
|
Sets language for displays on the Cisco IP Phones 7940 and 7940G and the Cisco IP Phones 7960 and 7960G.
|
show telephony-service voice-port
To display configurations of virtual voice ports in a Cisco CallManager Express (Cisco CME) system, use the show telephony-service voice-port command in user EXEC or privileged EXEC mode.
show telephony-service voice-port
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco CME Version
|
Modification
|
12.1(5)YD
|
1.0
|
This command was introduced.
|
12.2(8)T
|
2.0
|
This command was integrated into Cisco IOS Release 12.2(8)T.
|
Usage Guidelines
This command displays virtual voice-port configurations for a Cisco CME system. Each ephone-dn corresponds to a virtual voice port. For example, the ephone-dn with dn-tag 7 corresponds to virtual voice port 50/0/7. The virtual voice port provides the telephone line associated with the Cisco IP phone extension (ephone-dn).
Examples
The following is sample output from this command:
Router# show telephony-service voice-port
Table 54 describes significant fields in this output, in alphabetical order.
Table 54 show telephony-service voice-port Field Descriptions
Field
|
Description
|
station-id number
|
Phone number used for caller ID purposes for calls made from this voice port.
|
timeout ringing
|
Maximum amount of time that a phone is allowed to ring before the call is disconnected.
|
voice-port
|
Virtual voice port.
|
Related Commands
Command
|
Description
|
show telephony-service all
|
Displays the detailed configuration of all the Cisco IP phones.
|
show telephony-service dial-peer
|
Displays dial-peer information for extensions in a Cisco CME system.
|
show telephony-service ephone-dn
|
Displays information for extensions (ephone-dns) in a Cisco CME system.
|
show voice emergency
To display the IP address, subnet mask, and ELIN for each emergency response location, use the show voice emergency command in user EXEC or privileged EXEC mode.
show voice emergency
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(15)XY
|
Cisco Unified CME 4.2(1) Cisco Unified SRST 4.2(1) Cisco Unified SIP SRST 4.2(1)
|
This command was introduced.
|
12.4(20)T
|
Cisco Unified CME 7.0 Cisco Unified SRST 7.0 Cisco Unified SIP SRST 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
Use this command to display the IP address, subnet mask, and ELIN for each emergency response location.
Examples
The following example shows sample output which includes IP mask and ELIN information for each ERL:
EEMERGENCY RESPONSE LOCATIONS
ERL | ELIN 1 | ELIN2 | SUBNET 1 | SUBNET 2
1 | 6045550101 | | 10.0.0.0 | 255.0.0.0
2 | 6045550102 | 6045550106 | 192.168.0.0 | 255.255.0.0
3 | | 6045550107 | 172.16.0.0 | 255.255.0.0
4 | 6045550103 | | 192.168.0.0 | 255.255.0.0
5 | 6045550105 | | 209.165.200.224 | 255.0.0.0
6 6045550198 | | 6045550109 | 209.165.201.0 | 255.255.255.224
Related Commands
Command
|
Description
|
voice emergency response location
|
Creates a tag for identifying an ERL for E911 services.
|
show voice emergency addresses
To display address information for each emergency response location, use the show emergency addresses command in user EXEC or privileged EXEC mode.
show voice emergency addresses
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(15)XY
|
Cisco Unified CME 4.2(1) Cisco Unified SRST 4.2(1) Cisco Unified SIP SRST 4.2(1)
|
This command was introduced.
|
12.4(20)T
|
Cisco Unified CME 7.0 Cisco Unified SRST 7.0 Cisco Unified SIP SRST 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
This command displays the physical address of each emergency response location.
Examples
The following example shows a sample output which includes physical address information for the ERL:
Router# show voice emergency addresses
3850 Zanker Rd, San Jose,604,5550101
225 W Tasman Dr, San Jose,604,5550102
275 W Tasman Dr, San Jose,604,5550103
518 Bellew Dr,Milpitas,604,5550104
400 Tasman Dr,San Jose,604,5550105
3675 Cisco Way,San Jose,604,5550106
Related Commands
Command
|
Description
|
address
|
Specifies a comma separated text entry (up to 250 characters) of an ERL's civic address.
|
show voice emergency all
|
Displays all emergency response location information.
|
voice emergency response location
|
Creates a tag for identifying an ERL for E911 services.
|
show voice emergency all
To display all emergency response location information, use the show voice emergency all command in user EXEC or privileged EXEC mode.
show voice emergency all
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(15)XY
|
Cisco Unified CME 4.2(1) Cisco Unified SRST 4.2(1) Cisco Unified SIP SRST 4.2(1)
|
This command was introduced.
|
12.4(20)T
|
Cisco Unified CME 7.0 Cisco Unified SRST 7.0 Cisco Unified SIP SRST 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
Use this command to display all information configured for each emergency response location.
Examples
The following example shows a sample output, displaying all ERL-related information for ERL 1 and 3.
VOICE EMERGENCY RESPONSE SETTINGS
Callback Number: 6045550103
Emergency Line ID Number: 6045550155
EMERGENCY RESPONSE LOCATION 1
Address: 3850 Zanker Rd, San Jose,elin.1.3,elin.4.10
IP Address 1: 209.165.200.226 IP mask 1: 255.255.255.254
IP Address 2: 209.165.202.129 IP mask 2: 255.255.0.0
Emergency Line ID 1: 6045550180
Last Caller: 6045550188 [Jan 30 2007 16:05.52 PM]
Next ELIN For Emergency Call: 6045550166
EMERGENCY RESPONSE LOCATION 3
Address: 225 W Tasman Dr, San Jose,elin.1.3,elin.4.10
IP Address 1: 209.165.202.133 IP mask 1: 255.255.0.0
IP Address 2: 209.165.202.130 IP mask 2: 255.0.0.0
Emergency Line ID 2: 6045550150
Next ELIN For Emergency Call: 6045550151
Related Commands
Command
|
Description
|
address
|
Specifies a comma separated text entry (up to 250 characters) of an ERL's civic address.
|
elin
|
Specifies a PSTN number that will replace the caller's extension.
|
name
|
Specifies a string (up to 32-characters) used internally to identify or describe the emergency response location.
|
subnet
|
Defines which IP phones are part of this ERL.
|
voice emergency response location
|
Creates a tag for identifying an ERL for the E911 services.
|
show voice emergency callers
To display a list of 911 calls made over the last three hours, use the show emergency callers command in privileged EXEC mode.
show voice emergency callers
Syntax Description
This command has no arguments or keywords.
Command Default
No list of 911 calls is displayed.
Command Modes
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(15)T
|
Cisco Unified CME 4.1 Cisco Unified SRST 4.1 Cisco Unified SIP SRST 4.1
|
This command was introduced. For Cisco Unified CME, this command is supported in SRST fallback mode only.
|
12.4(15)XY
|
Cisco Unified CME 4.2(1) Cisco Unified SRST 4.2(1) Cisco Unified SIP SRST 4.2(1)
|
This command was added to Cisco Unified CME.
|
12.4(20)T
|
Cisco Unified CME 7.0 Cisco Unified SRST 7.0 Cisco Unified SIP SRST 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
Use this command to display a list of all 911 calls made in the past three hours. The list shows the originating number, the ELIN used, and the time the call was placed.
Examples
The following example shows sample output, which includes the originating number, the ELIN used, and the time the call was placed:
router# show voice emergency callers
EMERGENCY CALLS CALL BACK TABLE
6045550181 | 8155550151 | Oct 12 2006 04:05:21
6045550182 | 8155550152 | Oct 12 2006 04:05:21
Related Commands
Command
|
Description
|
voice emergency response location
|
Creates a tag for identifying an ERL for the enhanced 911 service.
|
show voice emergency zone
To display each emergency response zone's list of locations in priority order, use the show voice emergency zone command in user EXEC or privileged EXEC mode.
show voice emergency zone
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(15)XY
|
Cisco Unified CME 4.2(1) Cisco Unified SRST 4.2(1) Cisco Unified SIP SRST 4.2(1)
|
This command was introduced.
|
12.4(20)T
|
Cisco Unified CME 7.0 Cisco Unified SRST 7.0 Cisco Unified SIP SRST 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
Use this command to display a list of the locations, in priority order, of all configured emergency response zones.
Examples
The following example shows a sample output which displays the ERL locations for emergency response zones 90 and 100.
Related Commands
Command
|
Description
|
location
|
Identifies locations within an emergency response zone.
|
voice emergency response location
|
Creates a tag for identifying an ERL for the enhanced 911 service.
|
voice emergency response zone
|
Creates an emergency response zone within which ERLs can be grouped.
|
show voice fac statistics
To display the FAC failure statistics collected by the system, use the show voice fac statistics command in privileged EXEC mode.
show voice fac statistics
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(3)T
|
Cisco Unified CME 8.5
|
This command was introduced.
|
Usage Guidelines
Use this command to display the forced athentication code (FAC) success or failure statistics collected by the system.
Examples
The following is sample output from this command displaying all statistical information:
Router# show voice fac statistics
Voice FAC statistics for failure calls:
Total basic calls: 5
Total forward calls: 1
Related Commands
Command
|
Description
|
show call active voice
|
Displays call information for voice calls that are in progress.
|
show call history voice
|
Displays the call history table for voice calls.
|
show voice hunt-group statistics
To display call statistics from voice hunt groups, use the show voice hunt-group statistics command in privileged EXEC mode.
show voice hunt-group group-id statistics {last hours hours | start day time [to day time]}
Syntax Description
group-id
|
Identifier for the voice hunt group. Range: 1 to 100.
|
last
|
Displays the latest call statistics for a voice hunt group for a specified number of hours, counting backward from the current hour. Range: 1 to 167.
|
hours hours
|
Number of hours that the call statistics are displayed.
|
start
|
Defines the start of the period for which the call statistics are displayed. Default duration is one hour.
|
day
|
Abbreviated day of the week. The following abbreviations are valid: sun, mon, tue, wed, thu, fri, sat.
|
time
|
Hour of the day. Range: 0 to 23.
|
to
|
(Optional) Defines the time the display of the call statistics ends.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
15.2(2)T
|
This command was introduced.
|
Usage Guidelines
Use the show voice hunt-group statistics command to display the average and longest times for a voice hunt group to answer a call, make a call, or put a call on hold. The command can also display the number of answered and abandoned calls, the number of calls forwarded to or answered by voice mail, and the number of error calls.
The output is dependent on call activity. If there is no activity, no data is displayed.
If your Cisco Unified CME system is configured with the basic automatic call distribution (B-ACD) and auto-attendant service, you can enable the collection of call statistics for every voice hunt group with the voice hunt-group statistics collect command. Additional data is displayed for all agents combined and for individual agents.
Note
On the day that daylight saving time adjusts the time back by one hour at 2 a.m. each year, the original 1 a.m. to 2 a.m. statistics for that day are lost because they are overwritten by the new 1 a.m. to 2 a.m. statistics.
For remote Cisco Unified SCCP IP phones in voice hunt groups, the hold and resume statistics are not updated.
Examples
The following is a sample output from the show voice hunt-group statistics command. The output includes direct calls to a voice hunt group number and calls from queue/B-ACD.
Router# show voice hunt-group 1 statistics last 1 h
Average Time to Answer (secs): 6
Longest Time to Answer (secs): 13
Average Time in Call (secs): 75
Longest Time in Call (secs): 161
Average Time before Abandon (secs): 8
Average Time in Hold (secs): 16
Longest Time in Hold (secs): 21
Average Time in Call (secs): 70
Longest Time in Call (secs): 150
Average Hold Time (secs): 21
Longest Hold Time (secs): 21
Average Time in Call (secs): 55
Longest Time in Call (secs): 78
Average Hold Time (secs): 19
Longest Hold Time (secs): 26
Average Time in Call (secs): 51
Longest Time in Call (secs): 118
Average Hold Time (secs): 11
Longest Hold Time (secs): 11
Average Time in Call (secs): 4
Longest Time in Call (secs): 4
Average Time in Call (secs): 161
Longest Time in Call (secs): 161
Average Time in Call (secs): 658
Longest Time in Call (secs): 658
Queue related statistics:
Total calls presented to the queue: 5
Number of calls in the queue: 0
Average time to handoff (secs): 2
Longest time to handoff (secs): 3
Number of abandoned calls: 0
Average time before abandon (secs): 0
Calls forwarded to voice mail: 0
Calls answered by voice mail: 0
The following is a sample output from the show voice hunt-group statistics command. The output focuses on queue-related statistics.
Queue related statistics:
Total calls presented to the queue: 8
Number of calls in the queue: 1
Average time to handoff (secs): 10
Longest time to handoff (secs): 15
Number of abandoned calls: 4
Average time before abandon (secs): 7
Calls forwarded to voice mail: 0
Calls answered by voice mail: 0
The following is a sample output from the show voice hunt-group statistics command. The output shows that no call statistics were collected from voice hunt group 1 from 2:00 to 4:00 on a Monday.
Router# show voice hunt-group 1 stat start Mon 2 to Mon 4
Table 55 describes the significant fields shown in the display.
Table 55 show voice hunt-group statistics Field Descriptions
Field
|
Description
|
Max agent
|
Maximum number of hunt group agents.
|
Min agent
|
Minimum number of hunt group agents.
|
Average time to answer (secs)
|
Average length of time that all calls to Cisco Unified CME B-ACD waited before being answered.
|
Longest time to answer (secs)
|
Longest length of time before calls to Cisco Unified CME B-ACD were answered.
|
Average time in call (secs)
|
Average length of time that unanswered calls waited before going to an agent.
|
Longest time in call (secs)
|
Longest length of time that all calls to Cisco Unified CME B-ACD that went to an agent waited in a call queue.
|
Average time before abandon (secs)
|
Average length of time that unanswered calls waited before hanging up.
|
Calls on hold
|
Total number of calls that were placed on hold.
|
Average time in hold (secs)
|
Average length of time that calls were kept on hold for all agents.
|
Longest time in hold (secs)
|
Longest length of time that a call spent between being placed on hold and being picked up by agents.
|
Total calls answered
|
Total number of calls to Cisco Unified CME B-ACD that were answered by an agent.
|
Total calls on hold
|
Total number of calls that were placed on hold for this agent.
|
Average hold time (secs)
|
Average length of time that calls waited on hold for this agent.
|
Longest hold time (secs)
|
Longest length of time that a call to this agent was spent between being placed on hold and being picked up.
|
Total calls presented to the queue
|
Total number of calls made to Cisco Unified CME B-ACD.
|
Calls handoff to IOS
|
Total number of calls handed off to IOS.
|
Number of calls in the queue
|
Total number of calls in the queue.
|
Average time to handoff (secs)
|
Average length of time before a call was handed off to IOS
|
Longest time to handoff (secs)
|
Longest length of time before a call was handed off to IOS.
|
Number of abandoned calls
|
Total number of calls to Cisco Unified CME B-ACD that hung up before being answered.
|
Calls forwarded to voice mail
|
Total number of calls to Cisco Unified CME B-ACD that were forwarded to voice mail.
|
Calls answered by voice mail
|
Total number of calls to Cisco Unified CME B-ACD that were answered by voice mail.
|
Number of error calls
|
Total number of error calls.
|
Related Commands
Command
|
Description
|
voice hunt-group statistics collect
|
Enables the collection of call statistics for voice hunt groups.
|
show voice lpcor
To display information about logical partitioning class of restriction (LPCOR) policies and calls, use the show voice lpcor policy command in user EXEC or privileged EXEC mode.
show voice lpcor {ip-phone dn | policy lpcor-group | statistics}
Syntax Description
ip-phone dn
|
Displays the LPCOR policy associated with each directory number.
|
policy lpcor-group
|
Displays the LPCOR policy for the specified resource group.
|
statistics
|
Displays statistics for LPCOR calls that failed.
|
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.0(1)XA
|
Cisco Unified CME 8.0
|
This command was introduced.
|
15.1(1)T
|
Cisco Unified CME 8.0
|
This command was integrated into Cisco IOS Release 15.1(1)T.
|
Usage Guidelines
This command displays information about the LPCOR policies configured on the router. You can display the LPCOR information by directory number, for a specific policy, or the number and type of LPCOR calls that fail.
Examples
The following is sample output from the show voice lpcor ip-phone dn command.
Router# show voice lpcor ip-phone dn
Lpcor Type: local Incoming: local_sccp_phone_11 Outgoing: local_sccp_phone_1
Lpcor Type: local Incoming: local_sccp_phone_12 Outgoing: local_sccp_phone_1
Lpcor Type: local Incoming: local_sccp_phone_13 Outgoing: local_sccp_phone_1
Lpcor Type: local Incoming: local_sccp_phone_14 Outgoing: local_sccp_phone_1
The following is sample output from the show voice lpcor policy command:
Router# show voice lpcor policy voip_siptrunk
voice lpcor policy voip_siptrunk (group 1):
( accept ) voip_siptrunk (group 1)
( reject ) voip_h323trunk (group 2)
( reject ) pstn_trunk (group 3)
( reject ) cue_vmail_local (group 4)
( reject ) cue_vmail_remote (group 5)
( reject ) vmail_unity (group 6)
( accept ) local_sccp (group 7)
( accept ) local_sip (group 8)
( reject ) remote_sccp (group 9)
( reject ) remote_sip (group 10)
( accept ) analog_vg224 (group 11)
( reject ) analog_fxs (group 12)
The following is sample output from the show voice lpcor statistics command:
Router# show voice lpcor statistics
Voice LPCOR statistics for failure calls:
Total basic calls: 5
Total forward calls: 1
Total transfer calls: 2
Total conference calls: 0
Total park retrieval calls: 1
Total pick up calls: 0
Related Commands
Command
|
Description
|
clear voice lpcor statistics
|
Clears all LPCOR statistics.
|
lpcor incoming
|
Associates an incoming call with a LPCOR resource-group policy.
|
lpcor outgoing
|
Associates an outgoing call with a LPCOR resource-group policy.
|
voice lpcor policy
|
Creates a LPCOR policy for a resource group.
|
show voice moh-group
To display information about voice moh-groups, use the show voice moh-group command in in privileged EXEC mode.
show voice moh-group
Syntax Description
This command has no arguments or keywords
Command Modes
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.0(1)XA
|
Cisco Unified CME 8.0 Cisco Unified SRST 8.0
|
This command was introduced.
|
15.1(1)T
|
Cisco Unified CME 8.0 Cisco Unified SRST 8.0
|
This command was integrated into Cisco IOS Release 15.1(1)T.
|
Examples
The following sample output shows general information about voice moh-groups in Cisco Unifiede CME or Cisco Unified SRST.
Router# show voice moh-group
description this moh group is for sales
multicast moh 239.1.1.1 port 16386 route 239.1.1.3 239.1.1.3
extension-range 1000 to 1999
extension-range 2000 to 2999
extension-range 3000 to 3999
extension-range 20000 to 22000
extension-range A1000 to A1999
description (not configured)
multicast moh 239.23.4.10 port 2000
extension-range 7000 to 7999
extension-range 8000 to 8999
description This is for marketing
multicast moh 239.15.10.1 port 3000
extension-range 9000 to 9999
description (not configured)
multicast moh 239.16.12.1 port 4000
extension-range 10000 to 19999
description (not configured)
multicast moh 239.12.1.2 port 5000
extension-range ABCD to DECF
extension-range 0012 to 0024
extension-range 0934 to 0964
=== Total of 5 voice moh-groups ===
e
Examples
Command
|
Description
|
showcall-manager-fallback all
|
Displays the detailed configuration of all Cisco IP phones, directory numbers, voice ports, and dial peers in your network during Cisco Unified Communications Manager fallback.
|
show ephone summary
|
Displays the information about the MOH files in use
|
show voice moh-group statistics
|
Displays the MOH subsystem statistics information
|
show voice moh-group statistics
To display the MOH subsystem statistics information, use the show voice moh-group command in privileged EXEC mode.
show voice moh-group statistics
Syntax Description
This command has no arguments or keywords
Command Modes
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.0(1)XA
|
Cisco Unified CME 8.0 Cisco Unified SRST 8.0
|
This command was introduced.
|
15.1(1)T
|
Cisco Unified CME 8.0 Cisco Unified SRST 8.0
|
This command was integrated into Cisco IOS Release 15.1(1)T.
|
Examples
In the following example, the MOH Group Streaming Interval Timing Statistics shows the media packet counts during streaming intervals.
Each packet counter is of 32 bit size and holds a count limit of 4294967296 intervals. This means that with 20 milliseconds packet interval (for G.711), the counters restart from 0 any time after 2.72 years (2 years 8 months). You must use the e clear voice moh-group statistics once in every two years to reset the packet counters.
MOH Group Packet Transmission Timing Statistics shows the maximum and minimum amount of time (in microseconds) taken by the MOH groups to send out media packets.
The MOH Group Loopback Interval Timing Statistics is available when loopback interface is configured as part of the multicast MOH routes in Cisco Unified SRST . These counts are loopback packet counts within certain streaming timing intervals.
router# show voice moh-group statistics
MOH Group Streaming Interval Timing Statistics:
Grp# ~19 msec 20~39 40~59 60~99 100~199 200+ msec
==== ========== ========== ========== ========== ========== ==========
0: 25835 17559966 45148 0 0 1
1: 19766 17572103 39079 0 0 1
2: 32374 17546886 51687 0 0 1
3: 27976 17555681 47289 0 0 1
4: 34346 17542940 53659 0 0 1
5: 14971 17581689 34284 0 0 1
MOH Group Packet Transmission Timing Statistics:
==== ========== ==========
MOH Group Loopback Interval Timing Statistics:
loopback event array: svc_index=1542, free_index=1549, max_q_depth=31
Grp# ~19 msec 20~39 40~59 60~99 100~199 200+ msec
==== ========== ========== ========== ========== ========== ==========
0: 8918821 8721527 10023 0 1 1
1: 9007373 8635813 7184 0 1 1
2: 8864760 8772851 12758 0 1 1
3: 8924447 8715457 10464 0 1 1
4: 8858393 8778957 13017 0 1 1
5: 9005511 8639936 4919 0 1 1
Statistics collect time: 4 days 2 hours 5 minutes 39 seconds.
Related Commands
Command
|
Description
|
show ephone-dn
|
Displays MOH group information for a phone directory number.
|
show ephone summary
|
Displays the information about the MOH files in use
|
show voice moh-group
|
Displays the MOH groups configured
|
show voice register all
To display all Cisco Unified Session Initiation Protocol (SIP) Survivable Remote Site Telephony (SRST) or Cisco Unified Communications Manager Express (Cisco Unified CME) configurations and register information, use the show voice register all command in privileged EXEC mode.
show voice register all
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.2(15)ZJ
|
Cisco SIP SRST 3.0
|
This command was introduced.
|
12.3(4)T
|
Cisco SIP SRST 3.0
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
12.4(4)T
|
Cisco CME 3.4 Cisco SIP SRST 3.4
|
This command was added to Cisco CME.
|
15.0(1)XA
|
Cisco SIP SRST 8.0
|
This command was modified to display the signaling transport protocol.
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SIP SRST 8.1
|
The output display of this command was modified.
|
15.2(4)M
|
Cisco Unified CME 9.1
|
This command was modified to include Key Expansion Module (KEM) data in the output display.
|
Usage Guidelines
KEM data are displayed for Cisco Unified CME only. Cisco Unified SRST is unable to gather all the configuration details about KEMs from Cisco Unified CM.
Examples
Cisco Unified SIP SRST
The following is a sample output of the show voice register all command:
Router# show voice register all
Outbound-proxy is enabled and will use global configured value
Security Policy: DEVICE-DEFAULT
network-locale[0] US (This is the default network locale for this box)
user-locale[0] US (This is the default user locale for this box)
user-locale[4] US Active registrations : 0
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Pool 1 has this DN configured for line 1
Pool 2 has this DN configured for line 1
Pool 3 has this DN configured for line 1, 2
Pool 1 has this DN configured for line 4
Pool 1 has this DN configured for line 3
Mac address is 001B.535C.D410
Proxy Ip address is 0.0.0.0
Reason for unregistered state:
No registration request since last reboot/unregister
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Mac address is 0015.C68E.6D13
Proxy Ip address is 0.0.0.0
Reason for unregistered state:
No registration request since last reboot/unregister
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Mac address is 0021.5553.8998
Proxy Ip address is 0.0.0.0
Reason for unregistered state:
No registration request since last reboot/unregister
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Cisco Unified CME
The following is a sample output of the show voice register all command:
Router# show voice register all
1) show voice register all
Outbound-proxy is enabled and will use global configured value
Security Policy: DEVICE-DEFAULT
Source-address is 8.3.3.5 port 5060
Mwi registration for full E.164 is disabled
Forwarding local is enabled
Privacy-on-hold is disabled
Dst auto adjust is enabled
start at Apr week 1 day Sun time 02:00
stop at Oct week 8 day Sun time 02:00
ef (the MS 6 bits, 46, in ToS, 0xB8) for media
cs3 (the MS 6 bits, 24, in ToS, 0x60) for signal
af41 (the MS 6 bits, 34, in ToS, 0x88) for video
default (the MS 6 bits, 0, in ToS, 0x0) for service
Generate text file is disabled
Tftp files are created, current syncinfo 0001140473454008
OS79XX.TXT is not created
network-locale[0] US (This is the default network locale for this box)
user-locale[0] US (This is the default user locale for this box)
user-locale[4] US Active registrations : 0
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Pool 1 has this DN configured for line 1
call-forward b2bua noan 999 timeout 8
Pool 2 has this DN configured for line 1
Pool 7 has this DN configured for line 1
call-forward b2bua all 87687
Pool 3 has this DN configured for line 1, 2
Pool 1 has this DN configured for line 4
call-forward b2bua all 678
Pool 1 has this DN configured for line 3
Attended Transfer is enabled
Blind Transfer is enabled
Semi-attended Transfer is enabled
Caller-ID block is disabled
Anonymous call block is disabled
Pool 4 has this template configured
Template 1 has this dialplan configured
Pool 4 has this dialplan configured
Mac address is 001B.535C.D410
Proxy Ip address is 0.0.0.0
Busy trigger per button value is 0
call-forward phone all is 4566
call-forward b2bua all 4555
keep-conference is enabled
service-control mechanism is not supported
Privacy feature is not configured.
Privacy button is disabled
Reason for unregistered state:
No registration request since last reboot/unregister
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Mac address is 0015.C68E.6D13
Proxy Ip address is 0.0.0.0
Busy trigger per button value is 0
call-forward phone noan is 9886, timeout 98
keep-conference is enabled
username pool2 password lab
service-control mechanism is not supported
Privacy feature is not configured.
Privacy button is disabled
Reason for unregistered state:
No registration request since last reboot/unregister
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Mac address is 0021.5553.8998
Proxy Ip address is 0.0.0.0
Busy trigger per button value is 0
call-forward phone all is 45112
call-forward b2bua all 45111
keep-conference is enabled
service-control mechanism is not supported
Privacy feature is not configured.
Privacy button is disabled
Reason for unregistered state:
No registration request since last reboot/unregister
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Mac address is 8989.9867.8769
Proxy Ip address is 0.0.0.0
Busy trigger per button value is 0
keep-conference is enabled
service-control mechanism is not supported
Privacy feature is not configured.
Privacy button is disabled
Reason for unregistered state:
No registration request since last reboot/unregister
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Mac address is 0018.BAC8.D2B1
Proxy Ip address is 0.0.0.0
Busy trigger per button value is 0
keep-conference is enabled
service-control mechanism is not supported
Privacy feature is not configured.
Privacy button is disabled
Reason for unregistered state:
No registration request since last reboot/unregister
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
The following is an example of a partial output of the show voice register all command, showing KEM data with the phone type information:
Router# show voice register all
Mac address is B4A4.E328.4698
Type is 9971 addon 1 CKEM
Proxy Ip address is 0.0.0.0
Busy trigger per button value is 0
keep-conference is enabled
registration expires timer max is 200 and min is 60
The following is a sample output of the show voice register all command, showing the three KEMs configured with phone type 9971:
Router# show voice register all
Mac address is B4A4.E328.4698
Type is 9971 addon 1 CKEM 2 CKEM 3 CKEM
Table 56 describes the significant fields shown in this output.
Table 56 show voice register all Field Descriptions
Field
|
Description
|
Pool Tag
|
Shows the assigned tag number of the current voice register pool.
|
Config
|
Shows the voice register pool.
|
Network address and Mask
|
Shows network address and mask information when the id command is configured.
|
Number list, Pattern, and Preference
|
Shows the number command configuration.
|
Proxy IP address
|
Shows the proxy command configuration.
|
Default preference
|
Shows the default preference value of this pool.
|
Incoming called number
|
Shows the incoming called-number command configuration.
|
Translate outgoing called tag
|
Shows the translate-outgoing command configuration.
|
Class of Restriction List Tag
|
Shows the COR tag.
|
Incoming corlist name
|
Shows the cor command configuration.
|
Application
|
Shows the application command configuration for this pool.
|
Dialpeers created
|
Lists all the dial peers created and their contents. Dial-peer contents differ for each application and are not described here.
|
Statistics
|
Shows the registration statistics for this pool.
|
Active registrations
|
Shows the current active registrations.
|
Total Registration Statistics
|
Shows the total registration statistics for this pool.
|
Registration requests
|
Shows the incoming registration requests.
|
Registration success
|
Shows the successful registrations.
|
Registration failed
|
Shows the failed registrations.
|
unRegister requests
|
Shows the incoming unregister/registration expire requests.
|
unRegister success
|
Reports the number of successful unregisters.
|
unRegister failed
|
Reports the number of failed unregisters.
|
Related Commands
Command
|
Description
|
application (voice register pool)
|
Selects the session-level application for the dial peer associated with an individual Cisco Unified SIP IP phone in a Cisco Unified CME environment or for a group of phones in a Cisco Unified SIP SRST environment.
|
cor (voice register pool)
|
Configures a class of restriction on the VoIP dial peers associated with directory numbers.
|
id (voice register pool)
|
Explicitly identifies a locally available, individual Cisco Unified SIP IP phone or, when running Cisco Unified SIP SRST, a set of Cisco Unified SIP IP phones.
|
incoming called-number (dial peer)
|
Specifies a digit string that can be matched by an incoming call to associate the call with a dial peer.
|
number (voice register pool)
|
Indicates the E.164 phone numbers that the registrar permits to handle the Register message from a Cisco Unified SIP IP phone.
|
proxy (voice register pool)
|
Autogenerates additional VoIP dial peers to reach the main proxy whenever a Cisco Unified SIP IP phone registers with a Cisco Unified SIP SRST gateway.
|
show sip-ua status registrar
|
Displays all the SIP endpoints currently registered with the contact address.
|
show voice register dial-peers
|
Displays details of all dynamically created VoIP dial peers associated with the Cisco Unified SIP SRST or Cisco Unified CME register event.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
translate-outgoing (voice register pool)
|
Allows an explicit setting of translation rules on the VoIP dial peer to modify a phone number dialed by any Cisco Unified IP phone user.
|
show voice register credential
To display configuration information associated with a credential file used for authorization, use the show voice register credential command in privileged EXEC mode.
show voice register credential
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(11)XJ
|
Cisco Unified CME 4.1
|
This command was introduced.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
Examples
The following is sample output from this command:
Router# show voice register credential
username: Jsmith, password: 1234abc, service: PRESENCE , file index 3
username: Ksample, password: xyz1234, service: PRESENCE , file index 3
username: Mmore, password: updwssc, service: PRESENCE , file index 3
username: Sstove, password: 12bms, service: PRESENCE , file index 3
username: Yjones, password: 357llvrus, service: PRESENCE , file index 5
username: Yjones2, password: 55rrtuv, service: PRESENCE OOD_REFER , file index 5
username: vtemp, password: 1234567, service: PRESENCE , file index 5
Table 61 contains descriptions of fields shown in the output, listed in order of appearance.
Table 57 show voice register credential Field Descriptions
Field
|
Description
|
username
|
Username that is authorized.
|
password
|
Password that is authorized.
|
service
|
Type of service for which the credential file is used; presence or Out-of-dialog REFER (OOD-R).
|
file index
|
Identification number of the credential file defined with the authenticate command.
|
Related Commands
Command
|
Description
|
authenticate (voice register global)
|
Defines the authenticate mode for SIP phones in a Cisco Unified CME system.
|
credential load
|
Reloads a credential file into Flash memory.
|
show voice register all
|
Displays all Cisco Unified CME and Cisco Unified SIP SRST configurations and register information.
|
show voice register dial-peers
To display details of all dynamically created VoIP dial peers associated with the Cisco Unified Session Initiation Protocol (SIP) Survivable Remote Site Telephony (SRST) or Cisco Unified CallManager Express (Cisco Unified CME) register event, use the show voice register dial-peers command in privileged EXEC mode.
show voice register dial-peers [pool tag]
Syntax Description
pool tag
|
Number of entries in attempted registrations table. Size range from 0 to 50.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.2(15)ZJ
|
Cisco SIP SRST 3.0
|
This command was introduced.
|
12.3(4)T
|
Cisco SIP SRST 3.0
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
12.4(4)T
|
Cisco CME 3.4 Cisco SIP SRST 3.4
|
This command was added to Cisco CME.
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SIP SRST 8.1
|
This command was modified. Pool tag keyword- argument was added. Command output display was also modified to display dial-peers specific to a pool.
|
Usage Guidelines
Use this command to display the dial-peers associated with a pool. To display the dynamic dial-peers associated with a specific pool, use the pool keyword followed by the pool tag. When using the pool keyword, you must specify the pool tag.
Examples
Cisco Unified CME adn Cisco Unified SIP SRST
The following is a sample output from this command displaying all dial-peers:
Router#show voice register dial-peers
Dial-peers for Pool 1
dial-peer voice 40001 voip
destination-pattern 45111
session target ipv4:8.3.3.111:5060
session protocol sipv2
call-fwd-all 4555
after-hours-exempt FALSE
dial-peer voice 40002 voip
destination-pattern 45113
session target ipv4:8.33.33.111:5060
session protocol sipv2
after-hours-exempt FALSE
Dial-peers for Pool 2
dial-peer voice 40003 voip
destination-pattern 45112
session target ipv4:8.33.33.112:5060
session protocol sipv2
call-fwd-noan-timeou 8
call-fwd-noan 999
after-hours-exempt TRUE
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying all statistical information related to pool 1:
Router# show voice register dial-peers pool 1
Dial-peers for Pool 1:
dial-peer voice 40004 voip
destination-pattern 1000
redirect ip2ip
session target ipv4:9.13.18.40:19633
session protocol sipv2
dtmf-relay rtp-nte sip-notify
digit collect kpml
codec g711ulaw bytes 160
after-hours-exempt FALSE
dial-peer voice 40001 voip
destination-pattern 2000
redirect ip2ip
session target ipv4:9.13.18.40:19634
session protocol sipv2
dtmf-relay rtp-nte sip-notify
digit collect kpml
codec g711ulaw bytes 160
after-hours-exempt FALSE
Related Commands
Command
|
Description
|
show sip-ua status registrar
|
Displays all the SIP endpoints currently registered with the contact address.
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register dialplan
To display all configuration information for a specific SIP dial plan, use the show voice register dialplan command in privileged EXEC mode.
show voice register dialplan {tag | all}
Syntax Description
tag
|
Number that identifies the SIP dialplan. Range: 1 to 24.
|
all
|
(Optional) Displays all the dialplans defined in a system.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(11)XJ
|
Cisco Unified CME 4.1
|
This command was introduced.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
15.1(2)T
|
Cisco Unified CME 8.1
|
This command was modified. All keyword was added. Pools and templates that have dialplan configured are also displayed in the output.
|
Usage Guidelines
Use this command to verify the configuration of SIP dial plans. You define a dial plan with the voice register dialplan command and assign it to a SIP phone with the dialplan command.
In Cisco Unified CME 8.1 and later, show voice register dialplan command also displays the pools and templates that have the dialplan configured. The pools which have the diaplan configured by virtue of inclusion of a template is also displayed as part of the pool list display. If a dialplan is configured under both template and pool, the dialplan under the pool takes precedence and the pool is displayed.
When used with the all keyword, the show voice register diaplan command displays configuration information for all the dialplans defined in a system.
Examples
The following is sample output from this command displaying information for dialplan 1:
Router# show voice register dialplan 1
Dialplan Tag 1
Config:
Type is 7905-7912
Template 1 has this dialplan configured
Pool 4 has this dialplan configured
The following is a sample output from this command displaying information for all the dialplans configured in a system:
Router# show voice register dialplan all
Config:
Type is 7905-7912
Pattern 1 is 9879, timeout is 0, user option is phone, button is default
Pattern 24 is 908, timeout is 0, user option is phone, button is default
Dialplan Tag 2
Config:
Type is 7940-7960-others
Pattern 3 is 9845, timeout is 0, user option is phone, button is default
Pattern 20 is 9098, timeout is 0, user option is phone, button is default
Table 59 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 58 show voice register dialplan Field Descriptions
Field
|
Description
|
Config
|
List of configuration options defined for this SIP dial plan.
|
Dialplan Tag
|
Tag number of the requested SIP dial plan.
|
Pattern
|
Dial pattern defined for a SIP dial plan with the pattern command in voice register dialplan configuration mode.
|
Type
|
Phone type defined for a SIP dial plan with the type command.
|
Related Commands
Command
|
Description
|
dialplan
|
Assigns a dial plan to a SIP phone.
|
pattern (voice register dialplan)
|
Defines a dial pattern for a SIP dial plan.
|
show voice register all
|
Displays all Cisco Unified CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
type (voice register dialplan)
|
Defines a phone type for a SIP dial plan.
|
voice register dialplan
|
Enters voice register dialplan configuration mode to define a dial plan for SIP phones.
|
voice register pool
|
Enters voice register pool configuration mode for SIP phones.
|
show voice register dn
To display all configuration information associated with a specific voice register dn, use the show voice register dn command in privileged EXEC mode.
show voice register dn {tag | all}
Syntax Description
tag
|
Tag number of the voice register dn for which to display information. Range is 1 to 750.
|
all
|
(Optional) Displays configuration information associated with all voice register dns defined in a system.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
12.4(4)T
|
Cisco CME 3.4 and Cisco SIP SRST 3.4
|
This command was introduced.
|
15.1(2)T
|
Cisco CME 8.1 and Cisco SIP SRST 8.1
|
This command was modified.The display output now shows pools that have DNs configured under them. All keyword was added to show configuration information for all voice register dns defined in system.
|
Usage Guidelines
In Cisco Unified CME 8.1 and Cisco Unified SIP SRST 8.1, the show voice register dn command displays the pools that have the DNs configured under them. When used with all keyword, the show voice register dn command displays configuration information for all the DNs defined in a system.
Examples
Cisco Unified SIP CME
The following is a sample output from this command:
Router# show voice register dn 1
Dn Tag 1
Config:
Number is 11
Preference is 10
Huntstop is enabled
Translation-profile incoming saaa
Allow watch is enabled
Pool 1 has this DN configured for line 1
Cisco Unified SIP SRST
The following is a sample output from this command:
Router# show voice register dn 2
Dn Tag 1
Config:
Number is 11
Preference is 10
Huntstop is enabled
Translation-profile incoming saaa
Allow watch is enabled
Pool 1 has this DN configured for line 1
Cisco Unified SIP SRST
The following is a sample output from this command displaying information for all the dns:
Translation-profile incoming saaa
Pool 1 has this DN configured for line 1
Pool 2 has this DN configured for line 1, 2
Cisco Unified SIP CME
The following is a sample output from this command displaying information for all the dns:
Router# show voice register dn all
call-forward b2bua noan 999 timeout 8
Pool 2 has this DN configured for line 1
Pool 7 has this DN configured for line 1
call-forward b2bua all 87687
call-forward b2bua all 87687
Pool 1 has this DN configured for line 1
Pool 3 has this DN configured for line 1, 2
Pool 1 has this DN configured for line 4
call-forward b2bua all 678
Pool 1 has this DN configured for line 3
Table 59 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 59 show voice register dn Field Descriptions
Field
|
Description
|
Auto answer
|
Status of auto-answer feature defined with the auto-answer command.
|
Config
|
List of configuration options defined for this voice register dn.
|
Dn Tag
|
Tag number of the requested voice register dn.
|
Huntstop
|
Status of huntstop behavior defined with the huntstop command.
|
Number
|
Telephone or extension number set with the number command in voice register dn configuration mode.
|
Preference
|
Preference order set with the preference command in voice register dn configuration mode.
|
Related Commands
Command
|
Description
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register dn all
|
Displays information associated with all the dns configured in a system.
|
voice register dn
|
Enters voice register dn configuration mode to define an extension for a SIP phone line.
|
show voice register global
To display all global configuration parameters associated with Cisco Unified SIP IP phones, use the show voice register global command in privileged EXEC mode.
show voice register global
Syntax Description
This command has no arguments or keywords.
Command Default
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(4)T
|
Cisco CME 3.4 Cisco SIP SRST 3.4
|
This command was introduced.
|
15.0(1)XA
|
Cisco SIP SRST 8.0
|
This command was modified to display the signaling transport protocol.
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SIP SRST 8.1
|
This command was modified to include global statistics in the output display.
|
15.2(2)T
|
Cisco Unified CME 9.0
|
This command was modified to include conference hardware in the output display.
|
Examples
Cisco Unified CME
The following is a sample output from the show voice register global command used in Cisco Unified CME:
Router# show voice register global
Outbound-proxy is enabled and will use global configured value
Security Policy: DEVICE-DEFAULT
Source-address is 8.3.3.5 port 5060
Mwi registration for full E.164 is disabled
Forwarding local is enabled
Privacy-on-hold is disabled
Dst auto adjust is enabled
start at Apr week 1 day Sun time 02:00
stop at Oct week 8 day Sun time 02:00
ef (the MS 6 bits, 46, in ToS, 0xB8) for media
cs3 (the MS 6 bits, 24, in ToS, 0x60) for signal
af41 (the MS 6 bits, 34, in ToS, 0x88) for video
default (the MS 6 bits, 0, in ToS, 0x0) for service
Generate text file is disabled
Tftp files are created, current syncinfo 0001140473454008
OS79XX.TXT is not created
network-locale[0] US (This is the default network locale for this box)
user-locale[0] US (This is the default user locale for this box)
user-locale[4] US Active registrations : 0
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
The following is a sample output from the show voice register global command. The output shows that hardware conferencing is enabled.
Router# show voice register global
Outbound-proxy is enabled and will use global configured value
Security Policy: DEVICE-DEFAULT
Forced Authorization Code Refer is enabled
Source-address is 1.5.40.20 port 5060
Mwi registration for full E.164 is disabled
Forwarding local is enabled
Privacy-on-hold is disabled
Conference hardware is enabled
Dst auto adjust is enabled
start at Apr week 1 day Sun time 02:00
stop at Oct week 8 day Sun time 02:00
Cisco Unified SIP SRST
The following is a sample output from the show voice register global command used in Cisco Unified SIP SRST:
Router# show voice register global
Outbound-proxy is enabled and will use global configured value
Security Policy: DEVICE-DEFAULT
network-locale[0] US (This is the default network locale for this box)
user-locale[0] US (This is the default user locale for this box)
user-locale[4] US Active registrations : 0
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
after last unregister : 0
Last register request time :
Last unregister request time :
Unregister success time :
Table 60 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 60 show voice register global Field Descriptions
Field
|
Description
|
Conference hardware
|
Shows whether the Cisco Unified SIP IP phone will perform local mixing on its own or request Cisco Unified CME to perform hardware conferencing using its DSP resource.
|
Date-format
|
Value of date-format command.
|
DST auto adjust
|
Setting of dst auto-adjust command.
|
Forwarding local
|
Setting of forwarding local command.
|
Generate text file
|
Setting of text file command.
|
Hold-alert
|
Setting of hold-alert command.
|
Load
|
Value of load command.
|
Max-dn
|
Reports the maximum number of SIP voice register directory numbers (DNs) supported by the Cisco Unified SIP CME or Cisco Unified SIP SRST router as configured with the max-dn command. The maximum possible number is platform-dependent.
|
Max-pool
|
Reports the maximum number of SIP voice register pools supported by the Cisco Unified SIP SRST or Cisco Unified CME router as configured with the max-pool command. The maximum possible number is platform-dependent.
|
Max redirect number
|
Maximum number of redirects set with the max-redirect command.
|
Mode
|
Reports the mode as configured with the mode command. Value can be either Cisco Unified CME or Cisco Unified SIP SRST.
|
MWI registration
|
Setting of mwi command.
|
MWI stutter
|
Setting of mwi stutter command.
|
Time-format
|
Value of time-format command.
|
Time-zone
|
Number of the timezone selected with the timezone command.
|
TFTP path
|
Directory location of provisioning files for Cisco Unified SIP IP phones that is specified with the tftp-path command.
|
Version
|
Reports the Cisco Unified SIP SRST or Cisco Unified CME version number.
|
Related Commands
Command
|
Description
|
show sip-ua status registrar
|
Displays all the Cisco Unified SIP IP phones currently registered with the contact address.
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register dial-peers
|
Displays details of all dynamically created VoIP dial peers associated with the Cisco Unified SIP SRST or Cisco Unified CME register event.
|
voice register global
|
Enters voice register global configuration mode to set global parameters for all supported Cisco Unified SIP IP phones in a Cisco Unified CME or Cisco Unified SIP SRST environment.
|
show voice register hfs
To display the HTTP File-Fetch Server (HFS) file bindings of firmware files accessible to Cisco Unified SIP IP phones, use the show voice register hfs command in privileged EXEC mode.
show voice register hfs
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
15.2(1)T
|
This command was introduced.
|
Usage Guidelines
Use the show voice register hfs command with Cisco Unified CME 8.8 or a later version.
This command displays the bindings of firmware files that are accessible to Cisco Unified SIP IP phones using the HFS download service.
Examples
The following is a sample output from the show voice register hfs command:
Router(config)# show voice register hfs
Fetch Service Enabled = Y
Registered session-id = 19
Default home path = flash:/
Ongoing fetches from home = 0
HTTP File Server Bindings
No. of url table entries = 9
No. of alias table entries = 9
Related Commands
Command
|
Description
|
create profile (voice register global)
|
Generates the configuration profile files required for SIP phones.
|
hfs enable
|
Enables the HFS download service on an IP Phone in a Cisco Unified CME system.
|
show voice register pool
To display all configuration information associated with a specific voice register pool, use the show voice register pool command in privileged EXEC mode.
show voice register pool {pool-tag | all }[brief]
Syntax Description
pool-tag
|
Tag number of the voice register pool for which information is displayed. Range is 1 to 262.
Note The maximum number of pools is version and platform dependent.
|
all
|
Displays the information of all the voice register pools.
|
brief
|
(Optional) Displays brief information of all voice register pools.
|
Command Modes
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.2(15)ZJ
|
Cisco SIP SRST
|
This command was introduced.
|
12.3(4)T
|
Cisco SIP SRST
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
12.4(4)T
|
Cisco CME 3.4 Cisco SIP SRST 3.4
|
This command was added to Cisco CME.
|
12.4(15)XY
|
Cisco Unified CME 4.2(1) Cisco Unified SIP SRST 4.2(1)
|
This command was modified to include emergency response location information in the output display.
|
12.4(20)T
|
Cisco Unified CME 7.0 Cisco Unified SIP SRST 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
15.0(1)XA
|
Cisco Unified CME 8.0
|
This command was modified to include logical partitioning class of restriction (LPCOR) information in the output display.
|
15.1(1)T
|
Cisco Unified CME 8.0
|
This command was integrated into Cisco IOS Release 15.1(1)T.
|
15.1(2)T
|
Cisco Unified CME 8.1
|
This command was modified. The all and brief keywords were added. Voice-class stun-usage information is displayed in the output.
|
15.2(2)T
|
Cisco Unified CME 9.0
|
This command was modified to include conference admin, conference add mode, and conference drop mode in the output display.
|
15.2(4)M
|
Cisco Unified CME 9.1 Cisco Unified SIP SRST 9.1
|
This command was modified to include Key Expansion Module (KEM) data in the output display.
|
Examples
Cisco Unified CME
The following is a sample output of the show voice register pool command, displaying information for voice register pool 33 in Cisco Unified CME:
Router# show voice register pool 33
Mac address is 0009.B7F7.532E
Proxy Ip address is 0.0.0.0
Busy trigger per button value is 0
keep-conference is enabled
Emergency response location 3
Lpcor Incoming is sip_group
Lpcor Outgoing is sip_group
service-control mechanism is not supported
Privacy feature is not configured.
Privacy button is disabled
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 0
The following is a sample output of the show voice register pool command. The output shows that a meet-me hardware conference administrator has been assigned, the conference creator or any of the participants can add a new participant, and the conference creator can terminate the active video hardware conference by hanging up.
Router# show voice register pool 15
Mac address is 1C17.D340.81F0
Proxy Ip address is 0.0.0.0
Current Phone load version is Cisco-CP9951/9.0.1
DTMF Relay is enabled, sip-notify
Busy trigger per button value is 0
keep-conference is enabled
registration expires timer max is 86400 and min is 60
service-control mechanism is supported
registration Call ID is 1c17d340-81f00002-6c48fe8e-03013c10@1.5.40.105
Registration method: per line
Privacy feature is not configured.
Privacy button is disabled
active primary line is: 3915
contact IP address: 1.5.40.105 port 5060
conference drop mode: creator
paging-dn: config 0 [multicast] effective 0 [multicast]
The following is an example of a partial output of the show voice register pool all command, showing KEM data with the phone type information:
Router# show voice register pool all
Mac address is B4A4.E328.4698
Type is 9971 addon 1 CKEM
Proxy Ip address is 0.0.0.0
Busy trigger per button value is 0
keep-conference is enabled
registration expires timer max is 200 and min is 60
The following is a sample output of the show voice register pool all command, showing the three KEMs configured with phone type 9971:
Router# show voice register pool all
Mac address is B4A4.E328.4698
Type is 9971 addon 1 CKEM 2 CKEM 3 CKEM
Cisco Unified SIP SRST
The following is a sample output of the show voice register pool command, displaying all information for voice register pool 1 in Cisco Unified SIP SRST:
Router# show voice register pool 1
Network address is 192.168.0.0, Mask is 255.255.0.0
Number list 1 : Pattern is 50.., Preference is 2
Proxy Ip address is 0.0.0.0
Incoming called number is
Translate outgoing called tag is 1
Class of Restriction List Tag: default
Incoming corlist name is allowall
Application is default.new
dial-peer voice 40007 voip
corlist incoming allowall
incoming called-number 5001
session target ipv4:192.168.0.3
translate-outgoing called 1
Total Registration Statistics
Registration requests : 48
Registration success : 48
Emergency response location 6
Voice class stun usage
The following is a sample output of the show voice register pool command, displaying voice-class stun-usage information for voice register pool 51:
Router# show voice register pool 51
Mac address is 0011.209F.5D60
Proxy Ip address is 0.0.0.0
Current Phone load version is Cisco-SIPGateway/IOS-12.x
Busy trigger per button value is 0
keep-conference is enabled
service-control mechanism is not supported
registration Call ID is 2BA38EE3-17D311DB-800BCD81-A9AD11F0
Privacy feature is not configured.
Privacy button is disabled
active primary line is: 16263646
contact IP address: 192.168.0.87 port 5060
Reason for unregistered state:
No registration request since last reboot/unregister
voice-class stun-usage is enabled. tag is 1
Total SIP phones registered: 0
Total Registration Statistics
Registration requests : 2
after last unregister : 0
Last register request time : 13:43:27.839 IST Tue Apr 20 2010
Table 61 contains descriptions of significant fields shown in the Cisco Unified CME and Cisco Unified SIP SRST output, listed in alphabetical order.
Table 61 show voice register pool Field Descriptions
Field
|
Description
|
Active registrations
|
Shows the current active registrations.
|
Application
|
Shows the application command configuration for this pool.
|
Call Waiting
|
Shows the call-waiting command configuration.
|
Class of Restriction List Tag
|
Shows the COR tag.
|
Conference add mode
|
Shows the current setting of the hardware conference privilege for adding participants.
|
Conference admin
|
Shows whether the Cisco Unified SIP IP phone is assigned as the hardware conference administrator or not.
|
Conference drop mode
|
Shows who can terminate an active ad-hoc hardware conference by hanging up.
|
Config
|
Shows the voice register pool.
|
Default preference
|
Shows the default preference value of this pool.
|
Dialpeers created
|
Lists all the dial peers created and their contents. Dial-peer contents differ for each application and are not described here.
|
DnD
|
Shows the setting of the dnd-control command.
|
DTMF Relay
|
Shows the setting of the dtmf-relay command.
|
Emergency response location
|
Shows the ephone's emergency response location to which an emergency response team is dispatched when an emergency call is made.
|
Incoming called number
|
Shows the incoming called-number command configuration.
|
Incoming corlist name
|
Shows the cor command configuration.
|
keep-conference
|
Shows the status of the keep-conference command.
|
Lpcor Incoming
|
Shows the setting of the lpcor incoming command.
|
Lpcor Outgoing
|
Shows the setting of the lpcor outgoing command.
|
Lpcor Type
|
Shows the setting of the lpcor type command.
|
Mac address
|
Shows the MAC address of the Cisco Unified SIP IP phone as defined by the id command.
|
Network address and Mask
|
Shows network address and mask information when the id command is configured.
|
Number list, Pattern, and Preference
|
Shows the number command configuration.
|
Pool Tag
|
Shows the assigned tag number of the current pool.
|
Proxy IP address
|
Shows the proxy command configuration; that is, the IP address of the external SIP server.
|
Registration failed
|
Shows the failed registrations.
|
Registration requests
|
Shows the incoming registration requests.
|
Registration success
|
Shows the successful registrations.
|
Statistics
|
Shows the registration statistics for this pool.
|
Template
|
Shows the template-tag number for the template applied to the Cisco Unified SIP IP phone.
|
Total Registration Statistics
|
Shows the total registration statistics for this pool.
|
Translate outgoing called tag
|
Shows the translate-outgoing command configuration.
|
Type
|
Shows the phone type identified for the Cisco Unified SIP IP phone using the type command.
|
unRegister failed
|
Reports the number of failed unregisters.
|
unRegister requests
|
Shows the incoming unregister/registration expiry requests.
|
unRegister success
|
Reports the number of successful unregisters.
|
Username Password
|
Shows the values within the authentication credential.
|
Related Commands
Command
|
Description
|
application (voice register pool)
|
Selects the session-level application for the dial peer associated with an individual Cisco Unified SIP IP phone in a Cisco Unified CME environment or for a group of phones in a Cisco Unified SIP SRST environment.
|
call-waiting (voice register pool)
|
Enables the call-waiting option on a SIP phone.
|
cor (voice register pool)
|
Configures a class of restriction on the VoIP dial peers associated with directory numbers.
|
dnd-control (voice register template)
|
Enables the Do-Not-Disturb (DND) soft key on SIP phones.
|
dtmf-relay (voice register pool)
|
Specifies the list of dual-tone multifrequency (DTMF) relay methods that can be used to relay DTMF audio tones between SIP endpoints.
|
id (voice register pool)
|
Explicitly identifies a locally available, individual Cisco Unified SIP IP phone or, when running Cisco Unified SIP SRST, a set of Cisco Unified SIP IP phones.
|
incoming called-number (dial peer)
|
Specifies a digit string that can be matched by an incoming call to associate the call with a dial peer.
|
keep-conference (voice register pool)
|
Allows IP phone conference initiators to exit from conference calls and keep the remaining parties connected.
|
lpcor incoming
|
Associates an incoming call with a logical partitioning class of restriction (LPCOR) resource-group policy.
|
lpcor outgoing
|
Associates an outgoing call with an LPCOR resource-group policy.
|
lpcor type
|
Specifies the LPCOR type for an IP phone.
|
number (voice register pool)
|
Indicates the E.164 phone numbers that the registrar permits to handle the Register message from a Cisco Unified SIP IP phone.
|
proxy (voice register pool)
|
Autogenerates additional VoIP dial peers to reach the main proxy whenever a Cisco Unified SIP IP phone registers with a Cisco Unified SIP SRST gateway.
|
show sip-ua status registrar
|
Displays all the Cisco Unified SIP IP phones registered with the contact address.
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register dial-peer
|
Displays details of all dynamically created VoIP dial peers associated with the Cisco Unified CME or Cisco Unified SIP SRST register event.
|
translate-outgoing (voice register pool)
|
Allows an explicit setting of translation rules on the VoIP dial peer to modify a phone number dialed by any Cisco Unified IP phone user.
|
type (voice register pool)
|
Defines a phone type for a SIP phone.
|
voice register pool
|
Enters voice register pool configuration mode for Cisco Unified SIP IP phones.
|
show voice register pool after-hour-exempt
To display the details of a phone that has after-hour-exempt enabled on it, use the show voice register after-hour-exempt command in privileged EXEC mode.
show voice register after-hour-exempt
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of a phone that has after-hour-exempt enabled. Individual phones can be exempted from call blocking using the after-hour exempt.
Examples
Cisco Unified CME
The following is a sample output from this command displaying information for phones with after after-hour-exempt:
Router# show voice register pool after-hour-exempt
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
1 001B.535C.D410 8.3.3.111 3 8 UNREGISTERED
2 0015.C68E.6D13 1 2 45112 UNREGISTERED
3 0021.5553.8998 1 3 45113 UNREGISTERED
7 0018.BAC8.D2B1 1 2 45112 UNREGISTERED
Cisco Unified SRST
The following is a sample output from this command displaying information for phones with after after-hour-exempt:
Router# show voice register pool after-hour-exempt
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
1 9.13.18.40 9.13.18.40 1 1 1000 REGISTERED
Table 59 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 62 show voice register pool after-hour exempt field descriptions
Field
|
Description
|
DN
|
Directory number of the phone.
|
IP Address/port
|
IP address and port number of the phones.
|
LN
|
Line number of the phone.
|
Number
|
Number of the phones that have after-hour exempt enabled.
|
Pool
|
Shows the current pool.
|
State
|
Registration state.
|
Related Commands
Command
|
Description
|
after-hour exempt(voice register pool)
|
Specifies that an IP phone does not have any of its outgoing calls blocked although call blocking is defined.
|
show voice register all
|
Displays all Cisco SIP SRST and Cisco CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
voice register pool
|
Enters voice register pool configuration mode for SIP phones.
|
show voice register pool attempted-registrations
To display the details of phones that attempt to register with Cisco Unified CME or Cisco Unified SRST and fail, use the show voice register pool attempted-registrations command in privileged EXEC mode.
show voice register pool attempted-registrations
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of the phones that attempt to register with Cisco Unified CME or Cisco Unified SRST and fail. If the phone registers successfully after some time, the attempted registration entry will still show up in the attempted-registration table. Use the clear voice register attempted-registrations command to remove the entry from the attempted registration table.
Examples
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying information for show voice register pool attempted-registrations:
Router# show voice register pool attempted-registrations
Phones that have attempted registrations and have failed:
MAC address: 001b.535c.d410
IP address : 8.3.3.111
Attempts : 5
Time of first attempt : *10:49:51.542 UTC Wed Oct 14 2009
Time of latest attempt: *10:50:00.886 UTC Wed Oct 14 2009
Reason for failure :
No pool match for the registration request
MAC address: 0015.c68e.6d13
IP address : 8.33.33.112
Attempts : 4
Time of first attempt : *10:49:53.418 UTC Wed Oct 14 2009
Time of latest attempt: *10:50:00.434 UTC Wed Oct 14 2009
Reason for failure :
No pool match for the registration request
MAC address: 0009.43E9.0B35
IP address : 9.13.40.83
Attempts : 1
Time of first attempt : *10:49:57.866 UTC Wed Oct 14 2009
Time of latest attempt: *10:49:57.866 UTC Wed Oct 14 2009
Reason for failure :
No pool match for the registration request
The following is a sample output from this command displaying information for show voice register pool attempted-registrations when none of the phones fail:
Router# show voice register pool attempted-registrations
Phones that have attempted registrations and have failed: NONE
Related Commands
Command
|
Description
|
attempted-registrations size
|
Allows to set the size of the table that stores information related to SIP phones that attempt to register and fail.
|
clear voice register attempted-registrations
|
Clears entries from the attempted-registration table.
|
show voice register pool cfa
To display the voice register pool details of a phone that has Call Forward All (CFA) enabled, use the show voice register pool cfa command in privileged EXEC mode.
show voice register pool cfa
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the voice register pool details of the phone with CFA feature enabled. When Call Forward All feature is enabled on Cisco Unified SIP IP phones such as 7940, 7941, 7941GE, 7942, 7945, 7960, 7961, 7961GE, 7962, 7965, 7970, 7971, 7975 through the CFA phone button. The show voice register pool cfa command displays only the call forward all B2BUA details.
The show voice register pool cfa command also displays the line number and DN number if available under the pool configuration. If call-forward-all is configured under both pool and DN. the configuration under DN takes precedence.
Examples
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying all statistical information:
Router# show voice register pool cfa
Pool Ln DN Number Call Forward All Number
==== == == ====== ========================
1 2 8 678
0 1 45111 4555
4 7 451110 4555
3 1 3 45113 87687
2 3 45113 87687
Table 59 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 63 show voice register pool ip field descriptions
Field
|
Description
|
Call Forward All Number
|
Number to which the calls are forwarded
|
DN
|
Voice register DN tag of the line.
|
LN
|
Line number of the telephone number.
|
Pool
|
Tag ID of the pool.
|
Related Commands
Command
|
Description
|
call forward b2bua all
|
Enables call forward all.
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool detail all
|
Displays the details of all the pools defined in the system.
|
show voice register pool connected
To display the details of SIP phones that are in connected state, use the show voice register pool connected command in privileged EXEC mode.
show voice register pool connected [brief]
Syntax Description
brief
|
(Optional) Displays brief details of SIP phones that are in connected state.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of the phone that are currently in connected state (in conversation). The output for show voice register pool connected command shows details of both calls originating from the SIP phones and calls made towards SIP phones. When used with brief keyword, the show voice register pool connected command displays a brief detail of phones in connected state.
Cisco Unified CME and Cisco Unified SRST
The following is sample output from this command displaying all statistical information:
Router# show voice register pool connected
Outbound calls from SIP line phones:
Pool tag: 1
==============
MAC Address : 001B.535C.D410
Contact IP : 8.3.3.111
Phone Number : 45111
Remote Number : 45112
Call 2
SIP Call ID : 001b535c-d4100010-79612b5a-336b0db5@8.3.3.111
State of the call : STATE_ACTIVE (7)
Substate of the call : SUBSTATE_NONE (0)
Calling Number : 45111
Called Number : 45112
Bit Flags : 0xC0401C 0x100 0x4
CC Call ID : 7
Source IP Address (Sig ): 8.3.3.5
Destn SIP Req Addr:Port : [8.3.3.111]:5060
Destn SIP Resp Addr:Port: [8.3.3.111]:50076
Destination Name : 8.3.3.111
Number of Media Streams : 1
Number of Active Streams: 1
RTP Fork Object : 0x0
Media Mode : flow-through
Media Stream 1
State of the stream : STREAM_ACTIVE
Stream Call ID : 7
Stream Type : voice-only (0)
Stream Media Addr Type : 1
Negotiated Codec : g729r8 (20 bytes)
Codec Payload Type : 18
Negotiated Dtmf-relay : inband-voice
Dtmf-relay Payload Type : 0
QoS ID : -1
Local QoS Strength : BestEffort
Negotiated QoS Strength : BestEffort
Negotiated QoS Direction : None
Local QoS Status : None
Media Source IP Addr:Port: [8.3.3.5]:17580
Media Dest IP Addr:Port : [8.3.3.111]:26298
Options-Ping ENABLED:NO ACTIVE:NO
Inbound calls to SIP line phones:
Pool tag: 2
==============
MAC Address : 0015.C68E.6D13
Contact IP : 8.33.33.112
Phone Number : 45112
Remote Number : 45111
Call 3
SIP Call ID : 4DA52F97-ADA311DE-8019803A-FF3E4CBC@8.3.3.5
State of the call : STATE_ACTIVE (7)
Substate of the call : SUBSTATE_NONE (0)
Calling Number : 45111
Called Number : 45112
Bit Flags : 0xC04018 0x100 0x80
CC Call ID : 8
Source IP Address (Sig ): 8.3.3.5
Destn SIP Req Addr:Port : [8.33.33.112]:5060
Destn SIP Resp Addr:Port: [8.33.33.112]:5060
Destination Name : 8.33.33.112
Number of Media Streams : 1
Number of Active Streams: 1
RTP Fork Object : 0x0
Media Mode : flow-through
Media Stream 1
State of the stream : STREAM_ACTIVE
Stream Call ID : 8
Stream Type : voice-only (0)
Stream Media Addr Type : 1
Negotiated Codec : g729r8 (20 bytes)
Codec Payload Type : 18
Negotiated Dtmf-relay : inband-voice
Dtmf-relay Payload Type : 0
QoS ID : -1
Local QoS Strength : BestEffort
Negotiated QoS Strength : BestEffort
Negotiated QoS Direction : None
Local QoS Status : None
Media Source IP Addr:Port: [8.3.3.5]:16384
Media Dest IP Addr:Port : [8.33.33.112]:30040
The following is sample output from this command displaying brief statistical information:
Router# show voice register pool connected brief
Pool IP Address Number Remote Number
==== =============== ==================== ====================
1 8.3.3.111 45111 45112
Inbound calls to SIP line phones:
Pool IP Address Number Remote Number
==== =============== ==================== ====================
2 8.33.33.112 45112 45111
Related Commands
Command
|
Description
|
show sip-ua calls
|
Displays active user agent client (UAC) and user agent server (UAS) information on SIP calls
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool ip
To display the details of a SIP phone with a specific IP address, use the show voice register pool ip command in privileged EXEC mode.
show voice register pool ip ip-address
Syntax Description
ip-address
|
IPv4 address of the SIP phone .
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of a phone with a specific IP-address. When the pool ID is configured as a mac address or an IP address the registered pools contain the IP address information. The pool information is displayed if the IP addresses match.
When the pool ID is IP and the pool is unregistered, IP address configured under pool is compared with the input IP. When the pool ID is network contact, the IP address of each phone that is registered is compared with the input IP address.
Examples
Cisco Unified CME and Cisco Unified SRST
The following is sample output from this command displaying all statistical information:
Router# show voice register pool ip 8.3.3.111
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
1 001B.535C.D410 8.3.3.111 1 1 45111 REGISTERED
4 7 451110 UNREGISTERED
Table 59 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 64 show voice register pool ip field descriptions
Field
|
Description
|
DN
|
Voice register DN tag of the line.
|
ID
|
Phone identification (ID) address.
|
IP Address
|
IP address of the SIP phone.
|
LN
|
Line number of the telephone number.
|
Number
|
Number of the phones that have a mac address.
|
Pool
|
Tag ID of the pool.
|
State
|
Registration state of the line.
|
Related Commands
Command
|
Description
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool mac
To display the details of voice register pool associated with a specific phone type, use the show voice register pool mac command in privileged EXEC mode.
show voice register pool mac H.H.H
Syntax Description
H.H.H
|
MAC address of the SIP phone attempting to register.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of the phone with the mac address H.H.H. The command displays only the pools that are configured with an ID as mac.
Examples
Cisco Unified CME and Cisco Unified SRST
The following is sample output from this command displaying all statistical information:
Router# show voice register pool mac 001B.535C.D410
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
1 001B.535C.D410 8.3.3.111 1 1 45111 REGISTERED
4 7 451110 UNREGISTERED
Table 59 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 65 show voice register pool mac field descriptions
Field
|
Description
|
DN
|
Voice register DN tag of the line.
|
ID
|
Phone identification (ID) address.
|
IP Address
|
IP address of the SIP phone.
|
LN
|
Line number of the telephone number.
|
Number
|
Number of the phones that have a mac address.
|
Pool
|
Tag ID of the pool.
|
State
|
Registration state of the line.
|
Related Commands
Command
|
Description
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool on-hold
To display the details of phones that are currently on-hold, use the show voice register pool oh-hold command in privileged EXEC mode.
show voice register pool on-hold [brief]
Syntax Description
brief
|
(Optional) Displays brief details of SIP phones that are currently on-hold.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of the phone that are currently on-hold. The show voice register pool on-hold command output also displays a field to show if the hold was a locally initiated hold (initiated on the phone) or if the hold was initiated on the remote end. When used with brief keyword, the show voice register pool on-hold command displays a brief information of the phones that are currently put on hold by the remote caller or have put the remote caller on hold. The "Hold-Origin" field specifies the type of the hold, which can be either remote or local. Local indicates that the call is placed on hold by the local phone and remote indicates that call is placed on hold by the remote phone. In case of double-hold, the hold origin will display the value "Local and Remote".
Examples
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying information for phones ringing in a voice register pool:
Router# show voice register pool on-hold brief
Outbound calls from SIP line phones:
Pool IP Address Number Remote Number Hold Origin
==== =============== ==================== ==================== ==============
1 8.3.3.111 45111 45112 Remote & Local
Inbound calls to SIP line phones:
Pool IP Address Number Remote Number Hold Origin
==== =============== ==================== ==================== ==============
2 8.33.33.112 45112 45111 Remote & Local
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying information for phones on-hold:
Router# show voice register pool on-hold
Outbound calls from SIP line phones:
Pool tag: 1
==============
MAC Address : 001B.535C.D410
Contact IP : 8.3.3.111
Phone Number : 45111
Remote Number : 45112
Local Hold : CALL HOLD Pressed on SIP Phone
Call 4
SIP Call ID : 001b535c-d4100010-79612b5a-336b0db5@8.3.3.111
State of the call : STATE_ACTIVE (7)
Substate of the call : SUBSTATE_NONE (0)
Calling Number : 45111
Called Number : 45112
Bit Flags : 0xC0401C 0x10100 0x4
CC Call ID : 7
Source IP Address (Sig ): 8.3.3.5
Destn SIP Req Addr:Port : [8.3.3.111]:5060
Destn SIP Resp Addr:Port: [8.3.3.111]:50076
Destination Name : 8.3.3.111
Number of Media Streams : 1
Number of Active Streams: 1
RTP Fork Object : 0x0
Media Mode : flow-through
Media Stream 1
State of the stream : STREAM_ACTIVE
Stream Call ID : 7
Stream Type : voice-only (0)
Stream Media Addr Type : 1
Negotiated Codec : g729r8 (20 bytes)
Codec Payload Type : 18
Negotiated Dtmf-relay : inband-voice
Dtmf-relay Payload Type : 0
QoS ID : -1
Local QoS Strength : BestEffort
Negotiated QoS Strength : BestEffort
Negotiated QoS Direction : None
Local QoS Status : None
Media Source IP Addr:Port: [8.3.3.5]:17580
Media Dest IP Addr:Port : [8.3.3.111]:26298
Options-Ping ENABLED:NO ACTIVE:NO
Inbound calls to SIP line phones:
Pool tag: 2
==============
MAC Address : 0015.C68E.6D13
Contact IP : 8.33.33.112
Phone Number : 45112
Remote Number : 45111
Remote Hold : SIP Phone has received CALL HOLD
Call 5
SIP Call ID : 4DA52F97-ADA311DE-8019803A-FF3E4CBC@8.3.3.5
State of the call : STATE_ACTIVE (7)
Substate of the call : SUBSTATE_NONE (0)
Calling Number : 45111
Called Number : 45112
Bit Flags : 0xC04018 0x4100 0x80
CC Call ID : 8
Source IP Address (Sig ): 8.3.3.5
Destn SIP Req Addr:Port : [8.33.33.112]:5060
Destn SIP Resp Addr:Port: [8.33.33.112]:5060
Destination Name : 8.33.33.112
Number of Media Streams : 1
Number of Active Streams: 1
RTP Fork Object : 0x0
Media Mode : flow-through
Media Stream 1
State of the stream : STREAM_ACTIVE
Stream Call ID : 8
Stream Type : voice-only (0)
Stream Media Addr Type : 1
Negotiated Codec : g729r8 (20 bytes)
Codec Payload Type : 18
Negotiated Dtmf-relay : inband-voice
Dtmf-relay Payload Type : 0
QoS ID : -1
Local QoS Strength : BestEffort
Negotiated QoS Strength : BestEffort
Negotiated QoS Direction : None
Local QoS Status : None
Media Source IP Addr:Port: [8.3.3.5]:16384
Media Dest IP Addr:Port : [8.33.33.112]:30040
Options-Ping ENABLED:NO ACTIVE:NO
Related Commands
Command
|
Description
|
show voice register all
|
Displays all Cisco SIP SRST and Cisco CME configurations and register information.
|
show sip-ua calls
|
Displays active user agent client (UAC) and user agent server (UAS) information on SIP calls
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool phone-load
To display the details of phone-loads associated with phones that are registered to Cisco Unified CME, use the show voice register pool phone-load command in privileged EXEC mode.
show voice register pool phone-load
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of the phone-loads associated with phones that are registered with Cisco Unified CME. The phone-load information is taken from the REGISTER message sent by the phone.
Examples
The following is a sample output from this command displaying information for voice register pool phone-load:
Router# show voice register pool phone-load
Pool Device Name Current Version Previous Version
==== =========== ================= ===================
1 SEP001B535CD410 Cisco-CP7960G/8.0
Related Commands
Command
|
Description
|
load(voice register global)
|
Associates a type of Cisco Unified IP phone with a phone firmware file.
|
show voice register all
|
Displays all Cisco SIP SRST and Cisco CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
voice register pool
|
Enters voice register pool configuration mode for SIP phones.
|
show voice register pool registered
To display the details of phones that successfully register to Cisco Unified Communications Manager Express (Cisco Unified CME), use the show voice register pool registered command in privileged EXEC mode.
show voice register pool registered
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Version
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
15.2(4)M
|
Cisco Unified CME 9.1 Cisco Unified SIP SRST 9.1
|
This command was modified to display Key Expansion Module (KEM) details with the phone type information.
|
Usage Guidelines
Use the show voice register pool registered command to display the details of phones that are successfully registered to Cisco Unified CME and Cisco Unified Survivable Remote Site Telephony (Cisco Unified SRST).
Examples
Cisco Unified CME
The following is a sample output displaying information for a registered voice register pool in Cisco Unified CME:
Router# show voice register pool registered
Mac address is 001B.535C.D410
Proxy Ip address is 0.0.0.0
Current Phone load version is Cisco-CP7960G/8.0
Busy trigger per button value is 0
call-forward phone all is 4566
call-forward b2bua all 4555
keep-conference is enabled
service-control mechanism is supported
registration Call ID is 001b535c-d410790d-17a6877e-5d04bbc5@8.3.3.111
Privacy feature is not configured.
Privacy button is disabled
active primary line is: 45111
contact IP address: 8.3.3.111 port 5060
dial-peer voice 40001 voip
destination-pattern 45111
session target ipv4:8.3.3.111:5060
Total SIP phones registered: 1
Total Registration Statistics
Registration requests : 1
after last unregister : 0
Last register request time : *11:40:32.263 UTC Wed Oct 14 2009
Last unregister request time :
Register success time : *11:40:32.267 UTC Wed Oct 14 2009
Unregister success time :
The following is a sample output displaying information for a registered voice register pool with a Cisco Unified 9971 Session Initiation Protocol (SIP) IP phone attached to a Cisco SIP IP Phone CKEM 36-Button Line Expansion Module:
Router# show voice register pool registered
Mac address is B4A4.E328.4698
Type is 9971 addon 1 CKEM
Proxy Ip address is 0.0.0.0
Busy trigger per button value is 0
keep-conference is enabled
registration expires timer max is 200 and min is 60
Cisco Unified SRST
The following is a sample output displaying information for a registered voice register pool in Cisco
Unified SRST:
Router# show voice register pool registered
Ip address is 9.13.18.40, Mask is 255.255.0.0
Proxy Ip address is 0.0.0.0
DTMF Relay is enabled, rtp-nte, sip-notify
dial-peer voice 40004 voip
session target ipv4:9.13.18.40:19633
dtmf-relay rtp-nte sip-notify
dial-peer voice 40001 voip
session target ipv4:9.13.18.40:19634
dtmf-relay rtp-nte sip-notify
dial-peer voice 40002 voip
session target ipv4:9.13.18.40:19635
dtmf-relay rtp-nte sip-notify
dial-peer voice 40003 voip
session target ipv4:9.13.18.40:19636
dtmf-relay rtp-nte sip-notify
Total SIP phones registered: 1
Total Registration Statistics
Registration requests : 4
after last unregister : 0
Last register request time : .05:22:55.604 UTC Tue Oct 6 2009
Last unregister request time :
Register success time : .05:22:55.604 UTC Tue Oct 6 2009
Unregister success time :
Table 66 contains descriptions of significant fields shown in the show voice register pool registered command output, listed in alphabetical order.
Table 66 show voice register pool registered Field Descriptions
Field
|
Description
|
Active registrations
|
Shows the current active registrations.
|
Application
|
Shows the application command configuration for this pool.
|
Call Waiting
|
Shows the setting of the call-waiting command.
|
Class of Restriction List Tag
|
Shows the COR tag.
|
Config
|
Shows the voice register pool.
|
Current phone-load
|
Shows the current version of the phone load.
|
Default preference
|
Shows the default preference value of this pool.
|
Dialpeers created
|
Results in a list of all dial peers created and their contents. Dial-peer contents differ for each application and are not described here.
|
DnD
|
Shows the setting of the dnd-control command.
|
DTMF Relay
|
Shows the setting of the dtmf-relay command.
|
Emergency response location
|
Shows the ephone's emergency response location to which an emergency response team is dispatched when an emergency call is made.
|
Incoming called number
|
Shows the incoming called-number command configuration.
|
Incoming corlist name
|
Shows the cor command configuration.
|
keep-conference
|
Shows the status of the keep-conference command.
|
Lpcor Incoming
|
Shows the setting of the lpcor incoming command.
|
Lpcor Outgoing
|
Shows the setting of the lpcor outgoing command.
|
Lpcor Type
|
Shows the setting of the lpcor type command.
|
Mac address
|
Shows the MAC address of this SIP phone as defined by the id command.
|
Network address and Mask
|
Shows network address and mask information when the id command is configured.
|
Number list, Pattern, and Preference
|
Shows the number command configuration.
|
Pool Tag
|
Shows the assigned tag number of the current pool.
|
Previous phone-load
|
Shows the version of the previous phone load.
|
Proxy IP address
|
Shows the proxy command configuration; that is, the IP address of the external SIP server.
|
Registration failed
|
Shows the failed registrations.
|
Registration requests
|
Shows the incoming registration requests.
|
Registration success
|
Shows the successful registrations.
|
Statistics
|
Shows the registration statistics for this pool.
|
statistics time-stamps
|
Shows the registration statistics for this pool with specific time stamps.
|
Template
|
Shows the template-tag number for the template applied to this SIP phone.
|
Total Registration Statistics
|
Shows the total registration statistics for this pool.
|
Translate outgoing called tag
|
Shows the translate-outgoing command configuration.
|
Type
|
Shows the phone type identified for this SIP phone using the type command.
|
unRegister failed
|
Reports the number of failed unregisters.
|
unRegister requests
|
Shows the incoming unregister/registration expiry requests.
|
unRegister success
|
Reports the number of successful unregisters.
|
Username Password
|
Shows the values within the authentication credential.
|
Related Commands
Command
|
Description
|
application (voice register pool)
|
Selects the session-level application for the dial peer associated with an individual Cisco Unified SIP IP phone in a Cisco Unified CME environment or for a group of phones in a Cisco Unified SIP SRST environment.
|
call-waiting (voice register pool)
|
Enables the call-waiting option on a SIP phone.
|
cor (voice register pool)
|
Configures a class of restriction on the VoIP dial peers associated with directory numbers.
|
dnd-control (voice register template)
|
Enables the Do-Not-Disturb (DND) soft key on SIP phones.
|
dtmf-relay (voice register pool)
|
Specifies the list of dual-tone multifrequency (DTMF) relay methods that can be used to relay DTMF audio tones between SIP endpoints.
|
id (voice register pool)
|
Explicitly identifies a locally available, individual Cisco Unified SIP IP phone or, when running Cisco Unified SIP SRST, a set of Cisco Unified SIP IP phones.
|
incoming called-number (dial peer)
|
Specifies a digit string that can be matched by an incoming call to associate the call with a dial peer.
|
keep-conference (voice register pool)
|
Allows IP phone conference initiators to exit from conference calls and keep the remaining parties connected.
|
lpcor incoming
|
Associates an incoming call with a logical partitioning class of restriction (LPCOR) resource-group policy.
|
lpcor outgoing
|
Associates an outgoing call with an LPCOR resource-group policy.
|
lpcor type
|
Specifies the LPCOR type for an IP phone.
|
number (voice register pool)
|
Indicates the E.164 phone numbers that the registrar permits to handle the Register message from a Cisco Unified SIP IP phone.
|
proxy (voice register pool)
|
Autogenerates additional VoIP dial peers to reach the main proxy whenever a Cisco Unified SIP IP phone registers with a Cisco Unified SIP SRST gateway.
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register dial-peers
|
Displays details of all dynamically created VoIP dial peers associated with the Cisco Unified SIP SRST or Cisco Unified CME register event.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool unregistered
|
Displays the details of voice register pools that do not have any phones registered.
|
translate-outgoing (voice register pool)
|
Allows an explicit setting of translation rules on the VoIP dial peer to modify a phone number dialed by any Cisco Unified IP phone user.
|
type (voice register pool)
|
Defines a phone type for a SIP phone.
|
voice register pool
|
Enters voice register pool configuration mode for SIP phones.
|
show voice register pool remote
To display the details of phones that are at a remote location, use the show voice register pool remote command in privileged EXEC mode.
show voice register pool remote
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of the phones that are at remote location and do not have an address resolution protocol (ARP) entry.If the pool id is MAC or IP, the entire pool detail is displayed in a brief format. If the pool id is network, only the line details with remote contact IP address are displayed. In Cisco Unified SRST, if the pool id is IP and if the pool is not registered, the configured IP is checked to see if it is a remote IP.
Examples
Cisco Unified CME
The following is a sample output from this command displaying information for remote phones:
Router# show voice register pool remote
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
1 001B.535C.D410 8.3.3.111 1 1 45111 REGISTERED
3 8 UNREGISTERED
4 7 451110 UNREGISTERED
2 8.3.3.112 1 2 45112 REGISTERED
3 8.3.0.0 1 3 45113 REGISTERED
Cisco Unified SRST
The following is a sample output from this command displaying information for remote phones:
Router# show voice register pool remote
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
1 001B.535C.D410 8.33.33.111 1 1 45111 REGISTERED
3 8 UNREGISTERED
4 7 451110 UNREGISTERED
2 8.33.33.112 8.33.33.112 1 2 45112 REGISTERED
3 8.3.0.0 8.3.44.116 1 3 45113 REGISTERED
Table 59 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 67 show voice register pool telephone number field descriptions
Field
|
Description
|
DN
|
Directory number of the phone.
|
ID
|
Phone identification (ID) address.
|
IP Address
|
IP address and port number of the phones
|
LN
|
Line number of the phone.
|
Number
|
Number of the phones.
|
Pool
|
Shows the current pool.
|
State
|
Registration state.
|
Related Commands
Command
|
Description
|
show voice register all
|
Displays all Cisco SIP SRST and Cisco CME configurations and register information.
|
show voice register dial-peer
|
Displays details of all dynamically created VoIP dial peers associated with the Cisco SIP SRST or Cisco CME register event.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
voice register pool
|
Enters voice register pool configuration mode for SIP phones.
|
show voice register pool ringing
To display the details of phones that are currently in ringing state, use the show voice register pool ringing command in privileged EXEC mode.
show voice register pool ringing [brief]
Syntax Description
brief
|
(Optional) Displays brief details of SIP phones that are currently in ringing state.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of the phone that are currently in ringing state. When used with the brief keyword, the show voice register pool ringing brief command only displays information related to calls that are bound towards the SIP phones.
Examples
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying information for phones ringing in a voice register pool:
Router# show voice register pool ringing brief
Pool IP Address Number Remote Number
==== =============== ==================== ====================
2 8.33.33.112 45112 45111
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying information for phones ringing in a voice register pool:
Router# show voice register pool ringing
Pool tag: 2
==============
MAC Address : 0015.C68E.6D13
Contact IP : 8.33.33.112
Phone Number : 45112
Remote Number : 45111
Call 1
SIP Call ID : C0B5DA7-ADA311DE-8011803A-FF3E4CBC@8.3.3.5
State of the call : STATE_RECD_PROCEEDING (4)
Substate of the call : SUBSTATE_PROCEEDING_PROCEEDING (2)
Calling Number : 45111
Called Number : 45112
Bit Flags : 0xC00018 0x100 0x280
CC Call ID : 5
Source IP Address (Sig ): 8.3.3.5
Destn SIP Req Addr:Port : [8.33.33.112]:5060
Destn SIP Resp Addr:Port: [8.33.33.112]:5060
Destination Name : 8.33.33.112
Number of Media Streams : 1
Number of Active Streams: 1
RTP Fork Object : 0x0
Media Mode : flow-through
Media Stream 1
State of the stream : STREAM_ACTIVE
Stream Call ID : 5
Stream Type : voice+dtmf (1)
Stream Media Addr Type : 1
Negotiated Codec : No Codec (0 bytes)
Codec Payload Type : 255 (None)
Negotiated Dtmf-relay : inband-voice
Dtmf-relay Payload Type : 0
QoS ID : -1
Local QoS Strength : BestEffort
Negotiated QoS Strength : BestEffort
Negotiated QoS Direction : None
Local QoS Status : None
Media Source IP Addr:Port: [8.3.3.5]:16882
Related Commands
Command
|
Description
|
show sip-ua calls
|
Displays active user agent client (UAC) and user agent server (UAS) information on SIP calls
|
show voice register all
|
Displays all Cisco SIP SRST and Cisco CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool telephone-number
To display the details of a phone line with a specific telephone-number, use the show voice register pool telephone-number command in privileged EXEC mode.
show voice register pool telephone-number number
Syntax Description
number
|
Number identifying a specific phone.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of the phone line with the specified telephone-number. If the line is registered, the contact ip address will be displayed. When the phone line is not registered and the pool ID type is network IP, the IP address is not displayed. When the phone line is not registered but some other line is registered for the same pool with MAC or IP address, then the IP address is displayed.
Examples
Cisco Unified CME
The following is a sample output from this command displaying all statistical information:
Router# show voice register pool telephone number 45112
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
2 0015.C68E.6D13 1 2 45112 UNREGISTERED
7 0018.BAC8.D2B1 1 2 45112 UNREGISTERED
Cisco Unified SRST
Router# show voice register pool telephone-number 1000
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
1 9.13.18.40 9.13.18.40 1 1 1000 REGISTERED
Table 59 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 68 show voice register pool telephone number field descriptions
Field
|
Description
|
DN
|
Directory number of the phone.
|
ID
|
Phone identification (ID) address.
|
IP Address
|
IP address and port number of the phones
|
LN
|
Line number of the phone.
|
Number
|
Number of the phones.
|
Pool
|
Shows the current pool.
|
State
|
Registration state.
|
Related Commands
Command
|
Description
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool detail all
|
Displays the details of all the pools defined in the system.
|
show voice register pool type
To display the details of voice register pools associated with a specific phone type, use the show voice register pool type command in privileged EXEC mode.
show voice register pool type type
Syntax Description
type
|
3911, 3951, 7905, 7906, 7911, 7912, 7940, 7941, 7941GE, 7942, 7945, 7960, 7961, 7961GE, 7962, 7965, 7970, 7971, 7975, ATA (Cisco SIP Phone ATA), CKEM (Cisco SIP Key Expansion Module), P100 (PingTel Xpressa 100), P600 (Polycom SoundPoint 600).
|
Command Modes
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1
|
This command was introduced.
|
15.2(4)M
|
Cisco Unified CME 9.1
|
This command was modified to add CKEM as a value for the type argument to display the details of voice register pools associated with all the phones configured with KEMs.
|
Usage Guidelines
Use the show voice register pool type command to display the details of voice register pools associated with a specific phone type.
The show voice register pool type command only takes the configured value of the phone type into consideration.
The CKEM value is available for Cisco Unified CME only and is not available for Cisco Unified SRST.
Examples
The following is a sample output of the show voice register pool type command for a Cisco Unified 7960 SIP IP phone, displaying all statistical information:
Router# show voice register pool type 7960
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
1 001B.535C.D410 8.3.3.111 1 1 45111 REGISTERED
2 0015.C68E.6D13 1 2 45112 UNREGISTERED
The following is a sample output of the show voice register pool type command, showing all the phones configured with KEMs:
Router# show voice register pool type CKEM
Pool ID IP Address Ln DN Number State
==== =============== =============== == === ==================== ============
4 B4A4.E328.4698 9.45.31.111 1 4 5589$ REGISTERED
Related Commands
Command
|
Description
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool unregistered
To display the details of the voice registration pools that do not have any phones registered, use the show voice register pool unregistered command in privileged EXEC mode.
show voice register pool unregistered
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
15.1(2)T
|
Cisco Unified CME 8.1 Cisco Unified SRST 8.1
|
This command was introduced.
|
Usage Guidelines
Use this command to display the details of the pools that do not have any active registrations. In Cisco Unified SRST, if multiple phones are trying to register through the same pool and if one phone successfully registers and the others do not, the pool is not considered as an unregistered pool, as it does have an active registration of the registered phone.
Examples
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying information for pools with no active registeration:
Router# show voice register pool unregistered
Pool Tag: 2
MAC Address : 0015.C68E.6D13
No. of attempts to register: 0
Unregister time :
Last register request time :
Reason for state unregister:
No registration request since last reboot/unregister
Pool Tag: 3
MAC Address : 0021.5553.8998
No. of attempts to register: 0
Unregister time :
Last register request time :
Reason for state unregister:
No registration request since last reboot/unregister
Pool Tag: 4
MAC Address : 8989.9867.8769
No. of attempts to register: 0
Unregister time :
Last register request time :
Reason for state unregister:
No registration request since last reboot/unregister
Related Commands
Command
|
Description
|
show voice register all
|
Displays all Cisco SIP SRST and Cisco CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool registered
|
Displays details of phones that sucessfully register to Cisco Unified CME or Cisco Unified SRST.
|
voice register pool
|
Enters voice register pool configuration mode for SIP phones.
|
show voice register profile
To display the content of configuration files that are in ASCII text format, use the show voice register profile command in privileged EXEC mode.
show voice register profile text tag
Syntax Description
tag
|
Unique identifier for voice register profile to be displayed. Range is 1-500.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
12.4(4)T
|
Cisco CME 3.4
|
This command was introduced.
|
Usage Guidelines
Use this command to display ASCII configuration files for the Cisco IP Phone 7905 and 7905G, Cisco IP Phone 7912 and 7912G, Cisco ATA-186, or Cisco ATA-188. To generate ASCII text files, use the file text command.
Examples
The following is sample output from this command displaying information in the configuration profile for voice register pool 4:
Router# show voice register profile text 4
Table 69 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 69 show voice register profile Field Descriptions
Field
|
Description
|
Attended Transfer
|
Setting of soft key for attended transfer in a SIP phone template as defined by using the transfer-attended command. "1" indicates that the soft key is enabled; "0" indicates that the soft key is disabled.
|
Auto Lookup
|
1 indicates that Auto Lookup is enabled. 0 indicates that it is disabled.
|
Blind Transfer
|
Setting of soft key for blind transfer in a SIP phone template as defined by using the transfer-blind command. "1" indicates that the soft key is enabled; "0" indicates that the soft key is disabled.
|
Call Waiting
|
Setting of the call-waiting option on a SIP phone as defined by using the call-waiting command. "1" indicates that the soft key is enabled; "0" indicates that the soft key is disabled.
|
Call Forward Number
|
Number to which incoming calls are forwarded
|
Conference
|
Setting of soft key for conference in a SIP phone template as defined by using the conference command. "1" indicates that the soft key is enabled; "0" indicates that the soft key is disabled.
|
Directories URL
|
1 indicates that the Directories feature button for the phone is enabled. 0 indicates that it is disabled.
|
NTPIP
|
IP address for the NTP source
|
Pool tag
|
Pool tag of the configuration file being requested.
|
SIP Reg On
|
1 indicates that the registration with external proxy server for the phone is enabled. 0 indicates that it is disabled.
|
UI Password
|
1 indicates that the UI password is enabled on the phone. 0 indicates that dit is disabled.
|
UID
|
Authenticatuion credential for SIP phone.
|
Use Login ID
|
1 indicates that "use login id" for phone is enabled. 0 indicates that it is disabled.
|
Related Commands
Command
|
Description
|
create profile (voice register global)
|
Generates the configuration profiles required for SIP phone.
|
file text (voice register global)
|
Generates ASCII text files for the Cisco IP Phone 7905 and 7905G, Cisco IP Phone 7912 and 79012G, Cisco ATA-186, or Cisco ATA-188.
|
reset (voice register global)
|
Performs a complete reboot of all SIP phones associated with a Cisco CME router.
|
voice register global
|
Enters voice register global configuration mode in order to set global parameters for all supported Cisco SIP phones in a Cisco CME or Cisco SIP SRST environment.
|
show voice register session-server
To display the call details of the registered session servers, use the show voice register session-server command in privileged EXEC mode.
show voice register session-server
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.4(22)T
|
This command was introduced in a release earlier than Cisco IOS Release 12.4(22)T.
|
Examples
The following is sample output from the show voice register session-server command:
Router# show voice register session-server
Feature server 2, keepalive 60, register-uri CISCO-80NVCGATW_1259887561000
Session reg_number 569, refID 9B2783C0
Route point voice_reg_pool 28 reg_number 570
Route point voice_reg_pool 9 reg_number 571
Route point voice_reg_pool 19 reg_number 572
Route point voice_reg_pool 22 reg_number 573
Subscription sub_id 1133, calledNumber 1242
Subscription sub_id 1135, calledNumber 1054
Subscription sub_id 1138, calledNumber 1155
Subscription sub_id 1140, calledNumber 1188
Subscription sub_id 1142, calledNumber 261
Subscription sub_id 1146, calledNumber 1055
Subscription sub_id 1147, calledNumber 1100
Subscription sub_id 1149, calledNumber 1025
Subscription sub_id 1152, calledNumber 264
Subscription sub_id 1154, calledNumber 267
Subscription sub_id 1156, calledNumber 1185
Subscription sub_id 1157, calledNumber 1218
Subscription sub_id 1160, calledNumber 1056
Subscription sub_id 1161, calledNumber 263
Subscription sub_id 1163, calledNumber 1186
Subscription sub_id 1165, calledNumber 1243
Subscription sub_id 1167, calledNumber 1053
Subscription sub_id 1169, calledNumber 1120
Subscription sub_id 1171, calledNumber 1154
Subscription sub_id 1173, calledNumber 265
Table 70 describes the significant fields shown in this output.
Table 70 show voice register session-server Field Descriptions
Field
|
Definition
|
Feature server
|
The number of active feature servers.
|
keepalive
|
Interval, in seconds, at which the peer sends keepalive messages. The range is from 1 to 60 seconds. The default is 60 seconds.
|
register-uri
|
The registered Uniform Resource Identifier (URI) for the server.
|
Session reg_number
|
The registered number of the session.
|
Route point voice_reg_pool
|
Denotes the registered virtual device for application redirection.
|
Subscription sub_id
|
The subidentification number of the subscription.
|
show voice register statistics
To display statistics associated with the registration event, use the show voice register statistics command in privileged EXEC mode.
show voice register statistics [global | pool tag]
Syntax Description
global
|
(Optional) Displays aggregate statistics associated with the SIP phone registration event.
|
pool tag
|
(Optional) Displays registration pool statistics associated with a specific pool tag. The maximum number of pools is version and platform dependent. Type ? to display a list of values.
|
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.2(15)ZJ
|
Cisco SIP SRST 3.0
|
This command was introduced.
|
12.3(4)T
|
Cisco SIP SRST 3.0
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
12.4(4)T
|
Cisco CME 3.4 Cisco SIP SRST 3.4
|
This command was added to Cisco CME.
|
15.1(2)T
|
Cisco CME 8.1 Cisco SIP SRST 8.1
|
This command was modified. The global and pool keywords and tag argument were added. The output display was also modified to show more information about pools in unregistered state and time-stamps of registration event.
|
Usage Guidelines
When using the show voice register statistics command, you can verify that the number of Registration and unRegister successes for global statistics are the sum of the values in the individual pools. Because some Registrations fail even before matching a voice register pool, for Registration and unRegister failed statistics the value is not the sum of the values in the individual pools. Immediate failures are accounted in the global statistics.
In Cisco Unified CME 8.1 and Cisco Unified SIP SRST 8.1, the time-stamps for the events is displayed along with other registration related statistics. The command output also displays the reason for pools in unregistered state. Use the show voice register statistics command with pool tag keyword to display registration pool statistics associated with a specific pool.
When using the global keyword, the show voice register command output displays the aggregate statistics associated with SIP phone registration. The output of this command also displays the attempted-registrations table.
Examples
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying all statistical information:
Router# show voice register statistics
Total SIP phones registered: 2
Total Registration Statistics
Registration requests : 3
after last unregister : 1
Last Register Request Time : *11:42:31.783 UTC Wed Sep 16 2009
Last Unregister Request Time :
Register Success Time : *11:11:56.707 UTC Wed Sep 16 2009
Unregister Success Time :
Register pool 1 statistics
Total SIP phones registered: 1
Total Registration Statistics
Registration requests : 1
after last unregister : 0
Last Register Request Time : *11:11:54.615 UTC Wed Sep 16 2009
Last Unregister Request Time :
Register Success Time : *11:11:54.623 UTC Wed Sep 16 2009
Unregister Success Time :
Register pool 2 statistics
Total SIP phones registered: 1
Total Registration Statistics
Registration requests : 1
after last unregister : 0
Last Register Request Time : *11:11:56.707 UTC Wed Sep 16 2009
Last Unregister Request Time :
Register Success Time : *11:11:56.707 UTC Wed Sep 16 2009
Unregister Success Time :
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying all statistical information:
Router# show voice register statistics global
Global Statistics:
Active registrations : 1
Total SIP phones registered: 2
Total Registration Statistics
R egistration requests : 97715
Registration success : 3
Registration failed : 97712
unRegister requests : 1
unRegister success : 1
unRegister failed : 0
Attempts to register
after last unregister : 97712
Last register request time : *06:45:11.127 UTC Wed Oct 14 2009
Last unregister request time : *11:56:22.179 UTC Tue Oct 13 2009
Register success time : *12:10:37.263 UTC Tue Oct 13 2009
Unregister success time : *11:56:22.182 UTC Tue Oct 13 2009
Phones that have attempted registrations and have failed:
MAC address: 001b.535c.d410
IP address : 8.3.3.111
Attempts : 97712
Time of first attempt : *12:20:32.775 UTC Tue Oct 13 2009
Time of latest attempt: *06:46:14.815 UTC Wed Oct 14 2009
Reason for failure :
Unauthorized registration request
Cisco Unified CME and Cisco Unified SRST
The following is a sample output from this command displaying all statistical information associated with pool 1:
Router# show voice register statistics pool 1
Total SIP phones registered: 1
Total Registration Statistics
Registration requests : 2
after last unregister : 0
Last register request time : *12:10:37.259 UTC Tue Oct 13 2009
Last unregister request time : *11:56:22.179 UTC Tue Oct 13 2009
Register success time : *12:10:37.263 UTC Tue Oct 13 2009
Unregister success time : *11:56:22.182 UTC Tue Oct 13 2009
Reason for unregistered state:
No registration request since last reboot/unregister
Table 71 describes the significant fields shown in this output.
Table 71 show voice register statistics Field Descriptions
Field
|
Description
|
Statistics:
|
Used with the all, pool, and statistics keywords. Shows the registration statistics for this pool.
|
Active registrations
|
Used with the all, pool, and statistics keywords. Shows the current active registrations.
|
Last Register Request Time
|
Used with all, pool, and statistics keywords. Shows details such as day, date, and time when the phones requested to register the last time.
|
Last unRegister Request Time
|
Used with all, pool, and statistics keywords. Shows details such as day, date, and time when the phones requested to unregister the last time.
|
Total Registration Statistics
|
Used with the all, pool, and statistics keywords. Shows the total registration statistics for this pool.
|
Registration requests
|
Used with the all, pool, and statistics keywords. Shows the incoming registration requests.
|
Registration success
|
Used with the all, pool, and statistics keywords. Shows the successful registrations.
|
Registration failed
|
Used with the all, pool, and statistics keywords. Shows the failed registrations.
|
unRegister requests
|
Used with the all, pool, and statistics keywords. Shows the incoming unregister/registration expire requests.
|
unRegister success
|
Used with the all, pool, and statistics keywords. Reports the number of successful unregisters.
|
unRegister failed
|
Used with the all, pool, and statistics keywords. Reports the number of failed unregisters.
|
Global statistics
|
Used with the statistics keyword. Details all active registrations.
|
Register pool number statistics
|
Used with the statistics keyword. Details specific pool statistics.
|
Related Commands
Command
|
Description
|
show voice register all
|
Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.
|
show voice register pool
|
Displays all configuration information associated with a particular voice register pool.
|
show voice register pool attempted-registrations
|
Displays the details of phones that attempt to register with Cisco Unified CME or Cisco Unified SRST and fail.
|
show voice register template
To display all configuration information associated with a Cisco Unified SIP IP phone template, use the show voice register template command in privileged EXEC mode.
show voice register template {template-tag | all}
Syntax Description
template-tag
|
Number of the template for which to display information. Range is 1 to 5.
|
all
|
Displays all configuration information associated with all the Cisco Unified SIP IP phone templates.
|
Command Modes
Privileged EXEC (#)
Command History
Cisco IOS Release
|
Version
|
Modification
|
12.4(4)T
|
Cisco CME 3.4
|
This command was introduced.
|
12.4(15)XY
|
Cisco Unified CME 4.2(1)
|
This command was modified to include emergency response location (ERL) information assigned to a Cisco Unified SIP IP phone in the output display.
|
12.4(20)T
|
Cisco Unified CME 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
15.0(1)XA
|
Cisco Unified CME 8.0
|
This command was modified to include logical partitioning class of restriction (LPCOR) information in the output display.
|
15.1(1)T
|
Cisco Unified CME 8.0
|
This command was integrated into Cisco IOS Release 15.1(1)T.
|
15.1(2)T
|
Cisco Unified CME 8.1
|
This command was modified. All keyword was added. Pools that have the template defined are also displayed in the output. Voice-class stun-usage information is displayed in the output.
|
15.2(2)T
|
Cisco Unified CME 9.0
|
This command was modified to include conference admin, conference add mode, and conference drop mode in the output display.
|
Usage Guidelines
Use the show voice register template command to display all configuration information associated with a Cisco Unified SIP IP phone template defined in a system. Use the all keyword with the show voice register template command to display the details of all the templates defined in the system. A maximum of 10 templates can be configured and hence, the details of a maximum of 10 templates are displayed in the output.
Examples
The following is a sample output from the show voice register template command displaying information for a voice register template:
Router# show voice register template 1
Attended Transfer is enabled
Blind Transfer is enabled
Semi-attended Transfer is enabled
Caller-ID block is disabled
Anonymous call block is disabled
Voicemail is 56789, timeout 15
softkey connected Confrn Endcall Hold Trnsfer
softkey hold Newcall Resume
softkey idle Cfwdall Newcall Redial
softkey seized Cfwdall Endcall Redial
Emergency response location 6
Lpcor incoming sccp_phone1
Lpcor outgoing sccp_phone1
The following is a sample output from the show voice register template command displaying voice-class stun-usage information for voice register template 10:
Router# show voice register template 10
Attended Transfer is enabled
Blind Transfer is enabled
Semi-attended Transfer is enabled
Caller-ID block is disabled
Anonymous call block is disabled
softkey connected Park Confrn Endcall Hold Trnsfer
voice-class stun-usage is enabled. tag is 1
Pool 2 has this template configured
Pool 3 has this template configured
Pool 5 has this template configured
Pool 6 has this template configured
Pool 7 has this template configured
Pool 8 has this template configured
Pool 9 has this template configured
Pool 10 has this template configured
Pool 11 has this template configured
Pool 50 has this template configured
The following is a sample output from the show voice register template command. The output shows that a hardware conference administrator has been assigned, only the conference creator can add a new participant, and the conference creator can terminate the active video hardware conference by hanging up.
Router# show voice register template 5
Attended Transfer is enabled
Blind Transfer is enabled
Semi-attended Transfer is enabled
Conference softkey is enabled
Caller-ID block is disabled
Anonymous call block is disabled
conference add mode: creator
conference drop mode: creator
Table 72 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 72 show voice register template Field Descriptions
Field
|
Description
|
Anonymous call block
|
Status of anonymous caller blocking defined with the anonymous block command.
|
Attended Transfer
|
Status of attended transfer soft key defined with the transfer-attended command.
|
Blind Transfer
|
Status of blind transfer soft key defined with the transfer-blind command.
|
Caller-ID block
|
Status of caller-id feature defined with the caller-id block command.
|
Conference
|
Status of conference soft key defined with the conference command.
|
Conference admin
|
Shows whether the Cisco Unified SIP IP phone is assigned as the hardware conference administrator or not.
|
Conference add mode
|
Current setting of hardware conference privilege for adding participants.
|
Conference drop mode
|
Shows who can terminate an active ad-hoc hardware conference by hanging up.
|
Config:
|
List of configuration options defined for this template.
|
Dnd controls
|
Status of Do-Not-Disturb soft key defined with the dnd-control command.
|
Emergency response location
|
The ephone's emergency response location to which an emergency response team is dispatched when an emergency call is made.
|
Lpcor incoming
|
Setting of the lpcor incoming command.
|
Lpcor outgoing
|
Setting of the lpcor outgoing command.
|
Lpcor type
|
Setting of the lpcor type command.
|
Temp Tag
|
Tag number of the requested template.
|
VAD
|
Status of voice activity detection defined with the vad command.
|
Voicemail
|
Voice-mail extension and timeout value defined with the voice-mail command.
|
Related Commands
Command
|
Description
|
show voice register all
|
Displays all voice register information, including statistics, pools, and dial peers.
|
voice register template
|
Enters voice register template configuration mode and defines a template of common parameters for Cisco Unified SIP IP phones.
|
show voice register tftp-bind
To display the current configuration files accessible to SIP phones, use the show voice register tftp-bind command in privileged EXEC mode.
show voice register tftp-bind
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Cisco IOS Release
|
Version
|
Modification
|
12.4(4)T
|
Cisco CME 3.4
|
This command was introduced.
|
Usage Guidelines
This command provides a list of configuration files that are accessible to SIP phones using TFTP.
Examples
The following is sample output from this command:
Router(config)# show voice register tftp-bind
tftp-server SIPDefault.cnf url system:/cme/sipphone/SIPDefault.cnf
tftp-server syncinfo.xml url system:/cme/sipphone/syncinfo.xml
tftp-server SIP0009B7F7532E.cnf url system:/cme/sipphone/SIP0009B7F7532E.cnf
tftp-server SIP000ED7DF7932.cnf url system:/cme/sipphone/SIP000ED7DF7932.cnf
tftp-server SIP0012D9EDE0AA.cnf url system:/cme/sipphone/SIP0012D9EDE0AA.cnf
tftp-server gk123456789012 url system:/cme/sipphone/gk123456789012
tftp-server gk123456789012.txt url system:/cme/sipphone/gk123456789012.txt
Table 73 contains descriptions of significant fields shown in this output, listed in alphabetical order.
Table 73 show voice register tftp-bind Field Descriptions
Field
|
Description
|
ata<mac-address>
|
Cisco SIP configuration profile for a particular Cisco ATA-186 or Cisco ATA-188 as indicated by the <mac-address>. This file is generated by using the create profile command.
|
ata<mac-address>.txt
|
ASCII text file of a Cisco SIP configuration profile for a particular Cisco ATA-186 or Cisco ATA-188 as indicated by the <mac-address>. This file is generated by using the file text command.
|
gk<mac-address>
|
Cisco SIP configuration profile for a particular Cisco IP Phone 7912 or Cisco IP Phone 7912G as indicated by the <mac-address>. This file is generated by using the create profile command.
|
gk<mac>.txt
|
ASCII text file of a Cisco SIP configuration profile for a particular Cisco IP Phone 7912 or Cisco IP Phone 7912G as indicated by the <mac-address>. This file is generated by using the file text command.
|
Id<mac-address>
|
Cisco SIP configuration profile for a particular Cisco IP Phone 7905 or Cisco IP Phone 7912G as indicated by the <mac-address>. This file is generated by using the create profile command.
|
Id<mac-address>.txt
|
ASCII text file of a Cisco SIP configuration profile for a particular Cisco IP Phone 7905 or Cisco IP Phone 7912G as indicated by the <mac-address>. This file is generated by using the file text command.
|
SIPDefault.cnf
|
Configuration file to be shared by all Cisco SIP IP Phone 7940s and Cisco SIP IP Phone 7960s. This file is automatically generated by the router through the source-address and is placed in router memory. The SIPDefault.cnf file contains the IP address that the phones use to register for service, using the Session Initiation Protocol (SIP).
|
SIP<mac-address>.cnf
|
Cisco SIP configuration profile for a particular Cisco IP Phone 7940 or Cisco IP Phone 7960 as indicated by the <mac-address>. This file is generated by using the create profile command.
|
syncinfo.xml
|
Configuration file to be shared by all Cisco SIP IP Phone 7940s and Cisco SIP IP Phone 7960s. This file is generated by using the create profile command.
|
Related Commands
| |
Description
|
create profile (voice register global)
|
Generates the configuration profiles required for SIP phones.
|
reset (voice register dn)
|
Performs a complete reboot of one phone associated with a Cisco CME router.
|
reset (voice register pool)
|
Performs a complete reboot of one or all phones associated with a Cisco CME router.
|
text file (voice register global)
|
Generates an ASCII format text file of the Cisco SIP configuration profile for Cisco IP Phone 7905s and 7905Gs, Cisco IP phone 7912s and 7912Gs, Cisco ATA-186s, and Cisco ATA-188s.
|
tftp-path (voice register global)
|
Specifies the directory to which the provisioning file for SIP phones in a Cisco CallManager Express (Cisco CME) system will be written.
|
voice register global
|
Enters voice register global configuration mode in order to set global parameters for all supported Cisco SIP phones in a Cisco CME or Cisco SIP SRST environment.
|
show voice hunt-group
To display configuration information associated with one or all voice hunt groups in a Cisco Unified Communications Manager Express (Cisco Unified CME) system, use the show voice hunt-group command in privileged EXEC mode.
show voice hunt-group hunt-group-tag [brief] {longest-idle | parallel | peer | sequential}
Syntax Description
hunt-group-tag
|
(Optional) Unique sequence number that identifies the voice hunt group. Range is 1 to 100.
|
brief
|
(Optional) Displays brief information on all voice hunt groups in a Cisco CME system.
|
longest-idle
|
(Optional) Displays summary of longest-idle voice hunt groups.
|
parallel
|
(Optional) Displays summary of parallel voice hunt groups.
|
peer
|
(Optional) Displays summary of peer voice hunt groups.
|
sequential
|
(Optional) Displays summary of sequential voice hunt groups.
|
Command Modes
Privileged EXEC (# )
Command History
Release
|
Modification
|
12.4(24)T
|
This command was introduced in a release earlier than Cisco IOS Release 12.4(24)T.
|
15.2(2)T
|
This command was modified to add stat collect as a field.
|
Usage Guidelines
Use the show voice hunt-group command to get information about voice hunt group configuration on the gateway as an alternative to the show running-config command.
Use the show voice hunt-group and show voice hunt-group brief commands to display hunt group configuration information for all voice hunt groups in a Cisco Unified CME system. Use show voice hunt-group hunt-group-tag to display data on a specific hunt-tag configuration created by the voice hunt-group command. Use the longest-idle, parallel, peer, or sequential keywords to display data on a specific type of voice hunt group configuration created by the voice hunt-group command.
Examples
The following is a sample output from the show voice hunt-group command, displaying all voice hunt groups configured on the router:
Router# show voice hunt-group
pilot number: 3, peer-tag 2147483647
secondary number: 4, peer-tag 2147483646
The following is a sample output from the show voice hunt-group command, displaying the configuration for all the configured voice hunt groups:
Router# show voice hunt-group
pilot number: 1234, peer-tag 1234
list of numbers: 9498889994,9498889993,
secondary number: 5678, peer-tag 5678
pilot number: 6666, peer-tag 6666
list of numbers: 5106575902,4088531111,4083911375,4089306067,8869395033,88686619633
pilot number: 7777777, peer-tag 7777777
secondary number: 88888888, peer-tag 88888888
list of numbers: 7654321,87654321,987654321,
pilot number: 56789, peer-tag 56789
list of numbers: 87654321,9876,87654,
The following is a sample output from the show voice hunt-group command, displaying information for a particular voice hunt group as specified by the hunt-group-tag number:
Router# show voice hunt-group 5
pilot number: 1234, peer-tag 1234
secondary number: 5678, peer-tag 5678
list of numbers: 9498889994,9498889993,
The following is a sample output from the show voice hunt-group command, displaying information about all the voice hunt groups of a particular type:
Router# show voice hunt-group longest-idle
pilot number: 6666, peer-tag 6666
list of numbers: 5106575902,4088531111,4083911375,4089306067,8869395033,88686619633,
pilot number: 7777777, peer-tag 7777777
secondary number: 88888888, peer-tag 88888888
list of numbers: 7654321,87654321,987654321,
The following is a sample output from the show voice hunt-group command with the keyword brief:
Router# show voice hunt-group brief
=== ==== ======== =====================================================
5 PAR 1234 9498889-, 9498889-
8 LON 6666 5106575-, 4088531-, 4083911-, 4089306-, 8869395-,.....
10 LON 7777777 7654321, 8765432-, 9876543-
8888888- 7654321, 8765432-, 9876543-
15 PER 56789 8765432-, 9876, 87654
The following is a sample output from the show voice hunt-group command, indicating that call statistics is being collected:
Router# show voice hunt-group 1
pilot number: 5000, peer-tag 2147483647
list of numbers: 5001,5002,5011,5012,
The following is a sample output from the show voice hunt-group command when there is no voice hunt group configured:
Router# show voice hunt-group
no voice hunt-groups configured
Router# show voice hunt-group brief
no voice hunt-groups configured
Router# show voice hunt-group longest-idle
no voice hunt-groups configured
Table 74 describes the significant fields shown in the output.
Table 74 show voice hunt-group Field Descriptions
Field
|
Description
|
Group
|
Tag number of voice hunt group.
|
type
|
Type of voice hunt group. The available voice hunt group types are: longest-idle, parallel, peer and sequential.
|
pilot number
|
Number that callers dial to reach the specified voice hunt group.
|
secondary-number
|
Alternate number for the specified voice hunt group.
|
list of numbers
|
Numbers of the extensions configured in the voice hunt-group command`s hunt-tag identifier.
|
preference
|
Preference order for the extension or telephone number associated with a dial peer. Range is 0 to 8. Default is 0.
|
preference (sec)
|
Preference order for the secondary pilot number. Range is from 0 to 10, where 0 is the highest preference and 10 is the lowest preference. Default is 9.
|
timeout
|
Number of seconds after which a call that is not answered at one number is redirected to the next number in the hunt group list.
|
final_number
|
Last number in the voice hunt group, after which a call is no longer redirected.
|
hops
|
Number of hops before a call proceeds to the final number.
|
stat collect
|
Yes indicates that call statistics are being collected for a voice hunt group.
|
peer-tag
|
Peer hunting tag.
|
Related Commands
Command
|
Description
|
final (voice hunt-group)
|
Defines the last extension in a voice hunt group.
|
hops (voice hunt-group)
|
Defines the number of times that a call is redirected to the next directory number in a peer voice hunt group list before proceeding to the final directory number.
|
list (voice hunt-group)
|
Defines the directory numbers that participate in a directory number hunt group.
|
pilot (voice hunt-group)
|
Defines the voice dn that callers dial to reach a Cisco Unified Communications Manager Express (Cisco Unified CME) voice hunt group.
|
timeout (voice hunt-group)
|
Sets the number of seconds after which a call that is not answered is redirected to the next number in the hunt-group list and defines the last directory number in the hunt group.
|
voice hunt-group
|
Configures voice hunt groups and the associated parameters.
|
shutdown(telephony-service)
To shut down the Skinny Client Control Protocol (SCCP) server listening socket, use the shutdown command in telephony-service configuration mode. To enable service, use the no form of this command.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Command Default
No shutdown is enabled
Command Modes
Telephony-service configuration (config-telephony)
Group configuration (conf-tele-group)
Call-manager-fallback configuration (config-ccm-fallback)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(1)T
|
Cisco Unified CME 8.0 Cisco Unified SRST 8.0
|
This command was introduced
|
Usage Guidelines
The shutdown command allows you to shut down the SCCP server listening sockets when you want to change or remove the IP address set up on your system. For example, If you have IPv6 address and you want to change the IP address set up to dual stack (IPv4 and IPv6) you can use the shutdown command.
Examples
The following example shows SCCP server listening sockets being shut down under telephony- service.
Router(config-telephony)#shut down
The following example shows SCCP server listening sockets being shut down for group 2 (under group mode) in telephony service.
Router(config-telephony)#group 2
Router(conf-tele-group)#shutdown
The following example shows SCCP server listening sockets being shut down under call-manager-fallback mode.
Router(config-telephony)#group 2
Router(conf-cm-fallback)#shutdown
Related Commands
Command
|
Description
|
protocol -mode
|
Allows you to configure a preferred IP address mode for SCCP IP phones.
|
ip source address
|
Identifies the IP address and port through which IP phones communicate with a Cisco Unified CME router.
|
snr
To enable Single Number Reach (SNR) on an extension of an SCCP IP phone, use the snr command in ephone-dn configuration mode. To disable SNR on the extension, use the no form of this command.
snr e164-number delay seconds timeout seconds [cfwd-noan extension-number]
no snr
Syntax Description
e164-number
|
E.164 telephone number to ring if IP phone extension does not answer.
|
delay seconds
|
Sets the number of seconds that the call rings the IP phone before ringing the remote phone. Range: 0 to 10. Default: disabled.
|
timeout seconds
|
Sets the number of seconds that the call rings after the configured delay. Call continues to ring for this length of time on the IP phone even if the remote phone answers the call. Range: 5 to 60. Default: disabled.
|
cfwd-noan extension-number
|
(Optional) Forwards the call to this target number if the phone does not answer after both the delay and timeout seconds have expired. This is typically the voice mail number.
Note This option is not supported for calls from FXO trunks because the calls connect immediately.
|
Command Default
Single Number Reach is not enabled on the extension.
Command Modes
Ephone-dn configuration (config-ephone-dn)
Command History
Release
|
Cisco Product
|
Modification
|
12.4(22)YB
|
Cisco Unified CME 7.1
|
This command was introduced.
|
12.4(24)T
|
Cisco UnifiedCME 7.1
|
This command was integrated into Cisco IOS Release 12.4(24)T.
|
Usage Guidelines
This command enables the SNR feature on the extension. The SNR feature allows users to answer incoming calls on their desktop IP phone or at a remote destination and to pick up in-progress calls on the desktop phone or the remote destination without losing the connection. If an incoming call to this extension is answered immediately, the call is treated as a normal call.
If the call is not answered within the number of seconds set with the delay keyword, Cisco Unified CME rings the remote number while continuing to ring the SNR extension. If the call is answered by the desktop IP phone within the number of seconds set with the timeout keyword, the call to the remote number is disconnected. If the call is answered on the IP phone, the user can send the call to the remote phone by pressing the Mobility soft key.
If the call is not answered by the IP phone within the number of seconds set with the timeout keyword, the ringing call appearance on the IP phone is deleted. This call is marked as hold state on the IP phone. If the user answers the call on the remote phone, the user can pull back the call to the IP phone by pressing the Resume soft-key.
Examples
The following example shows extension 1001 is enabled for SNR. After a call rings at this number for 5 seconds, the call also rings at the remote number 4085550133. The call continues ringing on both phones for 15 seconds. If the call is not answered after a total of 20 seconds, the call no longer rings and is forwarded to the voice-mail number 2001.
ephone-dn 10
number 1001
mobility
snr 4085550133 delay 5 timeout 15 cfwd-noan 2001
Related Commands
Command
|
Description
|
mobility
|
Enables the Mobility feature on an extension of an SCCP IP phone.
|
number
|
Associates a telephone or extension number with an ephone-dn.
|
softkeys connected
|
Modifies the order and type of soft keys that display on an IP phone during the connected call state.
|
softkeys idle
|
Modifies the order and type of soft keys that display on an IP phone during the idle call state.
|
snr answer-too-soon
To set the SNR answer to soon timer, use the snr answer-too-soon command in ephone-dn mode. To reset the default, use the no form of the command.
snr answer-too-soon time
no snr answer-too-soon
Syntax Description
time
|
Time, in seconds. Range: 1 to 5.
|
Command Default
No answer too soon timer is set.
Command Modes
Ephone-dn configuration (config-ephone-dn)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(3)T
|
Cisco Unified CME 8.5
|
This command was introduced.
|
Usage Guidelines
Use this command to enable timer for answering the call on an SNR mobile phone. You can set a timer from 1 to 5 seconds. If the call is answered within the timer, the mobile leg is disconnected.
Examples
Router(config)ephone-dn 10
Router(config-ephone-dn)#snr answer-too-soon 4
Related Commands
Command
|
Description
|
snr
|
Enables SNR on the extension of an SCCP IP phone.
|
snr answer-too-soon (voice register dn)
To set the time in which Single Number Reach (SNR) calls are prevented from being diverted to the voice mailbox of a mobile phone, use the snr answer-too-soon command in voice register dn configuration mode. To allow SNR calls to be diverted to the voice mailbox, use the no form of the command.
snr answer-too-soon time
no snr answer-too-soon
Syntax Description
time
|
Time, in seconds. Range: 1 to 5.
|
Command Default
No answer-too-soon time is set. Calls may be diverted to the voice mailbox when a user's mobile phone is not answered or is turned off.
Command Modes
Voice register dn configuration (config-register-dn)
Command History
Release
|
Modification
|
15.2(2)T
|
This command was introduced.
|
Usage Guidelines
Use the snr answer-too-soon command to set the time in which SNR calls are prevented from being diverted to the voice mailbox of a mobile phone. When the call is diverted to the voice mailbox within the set time, the mobile phone call leg is disconnected.
Examples
The following example shows how SNR calls are prevented from being diverted to the voice mailbox of a mobile phone for 2 seconds:
Router(config)# voice register dn 3
Router(config-register-dn)# number 1004
Router(config-register-dn)# name John Smith
Router(config-register-dn)# mobility
Router(config-register-dn)# snr calling-number local
Router(config-register-dn)# snr 9900 delay 1 timeout 10
Router(config-register-dn)# snr ring-stop
Router(config-register-dn)# snr answer-too-soon 2
Related Commands
Command
|
Description
|
snr (voice register dn)
|
Enables the SNR feature on an extension of a Cisco Unified SIP IP phone.
|
snr calling-number local
To replace the calling-party number with the single number reach (SNR) extension number in calls forwarded to the remote phone, use the snr calling-number local command in ephone-dn configuration mode. To reset to the default, use the no form of this command.
snr calling-number local
no snr calling-number local
Syntax Description
This command has no arguments or keywords.
Command Default
Calling-party number is not replaced.
Command Modes
Ephone-dn configuration (config-ephone-dn)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.0(1)XA
|
Cisco Unified CME 8.0
|
This command was introduced.
|
15.1(1)T
|
Cisco Unified CME 8.0
|
This command was integrated into Cisco IOS Release 15.1(1)T.
|
Usage Guidelines
This command replaces the original calling party number with the SNR extension number (local number) in the caller ID display for SNR calls forwarded to the remote phone. When the call is forwarded to the remote phone, such as a mobile phone, the caller ID shows the SNR number that the caller dialed, not the number of the original calling party.
Examples
The following example shows that the original calling party number is replaced by the SNR extension number 1234 when the call is forwarded to the mobile phone:
ephone-dn 1
number 1234
mobility
snr 4085550123 delay 5 timeout 15 cfwd-noan 2001
snr calling-number local
Related Commands
Command
|
Description
|
calling-number local
|
Replaces a calling-party number and name with the forwarding-party number and name for all calls.
|
mobility
|
Enables the Mobility feature on an extension of an SCCP IP phone.
|
snr
|
Enables SNR on the extension of an SCCP IP phone.
|
snr calling-number local (voice register dn)
To replace the calling party number displayed on the configured mobile phone with the local Single Number Reach (SNR) number, use the snr calling-number local command in voice register dn configuration mode. To return to the default, use the no form of this command.
snr calling-number local
no snr calling-number local
Syntax Description
This command has no arguments or keywords.
Command Default
The number of the calling party is displayed on the mobile phone configured to receive SNR calls.
Command Modes
Voice register dn configuration (config-register-dn)
Command History
Release
|
Modification
|
15.2(2)T
|
This command was introduced.
|
Examples
The following example shows how the snr calling-number local command is used to display the local SNR number instead of the calling party's number on the mobile phone:
Router(config)# voice register dn 3
Router(config-register-dn)# number 1004
Router(config-register-dn)# name John Smith
Router(config-register-dn)# mobility
Router(config-register-dn)# snr calling-number local
Router(config-register-dn)# snr 9900 delay 1 timeout 10
Router(config-register-dn)# snr ring-stop
Router(config-register-dn)# snr answer-too-soon 2
Related Commands
Command
|
Description
|
snr (voice register dn)
|
Enables the SNR feature on an extension of a Cisco Unified SIP IP phone.
|
snr mode
To set the mode for the Single Number Reach (SNR) directory number (DN), use the snr mode command in ephone-dn configuration mode. To return to the default, use the no form of this command.
snr mode [virtual]
no snr mode
Syntax Description
virtual
|
Enables the virtual mode for an SNR DN when it is unregistered or floating.
Note Virtual mode is activated when the DN state remains up when it should be in the down state.
|
Command Default
No DN mode is set for the SNR feature.
Command Modes
Ephone-dn configuration (config-ephone-dn)
Command History
Release
|
Modification
|
15.2(2)T
|
This command was introduced.
|
Usage Guidelines
A virtual SNR DN is a DN not associated with any registered phone but is a number that can be called, have its calls forwarded to a preconfigured mobile phone, or put on an Auto Hold state when the mobile phone answers the call or the time delay is reached. In the Auto Hold state, the DN can either be floating or unregistered. A floating DN is a DN not configured with any phone while an unregistered DN is one associated with phones not registered to a Cisco Unified CME system.
A ringback tone is heard when a call is made to a virtual DN.
To enable the SNR feature, the SNR DN must be in the up state, the Mobility feature must be enabled, and the time delay or timeout value configured with the snr command must be reached.
Examples
The following example sets the virtual DN mode for SNR on ephone-dn 1:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# snr mode virtual
Related Commands
Command
|
Description
|
ephone-dn
|
Enters ephone-dn configuration mode to configure a DN for an IP phone line, intercom line, paging line, voice-mail port, or MWI.
|
snr
|
Enables SNR on an extension of a Cisco Unified SCCP IP phone.
|
snr ring-stop
To stop the IP phone from ringing after the SNR call is answered on a mobile phone, use the snr ring-stop command in ephone-dn configuration mode. To reset the default value, use the no form of the command.
snr ring-stop
no snr ring-stop
Syntax Description
This command has no arguments or keywords.
Command Default
Phone continues to ring after the SNR call is answered on a mobile phone.
Command Modes
Ephone-dn configuration (conf-ephone-dn)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
15.1(3)T
|
Cisco Unified CME 8.5
|
This command was introduced.
|
Usage Guidelines
Use this command to stop the IP phone from ringing after the SNR call is answered on a mobile phone.
Examples
Router(config-ephone-dn)10
Router(config-ephone-dn)#snr ring-stop
Related Commands
Command
|
Description
|
snr
|
Enables SNR on the extension of an SCCP IP phone.
|
snr ring-stop (voice register dn)
To end the ringing on a Cisco Unified SIP IP phone after the Single Number Reach (SNR) call is answered on the configured mobile phone, use the snr ring-stop command in voice register dn configuration mode. To allow the Cisco Unified SIP IP phone to continue ringing even after the SNR call has been answered, use the no form of the command.
snr ring-stop
no snr ring-stop
Syntax Description
This command has no arguments or keywords.
Command Default
The Cisco Unified SIP IP phone continues to ring even after the SNR call is answered on a mobile phone.
Command Modes
Voice register dn configuration (config-register-dn)
Command History
Release
|
Modification
|
15.2(2)T
|
This command was introduced.
|
Examples
The following example shows how to end the ringing on a Cisco Unified SIP IP phone:
Router(config)# voice register dn 3
Router(config-register-dn)# number 1004
Router(config-register-dn)# name John Smith
Router(config-register-dn)# mobility
Router(config-register-dn)# snr calling-number local
Router(config-register-dn)# snr 9900 delay 1 timeout 10
Router(config-register-dn)# snr ring-stop
Router(config-register-dn)# snr answer-too-soon 2
Related Commands
Command
|
Description
|
snr (voice register dn)
|
Enables the SNR feature on an extension of a Cisco Unified SIP IP phone.
|
snr (voice register dn)
To enable the Single Number Reach (SNR) feature on an extension of a Cisco Unified SIP IP phone, use the snr command in voice register dn configuration mode. To disable the SNR feature on the extension, use the no form of the command.
snr e164-number delay seconds timeout seconds [cfwd-noan extension-number]
no snr
Syntax Description
e164-number
|
E.164 telephone number to call when the Cisco Unified SIP IP phone extension does not answer.
|
delay seconds
|
Sets the number of seconds that the Cisco Unified SIP IP phone rings when called. When the time delay is reached, the call is tranferred to the PSTN phone and the SNR directory number. Range: 0 to 30. Default: 5.
|
timeout seconds
|
Sets the number of seconds that the Cisco Unified SIP IP phone rings after the configured time delay. When the timeout value is reached, no call is displayed on the phone. You have to use the Resume soft key to pull back or the Mobility soft key to send the call to a mobile phone. Range: 30 to 60. Default: 60.
Note When the default is enabled, the Cisco Unified SIP IP phone continues to ring for 60 seconds even if the remote phone answers the call.
|
cfwd-noan extension-number
|
(Optional) Forwards the call to the extension number when the phone does not answer after both the time delay and timeout values are reached. The extension number is typically the voice mail number.
Note This option is not supported for calls from FXO trunks because the calls connect immediately.
|
Command Default
The SNR feature is not enabled on the extension of a Cisco Unified SIP IP phone.
Command Modes
Voice register dn configuration (config-register-dn)
Command History
Release
|
Modification
|
15.2(2)T
|
This command was introduced.
|
Usage Guidelines
Use the snr command to enable the SNR feature on an extension of a Cisco Unified SIP IP phone.
The SNR feature allows you to answer incoming calls on your desktop IP phones or at a remote destination. It also allows you to pick up in-progress calls on a desktop phone or at a remote destination without losing the connection. If an incoming call to the extension is answered immediately, the call is treated as a normal call.
If the call is not answered within the number of seconds set with the delay keyword, Cisco Unified CME rings the remote number while continuing to ring the SNR extension. If the call is answered by the desktop IP phone within the number of seconds set with the timeout keyword, the call to the remote number is disconnected. If the call is answered on the IP phone, you can send the call to the remote phone by pressing the Mobility soft key.
If the call is not answered by the IP phone within the number of seconds set with the timeout keyword, the call is dislayed on the IP phone as being in the hold state. If the user answers the call on the remote phone, the user can pull back the call to the IP phone by pressing the Resume soft key.
Examples
The following example shows that extension 1004 is enabled for SNR. After a call rings at this number for one second, the call also rings at the remote number 9900. The call continues ringing on both phones for 10 seconds. If the call is not answered after a total of 11 seconds, the call no longer rings and is forwarded to the voice-mail number 1007.
Router(config)# voice register dn 3
Router(config-register-dn)# number 1004
Router(config-register-dn)# name John Smith
Router(config-register-dn)# mobility
Router(config-register-dn)# snr calling-number local
Router(config-register-dn)# snr 9900 delay 1 timeout 10 cfwd-noan 1007
Router(config-register-dn)# snr ring-stop
Router(config-register-dn)# snr answer-too-soon 2
Related Commands
Command
|
Description
|
mobility (voice register dn)
|
Enables the Mobility feature on an extension of a Cisco Unified SIP IP phone.
|
snr answer-too-soon (voice register dn)
|
Sets the time in which SNR calls are prevented from being diverted to the voice mailbox of a mobile phone.
|
snr calling-number local (voice register dn)
|
Replaces the calling party number displayed on the configured mobile phone with the local SNR number.
|
snr ring-stop (voice register dn)
|
Ends the ringing on a Cisco Unified SIP IP phone after the Single SNR call is answered on the configured mobile phone.
|
softkeys alerting
To configure an ephone template for soft-key display during the alerting call stage, use the softkeys alerting command in ephone-template configuration mode. To remove a soft key alerting configuration, use the no form of this command.
softkeys alerting {[Acct] [Callback] [Endcall]}
no softkeys alerting
Syntax Description
Acct
|
(Optional) Soft-key name that appears on the IP phone during the alerting call stage. Short for "account code." Provides access to configured accounts.
|
Callback
|
(Optional) Soft-key name that appears on the IP phone during the alerting call stage. Requests callback notification when a busy called line becomes free.
|
Endcall
|
(Optional) Soft-key name that appears on the IP phone during the alerting call stage. Ends the current call.
|
Defaults
The default soft keys for the alerting call stage and the order in which they appear on IP phones are, from first to last, Acct, Callback, and Endcall.
Command Modes
Ephone-template configuration (config-ephone-template)
Command History
Cisco IOS Release
|
Cisco CME Version
|
Modification
|
12.3(11)T
|
3.2
|
This command was introduced.
|
Usage Guidelines
The alerting call stage is when the remote point is being notified of an incoming call, and the status of the remote point is being relayed to the caller as either ringback or busy.
The number and order of soft keys listed in the softkeys alerting correspond to the number and order of soft keys that will appear on IP phones.
Examples
In the following example, ephone template 1 is configured for the alerting stage and for the seized and connected call stages:
Router(config)# telephony-service
Router(config-telephony)# ephone-template 1
Router(config-ephone-template)# softkeys seized Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall
Related Commands
Command
|
Description
|
ephone-template (ephone)
|
Applies an ephone template to an ephone.
|
softkeys connected
|
Configures an ephone template for soft-key display during the connected call stage.
|
softkeys idle
|
Configures an ephone template for soft-key display during the idle call stage.
|
softkeys seized
|
Configures an ephone template for soft-key display during the seized call stage.
|
softkeys connected
To modify the order and type of soft keys that display on an IP phone during the connected call state, use the softkeys connected command in ephone-template configuration mode. To reset to the default, use the no form of this command.
softkeys connected {[Acct] [ConfList] [Confrn] [Endcall] [Flash] [HLog] [Hold] [Join]
[LiveRcd] [Mobility] [Park] [RmLstC] [Select] [TrnsfVM] [Trnsfer]}
no softkeys connected
Syntax Description
Acct
|
(Optional) Soft key that provides access to configured accounts.
|
ConfList
|
(Optional) Soft key that lists all parties in a conference.
|
Confrn
|
(Optional) Soft key that connects callers to a conference call.
|
Endcall
|
(Optional) Soft key that ends the current call.
|
Flash
|
(Optional) Soft key that provides hookflash functionality for public switched telephony network (PSTN) services on calls connected to the PSTN via a foreign exchange office (FXO) port. Also called "hookflash."
|
HLog
|
(Optional) Soft key that places a phone into not-ready status, in which it does not accept hunt-group calls. You must set the hunt-group logout command to HLog for this soft key to be visible. This key is a toggle; pressing it a second time returns the phone to ready status, in which it is available to receive calls.
|
Hold
|
(Optional) Soft key that places an active call on hold and resumes the call.
|
Join
|
(Optional) Soft key that joins an established call to conference.
|
LiveRcd
|
(Optional) Soft key that enables recording of a call.
|
Mobility
|
(Optional) Soft key that forwards the call to the PSTN number defined by the Single Number Reach (SNR) feature.
|
Park
|
(Optional) Soft key that places an active call on hold, so it can be retrieved from another phone in the system.
|
RmLstC
|
(Optional) Soft key that removes the last party added to the conference. This soft key only works for the conference creator.
|
Select
|
(Optional) Soft key that selects a call or a conference on which to take action.
|
TrnsfVM
|
(Optional) Soft key that transfers a call to a voice-mail extension number.
|
Trnsfer
|
(Optional) Soft key that transfers active calls to another extension.
|
Command Default
The default soft keys for the connected call state and the order in which they appear on IP phones are, from first to last:
•
With HLog support: Hold, EndCall, Trnsfer, Confrn, Acct, Flash, Park, HLog
•
Without HLog support: Hold, EndCall, Trnsfer, Confrn, Acct, Flash, Park
Command Modes
Ephone-template configuration (config-ephone-template)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.3(11)T
|
Cisco CME 3.2
|
This command was introduced.
|
12.4(4)XC
|
Cisco Unified CME 4.0
|
The HLog keyword was added.
|
12.4(11)XJ
|
Cisco Unified CME 4.1
|
The ConfList, Join, RmLstC, and Select keywords were added.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
12.4(15)XZ
|
Cisco Unified CME 4.3
|
The LiveRcd and TrnsfVM keywords were added.
|
12.4(20)T
|
Cisco Unified CME 7.0
|
This command with the LiveRcd and TrnsfVM keywords was integrated into Cisco IOS Release 12.4(20)T.
|
12.4(22)YB
|
Cisco Unified CME 7.1
|
The Mobility keyword was added.
|
12.4(24)T
|
Cisco UnifiedCME 7.1
|
This command was integrated into Cisco IOS Release 12.4(24)T.
|
Usage Guidelines
The connected call state is when the connection to a remote point has been established.
Configure the ConfList, Join, and RmLstC soft keys for conferencing functions. These soft keys are supported for hardware-based conferencing only and require the appropriate DSP farm configuration.
Note
The ConfList (including the Remove, Update, and Exit soft keys within the ConfList function) and RmLstC soft keys do not work on the Cisco Unified IP Phone 7902, 7935, and 7936.
Examples
In the following example, ephone template 1 modifies the soft keys displayed for the seized, alerting, and connected call states:
Router(config)# ephone-template 1
Router(config-ephone-template)# softkeys seized Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall
Related Commands
Command
|
Description
|
ephone
|
Enters ephone configuration mode for an IP phone.
|
ephone-template (ephone)
|
Applies an ephone template to an ephone.
|
fxo-hook-flash
|
Enables display of the Flash soft key.
|
hunt-group logout
|
Enables separate handling of DND and HLog functionality for hunt-group agents and the display of the HLog soft key on phones.
|
softkeys alerting
|
Modifies the soft-key display for the alerting call state.
|
softkeys idle
|
Modifies the soft-key display for the idle call state.
|
softkeys ringing
|
Modifies the soft-key display for the ringing call state.
|
softkeys seized
|
Modifies the soft-key display for the seized call state.
|
softkeys connected (voice register template)
To modify the soft key display during the connected call state on Cisco Unified SIP IP phones, use the softkeys connected command in voice register template configuration mode. To return to the default, use the no form of this command.
softkeys connected {[ConfList] [Confrn] [Endcall] [Hold] [Park] [RmLstC] [Trnsfer]
[iDivert]}
no softkeys connected
Syntax Description
ConfList
|
(Optional) Lists all the participants in a conference.
|
Confrn
|
(Optional) Connects callers to a conference call. This soft key also enables ad-hoc conference creators to initiate a conference.
|
Endcall
|
(Optional) Ends the current call.
|
Hold
|
(Optional) Places an active call on hold and resumes the call.
|
Park
|
(Optional) Places an active call on hold so it can be retrieved from another phone in the system.
|
RmLstC
|
(Optional) Removes the last conference participant.
|
Trnsfer
|
(Optional) Transfers active calls to another extension.
|
iDivert
|
(Optional) Immediately diverts a call to a voice-messaging system.
|
Command Default
The default soft keys for the connected call state and the order in which they appear on Cisco Unified SIP IP phones are, from first to last: ConfList, Confrn, Endcall, Hold, Park, RmLstC, Trnsfer, and iDivert.
Command Modes
Voice register template configuration (config-register-temp)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(11)XJ
|
Cisco Unified CME 4.1
|
This command was introduced.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
12.4(22)YB
|
Cisco Unified CME 7.1
|
The Park keyword was added.
|
15.1(3)T
|
Cisco Unified CME 8.5
|
The iDivert keword was added.
|
15.2(2)T
|
Cisco Unified CME 9.0
|
This command was modified. The syntax description for the Confrn soft key was updated. The ConfList and RmLastC keywords were added.
|
Usage Guidelines
The connected call state is when the connection to a remote point is established.
The number and order of soft keys used in this command correspond to the number and order of soft keys that appear on Cisco Unified SIP IP phones. Any soft key that is not explicitly specified with this command is disabled.
The ConfList and RmLastC soft keys are added in the connected state when hardware conference is enabled.
This command is not supported on the Cisco Unified 7905, 7912, 7940, and 7960 SIP IP Phones.
Examples
In the following example, Cisco Unified SIP IP phone template 1 is configured for the connected and seized call states:
Router(config)# voice register template 1
Router(config-register-temp)# softkeys seized Redial Cfwdall EndCall
Router(config-register-temp)# softkeys connected Confrn Hold Endcall
The following is a sample output from the show voice register template command. The output shows that the iDivert soft key is in connected state.
Router# show voice register template 1
Attended Transfer is enabled
Blind Transfer is enabled
Semi-attended Transfer is enabled
Caller-ID block is disabled
Anonymous call block is disabled
Softkeys connected iDivert
Related Commands
Command
|
Description
|
softkeys hold (voice register template)
|
Modifies the soft key display on Cisco Unified SIP IP phones during the hold call state.
|
softkeys idle (voice register template)
|
Modifies the soft key display on Cisco Unified SIP IP phones during the idle call state.
|
softkeys seized (voice register template)
|
Modifies the soft key display on Cisco Unified SIP IP phones during the seized call state.
|
template (voice register pool)
|
Applies a phone template to a Cisco Unified SIP IP phone.
|
softkeys hold
To configure an ephone template to modify soft-key display during the call-hold call stage, use the softkeys hold command in ephone-template configuration mode. To remove a softkeys hold configuration, use the no form of this command.
softkeys hold {[Join] [Newcall] [Resume] [Select]}
no softkeys hold
Syntax Description
Join
|
(Optional) Soft-key name that appears on an IP phone during the hold call stage. Joins an established call to a conference.
|
Newcall
|
(Optional) Soft-key name that appears on an IP phone during the hold call stage. Opens a line on a speaker phone to place a new call.
|
Resume
|
(Optional) Soft-key name that appears on an IP phone during the hold call stage. Reconnects with the call on hold.
|
Select
|
(Optional) Soft-key name that appears on an IP phone during the hold call stage. Selects a call or a conference on which to take action.
|
Command Default
The default soft keys for the hold call stage and the order in which they appear on IP phones are alphabetical, from first to last, Join, Newcall, Resume, and Select.
Command Modes
Ephone-template configuration (config-ephone-template)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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.
|
12.4(11)XJ2
|
Cisco Unified CME 4.1
|
The Join and Select keywords were added.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command with the Join and Select keywords was integrated into Cisco IOS Release 12.4(15)T.
|
Usage Guidelines
You reach the call-hold state by pressing the Hold soft key while you are in the connected state. From the hold state, you can press Resume to return to the connected state or NewCall to start another call, leaving the original call in the call-hold state.
The number and order of soft keys listed in the softkeys hold correspond to the number and order of soft keys that will appear on IP phones.
Configure the Join and Select soft keys for conferencing functions. These soft keys are supported for hardware-based conferencing only and require the appropriate DSP farm configuration..
Examples
In the following example, ephone template 1 is configured for the idle, alerting, connected, and hold call stages. It is applied to ephone 25. When ephone 25 has a call on hold, the only soft key that will be available is the Resume soft key.
Router(config)# telephony-service
Router(config-telephony)# ephone-template 1
Router(config-ephone-template)# softkeys idle Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall
Router(config-ephone-template)# softkeys hold Resume
Router(config-ephone-template)# exit
Router(config)# ephone 25
Router(config-ephone)# button 1:39
Router(config-ephone)# ephone-template 1
Related Commands
Command
|
Description
|
ephone
|
Enters ephone configuration mode for an IP phone.
|
ephone-template
|
Declares and names an ephone template to configure IP phone soft-key display and enters ephone-template configuration mode
|
ephone-template (ephone)
|
Applies an ephone template to an ephone.
|
softkeys alerting
|
Configures an ephone template for soft-key display during the alerting call stage.
|
softkeys connected
|
Configures an ephone template for soft-key display during the connected call stage.
|
softkeys idle
|
Configures an ephone template for soft-key display during the idle call stage.
|
softkeys seized
|
Configures an ephone template for soft-key display during the seized call stage.
|
softkeys idle
To modify the order and type of soft keys that display on an IP phone during the idle call state, use the softkeys idle command in ephone template configuration mode. To reset to the default, use the no form of this command.
softkeys idle {[Cfwdall] [ConfList] [Dnd] [Gpickup] [HLog] [Join] [Login] [Mobility]
[Newcall] [Pickup] [Redial] [RmLstC]}
no softkeys idle
Syntax Description
Cfwdall
|
(Optional) Soft key that forwards all calls.
|
ConfList
|
(Optional) Soft key that lists all parties in a conference.
|
Dnd
|
(Optional) Soft key that enables the Do-Not-Disturb features. This key is a toggle; pressing it a second time disables DND.
|
Gpickup
|
(Optional) Soft key that selectively picks up calls coming into a phone number that is a member of a pickup group.
|
HLog
|
(Optional) Soft key that places a phone into not-ready status, in which it does not accept hunt-group calls. You must set the hunt-group logout command to HLog for this soft key to be visible. This key is a toggle; pressing it a second time returns the phone to ready status, in which it is available to receive calls.
|
Join
|
(Optional) Soft key that joins an established call to a conference.
|
Login
|
(Optional) Soft key that provides personal identification number (PIN)-controlled access to restricted phone features.
|
Mobility
|
(Optional) Soft key that enables Single Number Reach (SNR) feature. This key is a toggle; pressing it a second time disables SNR.
|
Newcall
|
(Optional) Soft key that opens a line on a speaker phone to place a new call.
|
Pickup
|
(Optional) Soft key that selectively picks up calls coming into another extension.
|
Redial
|
(Optional) Soft key that redials the last number dialed.
|
RmLstC
|
(Optional) Soft key that removes the last party added to the conference. This soft key removes the last party only when the conference creator presses it.
|
Command Default
The default soft keys for the idle call stage and the order in which they appear on IP phones are:
•
FXO Trunk: Redial, NewCall, DoNotDisturb
•
With HLog support: Redial, NewCall, CFwdAll, CallPickUp, GrpCallPickUp, DoNotDisturb, Login, HLog
•
Without HLog support: Redial, NewCall, CFwdAll, CallPickUp, GrpCallPickUp, DoNotDisturb, Login
Command Modes
Ephone-template configuration (config-ephone-template)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.3(11)T
|
Cisco CME 3.2
|
This command was introduced.
|
12.4(4)XC
|
Cisco Unified CME 4.0
|
The HLog keyword was added.
|
12.4(9)T
|
Cisco Unified CME 4.0
|
The HLog keyword was integrated into Cisco IOS Release 12.4(9)T.
|
12.4(11)XJ2
|
Cisco Unified CME 4.1
|
The ConfList, Join, and RmLstC keywords were added.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command with the ConfList, Join, and RmLstC keywords was integrated into Cisco IOS Release 12.4(15)T.
|
12.4(22)YB
|
Cisco Unified CME 7.1
|
The Mobility keyword was added.
|
12.4(24)T
|
Cisco unified CME 7.1
|
This command was integrated into Cisco IOS Release 12.4(24)T.
|
Usage Guidelines
The idle calling stage occurs before a call is made and after a call is complete.
The number and order of soft keys listed in the softkeys idle command correspond to the number and order of soft keys on IP phones.
Configure the ConfList, Join, and RmLstC soft keys for conferencing functions. These soft keys are supported for hardware-based conferencing only and require the appropriate DSP farm configuration.
Note
The ConfList (including the Remove, Update, and Exit soft keys within the ConfList function) and RmLstC soft keys do not work on the Cisco Unified IP Phone 7902 and Cisco Unified IP Phone 7935 and 7936.
Examples
In the following example, ephone template 1 is configured for the idle stage and for the alerting and connected call stages:
Router(config)# ephone-template 1
Router(config-ephone-template)# softkeys idle Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall
Related Commands
Command
|
Description
|
ephone
|
Enters ephone configuration mode for an IP phone.
|
ephone-template
|
Creates an ephone template.
|
ephone-template (ephone)
|
Applies an ephone template to an ephone.
|
hunt-group logout
|
Enables separate handling of DND and HLog functionality for hunt-group agents and the display of an HLog soft key on phones.
|
softkeys alerting
|
Configures soft-key display during the alerting call state.
|
softkeys connected
|
Configures soft-key display during the connected call state.
|
softkeys seized
|
Configures soft-key display during the seized call state.
|
softkeys idle (voice register template)
To modify the soft-key display during the idle call state on SIP phones, use the softkeys idle command in voice register template configuration mode. To remove a softkeys idle configuration, use the no form of this command.
softkeys idle {[Cfwdall] [DND] [Gpickup] [Newcall] [Pickup] [Redial]}
no softkeys idle
Syntax Description
Cfwdall
|
(Optional) Soft key for "call forward all." Forwards all calls.
|
DND
|
(Optional) Soft key that enables the Do-Not-Disturb feature.
|
Gpickup
|
(Optional) Soft key that allows a user to pickup a call that is ringing on another phone.
|
Newcall
|
(Optional) Soft key that opens a line on a speakerphone to place a new call.
|
Pickup
|
(Optional) Soft key that allows a user to pickup a call that is ringing on another phone that is a member of the same pickup group.
|
Redial
|
(Optional) Soft key that redials the last number dialed.
|
Command Default
The default soft keys for the idle call state and the order in which they appear on SIP phones are, from first to last, Redial, Newcall, and Cfwdall.
Command Modes
Voice register template configuration (config-register-temp)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(11)XJ
|
Cisco Unified CME 4.1
|
This command was introduced.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
12.4(22)YB
|
Cisco Unified CME 7.1
|
The DND keyword was added.
|
12.4(24)T
|
Cisco Unified CME 7.1
|
This command was integrated into Cisco IOS Release 12.4(24)T.
|
Usage Guidelines
The idle calling state occurs before a call is made and after a call is complete.
The number and order of soft keys used in this command correspond to the number and order of soft keys that appear on SIP phones. Any soft key that is not explicitly specified with this command is disabled if this command is used to change the default soft keys.
This command is not supported on the Cisco Unified IP Phone 7905, 7912, 7940, or 7960.
Examples
In the following example, SIP phone template 1 is configured for the idle and connected call states:
Router(config)# voice register template 1
Router(config-register-template)# softkeys idle Redial Cfwdall
Router(config-register-template)# softkeys connected Confrn Hold Endcall
Related Commands
Command
|
Description
|
softkeys connected (voice register template)
|
Modifies the soft-key display on SIP phones during the connected call state.
|
softkeys hold (voice register template)
|
Modifies the soft-key display on SIP phones during the hold call state.
|
softkeys idle (voice register template)
|
Modifies the soft-key display on SIP phones during the idle call state.
|
softkeys seized (voice register template)
|
Modifies the soft-key display on SIP phones during the seized call state.
|
template (voice register pool)
|
Applies a phone template to a SIP phone.
|
softkeys remote-in-use
To modify the order and type of soft keys that display on the IP phone during the remote-in-use call state, use the softkeys remote-in-use command in ephone-template configuration mode. To reset to the default, use the no form of this command.
softkeys remote-in-use {[CBarge] [Newcall]}
no softkeys remote-in-use
Syntax Description
CBarge
|
(Optional) Soft key that allows a user to barge into a call on a shared octo-line directory number.
|
Newcall
|
(Optional) Soft key that opens a line on a speakerphone to place a new call.
|
Command Default
The default soft keys for the remote-in-use call state and the order in which they appear on IP phones are Newcall, CBarge.
Command Modes
Ephone-template configuration (config-ephone-template)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(15)XZ
|
Cisco Unified CME 4.3
|
This command was introduced.
|
12.4(20)T
|
Cisco Unified CME 7.0
|
This command was itegrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
The remote-in-use call state is when another phone is connected to a call on an octo-line directory number shared by this phone.
Examples
In the following example, ephone template 1 modifies the soft keys displayed for the alerting, connected, and remote-in-use call states:
Router(config)# ephone-template 1
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall
Router(config-ephone-template)# softkeys remote-in-use CBarge Newcall
Related Commands
Command
|
Description
|
ephone-template (ephone)
|
Applies an ephone template to an ephone.
|
softkeys alerting
|
Modifies the soft-key display for the alerting call stage.
|
softkeys idle
|
Modifies the soft-key display for the idle call stage.
|
softkeys seized
|
Modifies the soft-key display for the seized call stage.
|
softkeys remote-in-use (voice register template)
To modify the soft-key display during the remote-in-use call state on SIP shared-line phones, use the softkeys remote-in-use command in voice register template configuration mode. To reset to the default, use the no form of this command.
softkeys remote-in-use {[Barge] [Newcall] [cBarge]}
no softkeys remote-in-use
Syntax Description
Barge
|
(Optional) Soft key that allows a user to join a call on a shared line.
|
Newcall
|
(Optional) Soft key that opens a line on a phone to place a new call.
|
cBarge
|
(Optional) Soft key that allows a user to join a call on a shared line and to turn the call into a conference call.
|
Command Default
The default soft keys for the remote-in-use call state and the order in which they appear on SIP phones are Barge, Newcall, cBarge.
Command Modes
Voice register template configuration (config-register-temp)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(22)YB
|
Cisco Unified CME 7.1
|
This command was introduced.
|
12.4(24)T
|
Cisco Unified CME 7.1
|
This command was integrated into Cisco IOS Release 12.4(24)T.
|
Usage Guidelines
The remote-in-use call state is when another phone is connected to a call on a directory number shared by this phone.
Examples
In the following example, SIP phone template 1 modifies the soft keys displayed for the alerting, connected, and remote-in-use call states:
Router(config)# voice register template 1
Router(config-register-temp)# softkeys alerting Callback Endcall
Router(config-register-temp)# softkeys connected Confrn Hold Endcall
Router(config-register-temp)# softkeys remote-in-use CBarge Newcall
Related Commands
Command
|
Description
|
softkeys alerting (voice register template)
|
Modifies the soft-key display on SIP phones during the alerting call state.
|
softkeys idle (voice register template)
|
Modifies the soft-key display on SIP phones during the idle call state.
|
softkeys seized (voice register template)
|
Modifies the soft-key display on SIP phones during the seized call state.
|
template (voice register pool)
|
Applies a phone template to a SIP phone.
|
softkeys ringin (voice register template)
To modify the soft-key display during the ringing call state on SIP phones, use the softkeys ringIn command in ephone-template configuration mode. To remove the softkeys ringIn configuration, use the no form of this command.
softkeys ringIn [Answer] [DND]
no softkeys ringIn
Syntax Description
Answer
|
(Optional) Soft key that picks up an incoming call.
|
DND
|
(Optional) Soft key that enables the Do Not Disturb feature.
|
Command Default
The following soft keys are displayed in alphabetical order, first to last, on IP phones during the ringing call state: Answer, Dnd
Command Modes
Voice register template configuration (config-register-temp)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(22)YB
|
Cisco Unified CME 7.1
|
This command was introduced.
|
12.4(24)T
|
Cisco Unified CME 7.1
|
This command was integrated into Cisco IOS Release 12.4(24)T.
|
Usage Guidelines
Use this command to create a template in which you specify which soft keys are displayed, and in what order, on an IP phone during the ringing call state. The ringing calling state is after a call is received and before the call is connected.
Any soft key that is not explicitly specified with this command is disabled if this command is used to change the default soft keys.
Configure the Answer keyword to enable a phone user to answer an incoming call on a line button that is unavailable; for example, if a line button is configured with a dual-line directory number and a call is holding on one channel of the directory number and another call is ringing on the second channel, the phone user can press the Answer soft key to pick up the incoming call on the second channel.
Configure the DND keyword to enable the phone user to place the phone into Do-Not-Disturb mode. Configure the Dnd soft key and the hunt-group logout DND command to enable the phone user to invoke DND mode and log the phone out of hunt groups in which it is a member.
To apply an ephone template to a phone, configure the ephone-template (ephone) command in ephone configuration mode.
Examples
In the following example, SIP phone template 1 is configured for the ringing state, and for the alerting and connected call states:
Router(config)# voice register template 1
Router(config-register-template)# softkeys ringing Answer Dnd Hlog
Router(config-register-template)# softkeys alerting Callback Endcall
Router(config-register-template)# softkeys connected Confrn Hold Endcall
Related Commands
Command
|
Description
|
softkeys connected (voice register template)
|
Modifies the soft-key display on SIP phones during the connected call state.
|
softkeys hold (voice register template)
|
Modifies the soft-key display on SIP phones during the hold call state.
|
softkeys idle (voice register template)
|
Modifies the soft-key display on SIP phones during the idle call state.
|
softkeys seized (voice register template)
|
Modifies the soft-key display on SIP phones during the seized call state.
|
softkeys ringing
To configure an ephone template for soft-key display during the ringing call state, use the softkeys ringing command in ephone-template configuration mode. To remove the softkeys ringing configuration, use the no form of this command.
softkeys ringing {[Answer] [Dnd] [HLog]}
no softkeys ringing
Syntax Description
Answer
|
(Optional) Soft-key name that appears on the IP phone during the ringing call state.
|
Dnd
|
(Optional) Soft-key name that appears on the IP phone during the ringing call state.
|
HLog
|
(Optional) Soft-key name that appears on the IP phone during the ringing call state.
|
Command Default
The following soft keys are displayed in alphabetical order, first to last, on IP phones during the ringing call state: Answer, Dnd, HLog
Command Modes
Ephone-template configuration (config-ephone-template)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(11)XW
|
Cisco Unified CME 4.2
|
This command was introduced.
|
12.4(15)XY
|
Cisco Unified CME 4.2(1)
|
This command was introduced.
|
12.4(15)XZ
|
Cisco Unified CME 4.3
|
This command was introduced.
|
12.4(20)T
|
Cisco Unified CME 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
Use this command in ephone-template configuration mode to create a template in which you can specify which soft keys are displayed, and in what order, on an IP phone during the ringing call state. The ringing calling state is when a call is received and before the call is connected.
Any soft key that is not explicitly configured is disabled.
You can enter any of the keywords in any order. The number and order of soft keys listed in the softkeys ringing command corresponds to the number and order of soft keys that will appear on IP phones during the ringing call state.
Configure the Answer keyword with this command to enable a phone user to answer an incoming call on a line button that is unavailable; for example, if a line button is configured with a dual-line directory number and a call is holding on one channel of the directory number and another call is ringing on the second channel, the phone user can use the Answer soft key to pick up the incoming call on the second channel.
Configure the HLog keyword with this command to display the Hlog soft key during the ringing call state. To enable HLog softkey functionality during the call ringing state, you must also configure the hunt-group logout HLog command. If you configure the Hlog soft key and do not configure the hunt-group logout HLog command, the Hlog soft key appears on the phone screen but is not functional. The HLog softkey is a toggle for enabling or disabling the not-ready status, in which the directory number does not accept hunt-group calls.
Configure the Dnd keyword with this command to enable the phone user to place the phone into Do-Not-Disturb mode. Configure the Dnd soft key and the hunt-group logout DND command to enable the phone user to invoke DND mode and log the phone out of hunt groups in which it is a member.
To apply an ephone template to phone, configure the ephone-template (ephone) command in the ephone configuration mode.
Examples
In the following example, ephone template 1 is configured for the ringing state, and for the alerting and connected call states:
Router(config)# telephony-service
Router(config-telephony)# ephone-template 1
Router(config-ephone-template)# softkeys ringing Answer Dnd Hlog
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall
Related Commands
Command
|
Description
|
dnd feature ring
|
Allows phone buttons configured with the feature-ring option to not ring when their phones are in do-not-disturb (DND) mode.
|
ephone-template (ephone)
|
Applies an ephone template to an ephone.
|
hunt-group logout
|
Enables separate handling of DND and HLog functionality for hunt-group agents.
|
softkeys alerting
|
Configures an ephone template for soft-key display during the alerting call state.
|
softkeys connected
|
Configures an ephone template for soft-key display during the connected call state.
|
softkeys idle
|
Configures an ephone template for soft-key display during the idle call state.
|
softkeys seized
|
Configures an ephone template for the soft-key display during the seized call state.
|
softkeys seized
To modify the order and type of soft keys that display on an IP phone during the seized call state, use the softkeys seized command in ephone-template configuration mode. To remove a softkeys seized configuration, use the no form of this command.
softkeys seized {[CallBack] [Cfwdall] [CWOff] [Endcall] [Gpickup] [HLog] [MeetMe]
[Pickup] [Redial]}
no softkeys seized
Syntax Description
CallBack
|
(Optional) Soft key that requests callback notification when a busy called line becomes free.
|
Cfwdall
|
(Optional) Soft key that forwards all calls.
|
CWOff
|
(Optional) Soft key that disables Call Waiting.
|
Endcall
|
(Optional) Soft key that ends the current call.
|
Gpickup
|
(Optional) Soft key that selectively picks up calls coming into a phone number that is a member of a pickup group.
|
HLog
|
(Optional) Soft key that places a phone into not-ready status, in which it does not accept hunt-group calls. You must set the hunt-group logout command to HLog for this soft key to be visible. This key is a toggle; pressing it a second time returns the phone to ready status, in which it is available to receive calls.
|
MeetMe
|
(Optional) Soft key that initiates a meet-me conference.
|
Pickup
|
(Optional) Soft key that selectively picks up calls to another extension.
|
Redial
|
(Optional) Soft key that redials the last number dialed.
|
Command Default
The default soft keys for the seized call stage and the order in which they appear on IP phones are:
•
With HLog support: Redial, EndCall, CFwdAll, CallPickUp, GrpCallPickUp, CallBack, HLog
•
Without HLog support: Redial, EndCall, CFwdAll, CallPickUp, GrpCallPickUp, CallBack
Command Modes
Ephone-template configuration (config-ephone-template)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.3(11)T
|
Cisco CME 3.2
|
This command was introduced.
|
12.4(4)XC
|
Cisco Unified CME 4.0
|
The HLog keyword was added.
|
12.4(9)T
|
Cisco Unified CME 4.0
|
The HLog keyword was integrated into Cisco IOS Release 12.4(9)T.
|
12.4(11)XJ2
|
Cisco Unified CME 4.1
|
The MeetMe keyword was added.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
The MeetMe keyword was integrated into Cisco IOS Release 12.4(15)T.
|
15.0(1)XA
|
Cisco Unified CME 8.0
|
This command was modified. The CWOff keyword was added.
|
15.1(1)T
|
Cisco Unified CME 8.0
|
This command was integrated into Cisco IOS Release 15.1(1)T.
|
Usage Guidelines
The seized calling stage is when a caller is attempting a call and has not yet been connected.
The number and order of soft keys listed in the softkeys seized command correspond to the number and order of soft keys on IP phones.
You must configure the MeetMe soft key to initiate a meet-me conference. Use this soft key for hardware conferencing only.
Examples
In the following example, ephone template 1 modifies the soft keys in the seized, alerting, and connected call states:
Router(config)# telephony-service
Router(config-telephony)# ephone-template 1
Router(config-ephone-template)# softkeys seized Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall
Related Commands
Command
|
Description
|
ephone
|
Enters ephone configuration mode for an IP phone.
|
ephone-template (ephone)
|
Applies an ephone template to an ephone.
|
hunt-group logout
|
Enables separate handling of DND and HLog functionality for hunt-group agents and the display of an HLog soft key on phones.
|
softkeys alerting
|
Modifies the soft keys that display during the alerting call stage.
|
softkeys connected
|
Modifies the soft keys that display during the connected call stage.
|
softkeys idle
|
Modifies the soft keys that display during the idle call stage.
|
softkeys seized (voice register template)
To modify the soft key display for the seized call state on Cisco Unified SIP IP phones, use the softkeys seized command in voice register template configuration mode. To return to the default, use the no form of this command.
softkeys seized {[Cfwdall] [Endcall] [Gpickup] [MeetMe] [Pickup] [Redial]}
no softkeys seized
Syntax Description
Cfwdall
|
(Optional) Appears on the Cisco Unified SIP IP phone during the seized call state. Short for "Call forward all." Forwards all calls.
|
Endcall
|
(Optional) Appears on the Cisco Unified SIP IP phone during the seized call state. Ends the current call.
|
Gpickup
|
(Optional) Appears on the Cisco Unified SIP IP phone during the seized call state. Short for "Group call pick up." Selectively picks up calls coming into a phone number that is a member of a pickup group.
|
MeetMe
|
(Optional) Appears on the Cisco Unified SIP IP phone during the seized call state. Short for "MeetMe conference." Initiates a meet-me conference.
|
Pickup
|
(Optional) Appears on the Cisco Unified SIP IP phone during the seized call state. Short for "Call pick up." Selectively picks up calls coming into another extension.
|
Redial
|
(Optional) Appears on the Cisco Unified SIP IP phone during the seized call state. Redials the last number dialed.
|
Command Default
The default soft keys for the seized call state and the order in which they appear on Cisco Unified SIP IP phones are, from first to last: Cfwdall, Endcall, Gpickup, MeetMe, Pickup, and Redial.
Command Modes
Voice register template configuration (config-register-template)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(11)XJ
|
Cisco Unified CME 4.1
|
This command was introduced.
|
12.4(15)T
|
Cisco Unified CME 4.1
|
This command was integrated into Cisco IOS Release 12.4(15)T.
|
15.2(2)T
|
Cisco Unified CME 9.0
|
This command was modified. The MeetMe keyword was added.
|
Usage Guidelines
The seized calling state is when a caller goes offhook before any other action is taken.
The number and order of soft keys used in this command correspond to the number and order of soft keys that appear on Cisco Unified SIP IP phones. Any soft key that is not explicitly specified with this command is disabled.
The MeetMe soft key is added in the seized state when hardware conference is enabled.
This command is not supported on the Cisco Unified 7905, 7912, 7940, and 7960 SIP IP phones.
Examples
In the following example, Cisco Unified SIP IP phone template 1 is configured for the seized and connected call states:
Router(config)# voice register template 1
Router(config-register-template)# softkeys seized Redial Cfwdall
Router(config-register-template)# softkeys connected Confrn Hold Endcall
Related Commands
Command
|
Description
|
softkeys connected (voice register template)
|
Configures a Cisco Unified SIP IP phone template for soft key display during the connected call state.
|
softkeys hold (voice register template)
|
Configures a Cisco Unified SIP IP phone template for soft key display during the hold call state.
|
softkeys idle (voice register template)
|
Configures a Cisco Unified SIP IP phone template for soft key display during the idle call state.
|
template (voice register pool)
|
Applies a template to a Cisco Unified SIP IP phone.
|
source-addr
To specify the IP address of the certification authority proxy function (CAPF) server on the Cisco Unified CME router, use the source-addr command in CAPF-server configuration mode. To return to the default, use the no form of this command.
source-addr ip-address
no source-addr
Syntax Description
ip-address
|
IP address of the Cisco Unified CME router.
|
Command Default
No IP address is entered for the CAPF server in the router configuration.
Command Modes
CAPF-server configuration (config-capf-server)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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 identifies the IP address for the CAPF server as 10.10.10.1:
Router(config)# capf-server
Router(config-capf-server)# source address 10.10.10.1
Router(config-capf-server)# trustpoint-label server25
Router(config-capf-server)# cert-oper upgrade all
Router(config-capf-server)# cert-enroll-trustpoint server12 password 0 x8oWiet
Router(config-capf-server)# auth-mode auth-string
Router(config-capf-server)# auth-string generate all
Router(config-capf-server)# port 3000
Router(config-capf-server)# keygen-retry 5
Router(config-capf-server)# keygen-timeout 45
Router(config-capf-server)# phone-key-size 2048
source-address (voice register global)
To identify the IP address and port through which SIP phones communicate with a Cisco CallManager Express (Cisco CME) router, use the source-address command in voice register global configuration mode. To disable the router from receiving messages from SIP phones, use the no form of this command.
source-address ip-address [port port]
no source-address
Syntax Description
ip-address
|
Preexisting router IP address, typically one of the addresses of the Ethernet port of the router.
|
port port
|
(Optional) TCP/IP port number to use for Skinny Client Control Protocol (SCCP). Range is 2000 to 9999. Default is 2000.
|
Defaults
Port number: 2000
Command Modes
Voice register global configuration (config-register-global)
Command History
Cisco IOS Release
|
Version
|
Modification
|
12.4(4)T
|
Cisco CME 3.4
|
This command was introduced.
|
Usage Guidelines
This commandis a mandatory command. The Cisco CallManager Express router cannot communicate with the Cisco CME phones if the IP address is not provided. If the port number is not provided, the SCCP default is port 2000, and the SIP default port for is 5060. The IP address is usually the IP address of the Ethernet port to which the phones are connected.
This command enables a router to receive messages from Cisco IP phones through the specified IP address and port.
For systems using ITS V2.1, Cisco CME 3.0, or later versions, the IP phones receive their initial configuration information and phone firmware from the TFTP server associated with the router. The TFTP server address obtained by the Cisco IP phones points to the router IP address. The Cisco IP phones transfer a configuration file called SIPDefault.cnf. This file is automatically generated by the router through the source-address and is placed in router memory. The SIPDefault.cnf file contains the IP address that the phones, using the Session Initiation Protocol (SIP), use to register for service. This IP address corresponds to a valid Cisco CME router IP address (and may be the same as the router TFTP server address).
Examples
The following example shows how to set the IP source address and port:
Router(config)# voice register global
Router(config-register-global)# source-address 10.6.21.4 port 6000
Related Commands
Command
|
Description
|
create profile (voice register global)
|
Generates the configuration profiles required for SIP phones.
|
file text (voice register global)
|
Generates ASCII text files for SIP phones.
|
tftp-path (voice register global)
|
Specifies the directory to which the provisioning file for SIP phones in a Cisco CallManager Express (Cisco CME) system will be written.
|
voice register global
|
Enters voice register global configuration mode in order to set global parameters for all supported Cisco SIP phones in a Cisco CME or Cisco SIP SRST environment.
|
speed-dial
To create speed-dial definitions for a Cisco Unified IP phone or analog phone that uses an analog telephone adaptor (ATA) in a Cisco Unified CME system, use the speed-dial command in ephone or ephone-template configuration mode. To disable a speed-dial definition, use the no form of this command.
speed-dial speed-tag digit-string [label label-text]
no speed-dial speed-tag
Syntax Description
speed-tag
|
Unique sequence number that identifies a speed-dial definition during configuration tasks. Range is from 1 to 33.
|
digit-string
|
Digits to be dialed when the speed-dial button is pressed on an IP phone or the digits to be dialed when the associated code is entered from an analog phone with an ATA device.
For IP phones, if the first character of this string is the plus sign (+), this speed-dial number is locked and cannot be changed at the phone. If the only character in this string is a pound sign (#), a user-programmable speed-dial button with no speed-dial number attached is defined.
|
label label-text
|
(Optional) String that contains identifying text to be displayed next to the speed-dial button. Enclose the string in quotation marks if the string contains a space.
|
Command Default
No speed-dial definitions are created.
Command Modes
Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.1(5)YD
|
Cisco ITS 1.0
|
This command was introduced
|
12.2(8)T
|
Cisco ITS 2.0
|
This command was integrated into Cisco IOS Release 12.2(8)T.
|
12.2(15)ZJ
|
Cisco CME 3.0
|
The number of speed-dial definitions that can be created was increased from 4 to 33. The ability to program speed-dial numbers at the phone and the ability to lock speed-dial numbers were introduced.
|
12.3(4)T
|
Cisco CME 3.0
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
12.3(11)XL
|
Cisco CME 3.2.1
|
This command was modified to allow IP phones to access more speed-dial numbers than the number of available buttons on their phones and to allow analog phones to access up to 33 speed-dial numbers.
|
12.3(14)T
|
Cisco CME 3.3
|
This command was integrated into Cisco IOS Release 12.3(14)T.
|
12.4(4)XC
|
Cisco Unified CME 4.0
|
This command was made available in ephone-template configuration mode.
|
12.4(9)T
|
Cisco Unified CME 4.0
|
This command in ephone-template configuration mode was integrated into Cisco IOS Release 12.4(9)T.
|
Usage Guidelines
The speed-tag argument in this command is a unique identifier for a speed-dial definition on the phone that is being configured.
This command must be followed by a quick reboot of the phone using the restart command.
If you use an ephone template to apply a to a phone and you also use the same command in ephone configuration mode for the same phone, the value that you set in ephone configuration mode has priority.
This command defines speed-dial numbers that are local to the ephone that is being configured. The directory entry defines additional, systemwide speed-dial numbers.
IP Phones
For IP phones, speed-dial numbers can be defined by administrators using this command and the digit-string argument. The numbers are locked if the digit-string argument begins with a plus sign (+). Locked numbers cannot be changed at the phone. Speed-dial definitions without speed-dial numbers (those defined with only a pound sign) and speed-dial instances with unlocked digit-string arguments can be changed by users at their IP phones. Changes made to speed-dial definitions are saved in the router nonvolatile random-access memory (NVRAM) configuration after a timer-based delay.
On Cisco Unified IP phones, speed-dial definitions are assigned to available extension buttons that have not been assigned to extensions. Speed-dial definitions are assigned in the order of their identifier (tag) numbers. For example, if you define speed-dial 1, it is assigned to the first phone button that is available after the buttons that have been assigned to extensions. If you have used two buttons for extensions on a phone, speed-dial 1 is assigned to the third physical button on the phone. When you define speed-dial 2, it is assigned to the fourth physical button on the phone, and so on.
If more speed-dial definitions are created than are supported by the IP phone setup, the extra speed-dial configurations can be dialed from IP phones using this procedure:
1.
With the phone on-hook, an IP phone user presses a two-digit speed-dial code (that is, 05 for the entry with tag 5). A new soft key, Abbr, appears in the phone display.
2.
The phone user picks up the phone handset and presses the Abbr soft key. The full telephone number associated with the speed-dial tag is dialed.
Prior to Cisco IOS Releases 12.3(11)XL and 12.3(14)T, speed-dial entries that were in excess of the number of physical phone buttons available were ignored.
Analog Phones
Analog phone users who use a Cisco ATA-186, Cisco ATA-188, or Cisco VG 224 to connect to a Cisco Unified CME system use a different method to access speed-dial numbers. Analog phone users press the asterisk (*) key and the speed-dial identifier (tag number) to dial a speed-dial number. For instance, an analog phone user presses *1 to speed dial the number that has been programmed as speed-dial 1 on that ephone. Analog phones can have up to 33 local speed-dial numbers programmed by the system administrator. The numbers cannot be programmed from the phone.
Prior to Cisco IOS Releases 12.3(11)XL and 12.3(14)T, analog phones were limited to nine speed-dial numbers.)
Examples
The following example sets speed-dial button 2 to dial the phone user's assistant at extension 5001 and locks the setting so that the phone user cannot change it at the phone:
Router(config)# ephone 23
Router(config-ephone)# speed-dial 2 +5001 label "Assistant"
Related Commands
| |
Description
|
directory entry
|
Adds a systemwide phone directory entry or speed-dial entry.
|
restart (ephone)
|
Performs a fast reboot of a single IP phone in a Cisco Unified CME system.
|
restart (telephony-service)
|
Performs a fast reboot of one or all phones in a Cisco Unified CME system.
|
ephone-template (ephone)
|
Applies template to ephone configuration.
|
speed-dial (voice logout-profile and voice user-profile)
To create speed-dial definitions in a user profile or logout profile for Extension Mobility in Cisco Unified CME, use the speed-dial command in voice user-profile configuration mode or voice logout-profile configuration mode. To disable a speed-dial definition, use the no form of this command.
speed-dial speed-tag number [label label] [blf]
no speed-dial speed-tag
Syntax Description
speed-tag
|
Unique sequence number that identifies a speed-dial definition during configuration tasks. Range: 1 to 36.
|
number
|
Digits to be dialed when the speed-dial button is pressed on an IP phone, or the digits to be dialed when the associated code is entered from an analog phone with an analog telephone adapter (ATA) device.
For IP phones, if the first character of this string is the plus sign (+), this speed-dial number is locked and cannot be changed at the phone. If the only character in this string is a pound sign (#), a user-programmable speed-dial button with no speed-dial number attached is defined.
|
label label
|
(Optional) String that contains identifying text to be displayed next to the speed-dial button. Enclose the string in quotation marks if the string contains a space.
|
blf
|
(Optional) Enables Busy Lamp Field (BLF) monitoring for a speed-dial number.
|
Command Default
No speed-dial definition is created.
Command Modes
Voice logout-profile configuration (config-logout-profile)
Voice user-profile configuration (config-user-profile)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(11)XW
|
Cisco Unified CME 4.2
|
This command was introduced.
|
12.4(15)XY
|
Cisco Unified CME 4.2(1)
|
This command was introduced.
|
12.4(15)XZ
|
Cisco Unified CME 4.3
|
This command was introduced.
|
12.4(20)T
|
Cisco Unified CME 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
Use this command in voice user-profile configuration mode to create a speed-dial definition in a user profile for Extension Mobility. A user profile is downloaded to the IP phone when a user is logged into an IP phone that is registered in Cisco Unified CME and enabled for Extension Mobility.
Use this command in voice logout-profile configuration mode to create a speed-dial definition in a logout profile for Extension Mobility. A logout profile is downloaded to the IP phone when no user is logged into an IP phone that is registered in Cisco Unified CME and enabled for Extension Mobility.
For button appearance, Extension Mobility will associate directory numbers and then associates speed-dial definitions in the logout profile or user profile to phone buttons in a sequential manner. If the profile contains more directory and speed-dial numbers than there are buttons on the physical phone to which the profile is downloaded, the remaining numbers in the profile are ignored.
On Cisco Unified IP phones, speed-dial definitions are assigned to available extension buttons that have not been assigned to extensions. Speed-dial definitions are assigned in the order of their identifier (tag) numbers, from 1 to 36.
Examples
The following example shows the configuration for a user profile to be downloaded when the a phone user logs into a Cisco Unified IP phone that is enabled for Extension Mobility. The lines and speed-dial buttons in this profile that are configured on an IP phone after the user logs in depend on the phone type. For example, if the user logs into a Cisco Unified IP Phone 7970, all buttons are configured according to voice-user profile1. However, if the phone user logs into a Cisco Unified IP Phone 7960, all six lines are mapped to phone buttons and the speed dial is ignored because there is no button available for speed dial.
pin 12345
user me password pass123
number 2001 type silent-ring
number 2002 type beep-ring
number 2003 type feature-ring
number 2004 type monitor-ring
number 2005,2006 type overlay
number 2007,2008 type cw-overly
speed-dial 1 3001
speed-dial 2 3002 blf
Related Commands
Command
|
Description
|
logout-profile
|
Enables Cisco Unified IP phone for Extension Mobility and assigns a logout profile to this phone.
|
reset (voice logout-profile and voice user-profile)
|
Performs complete reboot of all IP phones on which a particular logout-profile or user-profile is downloaded.
|
speed-dial (voice register pool)
To create a speed-dial definition for a Cisco Unified SIP IP phone or analog phone that uses an analog telephone adaptor (ATA) in a Cisco Unified Communications Manager Express (Cisco Unified CME) system, use the speed-dial command in voice register pool configuration mode. To disable a speed-dial definition, use the no form of this command.
speed-dial speed-tag digit-string [label label-text]
no speed-dial speed-tag
Syntax Description
speed-tag
|
Unique sequence number that identifies a speed-dial definition during configuration tasks. Range is 1 to 113.
|
digit-string
|
Digits to be dialed when the speed-dial button is pressed on an IP phone or the digits to be dialed when the associated code is entered from an analog phone with an ATA device.
For IP phones, if the first character of this string is a plus sign (+), this speed-dial number is locked and cannot be changed at the phone. If the only character in this string is a pound sign (#), a user-programmable speed-dial button with no speed-dial number attached is defined.
|
label label-text
|
(Optional) Text string that appears next to the speed-dial button. Enclose the string in quotation marks if the string contains a space.
|
Command Default
No speed-dial definition is created.
Command Modes
Voice register pool configuration (config-register-pool)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(4)T
|
Cisco CME 3.4
|
This command was introduced.
|
15.2(4)M
|
Cisco Unified CME 9.1
|
This command was modified to increase the number of speed-dial configuration to 113.
|
Usage Guidelines
The speed-dial command creates a speed-dial definition for a Cisco Unified SIP IP phone being configured in Cisco Unified CME.
The speed-tag argument is a unique identifier for a speed-dial definition on the phone that is being configured. On Cisco Unified IP phones, speed-dial definitions are assigned to available extension buttons that have not been assigned to extensions. Speed-dial definitions are assigned in the order of their identifier numbers.
For example, if you define speed-dial 1, it is assigned to the first phone button that is available after the buttons that are assigned to extensions. If you used two buttons for extensions on a phone, speed-dial 1 is assigned to the third physical button on the phone. When you define speed-dial 2, it is assigned to the fourth physical button on the phone.
For Cisco Unified IP phones, speed-dial numbers can be assigned by the administrator using the digit-string argument and can be locked if the digit-string argument begins with a plus sign (+). Locked numbers cannot be changed at the phone. Speed-dial instances without speed-dial numbers (those defined with only a pound sign) and speed-dial instances with unlocked digit-string arguments can be changed by users at their Cisco Unified IP phones.
If more speed-dial definitions are created than are supported by the IP phone setup, the extra speed-dial configurations are ignored.
Changes made to speed-dial buttons are saved in the router's NVRAM configuration after a timer-based delay.
Analog phone users who use a Cisco ATA-186 or Cisco ATA-188 to connect to Cisco Unified CME systems use a different method to access speed-dial numbers. Instead of pressing a speed-dial button, phone users with ATA devices press the asterisk (*) key and a speed-tag number (speed-dial identifier) to dial a speed-dial number. For instance, a phone user with a Cisco ATA-186 presses *1 to dial the number that has been programmed as speed-dial 1 on that phone.
Phones with ATA devices are limited to a maximum of nine speed-dial numbers that must be programmed by the system administrator. The numbers cannot be programmed from the phone. With phones that use ATA devices, system administrators must be sure to tell phone users when speed-dial numbers have been programmed for their phones.
After you configure the speed-dial command, restart the phone using the reset command.
Examples
The following example shows how to set speed-dial button 2 to dial the head office at extension 5001 and lock the setting so that the phone user cannot change it at the phone:
Router(config)# voice register pool 23
Router(config-register-pool)# speed-dial 2 +5001 label "Head Office"
The following example shows how to set speed-dial button 13 to dial the sales office extension number (222):
Router(config)# voice register pool 3
Router(config-register-pool)# speed-dial 13 222 label "Sales Office"
Related Commands
Command
|
Description
|
reset (voice register global)
|
Performs a complete reboot of all SIP phones associated with a Cisco Unified CME router.
|
reset (voice register pool)
|
Performs a complete reboot of a specific SIP phone associated with a Cisco Unified CME system.
|
voice register pool
|
Enters voice register pool configuration mode for SIP phones.
|
srst dn line-mode
To specify line mode for the ephone-dns that are automatically created in Survivable Remote Site Telephony (SRST) mode on a Cisco Unified CME router, use the srst dn line-mode command in telephony-service configuration mode. To return to the default, use the no form of this command.
srst dn line-mode {dual | dual-octo | octo | single}
no srst dn line-mode
Syntax Description
dual
|
SRST fallback ephone-dns are dual-line.
|
dual-octo
|
SRST fallback ephone-dns are dual-line or octo-line, depending on the phone type.
|
octo
|
SRST fallback ephone-dns are octo-line.
|
single
|
SRST fallback ephone-dns are single-line.
|
Command Default
Default is single-line mode.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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.
|
12.4(15)XZ
|
Cisco Unified CME 4.3
|
The dual-octo and octo keywords were added.
|
12.4(20)T
|
Cisco Unified CME 7.0
|
This command with the dual-octo and octo keywords was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
This command specifies whether ephone-dns that are created during fallback are dual-line, single-line, or octo-line ephone-dns. It applies only to the ephone-dns that are "learned" automatically from ephone configuration information, and not to ephone-dns that are manually configured in Cisco Unified CME.
If you use the dual-octo keyword, the type of ephone-dn that Cisco Unified CME in SRST mode creates depends on the phone type. It creates dual-line ephone-dns if the phone type is a Cisco Unified IP Phone 7902 or 7920, or an analog phone connected to the Cisco VG224 or Cisco ATA. It creates octo-line ephone-dns for all other phone types.
Use the show telephony-service ephone-dn command to display Cisco Unified CME parameters for ephone-dns.
Examples
The following example specifies dual-line mode for all SRST fallback ephone-dns.
telephony-service
srst dn line-mode dual
Related Commands
Command
|
Description
|
show telephony-service ephone-dn
|
Displays parameters for ephone-dns.
|
srst mode auto-provision
|
Enables SRST mode for a Cisco Unified CME router.
|
srst dn template
To specify an ephone-dn template to be used in Survivable Remote Site Telephony (SRST) mode on a Cisco Unified CallManager Express (Cisco Unified CME) router, use the srst dn template command in telephony-service configuration mode. To return to the default, use the no form of this command.
srst dn template template-tag
no srst dn template
Syntax Description
template-tag
|
Identifying number of an existing ephone-dn template. Range is from 1 to 15.
|
Command Default
No ephone-dn template is specified.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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 applies the specified ephone-dn template to all SRST fallback ephone-dns. Ephone-dn templates are created with the ephone-dn-template command.
Use the show telephony-service ephone-dn-template to display the contents of ephone-dn templates.
Examples
The following example applies ephone-dn template 2 to all SRST fallback ephone-dns.
telephony-service
srst dn template 2
Related Commands
Command
|
Description
|
ephone-dn-template
|
Enters ephone-dn-template configuration mode to create an ephone-dn template.
|
show telephony-service ephone-dn-template
|
Displays the contents of ephone-dn templates.
|
srst ephone description
To specify a description to be associated with an ephone in Survivable Remote Site Telephony (SRST) mode on a Cisco Unified CallManager Express (Cisco Unified CME) router, use the srst ephone description command in telephony-service configuration mode. To return to the default, use the no form of this command.
srst ephone description string
no srst ephone description
Syntax Description
string
|
Description to be associated with an ephone. Maximum string length is 100 characters.
|
Command Default
No description is specified.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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
Use the show telephony-service ephone to display the ephone description to be associated with SRST fallback phones.
Examples
The following example applies a description to all SRST fallback ephones.
telephony-service
srst ephone description srst fallback auto-provision phone
The following excerpt displays a time-stamped SRST description for ephone 1:
Router# show running-config
ephone 1
description srst fallback auto-provision phone : Jul 07 2005 17:45:08
ephone-template 5
mac-address 100A.7052.2AAE
button 1:1 2:2
Related Commands
Command
|
Description
|
show telephony-service ephone
|
Displays ephone settings.
|
srst ephone template
To specify an ephone template to be used in Survivable Remote Site Telephony (SRST) mode on a Cisco Unified CallManager Express (Cisco Unified CME) router, use the srst ephone template command in telephony-service configuration mode. To return to the default, use the no form of this command.
srst ephone template template-tag
no srst ephone template
Syntax Description
template-tag
|
Identifying number of an existing ephone template. Range is from 1 to 20.
|
Command Default
No ephone template is specified.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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
Ephone templates are created with the ephone-template command. This command applies the specified ephone template to all SRST fallback ephones.
Use the show telephony-service ephone-template to display the contents of ephone templates.
Examples
The following example applies ephone template 3 to all SRST fallback ephones.
telephony-service
srst ephone template 3
Related Commands
Command
|
Description
|
ephone-template
|
Enters ephone-template configuration mode to create an ephone template.
|
show telephony-service ephone-template
|
Displays the contents of ephone templates.
|
srst mode auto-provision
To enable Survivable Remote Site Telephony (SRST) mode for a Cisco Unified CallManager Express (Cisco Unified CME) router, use the srst mode auto-provision command in telephony-service configuration mode. To return to the default, use the no form of this command.
srst mode auto-provision {all | dn | none}
no srst mode auto-provision
Syntax Description
all
|
Includes information for learned ephones and ephone-dns in the running configuration.
|
dn
|
Includes information for learned ephone-dns in the running configuration.
|
none
|
Does not include information for learned ephones or learned ephone-dns in the running configuration. Use this keyword when you want Cisco Unified CME to provide SRST fallback services for Cisco Unified CallManager.
|
Command Default
SRST mode is disabled.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
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 puts a Cisco Unified CME router into SRST mode to provide fallback call-processing services for IP phones that have lost connection to their Cisco Unified CallManager. The phones can be preconfigured manually or the Cisco Unified CME-SRST router can dynamically learn their configuration. The keywords in this command allow you to specify how much of the learned phone configurations you want to include in the running configuration of the Cisco Unified CME-SRST router.
Use the none keyword to enable the Cisco Unified CME router to provide SRST fallback services for Cisco Unified CallManager. Use the dn or all keyword to enable the Cisco Unified CME router to learn the ephone-dn or ephone and ephone-dn configuration from Cisco Unified CallManager and include the information in its running configuration.
Note
We do not recommend that you use the dn or all keyword if you want Cisco Unified CME to provide SRST fallback services. After the Cisco Unified CME-SRST router learns the phone configuration from Cisco Unified CallManager and you save the configuration, the fallback phones are treated as locally configured phones on the Cisco Unified CME-SRST router which can adversely impact the fallback behavior of those phones.
Examples
The following example shows how to enable the Cisco Unified CME router to provide SRST fallback services for phones connected to Cisco Unified CallManager. Information for learned ephone-dns and ephones is not included in the running configuration.
telephony-service
srst mode auto-provision none
Related Commands
Command
|
Description
|
show telephony-service all
|
Displays detailed configuration for phones, voice ports, and dial peers in a Cisco Unified CME system.
|
srst dn line-mode
|
Specifies line mode for the ephone-dns that are automatically created in SRST mode on a Cisco Unified CME router.
|
standby username password
To specify that the standby (secondary backup) router XML interface is enabled, use the standby username password command in telephony-service configuration mode on the primary router. To disable the XML interface on the secondary backup router, use the no form of this command.
standby username username password password
no standby username username password password
Syntax Description
username
|
Specifies the username who is authorized to enable the XML interface.
|
password
|
Specifies the password to use for access.
|
Command Default
An authorized user is not named.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(15)XY
|
Cisco Unified CME 4.2(1)
|
This command was introduced.
|
12.4(15)XZ
|
Cisco Unified CME 4.3
|
This command was introduced.
|
12.4(20)T
|
Cisco Unified CME 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
Use this command to enable the XML interface on the secondary backup router. The username and password must be the same as that used for access to the primary router.
Examples
The following example enables the XML interface on the secondary backup router:
Router(config)# telephony-service
Router(config-telephony)# standby username admin password 1234
Related Commands
Command
|
Description
|
username password
|
To assign a login account username and password to a phone user so that the user can log in to the Cisco Unified CME router.
|
statistics collect
To enable the collection of call statistics for an ephone hunt group, use the statistics collect command in ephone-hunt configuration mode. To stop statistics collection and to delete statistics that have been collected, use the no form of this command.
statistics collect
no statistics collect
Syntax Description
This command has no arguments or keywords.
Command Default
The default is no call statistics data is collected.
Command Modes
Ephone-hunt configuration (config-ephone-hunt)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.3(11)XL
|
Cisco CME 3.2.1
|
This command was introduced.
|
12.3(14)T
|
Cisco CME 3.3
|
This command was integrated into Cisco IOS Release 12.3(14)T.
|
Usage Guidelines
This command is used for the collection of call statistics, such as direct calls to hunt group pilot numbers, or calls to the Basic Automatic Call Distribution (B-ACD) and Auto Attendant service. For detailed information, see Cisco Unified CME B-ACD and Tcl Call-Handling Applications.
The statistics collect can be used to activate statistics collection for any number of ephone hunt groups.
Statistics collection begins at the time that the statistics collect is entered. A maximum of one week (168 hours) of statistics can be stored at a time. You can display the statistics with the show hunt-group or transfer statistics automatically to files using TFTP. The no statistics collect deletes all statistics that have been collected.
All or some of the statistics can be output with the show hunt-group or sent to files automatically using TFTP by using the hunt-group report url hunt-group report every hours commands.
Examples
The following example enables the collection of call statistics for ephone hunt group 1 and ephone hunt group 2:
Router(config)# ephone-hunt 1
Router(config-ephone-hunt)# statistics collect
Router(config)# ephone-hunt 2
Router(config-ephone-hunt)# statistics collect
Related Commands
Command
|
Description
|
hunt-group report delay hours
|
Delays the automatic transfer of Cisco CME B-ACD call statistics to a file.
|
hunt-group report every hours
|
Sets the hourly interval at which Cisco CME B-ACD call data is automatically transferred to a file.
|
hunt-group report url
|
Sets filename parameters and the URL path where Cisco CME B-ACD call statistics are to be sent using TFTP.
|
show ephone-hunt statistics
|
Displays ephone-hunt configuration information and current status and statistics information.
|
statistics collect (voice hunt-group)
To enable the collection of call statistics for a voice hunt group, use the statistics collect command in voice hunt-group configuration mode. To return to the default, use the no form of this command.
statistics collect
no statistics collect
Syntax Description
This command has no arguments or keywords.
Command Default
No configuration statistics can be collected for voice hunt groups.
Command Modes
Voice hunt-group configuration (config-voice-hunt-group)
Command History
Release
|
Modification
|
15.2(2)T
|
This command was introduced.
|
Examples
The following example shows how to enable the collection of call statistics for voice hunt group 60:
Router(config)# voice hunt-group 60
Router(config-voice-hunt-group)# statistics collect
Related Commands
Command
|
Description
|
statistics collect
|
Enables the collection of call statistics for an ephone hunt group.
|
system message
To set a text message for display on idle Cisco IP Phones with display, such as Cisco IP Phone 7940 and Cisco IP Phone 7960, in a Cisco Unified Communications Manager Express (Cisco Unified CME) system, use the system message command in telephony-service configuration mode. To return to the default, use the no form of this command.
system message text-message
no system message
Syntax Description
text-message
|
Alphanumeric string of approximately 30 characters maximum to display when the phone is idle.
|
Command Default
The message "Cisco Unified Communications Manager Express" is displayed.
Command Modes
Telephony-service configuration (config-telephony)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.2(15)ZJ
|
Cisco Unified CME 3.0
|
This command was introduced.
|
12.3(4)T
|
Cisco Unified CME 3.0
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
Usage Guidelines
The number of characters that can be displayed is not fixed because IP phones typically use a proportional (as opposed to a fixed-width) font. There is room for approximately 30 alphanumeric characters.
The display message is refreshed with a new message after any of the following events occurs:
•
A busy phone goes back on-hook.
•
An idle phone receives a keepalive message.
•
A phone is restarted.
Examples
The following example sets the message "ABC Company" to display instead of "Cisco Unified Communications Manager Express" on idle Cisco IP Phones 7940 and 7940G and the Cisco IP Phones 7960 and 7960G:
Router(config)# telephony-service
Router(config-telephony)# system message ABC Company
Related Commands
Command
|
Description
|
telephony-service
|
Enters telephony-service configuration mode.
|
subnet
To define which IP phones are part of an emergency response location (ERL) for the enhanced 911 service, use the subnet command in voice emergency response location configuration mode. To remove the subnet definition, use the no form of this command.
subnet [1 | 2] IPaddress mask
no subnet [1 | 2]
Syntax Description
IPaddress
|
IP address that identifies which IP phones are part of the ERL.
|
mask
|
IP subnet mask for the network segment that is part of the ERL.
|
Command Default
No subnets are defined.
Command Modes
Voice emergency response location configuration (cfg-emrgncy-resp-location)
Command History
Cisco IOS Release
|
Cisco Product
|
Modification
|
12.4(15)T
|
Cisco Unified CME 4.1 Cisco Unified SRST 4.1 Cisco Unified SIP SRST 4.1
|
This command was introduced. For Cisco Unified CME, this command is supported in SRST fallback mode only.
|
12.4(15)XY
|
Cisco Unified CME 4.2(1) Cisco Unified SRST 4.2(1) Cisco Unified SIP SRST 4.2(1)
|
This command was added to Cisco Unified CME.
|
12.4(20)T
|
Cisco Unified CME 7.0 Cisco Unified SRST 7.0 Cisco Unified SIP SRST 7.0
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
Use this command to define the groups of IP phones that are part of an ERL. You can create up to 2 different subnets. To include all phones on a single ERL, you can set the subnet mask to 0.0.0.0 to indicate a "catch-all" subnet.
Examples
In the following example, all IP phones with the IP address of 10.X.X.X or 192.168.X.X are automatically associated with this ERL. If one of the phones dials 911, its extension is replaced with 408 555-0100 before it goes to the PSAP. The PSAP will see that the caller's number is 408 555-0100.
voice emergency response location 1
subnet 10.0.0.0 255.0.0.0
subnet 2 192.168.0.0 255.255.0.0
Related Commands
Command
|
Description
|
elin
|
Specifies a PSTN number that will replace the caller's extension.
|