Americas Headquarters

Cisco Systems, Inc.
170 West Tasman Drive
San J ose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
Cisco Unif ied
Communications Manager Express
Command Ref erence
October 22, 2009
Text Part Number: OL-10894-01
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco SensorBase, Cisco StackPower,
Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra,
Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital,
Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, Flip Gift Card, and One Million Acts of Green are service marks; and Access Registrar, Aironet, AllTouch,
AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo,
Cisco IOS, Cisco Lumin, Cisco Nexus, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation,
Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Follow Me Browsing, GainMaker, iLYNX, IOS, iPhone, IronPort, the IronPort logo, Laser Link, LightStream,
Linksys, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design),
PowerVu, Prisma, ProConnect, ROSA, SenderBase, SMARTnet, Spectrum Expert, StackWise, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc.
and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship
between Cisco and any other company. (0910R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, display output, and figures included in the document are
shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
Cisco Unified Communications Manager Express Command Reference
OL-10894-01
Copyright © 2005-2009 Cisco Systems, Inc. All rights reserved.
iii
Cisco Unified CME Command Reference
OL-10894-01
C O N T E N T S
Preface 5
Obt ai ni ng Document at i on, Obt ai ni ng Support , and Securi t y Gui del i nes 5
Addi t i onal Ref erences 5
Command List by Config Mode 7
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0 and Later 17
Cisco Unified CME Commands: A 29
Cisco Unified CME Commands: B 81
Cisco Unified CME Commands: C 111
Cisco Unified CME Commands: D 249
Cisco Unified CME Commands: Debug 291
Cisco Unified Commands: E 369
Cisco Unified CME Commands: F 417
Cisco Unified CME Commands: H 449
Cisco Unified CME Commands: I 477
Cisco Unified CME Commands: K 497
Cisco Unified CME Commands: L 511
Cisco Unified CME Commands: M 555
Cisco Unified CME Commands: N 629
Cisco Unified CME Commands: O 681
Cisco Unified CME Commands: P 683
Cisco Unified CME Commands: R 833
iv
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: sast1 trustpoint through show fb-its-log 861
Cisco Unified CME Commands: show presence global through subnet 983
Cisco Unified CME Commands: T 1121
Cisco Unified CME Commands: U 1189
Cisco Unified CME Commands: V 1221
Cisco Unified CME Commands: W 1279
Cisco Unified CME Commands: X 1287
Index
5
Cisco Unified CME Command Reference
OL-10894-01
Preface
Revised: March 8, 2007
Obtaining Documentation, Obtaining Support, and Security
Guidelines
For information on obtaining documentation, obtaining support, providing documentation feedback,
security guidelines, and also recommended aliases and general Cisco documents, see the monthly What's
New in Cisco Product Documentation, which also lists all new and revised Cisco technical
documentation at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html.
Additional References
Cisco Unified Communications Manager Express:
http://www.cisco.com/en/US/products/sw/voicesw/ps4625/tsd_products_support_series_home.html
Cisco Unified IP Phones:
http://www.cisco.com/en/US/products/sw/voicesw/ps4625/products_user_guide_list.html
Cisco SIP Configuration Guide:
http://www.cisco.com/en/US/docs/ios/voice/sip/configuration/guide/12_4t/sip_12_4t_book.html
Cisco Unified SRST:
http://www.cisco.com/en/US/products/sw/voicesw/ps2169/tsd_products_support_series_home.html
Cisco 12.4T Release:
http://www.cisco.com/en/US/products/ps6441/tsd_products_support_series_home.html
6
Cisco Unified CME Command Reference
OL-10894-01
Preface
Additional References
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT
NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT
ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR
THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE
INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU
ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A
COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as
part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE
PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED
OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL
DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR
INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, the Cisco logo, DCE, and
Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access
Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the
Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity,
Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink,
Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime
Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase,
SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are
registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply
a partnership relationship between Cisco and any other company. (0809R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, display output, and figures
included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and
coincidental.
Cisco Unified Communications Manager Express Command Reference
OL-10894-01
Copyright © 2005-2009 Cisco Systems, Inc. All rights reserved.
7
Cisco Unified CME Command Reference
OL-10894-01
Command List by Conf ig Mode
Revised: February 27, 2009
First Published: October 22, 2009
A
application-parameter configuration
param aa-hunt 688
param aa-pilot 690
param call-retry-timer 693
param co-did-max 696
param co-did-min 698
param dial-by-extension-option 700
param did-prefix 702
param drop-through-option 704
param drop-through-prompt 706
param ea-password 708
param hand-off string 710
param max-extnsion-length 712
param max-time-call-retry 714
param max-time-vm-retry 717
param menu-timeout 719
param number-of-hunt-grps 721
param queue-exit-extension 723
param queue-exit-option 725
param queue-len 729
param queue-manager-debug 731
param queue-overflow-extension 727
param secondary-prefix 733
param second-greeting-time 735
param send-account true 737
param service-name 739
param store-did-max 741
param store-did-min 743
param voice-mail 745
param welcome-prompt 747
C
CAPF-server configuration
auth-mode 59
cert-enroll-trustpoint 189
cert-oper 191
keygen-retry 503
phone-key-size 772
port 788
source-addr 1093
trustpoint-label 1173
credentials configuration
ctl-service admin 242
ip source-address 489
trustpoint 1171
CTL-client configuration
regenerate 833
sast1 trustpoint 858
sast2 trustpoint 859
server 873
D
dial peer configuration
lpcor outgoing 546
dial-peer configuration
b2bua 78
emergency response callback 375
emergency response location 377
emergency response zone 379
Index
8
Cisco Unified CME Command Reference
OL-10894-01
mailbox-selection 555
paramspace callsetup after-hours-exempt 751
E
ephone configuration
after-hour exempt 32, 34
auto-line 72
blf-speed-dial 80
bulk-speed-dial-list 87
busy-trigger-per-button 92
button 97
capf-auth-str 186
codec 205
conference add-mode 214
conference admin 216
conference drop-mode 218
description 249
device-security-mode 260
dnd feature-ring 277
emergency response location 377
ephone-template 401
fastdial 419
feature-button 423
headset auto-answer line 446
keepalive 494
keep-conference 498
keypad-normalize 504
keyphone 505
logout-profile 538
lpcor incoming 544
lpcor outgoing 546
lpcor type 549
mac-address 552
max-calls-per-button 558
missed-calls 578
mtp 597
multicast-moh 601
mwi-line 619
night-service bell 641
nte-end-digit-delay 660
paging-dn 685
park reservation-group 753
phone-ui speeddial-fastdial 775
pin 784
presence call-list 806
privacy (ephone) 811
privacy-button 819
provision-tag 827
reset 837
reset tapi 846
restart 847
speed-dial 1096
trantsfer-park blocked 1152
trantsfer-pattern blocked 1156
type 1176
username 1212
video 1222
vm-device-id 1225
ephone template configuration
lpcor incoming 544
lpcor outgoing 546
snr calling-number local 1069
ephone-dn configuration
allow watch 46
caller-id 140
caller-id block 142
call-forward all 153
call-forward busy 165
call-forward max-length 168
call-forward night-service 170
call-forward noan 172
call-waiting beep 182
call-waiting ring 184
conference 211
cor 222
corlist 226
cti notify 235
Index
9
Cisco Unified CME Command Reference
OL-10894-01
cti watch 238
description 250
ehone-dn-template 389
ephone-hunt login 394
feed 427
forward local-calls 435
hold-alert 448
huntstop 465
intercom 481
label 508
loopback-dn 541
mailbox-selection 557
mobility 587
moh 589
moh-group 596
mwi 603
mwi qsig 609
mwi sip 614
mwi-type 622
name 626
night-service bell 643
number 663
paging 680
paging group 683
park-slot 756
pickup-call any-group 776
pickup-group 778
preference 794
ring 854
session-server 904
snr 1067
timeouts transfer-recall 1136
transfer-mode 1150
translate 1161
translation-profile 1165
trunk 1168
whisper-intercom 1281
ephone-dn-template configuration
allow watch 46
caller-id block 142
call-forward all 153
call-forward busy 165
call-forward max-length 168
call-forward night-service 170
call-forward noan 172
call-waiting beep 182
call-waiting ring 184
cti notify 235
cti watch 238
description 250
hold-alert 448
huntstop 465
mwi 603
mwi qsig 609
mwi sip 614
mwi-type 622
pickup-group 778
timeouts transfer-recall 1136
translate 1161
translation-profile 1165
ephone-hunt configuration
auto logout 66
description 252
display-logout 275
final 432
forward local-calls 435
from-ring 438
fwd-final 440
hops 451
list 512
max-timeout 577
no-reg 657
pilot 780
preference 796
present-call 809
secondary start 866
statistics collect 1111
timeout 1128
Index
10
Cisco Unified CME Command Reference
OL-10894-01
ephone-template configuration
after-hour exempt 32, 34
after-hours block pattern 36
after-hours date 38
after-hours day 40
after-hours override-code 42
busy-trigger-per-button 92
button-layout 104
codec 205
conference add-mode 214
conference admin 216
conference drop-mode 218
emergency response location 377
fastdial 419
feature-button 423
features blocked 425
keepalive 494
keep-conference 498
keypad-normalize 504
keyphone 505
max-calls-per-button 558
mlpp indication 579
mlpp max-precedence 581
mlpp preemption 583
mlpp service-domain 585
mtp 597
multicast-moh 601
network-locale 631
night-service bell 641
nte-end-digit-delay 660
paging-dn 685
park reservation-group 753
privacy (ephone) 811
privacy-button 819
service phone 895
softkeys alerting 1070
softkeys connected 1072
softkeys hold 1076
softkeys idle 1078
softkeys remote-in-use 1082
softkeys ringing 1087
softkeys seized 1089
speed-dial 1096
transfer max-length 1147
trantsfer-park blocked 1152
trantsfer-pattern blocked 1156
type 1176
url services 1198
user-locale 1204
ephone-type configuration
addon 29
device-id 255
device-name 257
device-type 258
max-presentation 573
num-buttons 674
phoneload 773
security 870
utf8 1215
G
global configuration
call application voice aa-hunt 108
call application voice aa-name 110
call application voice aa-pilot 112
call application voice call-retry-timer 114
call application voice dial-by-extension-option 116
call application voice drop-through-prompt 119
call application voice handoff-string 120
call application voice max-extension-length 121
call application voice max-time-call-retry 122
call application voice max-time-vm-retry 124
call application voice number-of-hunt-grps 125
call application voice queue-len 127
call application voice queue-manager-debugs 129
call application voice second-greeting-time 131
call application voice voice-mail 134
Index
11
Cisco Unified CME Command Reference
OL-10894-01
call application voice welcome-prompt 136
capf-server 188
credentials 231
ctl-client 241
ephone 383
ephone-dn 385
ephone-dn-template 387
ephone-hunt 391
ephone-template 398
ephone-type 404
integration 1226
presence 804
telephony-service 1118
voice emergency response location 1230
voice emergency response settings 1232
voice emergency response zone 1234
voice hunt-group 1236
voice logout-profile 1239
voice mlpp 1254
voice moh-group 1255
voice register dialplan 1257
voice register dn 1259
voice register global 1261
voice register pool 1263
voice register session-server 1265
voice register template 1267
voice user-profile 1269
group configuration
url 1191
L
lpcor ip-phone subnet configuration
index 477
lpcor IP-trunk subnet configuration
index 479
lpcor policy configuration
accept 26
P
presence configuration
max-subscription 576
presence call-list 806
server 875
S
SIP configuration
registrar server 835
SIP UA configuration
presence enable 808
refer-ood enable 832
standby username password 1110
T
telephony-service configuration
after-hour login http 34
after-hours block pattern 36
after-hours date 38
after-hours day 40
after-hours override-code 42
after-hours pstn-prefix 44
application 49
authentication credential 57
auto assign 62
auto-reg-ephone 74
bulk-speed-dial-list 87
bulk-speed-dial-prefix 90
caller-id block code 146
call-forward 149
call-forward pattern 175
calling-number local 177
call-park system 180
cnf-file 201
cnf-file location 203
codec 208
Index
12
Cisco Unified CME Command Reference
OL-10894-01
conference hardware 220
create cnf-files 228
date-format 246
device-security-mode 260
dialplan-pattern 264
directory 271
directory entry 273
dn-webedit 280
em external 370
em keep-history 381
em logout 382
extension-assigner tag-type 408
fac 415
fxo hook-flash 442
hunt-group logout 454
hunt-group report delay hours 456
hunt-group report every hours 458
hunt-group report url 460
internal-call 484
ip qos dscp 487
ip source-address 491
keepalive 496
live-record 517
load 520
load-cfg-file 526
log password 531
log table 532
login 535
max-conferences 560
max-dn 562
max-ephones 566
max-redirect 575
moh 592
moh-file-buffer 594
multicast moh 599
mwi expires 606
mwi prefix 607
mwi reg-e164 611
mwi relay 613
mwi sip-server 616
network-locale 634
night-service code 645
night-service date 647
night-service day 649
night-service everyday 651
night-service weekday 653
night-service weekend 655
privacy 813
privacy-on-hold 823
protocol-mode 825
reset 839
restart 849
sdspfarm 861
sdspfarm conference mute-on mute-off 860
sdspfarm transcode sessions 863
sdspfarm units 864
sdspfarm unregister force 865
secondary-dialtone 868
secure-signaling trustpoint 869
server-security-mode 877
service directed-pickup 880
service dnis dir-lookup 882
service dnis overlay 886
service dss 892
service local-directory 894
service phone 895
srst dn line-mode 1103
srst dn template 1105
srst ephone description 1106
srst ephone template 1107
srst mode auto-provision 1108
standby username password 1110
system message 1113
tftp-server-credentials trustpoint 1125
time-format 1126
timeouts busy 1131
timeouts interdigit 1132
timeouts night-service-bell 1134
Index
13
Cisco Unified CME Command Reference
OL-10894-01
timeouts ringing 1133
timeouts transfer-recall 1136
time-webedit 1138
time-zone 1140
transfer-digit-collect 1145
transfer-pattern 1154
transfer-system 1158
url 1191
url authentication 1189
url idle 1197
user-locale 1207
video 1224
voicemail 1271
web admin custome 1276
web admin system 1278
web customize load 1280
xml user 1284
xmlschema 1286
xmltest 1287
xmlthread 1288
trunk group configuration
lpcor incoming 544
lpcor outgoing 546
V
video configuration
maximum bit-rate 570
voice emergency response location configuration
address 30
elin 366
name 628
subnet 1114
voice emergency response settings configuration
callback 138
elin 368
expiry 406
logging 533
voice emergency response zone configuration
location 529
voice hunt-group configuration
default 248
final 434
hops 453
list 515
pilot 782
preference 798
timeout 1130
voice logout-profile configuration
feature-button 423
number 668
pin 786
privacy-button 819
reset 843
speed-dial 1099
user 1200
voice MLPP configuration
access-digit 28
attendant-console 54
bnea 82
bpa 83
ica 474
loc2 527
preemption reserve timer 789
preemption tone timer 790
preemption trunkgroup 792
preemption user 793
voice moh-group configuration
description 253
extension-range 410
voice port configuration
lpcor incoming 544
lpcor outgoing 546
voice register dialplan configuration
filename 430
pattern 760
type 1180
voice register dn configuration
Index
14
Cisco Unified CME Command Reference
OL-10894-01
allow watch 46
auto-answer 70
call-forward b2bua all 155
call-forward b2bua busy 157
call-forward b2bua mailbox 159
call-forward b2bua noan 161
call-forward b2bua unreachable 163
huntstop 469
label 510
mwi 605
name 630
no-reg 659
number 666
pickup-call any-group 776
pickup-group 778
preference 800
refer target dial-peer 830
session-server 904
shared-line 908
translation-profile incoming 1167
voice register global configuration
application 50
authenticate 55
bulk 85
call-feature-uri 147
call-forward 151
create profile 230
date-format 247
dialplan-pattern 267
dst 281
dst auto-adjust 283
external-ring 412
forwarding local 437
hold-alert 450
ip qos dscp 487
logo 537
max-dn 564
max-pool 571
mode 588
mwi reg-e164 612
mwi stutter 618
ntp-server 662
outbound-proxy system 678
phone-redirect-limit 774
privacy 815
privacy-on-hold 824
reset 844
restart 852
source-address 1094
tftp-path 1124
time-format 1127
timezone 1142
upgrade 1187
url 1195
voicemail 1272
voice register pool configuration
application 52
blf-speed-dial 80
busy-trigger-per-button 94
call-forward b2bua all 155
call-forward b2bua busy 157
call-forward b2bua mailbox 159
call-forward b2bua noan 161
call-forward b2bua unreachable 163
call-waiting 181
codec 209
cor 223
description 254
dialplan 262
digit collect kpml 270
dnd 276
dtmf-relay 284
emergency response location 377
fastdial 421
id 475
keep-conference 501
lpcor incoming 544
lpcor outgoing 546
Index
15
Cisco Unified CME Command Reference
OL-10894-01
number 672
park reservation-group 753
preference 802
presence call-list 806
privacy initial-state 817
privacy-button 821
reset 845
restart 852
session-server 904
session-transport 906
speed-dial 1101
template 1122
translate-outgoing 1163
type 1182
username 1214
vad 1218
voice-class codec 1228
voice register session-server configuration
keepalive 497
register-id 834
voice register template configuration
anonymous block 48
caller-id block 144
conference 213
dialplan 262
digit collect kpml 270
dnd-control 279
emergency response location 377
lpcor incoming 544
lpcor outgoing 546
park reservation-group 753
privacy initial-state 817
privacy-button 821
semi-attended enable 871
session-transport 906
softkeys connected 1074
softkeys idle 1080
softkeys remote-in-use 1083
softkeys ringing 1085
softkeys seized 1091
transfer-attended 1148
transfer-blind 1149
vad 1219
voicemail 1273
voice service configuration
lpcor incoming 544
voice session-server configuration
cti-aware 240
voice user-profile configuration
feature-button 423
max-idle-time 568
number 668
pin 786
privacy-button 819
reset 843
speed-dial 1099
user 1202
voice-gateway system configuration
create cnf-files 229
mac-address 554
network-locale 639
reset 842
restart 851
type 1179
voice-port 1256
voice-mail integration configuration
pattern direct 762
pattern ext-to-ext busy 764
pattern ext-to-ext no-answer 766
pattern trunk-to-ext busy 768
pattern trunk-to-ext no-answer 770
voice-moh-group configuration
multicast moh 599
voice-port configuration
mlpp indication 579
mlpp max-precedence 581
mlpp preemption 583
mlpp service-domain 585
voice-service configuration
Index
16
Cisco Unified CME Command Reference
OL-10894-01
cti csta mode basic 193, 233
cti message device-id suppress-conversion 234
cti shutdown 237
17
Cisco Unified CME Command Reference
OL-10894-01
New, Modified, Replaced, and Removed Commands for
Cisco Unified CME 4.0 and Later
Revised: February 27, 2009
First Published: October 22, 2009
New, modified, replaced, and removed commands for Cisco Unified Communications Manager Express 4.0
(Cisco Unified CME) and later versions are grouped by Cisco IOS release and type, and ordered alphabetically within each
group. Use the table of contents to go to a group of commands, or use your web browser's Find function to search for a
command. To access the documentation for a command, click the highlighted page number following the command name.
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
18
Cisco Unified CME Command Reference
OL-10894-01
12.4(4)XC
New Commands
auth-mode 63
auto-reg-ephone 78
bulk-speed-dial list 91
bulk-speed-dial prefix 94
call-forward night-service 174
call-forward system (voice register) command 155
call-forward system command 153
call-park system 184
capf-auth-str 190
capf-server 192
cert-enroll-trustpoint 193
cert-oper (CAPF-server) 195
clear telephony-service
ephone-attempted-registrations 202
clear telephony-service xml-event-log 203
cnf-file 205
cnf-file location 207
codec (ephone) 209
codec (telephony-service) 212
ctl-client 245
ctl-service admin 246
description (ephone-hunt) 256
device-security-mode 264
dialplan-pattern (voice register) 271
display-logout 279
ephone-dn-template 391
ephone-dn-template (ephone-dn) 393
ephone-hunt login 398
ephone-hunt statistics write-all 400
fac 418
features blocked 429
forward local-calls 439
from-ring 442
headset auto-answer line 450
hunt-group logout 458
keygen-retry 507
keypad-normalize 508
load-cfg-file 530
mailbox-selection (ephone-dn) 561
maximum bit-rate (telephony-video) 574
max-timeout command 581
mtp 601
multicast-moh 605
mwi-line 623
mwi prefix 611
mwi qsig 613
network-locale (ephone-template) 635
param co-did-max 700
param co-did-min 702
param did-prefix 706
param secondary-prefix 737
param send-account true 741
param store-did-max 745
param store-did-min 747
phone-key-size 776
port (CAPF-server) 792
present-call 813
regenerate 837
ring (ephone-dn) 858
sast1 trustpoint 862
sast2 trustpoint 863
secondary start 870
secure-signaling trustpoint 873
server (CTL-client) 877
server-security-mode 881
service directed-pickup 884
show capf-server 914
show ctl-client 920
show ephone attempted-registratrations 926
softkeys hold 1080
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
19
Cisco Unified CME Command Reference
OL-10894-01
source-addr 1097
srst dn line-mode 1107
srst dn template 1109
srst ephone template 1111
srst mode auto-provision 1112
tftp-server-credentials trustpoint 1129
transfer max-length 1151
transfer-park blocked 1156
transfer-pattern blocked command 1160
trustpoint-label 1177
user-locale (ephone-template) 1208
video (ephone) 1226
video (telephony-service) 1228
xml user 1288
Modified Commands
after-hour exempt 36
auto assign 65
auto-line 76
auto logout 70
button 100
caller-id block (ephone-dn and ephone-dn-template) 146
call-forward all 157
call-forward busy 169
call-forward max-length 172
call-forward noan 176
call-waiting beep 186
call-waiting ring 188
create cnf-files 232
credentials 235
description (ephone-dn and ephone-dn-template) 254
ephone-hunt 395
ephone-template 402
ephone-template (ephone) 405
fastdial 423
hold-alert 452
hops 455
hunt-group report url 464
huntstop (ephone-dn and ephone-dn-template) 469
ip source-address (credentials) 493
ip source-address (telephony-service) 495
keepalive (ephone and ephone-template) 498
keep-conference 502
list (ephone-hunt) 516
load (telephony-service) 523
log password 535
mwi (ephone-dn and ephone-dn-template) 607
mwi sip 618
mwi sip-server 620
network-locale (telephony service) 637
night-service bell 645
paging-dn 689
park-slot 759
pickup-group 782
show credentials 916
show ephone 921
softkeys connected 1076
softkeys idle 1082
softkeys seized 1093
speed-dial 1100
timeout (ephone-hunt) 1132
transfer-system 1162
translate (ephone-dn) 1165
translation-profile 1169
trunk 1172
trustpoint (credentials) 1175
type 1178
user-locale (telephony-service) 1210
Obsolete Commands
xmlschema 1290 xmltest 1291
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
20
Cisco Unified CME Command Reference
OL-10894-01
xmlthread 1292
12.4(4)XC4
New Commands
button-layout 108
extension-assigner tag-type 412
mwi-type 626
param ea-password 712
provision-tag 831
service dss 896
Modified Commands
auto assign 65
load (telephony-service) 523
show ephone 921
type 1178
12.4(6)XE
New Commands
button-layout 108
mwi-type 626
service dss 896
Modified Commands
auto assign 65
load (telephony-service) 523
show ephone 921
type 1178
12.4(11)XJ
New Commands
allow watch command 50
call-feature-uri 151
dialplan 266
digit collect kpml 274
extension-assigner tag-type 412
fastdial (voice register pool) 425
filename 434
max-subscription 580
param ea-password 712
pattern (voice register dialplan) 764
presence 808
presence call-list 810
presence enable 812
provision-tag 831
refer-ood enable 836
restart (voice register) 856
server (presence) 879
session-transport 910
show presence global 984
show presence subscription 986
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
21
Cisco Unified CME Command Reference
OL-10894-01
softkeys seized (voice register template) 1095
translation-profile incoming 1171
type (voice register dialplan) 1184
Modified Commands
authenticate (voice register global) 59
call-forward b2bua all 159
call-forward b2bua busy 161
call-forward b2bua mailbox 163
call-forward b2bua noan 165
load (voice register global) 527
number (voice register pool) 676
type (voice register pool) 1186
voice register template 1271
Removed Commands
caller-id block (voice register template) 148 call-forward b2bua unreachable 167
12.4(11)XJ 2
New Commands
clear telephony-service conference hardware number 201
conference (ephone-dn) 215
conference add-mode 218
conference admin 220
conference drop-mode 222
conference hardware 224
sdspfarm conference mute-on mute-off command 864
Modified Commands
auto assign 65
button 100
load (telephony-service) 523
login (telephony-service) 539
show ephone 921
show telephony-service ephone-template 1013
softkeys connected 1076
softkeys hold 1080
softkeys idle 1082
softkeys seized 1093
type 1178
12.4(11)XW
New Commands
logout-profile 542
reset (voice logout-profile and voice user-profile) 847
session-server 908
softkeys ringing 1091
speed-dial (voice rlogout-profile and voice
user-profile) 1103
url services 1202
user (voice logout-profile) 1204
user (voice user-profile) 1206
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
22
Cisco Unified CME Command Reference
OL-10894-01
voice logout-profile 1243 voice user-profile 1273
Modified Commands
device-security-mode 264
12.4(11)XW2
New Commands
keepalive (voice register session-server) 501
pin (voice logout-profile and voice user-proifle) 790
refer target dial-peer 834
register-id 838
voice register session-server 1269
12.4(11)XW3
Modified Commands
auto assign 65
load (telephony-service) 523
show ephone 921
12.4(11)XW5
New Commands
11xw5a timeouts night-service-bell 1138
12.4(15)XY
New Commands
address (voice emergency response location) 34
after-hours override-code 46
after-hours pstn-prefix 48
callback (voice emergency response settings) 142
elin (voice emergency response settings) 372
expiry 410
keepalive (voice register session-server) 501
location (voice emergency response zone) 533
logging (voice emergency response settings) 537
logout-profile 542
name (voice emergency response location) 632
pin (voice logout-profile and voice user-profile) 790
refer target dial-peer 834
register-id 838
reset (voice logout-profile and voice user-profile) 847
session-serverr 908
show voice emergency 1022
show voice emergency addresses 1023
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
23
Cisco Unified CME Command Reference
OL-10894-01
show voice emergency all 1025
show voice emergency zone 1028
softkeys ringing 1091
speed-dial (voice rlogout-profile and voice
user-profile) 1103
standby username password 1114
url service 1202
user (voice logout-profile) 1204
user (voice user-profile) 1206
voice emergency response settings 1236
voice emergency response zone 1238
voice logout-profile 1243
voice register session-server 1269
voice user-profile 1273
Modified Commands
after-hours block pattern 40
after-hours date 42
after-hours day 44
device-security-mode 264
emergency response callback 379
emergency response location 381
emergency response zone 383
show telephony-service ephone-template 1013
show voice emergency callers 1027
show voice register pool 1055
show voice register template 1063
subnet 1118
voice emergency response location 1234
12.4(15)XZ
New Commands
addon 33
authentication credential 61
busy-trigger-per-button 96
device-id 259
device-name 261
device-type 262
em keep-history 385
em logout 386
ephone-type 408
keepalive (voice register session-server) 501
live-record 521
logout-profile 542
max-calls-per-button 562
max-idle-time 572
max-presentation 577
missed-calls all 582
num-buttons 678
outbound-proxy system 682
phoneload 777
phone-ui speeddial-fastdial 779
pin (voice logout-profile and voice user-profile) 790
privacy (ephone) 815
privacy (telephony-service) 817
privacy-button 823
privacy-on-hold 827
refer target dial-peer 834
register-id 838
reset (voice logout-profile and voice user-profile) 847
security 874
session-server 908
softkeys remote-in-use 1086
softkeys ringing 1091
speed-dial (voice rlogout-profile and voice
user-profile) 1103
timeouts transfer-recall 1140
transfer-digit-collect 1149
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
24
Cisco Unified CME Command Reference
OL-10894-01
url authentication 1193
url services 1202
user (voice logout-profile) 1204
user (voice user-profile) 1206
utf8 1219
voice logout-profile 1243
voice register session-server 1269
voice user-profile 1273
Modified Commands
codec (ephone) 209
codec (telephony-service) 212
codec (voice register pool) 213
device-security-mode 264
ephone-dn 389, 427
ephone-template (ephone) 405
fac 418
huntstop (ephone-dn and ephone-dn-template) 469
list (voice hunt-group) 519
load (telephony-service) 523
load (voice register global) 527
max-ephones 570
service phone 899
softkeys connected 1076
srst dn line-mode 1107
type 1178
type (voice register dialplan) 1184
type (voice register pool) 1186
voice hunt-group 1240
12.4(15)T
New Commands
type 1178
12.4(15)T1
Modified Commands
elin 370
emergency response callback 379
emergency response location 381
emergency response zone 383
show voice emergency callers 1027
subnet 1118
voice emergency response location 1234
12.4(20)YA
New Commands
reset tapi 850
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
25
Cisco Unified CME Command Reference
OL-10894-01
Modified Commands
load (telephony-service) 523
param max-time-call-retry 718
user-locale (telephony-service) 1210
12.4(20)T
New Commands
nte-end-digit-delay 664
Modified Commands
auto assign 65
12.4(20)T1
Modified Commands
type 1178
12.4(22)YA
New Commands
param queue-exit-extension 727
param queue-exit-option 729
param queue-overflow-extension 731
Modified Commands
param menu-timeout 723
12.4(22)T
New Commands
server-security-mode 881 url (telephony service) 1195
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
26
Cisco Unified CME Command Reference
OL-10894-01
12.4(22)YB
New Commands
debug ephone whisper-intercom 355
create cnf-files (voice-gateway) 233
debug ephone mlpp 329
debug shared-line 361
ip qos dscp (telephony-service and voice regoster
global) 490
mac-address (voice-gateway) 558
mobility (ephone-dn) 591
netwrok-locale (voice-gateway) 643
park reservation-group 757
pickup-call any-group 780
privacy (voice register global) 819
privacy (voice register pool) 821
privacy-button (voice register pool) 825
privacy-on-hold (voice register global) 828
reset (voice-gateway) 846
restart (voice-gateway) 855
shared-line 912
show ephone-dn whisper 950
show shared-line 996
snr 1071
softkeys remote-in-use (voice register template) 1087
softkeys ringin (voice register template) 1089
type (voice-gateway) 1183
voice-gateway system 1239
voice-port (voice-gateway) 1260
whisper-intercom 1285
bnea 86
bpa 87
mlpp indication 583
mlpp max-precedence 585
mlpp preemption 587
preemption reserve timer 793
preemption tone timer (voice MLPP) 794
preemption trunkgroup 796
preemption user 797
voice mlpp 1258
24YFa clear cti session 198
Modified Commands
busy-trigger-per-button (voice register pool) 98
call-feature-uri 151
call-park system 184
fac 418
huntstop (voice register dn) 473
max-dn (voice register global) 568
max-pool (voice register pool) 575
park-slot 759
pickup-group 782
service directed-pickup 884
show presence subscription 986
softkeys connected 1076
softkeys idle 1082
12.4(24)T
New Commands
access-digit 32 attendant-console 58
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
27
Cisco Unified CME Command Reference
OL-10894-01
12.4(24)T1
Modified Commands
max-redirect 579
15.0(1)XA
New Commands
accept 30
after-hour login http 38
clear voice lpcor statistics 199, 204
clear voice moh-group statistics 200
cti-aware 244
cti csta mode basic 197, 237
cti message device-id suppress-conversion 238
cti notify 239
cti shutdown 241
cti watch 242
debug cti 302
debug ephone lpcor 326
description (voice moh-group) 257
emadmin login 376
emadmin logout 378
em external 374
extension-range 414
feature-button 427
ica 478
index (lpcor ip-phone) 481
index (lpcor ip-trunk) 483
internal-call 488
loc2 531
lpcor outgoing 550
lpcor type 553
lpor incoming 548
mlpp service-domain 589
moh-file-buffer 598
moh-group (ephone-dn) 600
protocol-mode (telephony-service) 829
show cti 918
show voice moh-group 1032
show voice moh-group statistics 1034
voice moh-group 1259
Modified Commands
fac 418
multicast moh 603
show ephone summary 945
url (telephony-service) 1195
New, Modified, Replaced, and Removed Commands for Cisco Unified CME 4.0and Later
28
Cisco Unified CME Command Reference
OL-10894-01
29
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: A
Revised: October 23, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified CME Commands: A
accept
30
Cisco Unified CME Command Reference
OL-10894-01
accept
To allow a logical partitioning class of restriction (LPCOR) policy to accept calls associated with another
resource-group, use the accept command in LPCOR policy configuration mode. To reject calls
associated with a resource group, use the no form of this command.
accept lpcor-group
no accept lpcor-group
Syntax Description
Command Default Calls from other resource groups are rejected; calls from this resource group are accepted.
Command Modes LPCOR policy configuration (cfg-lpcor-policy)
Command History
Usage Guidelines Use this command to create a LPCOR policy by specifying the other resource groups from which this
resource group can accept calls. If a resource group is not explicitly set to accept with this command,
calls associated with that resource-group policy are rejected. You can create one LPCOR policy for each
resource group.
If you create a LPCOR policy using the voice lpcor policy command and do not explicitly accept any
other resource groups by using the accept command, that policy blocks all incoming calls associated
with any LPCOR resource group other than its own.
Examples The following example shows the LPCOR policy for the resource group named sccp_phone_local. It
accepts calls from the resource groups analog_phone_local and sip_phone_local but rejects calls from
the group named analog_phone_remote because it is not included in the policy.
voice lpcor policy sccp_phone_local
accept analog_phone_local
accept sip_phone_local

The following example shows that sccp_phone_local blocks calls that are associated with any other
LPCOR policy because its policy does not accept other resource groups.
voice lpcor policy sccp_phone_local

lpcor-group Name of the LPCOR resource group.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified CME Commands: A
accept
31
Cisco Unified CME Command Reference
OL-10894-01
The following example shows that the policy local_phone is configured to not accept any calls associated
with itself. SIP phone 1 and SCCP phone 2 both belong to the local_phone resource group and its policy
prevents them from accepting calls from each other.
voice register pool 1
lpcor type local
lpcor incoming local_phone
lpcor outgoing local_phone
id mac 0021.A02D.B360
type 7960
number 1 dn 1
!
voice lpcor custom
group 1 local_phone
group 2 remote_phone
group 3 analog_phone
!
voice lpcor policy local_phone
no accept local_phone
accept analog_phone
!
ephone 2
lpcor type local
lpcor incoming local_phone
lpcor outgoing local_phone
mac-address 0021.A02D.B580
type 7960
button 1:10
Related Commands Command Description
show voice lpcor policy Displays the LPCOR policy for the specified resource group.
voice lpcor custom Defines the LPCOR resource groups on the Cisco Unified CME router.
voice lpcor policy Creates a LPCOR policy for a resource group.
Cisco Unified CME Commands: A
access-digit
32
Cisco Unified CME Command Reference
OL-10894-01
access-digit
To define the access digit that phone users dial to request a precedence call, use the access-digit
command in voice MLPP configuration mode. To reset to the default, use the no form of this command.
access-digit digit
no access-digit
Syntax Description
Command Default Access digit is 0.
Command Modes Voice MLPP configuration (config-voice-mlpp)
Command History
Usage Guidelines This command defines the MLPP access digit that a user must dial when making a precedence call.
Phone users request a precedence call by dialing the prefix NP, where N is the preconfigured MLPP
access digit and P is the requested precedence level, followed by the phone number.
Note Your domain type must support the access digit that you select. For example, the valid range for the DSN
is 2 to 9.
Examples The following example shows the MLPP access digit set to 6:
Router(config)# voice mlpp
Router(config-voice-mlpp)# access-digit 6
Related Commands
digit Single-digit number users dial. Range: 0 to 9. Default: 0.
Cisco IOS Release Modification
12.4(22)YB This command was introduced.
12.4(24)T This command was integrated into Cisco IOS Release 12.4(24)T.
Command Description
mlpp preemption Enables preemption capability on an SCCP phone or analog FXS port.
preemption trunkgroup Enables preemption capability on a trunk group.
preemption user Enables preemption capability for all supported phones.
Cisco Unified CME Commands: A
addon
33
Cisco Unified CME Command Reference
OL-10894-01
addon
To define whether a phone type supports add-on modules, use the addon command in ephone-type
configuration mode. To reset to the default value, use the no form of this command.
addon
no addon
Syntax Description This command has no arguments or keywords.
Command Default Disabled (phone type does not support add-on modules).
Command Modes Ephone-type configuration (config-ephone-type)
Command History
Usage Guidelines This command specifies that add-on modules, such as the Cisco Unified IP Phone 7915 Expansion
Module, are supported by the type of phone being added with the phone-type template.
Examples The following example shows that expansion modules are supported for the phone being added with an
ephone-type template:
Router(config)# ephone-type 7965
Router(config-ephone-type)# addon
Related Commands
Cisco IOS Release Cisco Product Modification
12.4(15)XZ Cisco Unified CME 4.3
Cisco Unified SRST 4.3
This command was introduced.
12.4(20)T Cisco Unified CME 7.0
Cisco Unified SRST 7.0
This command was integrated into
Cisco IOS Release 12.4(20)T.
Command Description
device-id Specifies the device ID for a phone type in an ephone-type template.
device-name Assigns a name to a phone type in an ephone-type template.
Cisco Unified CME Commands: A
address (voice emergency response location)
34
Cisco Unified CME Command Reference
OL-10894-01
address (voice emergency response location)
To define the civic address for an ERL that is used for the ALI database upload, use the address
command in voice emergency response location mode. To remove this definition, use the no form of the
command. This command is optional.
address string
no address
Syntax Description
Command Default The civic address is not defined.
Command Modes Voice emergency response location configuration (cfg-emrgncy-resp-location)
Command History
Usage Guidelines Use this command to create a comma separated text entry of the ERL’s civic address. The address
information must be entered to conform with the NENA-2 Data Record specifications or the
recommendations by the service provider.
Examples In this example, a civic address is displayed for ERL 60.
voice emergency response location 60
subnet 1 209.165.200.224 255.255.0.0
elin 1 4085550100
name Cookies and More Incorporated,
address I,408,5550100,,11902,,,Main Street,Emerald City,CA,Idina Menzel,1,,,,,,
Related Commands
string String (1-247 characters) used to identify an ERL’s civic address.
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.
Command Description
elin Specifies a PSTN number that will replace the caller’s extension.
Cisco Unified CME Commands: A
address (voice emergency response location)
35
Cisco Unified CME Command Reference
OL-10894-01
name Specifies a string (up to 30 characters) used internally to identify or describe
the emergency response location.
subnet Defines which IP phones are part of this ERL.
Command Description
Cisco Unified CME Commands: A
after-hour exempt
36
Cisco Unified CME Command Reference
OL-10894-01
after-hour exempt
To specify that an individual IP phone in Cisco Unified CME does not have any of its outgoing calls
blocked even though after-hour call blocking has been enabled, use the after-hour exempt command in
ephone or ephone-template configuration mode. To remove the exemption, use the no form of this
command.
after-hour exempt
no after-hour exempt
Syntax Description This command has no arguments or keywords.
Command Default The SCCP phone is not exempt from call blocking.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines Use this command to exempt an individual SCCP phone from call blocking and enable the phone user
to place outgoing calls regardless of whether the outgoing called number matches the defined pattern of
digits during the call blocking periods.
By default, all IP phones in a Cisco Unified CME system are subject to call blocking if the Call Blocking
feature is configured.
If you use an ephone template to apply a command to a phone and you also use the same command in
ephone configuration mode for the same phone, the value that you set in ephone configuration mode has
priority.
Examples The following example shows how to configure this phone so that outgoing calls are not blocked:
Router(config)# ephone 23
Router(config-ephone)# mac 00e0.8646.9242
Router(config-ephone)# button 1:33
Router(config-ephone)# after-hour exempt
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
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 the ephone-template
configuration mode was integrated into Cisco IOS
12.4(9)T.
Cisco Unified CME Commands: A
after-hour exempt
37
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
after-hours block
pattern
Defines a pattern of digits for blocking outgoing calls from IP phones.
after-hours date Defines a recurring period based on date during which outgoing calls that
match defined block patterns are blocked on IP phones.
after-hours day Defines a recurring period based on day of the week during which outgoing
calls that match defined block patterns are blocked on IP phones.
Cisco Unified CME Commands: A
after-hour login http
38
Cisco Unified CME Command Reference
OL-10894-01
after-hour login http
To unblock an individual IP phone in Cisco Unified CME that is configured for after-hour call blocking,
use the after-hour login http command in ephone, telephony-service or ephone-template configuration
mode. To disable after-hour login http feature, use the no form of the command.
after-hour login htpp
no after-hour login htpp
Syntax Description This command has no arguments or keywords.
Command Default The after-hour login http feature is not enabled.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Use this command to log in to a phone to unblock the after hour block and enable the phone user to place
outgoing calls regardless of whether the outgoing called number matches the defined pattern of digits
during the call blocking periods.
When you configure after-hours login http command, you will experience slightly different login
behavior compare to the current one. This difference is because the after hours login mechanism is
enhanced due to some UI limitation in the current model. By default, after-hours login http is not applied,
which mean user will be using the existing after hours login mechanism.
By default, all IP phones in a Cisco Unified CME system are subject to call blocking if the Call Blocking
feature is configured.
If you use an ephone template to apply a command to a phone and you also use the same command in
ephone configuration mode for the same phone, the value that you set in ephone configuration mode has
priority.
Examples The following example shows how to configure this phone with pin login so that outgoing calls are not
blocked:
Router(config)# ephone 6
Router(config-ephone)# mac 00e0.8646.242
Router(config-ephone)# button 1:33
Router(config-ephone)# Pin 123
Router(config-ephone)# after-hour login http
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified CME Commands: A
after-hour login http
39
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
after-hours block
pattern
Defines a pattern of digits for blocking outgoing calls from IP phones.
after-hours date Defines a recurring period based on date during which outgoing calls that
match defined block patterns are blocked on IP phones.
after-hours day Defines a recurring period based on day of the week during which outgoing
calls that match defined block patterns are blocked on IP phones.
Cisco Unified CME Commands: A
after-hours block pattern
40
Cisco Unified CME Command Reference
OL-10894-01
after-hours block pattern
To define a pattern of outgoing digits for Call Blocking from IP phones, use the after-hours block
pattern command in telephony-service or ephone-template configuration mode. To delete a
call-blocking pattern, use the no form of this command.
after-hours block pattern pattern-tag pattern [7-24]
no after-hours block pattern pattern-tag
Syntax Description
Command Default No pattern is defined.
Command Modes Ephone-template (config-ephone-template)
Telephony-service configuration (config-telephony)
Command History
pattern-tag Identifier for a call-blocking pattern. Up to 32 call-blocking patterns can be
defined in separate commands.
pattern Outgoing call digits to be matched for blocking.
7-24 (Optional) If the 7-24 keyword is specified, the pattern is always blocked, 7 days
a week, 24 hours a day. If the 7-24 keyword is not specified, the pattern is blocked
during the days and dates that are defined with the after-hours day and
after-hours date commands.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.4(4)T Cisco CME 3.4 Support for this command was extended to all
SCCP, H.323, SIP, and POTS calls that go through
the Cisco Unified CME router, including all
incoming calls to the router, except calls from an
exempt phone.
12.4(15)XY Cisco Unified CME 4.2(1) This command was added to ephone-template
configuration mode.
12.4(15)XZ Cisco Unified CME 4.3 This command was added to ephone-template
configuration mode.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: A
after-hours block pattern
41
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines Call Blocking on IP phones is defined in the following way. First, one or more patterns of outgoing digits
(0-9) are defined using the after-hours block pattern command. Next, one or more time periods during
which calls that match those patterns are to be blocked are defined using the after-hours date or
after-hours day command or both. By default, all IP phones in a Cisco Unified CME system are
restricted during the specified time if at least one pattern and at least one time period are defined.
Before Cisco CME 3.4, Call Blocking is supported on IP phones and on analog phones connected to
SCCP-controlled analog telephone adaptors (Cisco ATA) or SCCP-controlled foreign exchange station
(FXS) ports. In Cisco CME 3.4 and later, the call-blocking configuration applies to all SCCP, H.323, SIP
and POTS calls that go through the Cisco Unified CME router. All incoming calls to the router, except
calls from an exempt phone, are also checked against the after-hours configuration.
Individual phones can be exempted from call blocking using the after-hour exempt or the after-hours
override-code command.
Blocked calls return a fast-busy tone to the user for approximately 10 seconds before the call is
terminated and the line is returned to on-hook status.
Examples The following example defines pattern 1, which blocks international calls after hours for a
Cisco Unified CME system that requires dialing 9 for external calls:
Router(config)# telephony-service
Router(config-telephony)# after-hours block pattern 1 9011

Related Commands Command Description
after-hour exempt Specifies that an IP phone does not have any of its outgoing calls blocked
although call blocking is defined.
after-hours date Defines a recurring period based on date during which outgoing calls that
match defined block patterns are blocked on IP phones.
after-hours day Defines a recurring period based on day of the week during which outgoing
calls that match defined block patterns are blocked on IP phones.
after-hours
override-code
Specifies that call blocking on an IP phone can be overridden by entering a
defined code.
after-hours
pstn-prefix
Specifies that trunk lines on an IP phone are blocked similarly to that
configured for nonPSTN lines.
ephone-template
(ephone)
Applies template to a SCCP phone.
Cisco Unified CME Commands: A
after-hours date
42
Cisco Unified CME Command Reference
OL-10894-01
after-hours date
To define a recurring period based on date during which outgoing calls that match defined block patterns
are blocked on IP phones, use the after-hours date command in ephone-template or telephony-service
configuration mode. To delete a defined time period, use the no form of this command.
after-hours date month date start-time stop-time
no after-hours date month date
Syntax Description
Command Default No time period based on date is defined for call blocking.
Command Modes Ephone-template configuration (config-ephone-temp)
Telephony-service configuration (config-ephone)
Command History
Usage Guidelines Use this command to define call blocking that recurs annually on the date specified in the command. Call
blocking on IP phones is defined as follows:
• First, one or more patterns of outgoing digits (0-9) are defined using the after-hours block pattern
command.
• Next, one or more time periods during which calls that match those patterns are to be blocked are
defined using the after-hours date or after-hours day command or both.
month Abbreviated month. The following abbreviations for month are valid: jan, feb,
mar, apr, may, jun, jul, aug, sep, oct, nov, dec.
date Date of the month. Range is from 1 to 31.
start-time
stop-time
Beginning and ending times for call blocking, in an HH:MM format using a
24-hour clock. The stop time that is entered will be the next available time that
follows the start time. The value 24:00 is not valid. If 00:00 is entered as a stop
time, it is changed to 23:59. If 00:00 is entered for both start time and stop time,
calls are blocked for the entire 24-hour period on the specified date.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.4(15)XY Cisco Unified CME 4.2(1) This command was added to ephone-template
configuration mode.
12.4(15)XZ Cisco Unified CME 4.3 This command was added to ephone-template
configuration mode.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: A
after-hours date
43
Cisco Unified CME Command Reference
OL-10894-01
By default, all IP phones in a Cisco Unified CME system are restricted during the specified time if at
least one pattern and at least one time period are defined. Individual IP phones can be exempted from
call blocking using the after-hour exempt or after-hours override-code commands.
Examples The following example defines January 1 as an entire day on which calls that match the pattern specified
in the after-hours block pattern command are blocked:
Router(config)# telephony-service
Router(config-telephony)# after-hours date jan 1 00:00 00:00

Related Commands Command Description
after-hour exempt Specifies that an IP phone does not have any of its outgoing calls blocked
although call blocking is defined.
after-hours block
pattern
Defines a pattern of digits (0-9) for blocking outgoing calls from IP phones.
after-hours day Defines a recurring period based on day of the week during which outgoing
calls that match defined block patterns are blocked on IP phones.
after-hours
override-code
Specifies that call blocking on an IP phone can be overridden by entering a
defined set of digits (0-9).
after-hours
pstn-prefix
Specifies that trunk lines on an IP phone are blocked similarly to that
configured for nonPSTN lines.
ephone-template
(ephone)
Applies template to SCCP phone.
Cisco Unified CME Commands: A
after-hours day
44
Cisco Unified CME Command Reference
OL-10894-01
after-hours day
To define a recurring period based on day of the week during which outgoing calls that match defined
block patterns are blocked on IP phones, use the after-hours day command in ephone-template or
telephony-service configuration mode. To delete a defined time period, use the no form of this command.
after-hours day day start-time stop-time
no after-hours day day
Syntax Description
Command Default No time period based on day of the week is defined for call blocking.
Command Modes Ephone-template configuration (config-ephone-template)
Telephony-service configuration (config-ephone)
Command History
Usage Guidelines Use this command to define call blocking during the hours between the start time and stop time on the
day of the week that is specified in this command. This time period recurs weekly unless it is removed
using the no form of this command.
Call blocking on IP phones is defined as follows:
• First, one or more patterns of outgoing digits (0-9) are defined using the after-hours block pattern
command.
day Abbreviated day of the week. The following abbreviations for day of the week are
valid: sun, mon, tue, wed, thu, fri, sat.
start-time
stop-time
Beginning and ending times for call blocking, in an HH:MM format using a
24-hour clock. The stop time that is entered will be the next available time that
follows the start time. The value 24:00 is not valid. If 00:00 is entered as a stop
time, it is changed to 23:59. If 00:00 is entered for both start time and stop time,
calls are blocked for the entire 24-hour period on the specified day.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.4(15)XY Cisco Unified CME 4.2(1) This command was added to ephone-template
configuration mode.
12.4(15)XZ Cisco Unified CME 4.3 This command was added to ephone-template
configuration mode.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: A
after-hours day
45
Cisco Unified CME Command Reference
OL-10894-01
• Next, one or more time periods during which calls that match those patterns are to be blocked are
defined using the after-hours date or after-hours day command or both.
By default, all IP phones in a Cisco Unified CME system are restricted during the specified time if at
least one pattern and at least one time period are defined. Individual phones can be exempted from call
blocking using the after-hour exempt or after-hours override-code commands.
Examples The following example defines the period from Monday night at 7 p.m. to Tuesday morning at 7 a.m. as
an after-hours call-blocking period:
Router(config)# telephony-service
Router(config-telephony)# after-hours day mon 19:00 07:00

Related Commands Command Description
after-hour exempt Specifies that an IP phone does not have any of its outgoing calls blocked
although call blocking is defined.
after-hours block
pattern
Defines a pattern of digits (0-9) for blocking outgoing calls from IP phones.
after-hours date Defines a recurring period based on date during which outgoing calls that
match defined block patterns are blocked on IP phones.
after-hours
override-code
Specifies that call blocking on an IP phone can be overridden by entering a
defined set of digits (0-9).
after-hours
pstn-prefix
Specifies that trunk lines on an IP phone are blocked similarly to that
configured for nonPSTN lines.
ephone-template
(ephone)
Applies template to SCCP phone.
Cisco Unified CME Commands: A
after-hours override-code
46
Cisco Unified CME Command Reference
OL-10894-01
after-hours override-code
To specify that a defined blocking pattern can be overridden, use the after-hours override-code
command in ephone-template or telephony-service configuration mode. To remove the exemption, use
the no form of this command.
after-hours override-code pattern
no after-hours override-code pattern
Syntax Description
Command Default No override is defined.
Command Modes Ephone-template configuration (config-ephone-template)
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Use this command to allow a phone user to override call blocking rules and enable the phone user to
place outgoing calls regardless of whether the outgoing called number matches the defined pattern of
digits during the call blocking periods.
By default, all IP phones in a Cisco Unified CME system are subject to call blocking if the Call
Blocking feature is configured. By entering the override code as defined by the system administrator,
the phone user can override all call blocking rules.
The after-hours override-code command, configured by either ephone-template or telephony-service,
overrides any global telephony-service call block configuration. If the after-hour exempt command is
configured, it has priority over the after-hours override-code command.
Examples The following example defines a blocking pattern using telephony-service configuration which can be
overridden using the override code of 1234:
Router(config)# telephony-service
Router(config-telephony)# after-hours block pattern 1 91900
Router(config-telephony)# after-hours day mon 19:00 07:00
pattern Specifies the pattern of digits (0-9) that must be dialed by the phone user to
override the call blocking rules. The override code is provided to the phone
user by the system administrator.
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 added to ephone-template
configuration mode.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: A
after-hours override-code
47
Cisco Unified CME Command Reference
OL-10894-01
Router(config-telephony)# after-hours date Jan 25 00:00 07:00
Router(config-telephony)# after-hours override-code 1234
Related Commands Command Description
after-hour exempt Specifies that an IP phone does not have any of its outgoing calls blocked
although call blocking is defined.
after-hours block
pattern
Defines a pattern of digits (0-9) for blocking outgoing calls from IP phones.
after-hours date Defines a recurring period based on date during which outgoing calls that
match defined block patterns are blocked on IP phones.
after-hours day Defines a recurring period based on day of the week during which outgoing
calls that match defined block patterns are blocked on IP phones.
after-hours
pstn-prefix
Specifies that trunk lines on an IP phone are blocked similarly to that
configured for non PSTN lines.
ephone-template
(ephone)
Applies a template to an ephone.
Cisco Unified CME Commands: A
after-hours pstn-prefix
48
Cisco Unified CME Command Reference
OL-10894-01
after-hours pstn-prefix
To specify that all configured blocking patterns apply to trunk or PSTN lines, use the after-hours
pstn-prefix command in telephony-service configuration mode. To delete call blocking configuration
for PSTN lines, use the no form of this command.
after-hours pstn-prefix tag pattern
no after-hours pstn-prefix tag pattern
Syntax Description
Command Default No pattern is defined.
Command Modes Telephony-service configuration
Command History
Usage Guidelines Use the after-hours pstn-prefix command to indicate that the after-hours call blocking patterns are
configured to include one or more PSTN access digits that are normally dialed by phone users using
regular ephone-dn lines. For example, the patterns are configured with a leading digit 9 to correspond to
the conventional “dial 9 for outside line.” The after-hours pstn-prefix command instructs the system to
skip over the PSTN prefix digits (in the blocking patterns) for calls that are dialed directly to the PSTN
on ephone-dns that are configured using the trunk feature. These lines do not require the user to dial a
PSTN access code (for example, 9) because they are configured to directly connect to the PSTN FXO
ports. For example, a user of a regular ephone-dn would dial 9-1-900-xxx-xxxx, whereas a user on a
trunk ephone-dn would omit the leading 9 and dial only 1-900-xxx-xxxx. The blocking pattern would be
configured as 91900 to restrict calls on regular ephone-dn lines, and this pattern would be interpreted as
1900 on ephone-dns configured using the trunk feature. If you do not specify the after-hours
pstn-prefix command, then no blocking is performed on calls dialed on trunk ephone-dn lines.
Call blocking on IP phones is defined as follows:
• First, one or more patterns of outgoing digits (0-9) are defined using the after-hours block pattern
command.
• Next, one or more time periods during which calls that match those patterns are to be blocked are
defined using the after-hours date, the after-hours day, or both commands.
tag Identifier for a PSTN call-blocking pattern. Up to 4 call-blocking patterns
can be defined in separate commands.
pattern Outgoing call digits (0-9) to be matched for PSTN blocking.
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 added to ephone-template
configuration mode.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: A
after-hours pstn-prefix
49
Cisco Unified CME Command Reference
OL-10894-01
By default, all IP phones in a Cisco Unified CME system are restricted during the specified time if at
least one pattern and at least one time period are defined.
Blocked calls return a fast-busy tone to the user for approximately 10 seconds before the call is
terminated and the line is returned to on-hook status.
Examples The following example defines a blocking pattern using telephony-service configuration which is
applied to a PSTN line:
Router(config)# telephony-service
Router(config-telephony)# after-hours block pattern 1 91900
Router(config-telephony)# after-hours pstn-prefix 1 9
Router(config-telephony)# after-hours day mon 19:00 07:00
Router(config-telephony)# after-hours date Jan 25 00:00 07:00

Related Commands Command Description
after-hour exempt Specifies that an IP phone does not have any of its outgoing calls blocked
although call blocking is defined.
after-hours block
pattern
Defines a pattern of digits (0-9) for blocking outgoing calls from IP phones.
after-hours date Defines a recurring period based on date during which outgoing calls that
match defined block patterns are blocked on IP phones.
after-hours day Defines a recurring period based on day of the week during which outgoing
calls that match defined block patterns are blocked on IP phones.
after-hours
override-code
Specifies that call blocking on an IP phone can be overridden by entering a
defined series of digits (0-9).
Cisco Unified CME Commands: A
allow watch
50
Cisco Unified CME Command Reference
OL-10894-01
allow watch
To allow a directory number on a phone registered to Cisco Unified CME to be watched in a presence
service, use the allow watch command in ephone-dn, ephone-dn-template, or voice register dn
configuration mode. To reset to the default condition, use the no form of this command.
allow watch
no allow watch
Syntax Description This command has no arguments or keywords.
Command Default Watching of the phone line is disabled.
Command Modes Ephone-dn configuration (config-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)
Voice register dn configuration (config-register-dn)
Command History
Usage Guidelines This command controls whether a phone line associated with a directory number can be watched as part
of a presence service. The directory number is enabled as a presentity that can be watched by internal
and external watchers. Presence service must be enabled on Cisco Unified CME. Another phone, acting
as a watcher, can monitor the status of this phone line when the blf-speed-dial or presence call-list
command is enabled for that phone.
If you use an ephone-dn template to apply a command to a directory number and you also use the same
command in ephone-dn configuration mode, the value that you set in ephone-dn configuration mode has
priority over the ephone-dn template configuration.
Examples The following example shows that the extension associated with voice register dn 2 can be watched by
the phone associated with voice register pool 1:
Router(config)# voice register dn 2
Router(config-register-dn)# number 2102
Router(config-register-dn)# allow watch
Router(config)# voice register pool 1
Router(config-register-pool)# id mac 0015.6247.EF90
Router(config-register-pool)# type 7971
Router(config-register-pool)# number 1 dn 2
Router(config-register-pool)# blf-speed-dial 1 2102 label 2102

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.
Cisco Unified CME Commands: A
allow watch
51
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
blf-speed-dial Enables Busy Lamp Field (BLF) monitoring for a speed-dial number on a
phone registered to Cisco Unified CME.
presence Enables presence service and enters presence configuration mode.
presence call-list Enables BLF monitoring for call lists and directories on phones registered to
Cisco Unified CME.
presence enable Allows the router to accept incoming presence requests.
show presence global Displays configuration information about the presence service.
show presence
subscription
Displays information about active presence subscriptions.
Cisco Unified CME Commands: A
anonymous block
52
Cisco Unified CME Command Reference
OL-10894-01
anonymous block
To enable anonymous call blocking in a SIP phone template, use the anonymous block command in
voice register template configuration mode. To return to the default, use the no form of this command.
anonymous block
no anonymous block
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Voice register template configuration (config-register-temp)
Command History
Usage Guidelines This command blocks incoming calls in which the caller is not identified. To apply a template to a SIP
phone, use the template command in voice register pool configuration mode.
Examples The following example shows how to set anonymous call blocking in template 1:
Router(config)# voice register template 1
Router(config-register-temp)# anonymous block

Related Commands
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
caller-id block (voice
register template)
Enables caller-ID blocking for outbound calls from a SIP phone.
template (voice register
pool)
Applies a template to a SIP phone.
Cisco Unified CME Commands: A
application (telephony-service)
53
Cisco Unified CME Command Reference
OL-10894-01
application (telephony-service)
To select a session-level application for all extensions (ephone-dns) in a Cisco Unified CME, use the
application command in telephony-service configuration mode. To disable use of an application for all
extensions, use the no form of this command.
application application-name
no application
Syntax Description
Command Default No application is selected for all extensions.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Use this command to assign a Tool Command Language (Tcl) IVR application to all extensions served
by the CME router.
Use the show call application voice summary command to display a list of applications.
Examples The following example sets the IVR application for all phones:
Router(config)# telephony-service
Router(config-telephony) application TCL IVR

Related Commands
application-name Interactive voice response (IVR) application name.
Cisco IOS Release Cisco Product Modification
12.2(11)YT Cisco ITS 2.1 This command was introduced.
12.2(15)T Cisco ITS 2.1 This command was integrated into Cisco IOS
Release 12.2(15)T.
Command Description
show call application
voice summary
Displays information about voice applications.
Cisco Unified CME Commands: A
application (voice register global)
54
Cisco Unified CME Command Reference
OL-10894-01
application (voice register global)
To select the session-level application for all dial peers associated with Session Initiation Protocol (SIP)
phones, use the application command in voice register global configuration mode. To disable use of the
application, use the no form of this command.
application application-name
no application
Syntax Description
Command Default Default application on router
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines During Cisco Unified CallManager Express (Cisco Unified CME) or Cisco Unified Session Initiation
Protocol (SIP) Survivable Remote Site Telephony (SRST) registration, a dial peer is created for each SIP
phone and that dial peer includes the default session application. The application command allows you
to change the default application for all dial peers associated with the Cisco SIP IP phones, if desired.
The applied application (or TCL IVR script) must support call redirection. Use the show call
application voice summary command to display a list of applications.
The application command in voice register pool configuration mode takes precedence over this
command in voice register global configuration mode.
Note Configure the id (voice register pool) command before any other voice register pool commands,
including the application command. The id command identifies a locally available individual Cisco SIP
IP phone or set of Cisco SIP IP phones.
Examples The following example shows how to set the Tcl IVR application globally for all SIP phones:
Router(config)# voice register global
Router(config-register-global)# mode cme
Router(config-register-global)# application sipapp2

application-name Interactive voice response (IVR) application name.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
Cisco Unified CME Commands: A
application (voice register global)
55
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
application (dial-peer) Enables a specific application on a dial peer.
application (voice register
pool)
Selects the session-level application for the dial peer associated an
individual SIP phone in a Cisco Unified CME environment or for a
group of phones in a Cisco Unified SIP SRST environment.
id (voice register pool) Explicitly identifies a locally available individual Cisco SIP IP phone,
or when running Cisco Unified SIP SRST, set of Cisco SIP IP phones.
mode (voice register
global)
Enables the mode for provisioning SIP phones in a Cisco Unified CME
system.
show call application voice
summary
Displays information about voice applications.
show dial-peer voice Displays information for dial peers.
voice register pool Enters voice register pool configuration mode for SIP phones.
Cisco Unified CME Commands: A
application (voice register pool)
56
Cisco Unified CME Command Reference
OL-10894-01
application (voice register pool)
To select the session-level application for the dial peer associated with an individual Session Initiation
Protocol (SIP) phone in a Cisco Unified CallManager Express (Cisco Unified CME) environment or for
a group of phones in a Cisco Unified SIP Survivable Remote Site Telephony (SRST) environment, use
the application command in voice register pool configuration mode. To disable use of the application,
use the no form of this command.
application application-name
no application
Syntax Description
Command Default Default application on router
Command Modes Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines During Cisco Unified CME or Cisco Unified SIP SRST registration, a dial peer is created for each SIP
phone and that dial peer includes the default session application. The application command allows you
to change the default application for all dial peers associated with the Cisco SIP IP phones, if desired.
The applied application (or TCL IVR script) must support call redirection. Use the show call
application voice summary command to display a list of applications.
The application command in voice register pool configuration mode takes precedence over this
command in voice register global configuration mode.
Note Configure the id (voice register pool) command before any other voice register pool commands,
including the application command. The id command identifies a locally available individual Cisco SIP
IP phone or set of Cisco SIP IP phones.
application-name Name of the selected interactive voice response (IVR) application name.
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.
Cisco Unified CME Commands: A
application (voice register pool)
57
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to set the IVR application for the SIP phone specified by the voice
register pool command:
Router(config)# voice register pool 1
Router(config-register-pool) application sipapp2

The following partial sample output from the show running-config command shows that voice register
pool 1 has been set up to use the SIP.app application:
voice register pool 1
id network 172.16.0.0 mask 255.255.0.0
application SIP.app
voice-class codec 1
Related Commands Command Description
application (dial-peer) Enables a specific application on a dial peer.
application (voice register
global)
Selects the session-level application for all dial peers associated with
SIP phones.
id (voice register pool) Explicitly identifies a locally available individual Cisco SIP IP phone,
or when running Cisco Unified SIP SRST, set of Cisco SIP IP phones.
mode (voice register
global)
Enables the mode for provisioning SIP phones in a Cisco Unified CME
system.
show call application voice
summary
Displays information about voice applications.
show dial-peer voice Displays information for dial peers.
Cisco Unified CME Commands: A
attendant-console
58
Cisco Unified CME Command Reference
OL-10894-01
attendant-console
To specify the phone number of the MLPP attendant-console service, use the attendant-console
command in voice MLPP configuration mode. To revert to the default, use the no form of this command.
attendant-console number redirect-timer seconds
no attendant-console
Syntax Description
Command Default MLPP call is not diverted to an attendant-console service.
Command Modes Voice MLPP configuration (config-voice-mlpp)
Command History
Usage Guidelines This command enables Cisco Unified CME to divert all unanswered precedence calls above Routine to
the specified target number after the specified period of time. This target directory number typically
specifies the pilot number of the attendant-console service that is used as a destination of last resort for
forwarded MLPP calls.
Examples The following example shows that any MLPP call that is not answered after 30 seconds is redirected to
extension 81005, which is the extension of the BACD queue.
Router(config)# voice mlpp
Router(config-voice-mlpp)# attendant-console 81005 redirect-timer 30
Related Commands
number Pilot number of the MLPP attendant-console service, such as the
Cisco Unified CME basic automatic call distribution (B-ACD) and
auto-attendant (AA) service.
seconds Number of seconds that a call rings before being redirected to the
attendant-console service. Range: 10 to 60.
Cisco IOS Release Cisco Product Modification
12.4(22)YB Cisco Unified CME 7.1 This command was introduced.
12.4(24)T — This command was integrated into Cisco IOS
Release 12.4(24)T.
Command Description
access-digit Defines the access digit that phone users dial to request a precedence call.
mlpp preemption Enables preemption capability on an SCCP phone or analog FXS port.
service Associates a dial peer with an auto-attendant (AA) service.
Cisco Unified CME Commands: A
authenticate (voice register global)
59
Cisco Unified CME Command Reference
OL-10894-01
authenticate (voice register global)
To define the authenticate mode for SIP phones in a Cisco Unified CME or Cisco Unified SRST system,
use the authenticate command in voice register global configuration mode. To return to the default, use
the no form of this command.
Cisco IOS Release 12.4(11)XJ and later releases
authenticate {credential tag location | ood-refer | presence | realm string | register}
no authenticate {credential tag location | ood-refer | presence | realm string | register}
Cisco IOS Release 12.4(4)T
authenticate [all] [realm string]
no authenticate [all] [realm string]
Syntax Description
Command Default Authenticate mode is disabled.
Command Modes Voice register global configuration (config-register-global)
Command History
credential tag Number that identifies the credential file to use for out-of-dialog REFER
(OOD-R) or presence authentication. Range: 1 to 5.
location Name and location of the credential file in URL format. Valid storage
locations are TFTP, HTTP, and flash memory.
ood-refer Incoming OOD-R requests are authenticated using RFC 2617-based digest
authentication.
presence Incoming presence subscription requests from an external presence server
are authenticated.
realm string Realm parameter for challenge and response as specified in RFC 2617 is
authenticated.
register All incoming registration requests are challenged and authenticated. Valid
for Cisco Unified CME only.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
12.4(11)XJ Cisco Unified CME 4.1
Cisco Unified SRST 4.1
The credential, ood-refer, presence, and register
keywords were added. The register keyword
replaced the all keyword.
12.4(15)T Cisco Unified CME 4.1
Cisco Unified SRST 4.1
The modifications to this command were
integrated into Cisco IOS Release 12.4(15)T.
Cisco Unified CME Commands: A
authenticate (voice register global)
60
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines The credential keyword allows OOD-R and presence service to use credential files for authentication.
Up to five text files containing username and password pairs can be defined and loaded into the system.
The contents of these five files are mutually exclusive; the username and password pairs must be unique
across all the files. For Cisco Unified CME, the username and password pairs cannot be the same ones
defined for SCCP or SIP phones with the username command.
The ood-refer keyword specifies that any OOD-R request that passes authentication is authorized to
setup calls between referee and refer-target if OOD-R is enabled with the refer-ood enable command.
The presence keyword enables digest authentication for external watchers. Credentials are verified
against a credential file stored in flash. This applies to both OOD-R and presence. The default is to
authenticate all SUBSCRIBE requests from external watchers. An external watcher that passes
authentication is authorized to subscribe to presence service for all lines allowed to be watched.
The register keyword enables authentication for registration requests in which the MAC address of the
SIP phone cannot be identified by using other methods. All incoming register requests are challenged
and authenticated. The realm keyword with the string argument specifies the character string to be
included in the challenge.
Examples The following example shows that all registration requests from SIP phones in a Cisco Unified CME
system must be authenticated:
Router(config)# voice register global
Router(config-register-global)# mode cme
Router(config-register-global)# authenticate register

Related Commands Command Description
credential load Reloads a credential file into flash memory.
mode cme Enables the mode for provisioning SIP phones in a Cisco Unified CME
system.
presence-enable Allows incoming presence subscribe requests from SIP trunks.
refer-ood enable Enables OOD-R processing.
username (ephone) Defines a username and password for SCCP phones.
username (voice
register pool)
Defines a username and password for authenticating SIP phones.
Cisco Unified CME Commands: A
authentication credential
61
Cisco Unified CME Command Reference
OL-10894-01
authentication credential
To create an entry for an application’s credential in the database used by the Cisco Unified CME
authentication server, use the authentication credential command in telephony-service configuration
mode. To remove the credential, use the no form of this command.
authentication credential application-name password
no authentication credential application-name password
Syntax Description
Command Default The credential is not stored in the database.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command stores a credential in the database used by the Cisco Unified CME authentication server.
The authentication server uses this data to authenticate and authorize HTTP requests from IP phones in
Cisco Unified CME.
Up to eight credentials can be stored in the database for the Cisco Unified CME authentication server.
For applications other than Extension Mobility, the credential must be created in the application.
Note This command is not required for authorizing requests from Extension Mobility phones in
Cisco Unified CME.
Examples The following example shows how to configure IP phones in Cisco Unified CME to request
authorization from the internal authentication server. When the IP phone receives a command from the
application, the phone requests authorization from the Cisco Unified CME authentication server to
execute that command. The authorization request from the phone includes the specified credential. The
authentication server compares the credential in its database to the one in the request, and authorizes or
rejects the request based on the results.
Router(config)# telephony-service
application-name String sent by application to identify itself to the server. Length of string:
1 to 15characters.
password String sent by application to identify itself to the server. Length of string:
1 to 15 characters.
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 integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: A
authentication credential
62
Cisco Unified CME Command Reference
OL-10894-01
Router(config-telephony)# authentication credential att psswrd
Router(config-telephony)# url authentication http://192.0.2.0/CCMCIP/authenticate.asp att
psswrd
Router(config-telephony)#
Related Commands Command Description
url authentication Specifies authentication server and credential to be used by an application.
Cisco Unified CME Commands: A
auth-mode
63
Cisco Unified CME Command Reference
OL-10894-01
auth-mode
To specify the type of authentication to use during CAPF sessions, use the auth-mode command in
CAPF-server configuration mode. To return to the default, use the no form of this command.
auth-mode {auth-string | LSC | MIC | none | null-string}
no auth-mode
Syntax Description
Command Default No certificate upgrade is initiated (same as the keyword none).
Command Modes CAPF-server configuration (config-capf-server)
Command History
Usage Guidelines This command is used with Cisco Unified CME phone authentication.
If you use the auth-string keyword with this command, the phone user is required to enter a specified
digit string at the phone to be authenticated for CAPF sessions. The digit string is entered into the
configuration using the auth-string command or the capf-auth-str command and must be
communicated to the phone user.
Use the show capf-server command to display parameters that you have set with this command.
Examples The following example specifies authentication strings as the method of CAPF authentication. The
auth-string command specifies that random authentication strings should be generated for all ephones.
capf-server
auth-mode auth-string
auth-string generate all

auth-string The phone user enters a special authentication string at the phone. The string
is entered using the auth-string command and is provided to the phone user
by the system administrator.
LSC The phone provides its phone certificate for authentication. Precedence is
given to an LSC if one exists.
MIC The phone provides its phone certificate for authentication. Precedence is
given to an MIC if one exists.
none No certificate upgrade is initiated.
null-string No authentication is used.
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
12.4(9)T.
Cisco Unified CME Commands: A
auth-mode
64
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Description
auth-string Creates or removes authentication strings for one or all secure ephones.
capf-auth-str Specifies a string of digits for a user to enter at the phone for CAPF
authentication.
show capf-server Displays configuration and session information for the CAPF server.
Cisco Unified CME Commands: A
auto assign
65
Cisco Unified CME Command Reference
OL-10894-01
auto assign
To automatically assign an already defined telephone or extension number to button 1 of
Cisco Unified IP phones as they register for service with a Cisco Unified CME router, use the
auto assign command in telephony-service configuration mode. To return to the default of not
automatically assigning dn-tags, use the no form of this command.
auto assign dn-tag to dn-tag [type phone-type] [cfw extension-number timeout seconds]
no auto assign dn-tag to dn-tag [type phone-type] [cfw extension-number timeout seconds]
Syntax Description dn-tag to dn-tag Range of ephone-dn tags for already configured ephone-dns, from which a
tag is assigned to the ephone being created.
The maximum number of directory numbers supported is version and
platform dependent. Type ? to display the value.
type phone-type (Optional) Type of Cisco Unified IP phone to which to restrict automatic
assignment of ephone-dn tags. Valid entries are the following:
• 12SP—12SP+ and 30VIP phones.
• 7902—Cisco Unified IP Phone 7902G.
• 7905—Cisco Unified IP Phone 7905G.
• 7906—Cisco Unified IP Phone 7906G.
• 7910—Cisco Unified IP Phone 7910 and 7910G.
• 7911—Cisco Unified IP Phone 7911G.
• 7912—Cisco Unified IP Phone 7912G.
• 7920—Cisco Unified Wireless IP Phone 7920.
• 7921—Cisco Unified Wireless IP Phone 7921.
• 7931—Cisco Unified Wireless IP Phone 7931G.
• 7935—Cisco Unified IP Conference Station 7935.
• 7936—Cisco Unified IP Conference Station 7936.
• 7937—Cisco Unified IP Conference Station 7937
• 7940—Cisco Unified IP Phones 7940 and 7940G.
• 7941—Cisco Unified IP Phone 7941G.
• 7941GE—Cisco Unified IP Phone 7941G-GE.
• 7942—Cisco Unified IP Phone 7942.
• 7945—Cisco Unified IP Phone 7945.
Cisco Unified CME Commands: A
auto assign
66
Cisco Unified CME Command Reference
OL-10894-01
Command Default Ephone-dn tags are not automatically assigned to registering Cisco Unified IP phones.
Command Modes Telephony-service configuration (config-telephony)
Command History
type phone-type • 7960—Cisco Unified IP Phones 7960 and 7960G.
• 7961—Cisco Unified IP Phone 7961G.
• 7961GE—Cisco Unified IP Phone 7961G-GE.
• 7962—Cisco Unified IP Phone 7962.
• 7965—Cisco Unified IP Phone 7965.
• 7970—Cisco Unified IP Phone 7970G.
• 7971—Cisco Unified IP Phone 7971G-GE.
• 7975—Cisco Unified IP Phone 7975.
• 7985—Cisco Unified IP Phone 7985.
• CIPC—Cisco IP Communicator.
• all—All ephone types.
• anl—Analog gateway.
• ata—Cisco ATA-186 or Cisco ATA-188.
• bri—SCCP gateway.
• vgc-phone—vg248 phone emulation for analog phone.
Note You can also add a new phone type to your configuration by using
the ephone-type command.
cfw (Optional) Automatically assigned ephone-dns are provisioned for
call-forward busy and no-answer to the specified extension number.
extension-number (Optional) Extension number to which calls are to be forwarded on busy and
no-answer conditions.
timeout seconds (Optional; required if the cfw keyword is used) Amount of time, in seconds,
to wait when a call is not being answered before forwarding it.
Range: 3 to 60000.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.3(7)T Cisco CME 3.1 The 7920 and 7936 keywords were added.
12.3(11)XL Cisco CME 3.2.1 The 7970 keyword was added.
12.3(14)T Cisco CME 3.3 The 7971 keyword was added, and this command
was integrated into Cisco IOS Release 12.3(14)T.
12.4(4)XC Cisco Unified CME 4.0 The 7941, 7941GE, 7961, and 7961GE keywords
were added.
Cisco Unified CME Commands: A
auto assign
67
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines Use this command to create an ephone configuration for a Cisco Unified IP phone whose MAC address
is not explicitly configured as it registers in Cisco Unified CME. The system-created ephone
configuration includes the MAC address of the Cisco Unified IP phone being registered and an
already-defined available ephone-dn assigned to button 1 of this phone.
The auto-reg-ephone command must be enabled (default) to use this command. If the auto registration
feature is disabled, a Cisco Unified IP phone whose MAC address is not explicitly configured cannot
register in Cisco Unified CME.
Before using this command, configure the ephone-dn tags to be assigned and define at least one primary
number for each dn-tag.
All ephone-dns in a specified range should be of the same type, either single-line or dual-line.
Ephone-dn tags to be assigned must belong to normal ephone-dns and cannot belong to paging
ephone-dns, intercom ephone-dns, music-on-hold (MOH) ephone-dns, or message-waiting-indication
(MWI) ephone-dns.
The auto assign command cannot create shared lines.
If an insufficient number of dn-tags is available, some ephone configurations will not include a telephone
or extension number.
Use multiple auto assign commands to assign discontinuous ranges of ephone-dn tags and to support
multiple types of IP phones. Overlapping ranges of dn-tags may be assigned so that they map to more
than one type of phone. If no type is specified, the values in the range are assigned to phones of any type,
and if a specific range is assigned for a specific phone type, the available ephone-dn tag in that range are
used first.
If the phone being registered is connected to a Cisco VG200 series analog phone gateway, configuring the
12.4(9)T Cisco Unified CME 4.0 This command was integrated into Cisco IOS
Release 12.4(9)T.
12.4(6)XE Cisco Unified CME 4.0(2) The 7931 keyword was added.
12.4(4)XC4 Cisco Unified CME 4.0(3) The 7931 keyword was added.
12.4(11)T Cisco Unified CME 4.0(3) This command was integrated into Cisco IOS
Release 12.4(11)T.
12.4(11)XJ2 Cisco Unified CME 4.1 The 7921 and 7985 keywords were introduced.
12.4(15)T Cisco Unified CME 4.1 This command wasintegrated into Cisco IOS
Release 12.4(15)T.
12.4(15)T1 Cisco Unified CME 4.1(1) The 7942, 7945, 7962, 7965, and 7975 keywords
were introduced.
12.4(11)XW3 Cisco Unified CME 4.2 The 7942, 7945, 7962, 7965, and 7975 keywords
were introduced.
12.4(15)XY Cisco Unified CME 4.2(1) The 7942, 7945, 7962, 7965, and 7975 keywords
were introduced.
12.4(15)XZ Cisco Unified CME 4.3 The 7942, 7945, 7962, 7965, and 7975 keywords
were introduced.
12.4(20)T Cisco Unified CME 7.0 The 7937 keyword was introduced and this
command was integrated into Cisco IOS Release
12.4(20)T.
Cisco IOS Release Cisco Product Modification
Cisco Unified CME Commands: A
auto assign
68
Cisco Unified CME Command Reference
OL-10894-01
auto assign command will automatically create one ephone configuration for each configured port, as the port
registers with the Cisco Unified CME router. To ensure that the tag-to-port assignment will match the
numbering order of the physical ports; for example, dn-tags 1 to 24 assigned to ports 1 to 24 of a
Cisco VG224 analog phone gateway, in that order, we recommend that the Cisco Unified CME system
be up, running, and configured before you boot the analog phone gateway.
The auto assign command cannot be used for the Cisco Unified IP Phone 7914 Expansion Module.
Phones with one or more expansion modules must be configured manually.
After using this command, reboot the phone for which an ephone is to be configured.
This command is also used by the Cisco Unified CME setup tool to automatically assign ephone-dns
after the tool has gathered information about the setup from the user. When lines are assigned by the
Cisco Unified CME setup tool in keyswitch mode with two ephone-dn entries created for each individual
extension number, the automatic assignment mechanism assigns both ephone-dn entries to an individual
ephone associated with an IP phone.
Note Care should be taken when using the auto assign command because this command grants telephony
service to any IP phone that attempts to register. If you use the auto assign command, ensure that your
network is secure from unauthorized access by unknown IP phones.
Examples The following examples show how to configure the Auto Assign feature, including prerequisite
commands for configuring the auto assign command.
The following example shows how to enter the ephone-dn configuration and create ephone-dns
configurations, tags 1-4, each having a single primary number:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 2000
Router(config-ephone-dn)# exit
Router(config)# ephone-dn 2
Router(config-ephone-dn)# number 3000
Router(config-ephone-dn)# exit
Router(config)# ephone-dn 3
Router(config-ephone-dn)# number 4000
Router(config-ephone-dn)# exit
Router(config)# ephone-dn 4
Router(config-ephone-dn)# number 4001
Router(config-ephone-dn)# exit
The following example shows how to designate ephone-dn tags 1 to 4 for automatic assignment to any
type of IP phone and then perform a fast reboot of all phones:
Router(config)# telephony-service
Router(config-telephony)# auto assign 1 to 4
Router (config-telephony)# restart all

Cisco Unified CME Commands: A
auto assign
69
Cisco Unified CME Command Reference
OL-10894-01
The following example is the partial output from the show ephone registered command listing four
registered IP phones, to which ephone-dn tags 1 to 4 have been automatically assigned, after the phones
were booted:
Router# show ephone registered
ephone-1 Mac:0003.E3E7.F627 TCP socket:[2] activeLine:0 REGISTERED
mediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0
IP:10.0.0.2 51671 Telecaster 7940 keepalive 28 max_line 2
button 1: dn 1 number 2000
ephone-2 Mac:0030.94C3.F43A TCP socket:[1] activeLine:0 REGISTERED
mediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0
IP:10.0.0.3 50094 Telecaster 7960 keepalive 28 max_line 6
button 1: dn 2 number 3000
ephone-3 Mac:0003.6B40.99DA TCP socket:[3] activeLine:0 REGISTERED
mediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0
IP:10.0.0.200 51879 Telecaster 7960 keepalive 28 max_line 6
button 1: dn 3 number 4000
ephone-4 Mac:0010.406B.99D9 TCP socket:[4] activeLine:0 REGISTERED
mediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0
IP:10.0.0.012 51879 Telecaster 7960 keepalive 28 max_line 6
button 1: dn 4 number 4001
.
.
.

The following example shows how to designate ephone-dn tags 1 to 12 for automatic assignment to
Cisco Unified IP Phone 7910Gs only and ephone-dn tags 13 to 20 for automatic assignment to a
Cisco Unified IP Phones 7960 and 7960Gs only, with call forwarding to extension 5001 on busy or after
30 seconds of ringing with no answer:
Router(config)# telephony-service
Router(config-telephony)# auto assign 1 to 12 type 7910
Router(config-telephony)# auto assign 13 to 20 type 7960 cfw 5001 timeout 30

Related Commands Command Description
auto-reg-ephone Enables registration of Cisco Unified IP phones for which MAC addresses
are not explicitly configured.
number Associates a telephone or extension number with an ephone-dn.
restart (ephone) Performs a fast reboot of a single phone associated with a
Cisco Unified CME router.
restart
(telephony-service)
Performs a fast reboot of one or all phones associated with a
Cisco Unified CME router.
show ephone Displays statistical information about registered Cisco Unified IP phones.
show ephone
registered
Displays the status of registered phones.
Cisco Unified CME Commands: A
auto logout
70
Cisco Unified CME Command Reference
OL-10894-01
auto logout
To enable the automatic change of an ephone hunt group agent’s ephone-dn to not-ready status after a
specified number of hunt-group calls are not answered, use the auto logout command in ephone-hunt
configuration mode. To disable automatic logout, use the no form of this command.
auto logout [number-of-calls] [dynamic | static]
no auto logout [number-of-calls] [dynamic | static]
Syntax Description
Command Default Automatic change of agent status to not-ready is disabled.
Command Modes Ephone-hunt configuration (config-ephone-hunt)
Command History
Usage Guidelines This command is valid only for the following Cisco IP phones:
• Cisco Unified IP Phone 7905G
• Cisco Unified IP Phone 7912G
• Cisco Unified IP Phones 7940 and 7940G
number-of-calls (Optional) Number of unanswered hunt-group calls to an ephone-dn before
the ephone-dn is automatically changed to not-ready status. Range is from 1
to 20. Default is 1.
dynamic (Optional) Specifies that this command applies only to dynamic hunt group
members (those who are specified by an asterisk (*) wildcard in the hunt
group configuration). If neither the dynamic nor static keyword is used,
automatic logout applies to both dynamic and static hunt group members.
static (Optional) Specifies that this command applies only to static hunt group
members (those whose extension numbers are explicitly named in the hunt
group configuration). If neither the dynamic nor static keyword is used,
automatic logout applies to both dynamic and static hunt group members.
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.
12.4(4)XC Cisco Unified CME 4.0 The number-of-calls argument and the dynamic
and static keywords were added. The criterion for
this command was changed from exceeding the
timeout command limit to exceeding the number
of calls specified in this command.
12.4(9)T Cisco Unified CME 4.0 The modifications made to this command were
integrated into Cisco IOS 12.4(9)T.
Cisco Unified CME Commands: A
auto logout
71
Cisco Unified CME Command Reference
OL-10894-01
• Cisco Unified IP Phones 7960 and 7960G
This command is used with the Automatic Agent Status Not-Ready feature for ephone hunt groups,
which automatically puts an agent’s phone in not-ready status when it exceeds a specified limit. The limit
at which the Automatic Agent Status Not-Ready feature is triggered depends on the Cisco CME version
that you are using, as follows:
• Cisco CME 3.3 and earlier versions—Automatic Agent Status Not-Ready is invoked when an
ephone-hunt group call rings longer on a member ephone-dn than the period of time configured in
the timeout command in ephone-hunt configuration mode.
• Cisco Unified CME 4.0 and later versions—Automatic Agent Status Not-Ready is invoked when the
specified number of ephone-hunt group calls is unanswered by an agent. The default is one call if
the number of calls is not explicitly specified.
When Automatic Agent Status Not-Ready is specified for an ephone hunt group and it is triggered
because an ephone-dn member does not answer a specified number of ephone hunt group calls, the
following actions take place:
• If the hunt-group logout HLog command has been used, the agent is placed in not-ready status.
The agent’s phone will not receive further hunt-group calls but will receive calls that directly dial
the phone’s extension numbers. An agent in not-ready status can return to ready status by pressing
the HLog soft key or by using the HLog feature access code (FAC).
• If the hunt-group logout HLog command has not been used or if the hunt-group logout DND
command has been used, the phone on which the ephone-dn appears is placed into Do Not Disturb
(DND) mode, in which the ephone-dn does not receive any calls at all, including hunt-group calls.
The red lamp on the phone lights to indicate DND status. An agent in DND mode can return to ready
status by pressing the DND soft key or by using the DND FAC.
• When an agent returns to ready status, the ephone hunt group resumes sending calls to the agent’s
ephone-dn.
Note When an agent who is a dynamic member of a hunt group is in not-ready status, the agent’s slot in the
ephone hunt group is not relinquished. It remains reserved by the agent until the agent leaves the group.
You can use the auto logout command with any number of ephone hunt groups, but any ephone-dn to
which the auto logout command applies must belong to only one ephone. Automatic Agent Status
Not-Ready is not supported on shared lines.
Examples This section provides the following examples:
• Cisco CME 3.3 and Earlier Versions
• Cisco Unified CME 4.0 and Later Versions
Cisco CME 3.3and Earlier Versions
In the following example, ephone hunt group 1 is configured to permit automatic logout. If hunt group
calls that are presented to 1001 and 1002 are unanswered (that is, if they ring longer than 40 seconds
each), ephone 1 and ephone 2 are automatically put into DND mode. All unanswered calls are sent to
voice mail (5000).
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 1001
Router(config)# ephone-dn 2
Router(config-ephone-dn)# number 1002
Cisco Unified CME Commands: A
auto logout
72
Cisco Unified CME Command Reference
OL-10894-01
Router(config)# ephone-hunt 1 peer
Router(config-ephone-hunt)# pilot 1111
Router(config-ephone-hunt)# list 1001, 1002
Router(config-ephone-hunt)# final 5000
Router(config-ephone-hunt)# timeout 40
Router(config-ephone-hunt)# auto logout
Router(config)# ephone 1
Router(config-ephone)# button 1:1
Router(config)# ephone 2
Router(config-ephone)# button 1:2
Cisco Unified CME 4.0and Later Versions
In the following example, Automatic Agent Status Not-Ready is limited to dynamic hunt group members
who do not answer two consecutive ephone hunt group calls. Ephone-dn 33, extension 1003, has
dynamically joined ephone-hunt group 1. Ephone 3 will be put into DND mode if extension 1003 does
not answer two consecutive hunt group calls. Ephones 1 and 2 will not be put into DND if they do not
answer hunt-group calls, because the auto logout command applies only to dynamic hunt-group agents.
Router(config)# telephony-service
Router(config-telephony)# hunt-group logout DND
Router(config)# ephone-dn 11
Router(config-ephone-dn)# number 1001
Router(config)# ephone-dn 22
Router(config-ephone-dn)# number 1002
Router(config)# ephone-dn 33
Router(config-ephone-dn)# number 1003
Router(config-ephone-dn)# ephone-hunt login
Router(config)# ephone-hunt 1 peer
Router(config-ephone-hunt)# pilot 1111
Router(config-ephone-hunt)# list 1001, 1002, *
Router(config-ephone-hunt)# final 5000
Router(config-ephone-hunt)# auto logout 2 dynamic
Router(config)# ephone 1
Router(config-ephone)# button 1:11
Router(config)# ephone 2
Router(config-ephone)# button 1:22
Router(config)# ephone 3
Router(config-ephone)# button 1:33
In the following example, Automatic Agent Status Not-Ready cannot be used because all of the
ephone-dns are shared.
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 1001
Router(config)# ephone-dn 2
Router(config-ephone-dn)# number 1002
Router(config)# ephone-hunt 1 peer
Router(config-ephone-hunt)# pilot 1111
Router(config-ephone-hunt)# list 1001, 1002
Router(config-ephone-hunt)# final 6000
Router(config)# ephone 1
Router(config-ephone)# button 1o1,2
Router(config)# ephone 2
Router(config-ephone)# button 1o1,2
Cisco Unified CME Commands: A
auto logout
73
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
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.
timeout Defines the number of seconds after which a call that is not answered is
redirected to the next number in a Cisco Unified CME ephone-hunt-group
list.
Cisco Unified CME Commands: A
auto-answer
74
Cisco Unified CME Command Reference
OL-10894-01
auto-answer
To enable the intercom auto-answer feature on a SIP phone extension, use the auto-answer command in
voice register dn configuration mode. To return to the default, use the no form of this command.
auto-answer
no auto-answer
Syntax Description This command has no arguments or keywords.
Defaults Disabled
Command Modes Voice register dn configuration (config-register-dn)
Command History
Usage Guidelines This command creates an IP phone line connection that resembles a private line, automatic ring-down
(PLAR). The auto-answer causes an extension (directory number) to operate in auto-dial fashion for
outbound calls and auto answer-with-mute for inbound calls. If an extension is configured for intercom
operation, it can be associated with one Cisco IP phone only.
Any caller can dial an intercom extension, and a call to an intercom extension that is originated by a
nonintercom caller triggers an automatic answer exactly like a legitimate intercom call. To prevent
nonintercom originators from manually dialing an intercom destination, you can use alphabetic
characters when you assign numbers to intercom extensions by using the number command. These
characters cannot be dialed from a normal phone but can be dialed by preprogrammed intercom
extensions when calls are made by the router.
Use the reset command to reset an individual SIP phone after you make changes to an extension for a
SIP phone in Cisco CME.
Examples The following example shows how to set the auto-answer feature on SIP phone directory number 1:
Router(config)# voice register dn 1
Router(config-register-dn) number A5001
Router(config-register-dn) auto-answer

Cisco IOS Release Version Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Cisco Unified CME Commands: A
auto-answer
75
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
number (voice register dn) Associates a telephone or extension number with a directory number.
reset (voice register global) Performs a complete reboot of all SIP phones associated with a
Cisco CME router.
reset (voice register pool) Performs a complete reboot of a single SIP phone associated with a
Cisco CME router.
Cisco Unified CME Commands: A
auto-line
76
Cisco Unified CME Command Reference
OL-10894-01
auto-line
To enable automatic line selection on an IP phone in a Cisco CallManager Express (Cisco CME) system,
use the auto-line command in ephone configuration mode. To disable automatic line selection, use the
no form of this command.
auto-line [button-number [answer-incoming] | incoming]
no auto-line
Syntax Description
Command Default Automatic line selection is enabled.
Command Modes Ephone configuration (config ephone)
Command History
Usage Guidelines Use the auto-line command with no keyword or argument enables automatic line selection on the
specified ephone. Picking up a handset answers the first ringing line or, if no line is ringing, selects the
first idle line. This command is also the default behavior if this command is not used.
Use the auto-line incoming command enables automatic line selection for incoming calls only. Picking
up the handset answers the first ringing line and, if no line is ringing, does not select an idle line for an
outgoing call. Pressing a line button selects a line for an outgoing call.
Use the auto-line command with the button-number argument specifies the line that will automatically
be selected when the handset is picked up to make an outgoing call. If a button number is specified and
the line associated with that button is unavailable (because it is a shared line in use on another phone),
no dial tone is heard when the handset is lifted. You must press an available line button to make an
outgoing call. Incoming calls must be answered by pressing the Answer soft key or pressing the ringing
line button.
button-number (Optional) Selects the line associated with the specified button when the
handset is lifted.
answer-incoming (Optional) Enables automatic line selection for incoming calls on the line
associated with the button-number argument.
incoming (Optional) Enables automatic line selection for incoming calls only.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.3(7)T Cisco CME 3.1 The button-number argument was added.
12.4(4)XC Cisco Unified CME 4.0 The answer-incoming keyword was added.
12.4(9)T Cisco Unified CME 4.0 The answer-incoming keyword was integrated
into Cisco IOS 12.4(9)T.
Cisco Unified CME Commands: A
auto-line
77
Cisco Unified CME Command Reference
OL-10894-01
Use the answer-incoming keyword with the button-number argument enables automatic line selection
for incoming calls on the specified button. Picking up the handset answers the incoming call on the line
button associated with the button-number argument.
Use the no auto-line command disables automatic line selection on the ephone that is being configured.
Pressing the Answer soft key answers the first ringing line, and pressing a line button selects a line for
an outgoing call. Picking up the handset does not answer calls or provide dial tone.
Examples The following example shows how to disable automatic line selection. The phone user must use the
Answer soft key or press a line button to answer calls, or the phone user must press a line button to
initiate outgoing calls.
Router(config)# ephone 23
Router(config-ephone)# no auto-line
The following example shows how to enable automatic line selection for incoming calls only. The phone
user picks up the handset to answer the first ringing line. To make outgoing calls, the phone user must
press a line button.
Router(config)# ephone 24
Router(config-ephone)# auto-line incoming
The following example shows how to enable the automatic selection of line button 3 for outgoing calls
when the handset is lifted. There is no automatic answering of incoming calls; the user presses the
Answer soft key or presses a line button to answer a call.
Router(config)# ephone 26
Router(config-ephone)# auto-line 3
The following example shows how to enable the automatic selection of line button 3 when the handset
is lifted to answer incoming calls or to make outgoing calls.
Router(config)# ephone 26
Router(config-ephone)# auto-line 3 answer-incoming
Related Commands Description
ephone Enters ephone configuration mode.
Cisco Unified CME Commands: A
auto-reg-ephone
78
Cisco Unified CME Command Reference
OL-10894-01
auto-reg-ephone
To enable automatic registration of ephones with the Cisco Unified CME system, use the
auto-reg-ephone command in telephony-service configuration mode. To disable automatic registration,
use the no form of this command.
auto-reg-ephone
no auto-reg-ephone
Syntax Description This command has no keywords or arguments.
Command Default Automatic registration is enabled.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command is enabled by default and allows automatic registration, in which Cisco Unified CME
allocates an ephone slot to any ephone that connects to it, regardless of whether the ephone appears in
the configuration or not.
The no form of this command blocks the automatic registration of ephones whose MAC addresses are
not explicitly listed in the configuration. When automatic registration is blocked, Cisco Unified CME
records the MAC addresses of phones that attempt to register but cannot because they are blocked.
Use the show ephone attempted-registrations command to view the list of phones that have attempted
to register but have been blocked. Use the clear telephony-service ephone-attempted-registrations
command to clear the list of phones that have attempted to register but have been blocked.
Examples The following example disables automatic registration of ephones that are not listed in the configuration:
Router(config)# telephony-service
Router(config-telephony)# no auto-reg-ephone

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
12.4(9)T.
Cisco Unified CME Commands: A
auto-reg-ephone
79
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
clear telephony-service
ephone-attempted-registrations
Empties the log of ephones that unsuccessfully attempt to register
with Cisco Unified CME.
show ephone
attempted-registrations
Displays the log of ephones that unsuccessfully attempt to register
with Cisco Unified CME.
Cisco Unified CME Commands: A
auto-reg-ephone
80
Cisco Unified CME Command Reference
OL-10894-01
81
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: B
Revised: October 22, 2009
This chapter contains commands to configure and maintain Cisco Unified
Communications Manager Express (Cisco Unified CME). The commands are presented in alphabetical
order. Some commands required for configuring Cisco Unified CME may be found in other Cisco IOS
references. Use the reference master index or search online to find these commands.
Cisco Unified CME Commands: B
b2bua
82
Cisco Unified CME Command Reference
OL-10894-01
b2bua
To configure a dial peer associated with an individual Session Initiation Protocol (SIP) phone in
Cisco Unified CME or a group of phones in a Cisco Unified SIP Survivable Remote Site Telephony
(SRST) environment to point to Cisco Unity Express, use the b2bua command in dial-peer configuration
mode. To disable B2BUA call flow on the dial peer, use the no form of this command.
b2bua
no b2bua
Syntax Description This command has no arguments or keywords.
Command Default B2BUA callflow is disabled.
Command Modes Dial-peer configuration (config-dial-peer)
Command History
Usage Guidelines Use the b2bua command to set the Cisco Unified CME source address as the 302 redirect contact address
for all calls forwarded to Cisco Unity Express.
Note Use the b2bua command to configure Cisco SIP SRST 3.4 only after using the allow-connections
command to enable B2BUA call flow on the SRST gateway.
Examples The following example shows b2bua included in the configuration for voice dial peer 1:
dial-peer voice 1 voip
destination-pattern 4...
session target ipv4:10.5.49.80
session protocol sipv2
dtmf-relay sip-notify
b2bua
Related Commands
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
Description
allow-connections Enables calls between SIP endpoints in a VoIP network.
dial-peer voice Defines a dial peer and enters dial-peer configuration mode.
mode (voice register
global)
Enables the mode for provisioning SIP phones in a Cisco Unified CME
system.
Cisco Unified CME Commands: B
b2bua
83
Cisco Unified CME Command Reference
OL-10894-01
show dial-peer voice Displays information for dial peers.
source-address (voice
register global)
Identifies the IP address and port through which SIP phones
communicate with a Cisco Unified 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 Unified CME
or Cisco Unified SIP SRST environment.
Description
Cisco Unified CME Commands: B
blf-speed-dial
84
Cisco Unified CME Command Reference
OL-10894-01
blf-speed-dial
To enable Busy Lamp Field (BLF) monitoring for a speed-dial number on a phone registered to
Cisco Unified CME, use the blf-speed-dial command in ephone or voice register pool configuration
mode. To disable BLF monitoring for speed-dial, use the no form of this command.
blf-speed-dial tag number label string [device]
no blf-speed-dial tag
Syntax Description
Command Default BLF monitoring is disabled.
Command Modes Ephone configuration (config-ephone)
Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines This command enables a phone to monitor the status of a line associated with a speed-dial button. The
device keyword enables BLF monitoring of the phone for which the watched directory number is the
primary line. This allows watchers to monitor whether a user is on the phone, not just an individual line
on the phone.
The directory number associated with the speed-dial number must have presence enabled with the
allow watch command. For device-level monitoring, all directory numbers associated with the
monitored phone require the allow watch command. If any of the directory numbers is missing this
configuration, the device status reported to the watcher could be inconsistent.
After using this command for SIP phones, you must generate a new configuration profile by using the
create profile command and then restart the phones with the restart command.
For information on the BLF status indicators that display on specific types of phones in
Cisco Unified CME, see the Cisco Unified IP Phone documentation for your phone model.
tag Number that identifies the speed-dial index. Range: 1 to 33 (SCCP);
1 to 7 (SIP).
number Telephone number to speed dial.
label string Alphanumeric label that identifies the speed-dial button. The string can
contain up to 30 characters.
device (Optional) Enables phone-based monitoring.
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 device keyword was added.
12.4(24)T Cisco Unified CME 7.1 This command has been integrated into Cisco IOS
Release 12.4(24)T.
Cisco Unified CME Commands: B
blf-speed-dial
85
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows BLF speed-dial monitoring enabled on phone 1 for individual directory
numbers. The line status of extensions 51212 and 51214 displays on phone 1 provided that presence is
enabled for those directory numbers.
Router(config)# ephone 1
Router(config-ephone)# blf-speed-dial 1 51212 label sales
Router(config-ephone)# blf-speed-dial 2 51214 label payroll

Router(config)# voice register pool 1
Router(config-register-pool)# blf-speed-dial 1 51212 label sales
Router(config-register-pool)# blf-speed-dial 2 51214 label payroll

The following example shows phone-based BLF speed-dial monitoring enabled on phone 2. The line
status of all extensions on the phone for which 51212 is the primary number displays on phone 2
provided that presence is enabled for those directory numbers.
Router(config)# ephone 2
Router(config-ephone)# blf-speed-dial 1 51212 label sales device

Router(config)# voice register pool 2
Router(config-register-pool)# blf-speed-dial 1 51212 label sales 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.
create profile Generates the configuration profile files required for SIP phones.
presence Enables presence service and enters presence configuration mode.
presence call-list Enables BLF monitoring for call lists and directories on phones registered to
Cisco Unified CME.
restart (voice register) Performs a fast restart of one or all SIP phones associated with a Cisco
Unified CME router.
Cisco Unified CME Commands: B
bnea
86
Cisco Unified CME Command Reference
OL-10894-01
bnea
To specify the audio file used for the busy station not equipped for preemption announcement, use the
bnea command in voice MLPP configuration mode. To disable use of this audio file, use the no form of
this command.
bnea audio-url
no bnea
Syntax Description
Command Default No announcement is played.
Command Modes Voice MLPP configuration (config-voice-mlpp)
Command History
Usage Guidelines This command specifies the G.711 a-law or u-law 8-KHz encoded audio file (.wav or. au format) for the
announcement that is played to the caller when the dialed number is not preemptable.
The mlpp indication command must be enabled (default) for a phone to play preemption
announcements.
This command is not supported by Cisco IOS help. If you type ?, Cisco IOS help does not display a list
of valid entries.
Examples The following example shows the busy station not equipped for preemption announcement is set to the
file named bnea.au located in flash:
Router(config)# voice mlpp
Router(config-voice-mlpp)# bnea flash:bnea.au
Related Commands
audio-url Location of the announcement audio file in URL format. Valid storage
locations are TFTP, FTP, HTTP, and flash memory.
Release Cisco Products 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.
Command Description
access-digit Defines the access digit that phone users dial to request a precedence call.
bpa Specifies the audio file used for the blocked precedence announcement.
mlpp indication Enables MLPP indication on an SCCP phone or analog FXS port.
mlpp preemption Enables preemption capability on an SCCP phone or analog FXS port.
Cisco Unified CME Commands: B
bpa
87
Cisco Unified CME Command Reference
OL-10894-01
bpa
To specify the audio file used for the blocked precedence announcement, use the bpa command in voice
MLPP configuration mode. To disable use of this audio file, use the no form of this command.
bpa audio-url
no bpa
Syntax Description
Command Default No announcement is played.
Command Modes Voice MLPP configuration (config-voice-mlpp)
Command History
Usage Guidelines This command specifies the G.711 a-law or u-law 8-KHz encoded audio file (.wav or .au format) for the
announcement that is played to the caller in the following situations:
• Destination party for the precedence call is off hook.
• Destination party is busy with a precedence call of an equal or higher precedence and the destination
party does not have Call Waiting or Call Forward configured, and does not have an attendant-console
service configured.
The mlpp indication command must be enabled (default) for a phone to play precedence
announcements.
This command is not supported by Cisco IOS help. If you type ?, Cisco IOS help does not display a list
of valid entries.
Examples The following example shows the blocked precedence announcement is set to the file named bpa.au
located in flash:
Router(config)# voice mlpp
Router(config-voice-mlpp)# bpa flash:bpa.au
Related Commands
audio-url Location of the announcement audio file in URL format. Valid storage
locations are TFTP, FTP, HTTP, and flash memory.
Release Cisco Products 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.
Cisco Unified CME Commands: B
bpa
88
Cisco Unified CME Command Reference
OL-10894-01
Command Description
attendant-console Specifies the phone number of the MLPP attendant-console service.
bnea Specifies the audio file used for the busy station not equipped for
preemption announcement.
mlpp indication Enables MLPP indication on an SCCP phone or analog FXS port.
mlpp preemption Enables preemption capability on an SCCP phone or analog FXS port.
Cisco Unified CME Commands: B
bulk
89
Cisco Unified CME Command Reference
OL-10894-01
bulk
To set bulk registration for E.164 numbers that will register with SIP proxy server, use the bulk
command in voice register global configuration mode. To disable bulk registration, use the no form of
this command.
bulk number-pattern
no bulk
Syntax Description
Command Default .Bulk registration is disabled.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command allows you to configure bulk registration for registering a block of phone numbers with
an external registrar so that calls can be routed to Cisco CME from the SIP network.
Numbers that match the number pattern defined by using the bulk command register with the external
registrar. The block of numbers that is registered can include any phone that is attached to Cisco CME
using SIP or SCCP, or any analog phone that is directly attached to a Cisco router FXS port.
A number can contain one or more periods (.) as wildcard characters that will match any dialed number
in that position. For example, 51.. rings when 5100 is dialed, when 5101 is dialed, and so forth.
The external registrar is configured by using the registrar server command under the SIP user-agent
configuration mode.
Examples The following example shows how to specify that numbers matching 1235 and any other dialed number
in the next four positions, be routed to the Cisco CME from the SIP network.
Router(config)# voice register global
Router(conf-register-global)# mode cme
Router(conf-register-global)# bulk 1235...

number-pattern A sequence of digits including wild card character.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Cisco Unified CME Commands: B
bulk
90
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Description
mode (voice register
global)
Enables the mode for provisioning SIP phones in a Cisco CallManager
Express (Cisco CME) system.
no reg (voice register
dn)
Specifies that a directory number in a SIP Cisco CallManager Express
(Cisco CME) system not register with an external proxy server
no reg (voice
hunt-group)
Specifies that a pilot number for a voice hunt group not register with an
external proxy server
registrar Enables SIP registrar functionality.
Cisco Unified CME Commands: B
bulk-speed-dial list
91
Cisco Unified CME Command Reference
OL-10894-01
bulk-speed-dial list
To enable use of a bulk speed-dial list, use the bulk-speed-dial list command in ephone or
telephony-service configuration mode. To remove the list, use the no form of this command.
bulk-speed-dial list list-id location
no bulk-speed-dial list list-id
Syntax Description
Command Default No default behavior or values.
Command Modes Ephone configuration (config-ephone)
Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command in telephony-service configuration mode enables a bulk speed-dial list on a per-system
basis for all phones in Cisco Unified CME. This command in ephone configuration mode enables a bulk
speed-dial list for a particular phone in Cisco Unified CME.
Bulk speed-dial lists must contain only comma-separated data. Typically, speed-dial lists are text files
saved with the.txt file extension or Microsoft® Office Excel tables saved as .csv files.
Each list contains entries of speed-dial codes and the associated phone numbers to be dialed. Each entry
in a list must appear on a separate line. Fields in each entry are separated by commas (,). A line that
begins with a semicolon (;) is a comment and is ignored by Cisco Unified CME. Each entry in a list can
include the following fields. For information about each field, see Table 1.
index,digits,[name],[hide],[append]
Table 1 explains the fields in a bulk speed-dial list entry.
list-id Digit that identifies the list to be used. Range is from 0 to 9.
location Location of the bulk speed-dial list. Valid storage locations are TFTP, HTTP,
and Flash memory.
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
12.4(9)T.
Cisco Unified CME Commands: B
bulk-speed-dial list
92
Cisco Unified CME Command Reference
OL-10894-01
The following is a sample bulk speed-dial list:
01,5550140,voicemail,hide,append
90,914085550153,Cisco extension,hide,append
11,9911,emergency,hide,
91,9911,emergency,hide,
08,110,Paging,,append
The software does not automatically detect changes to the list files. If you modify a bulk speed-dial list
that is enabled at a global or phone level, explicitly disable the list using the no form of this command,
then enable the modified list. If the same list is enabled for more than one phone, disable the list on each
phone using the no form of this command in ephone configuration mode, then enable the modified list
per phone.
Table 1 Bulk Speed-Dial List Entry
Field Description
index Zero-filled number that uniquely identifies this index entry.
Maximum length: 4 digits. All index entries must be the same
length.
digits Telephone number to dialed. Represents a fully qualified
E.164 number. Use a comma (,) to represent a one-second
pause.
name (Optional) Alphanumeric string to identify a name, up to 30
characters.
hide (Optional) Enter hide to block the display of the dialed
number.
append (Optional) Enter append to allow additional digits to be
appended to this number when dialed.
Cisco Unified CME Commands: B
bulk-speed-dial list
93
Cisco Unified CME Command Reference
OL-10894-01
Use the bulk speed-dial prefix command to change the prefix code that a phone user must dial to access
speed-dial numbers from a bulk speed-dial list. The default prefix is # (pound sign).
If a bulk speed-dial list is enabled using this command in telephony-service configuration mode and is
also enable using this command in ephone configuration mode, the list enabled in ephone configuration
mode takes precedence over the list at the global level for a given prefix. However, if the prefix used at
the global level is different than the prefix used at the phone level, the lists are treated as separate lists -
each list being associated with a different prefix, and at the phone level, you can access both lists.
Bulk speed dial is not supported on FXO trunk lines.
Use the show telephony-service bulk-speed-dial to display information about bulk speed-dial lists that
are configured in Cisco Unified CME.
Examples The following example shows that the default global bulk speed-dial prefix is changed to #7 and bulk
speed-dial list 6 is enabled at a global level for all phones. To place a call to an entry in this bulk
speed-dial list, the phone user must first dial #7, followed by the list-id (6), then the index number for
the entry to be called. This example also shows that bulk speed-dial list 7, with the default prefix
unchanged, is enabled for ephone 2 only.
telephony-service
bulk-speed-dial list 6 flash:sd_dept_01_1_87.txt
bulk-speed-dial prefix #7
ephone-dn 3
number 2555
ephone-dn 4
number 2557
ephone 2
button 1:3 2:4
bulk-speed-dial list 7 flash:lmi_sd_list_08_24_95.csv

Related Commands Command Description
bulk-speed-dial prefix Sets the prefix code that phone users dial to access speed-dial numbers from
a bulk speed-dial list that is enabled system-wide.
show
telephony-service
bulk-speed-dial
Displays information about bulk speed-dial lists that are configured in
Cisco Unified CME.
Cisco Unified CME Commands: B
bulk-speed-dial prefix
94
Cisco Unified CME Command Reference
OL-10894-01
bulk-speed-dial prefix
To set the prefix code that phone users dial to access speed-dial numbers from a global bulk speed-dial
list, use the bulk-speed-dial prefix command in telephony-service configuration mode. To return the
prefix code to the default, use the no form of this command.
bulk-speed-dial prefix prefix-code
no bulk-speed-dial-prefix
Syntax Description
Command Default The default prefix code (number sign [#]) is used.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command changes the prefix code that a phone user must dial to access speed-dial numbers from a
speed-dial list that is enabled using the bulk-speed-dial list command in telephony-service
configuration mode. The default prefix is # (number sign).
If a bulk speed-dial list is enabled using this command in telephony-service configuration mode and is
also enable using this command in ephone configuration mode, the list enabled in ephone configuration
mode takes precedence over the list at the global level for a given prefix. However, if the prefix used at
the global level is different than the prefix used at the phone level, the lists are treated as separate lists -
each list being associated with a different prefix, and at the phone level, you can access both lists.
Use the show telephony-service bulk-speed-dial to display information about bulk speed-dial lists that
are configured in Cisco Unified CME.
prefix-code One to four-character access code for speed dial. Default is #.
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
12.4(9)T.
Cisco Unified CME Commands: B
bulk-speed-dial prefix
95
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example changes the default bulk speed-dial prefix to #7 and enables global bulk
speed-dial list number 6 for all phones. It also enables a personal bulk speed-dial list for ephone 2. In
this example, ephone 2 can access all of the numbers in both lists because each list is assigned a different
prefix (# and #7).
telephony-service
bulk-speed-dial list 6 flash:sd_dept_01_1_87.txt
bulk-speed-dial prefix #7
ephone-dn 3
number 2555
ephone-dn 4
number 2557
ephone 2
button 1:3 2:4
bulk-speed-dial list 7 flash:lmi_sd_list_08_24_95.csv

Related Commands Description
bulk-speed-dial list Enables a bulk speed-dial list.
show
telephony-service
bulk-speed-dial
Displays information about bulk speed-dial lists that are configured in
Cisco Unified CME.
Cisco Unified CME Commands: B
busy-trigger-per-button
96
Cisco Unified CME Command Reference
OL-10894-01
busy-trigger-per-button
To set the maximum number of calls allowed on an octo-line directory number before activating
Call Forward Busy or a busy tone, use the busy-trigger-per-button command in ephone or
ephone-template configuration mode. To reset to the default, use the no form of this command.
busy-trigger-per-button number-of-calls
no busy-trigger-per-button
Syntax Description
Command Default Disabled (busy trigger is 0).
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines This command limits the calls to an octo-line on the specified phone by triggering Call Forward Busy or
a busy tone. After the number of active calls, incoming and outgoing, on an octo-line directory number
reaches the limit set with this command, the next incoming call to the directory number is forwarded to
the Call Forward Busy destination. If Call Forward Busy is not configured, Cisco Unified CME rejects
the call and plays a busy tone.
This command applies to each octo-line directory number on the phone.
If a directory number is shared among different phones, the busy trigger is initiated after the number of
existing calls exceeds the limit set on any of the phones that share the directory number.
This command must be set to a value that is less than or equal to the value set with the
max-calls-per-button command.
If you use an ephone template to apply a command to an ephone and you also use the same command in
ephone configuration mode for the same ephone, the value that you set in ephone configuration mode
has priority.
Examples The following example shows that after an octo-line on ephone 1 receives four calls, the fifth incoming
call triggers Call Forward Busy or a busy tone.
Router(config)# ephone 1
Router(config-ephone)# busy-trigger-per-button 4
number-of-calls Maximum number of calls. Range: 1 to 8. Default: 0 (disabled).
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 integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: B
busy-trigger-per-button
97
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
call-forward busy Enables call forwarding so that incoming calls to a busy extension are
forwarded to another extension.
ephone-dn Configures a directory number for SCCP phones.
max-calls-per-button Sets the maximum number of calls allowed on an octo-line directory
number on an SCCP phone.
Cisco Unified CME Commands: B
busy-trigger-per-button (voice register pool)
98
Cisco Unified CME Command Reference
OL-10894-01
busy-trigger-per-button (voice register pool)
To set the maximum number of calls allowed on a SIP directory number before activating Call Forward
Busy or a busy tone, use the busy-trigger-per-button command in voice register pool configuration
mode. To reset to the default, use the no form of this command.
busy-trigger-per-button number
no busy-trigger-per-button
Syntax Description
Command Default Busy trigger is disabled (0).
Command Modes Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines This command limits the number of calls to each directory number on the specified phone by triggering
Call Forward Busy or a busy tone. After the number of active calls, both incoming and outgoing, reaches
the number of calls set with this command, Cisco Unified CME forwards the next incoming call to the
Call Forward Busy destination. Cisco Unified CME rejects the call and plays a busy tone if Call Forward
Busy is not configured.
If a directory number is shared among different phones, the busy trigger is initiated after the number of
existing calls exceeds the limit set on all of the phones that share the directory number.
This command must be set to a value that is less than or equal to the value set with the
max-calls-per-button command.
Examples The following example shows that after a shared-line on phone 1 receives four calls, the fifth incoming
call triggers Call Forward Busy or a busy tone.
Router(config)# voice register pool 1
Router(config-register-pool)# busy-trigger-per-button 4
Related Commands
number Maximum number of calls. Range: 1 to 50. Default: 0 (disabled).
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.
Command Description
huntstop (voice register dn) Disables call hunting behavior for a directory number on a SIP phone.
Cisco Unified CME Commands: B
busy-trigger-per-button (voice register pool)
99
Cisco Unified CME Command Reference
OL-10894-01
max-calls-per-button Sets the maximum number of calls allowed on an octo-line directory
number on an SCCP phone.
shared-line Creates a directory number to be shared by multiple SIP phones.
Command Description
Cisco Unified CME Commands: B
button
100
Cisco Unified CME Command Reference
OL-10894-01
button
To associate ephone-dns with individual buttons on a Cisco Unified IP phone and to specify line type or
ring behavior, use the button command in ephone configuration mode. To remove an ephone-dn
association from a button, use the no form of this command.
button button-number {separator} dn-tag [,dn-tag...] [button-number{x}overlay-button-number]
[button-number...]
no button button-number {separator} dn-tag [,dn-tag...]
[button-number{x}overlay-button-number] [button-number...]
Syntax Description button-number Number of a line button on a Cisco Unified IP phone that is to be associated
with an extension (ephone-dn).
The maximum number of button–ephone-dn pairs is determined by the
phone type.
Note The Cisco Unified IP Phone 7910G has only one physical line
button, but you can assign it two button–ephone-dn pairs.
separator Single character that denotes the characteristics to be associated with this
phone button. Valid entries are as follows:
• : (colon)—Normal ring. For incoming calls on this extension, the phone
produces audible ringing, a flashing icon in the phone display, and a
flashing red light on the handset. On the Cisco IP Phone 7914
Expansion Module, a flashing yellow light also accompanies incoming
calls.
• b—Beep but no ring. Audible ring is suppressed for incoming calls, but
call-waiting beeps are allowed. Visible cues are the same as those
described for a normal ring.
• c—Call waiting. Provides call waiting for secondary calls to an overlaid
ephone-dn. See also the o keyword.
• f—Feature ring. Differentiates incoming calls on a special line from
incoming calls on other lines on the phone. The feature-ring cadence is
a triple pulse, as opposed to a single pulse for normal internal calls and
a double pulse for normal external calls.
Cisco Unified CME Commands: B
button
101
Cisco Unified CME Command Reference
OL-10894-01
Command Default No buttons are defined for an ephone.
Command Modes Ephone configuration (config-ephone)
Command History
• m—Monitor mode for a shared line. Visible line status indicates
whether the line is in-use or not. Monitored lines cannot be used on this
phone for incoming or outgoing calls.
• o—Overlay line. Multiple ephone-dns share a single button, up to a
maximum of 25 on a button. See also the c keyword.
• s—Silent ring. Audible ring and call-waiting beep are suppressed for
incoming calls. The only visible cue is a flashing ((< icon in the phone
display.
Note In Cisco IOS Release 12.4(4)XC and later releases, the silent ringing
behavior is overridden during active night-service periods. Silent
ringing does not apply during designated night-service periods when
the s keyword is used.
• w—Watch mode for all lines on the phone for which this directory
number is the primary line. Visible line status indicates whether watched
phone is idle or not.
dn-tag Ephone-dn tag that was previously defined using the ephone-dn command.
When used with the c and o keywords, the dn-tag argument can contain up
to 25 individual dn-tags, separated by commas.
x Separator that creates an overlay rollover button. When the overlay button
specified in this command is occupied by an active call, a second call to one
of its ephone-dns will appear on this button. This button is also known as an
overlay expansion button.
overlay-button-number Number of the overlay button that should overflow to this button.
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(11)YT Cisco ITS 2.1 The b and s keywords were added.
12.2(15)ZJ Cisco CME 3.0 The f, m, and o keywords were added.
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 The c keyword was added and the ability to use the
m keyword to monitor call-park slots was added.
12.3(14)T Cisco CME 3.3 This command was integrated into Cisco IOS
Release 12.3(14)T.
Cisco Unified CME Commands: B
button
102
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines The button command assigns telephone extensions to Cisco Unified IP phones by associating a button
number with one or more directory numbers (ephone-dns).
Note After adding or changing a phone button configuration using this command, you must perform a quick
reboot of the phone using the restart command.
Telephone services such as call waiting and three-party conferences require a minimum of two phone
lines (ephone-dns defined with the ephone-dn command) to be available and configured on a Cisco IP
phone.
The Cisco Unified IP Phone 7910G has only one physical line button. To support call waiting and
three-party conferences on a Cisco Unified IP Phone 7910G, a second (hidden) line is required. This line
cannot be selected directly using a line button. You can access the second line when you press the
Conference button. You can also support multiple-call services using the ephone-dn dual-line
configuration option.
Feature Ring (f)
A feature ring is a third type of ring cadence, in addition to the internal call and external call ring
cadences. For example, an internal call in the United States rings for 2 seconds on and 4 seconds off
(single-pulse ring), and an external call rings for 0.4 seconds on, 0.2 seconds off, 0.4 seconds on, and
0.2 seconds off (double-pulse ring). A feature ring is a triple-pulse ring. The purpose of associating a
feature ring with a line button is to be able to identify from a distance a special line that is ringing on a
multiline phone.
Monitor Mode (m)
A line button set in monitor mode on one phone displays visual line status for a line that also appears on
another phone. When monitor mode is set for a button with a shared line, the line status indicates that
the shared line is either idle or in use. The line and line button are available in monitor mode for visual
status only. Calls cannot be made or received using a line button that has been set in monitor mode.
Incoming calls on a line button that is in monitor mode do not ring and do not display caller ID or
call-waiting caller ID.
Monitor mode is intended for use only in the context of shared lines so that a receptionist can visually
monitor the in-use status of several users’ phone extensions (for example, as a busy-lamp field). To
monitor all lines on an individual phone so that a receptionist can visually monitor the in-use status of
that phone, see the “Watch Mode (w)” section on page 104.
12.4(4)XC Cisco Unified CME 4.0 The x keyword was added and the number of
ephone-dns that can be overlaid on a single button
with the o or c keyword was increased from
10 to 25. The interaction between the keyword and
night service was modified; silent ringing is
overridden when night service is active.
12.4(9)T Cisco Unified CME 4.0 The modifications made to This command were
integrated into Cisco IOS Release 12.4(9)T.
12.4(11)XJ2 Cisco Unified CME 4.1 The w keyword was added.
12.4(15)T Cisco Unified CME 4.1 This command with the w keyword was integrated
into Cisco IOS Release 12.4(15)T.
Cisco IOS Release Cisco Product Modification
Cisco Unified CME Commands: B
button
103
Cisco Unified CME Command Reference
OL-10894-01
The line button for a monitored line can also be used as a direct-station-select for a call transfer when
the monitored line is in an idle state. In this case, the receptionist who transfers a call from a normal line
can press the Transfer button and then press the line button of the monitored line, causing the call to be
transferred to the phone number of the monitored line.
Overlay (o)
Overlay lines are ephone-dns that share a single button on a multibutton phone. When more than one
incoming call arrives on lines that are set on a single button, the line (ephone-dn) that is the leftmost in
the button command list is the primary line and is given the highest priority. If this call is answered by
another phone or if the caller hangs up, the phone selects the next line in its overlay set to present as the
ringing call. The caller ID display updates to show the caller ID for the currently presented call.
Ephone-dns that are part of an overlay set can be single-line ephone-dns or dual-line ephone-dns, but the
set must contain either all single-line ephone-dns or all dual-line ephone-dns, and not a mixture of the
two.
The primary ephone-dn on each phone in a shared-line overlay set should be unique to the phone being
configured to guarantee that there is a line available for outgoing calls, and to ensure that the phone user
can obtain dial-tone even when there are no idle lines available in the rest of the shared-line overlay set.
Use a unique ephone-dn in this manner to provide for a unique calling party identity on outbound calls
made by the phone so that the called user can see which specific phone is calling.
The name of the first ephone-dn in the overlay set is not displayed because it is the default ephone-dn
for calls to the phone, and the name or number is permanently displayed next to the phone’s button. For
example, if there are ten ephone-dns in an overlay set, only the last nine ephone-dns are displayed when
calls are made to them.
Overlay Ephone-dns with Call Waiting (c)
The configuration for the overlaid ephone-dns with call waiting (keyword c) and without call waiting
(keyword o) is the same.
Ephone-dns accept call interruptions, such as call waiting, by default. For call waiting to work, the
default must be active. To ensure that the default is active, remove the no call-waiting beep accept
command from the configurations of ephone-dns for which you want to use call waiting.
In Cisco Unified CME 4.0(3), the Cisco Unified IP Phone 7931G cannot support overlays that contain
ephone-dn configured for dual-line mode.
Note In general, all the ephone-dns within an overlay must be of the same type (dual-line or single line mode).
Silent Ring (s)
You can configure silent ring on any type of phone. However, you typically set silent ring only on buttons
of a phone with multiple lines, such as a Cisco Unified IP Phone 7940, Cisco Unified IP Phones 7960
and 7960G, or a Cisco Unified IP Phone 7914 Expansion Module. The only visible cue is a flashing ((<
icon in the phone display.
If you configure a button to have a silent ring, you will not hear a call-waiting beep or call-waiting ring
regardless of whether the ephone-dn associated with the button is configured to generate a call-waiting
beep or call-waiting ring.
In Cisco IOS Release 12.4(4)XC and later releases, the silent ringing behavior is overridden during
active night-service periods. Silent ringing does not apply during designated night-service periods when
the s keyword is used.
Cisco Unified CME Commands: B
button
104
Cisco Unified CME Command Reference
OL-10894-01
Watch Mode (w)
A line button that is configured for watch mode on one phone provides visual line status for all lines on
another phone (watched phone) for which the watched directory number is the primary line. Watched
mode allows a phone user, such as a receptionist, to visually monitor the in-use status of an individual
phone. The line and line button on the watching phone are available in watch mode for visual status only.
Calls cannot be made or received using a line button that has been set in watch mode. Incoming calls on
a line button that is in watch mode do not ring and do not display caller ID or call-waiting caller ID.
If any of the following conditions are true, the status of the line button in watch mode is that the watched
phone is in-use:
• Watched phone is off-hook
• Watched phone is not registered
• Watched phone is in the do-not-disturb (DND) mode
• Watched directory number is not idle
Note If the watched directory number is a shared line and the shared line is not idle on any phone with which
it is associated, then in the context of watch mode, the status of the line button indicates that the watched
phone is in use.
For best results in terms of monitoring the status of an individual phone based on a watched directory number,
the directory number to be configured for watch mode should not be a shared line. To monitor a shared line
so that a receptionist can visually monitor the in-use status of several users’ phone extensions, see the
“Monitor Mode (m)” section on page 102.
If the watched directory number is associated with several phones, then the watched phone is the one on
which the watched directory number is on button 1 or the one on which the watched directory number
is on the button that is configured by using the auto-line command, with auto-line having priority.
If more than one phone meets the criteria for primary line as described above, then the watched phone
is the first phone that meets the criteria. Typically, that is the phone with the lowest ephone tag value.
However, if the watched directory number is configured on button 1 of ephone 1 and the same directory
number is also configured on button 3 with “auto-line 3” of ephone 24, then ephone 24 is the watched
phone because the auto-line configuration has priority.
The line button for a watched phone can also be used as a direct-station-select for a call transfer when
the watched phone is idle. In this case, the phone user who transfers a call from a normal line can press
the Transfer button and then press the line button of the watched directory number, causing the call to
be transferred to the phone number associated with the watched directory number.
Expansion Buttons for Overlay Ephone-dns (x)
This feature works to expand coverage for an overlay button that has been configured using the o
separator in the button command. Overlay buttons with call waiting that use the c separator in the button
command are not eligible for overlay rollover.
Examples The following example assigns four button numbers on the phone to ephone-dn tags. Button 4 is
configured for a silent ring:
ephone-dn 1
number 233
ephone-dn 4
Cisco Unified CME Commands: B
button
105
Cisco Unified CME Command Reference
OL-10894-01
number 234
ephone-dn 16
number 235
ephone-dn 19
number 236
ephone 1
button 1:1 2:4 3:16 4s19
The following example shows three phones that each have three instances of extension number 1001
overlaid onto a single button, which allows three simultaneous calls to extension 1001. The first call
arrives on ephone-dn 1 and rings button 1 on all three phones. The call is answered on ephone 10. A
second call for 1001 hunts onto ephone-dn 2 and rings on the remaining two ephones, ephones 11 and
12, and is answered by ephone 12. A third call to 1001 hunts onto ephone-dn 3 and rings on ephone 12,
where it is answered. This configuration creates a three-way shared line across three IP phones and can
handle three simultaneous calls to the same telephone number. Note that if ephone 12 is busy, the third
call will go to voice mail (7000). Note also that if you want to configure call waiting, you can use the
same configuration, except use the c keyword instead of the o keyword. Ephone 10 uses call waiting.
ephone-dn 1
number 1001
no huntstop
!
ephone-dn 2
number 1001
no huntstop
preference 1
!
ephone-dn 3
number 1001
preference 2
call-forward busy 7000
!
! The next ephone configuration includes the first instance of shared line 1001.
ephone 10
mac-address 1111.2222.3333
button 1c1,2,3
!
! The next ephone configuration includes the second instance of shared line 1001.
ephone 11
mac-address 1111.2222.4444
button 1o1,2,3
!
! The next ephone configuration includes the third instance of shared line 1001.
ephone 12
mac-address 1111.2222.555
button 1o1,2,3
The following is an example of a unique ephone-dn as the primary dn in a simple shared-line overlay
configuration. The no huntstop command is configured for all the ephone-dns except ephone-dn 12, the
last one in the overlay set. Because the ephone-dns are dual-line dns, the huntstop-channel command
is also configured to ensure that the second channel remains free for outgoing calls and for conferencing.
ephone-dn 1 dual-line
number 101
huntstop-channel
!
ephone-dn 2 dual-line
number 102
huntstop-channel
Cisco Unified CME Commands: B
button
106
Cisco Unified CME Command Reference
OL-10894-01
!
ephone-dn 10 dual-line
number 201
no hunsttop
huntstop-channel
!
ephone-dn 11 dual-line
number 201
no hunsttop
huntstop-channel
!
ephone-dn 12 dual-line
number 201
huntstop-channel
!
!The next ephone configuration includes (unique) ephone-dn 1 as the primary line in a
shared-line overlay
ephone 1
mac-address 1111.1111.1111
button 1o1,10,11,12
!
!The next ephone configuration includes (unique) ephone-dn 2 as the primary line in
another shared-line overlay
ephone 2
mac-address 2222.2222.2222
button 1o2,10,11,12
Shared-line overlays can be constructed using the “button o” or “button c” formats, depending on
whether call-waiting is desired. The following example shows an ephone configuration that enables call
waiting (c) in a shared-line overlay:
ephone 1
mac-address 1111.1111.1111
button 1c1,10,11,12
!
ephone 2
mac-address 2222.2222.2222
button 1c2,10,11,12
The following example configures a “3x3” shared-line setup for three ephones and nine shared lines
(ephone-dns 20 through 28). Each ephone has a unique ephone-dn for each of its three buttons
(ephone-dns 1 to 3, ephone-dns 4 to 6, and ephone-dns 7 to 9). The remaining ephone-dns are shared
among the three phones. Three phones with three buttons each can take nine calls. The overflow buttons
provide the ability for an incoming call to ring on the first available button on each phone.
ephone 1
button 1o1,2,3,20,21,22,23,24,25,26,27,28 2x1 3x1
ephone 2
button 1o4,5,6,20,21,22,23,24,25,26,27,28 2x1 3x1
ephone 3
button 1o7,8,9,20,21,22,23,24,25,26,27,28 2x1 3x1
Cisco Unified CME Commands: B
button
107
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Description
call-waiting beep Allows phone buttons to accept or generate call-waiting beeps.
restart (ephone) Performs a fast reboot of a single phone associated with a
Cisco Unified CME router.
restart
(telephony-service)
Performs a fast reboot of one or all phones associated with a
Cisco Unified CME router.
show ephone Displays information about ephones and the corresponding Cisco Unified IP
phones.
show ephone overlay Displays the configuration and current status of registered overlay
ephone-dns.
Cisco Unified CME Commands: B
button-layout
108
Cisco Unified CME Command Reference
OL-10894-01
button-layout
To configure a fixed set of line or feature buttons in an ephone-template which can then be applied to a
supported IP phone in Cisco Unified CME, use the button-layout set command in ephone-template
configuration mode. To disable the feature buttons set and change the action of the buttons on IP phones,
use the no form of this command.
button-layout phone-type {1 | 2}
no button-layout
Syntax Description
Command Default No fixed set of line or feature buttons are defined.
Command Modes Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines Use this command to configure either Set 1 or Set 2 in an ephone-template which can then be applied to
an individual Cisco Unified IP Phone 7931G in Cisco Unified CME.
After a template has been created, you can apply it to an ephone using the ephone-template command
in ephone configuration mode. You cannot apply more than one ephone template to an ephone.
To view your ephone-template configurations, use the show telephony-service ephone-template
command.
phone-type Type of IP phone. The following choices are valid:
• 7931—Cisco Unified IP Phone 7931.
1 Number of fixed line or feature set containing the following buttons:
• Button 24—Menu.
• Button 23—Headset.
2 Number of fixed line or feature set containing the following buttons:
• Button 24—Menu.
• Button 23—Headset.
• Button 22—Directories.
• Button 21—Messages.
Cisco IOS Release Cisco Product Modification
12.4(6)XE Cisco Unified CME 4.0(2) This command was introduced.
12.4(4)XC4 Cisco Unified CME 4.0(3) This command was introduced.
12.4(11)T Cisco Unified CME 4.0(3) This command was integrated into
Cisco IOS Release 12.4(11)T.
Cisco Unified CME Commands: B
button-layout
109
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to create ephone-template 12, containing set 2 feature buttons, and
apply the template to ephone 36.
Router(config)# ephone-template 12
Router(config-ephone-template)# button-layout set 2
Router(config-ephone-template)# exit
Router(config)# ephone 36
Router(config-ephone)# ephone-template 12
Router(config-ephone)# exit
Router(config)# telephony-service
Router(config-telephony)# create cnf-files

Related Commands Description
ephone-template
(ephone)
Applies template to an ephone.
show telephon-service
ephone-template
Displays ephone-template configurations.
Cisco Unified CME Commands: B
button-layout
110
Cisco Unified CME Command Reference
OL-10894-01
111
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: C
Revised: October 22, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified CME Commands: C
call application voice aa-hunt
112
Cisco Unified CME Command Reference
OL-10894-01
call application voice aa-hunt
Effective with Cisco IOS Release 12.3(14)T and later, the call application voice aa-hunt command is
replaced by the param aa-hunt command. See the param aa-hunt command for more information.
To declare a Cisco Unified CME basic automatic call distribution (B-ACD) menu number and associate
it with the pilot number of an ephone hunt group, use the call application voice aa-hunt command in
global configuration mode. To remove the menu number and the ephone hunt group pilot number, use
the no form of this command.
call application voice application-name aa-huntmenu-number pilot-number
no call application voice application-name aa-huntmenu-number pilot-number
Syntax Description
Command Default Cisco CME B-ACD menu number 1 is configured, but it has no pilot number.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier
than 2.1.0.0 and is used only with with a version of the Cisco Unified CME B-ACD script that is earlier
than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD call queue scripts. Up
to three menu options are allowed per call queue script. You can use any of the allowable numbers in any
order.
The call application voice aa-hunt command allows each of the menu options to be associated with the
pilot number of an ephone hunt group. The menu options are announced by the
en_bacd_options_menu.au audio file, which you can rerecord. When a caller presses a number, the call
will go to the pilot number of an ephone hunt group so it can be transferred to one of the ephone hunt
group’s ephone-dns. It will not go to any other ephone hunt group. The order in which ephone-dns are
selected depends on the ephone hunt group’s search method, which is configured with the ephone-hunt
command, and whether an ephone-dn is busy or not.
menu-number Number that callers must dial to reach the pilot number of an ephone hunt
group. The range is from 1to 10. The default is 1.
application-name Application name given to the call queue script in the call application voice
command.
pilot-number Ephone hunt group pilot number.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced with the param
aa-hunt command.
Cisco Unified CME Commands: C
call application voice aa-hunt
113
Cisco Unified CME Command Reference
OL-10894-01
If only one menu option is configured, callers will hear a greeting and be transferred directly to the pilot
number of the corresponding ephone hunt group. They do not have to enter a number.
The highest aa-hunt number will automatically be set to zero (0) for the operator. In the following
example, aa-hunt8 supports the menu option of 0 and 8.
call application voice queue aa-hunt1 1111
call application voice queue aa-hunt3 3333
call application voice queue aa-hunt8 8888

If a phone user presses 0 or 8, their call be sent to pilot number 3333.
For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.
Examples The following example associates three menu numbers with three pilot numbers of three ephone hunt
groups. Pilot number 1111 is for ephone hunt group 1 (sales); 2222 is for ephone hunt group 2 (customer
service); and 3333 is for ephone hunt group 3 (operator). If sales is selected from the AA menu, the call
will be transferred to 1111 and sent to ephone hunt group 1’s available ephone-dns (2001, 2002, 2003,
2004, 2005, 2006).
Router(config)# ephone-hunt 1 peer
Router(config-ephone-hunt)# pilot 1111
Router(config-ephone-hunt)# list 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009,
1010
Router(config)# ephone-hunt 2 peer
Router(config-ephone-hunt)# pilot 2222
Router(config-ephone-hunt)# list 2001, 2002, 2003, 2004, 2005, 2006
Router(config)# ephone-hunt 3 peer
Router(config-ephone-hunt)# pilot 3333
Router(config-ephone-hunt)# list 3001, 3002, 3003, 3004
Router(config)# call application voice queue flash:app-b-acd-x.x.x.x.tcl
Router(config)# call application voice queue aa-hunt1 1111
Router(config)# call application voice queue aa-hunt2 2222
Router(config)# call application voice queue aa-hunt3 3333

Related Commands Command Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
call application voice
aa-pilot
Associates an ephone hunt group with the Cisco CME basic service’s AA
script by declaring the group’s pilot number.
call application voice
welcome-prompt
Assigns an audio file that is used by a Cisco CME B-ACD AA script for the
welcome greeting.
ephone-dn Enters ephone-dn configuration mode for the purposes of creating and
configuring an extension for a Cisco IP phone line.
ephone-hunt Enters ephone-hunt configuration mode for the purposes of creating and
configuring a hunt group for use in a Cisco CME system.
pilot Defines the ephone-dn that callers dial to reach a Cisco CME ephone hunt
group.
Cisco Unified CME Commands: C
call application voice aa-name
114
Cisco Unified CME Command Reference
OL-10894-01
call application voice aa-name
Effective with Cisco IOS Release 12.3(14)T and later, the call application voice aa-name command is
not available in Cisco IOS software.
To associate the queue script for Cisco Unified CME basic automatic call distribution (B-ACD) with the
Cisco Unified CME B-ACD auto-attendant (AA) script, use the call application voice aa-name
command in global configuration mode. To remove the queue script and AA script association, use the
no form of this command.
call application voice application-name aa-name aa-script-name
no call application voice application-name aa-name aa-script-name
Syntax Description
Command Default No call queue script and AA script association is configured.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier
than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD call queue scripts.
Only one AA script can be associated with one call queue script.
For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.
Examples The following example associates a call queue script with an AA script:
Router(config)# call application voice aa flash:app-b-acd-aa-x.x.x.x.tcl
Router(config)# call application voice queue flash:app-b-acd-x.x.x.x.tcl
Router(config)# call application voice queue aa-name aa

application-name Application name given to the call queue script in the call application voice
command.
aa-script-name Application name given to the AA script in the call application voice
command.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced with the param
aa-name command.
Cisco Unified CME Commands: C
call application voice aa-name
115
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
call application voice
service-name
Associates a Cisco CME B-ACD AA script with a Cisco Unified CME
B-ACD call queue script.
Cisco Unified CME Commands: C
call application voice aa-pilot
116
Cisco Unified CME Command Reference
OL-10894-01
call application voice aa-pilot
Effective with Cisco IOS Release 12.3(14)T and later, the call application voice aa-pilot command is
replaced by the param aa-pilot command. See the param aa-pilot command for more information.
To assign a pilot number to the Cisco Unified CME basic automatic call distribution (B-ACD) service,
use the call application voice aa-pilot command in global configuration mode. To remove the
Cisco Unified CME B-ACD pilot number, use the no form of this command.
call application voice application-name aa-pilot pilot-number
no call application voice application-name aa-pilot pilot-number
Syntax Description
Command Default No Cisco Unified CME B-ACD pilot number is configured.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco CME B-ACD script that is earlier than
2.1.0.0 and is valid only for the configuration of Cisco CME B-ACD AA scripts. Only one pilot number
can be used for each Cisco Unified CME B-ACD service, and the voice ports handling AA must have
dial peers that will send calls to the pilot number.
For any configuration changes to take effect, you must reload the Cisco Unified CME B-ACD scripts.
application-name Application name given to the auto-attendant (AA) script in the call
application voice command.
pilot-number Pilot number for Cisco CME B-ACD.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
aa-pilot command.
Cisco Unified CME Commands: C
call application voice aa-pilot
117
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example assigns 8005550100 as the pilot number to the Cisco Unified CME B-ACD
service. Included in this example is the dial-peer configuration for the pilot number.
Router(config)# call application voice aa flash:app-b-acd-aa-x.x.x.x.tcl
Router(config)# call application voice aa aa-pilot 8005550100
Router(config)# dial-peer voice 1000 pots
Router(config)# incoming pilot number 8005550100
Router(config)# application aa
Router(config)# direct-inward-dial
Router(config)# port 1/0:23
Router(config)# forward digits-all
Router(config)# call application voice aa aa-pilot 80055501

Related Commands Command Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
dial-peer voice Defines a particular dial peer, specifies the method of voice encapsulation,
and enters dial-peer configuration mode.
ephone-dn Enters ephone-dn configuration mode for the purposes of creating and
configuring an extension for a Cisco IP phone line.
ephone-hunt Enters ephone-hunt configuration mode for the purposes of creating and
configuring a hunt group for use in a Cisco Unified CME system.
Cisco Unified CME Commands: C
call application voice call-retry-timer
118
Cisco Unified CME Command Reference
OL-10894-01
call application voice call-retry-timer
Effective with Cisco IOS Release 12.3(14)T and later, the call application call-retry-timer command
is replaced by the param call-retry-timer command. See the param call-retry-timer command for
more information.
To assign the length of time that calls to Cisco Unified CME basic automatic call distribution (B-ACD)
must wait before attempting to transfer to an ephone hunt group pilot number, use the call application
voice call-retry-timer command in global configuration mode. To remove the retry time, use the no
form of this command.
call application voice application-name call-retry-timer seconds
no call application voice application-name call-retry-timer seconds
Syntax Description
Command Default The retry interval is 15 seconds.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco CME B-ACD script that is earlier than
2.1.0.0 and is valid only for the configuration of Cisco CME B-ACD AA scripts. The following sequence
of events might occur:
• An outside call comes into a system configured with Cisco CME B-ACD.
• A menu option is selected that attempts to transfer the call to an ephone hunt group pilot number.
• All of the ephone hunt group’s ephone-dns are busy.
In that case, the call will wait in a queue for the period of time set by the call application voice
call-retry-timer command and retry to the pilot number.
For any configuration changes to take effect, you must reload the Cisco Unified CME B-ACD scripts.
application-name Application name given to the auto-attendant (AA) script in the call
application voice command.
seconds Number of seconds that a call must wait before attempting to transfer an
ephone hunt pilot number or voice-mail pilot number. The range is from 5 to
30 seconds. The default is 15 seconds.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
call-retry-timer command
Cisco Unified CME Commands: C
call application voice call-retry-timer
119
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows a configuration that allows outside calls to Cisco CME B-ACD to retry an
ephone hunt group pilot number every 30 seconds. The example shows the configuration for one ephone
hunt group, which is presented by Cisco CME B-ACD menu as the sales department and uses a simple
configuration. If a caller selects the sales menu option (ephone-hunt 1) and all of the ephone-dns
configured in the list command (1001, 1002, 1003, 1004) are busy, the call will wait 30 seconds and then
retry the pilot number (1111) until either an ephone-dn becomes available or a configured amount of time
has elapsed (see the call application voice max-time-call-retry command).
Router(config)# ephone-hunt 1 peer
Router(config-ephone-hunt)# pilot 1111
Router(config-ephone-hunt)# list 1001, 1002, 1003, 1004
Router(config)# call application voice aa flash:app-b-acd-aa-x.x.x.x.tcl
Router(config)# call application voice aa call-retry-timer 30

Related Commands Command Description
ephone-dn Enters ephone-dn configuration mode for the purposes of creating and
configuring an extension for a Cisco IP phone line.
ephone-hunt Enters ephone-hunt configuration mode for the purposes of creating and
configuring a hunt group for use in a Cisco Unified CME system.
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
call application voice
aa-hunt
Declares a Cisco Unified CME B-ACD menu number and associates it with
the pilot number of an ephone hunt group.
call application voice
aa-pilot
Associates an ephone hunt group with the Cisco Unified CME basic
service’s AA script by declaring the group’s pilot number
call application voice
max-time-call-retry
Assigns the maximum length of time for which calls to Cisco Unified CME
B-ACD can stay in a call queue.
Cisco Unified CME Commands: C
call application voice dial-by-extension-option
120
Cisco Unified CME Command Reference
OL-10894-01
call application voice dial-by-extension-option
Effective with Cisco IOS Release 12.3(14)T and later, the call application dial-by-extension-option
command is replaced by the param dial-by-extension-option command. See the param
dial-by-extension-option command for more information.
To enable direct extension access and set the access number for Cisco Unified CME basic automatic call
distribution (B-ACD), use the call application voice dial-by-extension-option command in global
configuration mode. To disable direct dial extension access and remove the access number, use the no
form of this command.
call application voice application-name dial-by-extension number
no call application voice application-name dial-by-extension number
Syntax Description
Command Default Direct dial access is disabled. No access number is configured.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier
than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. It enables
the en_bacd_enter_dest.au audio file. The default announcement says, “Please enter the extension
number you want to reach.” The call application voice dial-by-extension-option command also allows
for the configuration of the number that callers must press before they can enter the extension number
that they want to call.
Callers who select the extension access option can then dial any extension. If they dial an ephone hunt
group ephone-dn or pilot number, their call will not be sent to the ephone hunt-group call queue.
application-name Application name given to the auto-attendant (AA) script in the call
application voice command.
number The single digit that callers press to be able to enter an extension number
from the AA menu. The range is from 1 to 10. There is no default.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
dial-by-extension-option command.
Cisco Unified CME Commands: C
call application voice dial-by-extension-option
121
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example configures Cisco CME B-ACD to include an option that allows callers to press
the number 4 so they can dial an extension number.
Router(config)# call application voice aa flash:app-b-acd-aa-x.x.x.x.tcl
Router(config)# call application voice aa dial-by-extension 4
Related Commands Command Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
Cisco Unified CME Commands: C
call application voice drop-through-option
122
Cisco Unified CME Command Reference
OL-10894-01
call application voice drop-through-option
Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call
Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases,
the call application voice drop-through-option command has been replaced by the param
drop-through-option command.
Cisco Unified CME Commands: C
call application voice drop-through-prompt
123
Cisco Unified CME Command Reference
OL-10894-01
call application voice drop-through-prompt
Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call
Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases,
the call application voice drop-through-prompt command has been replaced by the param
drop-through-prompt command.
Cisco Unified CME Commands: C
call application voice handoff-string
124
Cisco Unified CME Command Reference
OL-10894-01
call application voice handoff-string
Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call
Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases,
the call application voice handoff-string command has been replaced by the param handoff-string
command.
Cisco Unified CME Commands: C
call application voice max-extension-length
125
Cisco Unified CME Command Reference
OL-10894-01
call application voice max-extension-length
Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call
Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases,
the call application voice max-extension-length command has been replaced by the param
max-extension-length command.
Cisco Unified CME Commands: C
call application voice max-time-call-retry
126
Cisco Unified CME Command Reference
OL-10894-01
call application voice max-time-call-retry
Effective with Cisco IOS Release 12.3(14)T and later, the call application voice max-time-call-retry
command is replaced by the param max-time-call-retry command. See the param
max-time-call-retry command for more information.
To assign the maximum length of time for which calls to Cisco Unified CME basic automatic call
distribution (B-ACD) can stay in a call queue, use the call application voice max-time-call-retry
command in global configuration mode. To remove the maximum length of time, use the no form of this
command.
call application voice application-name max-time-call-retry seconds
no call application voice application-name max-time-call-retry seconds
Syntax Description
Command Default The default maximum length of time that calls can stay in a call queue is 600 seconds.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier
than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. The call
application voice max-time-retry command allows you set a time limit for the redialing of pilot
numbers under the following circumstances:
• An outside call comes into a system configured with Cisco Unified CME B-ACD.
• A menu option is selected that transfers the call to an ephone hunt-group pilot number.
• All of the ephone hunt group’s ephone-dns are busy.
• The call is sent to a queue and tries the pilot number at intervals of time set by the call application
voice call-retry-timer command.
application-name Application name given to the auto attendant (AA) script in the call
application voice command.
seconds Maximum length of time that the Cisco Unified CME B-ACD AA script can
keep redialing an ephone hunt group pilot number. The range is from 0 to
3600 seconds. The default is 600 seconds.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
max-time-call-retry command.
Cisco Unified CME Commands: C
call application voice max-time-call-retry
127
Cisco Unified CME Command Reference
OL-10894-01
When the time period set by the call application voice max-call-retry command expires, one of the
following two events will occur:
• If a voice-mail pilot number has been configured in Cisco Unified CME and mail boxes for hunt
group pilot numbers have been configured in a voice-mail application, calls will be transferred to
voice mail.
• If voice mail has not been configured, a default message will be played that says, “We are unable to
take your call at this time. Please try again at a later time. Thank you for calling.”
Examples In the following example, the length of time for which calls can try to reach ephone hunt group 1 and
ephone hunt group 2 is 90 seconds. If a caller selects the AA menu option for either hunt group and all
of its ephone-dns configured in the list command are busy, the call will keep retrying the ephone hunt
group’s pilot number until one of the ephone-dns is available or 90 seconds has elapsed. When 90
seconds elapses, the call will go to voice mail.
Router(config)# ephone-hunt 1 peer
Router(config-ephone-hunt)# pilot 1111
Router(config-ephone-hunt)# list 1001, 1002, 1003, 1004
Router(config)# ephone-hunt 2peer
Router(config-ephone-hunt)# pilot 2222
Router(config-ephone-hunt)# list 2001, 2002, 2003, 2004
Router(config)# call application voice aa flash:app-b-acd-aa-x.x.x.x.tcl
Router(config)# call application voice aa max-call-retry-timer 90
Related Commands Command Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
call application voice
call-retry-timer
Assigns the length of time that calls to Cisco Unified CME B-ACD must
wait before attempting to transfer to an ephone hunt-group pilot number or
to voice mail.
call application voice
max-time-vm-retry
Assigns the maximum number of times that calls to Cisco Unified CME
B-ACD can attempt to reach voice mail.
ephone-dn Enters ephone-dn configuration mode for the purposes of creating and
configuring an extension for a Cisco IP phone line.
ephone-hunt Enters ephone-hunt configuration mode for the purposes of creating and
configuring a hunt group for use in a Cisco Unified CME system.
Cisco Unified CME Commands: C
call application voice max-time-vm-retry
128
Cisco Unified CME Command Reference
OL-10894-01
call application voice max-time-vm-retry
Cisco IOS Release 12.3(14)T and later releases support Cisco Unified CME Basic Automatic Call
Distribution (B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases,
the call application voice max-time-vm-retry command has been replaced by the param
max-time-vm-retry command.
Cisco Unified CME Commands: C
call application voice number-of-hunt-grps
129
Cisco Unified CME Command Reference
OL-10894-01
call application voice number-of-hunt-grps
Effective with Cisco IOS Release 12.3(14)T and later, the call application voice number-of-hunt-grps
command is replaced by the param number-of-hunt-grps command. See the param
number-of-hunt-grps command for more information.
To declare the maximum number of ephone hunt-group menus supported by Cisco Unified CME basic
automatic call distribution (B-ACD), use the call application voice number-of-hunt-grps command in
global configuration mode. To remove the maximum number of ephone hunt-group menus supported by
Cisco CME B-ACD, use the no form of this command.
call application voice application-name number-of-hunt-grps number
no call application voice application-name number-of-hunt-grps number
Syntax Description
Command Default Three ephone hunt-group menus are supported by Cisco CME B-ACD.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier
than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. The
number argument declares the number of ephone hunt groups only. The menu option for direct extension
access (see the call application voice dial-by-extension-option command) is not included.
Examples The following example configures a Cisco Unified CME B-ACD call queue script to use three ephone
hunt groups and one direct extension access number, making the number argument in the call
application voice number-of-hunt-grps equal to 3. The ephone-hunt command is used to configure
the three ephone hunt groups. The call application voice dial-by-extension-option command is used to
enable direct extension access and set the access number to 1.
Router(config)# ephone-hunt 1 peer
Router(config-ephone-hunt)# pilot 1111
application-name Application name given to the auto-attendant (AA) script in the call
application voice command.
number Number of hunt groups used by the Cisco Unified CME B-ACD AA script
and call queue script. The range is from 1 to 3. The default is 3.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
number-of-hunt-grps command.
Cisco Unified CME Commands: C
call application voice number-of-hunt-grps
130
Cisco Unified CME Command Reference
OL-10894-01
Router(config-ephone-hunt)# list 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009,
1010
Router(config)# ephone-hunt 2 peer
Router(config-ephone-hunt)# pilot 2222
Router(config-ephone-hunt)# list 2001, 2002, 2003, 2004, 2005, 2006
Router(config-ephone-hunt)# final 9000
Router(config)# ephone-hunt 3 peer
Router(config-ephone-hunt)# pilot 3333
Router(config-ephone-hunt)# list 3001, 3002, 3003, 3004
Router(config)# call application voice aa flash:app-b-acd-aa-x.x.x.x.tcl
Router(config)# call application voice aa dial-by-extension 1
Router(config)# call application voice aa number-of-hunt-grps 3
Related Commands Command Description
call application voice Defines a name for a voice application and specifies the location of the
Tcl or VoiceXML document to load for this application.
call application voice
dial-by-extension-option
Enables direct extension access and sets the access number for
Cisco CME B-ACD.
ephone-hunt Enters ephone-hunt configuration mode for the purposes of creating and
configuring a hunt group for use in a Cisco CME system.
Cisco Unified CME Commands: C
call application voice queue-len
131
Cisco Unified CME Command Reference
OL-10894-01
call application voice queue-len
Effective with Cisco IOS Release 12.3(14)T and later, the call application queue-len command is
replaced by the param queue-len command. See the param queue-len command for more information.
To set the maximum number of calls allowed for each ephone hunt group’s call queue that is used by
Cisco Unified CME basic automatic call distribution (B-ACD), use the call application voice queue-len
command in global configuration mode. To remove the queue-length setting, use the no form of this
command.
call application voice application-name queue-len number
no call application voice application-name queue-len number
Command Default
Command Default Thirty calls are allowed in each call queue.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with a version of the Cisco Unified CME B-ACD script that is earlier than
2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD call queue scripts. The
following sequence of events might occur:
• An outside call comes into a system configured with Cisco Unified CME B-ACD.
• A menu option is selected that transfers the call to an ephone hunt-group pilot number.
• All of the ephone hunt group’s ephone-dns are busy.
In that case, the call will be sent to a queue for that individual hunt group. The number of calls that each
ephone hunt group can hold in its queue is configured by the call application voice queue-len
command.
application-name Application name given to the call queue script in the call application voice
command.
number Number of calls that can be waiting in each ephone hunt group’s queue. The
range is dependent on your hardware configuration. The range is from 1 to
30. The default is 10.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
queue-len command.
Cisco Unified CME Commands: C
call application voice queue-len
132
Cisco Unified CME Command Reference
OL-10894-01
In the following configuration example, ephone hunt group 1 supports two ephone-dns; ephone hunt
group 2 supports three ephone-dns; and the queue length is 10 for both ephone hunt groups:
ephone-hunt 1 peer
pilot 1111
list 1001, 1002
ephone-hunt 2 peer
pilot 2222
list 2001, 2002, 2003
call application voice queue flash:app-b-acd-x.x.x.x.tcl
call application voice callqueuescriptfilename queue-len 10
If ephone hunt group 1’s ephone-dns are busy, ten more calls can be made to ephone hunt group 1. During
that time, the calls in the queue would periodically retry the pilot numbers (call application voice
max-time-retry-timer command) and receive secondary greetings (call application voice
second-greeting-time command). If none of the calls has hung up or connected to an ephone-dn, the
eleventh caller would hear the en_bacd_disconnect.au message and a busy signal. The default message
is, “We are unable to take your call at this time. Please try again at a later time. Thank you for calling.”
Includes a four-second pause after the message.
For ephone hunt group 2, three calls can be connected to ephone-dns 2001, 2002, and 2003, and ten calls
can be waiting in ephone hunt group 2’s queue. If the status remains unchanged, the fourteenth caller
hears the disconnect message and a busy signal. But if one of the earlier calls disconnects (either by
leaving the queue or by ending a call), the fourteen call enters the queue.
The maximum number of calls allowed in the queues of ephone hunt groups must be based on the number
of ports or trunks available. For example, if you had 20 foreign exchange office (FXO) ports and two
ephone hunt groups, you could configure a maximum of ten calls per ephone hunt-group queue with the
call application voice queue-len 10 command. You could use the same configuration if you had a single
T1 trunk, which supports 23 channels.
Examples The following example configures a Cisco Unified CME B-ACD call queue script to allow a maximum
of 12 calls to wait in each ephone hunt group’s calling queue for ephone-dns to become available:
Router(config)# call application voice queue flash:app-b-acd-x.x.x.x.tcl
Router(config)# call application voice queue queue-len 12

Related Commands Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
call application voice
call-retry-timer
Assigns the length of time that calls to Cisco CME B-ACD must wait before
attempting to transfer to an ephone hunt-group pilot number or to voice mail.
ephone-dn Enters ephone-dn configuration mode for the purposes of creating and
configuring an extension for a Cisco IP phone line.
ephone-hunt Enters ephone-hunt configuration mode for the purposes of creating and
configuring a hunt group for use in a Cisco CME system.
Cisco Unified CME Commands: C
call application voice queue-manager-debugs
133
Cisco Unified CME Command Reference
OL-10894-01
call application voice queue-manager-debugs
Effective with Cisco IOS Release 12.3(14)T and later, the call application queue-manager-debugs
command is replaced by the param queue-manager-debugs command. See the param aa-hunt
command for more information.
To enable or disable the collection of call queue debug information from Cisco CallManager Express
(Cisco CME) basic automatic call distribution (B-ACD), use the call application voice
queue-manager-debugs command in global configuration mode. To remove the current setting, use the
no form of this command with the keyword that was used in the previous occurrence of the call
application voice queue-manager-debugs command.
call application voice application-name queue-manager-debugs [0 | 1]
no call application voice application-name queue-manager-debugs [0 | 1]
Syntax Description
Command Default The collection of call queue debug information from Cisco CME B-ACD is disabled.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco CME B-ACD script that is earlier than
2.1.0.0 and is valid only for the configuration of Cisco CME B-ACD call queue scripts. It enables the
collection of data regarding call queue activity. It is used in conjunction with the debug voip ivr script
command. Both commands must be enabled at the same time.
For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.
application-name Application name given to the call queue script in the call application voice
command.
0 Disables debugging.
1 Enables debugging.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
queue-manager-debugs command.
Cisco Unified CME Commands: C
call application voice queue-manager-debugs
134
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example configures a Cisco CME B-ACD call queue script to enable debugging for the
collection of data for the debug voip ivr script command:
Router(config)# call application voice queue flash:app-b-acd-x.x.x.x.tcl
Router(config)# call application voice queue queue-manager-debugs 1

Related Commands Command Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
debug voip ivr script Display debugging messages for IVR scripts.
Cisco Unified CME Commands: C
call application voice second-greeting-time
135
Cisco Unified CME Command Reference
OL-10894-01
call application voice second-greeting-time
Effective with Cisco IOS Release 12.3(14)T and later, the call application voice second-greeting-time
command is replaced by the param second-greeting-time command. See the param
second-greeting-time command for more information.
To set the delay before the second greeting is played after a caller joins a Cisco Unified CME basic
automatic call distribution (B-ACD) calling queue and set the interval of time at which the
second-greeting message is repeated, use the call application voice second-greeting-time command in
global configuration mode. To remove the second-greeting time, use the no form of this command.
call application voice application-name second-greeting-time seconds
no call application voice application-name second-greeting-time seconds
Syntax Description
Command Default The second-greeting delay time is 60 seconds.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier
than 2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. A second
greeting is an audio message of up to 15 seconds in length. The default announcement is, “All agents are
currently busy assisting other customers. Continue to hold for assistance. Someone will be with you
shortly.” The second-greeting message is only presented to callers waiting in a CME B-ACD call queue.
The second-greeting time is clocked when the second-greeting message begins, not after it ends. For
example, if the second greeting were 15 seconds in length and the configured second-greeting time were
70 seconds, the greeting would begin every 70 seconds, not 85 seconds as if to allow for the 15-second
message.
For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.
application-name Application name given to the auto-attendant (AA) script in the call
application voice command.
seconds Amount of time that second-greeting message must wait before it can be
played. The range is from 30 to 120 seconds. The default is 60 seconds.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
second-greeting-time command.
Cisco Unified CME Commands: C
call application voice second-greeting-time
136
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example configures a Cisco Unified CME B-ACD AA script to allow a second-greeting
message to be repeated every 50 seconds as long as a call is in a call queue.
Router(config)# call application voice aa flash:app-b-acd-aa-x.x.x.x.tcl
Router(config)# call application voice AAscriptfilename second-greeting-time 50
Related Commands Command Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
ephone-dn Enters ephone-dn configuration mode for the purposes of creating and
configuring an extension for a Cisco IP phone line.
ephone-hunt Enters ephone-hunt configuration mode for the purposes of creating and
configuring a hunt group for use in a Cisco CME system.
Cisco Unified CME Commands: C
call application voice service-name
137
Cisco Unified CME Command Reference
OL-10894-01
call application voice service-name
Cisco IOS Release 12.3(14)T and later releases support Cisco CME Basic Automatic Call Distribution
(B-ACD) and Auto-Attendant (AA) Tcl scripts version 2.1.0.0 and greater. In these releases, the call
application voice service-name command has been replaced by the param service-name command.
Cisco Unified CME Commands: C
call application voice voice-mail
138
Cisco Unified CME Command Reference
OL-10894-01
call application voice voice-mail
Effective with Cisco IOS Release 12.3(14)T and later, the call application voice voice-mail command
is replaced by the param voice-mail command. See the param voice-mail command for more
information.
To assign a pilot number for the Cisco Unified CME basic automatic call distribution (B-ACD) service’s
voice mail, use the call application voice voice-mail command in global configuration mode. To remove
the voice-mail pilot number, use the no form of the command.
call application voice application-name voice-mail number
no call application voice application-name voice-mail number
Syntax Description
Command Default No voice-mail pilot number is configured for Cisco Unified CME B-ACD.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with a version of the Cisco Unified CME B-ACD script that is earlier than
2.1.0.0 and is valid only for the configuration of Cisco Unified CME B-ACD AA scripts. Only one pilot
number is allowed per Cisco CME B-ACD service. Calls to the service will be sent to this voice mail
number.
For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.
application-name Application name given to the auto attendant (AA) script using the call
application voice command.
number Pilot number of the voice mail to which calls to Cisco CME B-ACD will be
transferred.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
voice-mail command.
Cisco Unified CME Commands: C
call application voice voice-mail
139
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example configures a Cisco Unified CME B-ACD voice-mail pilot number as 5000.
Router(config)# call application voice aa flash:app-b-acd-aa-x.x.x.x.tcl
Router(config)# call application voice aa voice-mail 5000

Related Commands Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
Cisco Unified CME Commands: C
call application voice welcome-prompt
140
Cisco Unified CME Command Reference
OL-10894-01
call application voice welcome-prompt
Effective with Cisco IOS Release 12.3(14)T and later, the call application voice welcome-prompt
command is replaced by the param welcome-prompt command. See the param welcome-prompt
command for more information.
To assign an audio file that is used by the Cisco Unified CME basic automatic call distribution (B-ACD)
auto-attendant (AA) script for the welcome greeting, use the call application welcome-prompt
command in global configuration mode. To remove the audio file assignment, use the no form of this
command.
call application voice application-name welcome-prompt _audio-filename
no call application voice application-name welcome-prompt _audio-filename
Syntax Description
Command Default The welcome audio file downloaded with Cisco Unified CME B-ACD is used for the welcome prompt.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used only with with a version of the Cisco Unified CME B-ACD script that is earlier
than 2.1.0.0 and is valid only for the configuration of Cisco CME B-ACD AA scripts. The welcome
greeting is the initial AA response to a caller. The default audio file used is en_bacd_welcome.au, which
is is downloaded with Cisco CME B-ACD and announces, “Thank you for calling,” and includes a
two-second pause after the message.
The filename must be preceded by an underscore (_) character. In addition, it must not contain a
language-code prefix, such as “en” for English. For example, for en_bacd_welcome.au, you must
configure welcome-prompt _bacd_welcome.au instead of welcome-prompt _en_bacd_welcome.au.
For any configuration changes to take effect, you must reload the Cisco CME B-ACD scripts.
application-name Application name given to the AA script in the call application voice
command.
_audio-filename Filename of the welcome greeting to be played when callers first reach the
Cisco Unified CME B-ACD, preceded by the underscore (_) character. The
filename must not have a language code prefix, such as “en,” for English.
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.2.2 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.3(14)T Cisco CME 3.3 This command was replaced by the param
welcome-prompt command.
Cisco Unified CME Commands: C
call application voice welcome-prompt
141
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example sets file name en_welcome.au as the welcome greeting for Cisco Unified CME
B-ACD:
Router(config)# call application voice aa flash:app-b-acd-aa-x.x.x.x.tcl
Router(config)# call application voice aa welcome-prompt _bacd_welcome_2.au
Related Commands Command Description
call application voice Defines a name for a voice application and specifies the location of the Tcl
or VoiceXML document to load for this application.
call application voice
aa-name
Associates a Cisco CME B-ACD call queue script with a
Cisco Unified CME B-ACD AA script
call application voice
service-name
Associates a Cisco CME B-ACD AA script with a Cisco Unified CME
B-ACD call queue script.
Cisco Unified CME Commands: C
callback (voice emergency response settings)
142
Cisco Unified CME Command Reference
OL-10894-01
callback (voice emergency response settings)
To route an E911 callback to another number (for example, the company operator) if the callback cannot
find the last 911 caller associated to the ELIN, use the callback command in voice emergency response
settings configuration mode. This command is optional.
callback number
no callback
Syntax Description
Command Default A callback number is not defined.
Command Modes Voice emergency response settings configuration (cfg-emrgncy-resp-settings)
Command History
Usage Guidelines Use this command to specify the default number to contact if a 911 callback cannot find the last 911
caller associated with an ELIN. If no default callback number is configured, and the expiry time is
exceeded, the 911 operator may hear a reorder tone or be incorrectly routed.
Examples In this example, the ELIN (4085550101) defined in the voice emergency response settings configuration
is used if the 911 caller’s IP phone address does not match any of the voice emergency response
locations. After the 911 call is placed to the PSAP, the PSAP has 120 minutes to call back 408-555-0101
to reach the 911 caller. If the call history has expired (after 120 minutes), any callback is routed to
extension 7500.
voice emergency response settings
callback 7500
elin 4085550101
expiry 120
number Identifier of the E.164 default number to contact if a 911 callback fails.
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.
Cisco Unified CME Commands: C
callback (voice emergency response settings)
143
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
elin E.164 number used as the default ELIN if no matching ERL to the 911
caller’s IP phone address is found.
expiry Number of minutes a 911 call is associated to an ELIN in case of a callback
from the 911 operator.
logging Syslog informational message printed to the console every time an
emergency call is made.
voice emergency
response settings
Creates a tag for identifying settings for E911 behavior.
Cisco Unified CME Commands: C
caller-id
144
Cisco Unified CME Command Reference
OL-10894-01
caller-id
To specify whether to pass the local caller ID or the original caller ID with calls from an extension in
Cisco Unified CME that is using loopback, use the caller-id command in ephone-dn configuration
mode. To return to the default, use the no form of this command.
caller-id {local | passthrough}
no caller-id {local | passthrough}
Syntax Description
Defaults Default is passthrough.
Command Modes Ephone-dn configuration (config-ephone)
Command History
Usage Guidelines This command is valid only for ephone-dns that are being used for loopback.
This command with the local keyword is applied as follows:
• For transferred calls, caller ID is provided by the original caller-ID information source, such as from
a separate loopback-dn that handles inbound calls or from a public switched telephone network
interface.
• For forwarded calls, caller ID is provided by the original caller-ID information source or, for local
IP phones, is extracted from the redirected information associated with the call.
This command with the passthrough keyword is applied as follows:
• For transferred calls, the caller ID is provided by the original caller-ID information that is obtained
from the inbound side of the loopback-dn.
• For forwarded calls, the caller ID is provided by the original caller-ID information of the incoming
call.
local Local caller ID for redirected calls.
passthrough Original caller ID. Default.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ3 Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
Cisco Unified CME Commands: C
caller-id
145
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example selects local caller ID for redirected calls:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5001
Router(config-ephone-dn)# loopback-dn 15 forward 4
Router(config-ephone-dn)# caller-id local
Router(config-ephone-dn)# no huntstop

Related Commands Command Description
loopback-dn Creates a virtual loopback voice port (loopback-dn) to establish a
demarcation point for VoIP voice calls and supplementary services.
Cisco Unified CME Commands: C
caller-id block (ephone-dn and ephone-dn-template)
146
Cisco Unified CME Command Reference
OL-10894-01
caller-id block (ephone-dn and ephone-dn-template)
To specify caller-ID blocking for outbound calls from a specific extension, use the caller-id block
command in ephone-dn or ephone-dn-template configuration mode. To disable caller-ID blocking for
outbound calls, use the no form of this command.
caller-id block
no caller-id block
Syntax Description This command has no arguments or keywords.
Command Default Caller-ID display is not blocked on calls originating from a Cisco Unified IP phone.
Command Modes Ephone-dn configuration
Ephone-dn-template configuration
Command History
Usage Guidelines This command sets caller-ID blocking for outbound calls originating from a specific extension
(ephone-dn). This command requests the far-end gateway device to block the display of the calling party
information for calls received from the ephone-dn that is being configured. This command does not
affect the ephone-dn calling party information display for inbound calls received by the ephone-dn.
If you want caller-ID name or number to be available on local calls but not on external calls, use the clid
strip name command or the clid strip command in dial-peer configuration mode to remove caller-ID
name or number from calls to VoIP. In this case, do not also use the caller-id block command, which
blocks caller-ID information on all calls.
Note This command is not valid for ephone-dns that are being used for loopback.
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
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.4(4)XC Cisco Unified CME 4.0 This command was made available in
ephone-dn-template configuration mode.
12.4(9)T Cisco Unified CME 4.0 This command in ephone-dn-template
configuration mode was integrated into Cisco IOS
Release 12.4(9)T.
Cisco Unified CME Commands: C
caller-id block (ephone-dn and ephone-dn-template)
147
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to set caller-ID blocking for the directory number 5001:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5001
Router(config-ephone-dn)# caller-id block
The following example uses an ephone-dn template to set caller-ID blocking for the directory number
5001:
Router(config)# ephone-dn-template 5
Router(config-ephone-dn-template)# caller-id block
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5001
Router(config-ephone-dn)# ephone-dn-template 5
Related Commands Description
clid strip Prevents display of caller-ID number on calls to VoIP.
clid strip name Prevents display of caller-ID name on calls to VoIP.
ephone-dn-template
(ephone-dn)
Applies ephone-dn template to an ephone dn.
Cisco Unified CME Commands: C
caller-id block (voice register template)
148
Cisco Unified CME Command Reference
OL-10894-01
caller-id block (voice register template)
Note Effective with Cisco IOS Release 12.4(11)XJ, the caller-id block (voice register template) command
is not available in Cisco IOS software.
To enable caller-ID blocking for outbound calls from a specific SIP phone, use the caller-id block
command in voice register template configuration mode. To disable caller-ID blocking, use the no form
of this command.
caller-id block
no caller-id block
Syntax Description This command has no arguments or keywords.
Command Default Caller ID blocking is disabled.
Command Modes Voice register template configuration (config-register-temp)
Command History
Usage Guidelines This command sets caller-ID blocking for outbound calls originating from any SIP phone that uses the
specified template. This command requests the far-end gateway device to block the display of the calling
party information for calls received from the specified SIP phone. This command does not affect the
calling party information displayed for inbound calls received by the SIP phone. To apply a template to
a SIP phone, use the template command in voice register pool configuration mode.
Examples The following example shows how to enable caller-ID blocking in template 1:
Router(config)# voice register template 1
Router(config-register-temp)# caller-id block

Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
12.4(11)XJ Cisco Unified CME 4.1 This command was removed.
12.4(15)T Cisco Unified CME 4.1 This command was removed in Cisco IOS
Release 12.4(15)T.
Cisco Unified CME Commands: C
caller-id block (voice register template)
149
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
anonymous block (voice
register template)
Enables anonymous call blocking in a SIP phone template.
template (voice register
pool)
Applies a template to a SIP phone.
voice register template Enters voice register template configuration mode and defines a template
of common parameters for SIP phones.
Cisco Unified CME Commands: C
caller-id block code (telephony-service)
150
Cisco Unified CME Command Reference
OL-10894-01
caller-id block code (telephony-service)
To set a code for a user to dial to block the display of caller ID on selected outgoing calls from Cisco IP
phones, use the caller-id block code command in telephony-service configuration mode. To remove the
code, use the no form of this command.
caller-id block code code-string
no caller-id block code
Syntax Description
Command Default No caller-ID blocking code is defined.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Once the caller-ID blocking code has been defined using this command, phone users should enter the
caller-ID blocking code before dialing any call on which they want their caller ID not to display.
Examples The following example sets a caller-ID blocking code of *4321:
Router(config)# telephony-service
Router(config-telephony)# caller-id block code *4321

Related Commands
code-string Character string to dial to enable blocking of caller ID display on selected
outgoing calls. The first character must be an asterisk (*) and the remaining
characters must be digits. The string can contain a maximum of 16
characters.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
Command Description
telephony-service Enters telephony-service configuration mode.
Cisco Unified CME Commands: C
call-feature-uri
151
Cisco Unified CME Command Reference
OL-10894-01
call-feature-uri
To specify the uniform resource identifier (URI) for soft keys on SIP phones registered to a
Cisco Unified CME router, use the call-feature-uri command in voice register global configuration
mode. To remove a URI association, use the no form of this command.
call-feature-uri {cfwdall | gpickup | pickup} service-uri
no call-feature-uri cfwdall {cfwdall | gpickup | pickup}
Syntax Description
Command Default No URI is associated with the soft key.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command updates the service URI for soft keys in the configuration file that is downloaded from
the Cisco Unified CME router to the SIP phones during phone registration.
For Call Forward All, this URI and the call forward number is sent to Cisco Unified CME when a user
enables Call Forward All from the phone using the CfwdAll soft key.
After you configure this command, restart the phone by using the reset or restart command.
This command is not supported on the Cisco Unified IP Phone 7905, 7912, 7940, or 7960.
Examples The following example shows how to specify the URI for the call forward all soft key:
Router(config)# voice register global
Router(config-register-global)# call-feature-uri cfwdall http://10.10.10.11/cfwdall
cfwdall Call Forward All (CfwdAll) soft key.
gpickup Group Pickup (GPickUp) soft key.
pickup Local Pickup (PickUp) soft key.
service-uri URI that is requested when the specified soft key is pressed.
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 gpickup and pickup keywords were added.
12.4(24)T Cisco Unified CME 7.1 This command has been integrated into Cisco IOS
Release 12.4(24)T.
Cisco Unified CME Commands: C
call-feature-uri
152
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
call-forward b2bua all Enables call forwarding for a SIP back-to-back user agent (B2BUA) so
that all incoming calls are forwarded to another extension.
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 one phone associated with a
Cisco Unified CME router.
restart (voice register) Performs a fast restart of one or all SIP phones associated with a Cisco
Unified CME router.
service directed-pickup Enables Directed Call Pickup and modifies the function of the PickUp
and GPickUp soft keys.
Cisco Unified CME Commands: C
call-forward
153
Cisco Unified CME Command Reference
OL-10894-01
call-forward
To globally apply dialplan-pattern expansion to redirecting numbers for extension numbers associated
with SCCP IP phones in Cisco Unified CME, use the call-forward system command in
telephony-service configuration mode. To disable the call-forward system command, use the no form
of this command.
call-forward system redirecting-expanded
no call-forward system redirecting-expanded
Syntax Description
Command Default The redirecting number is not expanded.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Use this command to apply dialplan-pattern expansion on a per-system basis to individual nonSIP
redirecting numbers, including original called and last reroute numbers, in a Cisco Unified CME system.
When A calls B, and B forwards the call to C; B is the original called number and the last reroute number.
If C then forwards or transfers the call to another number, C becomes the original called number and the
last reroute number. The dial-plan pattern expansion is applied to both redirecting numbers. Once the
number is expanded, it remains expanded during the entire call instance.
The dial-plan pattern to be matched must be configured using the dialplan-pattern command.
Examples The following example shows how to create a dialplan-pattern for expanding calling numbers to an
E.164 number and to also apply the expansion globally to redirecting numbers.
Router(config)# voice register global
Router(config-register-global)# dialplan-pattern 1 5105550... extension-length 5
Router(config-register-global)# call-forward system redirecting-expanded

system Call forward system parameter.
redirecting-expanded Expand redirecting extensions to an E.164 number.
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.
Cisco Unified CME Commands: C
call-forward
154
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
dialplan-pattern Create global prefix for expanding extension numbers of forward-to and
transfer-to targets.
show
telephony-service
dial-peer
Displays dial peer information for extensions in a Cisco Unified CME
system.
Cisco Unified CME Commands: C
call-forward (voice register)
155
Cisco Unified CME Command Reference
OL-10894-01
call-forward (voice register)
To globally apply dialplan-pattern expansion to redirecting numbers for extension numbers associated
with SIP IP phones in Cisco Unified CME, use the call-forward system command in voice register
global configuration mode. To disable the call-forward system command, use the no form of this
command.
call-forward system redirecting-expanded
no call-forward system redirecting-expanded
Syntax Description
Command Default The redirecting number is not expanded.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines Use this command to apply dialplan-pattern expansion on a per-system basis to individual SIP
redirecting numbers, including original called and last reroute numbers, in Cisco Unified CME.
When A calls B, and B forwards the call to C; B is the original called number and the last reroute number.
If C then forwards or transfers the call to another number, C becomes the original called number and the
last reroute number. The dial-plan pattern expansion is applied to both redirecting numbers. Once the
number is expanded, it remains expanded during the entire call instance.
This command supports call forward using B2BUA only.
The dial-plan pattern to be matched must be configured using the dialplan-pattern command.
Examples The following example shows how to create a dialplan-pattern for expanding calling numbers of SIP
phones to an E.164 number and to also apply the expansion globally to SIP redirecting numbers.
Router(config)# voice register global
Router(config-register-global)# dialplan-pattern 1 5105550... extension-length 5
Router(config-register-global)# call-forward system redirecting-expanded

system Call forward system parameter.
redirecting-expanded Redirecting extension is to be expanded to an E.164 number.
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).
Cisco Unified CME Commands: C
call-forward (voice register)
156
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Description
dialplan-pattern
(voice register)
Create global prefix for expanding extension numbers of forward-to and
transfer-to targets if the target is an extension on a SIP phone.
show voice register
dial-peer
Displays dial peer information for extensions in a Cisco Unified CME
system.
Cisco Unified CME Commands: C
call-forward all
157
Cisco Unified CME Command Reference
OL-10894-01
call-forward all
To configure call forwarding so that all incoming calls to a directory number are forwarded to another
directory number, use the call-forward all command in ephone-dn or ephone-dn-template
configuration mode. To disable call forwarding, use the no form of this command.
call-forward all directory-number
no call-forward all
Syntax Description
Command Default Call forwarding for all calls is not set.
Command Modes Ephone-dn configuration (config-ephone-dn)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines The call forwarding mechanism applies to the individual directory number and cannot be configured for
individual Cisco Unified IP phones.
Note The call-forward all command takes precedence over the call-forward busy and call-forward noan
commands.
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
directory-number Directory number to which calls are forwarded. Represents a fully qualified
E.164 number.
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.4(4)XC Cisco Unified CME 4.0 This command was made available in
ephone-dn-template configuration mode.
12.4(9)T Cisco Unified CME 4.0 This command in ephone-dn-template
configuration mode was integrated into Cisco IOS
Release 12.4(9)T.
Cisco Unified CME Commands: C
call-forward all
158
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to set call forwarding of all calls on directory number 5001 to
directory number 5005. All incoming calls destined for extension 5001 are forwarded to another
Cisco IP phone with the extension number 5005:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5001
Router(config-ephone-dn)# call-forward all 5005

The following example uses an ephone-dn template to forward all calls for extension 5001 to
extension 5005.
Router(config)# ephone-dn-template 3
Router(config-ephone-dn-template)# call-forward all 5005
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5001
Router(config-ephone-dn)# ephone-dn-template 3

Related Commands Command Description
call-forward busy Configures call forwarding to another number when a Cisco Unified IP
phone is busy.
call-forward noan Configures call forwarding to another number when no answer is
received from a Cisco Unified IP phone.
ephone-dn-template
(ephone-dn)
Applies template to ephone-dn.
Cisco Unified CME Commands: C
call-forward b2bua all
159
Cisco Unified CME Command Reference
OL-10894-01
call-forward b2bua all
To enable call forwarding for a Session Initiation Protocol (SIP) back-to-back user agent (B2BUA) so
that all incoming calls are forwarded to another extension, use the call-forward b2bua all command in
voice register dn or voice register pool configuration mode. To disable call forwarding, use the no form
of this command.
call-forward b2bua all directory-number
no call-forward b2bua all
Syntax Description
Command Default Feature is disabled.
Command Modes Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines This command in voice register dn configuration mode applies the call forward mechanism to a
individual SIP extension in Cisco Unified CME or Cisco Unified SIP SRST. This command in voice
register pool configuration mode is for Cisco Unified SIP SRST only and applies to SIP IP phones on
which the extension appears.
If this command is configured in both the voice register dn and voice register pool configuration modes,
the configuration under voice register dn takes precedence.
We recommend that you do not use this command to configure a SIP extension or SIP IP phone that is a
member of a hunt group. If this command is configured for a member of a hunt group, remove the phone
from any hunt group to which it is assigned to avoid forwarding calls to all phones in the hunt group.
The call-forward b2bua all command takes precedence over the call-forward b2bua busy and
call-forward b2bua noan commands.
directory-number Telephone number to which calls are forwarded. Represents a fully
qualified E.164 number. Maximum length of the telephone number is 32.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
12.4(11)XJ Cisco Unified CME 4.1 This command was removed from voice register
pool configuration mode for Cisco Unified CME
only.
12.4(15)T Cisco Unified CME 4.1 Command with modifications was integrated into
Cisco IOS release 12.4(15)T.
Cisco Unified CME Commands: C
call-forward b2bua all
160
Cisco Unified CME Command Reference
OL-10894-01
Note This command in voice register dn configuration mode is not commonly used for Cisco Unified SIP
SRST.
Examples Cisco Unified CME and Cisco Unified SIP SRST
The following example shows how to forward all incoming calls to extension 5001 on directory
number 4, to extension 5005.
Router(config)# voice register dn 4
Router(config-register-dn)# number 5001
Router(config-register-dn)# call-forward b2bua all 5005

Cisco Unified SIP SRST
The following example shows how to forward all incoming calls for extension 5001 on pool number 4,
to extension 5005.
Router(config)# voice register pool 4
Router(config-register-pool)# number 5001
Router(config-register-pool)# call-forward b2bua all 5005

Related Commands Command Description
call-forward b2bua
busy
Enables call forwarding for a SIP B2BUA so that incoming calls to a busy
extension are forwarded to another extension.
call-forward b2bua
mailbox
Controls the specific voice-mail box selected in a voice-mail system at the
end of a call forwarding exchange.
call-forward b2bua
noan
Enables call forwarding for a SIP B2BUA so that incoming calls to an
extension that does not answer after a configured amount of time are
forwarded to another extension.
call-waiting (voice
register pool)
Enables call waiting on a SIP phone.
Cisco Unified CME Commands: C
call-forward b2bua busy
161
Cisco Unified CME Command Reference
OL-10894-01
call-forward b2bua busy
To enable call forwarding for a Session Initiation Protocol (SIP) back-to-back user agent (B2BUA) so
that incoming calls to a busy extension are forwarded to another extension, use the call-forward b2bua
busy command in voice register dn or voice register pool configuration mode. To disable call
forwarding, use the no form of this command.
call-forward b2bua busy directory-number
no call-forward b2bua busy
Syntax Description
Command Default Feature is disabled.
Command Modes Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines This command in voice register dn configuration mode applies the call forward mechanism to a
individual SIP extension in Cisco Unified CME or Cisco Unified SIP SRST that is off-hook. This
command in voice register pool configuration mode is for Cisco Unified SIP SRST only and applies to
SIP IP phones on which the extension appears.
In Cisco Unified CME, call forward busy is also invoked when a call arrives for a destination that is
configured but unregistered. A destination is considered to be configured if its number is listed under the
voice register dn configuration.
If this command is configured in both voice register dn and voice register pool configuration modes, the
configuration under voice register dn takes precedence.
We recommend that you do not use this command to configure a SIP extension or SIP IP phone that is a
member of a hunt group. If this command is configured for a member of a hunt group, remove the phone
from any hunt group to which it is assigned to avoid forwarding calls to all phones in the hunt group.
The call-forward b2bua all command takes precedence over the call-forward b2bua busy and
call-forward b2bua noan commands.
directory-number Telephone number to which calls are forwarded. Represents a fully
qualified E.164 number. Maximum length of the telephone number is 32.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
12.4(11)XJ Cisco Unified CME 4.1 This command was removed from voice register
pool configuration mode for Cisco Unified CME
only.
12.4(15)T Cisco Unified CME 4.1 This command with modifications was integrated
into Cisco IOS Release 12.4(15)T.
Cisco Unified CME Commands: C
call-forward b2bua busy
162
Cisco Unified CME Command Reference
OL-10894-01
Note This command in voice register dn configuration mode is not commonly used for Cisco Unified SIP
SRST.
Examples Cisco Unified CME and Cisco Unified SIP SRST
The following example shows how to forward all incoming calls to extension 5001 on directory
number 4 to extension 5005 when extension 5001 is busy.
Router(config)# voice register dn 4
Router(config-register-dn)# number 5001
Router(config-register-dn)# call-forward b2bua busy 5005

Cisco Unified SIP SRST
The following example shows how to forward calls from extension 5001 in pool 4 to extension 5005
when extension 5001 is busy.
Router(config)# voice register pool 4
Router(config-register-pool)# number 5001
Router(config-register-pool)# call-forward b2bua busy 5005

Related Commands Command Description
call-forward b2bua all Enables call forwarding for a SIP B2BUA so that all incoming calls are
forwarded to another extension.
call-forward b2bua
mailbox
Controls the specific voice-mail box selected in a voice-mail system at
the end of a call forwarding exchange.
call-forward b2bua noan Enables call forwarding for a SIP B2BUA so that incoming calls to an
extension that does not answer after a configured amount of time are
forwarded to another extension.
call-waiting (voice register
pool)
Enables call waiting on a SIP phone.
Cisco Unified CME Commands: C
call-forward b2bua mailbox
163
Cisco Unified CME Command Reference
OL-10894-01
call-forward b2bua mailbox
To control the specific voice-mail box selected in a voice-mail system at the end of a call forwarding
exchange, use the call-forward b2bua mailbox command in voice register dn or voice register pool
configuration mode. To disable call forwarding, use the no form of this command.
call-forward b2bua mailbox directory-number
no call-forward b2bua mailbox
Syntax Description
Command Default Feature is disabled.
Command Modes Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines This command is used to denote the voice-mail box to use at the end of a chain of call forwards to busy
or no answer destinations. It can be used to forward calls to a voice-mail box that has a different number
than the forwarding extension, such as a shared voice-mail box.
This command in voice register dn configuration mode applies the call forward mechanism to a
individual SIP extension in Cisco Unified CME or Cisco Unified SIP SRST. This command in voice
register pool configuration mode is for Cisco Unified SIP SRST only and applies to SIP IP phones on
which the extension appears.
If this command is configured in both the voice register dn and voice register pool configuration modes,
the configuration under voice register dn takes precedence.
We recommend that you do not use this command to configure a SIP extension or SIP IP phone that is a
member of a hunt group. If this command is configured for a member of a hunt group, remove the phone
from any hunt group to which it is assigned to avoid forwarding calls to all phones in the hunt group.
This command is used in conjunction with the call-forward b2bua all, call-forward b2bua busy, and
call-forward b2bua noan commands.
directory-number Telephone number to which calls are forwarded when the forwarded
destination is busy or does not answer. Represents a fully qualified E.164
number. Maximum length of the telephone number is 32.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
12.4(11)XJ Cisco Unified CME 4.1 This command was removed from voice register
pool configuration mode for Cisco Unified CME
only.
12.4(15)T Cisco Unified CME 4.1 This command with modifications was integrated
into Cisco IOS Release 12.4(15)T
Cisco Unified CME Commands: C
call-forward b2bua mailbox
164
Cisco Unified CME Command Reference
OL-10894-01
Note This command in voice register dn configuration mode is not commonly used for Cisco Unified SIP
SRST.
Examples Cisco Unified CME and Cisco Unified SIP SRST
The following example shows how to forward all incoming calls to extension 5005 if an incoming call
is forwarded to extension 5001, and extension 5001 is busy or does not answer.
Router(config)# voice register dn 4
Router(config-register-dn)# number 5001
Router(config-register-dn)# call-forward b2bua mailbox 5005

Cisco Unified SIP SRST
The following example shows how to forward calls to extension 5005 if an incoming call is forwarded
to extension 5001 on pool number 4, and extension 5001 is busy or does not answer.
Router(config)# voice register pool 4
Router(config-register-pool)# number 5001
Router(config-register-pool)# call-forward b2bua mailbox 5005

Related Commands Command Description
call-forward b2bua all Enables call forwarding for a SIP B2BUA so that all incoming calls are
forwarded to another extension.
call-forward b2bua busy Enables call forwarding for a SIP B2BUA so that incoming calls to a
busy extension are forwarded to another extension.
call-forward b2bua noan Enables call forwarding for a SIP B2BUA so that incoming calls to an
extension that does not answer after a configured amount of time are
forwarded to another extension.
call-forward b2bua
unreachable
Enables call forwarding for a SIP B2BUA so that incoming calls to an
extension that is not registered in Cisco Unified CME are forwarded to
another extension.
call-waiting (voice register
pool)
Enables call waiting on a SIP phone.
number (voice register dn) Associates an extension number with a voice register dn.
voice register dn Enters voice register dn configuration mode to define an extension for a
SIP phone line.
voice register pool Enters voice register pool configuration mode for SIP phones.
Cisco Unified CME Commands: C
call-forward b2bua noan
165
Cisco Unified CME Command Reference
OL-10894-01
call-forward b2bua noan
To enable call forwarding for a Session Initiation Protocol (SIP) back-to-back user agent (B2BUA) so
that incoming calls to an extension that does not answer after a configured amount of time are forwarded
to another extension, use the call-forward b2bua noan command in voice register dn or voice register
pool configuration mode. To disable call forwarding, use the no form of this command.
call-forward b2bua noan directory-number timeout seconds
no call-forward b2bua noan
Syntax Description
Command Default Feature is disabled.
Command Modes Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines This command in voice register dn configuration mode applies the call forward mechanism to a
individual SIP extension in Cisco Unified CME or Cisco Unified SIP SRST that remains unanswered
after a specified length of time. This command in voice register pool configuration mode is for
Cisco Unified SIP SRST only and applies to SIP IP phones on which the extension appears.
If this command is configured in both the voice register dn and voice register pool configuration modes,
the configuration under voice register dn takes precedence.
We recommend that you do not use this command to configure a SIP extension or SIP IP phone that is a
member of a hunt group. If this command is configured for a member of a hunt group, remove the phone
from any hunt group to which it is assigned to avoid forwarding calls to all phones in the hunt group.
The call-forward b2bua all command takes precedence over the call-forward b2bua busy and
call-forward b2bua noan commands.
directory-number Telephone number to which calls are forwarded. Represents a fully
qualified E.164 number. Maximum length of the telephone number is 32.
timeout seconds Number of seconds that a call can ring with no answer before the call is
forwarded to another extension. Range is 3 to 60000. Default is 20.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
12.4(11)XJ Cisco Unified CME 4.1 This command was removed from voice register
pool configuration mode for Cisco Unified CME
only.
12.4(15)T Cisco Unified CME 4.1 This command with modifications was integrated
into Cisco IOS Release 12.4(15)T.
Cisco Unified CME Commands: C
call-forward b2bua noan
166
Cisco Unified CME Command Reference
OL-10894-01
Note This command in voice register dn configuration mode is not commonly used for Cisco Unified SIP
SRST.
Examples Cisco Unified CME and Cisco Unified SIP SRST
The following example shows how to forward calls to extension 5005 when extension 5001 is
unanswered. The timeout before the call is forwarded to extension 5005 is 10 seconds.
Router(config)# voice register pool 4
Router(config-register-pool)# number 5001
Router(config-register-pool)# call-forward b2bua noan 5005 timeout 10

Cisco Unified SIP SRST
The following example shows how to forward calls to extension 5005 when extension 5001 on pool
number 4 is unanswered. The timeout before the call is forwarded to extension 5005 is 10 seconds.
Router(config)# voice register pool 4
Router(config-register-pool)# number 5001
Router(config-register-pool)# call-forward b2bua noan 5005 timeout 10

Related Commands Command Description
call-forward b2bua all Enables call forwarding for a SIP B2BUA so that all incoming calls are
forwarded to another extension.
call-forward b2bua
busy
Enables call forwarding for a SIP B2BUA so that incoming calls to a busy
extension are forwarded to another extension.
call-forward b2bua
mailbox
Controls the specific voice-mail box selected in a voice-mail system at the
end of a call forwarding exchange.
call-waiting (voice
register pool)
Enables call waiting on a SIP phone.
Cisco Unified CME Commands: C
call-forward b2bua unreachable
167
Cisco Unified CME Command Reference
OL-10894-01
call-forward b2bua unreachable
Note Effective with Cisco IOS Release 12.4(11)XJ, the call-forward b2bua unreachable command is not
available in Cisco IOS software.
To forward calls to a phone that is not registered to Cisco Unified CME, use the call-forward b2bua
unreachable command in voice register dn or voice register pool configuration mode. To disable call
forwarding, use the no form of this command.
call-forward b2bua unreachable directory-number
no call-forward b2bua unreachable
Syntax Description
Command Default Feature is disabled
Command Modes Voice register dn configuration (config-register-dn)
Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines Call forward unreachable is triggered when a call arrives for a destination that is configured but
unregistered with Cisco CME. A destination is considered to be configured if its number is listed under
the voice register pool or voice register dn configurations.
If call forward unreachable is not configured for a pool or directory number (DN) register, any calls that
match the numbers in that pool or DN register will use call forward busy instead.
We recommend that you do not use this command with hunt groups. If the command is used, consider
removing the phone from any assigned hunt groups, unless you want to forward calls to all phones in the
hunt group.
directory-number Telephone number to which calls are forwarded. Represents a fully
qualified E.164 number.
Cisco IOS Release Version Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
12.4(11)XJ Cisco Unified CME 4.1 This command was removed.
12.4(15)T Cisco Unified CME 4.1 This command was removed in Cisco IOS
Release 12.4(15)T.
Cisco Unified CME Commands: C
call-forward b2bua unreachable
168
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to forward calls to extension 5005 when extension 5001 on directory
number 4 is unreachable, either because it is unplugged or the network between the Cisco router and the
extension is nonfunctional. The timeout before the call is forwarded to extension 5005 is 10 seconds.
Router(config)# voice register pool 4
Router(config-register-dn)# number 5001
Router(config-register-dn)# call-forward b2bua unreachable 5005 timeout 10

Related Commands Command Description
call-forward b2bua all
(voice register dn and
voice register pool)
Enables call forwarding for a SIP B2BUA so that all incoming calls are
forwarded to another extension.
call-forward b2bua
busy (voice register dn
and voice register
pool)
Enables call forwarding for a SIP B2BUA so that incoming calls to a busy
extension are forwarded to another extension.
call-forward b2bua
mailbox (voice register
dn and voice register
pool)
Controls the specific voice-mail box selected in a voice-mail system at the
end of a call forwarding exchange.
call-forward b2bua
noan (voice register dn
and voice register
pool)
Enables call forwarding for a SIP B2BUA so that incoming calls to an
extension that does not answer after a configured amount of time are
forwarded to another extension.
call-waiting (voice
register pool)
Enables call waiting on a SIP phone.
number (voice register
dn)
Associates an extension number with a voice register dn.
Cisco Unified CME Commands: C
call-forward busy
169
Cisco Unified CME Command Reference
OL-10894-01
call-forward busy
To configure call forwarding so that incoming calls to a busy extension (ephone-dn) are forwarded to
another extension, use the call-forward busy command in ephone-dn or ephone-dn-template
configuration mode. To disable call forwarding, use the no form of this command.
call-forward busy target-number [primary | secondary] [dialplan-pattern]
no call-forward busy
Syntax Description
Command Default Call forwarding for a busy extension is not enabled.
Command Modes Ephone-dn configuration (config-dn-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines The call forwarding mechanism is applied to an individual extension (ephone-dn) and is not applied to
the phone on which the extension appears.
Normally, call forwarding is applied to all dial peers that are created by the ephone-dn. An ephone-dn
can create up to four dial peers:
• A dial peer for the primary number
• A dial peer for the secondary number
target-number Phone number to which calls are forwarded.
primary (Optional) Call forwarding is selectively applied only to the dial peer
created for the primary number for this ephone-dn.
secondary (Optional) Call forwarding is selectively applied only to the dial peer
created for the secondary number for this ephone-dn.
dialplan-pattern (Optional) Call forwarding is selectively applied only to dial peers created
for this ephone-dn by the dial-plan pattern.
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.4(4)XC Cisco Unified CME 4.0 The primary, secondary, and dialplan-pattern
keywords were added, and this command was
made available in ephone-dn-template
configuration mode.
12.4(11)T Cisco Unified CME 4.0 This command with the primary, secondary, and
dialplan-pattern keywords added, and this
command in ephone-dn-template configuration
mode was integrated into Cisco IOS 12.4(11)T.
Cisco Unified CME Commands: C
call-forward busy
170
Cisco Unified CME Command Reference
OL-10894-01
• A dial peer for the primary number as expanded by the dialplan-pattern command
• A dial peer for the secondary number as expanded by the dialplan-pattern command
The primary, secondary, and dialplan-pattern keywords allow you to apply call forwarding selectively
to one or more dial peers based on the exact called number that was used to route the call to the
ephone-dn. If none of the optional keywords is used, call forwarding applies to all dial-peers that are
defined for the ephone-dn.
An ephone-dn can have all four types of call forwarding defined at the same time: all-calls, no-answer,
busy, and night-service. Each type of call forwarding can have a different forwarding target defined in
its target-number argument. If more than one type of call forwarding is in effect (is active) at one time,
the precedence order for evaluating the different types is as follows:
1. call forward night service
2. call forward all
3. call forward busy and call forward no answer
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
Examples The following example forwards all calls for the ephone-dn 2345 when it is busy.
Router(config)# ephone-dn 236
Router(config-ephone-dn)# number 2345
Router(config-ephone-dn)# call-forward busy 2000

The following example uses an ephone-dn template to forward calls for extension 2345 when it is busy.
Router(config)# ephone-dn-template 6
Router(config-ephone-dn-template)# call-forward busy 2000
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn 236
Router(config-ephone-dn)# number 2345
Router(config-ephone-dn)# ephone-dn-template 6

The following example creates a dial-plan pattern to expand extension numbers into E.164 numbers. It
then sets call forwarding of incoming calls to directory number 5005. In this example, call forwarding
on busy is applied only when callers dial the primary number for this ephone-dn, 5001.
Router(config)# telephony-service
Router(config-telephony)# dialplan-pattern 1 40855501.. extension-length 4
extension-pattern 50..
Router(config-telephony)# exit
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5001 secondary 5002
Router(config-ephone-dn)# call-forward busy 5005 primary

Related Commands Command Description
call-forward all Configures call forwarding for all incoming calls to an ephone-dn.
call-forward
night-service
Configures call forwarding for all incoming calls to an ephone-dn during the
hours defined for night service.
Cisco Unified CME Commands: C
call-forward busy
171
Cisco Unified CME Command Reference
OL-10894-01
call-forward noan Configures call forwarding to another number when no answer is received
from an ephone-dn.
ephone-dn-template
(ephone-dn)
Applies template to ephone-dn.
Command Description
Cisco Unified CME Commands: C
call-forward max-length
172
Cisco Unified CME Command Reference
OL-10894-01
call-forward max-length
To restrict the number of digits that can be entered using the CfwdALL soft key on an IP phone, use the
call-forward max-length command in ephone-dn or ephone-dn-template configuration mode. To
remove a restriction on the number of digits that can be entered, use the no form of this command.
call-forward max-length length
no call-forward max-length
Syntax Description
Command Default There is no restriction on the number of digits that can be entered.
Command Modes Ephone-dn configuration (config-dn-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines This command can be used to prevent a phone user from using the CfwdALL soft key on an IP phone to
forward calls to numbers that will incur toll charges when they receive forwarded calls.
If the length argument is set to 0, the CfwdALL soft key is completely disabled. If the ephone-dn
associated with the first line button has an active call forward number when this command is used to set
the length argument to 0, the CfwdALL soft key will be disabled after the next phone restart.
The restriction created by this command does not apply to destinations that are entered using the
Cisco IOS command-line interface (CLI) or the Cisco Unified CME GUI.
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
length Number of digits that can be entered using the CfwdAll soft key on an IP
phone.
Cisco IOS Release Cisco Product Modification
12.3(7)T Cisco CME 3.1 This command was introduced.
12.4(4)XC Cisco Unified CME 4.0 This command was made available in
ephone-dn-template configuration mode.
12.4(11)T Cisco Unified CME 4.0 This command in ephone-dn-template
configuration mode was integrated into Cisco IOS
Release 12.4(11)T.
Cisco Unified CME Commands: C
call-forward max-length
173
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example restricts the number of digits that a phone user can enter using the CfwdALL soft
key to four. In this example, extensions in the phone user’s Cisco Unified CME system have four digits,
so that means the user can use the IP phone to forward all calls to any extension in the system, but not
to any number outside the system.
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5001
Router(config-ephone-dn)# call-forward max-length 4

The following example uses an ephone-dn-template to restrict the number of digits that a phone user can
enter using the CfwdALL soft key to four.
Router(config)# ephone-dn-template 4
Router(config-ephone-dn-template)# call-forward max-length 4
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5001
Router(config-ephone-dn)# ephone-dn-template 4

Related Commands Command Description
call-forward all Configures call forwarding for all incoming calls on one of the lines of a
Cisco Unified IP phone.
ephone-dn-template
(ephone-dn)
Applies an ephone-dn template to an ephone-dn.
Cisco Unified CME Commands: C
call-forward night-service
174
Cisco Unified CME Command Reference
OL-10894-01
call-forward night-service
To automatically forward calls to another number during night-service hours, use the call-forward
night-service command in ephone-dn or ephone-dn-template configuration mode. To disable automatic
call forwarding during night service, use the no form of this command.
call-forward night-service target-number
no call-forward night-service
Syntax Description
Command Default Calls are not forwarded during night-service hours.
Command Modes Ephone-dn configuration (config-dn-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines You must also configure the night-service bell command for this ephone-dn.
Night-service hours are defined using the night-service date and night-service day commands.
An ephone-dn can have all four types of call forwarding defined at the same time: all-calls, no-answer,
busy, and night-service. Each type of call forwarding can have a different forwarding destination defined
in its target-number argument. If more than one type of call forwarding is in effect (is active) at one time,
the precedence order for evaluating the different types is as follows:
1. call forward night-service
2. call forward all
3. call forward busy and call forward no answer
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
target-number Phone number to which calls are forwarded.
Cisco IOS Release Cisco Product Modification
12.4(4)XC Cisco Unified CME 4.0 This command was introduced.
12.4(11)T Cisco Unified CME 4.0 This command was integrated into Cisco IOS
Release 12.4(11)T.
Cisco Unified CME Commands: C
call-forward night-service
175
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example establishes night-service hours from 1 p.m. Saturday until 8 a.m. Monday.
During that time, calls to extension 1000 (ephone-dn 1) are forwarded to extension 2346. Note that the
night-service bell command has also been used for ephone-dn 1.
telephony-service
night-service day sat 13:00 12:00
night-service day sun 12:00 08:00
night-service code *1234
!
ephone-dn 1
number 1000
night-service bell
call-forward night-service 2346
!
ephone-dn 2
number 2346
ephone 12
button 1:1
ephone 13
button 1:2
The following example uses an ephone-dn template to apply call forwarding for extension
2876 during the night service hours established in the previous example.
ephone-dn-template 2
call-forward night-service 2346
ephone-dn 25
number 2876
ephone-dn-template 2

Related Commands Command Description
call-forward all Configures call forwarding for all incoming calls to an ephone-dn.
call-forward busy Configures call forwarding to another number when an ephone-dn is busy.
call-forward noan Configures call forwarding to another number when no answer is received
from an ephone-dn.
night-service bell
(ephone-dn)
Marks an ephone-dn for night-service treatment.
night-service date Defines a recurring time period associated with a month and day during
which night service is active.
night-service day Defines a recurring time period associated with a day of the week during
which night service is active.
Cisco Unified CME Commands: C
call-forward noan
176
Cisco Unified CME Command Reference
OL-10894-01
call-forward noan
To configure call forwarding so that incoming calls to an extension (ephone-dn) that does not answer are
forwarded to another number, use the call-forward noan command in ephone-dn or
ephone-dn-template configuration mode. To disable call forwarding, use the no form of this command.
call-forward noan target-number timeout seconds [primary | secondary] [dialplan-pattern]
no call-forward noan
Syntax Description
Command Default Call forwarding for an extension that does not answer is not enabled.
Command Modes Ephone-dn configuration (config-dn-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines The call forwarding mechanism is applied to an individual extension (ephone-dn) and is not applied to
the phone on which the extension appears.
Normally, call forwarding is applied to all dial peers that are created by the ephone-dn. An ephone-dn
can create up to four dial peers:
• A dial peer for the primary number
target-number Phone number to which calls are forwarded.
timeout seconds Sets the duration that a call can ring with no answer before the call is
forwarded to the target number. Range is from 3 to 60000. There is no
default value.
primary (Optional) Call forwarding is selectively applied only to the dial peer
created for the primary number for this ephone-dn.
secondary (Optional) Call forwarding is selectively applied only to the dial peer
created for the secondary number for this ephone-dn.
dialplan-pattern (Optional) Call forwarding is selectively applied only to dial peers created
for this ephone-dn by the dial-plan pattern.
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.4(4)XC Cisco Unified CME 4.0 The primary, secondary, and dialplan-pattern
keywords were added, and this command was
made available in ephone-dn-template
configuration mode.
12.4(9)T Cisco Unified CME 4.0 This command with modifications was integrated
into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: C
call-forward noan
177
Cisco Unified CME Command Reference
OL-10894-01
• A dial peer for the secondary number
• A dial peer for the primary number as expanded by the dialplan-pattern command
• A dial peer for the secondary number as expanded by the dialplan-pattern command
The primary, secondary, and dialplan-pattern keywords allow you to apply call forwarding selectively
to one or more dial peers based on the exact called number that was used to route the call to the
ephone-dn. If none of the optional keywords is used, call forwarding applies to all dial-peers that are
defined for the ephone-dn.
An ephone-dn can have all four types of call forwarding defined at the same time: all-calls, no-answer,
busy, and night-service. Each type of call forwarding can have a different forwarding target defined in
its target-number argument. If more than one type of call forwarding is in effect (is active) at one time,
the precedence order for evaluating the different types is as follows:
1. call forward night service
2. call forward all
3. call forward busy and call forward no answer
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
Examples The following example forwards calls for the ephone-dn 2345 when it does not answer.
Router(config)# ephone-dn 236
Router(config-ephone-dn)# number 2345
Router(config-ephone-dn)# call-forward busy 2000
The following example uses an ephone-dn-template to forward calls for the ephone-dn 2345
when it does not answer.
Router(config)# ephone-dn-template 8
Router(config-ephone-dn-template)# call-forward busy 2000
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn 236
Router(config-ephone-dn)# number 2345
Router(config-ephone-dn)# ephone-dn-template 8

The following example creates a dial-plan pattern to expand extension numbers into E.164 numbers. It
then sets call forwarding of incoming calls to directory number 5005. In this example, call forwarding
on no answer is applied only when callers dial the primary number for this ephone-dn, 5001.
Router(config)# telephony-service
Router(config-telephony)# dialplan-pattern 1 40855501.. extension-length 4
extension-pattern 50..
Router(config-telephony)# exit
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5001 secondary 5002
Router(config-ephone-dn)# call-forward noan 5005 primary

Related Commands Command Description
call-forward all Configures call forwarding for all incoming calls for an ephone-dn.
call-forward busy Configures call forwarding to another number when an ephone-dn is busy.
Cisco Unified CME Commands: C
call-forward noan
178
Cisco Unified CME Command Reference
OL-10894-01
call-forward
night-service
Configures call forwarding for all incoming calls to an ephone-dn during the
hours defined for night service.
ephone-dn-template
(ephone-dn)
Applies an ephone-dn-template to an ephone-dn.
Command Description
Cisco Unified CME Commands: C
call-forward pattern
179
Cisco Unified CME Command Reference
OL-10894-01
call-forward pattern
To specify a pattern for calling-party numbers that are able to support the ITU-T H.450.3 standard for
call forwarding, use the call-forward pattern command in telephony-service configuration mode. To
remove the pattern, use the no form of this command.
call-forward pattern pattern
no call-forward pattern pattern
Syntax Description
Command Default No call-forward pattern is defined.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Use this command with Cisco IOS Telephony Services (ITS) V2.1, Cisco CallManager Express 3.0, or
a later version.
When H.450.3 call forwarding is selected, the router must be configured with a Tool Command
Language (Tcl) script that supports the H.450.3 protocol. The Tcl script is loaded on the router by using
the call application voice command.
The pattern match in this command is against the phone number of the calling party. When an extension
number has forwarded its calls and an incoming call is received for that number, the router sends an
H.450.3 response back to the original calling party to request that the call be placed again using the
forward-to destination.
Calling numbers that do not match the patterns defined using this command are forwarded using
Cisco-proprietary call forwarding for backward compatibility.
Examples The following example specifies that all 4-digit directory numbers that begin with 4 should use the
H.450.3 standard whenever they are forwarded:
Router(config)# telephony-service
Router(config-telephony)# call-forward pattern 4...

pattern String that consists of one or more digits and wildcard markers or dots (.) to
define a specific pattern. Calling parties that match a defined pattern use the
H.450.3 standard if they are forwarded. A pattern of .T specifies the H.450.3
forwarding standard for all incoming calls.
Cisco IOS Release Cisco Product Modification
12.2(11)YT Cisco CME 2.1 This command was introduced.
12.2(15)T Cisco CME 2.1 This command was integrated into Cisco IOS
Release 12.2(15)T.
Cisco Unified CME Commands: C
call-forward pattern
180
Cisco Unified CME Command Reference
OL-10894-01
The following example forwards all calls that support the H.450.3 standard:
Router(config)# telephony-service
Router(config-telephony)# call-forward pattern .T

Related Commands Command Description
call application voice Defines an application, indicates the location of the corresponding Tcl files
that implement the application, and loads the selected Tcl script.
Cisco Unified CME Commands: C
calling-number local
181
Cisco Unified CME Command Reference
OL-10894-01
calling-number local
To replace a calling-party number and name with the forwarding-party number and name (the local
number and name) in calls forwarded using local hairpin call routing, use the calling-number local
command in telephony-service configuration mode. To reset to the default, use the no form of this
command.
calling-number local [secondary]
no calling-number local
Syntax Description
Command Default Calling-party numbers and names are used in forwarded calls.
Command Modes Telephony-service configuration
Command History
Usage Guidelines In Cisco CME 3.2 and earlier versions, this command is used with the Tool Command Language (Tcl)
script app-h450-transfer.2.0.0.7 or a later version.
In Cisco CME 3.3 and later versions, this command can be used without the TCL script because the
functionality is integrated into the default IOS voice application framework.
If the ephone-dn used by a forwarding party has a secondary number in addition to its primary number
and neither number is registered with the gatekeeper, the primary number is the number that appears as
the calling number on hairpin-forwarded calls when the calling-number local command is used. If only
one of the numbers is registered with the gatekeeper, the registered number is the number that appears
as the calling number. If both numbers are registered with the gatekeeper, the primary number is the
number that appears as the calling number.
secondary (Optional) Uses the secondary number associated with the forwarding party
instead of the primary number. The primary number is the default if this
keyword is not used.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ3 Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.3(15)ZJ4 Cisco CME 3.0 The secondary keyword was introduced.
12.3(14)T Cisco CME 3.3 Support was added to the default IOS voice
application framework and dependency on the
TCL script was removed.
Cisco Unified CME Commands: C
calling-number local
182
Cisco Unified CME Command Reference
OL-10894-01
If the ephone-dn used by a forwarding party has a secondary number in addition to its primary number
and the calling-number local secondary command is used, the secondary number is the number that
appears as the calling number on hairpin-forwarded calls if both numbers are registered with the
gatekeeper or if both numbers are not registered. If only one number is configured to register with the
gatekeeper, the number that is registered appears as the calling number.
Examples The following example specifies use of the name and number of the local forwarding party in
hairpin-forwarded calls:
Router(config)# telephony-service
Router(config-telephony)# calling-number local

The following examples demonstrate the use of the calling-number local command without the
secondary keyword.
• The calling number for hairpin calls forwarded from ephone-dn 1 is 1234 in the following example:
calling-number local
ephone-dn 1
number 1234 secondary 4321 no-reg
• The calling number for hairpin calls forwarded from ephone-dn 1 is 4321 in the following example:
calling-number local
ephone-dn 1
number 1234 secondary 4321 no-reg primary
• The calling number for hairpin calls forwarded from ephone-dn 1 is 1234 in the following example:
calling-number local
ephone-dn 1
number 1234 secondary 4321 no-reg both
or
number 1234 secondary 4321
The following examples demonstrate the use of the calling-number local secondary command.
• The calling number for hairpin calls forwarded from ephone-dn 1 is 1234 in the following example:
calling-number local secondary
ephone-dn 1
number 1234 secondary 4321 no-reg
• The calling number for hairpin calls forwarded from ephone-dn 1 is 4321 in the following example:
calling-number local secondary
ephone-dn 1
number 1234 secondary 4321 no-reg primary
• The calling number for hairpin calls forwarded from ephone-dn 1 is 4321 in the following example:
calling-number local secondary
ephone-dn 1
number 1234 secondary 4321 no-reg both
Cisco Unified CME Commands: C
calling-number local
183
Cisco Unified CME Command Reference
OL-10894-01
or
number 1234 secondary 4321
Cisco Unified CME Commands: C
call-park system
184
Cisco Unified CME Command Reference
OL-10894-01
call-park system
To define system parameters for the Call Park feature, use the call-park system command in
telephony-service configuration mode. To reset to the default, use the no form of this command.
call-park system {application | redirect}
no call-park system {application | redirect}
Syntax Description
Command Default H.323 and SIP calls use hairpin call forwarding or transfer to park calls and to pick up calls from park.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines The application keyword selects the enhanced Call Park method supported in Cisco Unified CME 7.1
and later versions for SCCP and SIP phones.
Examples The following example specifies that H.323 and SIP calls will use the H.450 or SIP Refer method of call
forwarding or transfer to park calls and pick up calls from park:
Router(config)# telephony-service
Router(config-telephony)# call-park system redirect
Related Commands
application Enables Call Park and Directed Call Park for SCCP and SIP phones.
redirect H.323 and SIP calls use H.450 or the SIP Refer method of call forwarding or
transfer to park calls and to pick up calls from park.
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(22)YB Cisco Unified CME 7.1 The application keyword and support for SIP
phones was added.
12.4(24)T Cisco Unified CME 7.1 This command has been integrated into Cisco IOS
Release 12.4(24)T.
Command Description
park reservation-group Assigns a call-park reservation group to a phone.
park-slot Creates a floating extension at which calls can be temporarily parked.
Cisco Unified CME Commands: C
call-waiting (voice register pool)
185
Cisco Unified CME Command Reference
OL-10894-01
call-waiting (voice register pool)
To enable call-waiting option on a SIP phone, use the call-waiting command in voice register pool
configuration mode. To disable call waiting, use the no form of this command.
call-waiting
no call-waiting
Syntax Description This command has no arguments or keywords.
Command Default Feature is enabled.
Command Modes Voice register pool configuration (call-waiting)
Command History
Usage Guidelines The call waiting feature is enabled by default on SIP phones. To disable call waiting, use the
no call-waiting command.
Examples The following example shows how to disable call waiting on SIP phone 1:
Router(config)# voice register pool 1
Router(config-register-pool)# no call-waiting

Related Commands
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
voice register pool Enters voice register pool configuration mode for SIP phones.
Cisco Unified CME Commands: C
call-waiting beep
186
Cisco Unified CME Command Reference
OL-10894-01
call-waiting beep
To allow call-waiting beeps to be accepted by or generated from an ephone-dn, use the call-waiting beep
command in ephone-dn or ephone-dn-template configuration mode. To disable the acceptance and
generation of call-waiting beeps by an ephone-dn, use the no form of this command.
call-waiting beep [accept | generate]
no call-waiting beep [accept | generate]
Syntax Description
Command Default Call-waiting beeps are accepted and generated.
Command Modes Ephone-dn configuration (config-ephone-dn)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines The call-waiting beep command must be used with the ephone-dn command. The call-waiting beep
command is used like a toggle and can be switched on and off for each ephone-dn.
A beep can be heard only if both sending and receiving ephone-dns are configured to accept call-waiting
beeps.
To display how call-waiting beeps are configured, use the show running-config command in the
privileged EXEC configuration mode. If the no call-waiting beep generate and no call-waiting beep
accept commands are configured, the show running-config output will display the no call-waiting
beep command.
If you configure a button to have a silent ring using the s option of the button command, you will not
hear a call-waiting beep regardless of whether the ephone-dn associated with the button is configured to
generate a call-waiting beep.
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
accept (Optional) Allows call-waiting beeps to be accepted by an ephone-dn.
generate (Optional) Allows call-waiting beeps to be generated by an ephone-dn.
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 This command was made available in
ephone-dn-template configuration mode.
12.4(9)T Cisco Unified CME 4.0 This command in ephone-dn-template
configuration mode was integrated into Cisco IOS
Release 12.4(9)T.
Cisco Unified CME Commands: C
call-waiting beep
187
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example configures ephone-dn 1 and ephone-dn 2 not to accept and not to generate
call-waiting beeps:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 2588
Router(config-ephone-dn)# no call-waiting beep accept
Router(config-ephone-dn)# no call-waiting beep generate
Router(config-ephone-dn)# exit
Router(config)# ephone-dn 2
Router(config-ephone-dn)# number 2589
Router(config-ephone-dn)# no call-waiting beep accept
Router(config-ephone-dn)# no call-waiting beep generate
Router(config-ephone-dn)# exit

The following example uses an ephone-dn template to set the same attributes as in the previous example:
Router(config)# ephone-dn-template 5
Router(config-ephone-dn-template)# no call-waiting beep accept
Router(config-ephone-dn-template)# no call-waiting beep generate
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 2588
Router(config-ephone-dn)# ephone-dn-template 5
Router(config-ephone-dn)# exit
Router(config)# ephone-dn 2
Router(config-ephone-dn)# number 2589
Router(config-ephone-dn)# ephone-dn-template 5
Router(config-ephone-dn)# exit

The following example configures ephone-dn 1 and ephone-dn 2 to switch back to accept call-waiting
beeps. Ephone-dn 1 and ephone-dn 2 now accept but do not generate call-waiting beeps.
Router(config)# ephone-dn 1
Router(config-ephone-dn)# call-waiting beep accept
Router(config)# ephone-dn 2
Router(config-ephone-dn)# call-waiting beep accept

Related Commands Command Description
show running-config Displays the contents of the currently running configuration file or the
configuration for a specific interface, or map class information.
ephone-dn-template
(ephone-dn)
Applies a template to an ephone-dn.
Cisco Unified CME Commands: C
call-waiting ring
188
Cisco Unified CME Command Reference
OL-10894-01
call-waiting ring
To allow an ephone-dn to use a ring sound for call-waiting notification, use the call-waiting ring
command in ephone-dn or ephone-dn-template configuration mode. To disable the ring notification, use
the no form of this command.
call-waiting ring
no call-waiting ring
Syntax Description This command has no arguments or keywords.
Command Default The ephone-dn accepts call waiting and uses beeps for notification.
Command Modes Ephone-dn configuration (config-ephone-dn)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines To use a ring sound for call-waiting notification on an ephone-dn, you must ensure that the ephone-dn
will accept secondary calls while it is connected to another line. The acceptance of call waiting is the
default ephone-dn behavior. However, the no call-waiting beep accept command can change this default
so an ephone-dn does not accept call waiting. This command must be removed for ringing notification
to work.
The call-waiting ring command will automatically disable a call-waiting beep configuration.
If you configure a button to have a silent ring using the s option of the button command, you will not
hear a call-waiting ring regardless of whether the ephone-dn associated with the button is configured to
generate a call-waiting ring.
Note The call-waiting ring option cannot be used on the Cisco Unified IP Phone 7902, Cisco Unified IP
Phone 7905, or Cisco Unified IP Phone 7912. Do not use the call-waiting ring command for ephone-dns
associated with these types of phones.
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.
12.4(4)XC Cisco Unified CME 4.0 This command was made available in
ephone-dn-template configuration mode.
12.4(9)T Cisco Unified CME 4.0 This command in ephone-dn-template
configuration mode was integrated into Cisco IOS
Release 12.4(9)T.
Cisco Unified CME Commands: C
call-waiting ring
189
Cisco Unified CME Command Reference
OL-10894-01
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
Examples The following example configures ephone-dn 1 and ephone-dn 2 to use ringing for their call-waiting
notification:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# call-waiting ring
Router(config)# ephone-dn 2
Router(config-ephone-dn)# no call-waiting ring

The following example uses an ephone-dn template to set the same attributes as in the previous example:
Router(config)# ephone-dn-template 9
Router(config-ephone-dn-template)# call-waiting ring
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn-template 10
Router(config-ephone-dn-template)# no call-waiting ring
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn 1
Router(config-ephone-dn)# ephone-dn-template 9
Router(config-ephone-dn)# exit
Router(config)# ephone-dn 2
Router(config-ephone-dn)# ephone-dn-template 10
Router(config-ephone-dn)# exit

Related Commands Command Description
call-waiting beep Allows call-waiting beeps to be accepted by or generated from an
ephone-dn.
ephone-dn-template
(ephone-dn)
Applies template to ephone-dn.
Cisco Unified CME Commands: C
capf-auth-str
190
Cisco Unified CME Command Reference
OL-10894-01
capf-auth-str
To define a string of digits that a user enters at the phone for CAPF authentication, use the capf-auth-str
command in ephone configuration mode. To return to the default, use the no form of this command.
capf-auth-str digit-string
no capf-auth-str
Syntax Description
Command Default No authentication string exists for the phone.
Command Modes Ephone configuration (config-ephone)
Command History
Usage Guidelines This command is used with Cisco Unified CME phone authentication to create or remove an
authentication string (Personal Identification Number or PIN) for the specified secure ephone. Use this
command if the auth-string keyword is specified in the auth-mode command. Once you specify a CAPF
authentication string, it becomes part of the ephone configuration. This value can also be set globally or
per ephone using the auth-string command in CAPF configuration mode.
Use the show capf-server auth-str command to display configured authentication strings.
When a phone is configured for a certificate upgrade that requires auth-string authentication, the CAPF
initiation needs to be performed manually by the phone user using the following steps:
1. Press the Settings button.
2. If the configuration is locked, press **# (asterisk, asterisk, pound sign) to unlock it.
3. Scroll down the menu and select Security Configuration.
4. Scroll down the next menu to LSC and press the Update soft key.
5. When prompted for the authentication string, enter the string provided by the system administrator.
digit-string String of digits that a phone user enters at the phone for CAPF
authentication.
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.
Cisco Unified CME Commands: C
capf-auth-str
191
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example specifies the type of authentication for ephone 392 is an authentication string
that is entered from the phone, and then defines the string as 38593.
ephone 392
button 1:23 2:24 3:25
device-security-mode authenticated
cert-oper upgrade auth-mode auth-string
capf-auto-str 38593

Related Commands Command Description
auth-mode Specifies the type of authentication to use during CAPF sessions.
auth-string Generates or removes authentication strings for one or all secure ephones.
show capf-server Displays configuration and session information for the CAPF server.
Cisco Unified CME Commands: C
capf-server
192
Cisco Unified CME Command Reference
OL-10894-01
capf-server
To enter CAPF-server configuration mode to set CAPF server parameters, use the capf-server command
in global configuration mode. To remove the CAPF server configuration, use the no form of this
command.
capf-server
no capf-server
Syntax Description This command has no keywords or arguments.
Command Default No CAPF server configuration is present.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used with Cisco Unified CME phone authentication.
Examples The following example sets parameters for the CAPF server:
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

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.
Cisco Unified CME Commands: C
cert-enroll-trustpoint
193
Cisco Unified CME Command Reference
OL-10894-01
cert-enroll-trustpoint
To enroll the CAPF with the CA or RA, use the cert-enroll-trustpoint command in CAPF-server
configuration mode. To remove an enrollment, use the no form of this command.
cert-enroll-trustpoint ca-label password {0 | 1} password-string
no cert-enroll-trustpoint
Syntax Description
Command Default The CAPF server is not enrolled with the CA or RA.
Command Modes CAPF-server configuration (config-capf-server)
Command History
Usage Guidelines This command is used with Cisco Unified CME phone authentication.
ca-label PKI trustpoint label for the CA or for the RA if an RA is being used.
password Values that follow apply to the password.
0 | 1 Encryption status of the password string that follows.
• 0—Encrypted.
• 1—Clear text.
Note This option refers to the way that you want the password to appear in
show command output and not to the way that you enter the password
in this command.
password-string Alphanumeric challenge password that is required for certificate enrollment.
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.
Cisco Unified CME Commands: C
cert-enroll-trustpoint
194
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example specifies that the CAPF server should enroll with the trustpoint named server12
(the CA) using the password x8oWiet, which should be encrypted:
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

Cisco Unified CME Commands: C
clear cti session
195
Cisco Unified CME Command Reference
OL-10894-01
clear cti session
To tear down the connection between a CSTA client application and Cisco Unified CME, use the clear
cti session command in privileged EXEC configuration mode.
clear cti session session_id
Syntax Description
Command Default The CTI session between the application and the router is active.
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines This command gracefully disassociates the connection between a CSTA application and
Cisco Unified CME. Use this command to direct Cisco Unified CME to send a SIP BYE for the CSTA
call to the application and to clean up the session internally. This command does not reset the IP phone.
To disassociate the connection without using this command, you must reboot the router or the CSTA
client application.
This command has a no form, but the no form has no effect.
To determine the ID for an active CTI session, use the show cti session command.
Examples The following example shows how to tear down session 10133 between a CSTA client application and
Cisco Unified CME:
Router# clear cti session 10133
Router#

Related Commands
session_id Unique numeric identifier for the session. String length is 1 to 10 characters.
String value is 1 to 2147483647.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
show cti session Displays active CTI sessions.
Cisco Unified CME Commands: C
clear voice moh-group statistics
196
Cisco Unified CME Command Reference
OL-10894-01
clear voice moh-group statistics
To clear the display of MOH subsystem statistics information and reset the packet counters, use the clear
voice moh-group statistics command in privileged EXEC mode.
clear voice moh-group statistics
Syntax Description This command has no arguments or keywords
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines Use this command to clear the display of MOH subsystem statistics information displayed by the show
voice moh-group statistics command.
We recommend that the clear voice moh-group statistics should be used once every two years to reset
the packet counters. Each packet counter is of 32 bit size limit and the largest count a packet counter can
hold is 4294967296 intervals. This means that with 20 milliseconds packet interval (for G.711), the
counters will restart from 0 any time after 2.72 years (2 years and 8 months).
Examples Router# clear voice moh-group statistics
All moh group stats are cleared
Related Commands
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0
Cisco Unified SRST 8.0
This command was introduced.
Command Description
show voice moh-group statistics Displays the MOH subsystem statistics information
show voice moh-group Displays the MOH groups configured
Cisco Unified CME Commands: C
clear telephony-service conference hardware number
197
Cisco Unified CME Command Reference
OL-10894-01
clear telephony-service conference hardware number
To drop all conference parties and clear the conference call, use the clear telephony-service conference
hardware number command in privileged EXEC mode.
clear telephony-service conference hardware number number
Syntax Description
Command Default The conference call continues with all current parties.
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines Use the show telephony-service conference hardware command to display the active hardware
conferences. Use the clear telephony-service conference hardware number command to clear the
desired conference.
Examples The following example clears the conference number 1111 and drops all its parties:
Router# clear telephony-service conference hardware number 1111
Related Commands
number Conference telephone or extension number.
Cisco IOS 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.
Command Description
show telephony-service conference
hardware
Displays information about hardware conferences in a Cisco
CME system.
Cisco Unified CME Commands: C
clear telephony-service ephone-attempted-registrations
198
Cisco Unified CME Command Reference
OL-10894-01
clear telephony-service ephone-attempted-registrations
To empty the log of ephones that unsuccessfully attempt to register with Cisco Unified CME, use the
clear telephony-service ephone-attempted-registrations command in privileged EXEC configuration
mode.
clear telephony-service ephone-attempted-registrations
Syntax Description This command has no keywords or arguments.
Command Default The log continues to accumulate attempted ephone registrations.
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines The no auto-reg-ephone command blocks the automatic registration of ephones whose MAC addresses
are not explicitly listed in the configuration. When automatic registration is blocked,
Cisco Unified CME records the MAC addresses of phones that attempt to register but cannot because
they are blocked.
Use the show ephone attempted-registrations command to view the list of phones that have attempted
to register but have been blocked. The clear telephony-service ephone-attempted-registrations
command clears the list.
Examples The following example clears the attempted-registrations log.
Router# clear telephony-service ephone-attempted-registrations
Related Commands
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.
Command Description
auto-reg-ephone Enables automatic registration of ephones with Cisco Unified CME.
show ephone
attempted-registrations
Displays the log of ephones that unsuccessfully attempt to register with
Cisco CME.
Cisco Unified CME Commands: C
clear telephony-service xml-event-log
199
Cisco Unified CME Command Reference
OL-10894-01
clear telephony-service xml-event-log
To clear the event table used for the Cisco Unified CME XML application, use the clear
telephony-service xml-event-log command in privileged EXEC mode.
clear telephony-service xml-event-log
Syntax Description This command has no keywords or arguments.
Command Default The XML event table is not cleared.
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines The show fb-its-log command displays the contents of the XML event table.
Examples The following example clears the entries from the XML event table:
Router# clear telephony-service xml-event-log
Related Commands
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.
Command Description
show fb-its-log Displays Cisco Unified CME XML API information.
Cisco Unified CME Commands: C
clear voice lpcor statistics
200
Cisco Unified CME Command Reference
OL-10894-01
clear voice lpcor statistics
To clear all logical partitioning class of restriction (LPCOR) statistics that are displayed when the show
voice lpcor statistics command is used, use the clear voice lpcor statistics command in privileged
EXEC mode.
clear voice lpcor statistics
Syntax Description This command has no arguments or keywords.
Command Default Statistics continue to increment.
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines This command resets all LPCOR failed-call statistics to 0. Use the show voice lpcor statistics command
to display the current statistics.
Examples The following example resets the LPCOR statistics:
Router# clear voice lpcor statistics
Related Commands
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
show voice lpcor statistics Displays information about LPCOR policies and calls.
voice lpcor policy Creates a LPCOR policy for a resource group.
Cisco Unified CME Commands: C
cnf-file
201
Cisco Unified CME Command Reference
OL-10894-01
cnf-file
To specify the generation of different phone configuration files by type of phone or by individual phone,
use the cnf-file command in telephony-service configuration mode. To return to the default, use the no
form of this command.
cnf-file {perphonetype | perphone}
no cnf-file {perphonetype | perphone}
Syntax Description
Command Default A single configuration file is used for all phones.
Command Modes Telephony-service (config-telephony)
Command History
Usage Guidelines Configuration files can be applied in the following ways:
• Per system—All phones use a single configuration file. This command is the default behavior for
Cisco Unified CME and does not require you to configure this command. The default user and
network locale in a single configuration file are applied to all phones in the Cisco Unified CME
system. Alternative and user-defined user and network locales are not supported. To use the
per-system option after configuring this command, use the no cnf-file command to reset the option
to default behavior.
• Per phone type—Creates separate configuration files for each phone type. For example, all
Cisco Unified IP Phone 7960s use XMLDefault7960.cnf.xml, and all Cisco Unified IP Phone 7905s
use XMLDefault7905.cnf.xml. All phones of the same type use the same configuration file which is
generated using the default user and network locale. This option is not supported if the cnf-file
location is configured for system.
• Per phone—Creates a separate configuration file for each phone, by MAC address. For example, a
Cisco Unified IP Phone 7960 with the MAC address 123.456.789 creates the per-phone
configuration file SEP123456789.cnf.xml. The configuration file for a phone is generated with the
default user and network locale unless a different user and network locale is applied to the phone
using an ephone template. This option is not supported if the location option is system.
To reset the type of configuration file to the default, use the no form of this command and the keyword
that you previously used to set the type.
perphonetype A separate configuration file is generated for each type of phone.
perphone A separate configuration file is generated for each phone.
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.
Cisco Unified CME Commands: C
cnf-file
202
Cisco Unified CME Command Reference
OL-10894-01
This feature is supported only on the following phones:
• Cisco Unified IP Phones 7940 and 7940G
• Cisco Unified IP Phones 7960 and 7960G
• Cisco Unified IP Phone 7970G
• Cisco Unified IP Phone 7971G-GE
Examples The following example selects flash memory as the configuration file storage location and per-phone as
the type of configuration files that the system should generate.
telephony-service
cnf-file location flash:
cnf-file perphone

Related Commands Description
cnf-file location Specifies a storage location for XML configuration files.
create cnf Generates the XML configuration files used for provisioning SCCP phones.
Cisco Unified CME Commands: C
cnf-file location
203
Cisco Unified CME Command Reference
OL-10894-01
cnf-file location
To specify a storage location for phone configuration files, use the cnf-file location command in
telephony-service configuration mode. To return to the default, use the no form of this command.
cnf-file location {flash: | slot0: | tftp tftp-url}
no cnf-file location {flash: | slot0: | tftp tftp-url}
Syntax Description
Command Default A single phone configuration file is stored in system memory and is used by all phones.
Command Modes Telephony-service configuration
Command History
Usage Guidelines You can specify any of the following four locations to store configuration files:
• System—This is the default. When the system is the storage location, there can be only one default
configuration file and it is used for all phones in the system. All phones, therefore, use the same user
locale and network locale. User-defined user and network locales are not supported. To use the
system location, either do not use the cnf-file location command to specify a location or use the no
cnf-file location {flash: | slot0: | tftp url} command to reset the option from a previous, different
location.
If VRF Support on Cisco Unified CME is configured and the cnf-file location command is
configured for system:, the per phone or per phone type file for an ephone in a VRF group is created
in system:/its/vrf<group-tag>/. The vrf group directory is created and appended to the TFTP path
automatically. No action is required on your part. The location for locale files is not affected. Locale
files are created in system:/its/.
• Flash or slot 0—When flash or slot 0 memory on the router is the storage location, you can create
additional configuration files that can be applied per phone type or per individual phone. Up to five
user-defined user and network locales can be used in these configuration files. To store configuration
files in flash or slot 0, use the cnf-file location flash: or cnf-file location slot0: command. The
generation of configuration files on flash or slot 0 can take up to a minute, depending on the number
of files that are being generated.
flash: Router flash memory.
slot0: Router slot 0 memory.
tftp tftp-url External TFTP server at the specified URL.
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.
Cisco Unified CME Commands: C
cnf-file location
204
Cisco Unified CME Command Reference
OL-10894-01
If VRF Support on Cisco Unified CME is configured and the cnf-file location command is
configured as flash: or slot0:, the per phone or per phone type file for an ephone in a VRF group is
named flash:/its/vrf<group-tag>_<filename> or slot0:/its/vrf<group-tag>_filename>. The vrf
group directory is created and appended to the TFTP path automatically. No action is required on
your part. The location for locale files is not affected. Locale files are created in flash:/its/ or in
slot0:/its
Note When the storage location chosen is flash and the file system type on this device is Class B(LEFS), make
sure to check free space on the device periodically and use the squeeze command to free the space used
up by deleted files. Unless you use the squeeze command, the space used by the moved or deleted
configuration files cannot be used by other files.
• TFTP—When an external TFTP server is the storage location, you can create additional
configuration files that can be applied per phone type or per individual phone. Up to five
user-defined user and network locales can be used in these configuration files. To store configuration
files on an external TFTP server, use the cnf-file location tftp url command.
TFTP does not support file deletion. When configuration files are updated, they overwrite any existing
configuration files with the same name. If you change the configuration file location, files are not deleted
from the TFTP server.
To reset the location to the default, use the no form of this command and the keyword that you previously
used to set the location.
This feature is supported only on the following phones:
• Cisco Unified IP Phones 7940 and 7940G
• Cisco Unified IP Phones 7960 and 7960G
• Cisco Unified IP Phone 7970G
• Cisco Unified IP Phone 7971G-GE
Examples The following example selects flash memory as the configuration file storage location and per-phone as
the type of configuration files that the system should generate.
telephony-service
cnf-file location flash:
cnf-file perphone

Related Commands Command Description
cnf-file Specifies the use of different phone configuration files by type of phone or
by individual phone.
create cnf Generates the XML configuration files used for provisioning SCCP phones.
Cisco Unified CME Commands: C
codec (ephone)
205
Cisco Unified CME Command Reference
OL-10894-01
codec (ephone)
To select a preferred codec for Cisco Unified CME to use when configuring calls for a phone, use the
codec command in ephone or ephone-template configuration mode. To return to the command default,
use the no form of this command.
codec {g711ulaw | g722r64 | g729r8 [dspfarm-assist] | ilbc}
no codec
Syntax Description
Command Default G.711 micro-law is the preferred codec.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines This command can be used to help save network bandwidth for a remote IP phone.
For calls to phones that are not in the same Cisco Unified CME system (such as VoIP calls), the codec
is negotiated based on the protocol that is used for the call (such as H.323). The Cisco Unified CME
system plays no part in the negotiation.
The G.722-64K codec is supported on some varieties of phone models. Check your phone documentation
to make sure the phone supports the G.722-64K codecs.
g711ulaw Preferred codec: G.711 micro-law 64K bps.
g722r64 Preferred codec: G.722-64K bps.
g729r8 Preferred codec: G.729-8K bps.
dspfarm-assist (Optional) DSP-farm resources are used for transcoding the segment
between the phone and the Cisco Unified CME router if G.711 is negotiated
for the call.
Note The dspfarm-assist keyword is ignored if the SCCP endpoint type is
ATA, VG224, or VG248.
ilbc Preferred codec: iLBC 20ms.
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 g722r64 and ilbc keywords were added.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: C
codec (ephone)
206
Cisco Unified CME Command Reference
OL-10894-01
The telephone’s firmware version must support the specified codec. If a codec is specified by using this
command and a phone does not support the preferred codec, then the phone will use the global codec as
specified by using the codec command in telephony-service configuration mode or if the global codec
is not supported, G.711 micro-law.
For calls to other phones in the same Cisco Unified CME system, an IP phone that is configured to use
G.729 will always have its calls set up to use G.729. If the phone participates in a call on a line that is
shared with a phone that is configured for G.729 or is paged together with another phone that is
configured for G.729, it must use G.729.
When you use the codec command without the dspfarm-assist keyword, you affect only calls between
two phones on the Cisco Unified CME router (such as between an IP phone and another IP phone or
between an IP phone and a FXS analog phone). The command has no effect on a call directed through a
VoIP dial peer unless you use the dspfarm-assist keyword.
When you use the g729r8 keyword to select the G.729r8 codec for the RTP segment between the IP
phone and the Cisco Unified CME router and you also use the dspfarm-assist keyword, the router
attempts to use DSP-farm resources in the following way: If the IP phone is in a VoIP call (H.323 or SIP)
or a Cisco Unified CME conference in which the codec must be set to G.711, the router uses configured
DSP-farm resources to attempt to return the segment between the phone and the Cisco Unified CME
router to G.729. Adequate DSP resources must be appropriately configured separately.
f the dspfarm-assist keyword is configured for a phone and a DSP resource is not available when needed
for transcoding, a phone registered to the local Cisco Unified CME router will use G.711 instead of
G.729r8. This is not true for non-SCCP call legs; if no DSP resource is available for the transcoding
required for a conference, for example, the conference will not be created.
It is recommended that the dspfarm-assist keyword be used sparingly and only when absolutely
required for bandwidth savings or when you know the phone will have few calls that require a G.711
codec.
You should consider your options carefully when deciding to use the dspfarm-assist keyword with the
codec command. The benefit is that it allows calls to use the G.729r8 codec on the call leg between the
IP phone and the Cisco Unified CME router, which saves network bandwidth. The disadvantage is that
for situations requiring G.711 codecs, such as conferencing and Cisco Unity Express, DSP resources that
can be scarce will be used to transcode the call, and delay will be introduced while voice is shuttled to
and from the DSP. In addition, the overuse of this feature can mask configuration errors in the codec
selection mechanisms involving dial peers and codec lists.
For information about configuring DSP-farm resources, see the Cisco Unified CME Administrator
Guide.
Note The dspfarm-assist keyword is ignored if the SCCP endpoint type is ATA, VG224, or VG248.
This command can also be configured in ephone-template configuration mode. If you use an ephone
template to apply a command to a phone and you also use the same command in ephone configuration
mode for the same phone, the value that you set in ephone configuration mode has priority.
Examples The following example selects the G.729 codec with DSP farm assist for calls that are being configured
for ephone 25:
ephone 25
button 1:37
codec g729r8 dspfarm-assist

Cisco Unified CME Commands: C
codec (ephone)
207
Cisco Unified CME Command Reference
OL-10894-01
The following example uses ephone template 1 to apply the G.729 codec preference to ephone 25:
ephone-template 1
codec g729r8
ephone 25
button 1:37
ephone-template 1

Related Commands Command Description
dspfarm (dspfarm) Enables digital-signal-processor (DSP) farm service
dsp services dspfarm Specifies the NM-HDV or NM-HDV-FARM on which DSP-farm services
are to be enabled.
dspfarm transcoder
maximum sessions
Specifies the maximum number of transcoding sessions to be supported by
a DSP farm.
show dspfarm Displays summary information about DSP resources.
Cisco Unified CME Commands: C
codec (telephony-service)
208
Cisco Unified CME Command Reference
OL-10894-01
codec (telephony-service)
To select a default codec for SCCP IP phones in Cisco Unified CME, use the codec command in
telephony-service configuration mode. To disable the codec, use the no form of this command.
codec {g711-ulaw | g722-64k}
no codec
Syntax Description
Command Default The default is G.711 micro-law.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command can be used to help save network bandwidth for a remote IP phone.
The G.722-64K codec is supported on certain phones only, such as the Cisco Unified IP Phone 7906G,
7911G, 7941G-GE, 7942G, 7945G, 7961G-GE, 7962G, 7965G, and 7975G. Check your phone
documentation to make sure your phones support the G.722-64K codec.
The telephone firmware version on a Cisco Unified IP phone must support the specified codec. If this
command is configured and a phone does not support the specified codec, the default codec for that
phone is G.711 micro-law.
Examples The following example shows how to configure a G.722-64K codec in telephony-service configuration
mode:
Router(config)# telephony-service
Router(config-telephony)# codec g722r64
Router(config-telephony)# service phone g722CodecSupport 2
Router(config-telephony)#
Related Commands
g711-ulaw Preferred codec: G.711 micro-law.
g722-64k Preferred codec: G.722 64K bps.
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 integrated into Cisco IOS
Release 12.4(20)T.
Command Description
service phone Modifies VendorConfig parameters in configuration files for IP phones.
Cisco Unified CME Commands: C
codec (voice register pool)
209
Cisco Unified CME Command Reference
OL-10894-01
codec (voice register pool)
To specify the codec to be used when setting up a call for a SIP phone or group of SIP phones in
Cisco Unified CME or Cisco Unified SIP SRST, use the codec command in voice register pool
configuration mode. To disable a specified codec, use the no form of this command.
codec codec-type [bytes]
no codec
Syntax Description
Command Default Default is G.729 8K bps.
Command Modes Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines This command changes the automatically selected codec for the dial peer that is dynamically created
when the SIP phone registers from the default (G.729) to the specified codec.
This command affects calls between two phones on the same Cisco Unified CME or Cisco Unified SRST
router, such as between an IP phone and another IP phone or between an IP phone and an FXS analog
phone.
If codec values for the dial peers of a connection do not match, the call fails. For example, the default
codec for the POTS dial peer for an SCCP phone is G.711 and the default codec for a VoIP dial peer for
a SIP phone is G.729. If neither the SCCP phone nor the SIP phone has been specifically configured to
change the codec, calls between the two IP phones on the same router will produce a busy signal caused
codec-type Preferred codec; values are as follows:
• g711alaw—G.711 A–law 64K bps.
• g711ulaw—G.711 micro–law 64K bps.
• g722r64—G.722-64K at 64K bps.
• g729r8—G.729 8K bps (default).
• ilbc—internet Low Bitrate Codec (iLBC) at 13,330 bps or 15,200 bps.
bytes (Optional) Specifies the number of bytes in the voice payload of each frame.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
12.4(15)XZ Cisco CME 4.3
Cisco Unified SIP SRST 4.3
The g722r64 and ilbc keywords were added.
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.
Cisco Unified CME Commands: C
codec (voice register pool)
210
Cisco Unified CME Command Reference
OL-10894-01
by the mismatched default codecs. For calls to other phones on the same Cisco router, a SIP phone that
is configured to use G.711 will always have its calls set up to use G.711. If the phone participates in a
call on a line that is shared with a phone that is configured for G.711, it must use G.711.
For calls to external phones; that is, phones that are not in the same Cisco Unified CME (such as VoIP
calls), the codec is negotiated based on the protocol that is used for the call (such as H.323). The
Cisco Unified CME plays no part in the negotiation.
This command sets the codec configuration for an individual phone and overrides any previously
configured codec selection set with the voice-class codec command or the codec (telephony-service)
command.
Note Configure the id (voice register pool) command before any other voice register pool commands. The id
command identifies a locally available individual SIP phone or set of SIP phones.
Examples The following example shows how to set the codec to g711 for a SIP phone in pool 1:
Router(config)# voice register pool 1
Router(config-register-pool)# codec g711ulaw
.
.
.

The following partial sample from the show voice register pool command shows the configuration for
voice register pool 1:
pool tag 1
Config
MAC address is 0012.DABF.26BE
Type is 7960
Number list 1: dn 1
Proxy Ip address is 0.0.0.0
Codec is g711ulaw
...
Dialpeers created
dial-peer voice 4003 voip
destination-pattern 6667
session target ipv
session protocol sip2v
codec g711ulaw

Related Commands Command Description
codec
(telephony-service)
Specifies preferred codec for calls through Cisco Unified CME.
id (voice register pool) Explicitly identifies a locally available individual SIP phone, or with
Cisco Unified SIP SRST, a set of SIP phones.
show voice register
dial-peer
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.
voice-class codec Assigns a previously configured codec selection preference list.
Cisco Unified CME Commands: C
conference (ephone-dn)
211
Cisco Unified CME Command Reference
OL-10894-01
conference (ephone-dn)
To configure a conference associated with a directory number, use the conference command in
ephone-dn configuration mode. To disable a conference associated with a directory number, use the no
form of this command.
conference {ad-hoc | meetme}
no conference {ad-hoc | meetme}
Syntax Description
Command Default No conference is associated with the directory number.
Command Modes Ephone-dn configuration (config-ephone-dn)
Command History
Usage Guidelines Ad hoc conferences are those which begin as a call between the conference creator and another party.
The creator then calls other parties and adds them to the original call creating a conference.
Meet-me conferences have a designated meet-me telephone or extension number that all parties call to
join the conference. The conference creator initiates the meet-me conference by pressing the MeetMe
soft key, then dialing the meet-me number. Other parties join the conference by dialing the meet-me
number.
Use the ephone-dn command to configure enough extensions for your conference needs. Each extension
can handle two conference parties if the dual-line keyword is used with the ephone-dn command as
shown in the example below. Use the show ephone-dn command to display phone information for the
extension.
Examples The following example configures extension 9001 as a four-party meet-me conference number.
Router(config)# ephone-dn 1 dual-line
Router(config-ephone-dn)# number 9001
Router(config-ephone-dn)# conference meetme
Router(config)# ephone-dn 2 dual-line
Router(config-ephone-dn)# number 9001
Router(config-ephone-dn)# conference meetme

You must configure additional directory numbers to add more parties to the conference.
ad-hoc Configures ad hoc conferences.
meetme Configures meet-me conferences.
Cisco IOS 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
Cisco Unified CME Commands: C
conference (ephone-dn)
212
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
show ephone-dn Displays phone information for specified dn-tag or for all dn-tags.
Cisco Unified CME Commands: C
conference (voice register template)
213
Cisco Unified CME Command Reference
OL-10894-01
conference (voice register template)
To enable the soft key for conference in a SIP phone template, use the conference command in voice
register template configuration mode. To disable the soft key, use the no form of this command.
conference
no conference
Syntax Description This command has no arguments or keywords.
Command Default Soft key for conference is enabled.
Command Modes Voice register template configuration (config-register-temp)
Command History
Usage Guidelines This command enables a soft key for conference in the specified template which can then be applied to
SIP phones. The conference soft key is enabled by default. To disable the conference soft key, use the
no conference command. To apply a template to a SIP phone, use the template command in voice
register pool configuration mode.
Examples The following example shows how to disable the conference soft key in template 1:
Router(config)# voice register template 1
Router(config-register-temp)# no conference

Related Commands
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
template (voice register
pool)
Applies a template to a SIP phone.
transfer-attended
(voice register
template)
Enables a soft key for attended transfer in a SIP phone template.
transfer-blind (voice
register template)
Enables a soft key for blind transfer in a SIP phone template.
voice register pool Enters voice register pool configuration mode for SIP phones.
Cisco Unified CME Commands: C
conference add-mode
214
Cisco Unified CME Command Reference
OL-10894-01
conference add-mode
To configure the mode for adding parties to ad hoc hardware conferences, use the conference add-mode
command in ephone or ephone-template configuration mode. To return to the default, use the no form of
this command.
conference add-mode [creator]
no conference add-mode [creator]
Syntax Description
Command Default Any party can add other parties provided the creator remains in the conference.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines For more control of conference participation, use this command to specify that only the creator can add
new parties. This configuration ensures that no one can add parties to the conference without the
creator’s knowledge.
Use this command to configure an ephone directly in ephone configuration mode, or use it to configure
an ephone template in ephone-template configuration mode. Use the ephone-template command in
ephone configuration mode to apply the ephone template to one or more ephones. Use the show
telephony-service ephone command to display the add and drop modes for the ephone. Use the show
telephony-service ephone-template command to display the ephone template.
Examples The following example configures ad hoc hardware conferences so that only the creator can add
participants.
Router(config)# ephone 1
Router(config-ephone)# conference add-mode creator

creator Specifies that only the creator can add parties.
Cisco IOS 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.
Cisco Unified CME Commands: C
conference add-mode
215
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
ephone-template
(ephone)
Applies an ephone template to an ephone.
show telephony-service
ephone
Displays configuration for the Cisco IP phones.
show telephony-service
ephone-template
Displays the contents of ephone-templates.
Cisco Unified CME Commands: C
conference admin
216
Cisco Unified CME Command Reference
OL-10894-01
conference admin
To configure the ephone as the ad hoc and meet-me hardware conference administrator, use the
conference admin command in ephone or ephone-template configuration mode. To return to the
defaults, use the no form of this command.
conference admin
no conference admin
Syntax Description This command has no arguments or keywords.
Command Default This ephone is not the ad hoc and meet-me hardware conference administrator.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines Use this command to configure an 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
The administrator can control the use of conference bridges by enforcing time limits and making sure
conference bridges are available for scheduled meetings.
Use this command to configure an ephone directly in ephone configuration mode, or use it to configure
an ephone template in ephone-template configuration mode. Use the ephone-template command in
ephone configuration mode to apply the ephone template to one or more ephones. Use the show
telephony-service ephone command to display the add and drop modes for the ephone. Use the show
telephony-service ephone-template command to display the ephone template.
Examples The following example configures ephone 1 as the ad hoc and meet-me hardware conference
administrator.
Router(config)# ephone 1
Router(config-ephone)# conference admin

Cisco IOS 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
Cisco Unified CME Commands: C
conference admin
217
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
ephone-template
(ephone)
Applies an ephone template to an ephone.
show telephony-service
ephone
Displays configuration for the Cisco IP phones.
show telephony-service
ephone-template
Displays the contents of ephone-templates.
Cisco Unified CME Commands: C
conference drop-mode
218
Cisco Unified CME Command Reference
OL-10894-01
conference drop-mode
To configure the mode for terminating ad hoc hardware conferences when parties drop out, use the
conference drop-mode command in ephone or ephone-template configuration mode. To return to the
default, use the no form of this command.
conference drop-mode [creator | local]
no conference drop-mode [creator | local]
Syntax Description
Command Default The conference is not dropped, regardless of whether the creator hangs up, provided three parties remain
in the conference.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines For more control of conference participation, use this command to specify that the conference drops
when the creator hangs up (see the example). This configuration ensures that the conference cannot
continue without the creator’s presence.
Use this command to configure an ephone directly in ephone configuration mode, or use it to configure
an ephone template in ephone-template configuration mode. Use the ephone-template command in
ephone configuration mode to apply the ephone template to one or more ephones. Use the show
telephony-service ephone command to display the add and drop modes for the ephone. Use the show
telephony-service ephone-template command to display the ephone template.
Examples The following example configures ad hoc hardware conferences so that only the creator can add
participants and the active conference terminates when the creator hangs up.
Router(config)# ephone 1
Router(config-ephone)# conference drop-mode creator
creator Specifies that the active conference terminates when the creator hangs up.
local Specifies that the active conference terminates when the last local party in
the conference hangs up or drops out of the conference.
Cisco IOS 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
Cisco Unified CME Commands: C
conference drop-mode
219
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
ephone-template
(ephone)
Applies an ephone template to an ephone.
show telephony-service
ephone
Displays configuration for the Cisco IP phones.
show telephony-service
ephone-template
Displays the contents of ephone-templates.
Cisco Unified CME Commands: C
conference hardware
220
Cisco Unified CME Command Reference
OL-10894-01
conference hardware
To configure a Cisco Unified CallManager Express system for hardware conferencing only, use the
conference hardware command in telephony-service configuration mode. To return to the default,
three-party software conferencing, use the no form of this command.
conference hardware
no conference hardware
Syntax Description This command has no arguments or keywords.
Command Default Three-party ad hoc software conferencing.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Software conferencing allows a maximum of three parties in a conference. Use this command to take
advantage of DSP farm resources for hardware conferencing which allows ad hoc conferences with more
than three parties.
If you need ad hoc hardware conferences, you must use this command to configure DSP farm hardware
conferencing. You can configure other conferencing features using the conference-join custom-cptone,
conference-leave custom-cptone, and maximum conference-party commands in DSP farm profile
configuration mode. Use the show dspfarm profile command to display the DSP farm profile.
Examples The following example configures hardware conferencing as the default for ad hoc conferences on this
Cisco Unified CallManager Express system:
Router(config)# telephony-service
Router(config-telephony)# conference hardware

Related Commands
Cisco IOS 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
Command Description
conference-join
custom-cptone
Associates a custom call-progress tone to indicate joining a conference with
a DSP farm profile.
conference-leave
custom-cptone
Associates a custom call-progress tone to indicate leaving a conference with
a DSP farm profile.
Cisco Unified CME Commands: C
conference hardware
221
Cisco Unified CME Command Reference
OL-10894-01
maximum
conference-party
Configures the maximum number of conference participants allowed in
each conference.
show dspfarm profile Display configured digital signal processor (DSP) farm profile information.
Command Description
Cisco Unified CME Commands: C
cor (ephone-dn)
222
Cisco Unified CME Command Reference
OL-10894-01
cor (ephone-dn)
This command is now documented as the corlist command. For complete command information, see the
corlist command page.
Cisco Unified CME Commands: C
cor (voice register pool)
223
Cisco Unified CME Command Reference
OL-10894-01
cor (voice register pool)
To configure a class of restriction (COR) on the VoIP dial peers associated with directory numbers, use
the cor command in voice register pool configuration mode. To disable a COR associated with directory
numbers, use the no form of this command.
cor {incoming | outgoing} cor-list-name {cor-list-number starting-number [- ending-number] |
default}
no cor {incoming | outgoing} cor-list-name {cor-list-number starting-number [- ending-number] |
default}
Syntax Description
Command Default COR is not configured on VoIP dial peers.
Command Modes Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines The cor command sets the dial-peer COR parameter for dynamically created VoIP dial peers. A
list-based mechanism assigns COR parameters to specific set of number ranges. The COR functionality
provides the ability to deny certain call attempts on the basis of the incoming and outgoing class of
restrictions provisioned on the dial peers. This functionality provides flexibility in network design,
allows users to block calls (for example, calls to 900 numbers), and applies different restrictions to call
attempts from different originators.
COR specifies which incoming dial peer can use which outgoing dial peer to make a call. Each dial peer
can be provisioned with an incoming and an outgoing COR list.
incoming COR list to be used by incoming dial peers.
outgoing COR list to be used by outgoing dial peers.
cor-list-name COR list name.
cor-list-number COR list identifier.
starting-number Start of a directory number range, if an ending number is included. Can also
be a standalone number.
- (Optional) Indicator that a full range is configured.
ending-number (Optional) End of a directory number range.
default Instructs the COR list to assume behavior according to a predefined default
COR list.
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 CallManager
Express (Cisco CME).
Cisco Unified CME Commands: C
cor (voice register pool)
224
Cisco Unified CME Command Reference
OL-10894-01
A default COR is assigned to the directory numbers that do not match any COR list number or number
range. During Cisco Unified Session Initiation Protocol (SIP) Survivable Remote Site Telephony
(SRST) registration, a dial peer is created and that dial peer includes a default COR value. The cor
command allows you to change the automatically selected default.
In dial-peer configuration mode, build your COR list and add members. Then in voice register pool
configuration mode, use the cor command to apply the name of the dial-peer COR list.
You can have up to four COR lists for the Cisco Unified SIP SRST configuration, comprised of incoming
or outgoing dial peers. The first four COR lists are applied to a range of phone numbers. The phone
numbers that do not have a COR list configuration are assigned to the default COR list, providing that a
default COR list has been defined.
Note Configure the id (voice register pool) command before any other voice register pool commands,
including the cor command. The id command identifies a locally available individual Cisco SIP IP phone
or set of Cisco SIP IP phones.
Examples The following is sample output from the show running-config command:
..
voice register pool 1
id mac 0030.94C2.A22A
preference 5
cor incoming call91 1 91011
translate-outgoing called 1
proxy 10.2.161.187 preference 1 monitor probe icmp-ping
alias 1 94... to 91011 preference 8
voice-class codec 1
.
.
.
dial-peer cor custom
name 95
name 94
name 91
!
dial-peer cor list call91
member 91
!
dial-peer voice 91500 pots
corlist incoming call91
corlist outgoing call91
destination-pattern 91500
port 1/0/0
.
.
.
Related Commands Command Description
dial-peer cor custom Specifies that named CORs apply to dial peers.
dial-peer cor list Defines a COR list name.
id (voice register pool) Explicitly identifies a locally available individual Cisco SIP IP phone, or
when running Cisco Unified SIP SRST, set of Cisco SIP IP phones.
Cisco Unified CME Commands: C
cor (voice register pool)
225
Cisco Unified CME Command Reference
OL-10894-01
member (dial-peer cor
list)
Adds a member to a dial-peer COR list.
name (dial-peer
custom cor)
Provides a name for a custom COR.
show dial-peer voice Displays information for voice dial peers.
Command Description
Cisco Unified CME Commands: C
corlist
226
Cisco Unified CME Command Reference
OL-10894-01
corlist
This command was previously documented as the cor command.
To apply a class of restriction (COR) to the dial peers associated with a Cisco CME extension
(ephone-dn), use the corlist command in ephone-dn configuration mode. To disable the COR associated
with an extension, use the no form of this command.
corlist {incoming | outgoing} corlist-name
no corlist {incoming | outgoing}
Syntax Description
Command Default No COR is used by the dial peers associated with the extension that is being configured.
Command Modes Ephone-dn configuration (config-ephone-dn)
Command History
Usage Guidelines COR is used to specify which incoming ephone-dn dial peer can use which outgoing ephone-dn dial peer
to make a call. COR denies certain call attempts on the basis of the incoming and outgoing class of
restrictions that have been provisioned on the dial peers. This functionality provides flexibility in
network design, allows administrators to block calls (for example, calls to 900 numbers), and applies
different restrictions to call attempts from different originators.
Each dial peer can be provisioned with an incoming and an outgoing COR list.
The corlist incoming and corlist outgoing commands in dial-peer configuration mode perform these
functions for dial peers that are not associated with ephone-dns. The dial-peer cor list and member
commands define the sets of capabilities, or COR lists, that are referred to in the corlist commands.
incoming Specifies a COR list to be used by incoming dial peers.
outgoing Specifies a COR list to be used by outgoing dial peers.
corlist-name COR list name.
Cisco IOS Release Cisco Product Modification
12.2(2)XT Cisco ITS 2.0 This command was introduced on the Cisco 1750,
Cisco 1751, Cisco 2600 series, Cisco 3600 series,
and Cisco IAD2420 series.
12.2(8)T Cisco ITS 2.0 This command was integrated into Cisco IOS
Release 12.2(8)T and implemented on the
Cisco 3725 and Cisco 3745.
12.2(8)T1 Cisco ITS 2.0 This command was implemented on the
Cisco 2600-XM and Cisco 2691.
12.2(11)T Cisco ITS 2.01 This command was implemented on the
Cisco 1760.
Cisco Unified CME Commands: C
corlist
227
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to set a COR parameter for incoming calls to dial peers associated
with the extension that has the dn-tag 1:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# corlist incoming corlist1

Related Commands Command Description
corlist incoming Specifies the COR list to be used when a specified dial peer acts as the
incoming dial peer.
corlist outgoing Specifies the COR list to be used by an outgoing dial peer.
dial-peer cor list Defines a COR list name.
Cisco Unified CME Commands: C
create cnf-files
228
Cisco Unified CME Command Reference
OL-10894-01
create cnf-files
To build the eXtensible Markup Language (XML) configuration files that are required for IP phones in
Cisco Unified CME, use the create cnf-files command in telephony-service configuration mode. To
remove the configuration files and disable the automatic generation of configuration files, use the no
form of this command.
create cnf-files
no create cnf-files
Syntax Description This command has no arguments or keywords.
Command Default Required XML configuration files are not built.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Use this command to generate the XML configuration files used for provisioning SCCP phones and write
the files to the location specified with the cnf-file location command.
Examples The following example builds the necessary XML configuration files on the Cisco Unified CME router:
Router(config)# telephony-service
Router(config-telephony)# create cnf-files

Related Commands
Cisco IOS Release Cisco Product Modification
12.2(11)YT Cisco ITS 2.1 This command was introduced.
12.2(15)T Cisco ITS 2.1 This command was integrated into Cisco IOS
Release 12.2(15)T.
12.4(4)XC Cisco Unified CME 4.0 This command was modified to interact with the
cnf-file command and the cnf-file location
command.
12.4(9)T Cisco Unified CME 4.0 Modifications to this command for interacting
with the cnf-file command and the cnf-file
location command were integrated into Cisco IOS
Release 12.4(9)T.
Command Description
cnf-file Specifies the type of configuration file to be created.
cnf-file location Specifies a storage location for phone configuration files
Cisco Unified CME Commands: C
create cnf-files (voice-gateway)
229
Cisco Unified CME Command Reference
OL-10894-01
create cnf-files (voice-gateway)
To generate the eXtensible Markup Language (XML) configuration files that are required to
autoconfigure the Cisco voice gateway, use the create cnf-files command in voice-gateway
configuration mode. To disable the generating of configuration files, use the no form of this command.
create cnf-files
no create cnf-files
Syntax Description This command has no arguments or keywords.
Command Default Required XML configuration files are not built.
Command Modes Voice-gateway configuration (config-voice-gateway)
Command History
Usage Guidelines Cisco Unified CME writes the XML files generated by this command to the location specified with the
cnf-file location command, or to the default location in system:/its/. The voice gateway downloads its
configuration file from Cisco Unified CME when you run the autoconfiguration process on the voice
gateway.
Examples The following example shows that the gateway configuration files are generated by Cisco Unified CME:
voice-gateway system 1
network-locale FR
type VG224
mac-address 001F.A30F.8331
voice-port 0-23
create cnf-files
Related Commands
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.
Command Description
cnf-file location Specifies a storage location for phone configuration files.
reset (voice-gateway) Performs a complete reboot of all analog phones associated with the voice
gateway and registered to Cisco Unified CME.
restart (voice-gateway) Performs a fast restart of all analog phones associated with the voice
gateway and registered to Cisco Unified CME.
Cisco Unified CME Commands: C
create profile (voice register global)
230
Cisco Unified CME Command Reference
OL-10894-01
create profile (voice register global)
To generate the configuration profile files required for SIP phones, use the create profile command in
voice register global configuration mode. To return to the default, use the no form of this command.
create profile
no create profile
Syntax Description This command has no arguments or keywords.
Defaults Configuration files are not generated.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command generates the configuration files used for provisioning SIP phones and writes the files to
the location specified with the tftp-path command.
Examples The following example shows how to create the configuration profile:
Router(config)# voice register global
Router(config-register-global)# mode cme
Router(config-register-global)# create profile

Related Commands
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
file text (voice register
global)
Generates ASCII text files for SIP phones.
mode (voice register
global)
Enables the mode for provisioning SIP phones in a Cisco CallManager
Express (Cisco CME) system.
reset (voice register
global)
Performs a complete reboot of all SIP phones associated with a Cisco CME
router.
source-address (voice
register global)
Identifies the IP address and port through which SIP phones communicate
with a Cisco CME router.
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.
Cisco Unified CME Commands: C
credentials
231
Cisco Unified CME Command Reference
OL-10894-01
credentials
To enter credentials configuration mode to configure a certificate for a Cisco Unified CME CTL
provider or for Cisco Unified SRST router communication to Cisco Unified CallManager, use the
credentials command in global configuration mode. To set all commands in credentials configuration
mode to the default of nonsecure, use the no form of this command.
credentials
no credentials
Syntax Description This command has no arguments or keywords.
Command Default Credentials are not provided.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used to configure credentials service for Cisco Unified CME and Cisco Unified SRST.
Cisco Unified CME
This command is used with Cisco Unified CME phone authentication to configure a CTL provider on
each Cisco Unified CME router on which the CTL client is not running. That is, if there is a primary and
a secondary Cisco Unified CME router and the CTL client is running on the primary router, a CTL
provider must be configured on the secondary router, and vice versa. If the CTL client is running on a
router that is not a Cisco Unified CME router, CTL providers must be configured on all
Cisco Unified CME routers.
Credentials service for Cisco Unified CME runs on default port 2444.
Cisco Unified SRST
The credential server provides certificates to any device that requests a certificate. The credentials server
does not request any data from a client; thus no authentication is necessary. When the client,
Cisco Unified CallManager, requests a certificate, the credentials server provides the certificate.
Cisco Unified CallManager exports the certificate to the phone, and the Cisco Unified IP phone holds
the SRST router certificate in its configuration file. The device certificate for secure SRST routers is
placed in the configuration file of the Cisco Unified IP phone because the entry limit in the certificate
trust list (CTL) of Cisco Unified CallManager is 32.
Cisco IOS Release Cisco Product Modification
12.3(14)T Cisco SRST 3.3 This command was introduced for Cisco SRST.
12.4(4)XC Cisco Unified CME 4.0 This command was introduced for
Cisco Unified CME.
12.4(9)T Cisco Unified CME 4.0 This command for Cisco Unified CME was
integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: C
credentials
232
Cisco Unified CME Command Reference
OL-10894-01
Credentials service for SRST runs on default port 2445. Cisco Unified CallManager connects to port
2445 on the secure SRST router and retrieves the secure SRST device certificate during the TLS
handshake.
Activate this command on all SRST routers.
Caution For security reasons, credentials service should be deactivated on all SRST routers after provisioning to
Cisco Unified CallManager is completed.
Examples Cisco Unified CME
The following example configures a CTL provider on the Cisco Unified CME router with the IP address
172.19.245.1. CTL providers must be configured on all Cisco Unified CME routers on which the CTL
client is not running.
Router(config)# credentials
Router(config-credentials)# ip source-address 172.19.245.1 port 2444
Router(config-credentials)# trustpoint cmeca
Router(config-credentials)# ctl-service admin user4 secret 0 c89L8o

Cisco Unified SRST
The following example enters credentials configuration mode and sets the IP source address and the
trustpoint:
Router(config)# credentials
Router(config-credentials)# ip source-address 10.6.21.4 port 2445
Router(config-credentials)# trustpoint srstca

Related Commands Command Description
ctl-service admin Specifies a user name and password to authenticate the CTL client during
the CTL protocol.
debug credentials Sets debugging on the credentials service that runs between a
Cisco Unified CME CTL provider the CTL client or between an SRST
router and Cisco Unified CallManager.
ip source-address
(credentials)
Enables the Cisco Unified CME or SRST router to receive messages
through the specified IP address and port.
show credentials Displays the credentials settings on a Cisco Unified CME or SRST
router.
trustpoint (credentials) Specifies the name of the trustpoint to be associated with a
Cisco Unified CME CTL provider certificate or with an SRST router
certificate.
Cisco Unified CME Commands: C
cti csta mode basic
233
Cisco Unified CME Command Reference
OL-10894-01
cti csta mode basic
To set the CTI interface in Cisco Unified CME into basic mode, use the cti csta mode basic command
in voice-service configuration mode. To return to default, use the no form of this command.
cti csta mode basic
no cti csta mode basic
Syntax Description This command has no arguments or keywords.
Command Default CTI interface is in advanced mode.
Command Modes Voice-service configuration (config-voi-serv)
Command History
Usage Guidelines This command supresses all enhanced extensions/features, such as shared line and shared media, in a
CTI message from Cisco Unified CME.
This command is required if the computer-based CSTA client application that is interacting with
Cisco Unified CME is a Microsoft Office Communicator (MOC) client.
Examples The following example shows a voice-service configuration with this command enabled:
!
voice service voip
no cti shutdown
cti csta mode basic
!

Related Commands
Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
cti shutdown Disables CTI integration.
Cisco Unified CME Commands: C
cti message device-id suppress-conversion
234
Cisco Unified CME Command Reference
OL-10894-01
cti message device-id suppress-conversion
To suppress the conversion or promotion of all extension numbers except the primary number in a CTI
message, use the cti message device-id suppress-conversion command in voice-service configuration
mode. To return to default, use the no form of this command.
cti message device-id suppress-conversion
no cti message device-id suppress-conversion
Syntax Description This command has no arguments or keywords.
Command Default All SCCP extension numbers are converted or promoted in CTI messages.
Command Modes Voice-service configuration (config-voi-serv)
Command History
Usage Guidelines This command specifies that only the requested (primary) extension number is converted or promoted in
the outgoing CTI message when an expanded number is presented in a RequestSystemStatus from a
CSTAclient application. Use this command to suppress the conversion or promotion of all secondary
numbers in a CTI message.
By default, Cisco Unified CME converts or promotes all SCCP primary and secondary extension
numbers when reporting events.
Examples The following example shows the voice-service configuration with this command enabled:
!
voice service voip
no cti shutdown
cti csta mode basic
cti message device-id suppress-conversion

Related Commands
Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
cti shutdown Disables CTI integration.
Cisco Unified CME Commands: C
cti notify
235
Cisco Unified CME Command Reference
OL-10894-01
cti notify
To force an ephone-dn into a constant “up” state, use the cti notify command in ephone-dn or
ephone-dn-template configuration mode. To return to default, use the no form of this command.
cti notify
no cti notify
Syntax Description This command has no arguments or keywords.
Command Default Cisco Unified CME cannot send notifications to the ephone-dn because a CTI session cannot be
established.
Command Modes Ephone-dn configuration (config-ephone-dn)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines This command forces an ephone-dn into a constant “up” state.
Use this command to permit a CTI session to be established with a directory number that is not
associated with a physical device, allowing Cisco Unified CME to send notifications to the directory
number. If a directory number is not associated to an ephone configuration that includes the button
command, a static fwd is applied to the directory number and all incoming calls are forwarded to another
directory number.
If you use an ephone-dn template to apply this command to a directory number and you also use this
command in ephone-dn configuration mode for the same directory number, the value that you set in
ephone-dn configuration mode has priority.
Examples The following example shows the configuration for ephone-dn 4 including this command. A CTI session
can be established for this directory number (204) even though the number is not associated with an
ephone configuration because this directory number is always “up.”
!
ephone-dn 4
number 204
cti notify
cti watch
!
!
ephone 1
mac-address 001E.4A34.A35F
type 7961
Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified CME Commands: C
cti notify
236
Cisco Unified CME Command Reference
OL-10894-01
button 1:1
!
!
!
ephone 2
mac-address 000F.8FC7.B681
type 7960
button 1:2
!
!
!
ephone 3
mac-address 0019.E7FF.1E30
type 7961
logout-profile 1
!

The following example shows how to create the same configuration for ephone-dn 4 using this command
in ephone-dn template configuration mode and then applying the template to the directory number:
ephone-dn-template 15
cti notify
cti watch
ephone-dn 4
number 204
ephone-dn-template 15
Related Commands Command Description
ephone-dn-template
(ephone-dn)
Applies an ephone-dn template to an ephone-dn.
Cisco Unified CME Commands: C
cti shutdown
237
Cisco Unified CME Command Reference
OL-10894-01
cti shutdown
To disable all CTI sessions after the CTI interface in Cisco Unified CME is enabled, use the cti
shutdown command in voice-service configuration mode. To enable the CTI interface, use the no form
of this command.
cti shutdown
no cti shutdown
Syntax Description This command has no arguments or keywords.
Command Default CTI interface in Cisco Unified CME is disabled.
Command Modes Voice-service configuration (config-voi-serv)
Command History
Usage Guidelines This command disables all CTI sessions and returns the interface to its initial state.
The no form of this command is required to enable a CSTA client application to control/monitor SCCP
devices registered in Cisco Unified CME over the CTI interface in Cisco Unified CME.
To clear a specific session, use the clear cti session command.
Examples The following example shows the voice-service configuration in which the CTI interface in
Cisco Unified CME is enabled by using the no form of this command:
voice service voip
allow-connections sip to sip
gcid
no supplementary-service sip moved-temporarily
no supplementary-service sip refer
no cti shutdown
cti mode basic
Related Commands
Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
clear cti session Gracefully dissassociates a connection between a CSTA client application
and Cisco Unified CME.
Cisco Unified CME Commands: C
cti watch
238
Cisco Unified CME Command Reference
OL-10894-01
cti watch
To allow a CSTA client application to monitor and control a directory number in Cisco Unified CME,
use the cti watch command in ephone-dn or ephone-dn-template configuration mode. To return to
default, use the no form of this command.
cti watch
no cti watch
Syntax Description This command has no arguments or keywords.
Command Default A CSTA client application cannot use the CTI interface to montitor and control an ephone-dn in
Cisco Unified CME.
Command Modes Ephone-dn configuration (config-ephone-dn)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines This command enables a CSTA client application to monitor and control a directory number in
Cisco Unified CME.
If you use an ephone-dn template to apply this command to a directory number and you also use this
command in ephone-dn configuration mode for the same directory number, the value that you set in
ephone-dn configuration mode has priority.
Examples The following example shows the configuration for ephone-dn 4 with this command configured. The
CSTA application can montior and control the directory number (204).
!
ephone-dn 4
number 204
cti notify
cti watch

The following example shows how to create the same configuration for ephone-dn 4 using this command
in ephone-dn template configuration mode and applying the template to the directory number:
ephone-dn-template 15
cti notify
cti watch
Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified CME Commands: C
cti watch
239
Cisco Unified CME Command Reference
OL-10894-01
ephone-dn 4
number 204
ephone-dn-template 15

Related Commands Command Description
ephone-dn-template
(ephone-dn)
Applies an ephone-dn template to an ephone-dn
Cisco Unified CME Commands: C
cti-aware
240
Cisco Unified CME Command Reference
OL-10894-01
cti-aware
To bind a session to the CTI subsystem, use the cti aware command in voice session-server
configuration mode. To return to default, use the no form of this command.
cti-aware
no cti-aware
Syntax Description This command has no keywords or arguments.
Command Default CTI-register heartbeat continues even after the CTI session is shutdown.
Command Modes Voice session-server configuration (config-register-fs)
Command History
Usage Guidelines This command causes the CSTA SIP keepalive response to stop if the CTI session between
Cisco Unified CME and the CSTA client application expires or is down for any reason. By default, the
CSTA SIP keepalive response continues even after the CTI session expires and the CSTA client
application is unaware that the CTI session is not operational.
Examples The following partial output shows the configuration for a session manager for a CSTA client application
in which this command is configured:
router# show running-configuration
.
.
.
voice register session-server 1
register-id app1
keepalive 360
cti-aware

Related Commands
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
keepalive (voice
register
session-server)
Duration for registration after which the registration expires unless the
feature server or application reregisters before the registration expiry.
register-id Creats an ID for explicitly identifying an external feature server or
application during Register requests
Cisco Unified CME Commands: C
ctl-client
241
Cisco Unified CME Command Reference
OL-10894-01
ctl-client
To enter CTL-client configuration mode to set parameters for the CTL client, use the ctl-client command
in global configuration mode. To return to the default, use the no form of this command.
ctl-client
no ctl-client
Syntax Description This command has no keywords or arguments.
Command Default No CTL-client parameters are set.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command is used with Cisco Unified CME phone authentication.
Examples The following example defines server IP addresses and trustpoints for the CAPF server, the
Cisco Unified CME router, and the TFTP server, as well as trustpoints for SAST1 and SAST2. It also
specifies that a new CTL file should be generated.
Router(config)# ctl-client
Router(config-ctl-client)# server capf 10.2.2.2 trustpoint capftrust
Router(config-ctl-client)# server cme 10.2.2.3 trustpoint cmetp
Router(config-ctl-client)# server tftp 10.2.2.4 trustpoint tftptp
Router(config-ctl-client)# sast1 trustpoint sast1tp
Router(config-ctl-client)# sast2 trustpoint sast2tp
Router(config-ctl-client)# regenerate

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.
Cisco Unified CME Commands: C
ctl-service admin
242
Cisco Unified CME Command Reference
OL-10894-01
ctl-service admin
To specify a user name and password to authenticate the client during the CTL protocol, use the
ctl-service admin command in credentials configuration mode. To return to the default, use the no form
of this command.
ctl-service admin username secret {0 | 1} password-string
no ctl-service admin
Syntax Description
Command Default No user name or password is defined for authentication.
Command Modes Credentials configuration (config-credentials)
Command History
Usage Guidelines This command is used with Cisco Unified CME phone authentication to define a user who will be used
to authenticate the CTL client with a CTL provider.
Examples The following example creates a CTL provider on a Cisco Unified CME router that is not running the
CTL client.
Router(config)# credentials
Router(config-credentials)# ip source-address 172.19.245.1 port 2444
Router(config-credentials)# trustpoint ctlpv
Router(config-credentials)# ctl-service admin user4 secret 0 c89L8o

username Defines the name that will be used to authenticate the client.
secret {0 | 1} Defines a character string for login authentication and whether it will be
encrypted when it is stored in the running configuration.
• 0—Not encrypted.
• 1—Encrypted using Message Digest 5 (MD5).
password-string Character string for login authentication
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.
Cisco Unified CME Commands: C
ctl-service admin
243
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
debug credentials Sets debugging on the credentials service that runs between a
Cisco Unified CME CTL provider and the CTL client or between an SRST
router and Cisco Unified CallManager.
show credentials Displays the credentials settings on a Cisco Unified CME or SRST router.
trustpoint
(credentials)
Specifies the name of the trustpoint to be associated with a
Cisco Unified CME CTL provider certificate or with an SRST router
certificate.
Cisco Unified CME Commands: C
ctl-service admin
244
Cisco Unified CME Command Reference
OL-10894-01
249
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: D
Revised: October 22, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified CME Commands: D
date-format (telephony-service)
250
Cisco Unified CME Command Reference
OL-10894-01
date-format (telephony-service)
To set the date display format on the Cisco IP phones in a Cisco CallManager Express (Cisco CME)
system, use the date-format command in telephony-service configuration mode. To display the date in
the default format, use the no form of this command.
date-format {dd-mm-yy | mm-dd-yy | yy-dd-mm | yy-mm-dd}
no date-format
Syntax Description
Command Default Def aul t i s mm-dd-yy.
Command Modes Telephony-service configuration (config-telephony)
Command History
Examples The following example sets the date format to day, month, and year, so that December 17, 2004 is
represented as 17-12-04.
Router(config)# telephony-service
Router(config-telephony)# date-format dd-mm-yy

dd-mm-yy
mm-dd-yy
yy-dd-mm
yy-mm-dd
Format in which dates are displayed on the IP phone:
• dd—Two-digit day.
• mm—Two-digit month.
• yy—Two-digit year.
Cisco IOS Release Cisco Product Modification
12.2(2)XT Cisco ITS 2.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.
Cisco Unified CME Commands: D
date-format (voice register global)
251
Cisco Unified CME Command Reference
OL-10894-01
date-format (voice register global)
To set the date display format on SIP phones directly connected in Cisco Unified CME, use the
date-format command in voice register global configuration mode. To display the date in the default
format, use the no form of this command.
date-format {d/m/y | m/d/y | y-d-m |y/d/m | y/m/d | yy-m-d}
no date-format
Syntax Description
Command Default Date is displayed as m/d/y.
Command Modes Voice register global configuration (config-register-global)
Command History
Examples The following example shows how to set the date format so that a date such as December 3, 2007 is
represented as 2007-12-03. By using the default configuration, this same date appears as 12/03/07.
Router(config)# voice register global
Router(config-register-global)# date-format yy-m-d

Related Commands
d/m/y
m/d/y
y-d-m
y/d/m
y/m/d
yy-m-d
Format in which dates are displayed on the SIP IP phone:
• d—Two-digit date of the month
• m—Two-digit month
• y—Two-digit year
• yy—Four-digit year
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
dst auto-adjust (voice
register global)
Enables automatic adjustment of daylight saving time on SIP phones.
time-format (voice
register global)
Selects a 12-hour clock or a 24-hour clock for the time display format on
SIP IP phones in Cisco Unified CME.
Cisco Unified CME Commands: D
default (voice hunt-group)
252
Cisco Unified CME Command Reference
OL-10894-01
default (voice hunt-group)
To set a command to its defaults values, use the default command in voice hunt-group configuration
mode.
default default-value
Syntax Description
Command Default There are no default behaviors or values.
Command Modes Voice hunt-group configuration (config-voi-hunt-group)
Command History
Usage Guidelines Use this command to configure the default value for a voice hunt group command.
The default command instructs the voice hunt group to use the default value of the specified command
whenever the hunt group is called. This has the same effect as using the no form of the specified
command, but the default command clearly specifies which commands are using their default values.
To use the default values for more than one command, enter each command on a separate line.
Examples The following example shows how to set the default values for two separate voice hunt-group
commands:
Router(config)# voice hunt-group 4 peer
Router(config-voi-hunt-group)# default hops
Router(config-voi-hunt-group)# default timeout

Related Commands
default-value One of the voice hunt group configuration commands. Valid choices are as
follows:
• hops (Peer or longest-idle voice hunt group only)
• preference
• timeout
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
voice hunt-group Defines a hunt group for SIP phones in Cisco Unified CME.
Cisco Unified CME Commands: D
description (ephone)
253
Cisco Unified CME Command Reference
OL-10894-01
description (ephone)
To provide ephone descriptions for network management systems using an eXtensible Markup Language
(XML) query, use the description command in ephone configuration mode. To remove a description,
use the no form of this command.
description string
no application
Syntax Description
Command Default No ephone description is configured.
Command Modes Ephone configuration (config-ephone)
Command History
Usage Guidelines The descriptions configured with this command will appear neither on phone displays nor in show
command output. Instead, they are sent to network management systems, such as CiscoView. Network
management systems obtain description command data by sending an XML ISgetDevice request to a
Cisco CME system. Cisco CME responds by sending ISDevDesc field data to the network management
system, which uses the data to perform such tasks as printing descriptions on screen.
Examples The following example provides a description for ephone 1:
Router(config)# ephone 1
Router(config-ephone) description S/N:SK09456FPH3, Location:SJ21- 2nd Floor E5-9, User:
Smith, John

string Allows for a maximum of 128 characters, including spaces. There are no
character restrictions.
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.
Cisco Unified CME Commands: D
description (ephone-dn and ephone-dn-template)
254
Cisco Unified CME Command Reference
OL-10894-01
description (ephone-dn and ephone-dn-template)
To display a custom text-string description in the header bar of all supported Cisco Unified IP phones,
use the description command in ephone-dn or ephone-dn-template configuration mode. To return to the
default, use the no form of this command.
description string
no description
Syntax Description
Command Default The extension number of the first line on the phone appears in the header bar.
Command Modes Ephone-dn configuration (config-ephone)
Ephone-dn-template configuration (config-ephone-dn)
Command History
Usage Guidelines Use this command under the ephone-dn that is associated with the first line button on a Cisco Unified IP
phone. This command is typically used to display the entire E.164 telephone number associated with the
first line button in the header bar rather than just the extension number, which is the default.
This command is supported by the following IP phones:
• Cisco Unified IP Phone 7940 and 7940G
• Cisco Unified IP Phones 7960 and 7960G
• Cisco Unified IP Phone 7970
• Cisco Unified IP Pone 7971
string Alphanumeric characters to be displayed in the header bar of the phone
display. If spaces appear in the string, enclose the string in quotation marks.
The maximum string length is 40 characters.
Note Display behavior depends on phone firmware version.
Cisco IOS Release Cisco Product Modification
12.2(11)T Cisco ITS 2.0.1 This command was introduced.
12.2(11)YT Cisco ITS 2.1 The number of characters in the string was
modified.
12.2(15)T Cisco ITS 2.1 This command was integrated into Cisco IOS
Release 12.2(15)T.
12.4(4)XC Cisco Unified CME 4.0 This command was made available in
ephone-dn-template configuration mode.
12.4(9)T Cisco Unified CME 4.0 This command in ephone-dn-template
configuration mode was integrated into Cisco IOS
12.4(9)T.
Cisco Unified CME Commands: D
description (ephone-dn and ephone-dn-template)
255
Cisco Unified CME Command Reference
OL-10894-01
For Cisco Unified IP Phone 7940s and 7940Gs or Cisco Unified IP Phone 7960s and 7960Gs, the string
is truncated to 14 characters if the text string is greater than 14 characters.
For Cisco Unified IP Phone 797x, all characters in the string appear alternately with time and date, each
for 5 seconds.
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
Examples The following example shows how to define a header bar display for a phone on which the first line
button is the extension number 50155:
Router(config)# ephone-dn 4
Router(config-ephone-dn)# number 50155
Router(config-ephone-dn)# description 888-555-0155

The following example shows how to use an ephone-dn template to define a header bar display for a
phone on which the first line button is the extension number 50155:
Router(config)# ephone-dn-template 3
Router(config-ephone-dn-template)# description “888 555-0155”
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn 4
Router(config-ephone-dn)# number 50155
Router(config-ephone-dn)# ephone-dn-template 3

Related Commands Command Description
number Configures a valid number for a Cisco Unified IP phone.
Cisco Unified CME Commands: D
description (ephone-hunt)
256
Cisco Unified CME Command Reference
OL-10894-01
description (ephone-hunt)
To create a label for an ephone hunt group, use the description command in ephone-hunt configuration
mode. To return this value to the default, use the no form of this command.
description string
no description
Syntax Description
Command Default No description exists for the ephone hunt group.
Command Modes Ephone-hunt configuration (config-ephone-hunt)
Command History
Usage Guidelines This command creates a label to identify the ephone-hunt group. This label helps make the configuration
more readable.
Examples The following example shows how to identify a hunt group for technical support agents.
ephone-hunt 3 peer
pilot 4200
list 1001, 1002, 1003
description Tech Support Hunt Group
hops 3
timeout 7, 10, 15
max-timeout 25
final 4500
string Character string that identifies a hunt group.
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
12.4(9)T.
Cisco Unified CME Commands: D
description (voice moh-group)
257
Cisco Unified CME Command Reference
OL-10894-01
description (voice moh-group)
To display a brief description specific to a MOH group, use the description command in voice
moh-group configuration mode. To remove the description, use the no form of this command.
description string
no description
Syntax Description
Command Default No MOH group description is configured.
Command Modes Voice moh-group configuration (config-voice-moh-group)
Command History
Usage Guidelines This command allows you to type a brief text describing a specific voice-moh-group. You can use
maximum 80 characters, including spaces to describe a MOH group.
Examples The following example provides a description for voice-moh-group1:
Router(config)#
Router(config-voice-moh-group)#
Router(config-voice-moh-group) description this is a moh group for sales

Related Commands
string An alphanumeric string to add a brief description specific to a MOH group.
Maximum length: 80 characters including spaces.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0
Cisco Unified SRST 8.0
This command was introduced
Command Description
voice-moh-group Enter voice-moh-group configuration mode.
moh Enables music on hold from a flash audio feed
multicast moh Enables multicast of the music-on-hold audio stream.
extension-range Specifies the extension range for a clients calling a voice-moh-group.
Cisco Unified CME Commands: D
description (voice register pool)
258
Cisco Unified CME Command Reference
OL-10894-01
description (voice register pool)
To display a custom description in the header bar of Cisco IP Phone 7940 and 7940G or a Cisco IP Phone
7960 and 7960G, use the description command in voice register pool configuration mode. To return to
the default, use the no form of this command.
description string
no description
Syntax Description
Command Default The extension number of the first line on the phone appears in the header bar.
Command Modes Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines Use this command to display a customized description in the header bar of a SIP phone instead of the
extension number, which is the default. For example, you can display the entire E.164 telephone number
associated with the first phone line.
String is truncated to 14 characters in the display of the Cisco IP Phone 7940, Cisco IP Phone 7940G,
Cisco IP Phone 7960, and Cisco IP Phone 7960G.
Examples The following example shows how to define a header bar display for a SIP phone on which the extension
number is 50155:
Router(config)# voice register pool 4
Router(config-register-pool)# number 1 50155
Router(config-register-pool)# description 888-555-0155

Related Commands
string Alphanumeric characters that appear in the header bar of the phone display.
If spaces appear in the string, enclose the string in quotation marks. The
maximum string length is 40 characters.
Cisco IOS Release Cisco product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
number (voice register
pool)
Configures a valid number for a SIP phone.
Cisco Unified CME Commands: D
device-id (ephone-type)
259
Cisco Unified CME Command Reference
OL-10894-01
device-id (ephone-type)
To specify the device ID of a phone type, use the device-id command in ephone-type configuration
mode. To reset to the default value, use the no form of this command.
device-id number
no device-id
Syntax Description
Command Default Device ID is 0.
Command Modes Ephone-type configuration (config-ephone-type)
Command History
Usage Guidelines This command specifies the device ID of the type of phone being added with the ephone-type template.
If this command is set to the default value of 0, the ephone-type is invalid.
number Device ID of the phone type. Range: 1 to 2,147,483,647. Default: 0.
See Table 1 for a list of supported device IDs.
Cisco IOS Release Cisco Product Modification
12.4(15)XZ Cisco Unified CME 4.3
Cisco Unified SRST 4.3
This command was introduced.
12.4(20)T Cisco Unified CME 7.0
Cisco Unified SRST 7.0
This command was integrated into Cisco IOS
Release 12.4(20)T.
Table 2 Supported Values for Ephone-Type Commands
Supported Device device-id device-type num-buttons max-presentation
Cisco Unified IP Phone 7915
Expansion Module with 12 buttons
227 7915 12 0 (default)
Cisco Unified IP Phone 7915
Expansion Module with 24 buttons
228 7915 24 0
Cisco Unified IP Phone 7916
Expansion Module with 12 buttons
229 7916 12 0
Cisco Unified IP Phone 7916
Expansion Module with 24 buttons
230 7916 24 0
Cisco Unified Wireless IP Phone 7925 484 7925 6 4
Cisco Unified IP
Conference Station 7937G
431 7937 1 6
Nokia E61 376 E61 1 1
Cisco Unified CME Commands: D
device-id (ephone-type)
260
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows the device ID is set to 376 for the Nokia E61 when creating the
ephone-type template:
Router(config)# ephone-type E61
Router(config-ephone-type)# device-id 376
Router(config-ephone-type)# device-name E61 Mobile Phone
Related Commands Command Description
device-name Assigns a name to a phone type in an ephone-type template.
load Associates a type of phone with a phone firmware file.
type Assigns the phone type to a SCCP phone.
Cisco Unified CME Commands: D
device-name
261
Cisco Unified CME Command Reference
OL-10894-01
device-name
To assign a name to a phone type in an ephone-type template, use the device-name command in
ephone-type configuration mode. To remove the name, use the no form of this command.
device-name name
no device-name
Syntax Description
Command Default No name is assigned to this phone type.
Command Modes Ephone-type configuration (config-ephone-type)
Command History
Usage Guidelines This command specifies a device name for the type of phone being added with the ephone-type template.
Examples The following example shows that the name “E61 Mobile Phone” is assigned to a phone type when
creating the ephone-type template:
Router(config)# ephone-type E61
Router(config-ephone-type)# device-id 376
Router(config-ephone-type)# device-name E61 Mobile Phone
Related Commands
name String that identifies this phone type. Value is any alphanumeric string up
to 32 characters.
Cisco IOS Release Cisco Product Modification
12.4(15)XZ Cisco Unified CME 4.3
Cisco Unified SRST 4.3
This command was introduced.
12.4(20)T Cisco Unified CME 7.0
Cisco Unified SRST 7.0
This command was integrated into Cisco IOS
Release 12.4(20)T.
Command Description
device-id Specifies the device ID for a phone type in an ephone-type template.
Cisco Unified CME Commands: D
device-type
262
Cisco Unified CME Command Reference
OL-10894-01
device-type
To specify the phone type, use the device-type command in ephone-type configuration mode. To reset
to the default value, use the no form of this command.
device-type phone-type
no device-type
Syntax Description
Command Default Device type is the same value that is entered with the ephone-type command.
Command Modes Ephone-type configuration (config-ephone-type)
Command History
Usage Guidelines This command specifies the device type of the phone being added with the ephone-type template. The
device type is set to the same value as the ephone-type command unless you use this command to change
the value.
This command must be set to one of the following supported values.
phone-type Device type of the phone. See Table 1 for a list of supported device types.
Default value is the same value entered with the ephone-type command.
Cisco IOS Release Cisco Product Modification
12.4(15)XZ Cisco Unified CME 4.3
Cisco Unified SRST 4.3
This command was introduced.
12.4(20)T Cisco Unified CME 7.0
Cisco Unified SRST 7.0
This command was integerated into Cisco IOS
Release 12.4(20)T.
Table 3 Supported Values for Ephone-Type Commands
Supported Device device-id device-type num-buttons max-presentation
Cisco Unified IP Phone 7915
Expansion Module with 12 buttons
227 7915 12 0 (default)
Cisco Unified IP Phone 7915
Expansion Module with 24 buttons
228 7915 24 0
Cisco Unified IP Phone 7916
Expansion Module with 12 buttons
229 7916 12 0
Cisco Unified IP Phone 7916
Expansion Module with 24 buttons
230 7916 24 0
Cisco Unified Wireless IP Phone 7925 484 7925 6 4
Cisco Unified CME Commands: D
device-type
263
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows the device type set to 7915 in the ephone-type template for the
Cisco Unified IP Phone 7915 Expansion Module with 12 buttons:
Router(config)# ephone-type 7915-12 addon
Router(config-ephone-type)# device-id 227
Router(config-ephone-type)# device-name 7915-12
Router(config-ephone-type)# device-type 7915
Related Commands
Cisco Unified IP
Conference Station 7937G
431 7937 1 6
Nokia E61 376 E61 1 1
Table 3 Supported Values for Ephone-Type Commands
Supported Device device-id device-type num-buttons max-presentation
Command Description
device-name Assigns a name to a phone type in an ephone-type template.
ephone-type Adds a Cisco Unified IP phone type by defining an ephone-type template.
load Associates a type of phone with a phone firmware file.
type Assigns the phone type to a SCCP phone.
Cisco Unified CME Commands: D
device-security-mode
264
Cisco Unified CME Command Reference
OL-10894-01
device-security-mode
To set the security mode for SCCP signaling for devices communicating with the Cisco Unified CME
router globally or per ephone, use the device-security-mode command in telephony-service or ephone
configuration mode. To return to the default, use the no form of this command.
device-security-mode {authenticated | none | encrypted}
no device-security-mode
Syntax Description
Command Default Device signaling is not secure.
Command Modes Telephony-service configuration (config-telephony)
Ephone configuration (config-ephone)
Command History
Usage Guidelines Use this command with Cisco Unified CME phone authentication and encryption.
Set the SCCP signaling security mode globally using this command in telephony-service configuration
mode or per ephone using this command in ephone configuration mode. If you use both commands, the
per-phone setting overrides the global setting.
Examples The following example selects secure SCCP signaling for all ephones.
Router(config)# telephony-service
Router(config-telephony)# device-security-mode authenticated
authenticated SCCP signaling between a device and Cisco Unified CME through the secure
TLS connection on TCP port 2443.
none SCCP signaling is not secure.
encrypted SCCP signaling between a device and Cisco Unified CME through the secure
TLS connection on TCP port 2443, and the media uses Secure Real-Time
Transport Protocol (SRTP).
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)XW Cisco Unified CME 4.1 The encrypted keyword was added.
12.4(15)XY Cisco Unified CME 4.2(1) The encrypted keyword was added.
12.4(15)XZ Cisco Unified CME 4.3 The encrypted keyword was added.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: D
device-security-mode
265
Cisco Unified CME Command Reference
OL-10894-01
The following example selects secure SCCP signaling for ephone 28:
Router(config)# ephone 28
Router(config-ephone)# button 1:14 2:25
Router(config-ephone)# device-security-mode authenticated
The following example selects secure SCCP signaling for all ephones and then disables it for ephone 36:
Router(config)# telephony-service
Router(config-telephony)# device-security-mode authentication
Router(config)# ephone 36
Router(config-ephone)# button 1:15 2:16
Router(config-ephone)# device-security-mode none

The following example selects encrypted secure SCCP signaling and encryption through SRTP for all
ephones:
Router(config)# telephony-service
Router(config-telephony)# device-security-mode encrypted

Cisco Unified CME Commands: D
dialplan
266
Cisco Unified CME Command Reference
OL-10894-01
dialplan
To assign a dial plan to a SIP phone, use the dialplan command in voice register pool or voice register
template configuration mode. To remove the dial plan from the phone, use the no form of this command.
dialplan dialplan-tag
no dialplan dialplan-tag
Syntax Description
Command Default No dial plan is assigned to the phone.
Command Modes Voice register pool configuration (config-register-pool)
Voice register template configuration (config-register-temp)
Command History
Usage Guidelines You apply a dial plan to a SIP phone with this command after you create the dial plan with the voice
register dialplan command. When the phone is reset or restarted, the dial plan file specified with this
command is loaded to the phone. A phone can use only one dial plan.
A dial plan assigned to a SIP phone has priority over Key Press Markup Language (KPML), which is
enabled by default on the phone.
If you use a voice register template to apply a command to a phone and you also use the same command
in voice register pool configuration mode for the same phone, the value that you set in voice register pool
configuration mode has priority.
After using the no dialplan command to remove a dial plan from a phone, use the restart command after
creating a new configuration profile if the dial plan was defined with the pattern command. If the dial
plan was defined using a custom XML file with the filename command, you must use the reset command
for the change to take effect.
Examples The following example shows that dial plan 5 is assigned to the SIP phone identified by pool 1:
Router(config)# voice register pool 1
Router(config-register-pool)# dialplan 5

dialplan-tag Number that identifies the dial plan to use for this SIP phone. This is the
dialplan-tag argument that was assigned to the dial plan with the voice
register dialplan command. Range: 1 to 24.
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.
Cisco Unified CME Commands: D
dialplan
267
Cisco Unified CME Command Reference
OL-10894-01
The following example shows that dial plan 5 is assigned to voice register template 10:
Router(config)# voice register template 10
Router(config-register-temp)# dialplan 5

Related Commands Command Description
digit collect kpml Enables KPML digit collection on a SIP phone.
filename Specifies a custom XML file that contains the dial patterns to use for
a SIP dial plan.
pattern Defines a dial pattern for a SIP dial plan.
show voice register dialplan Displays all configuration information for a specific SIP dial plan.
show voice register pool Displays all configuration information associated with a particular
voice register pool.
voice register dialplan Enters voice register dialplan configuration mode to define a dial plan
for SIP phones.
Cisco Unified CME Commands: D
dialplan-pattern
268
Cisco Unified CME Command Reference
OL-10894-01
dialplan-pattern
To define a pattern that is used to expand extension numbers in Cisco Unified CME into fully qualified
E.164 numbers, use the dialplan-pattern command in telephony-service configuration mode. To disable
the dialplan-pattern command settings, use the no form of this command.
dialplan-pattern tag pattern extension-length extension-length [extension-pattern
extension-pattern | no-reg]
no dialplan-pattern tag
Syntax Description
Command Default No expansion pattern exists.
Command Modes Telephony-service configuration
Command History
tag Identifies this dial-plan pattern. The tag is a number from 1 to 5.
pattern Dial-plan pattern, such as the area code, the prefix, and the first one or two
digits of the extension number, plus wildcard markers or dots (.) for the
remainder of the extension number digits.
extension-length Sets the number of extension digits that will appear as a caller ID.
extension-length The number of extension digits. The extension length must match the length
of extensions for IP phones. Range: 1 to 32.
extension-pattern (Optional) Sets an extension number’s leading digit pattern when it is
different from the E.164 telephone number’s leading digits as defined in the
extension-pattern argument.
extension-pattern (Optional) The extension number’s leading digit pattern. Consists of one or
more digits and wildcard markers or dots (.). For example, 5.. would include
extension 500 to 599, and 5... would include 5000 to 5999.
The length of the extension pattern must equal the value configured for the
extension-length argument.
no-reg (Optional) Prevents the E.164 numbers in the dial peer from registering with
the gatekeeper.
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(11)YT Cisco ITS 2.1 The extension-pattern keyword was added.
12.2(15)T Cisco ITS 2.1 This command was integrated into Cisco IOS
Release 12.2(15)T.
Cisco Unified CME Commands: D
dialplan-pattern
269
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines This command creates a pattern for expanding individual abbreviated extension numbers of calling
numbers into fully qualified E.164 numbers.
Use this command when configuring a network with multiple Cisco Unified CMEs to ensure that the
appropriate calling number, extension or E.164 number, is provided to the target Cisco Unified CME,
and appears on the phone display of the called phone. In networks that have a single Cisco Unified CME,
this command is not needed.
If multiple dial-plan patterns are defined, the system matches extension numbers against the patterns in
sequential order, starting with with the lowest numbered dial-plan pattern tag first. Once a pattern
matches an extension number, the pattern is used to generate an expanded number. If additional patterns
subsequently match the extension number, they are not used.
The dialplan-pattern command builds additional dial peers for the expanded numbers it creates. For
example, when the ephone-dn with the number 1001 was defined, the following POTS dial peer was
automatically created for it:
dial-peer voice 20001 pots
destination-pattern 1001
voice-port 50/0/2
When you define a dial-plan pattern that 1001 will match, such as 40855510.., a second dial peer is
created so that calls to both the 1001 and 4085551001 numbers will be completed. In our example, the
additional dial peer that is automatically created looks like the following:
dial-peer voice 20002 pots
destination-pattern 4085551001
voice-port 50/0/2
Both numbers are recognized by Cisco Unified CME as being associated with a SCCP phone.
Both dial peers can be seen with the show telephony-service dial-peer command.
In networks with multiple routers, you may need to use the dialplan-pattern command to expand
extensions to E.164 numbers because local extension numbering schemes can overlap each other.
Networks with multiple routers have authorities such as gatekeepers that route calls through the network.
These authorities require E.164 numbers so that all numbers in the network will be unique. Use the
dialplan-pattern command to expand extension numbers into unique E.164 numbers for registering
with a gatekeeper.
Ephone-dn numbers for the Cisco IP phones must match the number in the extension-length argument;
otherwise, the extension number cannot be expanded. For example, the following command maps all
3-digit extension numbers to the telephone number 40855501xx, so that extension 111 is expanded but
the 4-digit extension 1011 is not.
dialplan-pattern 1 40855501.. extension-length 3
Using the dialplan-pattern command to expand extension numbers can sometimes result in the
improper matching of numbers with dial peers. For example, the expanded E.164 number 2035550134
can match dial-peer destination-pattern 203, not 134, which would be the correct destination pattern for
the desired extension. If it is necessary for you to use the dialplan-pattern command and you know that
the expanded numbers might match destination patterns for other dial peers, you can manually configure
the E.164 expanded number for an extension as its secondary number using the number command, as
shown in the following example.
ephone-dn 23
number 134 secondary 2035550134
Cisco Unified CME Commands: D
dialplan-pattern
270
Cisco Unified CME Command Reference
OL-10894-01
The pattern created by the dialplan-pattern command is also used to enable distinctive ringing for
inbound calls. If a calling-party number matches a dial-plan pattern, the call is considered an internal
call and has a distinctive ring that identifies the call as internal. Any call with a calling-party number
that does not match a dial-plan pattern is considered an external call and has a distinctive ring that is
different from the internal ringing.
When the extension-pattern keyword and extension-pattern argument are used, the leading digits of an
extension pattern are stripped and replaced with the corresponding leading digits of the dial plan. For
example, the following command maps all 4xx extension numbers to the E.164 number 40855501xx, so
that extension 412 corresponds to 4085550112.
dialplan-pattern 1 4085550100 extension-length 3 extension-pattern 4..
Examples The following example shows how to create dial-plan pattern 1 for extension numbers 5000 to 5099 with
a prefix of 408555. If an inbound calling party number (4085555044) matches dial-plan pattern 1, the
recipient phone will display an extension (5044) as the caller ID and use an internal ringing tone. If an
outbound calling party extension number (5044) matches the same dial-plan pattern 1, the calling-party
extension will be converted to an E.164 number (4085555044). The E.164 calling-party number will
appear as the caller ID.
Router(config)# telephony-service
Router(config-telephony)# dialplan-pattern 1 40855550.. extension-length 4
extension-pattern 50..

In the following example, the dialplan-pattern command creates dial-plan pattern 1 for extensions 800
to 899 with the telephone prefix starting with 4085559. As each number in the extension pattern is
declared with the number command, two POTS dial peers are created. In the example, they are 801 (an
internal office number) and 4085579001 (an external number).
Router(config)# telephony-service
Router(config-telephony)# dialplan-pattern 1 40855590.. extension-length 3
extension-pattern 8..

The following example shows a configuration for two Cisco CME systems. One system uses 50.. and the
other uses 60.. for extension numbers. Each is configured with the same two dialplan-pattern
commands. Calls from the “50..” system to the “60..” system, and vice versa, are treated as internal calls.
Calls that go across a H.323 network and calls that go to a PSTN through an ISDN interface on one of
the configured Cisco CME routers are represented as E.164.
Router(config)# telephony-service
Router(config-telephony)# dialplan-pattern 1 40855550.. extension-length 4
extension-pattern 50..
Router(config-telephony)# dialplan-pattern 2 51055560.. extension-length 4
extension-pattern 60..

Related Commands Command Description
show
telephony-service
dial-peer
Displays dial peer information for extensions in a Cisco CME system.
Cisco Unified CME Commands: D
dialplan-pattern (voice register)
271
Cisco Unified CME Command Reference
OL-10894-01
dialplan-pattern (voice register)
To define a pattern that is used to expand extension numbers in Cisco Unified CME into fully qualified
E.164 numbers, use the dialplan-pattern command in voice register global configuration mode. To
disable the dialplan-pattern command settings, use the no form of this command.
dialplan-pattern tag pattern extension-length extension-length [extension-pattern
extension-pattern | no-reg]
no dialplan-pattern tag
Syntax Description
Command Default No expansion pattern exists.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command creates a pattern for expanding individual abbreviated SIP extension numbers of calling
numbers into fully qualified E.164 numbers.
tag Unique number for identifying this dial-plan pattern. Range: 1 to 5.
pattern Dial-plan pattern to be matched, such as the area code, the prefix, and the
first one or two digits of the extension number, plus wildcard markers or
dots (.) for the remainder of the extension number digits.
extension-length Number of extension digits that will appear as a caller ID.
extension-length Number of digits in an extension.
This variable must match the length of the directory numbers configured for
SIP extensions in Cisco Unified CME. Range: 1 to 32.
extension-pattern (Optional) Leading digit pattern to be configured for an extension when it
is different from the leading digit pattern of the E.164 telephone number, as
defined in the extension-pattern argument.
extension-pattern (Optional) Leading digit pattern to be stripped from extension number when
expanding an extension to an E.164 telephone number. Consists of one or
more digits and wildcard markers or dots (.). For example, 5.. would include
extension 500 to 599, and 5... would include 5000 to 5999.
The length of the extension pattern must equal the value configured for the
extension-length argument.
no-reg (Optional) Prevents the E.164 numbers in the dial peer from registering with
the gatekeeper.
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
12.4(9)T.
Cisco Unified CME Commands: D
dialplan-pattern (voice register)
272
Cisco Unified CME Command Reference
OL-10894-01
Use this command when configuring a network with multiple Cisco Unified CMEs to ensure that the
appropriate calling number, extension or E.164 number, is provided to the target Cisco Unified CME,
and appears on the phone display of the called phone. In networks that have a single Cisco Unified CME,
this command is not needed.
Up to five dial-plan patterns can be configured. If multiple dial-plan patterns are defined, the system
matches extension numbers against the patterns in sequential order, starting with the lowest numbered
dial-plan pattern tag first.
Dial peers for directory numbers are automatically created when SIP phones register in
Cisco Unified CME. The dialplan-pattern command builds a second dial peer for the expanded number
because an extension number matches the pattern. Both numbers are recognized by Cisco Unified CME
as being associated with a SIP phone.
For example, the following POTS dial peer is automatically created for extension number 1001 when the
associated SIP phone registers in Cisco Unified CME:
dial-peer voice 20001 pots
destination-pattern 1001
voice-port 50/0/2
If the extension number (1001) also matches a dial-plan pattern that is configured using the
dialplan-pattern command, such as 40855510.., a second dial peer is dynamically created so that calls
to both the 1001 and 4085551001 numbers can be completed. Based on the dial-plan pattern to be
matched, the following additional POTS dial peer is created:
dial-peer voice 20002 pots
destination-pattern 4085551001
voice-port 50/0/2
Using the no form of this command will remove the dial peer that was created for the expanded number.
All dial peers can be displayed by using the show dial-peer voice summary command. All dial peers
for numbers associated to SIP phones only can be displayed by using the show voice register dial-peers
command. Dial peers created by using the dialplan-expansion command cannot be seen in the running
configuration.
The value of the extension-length argument must be equal to the length of extension number to be
matched, otherwise, the extension number cannot be expanded. For example, the following command
maps all 3-digit extension numbers to the telephone number 40855501.., so that extension 111 is
expanded but 4-digit extension number 1111 is not.
dialplan-pattern 1 40855501.. extension-length 3
When the extension-pattern keyword and extension-pattern argument are configured, the leading digits
of the extension pattern variable are stripped away and replaced with the corresponding leading digits of
the dial-plan pattern to create the expanded number. For example, the following command maps all
3-digit extension numbers with the leading digit of “4” to the telephone number 40855501.., so that
extension 434 corresponds to 4085550134.
dialplan-pattern 1 40855501.. extension-length 3 extension-pattern 4..
To apply dialplan-pattern expansion on a per-system basis to individual SIP redirecting numbers in a
Cisco Unified CME system, including original called and last reroute numbers, use the call-forward
command.
Cisco Unified CME Commands: D
dialplan-pattern (voice register)
273
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to create a dialplan-pattern for expanding extension numbers 60xxx
to E.164 numbers 5105555xxx.
Router(config)# voice register global
Router(config-register-global)# dialplan-pattern 1 5105550... extension-length 5

The following example is output from the show dial-peer summary command displaying information
for four dial peers, one each for extensions 60001 and 60002 and because the dialplan-expansion
command was configured to expand 6.... to 4085555...., one each for 4085550001 and 4085550002. The
latter two dial peers will not appear in the running configuration.
Router# show dial-peer summary
AD PRE PASS OUT
TAG TYPE MIN OPER PREFIX DEST-PATTERN FER THRU SESS-TARGET STATT
20010 pots up up 60002$ 0 0
20011 pots up up 60001$ 0 9
20012 pots up up 5105555001$ 0 9
20013 pots up up 5105555002$ 0 0

Related Commands Command Description
call-forward (voice
register)
Applies dial-plan pattern expansion globally to redirecting number.
show dial-peer
summary
Displays all dial peers created in Cisco Unified CME.
show voice register
dial-peer
Displays dial-peer information for SIP extensions in Cisco Unified CME.
Cisco Unified CME Commands: D
digit collect kpml
274
Cisco Unified CME Command Reference
OL-10894-01
digit collect kpml
To enable Key Press Markup Language (KPML) digit collection on a SIP phone, use the digit collect
kpml command in voice register pool or voice register template configuration mode. To disable KPML,
use the no form of this command.
digit collect kpml
no digit collect kpml
Syntax Description This command has no arguments or keywords.
Command Default KPML digit collection is enabled.
Command Modes Voice register pool configuration (config-register-pool)
Voice register template configuration (config-register-temp)
Command History
Usage Guidelines KPML is enabled by default for all directory numbers on the phone. A dial plan assigned to a phone has
priority over KPML. Use the no digit collect kpml command to disable KPML on a phone.
If you use a voice register template to apply a command to a phone and you also use the same command
in voice register pool configuration mode for the same phone, the value that you set in voice register pool
configuration mode has priority.
KPML is not supported on the Cisco Unified IP Phone 7905, 7912, 7940, or 7960.
Examples The following example shows KPML enabled on SIP phone 4:
Router(config)# voice register pool 4
Router(config-register-pool)# digit collect kpml

Related Commands
Release Cisco Product Modification
12.4(11)XJ Cisco Unified CME 4.1
Cisco Unified SRST 4.1
This command was introduced.
12.4(15)T Cisco Unified CME 4.1
Cisco Unified SRST 4.1
This command was integrated into Cisco IOS
Release 12.4(15)T.
Command Description
dialplan Assigns a dial plan to a SIP phone.
show voice register pool Displays all configuration information associated with a SIP phone.
voice register dialplan Enters voice register dialplan configuration mode to define a dial plan for
SIP phones.
Cisco Unified CME Commands: D
directory
275
Cisco Unified CME Command Reference
OL-10894-01
directory
To define the order in which the names of Cisco IP phone users are displayed in the local directory, use
the directory command in telephony-service configuration mode. To return to the default, use the no
form of this command.
directory {first-name-first | last-name-first}
no directory {first-name-first | last-name-first}
Syntax Description
Command Default Default is first-name-first.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command defines name order in the local directory. The directory itself is generated from entries
made using the name command and the number command in ephone-dn configuration mode.
Note The name information must be entered in the correct order in the name command.
The location for the file that is accessed when the Directories button is pressed is specified in the url
(telephony-service) command.
Examples The following example shows how to configure the local directory with the last name first:
Router(config)# telephony-service
Router(config-telephony)# directory last-name-first

Related Commands
first-name-first First name is entered first in the Cisco IP phone directory name field.
last-name-first Last name is entered first in the Cisco IP phone directory name field.
Cisco IOS Release Cisco Product Modification
12.2(2)XT Cisco ITS 2.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.
Description
name Specifies a name to be associated with an extension (ephone-dn).
Cisco Unified CME Commands: D
directory
276
Cisco Unified CME Command Reference
OL-10894-01
number Specifies a telephone number to be associated with an extension
(ephone-dn).
url Provisions URLs for the displays associated with buttons on
Cisco IP phones.
Description
Cisco Unified CME Commands: D
directory entry
277
Cisco Unified CME Command Reference
OL-10894-01
directory entry
To add a system-wide phone directory and speed-dial definition, use the directory entry command in
telephony-service configuration mode. To remove a definition, use the no form of this command.
directory entry {directory-tag number name name | clear}
no directory entry {directory-tag | clear}
Syntax Description
Command Default Entries do not exist.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Cisco Unified CME automatically creates a local phone directory consisting of the telephone numbers
and names that are entered during ephone-dn configuration. Additional directory entries can be made by
administrators using the directory entry command. Phone number directory listings are displayed in the
order in which they are entered.
A single entry can be removed using the no directory entry directory-tag command.
directory-tag Digit string that provides a unique identifier for this entry. Range: 1 to 250.
number String of up to 32 digits that provides the full telephone number for this entry.
name name String of up to 24 alphanumeric characters, including spaces. Cannot include
opening or closing quotation marks (‘, ’ , “, or ”).
clear Removes all directory entries that were made with this command.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.3(11)XL Cisco CME 3.2.1 This feature was modified to enable systemwide
speed-dialing of entries from 34 to 99.
12.3(14)T Cisco CME 3.3 This command was integrated into Cisco IOS
Release 12.3(14)T.
12.4(15)XZ Cisco Unified CME 4.3 The maximum number of directory entries was
increased from 100 to 250.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into Cisco IOS
Release 12.4(20)T.
Cisco Unified CME Commands: D
directory entry
278
Cisco Unified CME Command Reference
OL-10894-01
Directory entries that have directory-tag numbers from 34 to 99 also can be used as system-wide
speed-dial numbers. That is, if you have the following definition for the headquarters office, any phone
user can speed-dial the number:
Router(config)# telephony-service
Router(config-telephony)# directory entry 51 4085550123 name Headquarters

Analog phone users press the asterisk (*) key and the speed-dial identifier (tag number) to dial a
speed-dial number.
IP phone users follow this procedure to dial a speed-dial number:
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.
Examples The following example adds six telephone listings to the local directory. The last two entries, with the
identifiers 50 and 51, can be speed-dialed by anyone on the system because their identifiers
(directory-tags) are between 34 and 99.
Router(config)# telephony-service
Router(config-telephony)# directory entry 1 4045550110 name Atlanta
Router(config-telephony)# directory entry 2 3125550120 name Chicago
Router(config-telephony)# directory entry 4 2125550140 name New York City
Router(config-telephony)# directory entry 5 2065550150 name Seattle
Router(config-telephony)# directory entry 50 4085550123 name Corp Headquarters
Router(config-telephony)# directory entry 51 4085550145 name Division Headquarters
Related Commands Command Description
show telephony-service
directory-entry
Displays the configured directory entries.
url directories Provisions the directory URL to select an external directory resource
and disables the Cisco Unified CME local directory service.
Cisco Unified CME Commands: D
display-logout
279
Cisco Unified CME Command Reference
OL-10894-01
display-logout
To specify a message to display on phones in an ephone hunt group when all phones in the hunt group
are logged out, use the display-logout command in ephone-hunt configuration mode. To return this
value to the default, use the no form of this command.
display-logout string
no display-logout
Syntax Description
Command Default No logout message exists.
Command Modes Ephone-hunt configuration (config-ephone-hunt)
Command History
Usage Guidelines This command defines a plain-text message that displays on phones with ephone-dns that are members
of a hunt group when all the members of the group are logged out. The message can be used to notify
agents that no agents are available to take hunt group calls. It can also be used to tell agents about the
disposition of any incoming calls to the hunt group when no agents are available to answer calls. For
example, you could set the display to read “All Agents Unavailable,” or “Hunt Group Voice Mail” or
“Hunt Group Night Service.”
Examples The following example specifies a message to display when all agents are logged out of hunt group 3.
ephone-hunt 3 peer
pilot 4200
list 1001, 1002, 1003
display-logout All Agents Logged Out
hops 3
timeout 7, 10, 15
max-timeout 25
final 4500

string Character string to be displayed on hunt group member IP phones when all
members are logged out.
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
12.4(9)T.
Cisco Unified CME Commands: D
dnd (voice register pool)
280
Cisco Unified CME Command Reference
OL-10894-01
dnd (voice register pool)
To enable the Do-Not-Disturb (DND) feature, use the dnd-control command in voice register pool
configuration mode. To disable the DND, use the no form of this command.
dnd
no dnd
Syntax Description This command has no arguments or keywords.
Command Default DND is disabled
Command Modes Voice register pool configuration (config-register-pool)
Command History
Examples The following example shows how to enable DND:
Router(config)# voice register pool 1
Router(config-register-pool)# dnd

Related Commands
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
dnd-control (voice
register template)
Enables DND soft key in template to be assigned to SIP phones in
Cisco Unified CME.
Cisco Unified CME Commands: D
dnd feature-ring
281
Cisco Unified CME Command Reference
OL-10894-01
dnd feature-ring
To disable ringing on phone buttons configured for feature ring when the phone is in do-not-disturb
(DND) mode, use the dnd feature-ring command in ephone configuration mode. To allow lines
configured for feature ring to ring when the phone is in DND mode, use the no form of this command.
dnd feature-ring
no dnd feature-ring
Syntax Description This command has no arguments or keywords.
Command Default Incoming calls to buttons configured for feature ring do not ring in DND mode.
Command Modes Ephone configuration (config-ephone)
Command History
Usage Guidelines This command applies only to phone lines that are configured for the feature-ring option with the
button f command.
Note that the affirmative form of the command is enabled by default and feature-ring lines will not ring
when the phone is in DND mode. To enable feature-ring lines to ring when the phone is in DND mode,
use the no dnd feature-ring command.
Examples For the following example, when DND is active on ephone 1 and ephone 2, button 1 will ring, but
button 2 will not.
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 1001

Router(config)# ephone-dn 2
Router(config-ephone-dn)# number 1002

Router(config)# ephone-dn 10
Router(config-ephone)# number 1110
Router(config-ephone)# preference 0
Router(config-ephone)# no huntstop

Router(config)# ephone-dn 11
Router(config-ephone)# number 1111
Router(config-ephone)# preference 1
Router(config-ephone)# no huntstop
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.
Cisco Unified CME Commands: D
dnd feature-ring
282
Cisco Unified CME Command Reference
OL-10894-01

Router(config)# ephone 1
Router(config-ephone)# button 1f1
Router(config-ephone)# button 2o10,11
Router(config-ephone)# no dnd feature-ring

Router(config-ephone-dn)# ephone 2
Router(config-ephone)# button 1f2
Router(config-ephone)# button 2o10,11
Router(config-ephone)# no dnd feature-ring
Related Commands Command Description
button Associates ephone-dns with individual buttons on a Cisco IP phone and
specifies ring behavior.
Cisco Unified CME Commands: D
dnd-control (voice register template)
283
Cisco Unified CME Command Reference
OL-10894-01
dnd-control (voice register template)
To enable the Do-Not-Disturb (DND) soft key on SIP phones, use the dnd-control command in voice
register template configuration mode. To disable the DND soft key on a SIP phone, use the no form of
this command.
dnd-control
no dnd-control
Syntax Description This command has no arguments or keywords.
Command Default DND soft key is enabled on SIP phones in Cisco Unified CME.
Command Modes Voice register template configuration (config-register-temp)
Command History
Usage Guidelines This command enables a soft key for Do-Not-Disturb (DND) in the specified template which can then
be applied to SIP phones. The DND soft key is enabled by default. To disable the DND soft key, use the
dnd command. To apply a template to a SIP phone, use the template command in voice register pool
configuration mode.
Examples The following example shows how to disable the DND soft key:
Router(config)# voice register template 1
Router(config-register-template)# dnd-control
Related Commands\
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
dnd (voice register
pool)
Enables DND feature.
Cisco Unified CME Commands: D
dn-webedit
284
Cisco Unified CME Command Reference
OL-10894-01
dn-webedit
To enable the adding of extensions (ephone-dns) through the Cisco Unified CME graphical user
interface (GUI), use the dn-webedit command in telephony-service configuration mode. To disable this
feature, use the no form of this command.
dn-webedit
no dn-webedit
Syntax Description This command has no arguments or keywords.
Command Default Extensions cannot be added through the Cisco Unified CME GUI.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines The dn-webedit command enables the adding of extensions through the web-based GUI. If the
dn-webedit command is enabled, a customer administrator or a system administrator can modify and
assign extensions associated with the Cisco Unified CME router. If this ability is disabled, extensions
must be added using Cisco IOS commands.
If the set of extension numbers used by the router is part of a larger telephone network, limitations on
modification might be needed to ensure network integrity. Disabling the dn-webedit command prevents
an administrator from allocating phone numbers and prevents assignment of numbers that may already
be used elsewhere in the network.
Examples The following example enables editing of directory numbers through the web-based GUI interface:
Router(config)# telephony-service
Router(config-telephony)# dn-webedit

Related Commands
Cisco IOS Release Cisco Product Modification
12.2(2)XT Cisco ITS 2.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.
Command Description
time-webedit Enables time setting through the web interface.
Cisco Unified CME Commands: D
dst (voice register global)
285
Cisco Unified CME Command Reference
OL-10894-01
dst (voice register global)
To set the time period for daylight saving time on SIP phones, use the dst command in voice register
global configuration mode. To disable daylight saving time, use the no form of this command.
dst {start | stop} month [day day-of-month | week week-number day day-of-week] time
hour:minutes}
no dst {start | stop}
Syntax Description
Command Default Default start time is first week of April, Sunday, 2:00 a.m and default stop time is last week of October,
Sunday 2:00 a.m.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command sets the stop and start times for daylight saving time if the dst auto-adjust command is
configured.
Examples The following example shows how to set automatic adjustment of daylight saving time:
Router(config)# voice register global
Router(config-register-global)# dst start Jan day 1 time 00:00
Router(config-register-global)# dst stop Mar day 31 time 23:99

start Sets beginning time for daylight saving time.
stop Sets ending time for daylight saving time.
month Abbreviated month. The following abbreviations are valid: jan, feb, mar,
apr, may, jun, jul, aug, sep, oct, nov, dec.
day day-of-month Date of the month. Range is 1 to 31.
week week-number Number identifying the week of the month. Range is 1 to 4, or 8, where
8 represents the last week of the month.
day day-of-week Abbreviated day of the week. The following abbreviations are valid: sun,
mon, tue, wed, thu, fri, sat.
time hour:minutes Beginning and ending time for daylight saving time, in HH:MM format
using a 24-hour clock. The stop time must be greater than the start time. The
value 24:00 is not valid. If you enter 00:00for both start time and stop time,
daylight saving time is enabled for the entire 24-hour period on the specified
date.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Cisco Unified CME Commands: D
dst (voice register global)
286
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
date-format (voice
register global)
Sets the date display format on SIP phones in a Cisco CME system.
dst auto-adjust (voice
register global)
Enables automatic adjustment of daylight saving time on SIP phones.
time-format (voice
register global)
Selects a 12-hour clock or a 24-hour clock for the time display format on
Cisco IP phones in a SIP CME system.
timezone (voice
register global)
Sets the time zone used for SIP phones in a Cisco CME system.
Cisco Unified CME Commands: D
dst auto-adjust (voice register global)
287
Cisco Unified CME Command Reference
OL-10894-01
dst auto-adjust (voice register global)
To enable automatic adjustment of daylight saving time on SIP phones, use the dst auto-adjust
command in voice register global configuration mode. To disable daylight saving time auto adjustment,
use the no form of this command.
dst auto-adjust
no dst auto-adjust
Syntax Description This command has no arguments or keywords.
Command Default Automatic adjustment of daylight saving time on SIP phones is enabled.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines Automatic adjustment for daylight saving time is enabled by default. To disable auto adjusting for DST,
use the no dst auto-adjust command. To set the start and stop times for DST, use the dst command.
Examples The following example shows how to disable the automatic adjustment for daylight saving time:
Router(config)# voice register global
Router(config-register-global)# no dst auto-adjust

Related Commands
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
date-format (voice
register global)
Sets the date display format on SIP phones in a Cisco CME system.
dst (voice register
global)
Sets the start and stop time if using daylight saving time on SIP phones.
time-format (voice
register global)
Selects a 12-hour clock or a 24-hour clock for the time display format on
Cisco IP phones in a SIP CME system.
timezone (voice
register global)
Sets the time zone used for SIP phones in a Cisco CME system.
Cisco Unified CME Commands: D
dtmf-relay (voice register pool)
288
Cisco Unified CME Command Reference
OL-10894-01
dtmf-relay (voice register pool)
To specify the list of DTMF relay methods that can be used to relay dual-tone multifrequency (DTMF)
audio tones between Session Initiation Protocol (SIP) endpoints, use the dtmf-relay command in voice
register pool configuration mode. To send the DTMF audio tones as part of an audio stream, use the no
form of this command.
dtmf-relay {[cisco-rtp] [rtp-nte] [sip-notify]}
no dtmf-relay
Syntax Description
Command Default DTMF tones are disabled and sent in-band. That is, they remain in the audio stream.
Command Modes Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines During Cisco Unified Session Initiation Protocol (SIP) Survivable Remote Site Telephony (SRST) or
Cisco Unified CME registration, a dial peer is created and that dial peer has a default DTMF relay of
in-band.
This command allows you to change the default to a desired value. You must use one or more keywords
when configuring this command.
DTMF audio tones are generated when you press a button on a Touch-Tone phone. The tones are
compressed at one end of the call and when the digits are decompressed at the other end, there is a risk
that they can become distorted. DTMF relay reliably transports the DTMF audio tones generated after
call establishment out-of-band.
cisco-rtp Forwards DTMF audio tones by using Real-Time Transport Protocol (RTP)
with a Cisco proprietary payload type. This keyword is supported only for
dial peers that are created by incoming REGISTERs from a SIP gateway. It
is not supported for dial peers that are created by a SIP Cisco IP phone.
rtp-nte Forwards DTMF audio tones by using Real-Time Transport Protocol (RTP)
with a Named Telephone Event (NTE) payload.
sip-notify Forwards DTMF audio tones by using SIP-NOTIFY messages. This keyword
is supported only for dial peers that are created by incoming REGISTERs
from a SIP gateway. It is not supported for dial peers that are created by a
SIP Cisco IP phone.
Cisco IOS Release Cisco Product Modification
12.3(4)T Cisco SIP SRST 3.0 This command was introduced.
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was added to Cisco Unified CME.
Cisco Unified CME Commands: D
dtmf-relay (voice register pool)
289
Cisco Unified CME Command Reference
OL-10894-01
The SIP Notify method sends Notify messages bidirectionally between the originating and terminating
gateways for a DTMF event during a call. If multiple DTMF relay mechanisms are enabled on a SIP dial
peer and are negotiated successfully, the SIP Notify method takes precedence.
SIP Notify messages are advertised in an Invite message to the remote end only if the dtmf-relay
command is set.
For SIP calls, the most appropriate methods to transport DTMF tones are RTP-NTE or SIP-NOTIFY.
Note • The cisco-rtp keyword is a proprietary Cisco implementation. If the proprietary
Cisco implementation is not supported, the DTMF relay feature does not function, and the gateway
sends DTMF tones in-band.
• The sip-notify keyword is available only if the VoIP dial peer is configured for SIP.
Examples Cisco Unified CME
The following example shows how to enable the RTP-NTE and SIP-NOTIFY mechanisms for DTMF
relay for SIP phone 4:
Router(config)# voice register pool 4
Router(config-register-pool)# dtmf-relay rtp-nte sip-notify
Cisco Unified SIP SRST
The following is sample output from the show running-config command that shows that voice register
pool 1 has been set up to send DTMF tones:
voice register pool 1
application SIP.app
incoming called-number 308
voice-class codec 1
dtmf-relay rtp-nte
Related Commands Description
dtmf-relay (voice over
IP)
Specifies how an H.323 or SIP gateway relays DTMF tones between
telephony interfaces and an IP network.
Cisco Unified CME Commands: D
dtmf-relay (voice register pool)
290
Cisco Unified CME Command Reference
OL-10894-01
291
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: Debug
Revised: October 22, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified CME Commands: Debug
debug callmonitor
292
Cisco Unified CME Command Reference
OL-10894-01
debug callmonitor
To collect and display debugging traces for call monitor, use the debug callmonitor command in
privileged EXEC mode. To disable debugging, use the no form of this command.
debug callmonitor {all | core | detail | errors | events | hwconf | info | xml}
no debug command {all | core | detail | errors | events | hwconf | info | xml}
Syntax Description
Command Default There is no default for this command.
Command Modes Privileged EXEC
Command History
Examples The following example is partial output from this command:
Router# debug callmonitor all
Syslog logging: enabled (11 messages dropped, 2 messages rate-limited,
0 flushes, 0 overruns, xml disabled, filtering disabled)
No Active Message Discriminator.
No Inactive Message Discriminator.
Console logging: disabled
Monitor logging: level debugging, 0 messages logged, xml disabled,
filtering disabled
Buffer logging: level debugging, 444378 messages logged, xml disabled,
filtering disabled
Logging Exception size (4096 bytes)
Count and timestamp logging messages: disabled
Persistent logging: disabled
all All call-monitor debugging traces.
core Core information debugging traces.
detail Detailed debugging traces.
errors Call-monitor error debugging traces.
events Call-monitor event debugging traces.
hwconf Debugging traces related to hardware configuration.
info Call-monitor information debugging traces.
xml Call-monitor XML encoding debugging traces.
Release Modification
12.4(11)XW2 This command was introduced.
Cisco Unified CME Commands: Debug
debug callmonitor
293
Cisco Unified CME Command Reference
OL-10894-01
Trap logging: level informational, 461 message lines logged
Log Buffer (1000000 bytes):
Jun 4 22:30:24.222: //CMM/INFO:
Jun 4 22:30:24.222: //CMM/INFO:
Jun 4 22:30:24.222: //CMM/INFO:cmm_notify_trigger() 15, callID 99685, 5114016,
1884814040, 1632257208
Jun 4 22:30:24.222: //CMM/INFO: target_node 0
Jun 4 22:30:24.222: //CMM/INFO:Lineinfo node Search FAILED
Jun 4 22:30:24.222: //CMM/INFO:create_lineinfo_node
Jun 4 22:30:24.222: //CMM/INFO: target_node 66AF3714
Jun 4 22:30:24.222: //CMM/INFO: - dn 4016
Jun 4 22:30:24.222: //CMM/INFO: CallEntry 709C3FB8
Jun 4 22:30:24.222: //CMM/INFO: dstCallID -1
Jun 4 22:30:24.222: //CMM/INFO: line_info 66AF3720, dn 4016
Jun 4 22:30:24.222: //CMM/INFO: * cmm_crs_proc_tr_rpt_orig
Jun 4 22:30:24.222: //CMM/INFO: callID = 99685, CG 5114016, GCID
=05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/INFO:increase_gcid_ref_count 99685 0
Jun 4 22:30:24.222: //CMM/INFO:find_gcidinfo_node
Jun 4 22:30:24.222: //CMM/INFO: target_node 0
Jun 4 22:30:24.222: //CMM/INFO: Gcidinfo node Search FAILED
Jun 4 22:30:24.222: //CMM/INFO:create_gcidinfo_node
Jun 4 22:30:24.222: //CMM/INFO: target_node 6544A9CC
Jun 4 22:30:24.222: //CMM/INFO: - gcid 05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/INFO: count = 1
Jun 4 22:30:24.222: //CMM/INFO:insert_ssptrs_to_gcid for line_info 66AF3720 (dn 4016),
GCID 05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: ss_ptr list :-
Jun 4 22:30:24.222: ss_ptr list :-
Jun 4 22:30:24.222: //CMM/INFO:
Jun 4 22:30:24.222: //CMM/INFO:
Jun 4 22:30:24.222: //CMM/INFO:cmm_notify_trigger() 1, callID 99685, 5114016, 16,
1695547392
Jun 4 22:30:24.222: //CMM/INFO: target_node 66AF3714
Jun 4 22:30:24.222: //CMM/INFO: - dn 4016
Jun 4 22:30:24.222: //CMM/INFO: CallEntry 709C3FB8
Jun 4 22:30:24.222: //CMM/INFO: dstCallID -1
Jun 4 22:30:24.222: //CMM/INFO: line_info 66AF3720, dn 4016
Jun 4 22:30:24.222: //CMM/INFO: * cmm_crs_proc_tr_call_orig
Jun 4 22:30:24.222: //CMM/INFO: orig --> callID 99685, line_info 66AF3720,
call_inst 655AF384, gcid 05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/INFO:is_sccp_endpoint DN 4016
Jun 4 22:30:24.222: //CMM/INFO:
Jun 4 22:30:24.222: sccp endpoint TRUE
Jun 4 22:30:24.222: //CMM/INFO:find_gcidinfo_node
Jun 4 22:30:24.222: //CMM/INFO: target_node 6544A9CC
Jun 4 22:30:24.222: //CMM/INFO: - gcid 05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/INFO:cmm_send_dialog_notify sub_info 0
Jun 4 22:30:24.222: ss_ptr list :-
Jun 4 22:30:24.222: //CMM/INFO: <== DIALOG MGR ==>
Jun 4 22:30:24.222: //CMM/INFO: :: CMM_EV_CALL_CONN_ORIGINATED
Jun 4 22:30:24.222: //CMM/INFO: - Gcid
05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/INFO: - Calling 4016
Jun 4 22:30:24.222: //CMM/INFO: - Called
Jun 4 22:30:24.222: //CMM/INFO: - ConnAddr 4016
Jun 4 22:30:24.222: //CMM/INFO: - Type 0
Jun 4 22:30:24.222: //CMM/INFO: - parentGcid
00000000-00000000-00000000-00000000
Jun 4 22:30:24.222: //CMM/INFO:find_gcidinfo_node
Cisco Unified CME Commands: Debug
debug callmonitor
294
Cisco Unified CME Command Reference
OL-10894-01
Jun 4 22:30:24.222: //CMM/INFO: target_node 6544A9CC
Jun 4 22:30:24.222: //CMM/INFO: - gcid 05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/DETAIL: type: CMM_EV_CALL_CONN_ORIGINATED, filter analyzing....
[4016, , 4016]
Jun 4 22:30:24.222: //CMM/INFO:find_gcidinfo_node
Jun 4 22:30:24.222: //CMM/INFO: target_node 6544A9CC
Jun 4 22:30:24.222: //CMM/INFO: - gcid 05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/DETAIL:gcid is not part of conference. [4016, , 4016] checking
originateFilter...
Jun 4 22:30:24.222: //CMM/DETAIL:originateFilter[callid=99685, pdn=16, pchan=1] is not
set. [4016, , 4016] is not filtered
Jun 4 22:30:24.222: //CMM/INFO:find_gcidinfo_node
Jun 4 22:30:24.222: //CMM/INFO: target_node 6544A9CC
Jun 4 22:30:24.222: //CMM/INFO: - gcid 05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/INFO:cmm_send_dialog_notify sub_info 0
Jun 4 22:30:24.222: ss_ptr list :-
Jun 4 22:30:24.222: //CMM/INFO: <== DIALOG MGR ==>
Jun 4 22:30:24.222: //CMM/INFO: :: CMM_EV_CALL_CONN_ACTIVE
Jun 4 22:30:24.222: //CMM/INFO: - Gcid
05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/INFO: - Calling 4016
Jun 4 22:30:24.222: //CMM/INFO: - Called
Jun 4 22:30:24.222: //CMM/INFO: - ConnAddr 4016
Jun 4 22:30:24.222: //CMM/INFO: - LastRedirectAddr
Jun 4 22:30:24.222: //CMM/INFO: - Type 0
Jun 4 22:30:24.222: //CMM/INFO: - parentGcid
00000000-00000000-00000000-00000000
Jun 4 22:30:24.222: //CMM/INFO:find_gcidinfo_node
Jun 4 22:30:24.222: //CMM/INFO: target_node 6544A9CC
Jun 4 22:30:24.222: //CMM/INFO: - gcid 05591A85-122211DC-8645A1CA-4B604A7A
Jun 4 22:30:24.222: //CMM/DETAIL: type: CMM_EV_CALL_CONN_ACTIVE, filter analyzing....
[4016, , 4016]
Jun 4 22:30:24.222: //CMM/DETAIL:called number is not specified. [4016, , 4016]
Jun 4 22:30:24.222: //CMM/DETAIL:originateFilter[callid=99685, pdn=16, pchan=1] is not
set, [4016, , 4016] is not filtered
Jun 4 22:30:25.670: //CMM/INFO:
Jun 4 22:30:25.670: //CMM/INFO:
Jun 4 22:30:25.670: //CMM/INFO:cmm_notify_trigger() 14, callID 99686, 8101, 1902058375, 0
Jun 4 22:30:25.670: //CMM/INFO: target_node 65DB15E4
Jun 4 22:30:25.670: //CMM/INFO: - dn 8101
.
.
.
Related Commands Command Description
callmonitor Enable call monitoring messaging functionality on a SIP endpoint in a VoIP
network.
gcid Enable Global Call ID (Gcid) for every call on an outbound leg of a VoIP dial
peer for a SIP endpoint.
Cisco Unified CME Commands: Debug
debug capf-server
295
Cisco Unified CME Command Reference
OL-10894-01
debug capf-server
To collect debug information about the CAPF server, use the debug capf-server command in privileged
EXEC mode. To disable collection of debug information, use the no form of this command.
debug capf-server {all | error | events | messages}
no debug capf-server
Syntax Description
Command Default Collection of CAPF debug information is disabled.
Command Modes Privileged EXEC
Command History
Usage Guidelines This command is used with Cisco Unified CallManager Express phone authentication.
Examples The following example shows debug messages for the CAPF server.
Router# debug capf-server all
001891: .Jul 21 18:17:07.014: %IPPHONE-6-UNREGISTER_NORMAL: ephone-1:SEP000E325C9A43
IP:10.10.10.194 So
cket:3 DeviceType:Phone has unregistered normally.
001892: .Jul 21 18:17:20.495: New Connection from phone, socket 1
001893: .Jul 21 18:17:20.495: Created New Handshake Process
001894: .Jul 21 18:17:20.499: SSL Handshake Error -6983
001895: .Jul 21 18:17:21.499: SSL Handshake Error -6983
001896: .Jul 21 18:17:22.555: SSL Handshake Successful
001897: .Jul 21 18:17:22.555: ephone_capf_send_auth_req:
001898: .Jul 21 18:17:22.555: ephone_capf_ssl_write: 12 bytes
001899: .Jul 21 18:17:22.711: ephone_capf_ssl_read: Read 35 bytes
001900: .Jul 21 18:17:22.711: ephone_capf_handle_phone_msg: msgtype 2
001901: .Jul 21 18:17:22.711: ephone_capf_process_auth_res_msg: SEP000E325C9A43 AuthMode 2
001902: .Jul 21 18:17:22.711: ephone_capf_send_delete_cert_req_msg: SEP000E325C9A43
001903: .Jul 21 18:17:22.711: ephone_capf_ssl_write: 8 bytes
001904: .Jul 21 18:17:23.891: ephone_capf_ssl_read: Read 12 bytes
001905: .Jul 21 18:17:23.891: ephone_capf_handle_phone_msg: msgtype 14
001906: .Jul 21 18:17:23.891: certificate delete successful for SEP000E325C9A43
all Collect all CAPF information available.
error Collect only information about CAPF errors.
events Collect only information about CAPF status events.
messages Collect only CAPF system messages.
Cisco IOS Release Modification
12.4(4)XC This command was introduced.
12.4(9)T This command was integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: Debug
debug capf-server
296
Cisco Unified CME Command Reference
OL-10894-01
001907: .Jul 21 18:17:24.695: ephone_capf_release_session: SEP000E325C9A43
001908: .Jul 21 18:17:24.695: ephone_capf_send_end_session_msg: SEP000E325C9A43
001909: .Jul 21 18:17:24.695: ephone_capf_ssl_write: 12 bytes
001910: .Jul 21 18:17:25.095: %IPPHONE-6-REG_ALARM: 22: Name=SEP000E325C9A43 Load=7.2(2.0)
Last=Rese
t-Reset
001911: .Jul 21 18:17:25.099: %IPPHONE-6-REGISTER: ephone-1:SEP000E325C9A43
IP:10.10.10.194 Socket:2 De
viceType:Phone has registered.
001912: .Jul 21 18:18:05.171: %IPPHONE-6-UNREGISTER_NORMAL: ephone-1:SEP000E325C9A43
IP:1.1.1.127 So
cket:2 DeviceType:Phone has unregistered normally.
001913: .Jul 21 18:18:18.288: New Connection from phone, socket 1
001914: .Jul 21 18:18:18.288: Created New Handshake Process
001915: .Jul 21 18:18:18.292: SSL Handshake Error -6983
001916: .Jul 21 18:18:19.292: SSL Handshake Error -6983
001917: .Jul 21 18:18:20.348: SSL Handshake Successful
001918: .Jul 21 18:18:20.348: ephone_capf_send_auth_req:
001919: .Jul 21 18:18:20.348: ephone_capf_ssl_write: 12 bytes^Z
001920: .Jul 21 18:18:20.492: ephone_capf_ssl_read: Read 35 bytes
001921: .Jul 21 18:18:20.492: ephone_capf_handle_phone_msg: msgtype 2
001922: .Jul 21 18:18:20.492: ephone_capf_process_auth_res_msg: SEP000E325C9A43 AuthMode 2
001923: .Jul 21 18:18:20.492: ephone_capf_send_PhKeyGenReq_msg: SEP000E325C9A43 KeySize
1024
001924: .Jul 21 18:18:20.492: ephone_capf_ssl_write: 13 bytes
001925: .Jul 21 18:18:20.540: ephone_capf_ssl_read: Read 8 bytes
001926: .Jul 21 18:18:20.540: ephone_capf_handle_phone_msg: msgtype 17
001927: .Jul 21 18:18:20.540: ephone_capf_process_req_in_progress: SEP000E325C9A43 delay
0sh
001928: .Jul 21 18:18:21.924: %SYS-5-CONFIG_I: Configured from console by user1 on console
Cisco Unified CME Commands: Debug
debug cch323video
297
Cisco Unified CME Command Reference
OL-10894-01
debug cch323 video
To provide debugging output for video components within the H.323 subsystem, use the debug cch323
video command in privileged EXEC mode. To disable debugging output, use the no form of this
command.
debug cch323 video
no debug cch323 video
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History
Usage Guidelines Use this command to enable a debugging trace for the video component in an H.323 network.
Examples Originating Gateway Example
The following is sample output of the debugging log for an originating Cisco Unified CallManager
Express (Cisco Unified CME) gateway after the debug cch323 video command was enabled:
Router# show log
Syslog logging: enabled (11 messages dropped, 487 messages rate-limited,
0 flushes, 0 overruns, xml disabled, filtering disabled)
Console logging: disabled
Monitor logging: level debugging, 0 messages logged, xml disabled,
filtering disabled
Buffer logging: level debugging, 1144 messages logged, xml disabled,
filtering disabled
Logging Exception size (4096 bytes)
Count and timestamp logging messages: disabled
Trap logging: level informational, 1084 message lines logged
Log Buffer (6000000 bytes):
Jun 13 09:19:42.006: //103030/C7838B198002/H323/cch323_get_peer_info: Entry
Jun 13 09:19:42.006: //103030/C7838B198002/H323/cch323_get_peer_info: Have peer
Jun 13 09:19:42.006: //103030/C7838B198002/H323/cch323_set_pref_codec_list: First
preferred codec(bytes)=16(20)
Jun 13 09:19:42.006: //103030/C7838B198002/H323/cch323_get_peer_info: Flow Mode set to
FLOW_THROUGH
Jun 13 09:19:42.006: //103030/C7838B198002/H323/cch323_get_caps_chn_info: No peer leg
setup params
Jun 13 09:19:42.006: //103030/C7838B198002/H323/cch323_get_caps_chn_info: Setting
CCH323_SS_NTFY_VIDEO_INFO
Cisco IOS Release Modification
12.4(4)XC This command was introduced.
12.4(9)T This command was integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: Debug
debug cch323video
298
Cisco Unified CME Command Reference
OL-10894-01
Jun 13 09:19:42.006: //103030/C7838B198002/H323/cch323_set_h323_control_options_outgoing:
h245 sm mode = 8463
Jun 13 09:19:42.006: //103030/C7838B198002/H323/cch323_set_h323_control_options_outgoing:
h323_ctl=0x20
Jun 13 09:19:42.010: //103030/C7838B198002/H323/cch323_rotary_validate: No peer_ccb
available
Terminating Gateway Example
The following is sample output of the debugging log for a terminating Cisco Unified Survivable Remote
Site Telephony (Cisco Unified SRST) gateway after the debug cch323 video command was enabled:
Router# show log
Syslog logging: enabled (11 messages dropped, 466 messages rate-limited,
0 flushes, 0 overruns, xml disabled, filtering disabled)
Console logging: disabled
Monitor logging: level debugging, 0 messages logged, xml disabled,
filtering disabled
Buffer logging: level debugging, 829 messages logged, xml disabled,
filtering disabled
Logging Exception size (4096 bytes)
Count and timestamp logging messages: disabled
Trap logging: level informational, 771 message lines logged
Log Buffer (200000 bytes):
Jun 13 09:19:42.011: //103034/C7838B198002/H323/setup_ind: Receive bearer cap infoXRate
24, rateMult 12
Jun 13 09:19:42.011: //103034/C7838B198002/H323/cch323_set_h245_state_mc_mode_incoming:
h245 state m/c mode=0x10F, h323_ctl=0x2F
Jun 13 09:19:42.015: //-1/xxxxxxxxxxxx/H323/cch245_event_handler: callID=103034
Jun 13 09:19:42.019: //-1/xxxxxxxxxxxx/H323/cch245_event_handler: Event
CC_EV_H245_SET_MODE: data ptr=0x465D5760
Jun 13 09:19:42.019: //-1/xxxxxxxxxxxx/H323/cch323_set_mode: callID=103034, flow Mode=1
spi_mode=0x6
Jun 13 09:19:42.019: //103034/C7838B198002/H323/cch323_do_call_proceeding: set_mode NOT
called yet...saved deferred CALL_PROC
Jun 13 09:19:42.019: //103034/C7838B198002/H323/cch323_h245_connection_sm: state=0,
event=0, ccb=4461B518, listen state=0
Jun 13 09:19:42.019: //103034/C7838B198002/H323/cch323_process_set_mode: Setting inbound
leg mode flags to 0x10F, flow-mode to FLOW_THROUGH
Jun 13 09:19:42.019: //103034/C7838B198002/H323/cch323_process_set_mode: Sending deferred
CALL_PROC
Jun 13 09:19:42.019: //103034/C7838B198002/H323/cch323_do_call_proceeding: set_mode called
so we can proceed with CALLPROC
Jun 13 09:19:42.027: //103034/C7838B198002/H323/cch323_h245_connection_sm: state=1,
event=2, ccb=4461B518, listen state=1
Jun 13 09:19:42.027: //103034/C7838B198002/H323/cch323_send_cap_request: Setting mode to
VIDEO MODE
Jun 13 09:19:42.031: //103034/C7838B198002/H323/cch323_h245_cap_ind: Masks au=0xC data=0x2
uinp=0x32
Related Commands Command Description
debug ephone video Sets video debugging for the Cisco Unified IP phone.
show call active video Displays call information for SCCP video calls in progress.
Cisco Unified CME Commands: Debug
debug cch323video
299
Cisco Unified CME Command Reference
OL-10894-01
show call history video Displays call history information for SCCP video calls.
show debugging Displays information about the types of debugging that are enabled for your
router.
Command (continued) Description
Cisco Unified CME Commands: Debug
debug credentials
300
Cisco Unified CME Command Reference
OL-10894-01
debug credentials
To set debugging on the credentials service that runs between the Cisco Unified CME CTL provider and
CTL client or between the Cisco Unified SRST router and Cisco Unified CallManager, use the debug
credentials command in privileged EXEC mode. To disable debugging output, use the no form of this
command.
debug credentials
no debug credentials
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History
Usage Guidelines Cisco Unified CME
Use this command with Cisco Unified CME phone authentication to monitor a CTL provider as it
provides credentials to the CTL client.
Cisco Unified SRST
Use this command to monitor Cisco Unified CallManager while it requests certificates from the
Cisco Unified SRST router. It sets debugging on the credentials service that runs between the SRST
router and Cisco Unified CallManager
Examples Cisco Unified CME
The following sample output displays the CTL provider establishing a TLS session with the CTL client
and providing all the relevant credentials for the services that are running on this router to the CTL client.
Router# debug credentials
Credentials server debugging is enabled
May 25 12:08:17.944: Credentials service: Start TLS Handshake 1 10.5.43.174 4374
May 25 12:08:17.948: Credentials service: TLS Handshake returns OPSSLReadWouldBlockErr
May 25 12:08:18.948: Credentials service: TLS Handshake returns OPSSLReadWouldBlockErr
May 25 12:08:19.948: Credentials service: TLS Handshake returns OPSSLReadWouldBlockErr
May 25 12:08:20.964: Credentials service: TLS Handshake completes
Cisco IOS Release Modification
12.3(14)T This command was introduced for Cisco Unified SRST.
12.4(4)XC This command was introduced for Cisco Unified CME.
12.4(9)T This command was integrated into Cisco IOS Release 12.4(9)T for
Cisco Unified CME.
Cisco Unified CME Commands: Debug
debug credentials
301
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified SRST
The following is sample output showing the credentials service that runs between the
Cisco Unified SRST router and Cisco Unified CallManager. The credentials service provides
Cisco Unified CallManager with the certificate from the SRST router.
Router# debug credentials
Credentials server debugging is enabled
Router#
May 25 12:08:17.944: Credentials service: Start TLS Handshake 1 10.5.43.174 4374
May 25 12:08:17.948: Credentials service: TLS Handshake returns OPSSLReadWouldBlockErr
May 25 12:08:18.948: Credentials service: TLS Handshake returns OPSSLReadWouldBlockErr
May 25 12:08:19.948: Credentials service: TLS Handshake returns OPSSLReadWouldBlockErr
May 25 12:08:20.964: Credentials service: TLS Handshake completes
Table 4 describes the significant fields shown in the display.
Related Commands
Table 4 debug credentials Field Descriptions
Field Description
Start TLS Handshake 1
10.5.43.174 4374
Indicates the beginning of the TLS handshake between the secure
Cisco Unified SRST router and Cisco Unified CallManager. In this
example, 1 indicates the socket, 10.5.43.174 is the IP address, and 4374
is the port of Cisco Unified CallManager.
TLS Handshake returns
OPSSLReadWouldBlockErr
Indicates that the handshake is in process.
TLS Handshake completes Indicates that the TLS handshake has finished and that the
Cisco Unified CallManager has received the secure Cisco Unified SRST
device certificate.
Command Description
credentials Enters credentials configuration mode to configure a
Cisco Unified CME CTL provider certificate or a
Cisco Unified SRST router certificate.
ctl-service admin Specifies a user name and password to authenticate the CTL client
during the CTL protocol.
ip source-address
(credentials)
Enables the Cisco Unified CME or SRST router to receive
messages through the specified IP address and port.
show credentials Displays the credentials settings on a Cisco Unified CME or
SRST router.
show debugging Displays information about the types of debugging that are
enabled for your router.
trustpoint (credentials) Specifies the name of the trustpoint to be associated with a
Cisco Unified CME CTL provider certificate or with a
Cisco Unified SRST router certificate.
Cisco Unified CME Commands: Debug
debug cti
302
Cisco Unified CME Command Reference
OL-10894-01
debug cti
To enable debugging on the CTI interface in Cisco Unified CME, use the debug cti command in
privileged EXEC mode. To disable debugging, use the no form of this command.
debug cti {all | callcontrol | core | dmgr | lm | protoif | session | xml}
no debug cti {all | callcontrol | core | dmgr | lm | protoif | session | xml}
Syntax Description
Command Default Debugging on the CTI interface is disabled.
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines This command sets debugging for the CTI interface in Cisco Unified CME.
Examples The following partial output from the debug cti core command shows the events from the time a call is
placed to when the connection is established:
Router# debug cti core
Core CTI debug flags are on
.
.
.
Router#
Jun 17 23:12:09.885: //CTI/PI:cti_frontend_proc [BB5C]: received CC Event [19]:
CC_EV_CALL_INFO
Jun 17 23:12:09.885: //CTI/PI:pi_process_service_event event 19
Jun 17 23:12:09.885: //CTI/PI: got CC_EV_CALL_INFO callID 47964
Jun 17 23:12:09.885: //CTI/PI:pi_parse_service event 0
.
.
.
all All CTI debugging traces.
callcontrol CTI call control debugging traces.
core Basic call debugging traces.
dmgr CTI device manager debugging traces.
lm CTI line monitoring debugging traces.
protoif CTI protocol interface debugging traces.
session CTI session degugging traces.
xml CTI xml debugging traces.
Release Modification
15.0(1)XA This command was introduced.
Cisco Unified CME Commands: Debug
debug cti
303
Cisco Unified CME Command Reference
OL-10894-01
Jun 17 23:12:09.889: //CTI/CC:Fsm_Idle_MakeCall calling 201, called 204
Jun 17 23:12:09.889: //CTI/DMGR:
Jun 17 23:12:09.889: MakeCall event sent to Device Manager.callID 47964, Mac:0019E83B211D,
CallingNum:201, CalledNum:204
Jun 17 23:12:09.889: //CTI/DMGR:
Jun 17 23:12:09.889: MakeCall event sent to skinny server.Mac:0019E83B211D,
CallingNum:201, CalledNum:204
Jun 17 23:12:09.893: //CTI/CM:-- trigger 1, callID 59291, dn 201, reason 0, result 0
Jun 17 23:12:09.893: //CTI/CM: line_info 87674E4C, dn 201
Jun 17 23:12:09.893: //CTI/CM: * cmm_crs_proc_tr_call_orig
Jun 17 23:12:09.893: //CTI/CM:increase_gcid_ref_count 59291 0
Jun 17 23:12:09.893: //CTI/CM: Gcidinfo node Search FAILED
Jun 17 23:12:09.893: //CTI/CM:create_gcidinfo_node 59291
Jun 17 23:12:09.893: //CTI/CM: orig --> callID 59291, line_info 87674E4C, call_inst
88B0B070, gcid 1E2E3483-5ACB11DE-BA9EF925-DF2AFB55
Jun 17 23:12:09.893: === EVENT EV_ORIGINATED
Jun 17 23:12:09.893: 201 --> . cause normal
.
.
.
Jun 17 23:12:19.217: //CTI/PI:pi_process_service_event event 20
Jun 17 23:12:19.217: //CTI/PI: got CC_EV_CALL_INFO_ACK callID 47964
Jun 17 23:12:19.217: //CTI/SM:sm_handle_cc_service event 77
Jun 17 23:12:19.217: //CTI/SM:sm_find_scb_node_by_context context_id 47964
Jun 17 23:12:19.217: //CTI/SM: to return 86B88298
Jun 17 23:12:19.217: //CTI/SM: got CTI_EV_ACK, callID 47964
Jun 17 23:12:19.221: //CTI/PI:cti_frontend_proc [E750]: received CC Event [20]:
CC_EV_CALL_LOOPBACK_DONE
Jun 17 23:12:19.221: //CTI/PI:pi_process_service_event event 20
Jun 17 23:12:19.221: //CTI/PI: got CC_EV_CALL_INFO_ACK callID 59216
Jun 17 23:12:19.221: //CTI/SM:sm_handle_cc_service event 77
Jun 17 23:12:19.221: //CTI/SM:sm_find_scb_node_by_context context_id 59216
Jun 17 23:12:19.221: //CTI/SM: to return 87396644
Jun 17 23:12:19.221: //CTI/SM: got CTI_EV_ACK, callID 59216
UC520#

Cisco Unified CME Commands: Debug
debug cti
304
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
show debugging Displays information about the types of debugging that are enabled for your
router.
Cisco Unified CME Commands: Debug
debug ctl-client
305
Cisco Unified CME Command Reference
OL-10894-01
debug ctl-client
To collect debug information about the CTL client, use the debug ctl-client command in privileged
EXEC configuration mode. To disable collection of debug information, use the no form of this
command.
debug ctl-client
no debug ctl-client
Syntax Description This command has no arguments or keywords.
Command Default Collection of CTL client debug information is disabled.
Command Modes Privileged EXEC
Command History
Usage Guidelines This command is used with Cisco Unified CME phone authentication.
Examples The following example shows debug messages for the CTL client:
Router# debug ctl-client
001954: .Jul 21 18:23:02.136: ctl_client_create_ctlfile:
001955: .Jul 21 18:23:02.272: create_ctl_record: Function 0 Trustpoint cisco1
001956: .Jul 21 18:23:02.276: create_ctl_record: record added for function 0
001957: .Jul 21 18:23:02.276: create_ctl_record: Function 0 Trustpoint sast2
001958: .Jul 21 18:23:02.280: create_ctl_record: record added for function 0
001959: .Jul 21 18:23:02.280: create_ctl_record: Function 1 Trustpoint cisco1
001960: .Jul 21 18:23:02.284: create_ctl_record: record added for function 1
001961: .Jul 21 18:23:02.284: create_ctl_record: Function 3 Trustpoint cisco1
001962: .Jul 21 18:23:02.288: create_ctl_record: record added for function 3
001963: .Jul 21 18:23:02.288: create_ctl_record: Function 4 Trustpoint cisco1
001964: .Jul 21 18:23:02.292: create_ctl_record: record added for function 4
001965: .Jul 21 18:23:02.424: ctl_client_create_ctlfile: Signature length 128
001966: .Jul 21 18:23:02.640: CTL File Created Successfully
Cisco IOS Release Modification
12.4(4)XC This command was introduced.
12.4(9)T This command was integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: Debug
debug ephone alarm
306
Cisco Unified CME Command Reference
OL-10894-01
debug ephone alarm
To set SkinnyStation alarm messages debugging for the Cisco IP phone, use the debug ephone alarm
command in privileged EXEC mode. To disable debugging output, use the no form of this command.
debug ephone alarm [mac-address mac-address]
no debug ephone alarm [mac-address mac-address]
Syntax Description
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone alarm command shows all the SkinnyStation alarm messages sent by the
Cisco IP phone. Under normal circumstances, this message is sent by the Cisco IP phone just before it
registers, and the message has the severity level for the alarm set to “Informational” and contains the
reason for the phone reboot or re-register. This type of message is entirely benign and does not indicate
an error condition.
If the mac-address keyword is not used, the debug ephone alarm command debugs all Cisco IP phones
that are registered to the router. You can remove debugging for the Cisco IP phones that you do not want
to debug by using the mac-address keyword with the no form of this command.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with the Cisco IP phone.
mac-address (Optional) Defines the MAC address of the Cisco IP phone.
mac-address (Optional) Specifies the MAC address of the Cisco IP phone.
Release Modification
12.2(2)XT This command was introduced on the following platforms:
Cisco 1750, Cisco 1751, Cisco 2600 series and
Cisco 3600 series multiservice routers; and
Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(8)T This command was implemented on the Cisco 3725 and
Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and
Cisco 2691 routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone alarm
307
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows a SkinnyStation alarm message that is sent before the Cisco IP phone
registers:
Router# debug ephone alarm
phone keypad reset
CM-closed-TCP
CM-bad-state
Related Commands Command Description
debug ephone detail Sets detail debugging for the Cisco IP phone.
debug ephone error Sets error debugging for the Cisco IP phone.
debug ephone keepalive Sets keepalive debugging for the Cisco IP phone.
debug ephone loopback Sets MWI debugging for the Cisco IP phone.
debug ephone pak Provides voice packet level debugging and prints the contents of
one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the Cisco IP phone.
debug ephone state Sets state debugging for the Cisco IP phone.
debug ephone statistics Sets statistics debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are
enabled for your router.
Cisco Unified CME Commands: Debug
debug ephone blf
308
Cisco Unified CME Command Reference
OL-10894-01
debug ephone blf
To display debugging information for Busy Lamp Field (BLF) presence features, use the debug ephone
blf command in privileged EXEC mode. To disable debugging, use the no form of this command.
debug ephone blf [mac-address mac-address]
no debug ephone blf [mac-address mac-address]
Syntax Description
Command Modes Privileged EXEC
Command History
Usage Guidelines Use this command for troubleshooting BLF speed-dial and BLF call-list features for phones in a
presence service.
Examples The following is sample output from the debug ephone blf command.
Router# debug ephone blf
EPHONE BLF debugging is enabled
*Sep 4 07:18:26.307: skinny_asnl_callback: subID 16 type 4
*Sep 4 07:18:26.307: ASNL_RESP_NOTIFY_INDICATION
*Sep 4 07:18:26.307: ephone-1[1]:ASNL notify indication message, feature index 4, subID
[16]
*Sep 4 07:18:26.307: ephone-1[1]:line status 6, subID [16]
*Sep 4 07:18:26.307: ephone-1[1]:StationFeatureStatV2Message sent, status 2
*Sep 4 07:18:26.307: skinny_asnl_callback: subID 23 type 4
*Sep 4 07:18:26.307: ASNL_RESP_NOTIFY_INDICATION
*Sep 4 07:18:26.307: ephone-2[2]:ASNL notify indication message, feature index 2, subID
[23]
*Sep 4 07:18:26.311: ephone-2[2]:line status 6, subID [23]
*Sep 4 07:18:26.311: ephone-2[2]:StationFeatureStatV2Message sent, status 2
*Sep 4 07:18:28.951: skinny_asnl_callback: subID 16 type 4
*Sep 4 07:18:28.951: ASNL_RESP_NOTIFY_INDICATION
*Sep 4 07:18:28.951: ephone-1[1]:ASNL notify indication message, feature index 4, subID
[16]
*Sep 4 07:18:28.951: ephone-1[1]:line status 1, subID [16]
*Sep 4 07:18:28.951: ephone-1[1]:StationFeatureStatV2Message sent, status 1
*Sep 4 07:18:28.951: skinny_asnl_callback: subID 23 type 4
*Sep 4 07:18:28.951: ASNL_RESP_NOTIFY_INDICATION
*Sep 4 07:18:28.951: ephone-2[2]:ASNL notify indication message, feature index 2, subID
[23]
*Sep 4 07:18:28.951: ephone-2[2]:line status 1, subID [23]
mac-address mac-address (Optional) Specifies the MAC address of a specific IP phone.
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.
Cisco Unified CME Commands: Debug
debug ephone blf
309
Cisco Unified CME Command Reference
OL-10894-01
*Sep 4 07:18:28.951: ephone-2[2]:StationFeatureStatV2Message sent, status 1
Related Commands Command Description
blf-speed-dial Enables BLF monitoring for a speed-dial number on a phone registered to
Cisco Unified CME.
presence call-list Enables BLF monitoring for call lists and directories on phones registered to
a Cisco Unified CME router.
show presence global Displays configuration information about the presence service.
show presence
subscription
Displays information about active presence subscriptions.
Cisco Unified CME Commands: Debug
debug ephone ccm-compatible
310
Cisco Unified CME Command Reference
OL-10894-01
debug ephone ccm-compatible
To display Cisco CallManager notification updates for calls between Cisco CallManager and
Cisco CallManager Express, use the debug ephone ccm-compatible command in privileged EXEC
mode. To disable debugging output, use the no form of this command.
debug ephone ccm-compatible [mac-address mac-address]
no debug ephone ccm-compatible [mac-address mac-address]
Syntax Description
Command Modes Privileged EXEC
Command History
Usage Guidelines This command displays call flow notification information for all calls between Cisco CallManager and
Cisco CallManager Express, but it is most useful for filtering out specific information for transfer and
forward cases. For basic call information, use the debug ephone state command.
If you do not specify the mac-address keyword, the debug ephone ccm-compatible command debugs
all Cisco IP phones that are registered to the router. You can remove debugging for the Cisco IP phones
that you do not want to debug by using the no form of this command with the mac-address keyword.
Debugging can be enabled or disabled on any number of Cisco IP phones. Cisco IP phones that have
debugging enabled are listed in the debug field of the show ephone command output. When debugging
is enabled for a Cisco IP phone, debug output is displayed for all phone extensions (virtual voice ports)
associated with that phone.
Examples The following sample output displays call flow notifications between Cisco CallManager and
Cisco CallManager Express:
Router# debug ephone ccm-compatible
*May 1 04:30:02.650:ephone-2[2]:DtAlertingTone/DtHoldTone - mediaActive reset during
CONNECT
*May 1 04:30:02.654:ephone-2[2]:DtHoldTone - force media STOP state
*May 1 04:30:02.654://93/xxxxxxxxxxxx/CCAPI/ccCallNotify:(callID=0x5D,nData->
bitmask=0x00000007)
*May 1 04:30:02.654://93/xxxxxxxxxxxx/VTSP:(50/0/3):-1:0:5/vtsp_process_event:
vtsp:[50/0/3 (93), S_CONNECT, E_CC_SERVICE_MSG]
*May 1 04:30:02.654://93/xxxxxxxxxxxx/VTSP:(50/0/3):-1:0:5/act_service_msg_dow
n:.
*May 1 04:30:02.658:dn_callerid_update DN 3 number= 12009 name= CCM7960 in state
CONNECTED
*May 1 04:30:02.658:dn_callerid_update (incoming) DN 3 info updated to
*May 1 04:30:02.658:calling= 12009 called= 13003 origCalled=
mac-address mac-address (Optional) Specifies the MAC address of a Cisco IP phone for
debugging.
Release Modification
12.3(7)T This command was introduced.
Cisco Unified CME Commands: Debug
debug ephone ccm-compatible
311
Cisco Unified CME Command Reference
OL-10894-01
*May 1 04:30:02.658:callingName= CCM7960, calledName= , redirectedTo =
*May 1 04:30:02.658:ephone-2[2][SEP003094C2999A]:refreshDisplayLine for line 1
DN 3 chan 1
*May 1 04:30:03.318:ephone-2[2]:DisplayCallInfo incoming call
*May 1 04:30:03.318:ephone-2[2]:Call Info DN 3 line 1 ref 24 called 13003 calling 12009
origcalled 13003 calltype 1
*May 1 04:30:03.318:ephone-2[2]:Original Called Name UUT4PH3
*May 1 04:30:03.318:ephone-2[2]:CCM7960 calling
*May 1 04:30:03.318:ephone-2[2]:UUT4PH3
Related Commands Command Description
debug ephone state Displays call state information.
show debugging Displays information about the types of debugging that are enabled for your
router.
show ephone Displays information about registered Cisco IP phones.
Cisco Unified CME Commands: Debug
debug ephone detail
312
Cisco Unified CME Command Reference
OL-10894-01
debug ephone detail
To set detail debugging for the Cisco IP phone, use the debug ephone detail command in privileged
EXEC mode. To disable debugging output, use the no form of this command.
debug ephone detail [mac-address mac-address]
no debug ephone detail [mac-address mac-address]
Syntax Description
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone detail command includes the error and state levels.
If the mac-address keyword is not used, the debug ephone detail command debugs all Cisco IP phones
that are registered to the router. You can remove debugging for the Cisco IP phones that you do not want
to debug by using the mac-address keyword with the no form of this command.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with the Cisco IP phone.
Examples The following is sample output of detail debugging of the Cisco IP phone with MAC address
0030.94c3.8724. The sample is an excerpt of some of the activities that takes place during call setup,
connected state, active call, and the call being disconnected.
Router# debug ephone detail mac-address 0030.94c3.8724
mac-address (Optional) Defines the MAC address of the Cisco IP phone.
mac-address (Optional) Specifies the MAC address of the Cisco IP phone.
Release Modification
12.1(5)YD This command was introduced on the following platforms:
Cisco 2600 series and Cisco 3600 series multiservice routers, and
Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(2)XT This command was implemented on the Cisco 1750 and
Cisco 1751 multiservice routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T and
implemented on the Cisco 3725 and Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691
routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone detail
313
Cisco Unified CME Command Reference
OL-10894-01
Ephone detail debugging is enabled
1d04h: ephone-1[1]:OFFHOOK
.
.
1d04h: Skinny Call State change for DN 1 SIEZE
.
.
1d04h: ephone-1[1]:SetCallState line 1 DN 1 TsOffHook
.
.
1d04h: ephone-1[1]:SetLineLamp 1 to ON
.
.
1d04h: ephone-1[1]:KeypadButtonMessage 5
.
.
1d04h: ephone-1[1]:KeypadButtonMessage 0
.
.
1d04h: ephone-1[1]:KeypadButtonMessage 0
.
.
1d04h: ephone-1[1]:KeypadButtonMessage 2
.
.
1d04h: ephone-1[1]:Store ReDial digit: 5002
.
SkinnyTryCall to 5002 instance 1
.
.
1d04h: ephone-1[1]:Store ReDial digit: 5002
1d04h: ephone-1[1]:
SkinnyTryCall to 5002 instance 1
.
.
1d04h: Skinny Call State change for DN 1 ALERTING
.
.
1d04h: ephone-1[1]:SetCallState line 1 DN 1 TsRingOut
.
.
1d04h: ephone-1[1]:SetLineLamp 1 to ON
1d04h: SetCallInfo calling dn 1 dn 1
calling [5001] called [5002]
.
.
1d04h: ephone-1[1]: Jane calling
1d04h: ephone-1[1]: Jill
.
.
1d04h: SkinnyUpdateDnState by EFXS_RING_GENERATE
for DN 2 to state RINGING
.
.
1d04h: SkinnyGetCallState for DN 2 CONNECTED
.
.
1d04h: ephone-1[1]:SetLineLamp 3 to ON
1d04h: ephone-1[1]:UpdateCallState DN 1 state 4 calleddn 2
.
.
1d04h: Skinny Call State change for DN 1 CONNECTED
Cisco Unified CME Commands: Debug
debug ephone detail
314
Cisco Unified CME Command Reference
OL-10894-01
.
.
1d04h: ephone-1[1]:OpenReceive DN 1 codec 4:G711Ulaw64k duration 10 ms bytes 80
.
.
1d04h: ephone-1[1]:OpenReceiveChannelAck 1.2.172.21 port=20180
1d04h: ephone-1[1]:Outgoing calling DN 1 Far-ephone-2 called DN 2
1d04h: SkinnyGetCallState for DN 1 CONNECTED
.
.
1d04h: ephone-1[1]:SetCallState line 3 DN 2 TsOnHook
.
.
1d04h: ephone-1[1]:SetLineLamp 3 to OFF
.
.
1d04h: ephone-1[1]:SetCallState line 1 DN 1 TsOnHook
.
.
1d04h: ephone-1[1]:Clean Up Speakerphone state
1d04h: ephone-1[1]:SpeakerPhoneOnHook
1d04h: ephone-1[1]:Clean up activeline 1
1d04h: ephone-1[1]:StopTone sent to ephone
1d04h: ephone-1[1]:Clean Up phone offhook state
1d04h: SkinnyGetCallState for DN 1 IDLE
1d04h: called DN -1, calling DN -1 phone -1
1d04h: ephone-1[1]:SetLineLamp 1 to OFF
1d04h: UnBinding ephone-1 from DN 1
1d04h: UnBinding called DN 2 from DN 1
1d04h: ephone-1[1]:ONHOOK
1d04h: ephone-1[1]:SpeakerPhoneOnHook
1d04h: ephone-1[1]:ONHOOK NO activeline
.
Related Commands. Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the
Cisco IP phone.
debug ephone error Sets error debugging for the Cisco IP phone.
debug ephone keepalive Sets keepalive debugging for the Cisco IP phone.
debug ephone loopback Sets MWI debugging for the Cisco IP phone.
debug ephone pak Provides voice packet level debugging and prints the contents of
one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the Cisco IP phone.
debug ephone state Sets state debugging for the Cisco IP phone.
debug ephone statistics Sets statistics debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are
enabled for your router.
Cisco Unified CME Commands: Debug
debug ephone error
315
Cisco Unified CME Command Reference
OL-10894-01
debug ephone error
To set error debugging for the Cisco IP phone, use the debug ephone error command in privileged
EXEC mode. To disable debugging output, use the no form of this command.
debug ephone error [mac-address mac-address]
no debug ephone error [mac-address mac-address]
Syntax Description
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone error command cancels debugging at the detail and state level.
If the mac-address keyword is not used, the debug ephone error command debugs all Cisco IP phones
that are registered to the router. You can remove debugging for the Cisco IP phones that you do not want
to debug by using the mac-address keyword with the no form of this command.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with the Cisco IP phone.
Examples The following is sample output of error debugging for the Cisco IP phone with MAC address
0030.94c3.8724:
Router# debug ephone error mac-address 0030.94c3.8724
mac-address (Optional) Defines the MAC address of the Cisco IP phone.
mac-address (Optional) Specifies the MAC address of the Cisco IP phone.
Release Modification
12.1(5)YD This command was introduced on the following platforms:
Cisco 2600 series and Cisco 3600 series multiservice routers, and
Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(2)XT This command was implemented on the Cisco 1750 and
Cisco 1751 multiservice routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T and
implemented on the Cisco 3725 and Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691
routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone error
316
Cisco Unified CME Command Reference
OL-10894-01
EPHONE error debugging is enabled
socket [2] send ERROR 11
Skinny Socket [2] retry failure
Related Commands Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the
Cisco IP phone.
debug ephone detail Sets detail debugging for the Cisco IP phone.
debug ephone keepalive Sets keepalive debugging for the Cisco IP phone.
debug ephone loopback Sets MWI debugging for the Cisco IP phone.
debug ephone pak Provides voice packet level debugging and prints the contents of
one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the Cisco IP phone.
debug ephone state Sets state debugging for the Cisco IP phone.
debug ephone statistics Sets statistics debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are
enabled for your router.
Cisco Unified CME Commands: Debug
debug ephone extension-assigner
317
Cisco Unified CME Command Reference
OL-10894-01
debug ephone extension-assigner
To display status messages produced by the extension assigner application, use the debug ephone
extension-assigner command in privileged EXEC mode. To disable debugging output, use the no form
of this command.
debug ephone extension-assigner
no debug ephone extension-assigner
Syntax Description This command has no arguments or keywords.
Command Default Debug ephone extension-assigner is disabled.
Command Modes Privileged EXEC
Command History
Usage Guidelines This command displays status messages produced by the extension assigner application, including
messages related to the functions performed by the following Tcl commands:
• phone query—Verifies whether the ephone tag has been assigned a MAC address.
• phone assign—Binds the MAC address from the caller’s phone to a preexisting ephone template.
• phone unassign—Removes the MAC address from the ephone tag.
Before using this command, you must load the Tcl script for the extension assigner application.
Examples The following is sample output of extension assigner debugging as the extension assigner application
queries phones for their status and issues commands to assign or unassign extension numbers.
*Jun 9 19:08:10.627: ephone_query: inCallID=47, tag=4, ephone_tag=4
*Jun 9 19:08:10.627: extAssigner_IsEphoneMacPreset: ephone_tag = 4,
ipKeyswitch.max_ephones = 96
*Jun 9 19:08:10.627: extAssigner_IsEphoneMacPreset: ephone_ptr->mac_addr_str =
000B46BDE075, MAC_EXT_RESERVED_VALUE = 02EAEAEA0000
*Jun 9 19:08:10.627: SkinnyGetActivePhoneIndexFromCallid: callID = 47
*Jun 9 19:08:10.627: SkinnyGetActivePhoneIndexFromCallid: vdbPtr->physical_interface_type
(26); CV_VOICE_EFXS (26)
*Jun 9 19:08:10.627: SkinnyGetActivePhoneIndexFromCallid: vdbPtr->type (6);
CC_IF_TELEPHONY (6)
*Jun 9 19:08:10.627: SkinnyGetActivePhoneIndexFromCallid: htsp->sig_type (26);
CV_VOICE_EFXS (26)
Cisco IOS Release Cisco Product Modification
12.4(4)XC4 Cisco Unified CME 4.0(3) This command was introduced.
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.
Cisco Unified CME Commands: Debug
debug ephone extension-assigner
318
Cisco Unified CME Command Reference
OL-10894-01
*Jun 9 19:08:10.627: SkinnyGetActivePhoneIndexFromCallid: dn = 4, chan = 1
*Jun 9 19:08:10.627: ephone_query: EXTASSIGNER_RC_SLOT_ASSIGNED_TO_CALLING_PHONE
*Jun 9 19:08:22.763: ephone_unassign: inCallID=47, tag=4, ephone_tag=4
*Jun 9 19:08:22.763: extAssigner_IsEphoneMacPreset: ephone_tag = 4,
ipKeyswitch.max_ephones = 96
*Jun 9 19:08:22.763: extAssigner_IsEphoneMacPreset: ephone_ptr->mac_addr_str =
000B46BDE075, MAC_EXT_RESERVED_VALUE = 02EAEAEA000
*Jun 9 19:08:22.763: is_ephone_auto_assigned: button-1 dn_tag=4
*Jun 9 19:08:22.763: is_ephone_auto_assigned: NO
*Jun 9 19:08:22.763: SkinnyGetActivePhoneIndexFromCallid: callID = 47
*Jun 9 19:08:22.763: SkinnyGetActivePhoneIndexFromCallid: vdbPtr->physical_interface_type
(26); CV_VOICE_EFXS (26)
*Jun 9 19:08:22.767: SkinnyGetActivePhoneIndexFromCallid: vdbPtr->type (6);
CC_IF_TELEPHONY (6)
*Jun 9 19:08:22.767: SkinnyGetActivePhoneIndexFromCallid: htsp->sig_type (26);
CV_VOICE_EFXS (26)
*Jun 9 19:08:22.767: SkinnyGetActivePhoneIndexFromCallid: dn = 4, chan = 1
*Jun 9 19:08:29.795: ephone-4[8]:fStationOnHookMessage: Extension Assigner request
restart, cmd=2, new mac=02EAEAEA0004, ephone_tag=4
*Jun 9 19:08:30.063: %IPPHONE-6-UNREGISTER_NORMAL: ephone-4:SEP000B46BDE075 IP:5.5.0.1
Socket:8 DeviceType:Phone has unregistered normally.
*Jun 9 19:08:30.063: ephone-4[8][SEP000B46BDE075]:extAssigner_assign: new
mac=02EAEAEA0004, ephone-tag=4
*Jun 9 19:08:30.063: extAssigner_simple_assign: mac=02EAEAEA0004, tag=4
*Jun 9 19:08:30.063: ephone_updateCNF: update cnf_file ephone_tag=4
*Jun 9 19:08:30.063: extAssigner_assign: restart again (mac=02EAEAEA0004) ephone_tag=4
*Jun 9 19:08:30.131: %IPPHONE-6-REG_ALARM: 23: Name=SEP000B46BDE075 Load=8.0(2.0)
Last=Reset-Restart
*Jun 9 19:08:30.135: %IPPHONE-6-REGISTER_NEW: ephone-7:SEP000B46BDE075 IP:5.5.0.1
Socket:10 DeviceType:Phone has registered.
*Jun 9 19:08:30.503: %IPPHONE-6-UNREGISTER_NORMAL: ephone-7:SEP000B46BDE075 IP:5.5.0.1
Socket:10 DeviceType:Phone has unregistered normally.
*Jun 9 19:08:43.127: %IPPHONE-6-REG_ALARM: 22: Name=SEP000B46BDE075 Load=8.0(2.0)
Last=Reset-Reset
*Jun 9 19:08:43.131: %IPPHONE-6-REGISTER: ephone-7:SEP000B46BDE075 IP:5.5.0.1 Socket:13
DeviceType:Phone has registered.
Related Commands Command Description
debug ephone state Sets state debugging for Cisco IP phones.
debug voip application
script
Displays status messages produced by voice over IP application scripts.
Cisco Unified CME Commands: Debug
debug ephone keepalive
319
Cisco Unified CME Command Reference
OL-10894-01
debug ephone keepalive
To set keepalive debugging for the Cisco IP phone, use the debug ephone keepalive command in
privileged EXEC mode. To disable debugging output, use the no form of this command.
debug ephone keepalive [mac-address mac-address]
no debug ephone keepalive [mac-address mac-address]
Syntax Description
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone keepalive command sets keepalive debugging.
If the mac-address keyword is not used, the debug ephone keepalive command debugs all
Cisco IP phones that are registered to the router. You can remove debugging for the Cisco IP phones that
you do not want to debug by using the mac-address keyword with the no form of this command.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with the Cisco IP phone.
Examples The following is sample output of the keepalive status for the Cisco IP phone with MAC address
0030.94C3.E1A8:
Router# debug ephone keepalive mac-address 0030.94c3.E1A8
mac-address (Optional) Defines the MAC address of the Cisco IP phone.
mac-address (Optional) Specifies the MAC address of the Cisco IP phone.
Release Modification
12.1(5)YD This command was introduced on the following platforms:
Cisco 2600 series and Cisco 3600 series multiservice routers, and
Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(2)XT This command was implemented on the Cisco 1750 and
Cisco 1751 multiservice routers.
12.2(8)T This command was implemented on the Cisco 3725 and Cisco 3745
routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691
routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone keepalive
320
Cisco Unified CME Command Reference
OL-10894-01
EPHONE keepalive debugging is enabled for phone 0030.94C3.E1A8
1d05h: ephone-1 Set interface FastEthernet0/0 ETHERNET
1d05h: ephone-1[1]:Keepalive socket[1] SEP003094C3E1A8
1d05h: ephone-1 Set interface FastEthernet0/0 ETHERNET
1d05h: ephone-1[1]:Keepalive socket[1] SEP003094C3E1A8
1d05h: Skinny Checking for stale sockets
1d05h: ephone-1 Set interface FastEthernet0/0 ETHERNET
1d05h: ephone-1[1]:Keepalive socket[1] SEP003094C3E1A8
1d05h: ephone-1 Set interface FastEthernet0/0 ETHERNET
1d05h: ephone-1[1]:Keepalive socket[1] SEP003094C3E1A8
1d05h: Skinny active socket list (3/96): 1 2 4
Related Commands Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the
Cisco IP phone.
debug ephone detail Sets detail debugging for the Cisco IP phone.
debug ephone error Sets error debugging for the Cisco IP phone.
debug ephone loopback Sets MWI debugging for the Cisco IP phone.
debug ephone pak Provides voice packet level debugging and prints the contents of
one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the Cisco IP phone.
debug ephone state Sets state debugging for the Cisco IP phone.
debug ephone statistics Sets statistics debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are
enabled for your router.
Cisco Unified CME Commands: Debug
debug ephone loopback
321
Cisco Unified CME Command Reference
OL-10894-01
debug ephone loopback
To set debugging for loopback calls, use the debug ephone loopback command in privileged EXEC
mode. To disable debugging, use the no form of this command.
debug ephone loopback [mac-address mac-address]
no debug ephone loopback [mac-address mac-address]
Syntax Description
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone loopback command sets debugging for incoming and outgoing calls on all
loopback-dn pairs or on the single loopback-dn pair that is associated with the IP phone that has the
MAC address specified in this command.
If you enable the debug ephone loopback command and the debug ephone pak command at the same
time, the output displays packet debug output for the voice packets that are passing through the
loopback-dn pair.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with that Cisco IP phone.
Examples The following example contains two excerpts of output for a call that is routed through a loopback. The
first excerpt is output from the show running-config command and displays the loopback configuration
used for this example. The second excerpt is output from the debug ephone loopback command.
Router# show running-config
.
.
.
mac-address mac-address (Optional) Specifies the MAC address of a Cisco IP phone
for debugging.
Release Modification
12.2(2)XT This command was introduced for Cisco IOS Telephony Services
(now known as Cisco CallManager Express) Version 2.0 on the Cisco 1750,
Cisco 1751, Cisco 2600 series, Cisco 3600 series, and Cisco IAD2420
series.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T and
implemented on the Cisco 3725 and Cisco 3745.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691.
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T.
Cisco Unified CME Commands: Debug
debug ephone loopback
322
Cisco Unified CME Command Reference
OL-10894-01
ephone-dn 14
number 1514
!
!
ephone-dn 42
number 17181..
loopback-dn 43 forward 4
no huntstop
!
!
ephone-dn 43
number 19115..
loopback-dn 42 forward 4
!
.
.
.
A loopback call is started. An incoming call to 1911514 (ephone-dn 43) uses the loopback pair of
ephone-dns to become an outgoing call to extension 1514. The number in the outgoing call has only four
digits because the loopback-dn command specifies forwarding of four digits. The outgoing call uses
ephone-dn 42, which is also specified in the loopback-dn command under ephone-dn 43. When the
extension at 1514 rings, the following debug output is displayed:
Router# debug ephone loopback
Mar 7 00:57:25.376:Pass processed call info to special DN 43 chan 1
Mar 7 00:57:25.376:SkinnySetCallInfoLoopback DN 43 state IDLE to DN 42 state IDLE
Mar 7 00:57:25.376:Called Number = 1911514 Called Name =
Mar 7 00:57:25.376:Calling Number = 8101 Calling Name =
orig Called Number =
Copy Caller-ID info from Loopback DN 43 to DN 42
Mar 7 00:57:25.376:DN 43 Forward 1514
Mar 7 00:57:25.376:PredictTarget match 1514 DN 14 is idle
Mar 7 00:57:25.380:SkinnyUpdateLoopbackState DN 43 state RINGING calledDn -1
Mar 7 00:57:25.380:Loopback DN 42 state IDLE
Mar 7 00:57:25.380:Loopback DN 43 calledDN -1 callingDn -1 G711Ulaw64k
Mar 7 00:57:25.380:SkinnyUpdateLoopbackState DN 43 to DN 42 signal OFFHOOK
Mar 7 00:57:25.380:SetDnCodec Loopback DN 43 codec 4:G711Ulaw64k vad 0 size 160
Mar 7 00:57:25.380:SkinnyDnToneLoopback DN 42 state SIEZE to DN 43 state RINGING
Mar 7 00:57:25.380:TONE ON DtInsideDialTone
Mar 7 00:57:25.380:SkinnyDnToneLoopback called number = 1911514
Mar 7 00:57:25.380:DN 43 Forward 1514
Mar 7 00:57:25.380:DN 42 from 43 Dial 1514
Mar 7 00:57:25.384:SkinnyDnToneLoopback DN 42 state ALERTING to DN 43 state RINGING
Mar 7 00:57:25.384:TONE OFF
Mar 7 00:57:25.384:SkinnyDnToneLoopback DN 42 state ALERTING to DN 43 state RINGING
Mar 7 00:57:25.384:TONE OFF
Mar 7 00:57:25.384:SkinnyUpdateLoopbackState DN 42 state ALERTING calledDn -1
Mar 7 00:57:25.384:Loopback DN 43 state RINGING
Mar 7 00:57:25.384:Loopback Alerting DN 42 calledDN -1 callingDn -1 G711Ulaw64k
Mar 7 00:57:25.388:ephone-5[7]:DisplayCallInfo incoming call
Mar 7 00:57:25.388:SkinnyDnToneLoopback DN 42 state ALERTING to DN 43 state RINGING
Mar 7 00:57:25.388:TONE ON DtAlertingTone
Mar 7 00:57:25.388:SkinnyDnToneLoopback DN 42 to DN 43 deferred alerting by
DtAlertingTone
Mar 7 00:57:25.388:EFXS_STATE_ONHOOK_RINGING already done for DN 43 chan 1
Mar 7 00:57:25.388:Set prog_ind 0 for DN 42 chan 1
.
.
.
When extension 1514 answers the call, the following debug output is displayed:
Cisco Unified CME Commands: Debug
debug ephone loopback
323
Cisco Unified CME Command Reference
OL-10894-01
.
.
.
Mar 7 00:57:32.158:SkinnyDnToneLoopback DN 42 state ALERTING to DN 43 state RINGING
Mar 7 00:57:32.158:TONE OFF
Mar 7 00:57:32.158:dn_support_g729 true DN 42 chan 1 (loopback)
Mar 7 00:57:32.158:SetDnCodec Loopback DN 43 codec 4:G711Ulaw64k vad 0 size 160
Mar 7 00:57:32.158:SkinnyUpdateLoopbackState DN 42 state CALL_START calledDn 14
Mar 7 00:57:32.158:Loopback DN 43 state RINGING
Mar 7 00:57:32.158:SkinnyUpdateLoopbackState DN 42 to DN 43 deferred alerting by
CALL_START already sent
Mar 7 00:57:32.158:SetDnCodec reassert defer_start for DN 14 chan 1
Mar 7 00:57:32.158:Delay media until loopback DN 43 is ready
Mar 7 00:57:32.158:SkinnyUpdateLoopbackCodec check for DN 14 chan 1 from DN 42 loopback
DN 43
Mar 7 00:57:32.158:SkinnyUpdateLoopbackCodec DN chain is 14 1, other=42, lb=43, far=-1 1,
final=43 1
Mar 7 00:57:32.158:SkinnyUpdateLoopbackCodec DN 14 chan 1 DN 43 chan 1 codec 4 match
Mar 7 00:57:32.162:SkinnyUpdateLoopbackState DN 42 state CONNECTED calledDn 14
Mar 7 00:57:32.162:Loopback DN 43 state RINGING
Mar 7 00:57:32.162:SkinnyUpdateLoopbackState DN 42 to DN 43 signal ANSWER
Mar 7 00:57:32.162:Loopback DN 42 calledDN 14 callingDn -1 G711Ulaw64k
Mar 7 00:57:32.162:Loopback DN 43 calledDN -1 callingDn -1 incoming G711Ulaw64k
Mar 7 00:57:32.162:ephone-5[7][SEP000DBDBEF37D]:refreshDisplayLine for line 1 DN 14 chan
1
Mar 7 00:57:32.162:dn_support_g729 true DN 43 chan 1 (loopback)
Mar 7 00:57:32.162:SetDnCodec Loopback DN 42 codec 4:G711Ulaw64k vad 0 size 160
Mar 7 00:57:32.162:SkinnyUpdateLoopbackState DN 43 state CALL_START calledDn -1
Mar 7 00:57:32.162:Loopback DN 42 state CONNECTED
Mar 7 00:57:32.162:SkinnyUpdateLoopbackState DN 43 has defer_dn 14 chan 1 set
Mar 7 00:57:32.162:SkinnyUpdateLoopbackState DN 43 has defer_dn 14 chan 1:
-invoke SkinnyOpenReceive
Mar 7 00:57:32.162:SkinnyUpdateLoopbackCodec check for DN 14 chan 1 from DN 42 loopback
DN 43
Mar 7 00:57:32.162:SkinnyUpdateLoopbackCodec DN chain is 14 1, other=42, lb=43, far=-1 1,
final=43 1
Mar 7 00:57:32.162:SkinnyUpdateLoopbackCodec DN 14 chan 1 DN 43 chan 1 codec 4 match
Mar 7 00:57:32.162:SkinnyUpdateLoopbackState DN 43 state CALL_START calledDn -1
Mar 7 00:57:32.162:Loopback DN 42 state CONNECTED
Mar 7 00:57:32.454:SkinnyGetDnAddrInfo DN 43 LOOPBACK
update media address to 10.0.0.6 25390 from DN 14
Mar 7 00:57:33.166:ephone-5[7]:DisplayCallInfo incoming call
.
.
.
When the called extension, 1514, goes back on-hook, the following debug output is displayed:
.
.
.
Mar 7 00:57:39.224:Loopback DN 42 disc reason 16 normal state CONNECTED
Mar 7 00:57:39.224:SkinnyUpdateLoopbackState DN 42 state CALL_END calledDn -1
Mar 7 00:57:39.224:Loopback DN 43 state CONNECTED
Mar 7 00:57:39.224:SkinnyUpdateLoopbackState DN 42 to DN 43 signal ONHOOK
Mar 7 00:57:39.236:SkinnyDnToneLoopback DN 42 state IDLE to DN 43 state IDLE
Mar 7 00:57:39.236:TONE OFF
Mar 7 00:57:39.236:SkinnyDnToneLoopback DN 43 state IDLE to DN 42 state IDLE
Mar 7 00:57:39.236:TONE OFF
Table 5 describes the significant fields shown in the display.
Cisco Unified CME Commands: Debug
debug ephone loopback
324
Cisco Unified CME Command Reference
OL-10894-01
Table 5 debug ephone loopback Field Descriptions
Field Description
Called Number Original called number as presented to the incoming side of the loopback-dn.
Forward Outgoing number that is expected to be dialed by the outgoing side of the
loopback-dn pair.
PredictTarget Match Extension (ephone-dn) that is anticipated by the loopback-dn to be the
far-end termination for the call.
signal OFFHOOK Indicates that the outgoing side of the loopback-dn pair is going off-hook
prior to placing the outbound call leg.
Dial Outbound side of the loopback-dn that is actually dialing the outbound call
leg.
deferred alerting Indicates that the alerting, or ringing, tone is returning to the original
inbound call leg in response to the far-end ephone-dn state.
DN chain Chain of ephone-dns that has been detected, starting from the far-end that
terminates the call. Each entry in the chain indicates an ephone-dn tag and
channel number. Entries appear in the following order, from left to right:
• Ephone-dn tag and channel of the far-end call terminator (in this
example, ephone-dn 14 is extension 1514).
• other—Ephone-dn tag of the outgoing side of the loopback.
• lb—Ephone-dn tag of the incoming side of the loopback.
• far—Ephone-dn tag and channel of the far-end call originator, or -1 for
a nonlocal number.
• final—Ephone-dn tag for the originator of the call on the incoming side
of the loopback. If the originator is not a local ephone-dn, this is set
to -1. This number represents the final ephone-dn tag in the chain,
looking toward the originator.
codec match Indicates that there is no codec conflict between the two calls on either side
of the loopback-dn.
GetDnAddrInfo IP address of the IP phone at the final destination extension (ephone-dn),
after resolving the chain of ephone-dns involved.
disc_reason Disconnect cause code, in decimal. These are normal CC_CAUSE code
values that are also used in call control API debugging. Common cause
codes include the following:
• 16—Normal disconnect.
• 17—User busy.
• 19—No answer.
• 28—Invalid number.
Cisco Unified CME Commands: Debug
debug ephone loopback
325
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
debug ephone pak Provides voice packet level debugging.
loopback-dn Configures loopback-dn virtual loopback voice ports used to
establish demarcation points for VoIP voice calls and
supplementary services.
show ephone Displays information about registered Cisco IP phones.
show ephone-dn loopback Displays information for ephone-dns that have been set up for
loopback calls.
Cisco Unified CME Commands: Debug
debug ephone lpcor
326
Cisco Unified CME Command Reference
OL-10894-01
debug ephone lpcor
To display debugging information for calls using the logical partitioning class of restriction (LPCOR)
feature, use the debug ephone lpcor command in privileged EXEC mode. To disable debugging, use the
no form of this command.
debug ephone lpcor [mac-address mac-address]
no debug ephone lpcor [mac-address mac-address]
Syntax Description
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines Use this command for troubleshooting LPCOR calls to phones in a Cisco Unified CME system.
If the mac-address keyword is not used, this command debugs all phones that are registered to the
Cisco Unified CME router. You can disable debugging for specific phones by using the mac-address
keyword with the no form of this command.
Examples The following is sample output from the debug ephone lpcor command for a call between ephone-1 and
ephone-2 that was blocked by LPCOR policy validation:
Router# debug ephone lpcor
*Jun 24 11:23:45.599: ephone-1[0/3][SEP003094C25F38]:ephone_get_lpcor_index: dir 0
*Jun 24 11:23:46.603: ephone-2[1/2][SEP0021A02DB62A]:ephone_get_lpcor_index: dir 1
Related Commands
mac-address mac-address (Optional) Specifies the MAC address of a specific IP phone.
Release Modification
15.0(1)XA This command was introduced.
Command Description
debug voip application
lpcor
Enables debugging of the LPCOR application system.
debug voip lpcor Displays debugging information for the LPCOR feature.
lpcor incoming Associates an incoming call with a LPCOR resource-group policy.
lpcor outgoing Associates an outgoing call with a LPCOR resource-group policy.
show ephone Displays information about phones registered to Cisco Unified CME.
show voice lpcor policy Displays the LPCOR policy for the specified resource group.
Cisco Unified CME Commands: Debug
debug ephone message
327
Cisco Unified CME Command Reference
OL-10894-01
debug ephone message
To enable message tracing between ephones, use the debug ephone message command in privileged
EXEC mode. To disable debugging output, use the no form of this command.
debug ephone message [detail]
no debug ephone message
Syntax Description
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone message command enables message tracing between ephones.
The debug ephone command debugs all ephones associated with a Cisco Unified CME router.
You can enable or disable debugging on any number of ephones. To see the ephones that have debugging
enabled, enter the show ephone command and look at the debug field in the output. When debugging is
enabled for a ephone, the debug output is displayed for the directory numbers associated with the
ephone.
Examples The following is sample output for the debug ephone message command for ephones:
Router# debug ephone message
EPHONE skinny message debugging is enabled
*Jul 17 12:12:54.883: Received message from phone 7, SkinnyMessageID = StationKe
epAliveMessageID
*Jul 17 12:12:54.883: Sending message to phone 7, SkinnyMessageID = StationKe
epAliveAckMessageID
The following command disables ephone message debugging:
Router# no debug ephone message
EPHONE skinny message debugging is disabled
Related Commands
detail (Optional) Displays signaling connection control protocol (SCCP) messages
sent and received between ephones in the Cisco Unified CallManager
Express (Cisco Unified CME) system.
Cisco IOS Release Modification
12.4(4)XC This command was introduced.
12.4(9)T This command was integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: Debug
debug ephone message
328
Cisco Unified CME Command Reference
OL-10894-01
Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the ephone.
debug ephone detail Sets detail debugging for the ephone.
debug ephone error Sets error debugging for the ephone.
debug ephone mwi Sets MWI debugging for the ephone.
debug ephone pak Provides voice packet level debugging and displays the contents
of one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the ephone.
debug ephone state Sets state debugging for the ephone.
debug ephone statistics Sets statistics debugging for the ephone.
debug ephone video Sets video debugging for the ephone.
show debugging Displays information about the types of debugging that are
enabled for your router.
show ephone Displays information about ephones.
Cisco Unified CME Commands: Debug
debug ephone mlpp
329
Cisco Unified CME Command Reference
OL-10894-01
debug ephone mlpp
To display debugging information for Multilevel Precedence and Preemption (MLPP) calls to phones in
a Cisco Unified CME system, use the debug ephone mlpp command in privileged EXEC mode. To
disable debugging, use the no form of this command.
debug ephone mlpp [mac-address mac-address]
no debug ephone mlpp [mac-address mac-address]
Syntax Description
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines Use this command to troubleshoot calls that use the MLPP service.
Examples The following is sample output from the debug ephone mlpp command. This example shows output for
the following call scenario:
• Ephone 1 is connected to ephone 3 (nonMLPP call).
• Ephone 4 makes an MLPP call to ephone 3. Preemption tone is played to both ephone 1 and 3.
• Ephone 3 is disconnected after the preemption tone timeout and precedence ringing.
• Ephone 3 answers the MLPP call and is connected to ephone 4.
Router# debug ephone mlpp

Sep 5 14:23:00.499: ephone-4[3/3][SEP001AE2BC3EE7]:indication=1
Sep 5 14:23:00.499: ephone-4[3/3][SEP001AE2BC3EE7]:max precedence=0
Sep 5 14:23:02.299: ephone-4[3/3][SEP001AE2BC3EE7]:mlpp_ephone_display_update callID=294
Sep 5 14:23:02.299: ephone-4[3/3][SEP001AE2BC3EE7]:indication=1
Sep 5 14:23:02.299: ephone-4[3/3][SEP001AE2BC3EE7]:mlpp precedence=4, domain=0
Sep 5 14:23:02.303: ephone-3[2/1][SEP001B54BA0D64]:preemption=1
Sep 5 14:23:02.303: ephone-3[2/1][SEP001B54BA0D64]:preemption=1
Sep 5 14:23:02.303: mlpp_ephone_find_call: preempt_htsp=1774234732,
prempt_htsp->mlpp_preemptor_cid=294
Sep 5 14:23:02.303: //294/A6B5C03A8141/VOIP-MLPP/voice_mlpp_get_preemptInfo:
mlpp_ephone_find_call is successful
Sep 5 14:23:02.303: ephone-4[3/3][SEP001AE2BC3EE7]:indication=1
Sep 5 14:23:02.303: ephone-4[3/3][SEP001AE2BC3EE7]:mlpp precedence=4, domain=0
Sep 5 14:23:02.303: ephone-4[3/3][SEP001AE2BC3EE7]:indication=1
Sep 5 14:23:02.303: ephone-4[3/3][SEP001AE2BC3EE7]:mlpp precedence=4, domain=0
Sep 5 14:23:02.303: ephone-6[5/6][SEP0018187F49FD]:indication=1
Sep 5 14:23:02.303: ephone-6[5/6][SEP0018187F49FD]:mlpp precedence=4, domain=0
mac-address mac-address (Optional) Specifies the MAC address of a specific IP phone.
Release Modification
12.4(22)YB This command was introduced.
12.4(24)T This command was integrated into Cisco IOS Release 12.4(24)T .
Cisco Unified CME Commands: Debug
debug ephone mlpp
330
Cisco Unified CME Command Reference
OL-10894-01
Sep 5 14:23:02.303: ephone-4[3/3][SEP001AE2BC3EE7]:indication=1
Sep 5 14:23:02.307: ephone-1[0/2][SEP0014A9818797]:indication=1
Sep 5 14:23:02.307: ephone-3[2/1][SEP001B54BA0D64]:indication=1
Sep 5 14:23:02.307: ephone-1[0/2][SEP0014A9818797]:indication=1DtPreemptionTone
Sep 5 14:23:02.307: ephone-3[2/1][SEP001B54BA0D64]:indication=1DtPreemptionTone
Sep 5 14:23:07.307: ephone-3[2/1][SEP001B54BA0D64]:indication=1
Sep 5 14:23:07.307: ephone-1[0/2][SEP0014A9818797]:indication=1
Sep 5 14:23:07.319: ephone-3[2/1][SEP001B54BA0D64]:indication=1
Sep 5 14:23:07.319: ephone-3[2/1][SEP001B54BA0D64]:indication=1
Sep 5 14:23:07.319: ephone-3[2/1][SEP001B54BA0D64]:mlpp precedence=4, domain=0
Sep 5 14:23:07.319: ephone-3[2/1][SEP001B54BA0D64]:indication=1
Sep 5 14:23:07.319: ephone-3[2/1][SEP001B54BA0D64]: MLPP Precedence Ring 6 instead
Sep 5 14:23:10.623: ephone-3[2/1][SEP001B54BA0D64]:indication=1
Sep 5 14:23:10.623: ephone-3[2/1][SEP001B54BA0D64]:indication=1
Sep 5 14:23:10.623: ephone-3[2/1][SEP001B54BA0D64]:mlpp precedence=4, domain=0
Sep 5 14:23:10.623: ephone-3[2/1][SEP001B54BA0D64]:indication=1
Sep 5 14:23:10.623: ephone-3[2/1][SEP001B54BA0D64]:mlpp precedence=4, domain=0
Sep 5 14:23:10.623: ephone-4[3/3][SEP001AE2BC3EE7]:indication=1
Sep 5 14:23:10.623: ephone-4[3/3][SEP001AE2BC3EE7]:mlpp precedence=4, domain=0
Sep 5 14:23:10.623: ephone-6[5/6][SEP0018187F49FD]:indication=1
Sep 5 14:23:10.623: ephone-6[5/6][SEP0018187F49FD]:mlpp precedence=4, domain=0
Related Commands Command Description
debug voice mlpp Displays debugging information for MLPP service.
mlpp indication Enables MLPP indication on an SCCP phone or analog FXS port.
mlpp max-precedence Sets the maximum precedence (priority) level that a phone user can
specify when making an MLPP call.
mlpp preemption Enables preemption capability on an SCCP phone or analog FXS port.
Cisco Unified CME Commands: Debug
331
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: Debug
debug ephone moh
332
Cisco Unified CME Command Reference
OL-10894-01
debug ephone moh
To set debugging for music on hold (MOH), use the debug ephone moh command in privileged EXEC
mode. To disable debugging, use the no form of this command.
debug ephone moh [mac-address mac-address]
no debug ephone moh [mac-address mac-address]
Syntax Description
Command Modes Privileged EXEC
Command History
Usage Guidelines Always use the no moh command before modifying or replacing the MOH file in Flash memory.
When a configuration using the multicast moh command is used and the debug ephone moh command
is enabled, if you delete or modify the MOH file in the router's Flash memory, the debug output can be
excessive and can flood the console. The multicast MOH configuration should be removed before using
the no moh command when the debug ephone moh command is enabled.
Examples The following sample output shows MOH activity prior to the first MOH session. Note that if you enable
multicast MOH, that counts as the first session.
Router# debug ephone moh
Mar 7 00:52:33.817:MOH AU file
Mar 7 00:52:33.817:skinny_open_moh_play set type to 3
Mar 7 00:52:33.825: 2E73 6E64 0000 0018 0007 3CCA 0000 0001
Mar 7 00:52:33.825: 0000 1F40 0000 0001 FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
mac-address mac-address (Optional) Specifies the MAC address of a Cisco IP phone
for debugging.
Release Modification
12.2(2)XT This command was introduced for Cisco IOS Telephony Services
(now known as Cisco CallManager Express) Version 2.0 and Cisco
Survivable Remote Site Telephony (SRST) Version 2.0 on the
Cisco 1750, Cisco 1751, Cisco 2600 series, Cisco 3600 series, and
Cisco IAD2420 series.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T and
implemented on the Cisco 3725 and Cisco 3745.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and
Cisco 2691.
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T.
Cisco Unified CME Commands: Debug
debug ephone moh
333
Cisco Unified CME Command Reference
OL-10894-01
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Mar 7 00:52:33.825:
Mar 7 00:52:33.825:AU file processing Found .snd
Mar 7 00:52:33.825:AU file data start at 24 end at 474338
Mar 7 00:52:33.825:AU file codec Media_Payload_G711Ulaw64k
Mar 7 00:52:33.825:MOH read file header type AU start 24 end 474338
Mar 7 00:52:33.825:MOH pre-read block 0 at write-offset 0 from 24
Mar 7 00:52:33.833:MOH pre-read block 1 at write-offset 8000 from 8024
Mar 7 00:52:33.845:Starting read server with play-offset 0 write-offset 16000
Table 6 describes the significant fields shown in the display.
Related Commands
Table 6 debug ephone moh Field Descriptions
Field Description
type 0—invalid
1—raw file
2—wave format file (.wav)
3—AU format (.au)
4—live feed
AU file processing Found .snd A .snd header was located in the AU file.
AU file data start at, end at Data start and end file offset within the MOH file, as
indicated by the file header.
read file header type File format found (AU, WAVE, or RAW).
pre-read block, write-offset Location in the internal MOH buffer to which data is being
written, and location from which that data was read in the
file.
play-offset, write-offset Indicates the relative positioning of MOH file read-ahead
buffering. Data is normally written from a Flash file into the
internal circular buffer, ahead of the location from which
data is being played or output.
Command Description
moh
(telephony-service)
Generates an audio stream from a file for MOH in a Cisco CME system.
multicast moh Uses the MOH audio stream as a multicast source in a Cisco CME system.
Cisco Unified CME Commands: Debug
debug ephone mwi
334
Cisco Unified CME Command Reference
OL-10894-01
debug ephone mwi
To set message waiting indication (MWI) debugging for the Cisco IOS Telephony Service router, use the
debug ephone mwi command in privileged EXEC mode. To disable debugging output, use the no form
of this command.
debug ephone mwi
no debug ephone mwi
Syntax Description This command has no arguments or keywords.
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone mwi command sets message waiting indication debugging for the Cisco IOS
Telephony Service router. Because the MWI protocol activity is not specific to any individual
Cisco IP phone, setting the MAC address keyword qualifier for this command is not useful.
Note Unlike the other related debug ephone commands, the mac-address keyword does not help debug a
particular Cisco IP phone.
Examples The following is sample output of the message waiting indication status for the Cisco IOS Telephony
Service router:
Router# debug ephone mwi
Release Modification
12.2(2)XT This command was introduced on the following platforms:
Cisco 1750, Cisco 1751, Cisco 2600 series and
Cisco 3600 series multiservice routers; and
Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(8)T This command was implemented on the Cisco 3725 and
Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and
Cisco 2691 routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone mwi
335
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the
Cisco IP phone.
debug ephone detail Sets detail debugging for the Cisco IP phone.
debug ephone error Sets error debugging for the Cisco IP phone.
debug ephone keepalive Sets keepalive debugging for the Cisco IP phone.
debug ephone pak Provides voice packet level debugging and prints the contents of
one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the Cisco IP phone.
debug ephone state Sets state debugging for the Cisco IP phone.
debug ephone statistics Sets statistics debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are enabled
for your router.
Cisco Unified CME Commands: Debug
debug ephone pak
336
Cisco Unified CME Command Reference
OL-10894-01
debug ephone pak
To provide voice packet level debugging and to print the contents of one voice packet in every 1024 voice
packets, use the debug ephone pak command in privileged EXEC mode. To disable debugging output,
use the no form of this command.
debug ephone pak [mac-address mac-address]
no debug ephone pak [mac-address mac-address]
Syntax Description
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone pak command provides voice packet level debugging and prints the contents of one
voice packet in every 1024 voice packets.
If the mac-address keyword is not used, the debug ephone pak command debugs all Cisco IP phones
that are registered to the router. You can remove debugging for the Cisco IP phones that you do not want
to debug by using the mac-address keyword with the no form of this command.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with the Cisco IP phone.
Examples The following is sample output of packet debugging for the Cisco IP phone with MAC address
0030.94c3.8724:
mac-address (Optional) Defines the MAC address of the Cisco IP phone.
mac-address (Optional) Specifies the MAC address of the Cisco IP phone.
Release Modification
12.1(5)YD This command was introduced on the following platforms:
Cisco 2600 series and Cisco 3600 series multiservice routers,
and Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(2)XT This command was implemented on the Cisco 1750 and
Cisco 1751 multiservice routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T
and implemented on the Cisco 3725 and Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and
Cisco 2691 routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone pak
337
Cisco Unified CME Command Reference
OL-10894-01
Router# debug ephone pak mac-address 0030.94c3.8724
EPHONE packet debugging is enabled for phone 0030.94c3.8724
01:29:14: ***ph_xmit_ephone DN 3 tx_pkts 5770 dest=10.2.1.1 orig len=32
pakcopy=0 discards 27 ip_enctype 0 0 last discard: unsupported payload type
01:29:14: to_skinny_duration 130210 offset -30 last -40 seq 0 adj 0
01:29:14: IP: 45B8 003C 0866 0000 3F11 3F90 2800 0001 0A02 0101
01:29:14: TTL 63 TOS B8 prec 5
01:29:14: UDP: 07D0 6266 0028 0000
01:29:14: sport 2000 dport 25190 length 40 checksum 0
01:29:14: RTP: 8012 16AF 9170 6409 0E9F 0001
01:29:14: is_rtp:1 is_frf11:0 vlen:0 delta_t:160 vofr1:0 vofr2:0
scodec:11 rtp_bits:8012 rtp_codec:18 last_bad_payload 19
01:29:14: vencap FAILED
01:29:14: PROCESS SWITCH
01:29:15: %SYS-5-CONFIG_I: Configured from console by console
01:29:34: ***SkinnyPktIp DN 3 10.2.1.1 to 40.0.0.1 pkts 4880 FAST sw
01:29:34: from_skinny_duration 150910
01:29:34: nw 3BBC2A8 addr 3BBC2A4 mac 3BBC2A4 dg 3BBC2C4 dgs 2A
01:29:34: MAC: 1841 0800
01:29:34: IP: 45B8 0046 682E 0000 3E11 E0BD 0A02 0101 2800 0001
01:29:34: TTL 62 TOS B8 prec 5
01:29:34: UDP: 6266 07D0 0032 0000
01:29:34: sport 25190 dport 2000 length 50 checksum 0
01:29:34: RTP: 8012 55FF 0057 8870 3AF4 C394
01:29:34: RTP: rtp_bits 8012 seq 55FF ts 578870 ssrc 3AF4C394
01:29:34: PAYLOAD:
01:29:34: 1409 37C9 54DE 449C 3B42 0446 3AAB 182E
01:29:34: 56BC 5184 58E5 56D3 13BE 44A7 B8C4
01:29:34:
01:29:37: ***ph_xmit_ephone DN 3 tx_pkts 6790 dest=10.2.1.1 orig len=32
pakcopy=0 discards 31 ip_enctype 0 0 last discard: unsupported payload type
01:29:37: to_skinny_duration 153870 offset -150 last -40 seq 0 adj 0
01:29:37: IP: 45B8 003C 0875 0000 3F11 3F81 2800 0001 0A02 0101
01:29:37: TTL 63 TOS B8 prec 5
01:29:37: UDP: 07D0 6266 0028 0000
01:29:37: sport 2000 dport 25190 length 40 checksum 0
01:29:37: RTP: 8012 1AAF 9173 4769 0E9F 0001
01:29:37: is_rtp:1 is_frf11:0 vlen:0 delta_t:160 vofr1:0 vofr2:0
Related Commands Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the
Cisco IP phone.
debug ephone detail Sets detail debugging for the Cisco IP phone.
debug ephone error Sets error debugging for the Cisco IP phone.
debug ephone keepalive Sets keepalive debugging for the Cisco IP phone.
debug ephone loopback Sets MWI debugging for the Cisco IP phone.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the Cisco IP phone.
debug ephone state Sets state debugging for the Cisco IP phone.
debug ephone statistics Sets statistics debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are
enabled for your router.
Cisco Unified CME Commands: Debug
debug ephone pak
338
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: Debug
debug ephone qov
339
Cisco Unified CME Command Reference
OL-10894-01
debug ephone qov
To display quality of voice (QOV) statistics for calls when preset limits are exceeded, use the debug
ephone qov command in privileged EXEC mode. To disable debugging, use the no form of this
command.
debug ephone qov [mac-address mac-address]
no debug ephone qov [mac-address mac-address]
Syntax Description
Command Modes Privileged EXEC
Command History
Usage Guidelines Once enabled, the debug ephone qov command produces output only when the QOV statistics reported
by phones exceed preset limits. Phones are polled every few seconds for QOV statistics on VoIP calls
only, not on local PSTN calls. An output report is produced when limits are surpassed for either or both
of the following:
• Lost packets—A report is triggered when two adjacent QOV samples show an increase of four or
more lost packets between samples. The report is triggered by an increase of lost packets in a short
period of time, not by the total number of lost packets.
• Jitter and latency—A report is triggered when either jitter or latency exceeds 100 milliseconds.
To receive a QOV report at the end of each call regardless of whether the QOV limits have been
exceeded, enable the debug ephone alarm command in addition to the debug ephone qov command.
The debug ephone statistics command displays the raw statistics that are polled from phones and used
to generate QOV reports.
Examples The following sample output describes QOV statistics for a call on ephone 5:
Router# debug ephone qov
Mar 7 00:54:57.329:ephone-5[7]:QOV DN 14 chan 1 (1514) ref 4 called=1514 calling=8101
Mar 7 00:54:57.329:ephone-5[7][SEP000DBDBEF37D]:Lost 91 Jitter 0 Latency 0
Mar 7 00:54:57.329:ephone-5[7][SEP000DBDBEF37D]:previous Lost 0 Jitter 0 Latency 0
Mar 7 00:54:57.329:ephone-5[7][SEP000DBDBEF37D]:Router sent 1153 pkts, current phone got
1141
received by all (shared) phones 0
Mar 7 00:54:57.329:ephone-5[7]:worst jitter 0 worst latency 0
Mar 7 00:54:57.329:ephone-5[7]:Current phone sent 1233 packets
mac-address mac-address (Optional) Specifies the MAC address of a Cisco IP phone
for debugging.
Release Modification
12.2(15)ZJ2 This command was introduced for Cisco CallManager Express 3.0 and
Cisco Survivable Remote Site Telephony (SRST) Version 3.0.
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T.
Cisco Unified CME Commands: Debug
debug ephone qov
340
Cisco Unified CME Command Reference
OL-10894-01
Mar 7 00:54:57.329:ephone-5[7]:Signal Level to phone 3408 (-15 dB) peak 3516 (-15 dB)
Table 7 describes the significant fields shown in the display.
Related Commands
Table 7 debug ephone qov Field Descriptions
Field Description
Lost Number of lost packets reported by the IP phone.
Jitter, Latency The most recent jitter and latency parameters reported by the
IP phone.
previous Lost, Jitter, Latency Values from the previous QOV statistics report that were
used as the comparison points against which the current
statistics triggered generation of the current report.
Router sent pkts Number of packets sent by the router to the IP phone. This
number is the total for the entire call, even if the call is moved
from one phone to another during a call, which can happen
with shared lines.
current phone got Number of packets received by the phone currently
terminating the call. This number is the total for the entire
call, even if the call is moved from one phone to another
during a call, which can happen with shared lines.
worst jitter, worst latency Highest value reported by the phone during the call.
Current phone sent packets Number of packets that the current phone claims it sent
during the call.
Signal Level to phone Signal level seen in G.711 voice packet data prior to the
sending of the most recent voice packet to the phone. The
first number is the raw sample value, converted from G.711
to 16-bit linear format and left-justified. The number in
parentheses is the value in decibels (dB), assuming that
32,767 is about +3 dB.
Note This value is meaningful only if the call uses a G.711
codec.
Command Description
debug ephone alarm Displays alarm messages for IP phones.
debug ephone statistics Displays call statistics for IP phones.
Cisco Unified CME Commands: Debug
debug ephone raw
341
Cisco Unified CME Command Reference
OL-10894-01
debug ephone raw
To provide raw low-level protocol debugging display for all Skinny Client Control Protocol (SCCP)
messages, use the debug ephone raw command in privileged EXEC mode. To disable debugging output,
use the no form of this command.
debug ephone raw [mac-address mac-address]
no debug ephone raw [mac-address mac-address]
Syntax Description
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone raw command provides raw low-level protocol debug display for all SCCP messages.
The debug display provides byte level display of Skinny TCP socket messages.
If the mac-address keyword is not used, the debug ephone raw command debugs all Cisco IP phones
that are registered to the router. You can remove debugging for the Cisco IP phones that you do not want
to debug by using the mac-address keyword with the no form of this command.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with the Cisco IP phone.
Examples The following is sample output of raw protocol debugging for the Cisco IP phone with MAC address
0030.94c3.E1A8:
Router# debug ephone raw mac-address 0030.94c3.E1A8
mac-address (Optional) Defines the MAC address of the Cisco IP phone.
mac-address (Optional) Specifies the MAC address of the Cisco IP phone.
Release Modification
12.1(5)YD This command was introduced on the following platforms:
Cisco 2600 series and Cisco 3600 series multiservice routers, and
Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(2)XT This command was implemented on the Cisco 1750 and
Cisco 1751 multiservice routers.
12.2(8)T This command was implemented on the Cisco 3725 and Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691
routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone raw
342
Cisco Unified CME Command Reference
OL-10894-01
EPHONE raw protocol debugging is enabled for phone 0030.94C3.E1A8
1d05h: skinny socket received 4 bytes on socket [1]
0 0 0 0
1d05h:
1d05h: SkinnyMessageID = 0
1d05h: skinny send 4 bytes
4 0 0 0 0 0 0 0 0 1 0 0
1d05h: socket [1] sent 12 bytes OK (incl hdr) for ephone-(1)
1d06h: skinny socket received 4 bytes on socket [1]
0 0 0 0
1d06h:
1d06h: SkinnyMessageID = 0
1d06h: skinny send 4 bytes
4 0 0 0 0 0 0 0 0 1 0 0
1d06h: socket [1] sent 12 bytes OK (incl hdr) for ephone-(1)
Related Commands Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the
Cisco IP phone.
debug ephone detail Sets detail debugging for the Cisco IP phone.
debug ephone error Sets error debugging for the Cisco IP phone.
debug ephone keepalive Sets keepalive debugging for the Cisco IP phone.
debug ephone loopback Sets MWI debugging for the Cisco IP phone.
debug ephone pak Provides voice packet level debugging and prints the contents of
one voice packet in every 1024 voice packets.
debug ephone register Sets registration debugging for the Cisco IP phone.
debug ephone state Sets state debugging for the Cisco IP phone.
debug ephone statistics Sets statistics debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are
enabled for your router.
Cisco Unified CME Commands: Debug
debug ephone register
343
Cisco Unified CME Command Reference
OL-10894-01
debug ephone register
To set registration debugging for the Cisco IP phone, use the debug ephone register command in
privileged EXEC mode. To disable debugging output, use the no form of this command.
debug ephone register [mac-address mac-address]
no debug ephone register [mac-address mac-address]
Syntax Description
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone register command sets registration debugging for the Cisco IP phones.
If the mac-address keyword is not used, the debug ephone register command debugs all
Cisco IP phones that are registered to the router. You can remove debugging for the Cisco IP phones that
you do not want to debug by using the mac-address keyword with the no form of this command.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with the Cisco IP phone.
Examples The following is sample output of registration debugging for the Cisco IP phone with MAC address
0030.94c3.8724:
Router# debug ephone register mac-address 0030.94c3.8724
mac-address (Optional) Defines the MAC address of the Cisco IP phone.
mac-address (Optional) Specifies the MAC address of the Cisco IP phone.
Release Modification
12.1(5)YD This command was introduced on the following platforms:
Cisco 2600 series and Cisco 3600 series multiservice routers, and
Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(2)XT This command was implemented on the Cisco 1750 and
Cisco 1751 multiservice routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T and
implemented on the Cisco 3725 and Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691
routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone register
344
Cisco Unified CME Command Reference
OL-10894-01
Ephone registration debugging is enabled
1d06h: New Skinny socket accepted [1] (2 active)
1d06h: sin_family 2, sin_port 50778, in_addr 10.1.0.21
1d06h: skinny_add_socket 1 10.1.0.21 50778
1d06h: ephone-(1)[1] StationRegisterMessage (2/3/12) from 10.1.0.21
1d06h: ephone-(1)[1] Register StationIdentifier DeviceName SEP003094C3E1A8
1d06h: ephone-(1)[1] StationIdentifier Instance 1 deviceType 7
1d06h: ephone-1[-1]:stationIpAddr 10.1.0.21
1d06h: ephone-1[-1]:maxStreams 0
1d06h: ephone-(1) Allow any Skinny Server IP address 10.1.0.6
.
.
.
1d06h: ephone-1[1]:RegisterAck sent to ephone 1: keepalive period 30
.
Related Commands Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the
Cisco IP phone.
debug ephone detail Sets detail debugging for the Cisco IP phone.
debug ephone error Sets error debugging for the Cisco IP phone.
debug ephone keepalive Sets keepalive debugging for the Cisco IP phone.
debug ephone loopback Sets MWI debugging for the Cisco IP phone.
debug ephone pak Provides voice packet level debugging and prints the contents of
one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone state Sets state debugging for the Cisco IP phone.
debug ephone statistics Sets statistics debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are
enabled for your router.
Cisco Unified CME Commands: Debug
debug ephone sccp-state
345
Cisco Unified CME Command Reference
OL-10894-01
debug ephone sccp-state
To set debugging for the SCCP call state, use the debug ephone sccp-state command in privileged
EXEC mode. To disable debugging output, use the no form of this command.
debug ephone sccp-state [mac-address mac-address]
no debug ephone sccp-state [mac-address mac-address]
Syntax Description
Command Default Debugging is not enabled for SCCP state.
Command Modes Privileged EXEC
Command History
Usage Guidelines This command is used with Cisco Unified CallManager Express (Cisco Unified CME).
This command outputs only the debug messages that correspond to SCCP messages sent to IP phones to
indicate the SCCP phone call state, such as RingIn, OffHook, Connected, and OnHook. These debug
messages are also included in the output for the debug ephone detail command among other
information.
Examples The following example sets SCCP state debugging for one Cisco Unified CME phone with the MAC
address of 678B.AEF9.DAB5.
Router# debug ephone sccp-state mac-address 678B.AEF9.DAB5
EPHONE SCCP state message debugging is enabled
for ephones 000B.BEF9.DFB5
*Mar 8 06:38:45.863: %ISDN-6-CONNECT: Interface Serial2/0/0:22 is now connected to
4085254871 unknown
*Mar 8 06:38:50.487: ephone-2[13]:SetCallState line 4 DN 60(60) chan 1 ref 100 TsRingIn
*Mar 8 06:38:52.399: ephone-2[13]:SetCallState line 4 DN 60(-1) chan 1 ref 100 TsOffHook
*Mar 8 06:38:52.399: ephone-2[13]:SetCallState line 4 DN 60(-1) chan 1 ref 100
TsConnected
*Mar 8 06:38:58.415: %ISDN-6-CONNECT: Interface Serial2/0/0:22 is now connected to
4085254871 unknown
*Mar 8 06:38:59.963: ephone-2[13]:SetCallState line 4 DN 60(-1) chan 1 ref 100 TsOnHook
*Mar 8 06:38:59.975: %ISDN-6-DISCONNECT: Interface Serial2/0/0:22 disconnected from
4085254871 , call lasted 7 seconds
mac-address
mac-address
(Optional) Specifies the MAC address of a phone.
Cisco IOS Release Modification
12.4(4)XC This command was introduced.
12.4(9)T This command was integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: Debug
debug ephone sccp-state
346
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
debug ephone detail Sets detail debugging for one or all Cisco Unified IP phones.
Cisco Unified CME Commands: Debug
debug ephone state
347
Cisco Unified CME Command Reference
OL-10894-01
debug ephone state
To set state debugging for the Cisco IP phone, use the debug ephone state command in privileged EXEC
mode. To disable debugging output, use the no form of this command.
debug ephone state [mac-address mac-address]
no debug ephone state [mac-address mac-address]
Syntax Description
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone state command sets state debugging for the Cisco IP phones.
If the mac-address keyword is not used, the debug ephone state command debugs all Cisco IP phones
that are registered to the router. You can remove debugging for the Cisco IP phones that you do not want
to debug by using the mac-address keyword with the no form of this command.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with the Cisco IP phone.
Examples The following is sample output of state debugging for the Cisco IP phone with MAC address
0030.94c3.E1A8:
Router# debug ephone state mac-address 0030.94c3.E1A8
mac-address (Optional) Defines the MAC address of the Cisco IP phone.
mac-address (Optional) Specifies the MAC address of the Cisco IP phone.
Release Modification
12.1(5)YD This command was introduced on the following platforms:
Cisco 2600 series and Cisco 3600 series multiservice routers, and
Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(2)XT This command was implemented on the Cisco 1750 and
Cisco 1751 multiservice routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T and
implemented on the Cisco 3725 and Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691
routers.
12.2(11)T This command was implemented on Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone state
348
Cisco Unified CME Command Reference
OL-10894-01
EPHONE state debugging is enabled for phone 0030.94C3.E1A8
1d06h: ephone-1[1]:OFFHOOK
1d06h: ephone-1[1]:SIEZE on activeline 0
1d06h: ephone-1[1]:SetCallState line 1 DN 1 TsOffHook
1d06h: ephone-1[1]:Skinny-to-Skinny call DN 1 to DN 2 instance 1
1d06h: ephone-1[1]:SetCallState line 1 DN 1 TsRingOut
1d06h: ephone-1[1]:Call Info DN 1 line 1 ref 158 called 5002 calling 5001
1d06h: ephone-1[1]: Jane calling
1d06h: ephone-1[1]: Jill
1d06h: ephone-1[1]:SetCallState line 3 DN 2 TsRingIn
1d06h: ephone-1[1]:Call Info DN 2 line 3 ref 159 called 5002 calling 5001
1d06h: ephone-1[1]: Jane calling
1d06h: ephone-1[1]: Jill
1d06h: ephone-1[1]:SetCallState line 3 DN 2 TsCallRemoteMultiline
1d06h: ephone-1[1]:SetCallState line 1 DN 1 TsConnected
1d06h: ephone-1[1]:OpenReceive DN 1 codec 4:G711Ulaw64k duration 10 ms bytes 80
1d06h: ephone-1[1]:OpenReceiveChannelAck 1.2.172.21 port=24010
1d06h: ephone-1[1]:StartMedia 1.2.172.22 port=24612
1d06h: DN 1 codec 4:G711Ulaw64k duration 10 ms bytes 80
1d06h: ephone-1[1]:CloseReceive
1d06h: ephone-1[1]:StopMedia
1d06h: ephone-1[1]:SetCallState line 3 DN 2 TsOnHook
1d06h: ephone-1[1]:SetCallState line 1 DN 1 TsOnHook
1d06h: ephone-1[1]:SpeakerPhoneOnHook
1d06h: ephone-1[1]:ONHOOK
1d06h: ephone-1[1]:SpeakerPhoneOnHook
1d06h: SkinnyReportDnState DN 1 ONHOOK
Related Commands Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the
Cisco IP phone.
debug ephone detail Sets detail debugging for the Cisco IP phone.
debug ephone error Sets error debugging for the Cisco IP phone.
debug ephone keepalive Sets keepalive debugging for the Cisco IP phone.
debug ephone loopback Sets MWI debugging for the Cisco IP phone.
debug ephone pak Provides voice packet level debugging and prints the contents of
one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the Cisco IP phone.
debug ephone Sets statistics debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are
enabled for your router.
Cisco Unified CME Commands: Debug
debug ephone statistics
349
Cisco Unified CME Command Reference
OL-10894-01
debug ephone statistics
To set call statistics debugging for the Cisco IP phone, use the debug ephone statistics command in
privileged EXEC mode. To disable debugging output, use the no form of this command.
debug ephone statistics [mac-address mac-address]
no debug ephone statistics [mac-address mac-address]
Syntax Description
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone statistics command provides a debug monitor display of the periodic messages from
the Cisco IP phone to the router. These include transmit-and-receive packet counts and an estimate of
drop packets. The call statistics can also be displayed for live calls using the show ephone command.
If the mac-address keyword is not used, the debug ephone statistics command debugs all
Cisco IP phones that are registered to the router. You can remove debugging for the Cisco IP phones that
you do not want to debug by using the mac-address keyword with the no form of this command.
You can enable or disable debugging on any number of Cisco IP phones. To see the Cisco IP phones that
have debugging enabled, enter the show ephone command and look at the debug field in the output.
When debugging is enabled for a Cisco IP phone, the debug output is displayed for the directory
numbers associated with the Cisco IP phone.
Examples The following is sample output of statistics debugging for the Cisco IP phone with MAC address
0030.94C3.E1A8:
mac-address (Optional) Defines the MAC address of the Cisco IP phone.
mac-address (Optional) Specifies the MAC address of the Cisco IP phone.
Release Modification
12.1(5)YD This command was introduced on the following platforms:
Cisco 2600 series and Cisco 3600 series multiservice routers, and
Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(2)XT This command was implemented on the Cisco 1750 and
Cisco 1751 multiservice routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T and
implemented on the Cisco 3725 and Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691
routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug ephone statistics
350
Cisco Unified CME Command Reference
OL-10894-01
Router# debug ephone statistics mac-address 0030.94C3.E1A8
EPHONE statistics debugging is enabled for phone 0030.94C3.E1A8
1d06h: Clear Call Stats for DN 1 call ref 162
1d06h: Clear Call Stats for DN 1 call ref 162
1d06h: Clear Call Stats for DN 1 call ref 162
1d06h: Clear Call Stats for DN 2 call ref 163
1d06h: ephone-1[1]:GetCallStats line 1 ref 162 DN 1: 5001
1d06h: ephone-1[1]:Call Stats for line 1 DN 1 5001 ref 162
1d06h: ephone-1[1]:TX Pkts 0 bytes 0 RX Pkts 0 bytes 0
1d06h: ephone-1[1]:Pkts lost 4504384 jitter 0 latency 0
1d06h: ephone-1[1]:Src 0.0.0.0 0 Dst 0.0.0.0 0 bytes 80 vad 0 G711Ulaw64k
1d06h: ephone-1[1]:GetCallStats line 1 ref 162 DN 1: 5001
1d06h: STATS: DN 1 Packets Sent 0
1d06h: STATS: DN 2 Packets Sent 0
1d06h: ephone-1[1]:Call Stats found DN -1 from Call Ref 162
1d06h: ephone-1[1]:Call Stats for line 0 DN -1 5001 ref 162
1d06h: ephone-1[1]:TX Pkts 275 bytes 25300 RX Pkts 275 bytes 25300
1d06h: ephone-1[1]:Pkts lost 0 jitter 0 latency 0
Related Commands Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the
Cisco IP phone.
debug ephone detail Sets detail debugging for the Cisco IP phone.
debug ephone error Sets error debugging for the Cisco IP phone.
debug ephone keepalive Sets keepalive debugging for the Cisco IP phone.
debug ephone loopback Sets MWI debugging for the Cisco IP phone.
debug ephone pak Provides voice packet level debugging and prints the contents of
one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the Cisco IP phone.
debug ephone state Sets state debugging for the Cisco IP phone.
show debugging Displays information about the types of debugging that are
enabled for your router.
Cisco Unified CME Commands: Debug
debug ephone video
351
Cisco Unified CME Command Reference
OL-10894-01
debug ephone video
To set video debugging for ephones, use the debug ephone video command in privileged EXEC mode.
To disable debugging output, use the no form of this command.
debug ephone video
no debug ephone video
Syntax Description This command has no arguments or keywords.
Command Default Debugging is disabled for ephone video.
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug ephone video command sets ephone video traces, which provide information about different
video states for the call, including video capabilities selection, start, and stop.
The debug ephone command debugs all ephones that are registered to the Cisco Unified CallManager
Express (Cisco Unified CME) system.
You can enable or disable debugging on any number of ephones. To see the ephones that have debugging
enabled, enter the show ephone command and look at the debug field in the output. When debugging is
enabled for a ephone, the debug output is displayed for the directory numbers associated with the
ephone.
Examples The following is sample output for the debug ephone video command for ephones:
Router# debug ephone video
*Mar 13 16:10:02.703: SkinnyVideoCodecMatch_Caps2Caps: match capability: tx_idxcap = 4,
tx_idxpref = 3,
*Mar 13 16:10:02.703: rx_idxcap = 0, rx_idxpref = 0, videoBitRate = 7040
tx_mpi = 1
*Mar 13 16:10:04.711: ephone-19[1][SEPFFFA00000019]:checkToOpenMultiMedia: dn=19, chan=1
*Mar 13 16:10:04.711: ephone-19[1]:skinnyDP[19].s2s = 0
*Mar 13 16:10:04.711: ephone-19[1]:s2s is not set - hence not video capable
*Mar 13 16:10:04.719: ephone-19[1][SEPFFFA00000019]:SkinnyStartMultiMediaTransmission:
chan 1 dn 19
*Mar 13 16:10:04.723: ephone-19[1]:Accept OLC and open multimedia channel
*Mar 13 16:10:04.723: ephone-19[1][SEPFFFA00000019]:SkinnyOpenMultiMediaReceiveChannel: dn
19 chan 1
Cisco IOS Release Modification
12.4(4)XC This command was introduced.
12.4(9)T This command was integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: Debug
debug ephone video
352
Cisco Unified CME Command Reference
OL-10894-01
*Mar 13 16:10:04.967: ephone-19[1][SEPFFFA00000019]:fStationOpenReceiveChannelAckMessage:
MEDIA_DN 19 MEDIA_CHAN 1
*Mar 13 16:10:04.967: ephone-19[1]:fStationOpenMultiMediaReceiveChannelAckMessage:
*Mar 13 16:10:04.967: ephone-19[1]:Other_dn == -1
sk3745-2#
*Mar 13 16:10:14.787: ephone-19[1]:SkinnyStopMedia: Stop Multimedia
*Mar 13 16:10:14.787: ephone-19[1][SEPFFFA00000019]:SkinnyCloseMultiMediaReceiveChannel:
passThruPartyID = 0, callReference = 23
*Mar 13 16:10:14.787: ephone-19[1]:SkinnyStopMultiMediaTransmission: line 1 chan 1 dn 19
Related Commands Command Description
debug ephone alarm Sets SkinnyStation alarm messages debugging for the ephone.
debug ephone detail Sets detail debugging for the ephone.
debug ephone error Sets error debugging for the ephone.
debug ephone message Sets message debugging for the ephone.
debug ephone mwi Sets MWI debugging for the ephone.
debug ephone pak Provides voice packet level debugging and displays the contents
of one voice packet in every 1024 voice packets.
debug ephone raw Provides raw low-level protocol debugging display for all SCCP
messages.
debug ephone register Sets registration debugging for the ephone.
debug ephone state Sets state debugging for the ephone.
debug ephone statistics Sets statistics debugging for the ephone.
show debugging Displays information about the types of debugging that are
enabled for your router.
show ephone Displays information about registered ephones.
Cisco Unified CME Commands: Debug
debug ephone vm-integration
353
Cisco Unified CME Command Reference
OL-10894-01
debug ephone vm-integration
To display pattern manipulation information used for integration with voice-mail applications, use the
debug ephone vm-integration command in privileged EXEC mode. To disable debugging output, use
the no form of this command.
debug ephone vm-integration [mac-address mac-address]
no debug ephone vm-integration [mac-address mac-address]
Syntax Description
Command Modes Privileged EXEC
Command History
Usage Guidelines This command displays the voice-mail integration patterns that were created using the pattern
commands in vm-integration configuration mode. The patterns are used to forward calls to a voice-mail
number that is set with the voicemail command.
If you do not specify the mac-address keyword, the debug ephone vm-integration command debugs
all Cisco IP phones that are registered to the router. To remove debugging for Cisco IP phones, enter the
no form of this command with the mac-address keyword.
Examples The following sample output shows information for the vm-integration tokens that have been defined:
Router# debug ephone vm-integration
*Jul 23 15:38:03.294:ephone-3[3]:StimulusMessage 15 (1) From ephone 2
*Jul 23 15:38:03.294:ephone-3[3]:Voicemail access number pattern check
*Jul 23 15:38:03.294:SkinnyGetCallState for DN 3 chan 1 IDLE
*Jul 23 15:38:03.294:called DN -1 chan 1, calling DN -1 chan 1 phone -1 s2s:0
*Jul 23 15:38:03.294:dn number for dn 3 is 19003
*Jul 23 15:38:03.294:Updated number for token 1 is 19003
*Jul 23 15:38:03.294:CDN number for dn 3 is
*Jul 23 15:38:03.294:Updated number for token 2 is
*Jul 23 15:38:03.294:Updated number for token 0 is
*Jul 23 15:38:03.294:Update is 219003*
*Jul 23 15:38:03.294:New Voicemail number is 19101219003*
Table 8 describes the significant fields shown in the display.
mac-address mac-address (Optional) Specifies the MAC address of a Cisco IP phone for
debugging.
Release Modification
12.3(7)T This command was introduced.
Cisco Unified CME Commands: Debug
debug ephone vm-integration
354
Cisco Unified CME Command Reference
OL-10894-01
Related Commands
Table 8 debug ephone vm-integration Field Descriptions
Field Description
token 0 First token that was defined in the pattern.
token 1 Second token that was defined in the pattern.
token 2 Third token that was defined in the pattern.
Command Description
pattern direct Configures the DTMF digit pattern forwarding necessary to
activate the voice-mail system when a user presses the
Messages button on a phone.
pattern ext-to-ext busy Configures the DTMF digit pattern forwarding necessary to
activate the voice-mail system once an internal extension
reaches a busy extension and the call is forwarded to voice
mail.
pattern ext-to-ext no-answer Configures the DTMF digit pattern forwarding necessary to
activate the voice-mail system once an internal extension
fails to connect to an extension and the call is forwarded to
voice mail.
pattern trunk-to-ext busy Configures the DTMF digit pattern forwarding necessary to
activate the voice-mail system once an external trunk call
reaches a busy extension and the call is forwarded to voice
mail.
pattern trunk-to-ext no-answer Configures the DTMF digit pattern forwarding necessary to
activate the voice-mail system when an external trunk call
reaches an unanswered extension and the call is forwarded
to voice mail.
vm-integration Enters voice-mail integration configuration mode and
enables voice-mail integration with DTMF and analog
voice-mail systems.
voicemail Defines the telephone number that is speed-dialed when the
Messages button on a Cisco IP phone is pressed.
Cisco Unified CME Commands: Debug
debug ephone whisper-intercom
355
Cisco Unified CME Command Reference
OL-10894-01
debug ephone whisper-intercom
To display debugging messages for the Whisper Intercom feature, use the debug ephone
whisper-intercom command in privileged EXEC mode. To disable debugging output, use the no form
of this command.
debug ephone whisper-intercom
no debug ephone whisper-intercom
Syntax Description This command has no arguments or keywords.
Command Default Debugging for Whisper Intercom is disabled.
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines This command displays debugging information about the Whisper Intercom feature configured on a
directory number of a SCCP phone.
Examples The following example displays output from the debug ephone whisper-intercom command:
Router# debug ephone whisper-intercom

ephone-1[0] Mac:1111.C1C1.0001 TCP socket:[8] activeLine:0 whisperLine:2 REGISTERED in
SCCP ver 12/12 max_streams=3
mediaActive:0 whisper_mediaActive:0 startMedia:1 offhook:1 ringing:0 reset:0 reset_sent:0
paging 0 debug:0 caps:5
IP:10.6.2.185 9237 7970 keepalive 16 max_line 8
button 1: dn 1 number 2001 CH1 IDLE CH2 IDLE
button 2: dn 161 number 6001 auto dial 6002 CH1 WHISPER
Preferred Codec: g711ulaw
Active Call on DN 161 chan 1 :6001 0.0.0.0 0 to 10.6.2.185 9280 via 10.6.2.185
G711Ulaw64k 160 bytes no vad
Tx Pkts 0 bytes 0 Rx Pkts 0 bytes 0 Lost 0
Jitter 0 Latency 0 callingDn -1 calledDn 162


ephone-2[1] Mac:1111.C1C1.0002 TCP socket:[7] activeLine:0 whisperLine:2 REGISTERED in
SCCP ver 12/12 max_streams=3
mediaActive:0 whisper_mediaActive:1 startMedia:0 offhook:1 ringing:0 reset:0 reset_sent:0
paging 0 debug:0 caps:5
IP:10.6.2.185 9240 7970 keepalive 16 max_line 8
button 1: dn 2 number 2002 CH1 IDLE CH2 IDLE
Release Modification
12.4(22)YB This command was introduced.
12.4(24)T This command was integrated into Cisco IOS Release 12.4(24
Cisco Unified CME Commands: Debug
debug ephone whisper-intercom
356
Cisco Unified CME Command Reference
OL-10894-01
button 2: dn 162 number 6002 auto dial 6001 CH1 WHISPER
Preferred Codec: g711ulaw
Active Call on DN 162 chan 1 :6002 10.6.2.185 9280 to 10.6.2.254 2000 via 10.6.2.185
G711Ulaw64k 160 bytes no vad
Tx Pkts 0 bytes 0 Rx Pkts 0 bytes 0 Lost 0
Jitter 0 Latency 0 callingDn 161 calledDn -1
Related Commands Command Description
show ephone-dn whisper Displays information about whisper intercom ephone-dns that have been
created in Cisco Unified CME.
whisper-intercom Enables the Whisper Intercom feature on a directory number.
Cisco Unified CME Commands: Debug
debug mwi relay errors
357
Cisco Unified CME Command Reference
OL-10894-01
debug mwi relay errors
To debug message waiting indication (MWI) relay errors, use the debug mwi relay errors command in
privileged EXEC mode. To disable debugging output, use the no form of this command.
debug mwi relay errors
no debug mwi relay errors
Syntax Description This command has no arguments or keywords.
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug mwi relay errors command provides a debug monitor display of any error messages, when
MWI Relay Server (Cisco IOS Telephony Server) is trying to do MWI Relay to extensions on remote
Cisco IOS Telephony Service (ITS).
Examples The following examples show errors when MWI Relay Server tries to do an MWI Relay to extension
7004, but location of 7004 is not known to the MWI Relay Server:
Router# debug mwi relay errors
mwi-relay error info debugging is on
01:46:48: MWI-APP: mwi_notify_status: No ClientID (7004) registered
Release Modification
12.2(2)XT This command was introduced on the following platforms: Cisco 1750,
Cisco 1751, Cisco 2600 series and Cisco 3600 series multiservice routers;
and Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T and
implemented on the Cisco 3725 and Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691
routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug mwi relay errors
358
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
debug ephone mwi Sets MWI debugging for the Cisco IOS Telephony
Service router.
debug mwi relay events Sets MWI relay events debugging for the Cisco IOS
Telephony Service router.
Cisco Unified CME Commands: Debug
debug mwi relay events
359
Cisco Unified CME Command Reference
OL-10894-01
debug mwi relay events
To set message waiting indication (MWI) relay events debugging, use the debug mwi relay events
command in privileged EXEC mode. To disable debugging output, use the no form of this command.
debug mwi relay events
no debug mwi relay events
Syntax Description This command has no arguments or keywords.
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History
Usage Guidelines The debug mwi relay events command provides a debug monitor display of events, when MWI Relay
Server (Cisco IOS Telephony Server) is trying to do MWI Relay to extensions on remote Cisco IOS
Telephony Services (ITS).
Examples The following debugging messages are shown when the MWI Relay server tries to send MWI
Information to remote client 7001 and the location of 7001 is known by the MWI Relay Server:
Router# debug mwi relay events
mwi-relay events info debugging is on
01:45:34: mwi_notify_status: Queued event for mwi_app_queue
01:45:34: MWI-APP: mwi_app_process_event:
01:45:34: MWI-APP: mwi_app_process_event: MWI Event for ClientID(7001)@(1.8.17.22)
Release Modification
12.2(2)XT This command was introduced on the following platforms: Cisco 1750,
Cisco 1751, Cisco 2600 series and Cisco 3600 series multiservice routers;
and Cisco IAD2420 series Integrated Access Devices (IADs).
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T and
implemented on the Cisco 3725 and Cisco 3745 routers.
12.2(8)T1 This command was implemented on the Cisco 2600-XM and Cisco 2691
routers.
12.2(11)T This command was implemented on the Cisco 1760 routers.
Cisco Unified CME Commands: Debug
debug mwi relay events
360
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
debug ephone mwi Sets MWI debugging for the Cisco IOS Telephony Service
router.
debug mwi relay errors Sets MWI relay errors debugging for the Cisco IOS Telephony
Service router.
Cisco Unified CME Commands: Debug
debug shared-line
361
Cisco Unified CME Command Reference
OL-10894-01
debug shared-line
To display debugging information about SIP shared lines, use the debug shared-line command in
privileged EXEC mode. To disable debugging messages, use the no form of this command.
debug shared-line {all | errors | events | info}
no debug shared-line {all | errors | events | info}
Syntax Description
Command Modes Privileged EXEC (#)
Command History
Examples The following example shows output from the debug shared-line all command:
Router# debug shared-line all

Aug 21 21:56:56.949: //Shared-Line/EVENT/shrl_validate_newcall_outgoing:Outgoing call
validation request from AFW for user = 20143, usrContainer = 4A7CFBDC
.Aug 21 21:56:56.949: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20143'
.Aug 21 21:56:56.949: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry not found for dn
'20143'
.Aug 21 21:56:56.949: //Shared-Line/INFO/shrl_find_ccb_by_demote_dn:Demoted dn: 20143
.Aug 21 21:56:56.949: //Shared-Line/INFO/shrl_validate_newcall_outgoing:User '20143'
doesn't exist in Shared-Line table
.Aug 21 21:56:56.957: //Shared-Line/EVENT/shrl_validate_newcall_incoming:Incominging call
validation request from AFW for user = 20141
.Aug 21 21:56:56.957: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20141'
.Aug 21 21:56:56.957: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry found [ccb = 4742EAD4]
for dn '20141'
.Aug 21 21:56:56.957: //Shared-Line/INFO/shrl_validate_newcall_incoming:User '20141'
found: ccb = 4742EAD4, mem_count = 2
.Aug 21 21:56:56.957: //Shared-Line/EVENT/shrl_validate_newcall_incoming:Obtained call
instance inst: 0 for incoming call, incoming leg (peer_callid): 5399)
.Aug 21 21:56:56.957: //Shared-Line/INFO/shrl_update_barge_calltype:Updating shared-line
call -1 with calltype = 1
.Aug 21 21:56:56.961: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20141'
.Aug 21 21:56:56.961: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry found [ccb = 4742EAD4]
for dn '20141'
all Displays all shared-line debugging messages.
errors Displays shared-line error messages.
events Displays shared-line event messages.
info Displays general information about shared lines.
Release Modification
12.4(22)YB This command was introduced.
12.4(24)T This command was integrated into Cisco IOS Release 12.4(24)T.
Cisco Unified CME Commands: Debug
debug shared-line
362
Cisco Unified CME Command Reference
OL-10894-01
.Aug 21 21:56:56.961: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20141'
.Aug 21 21:56:56.961: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry found [ccb = 4742EAD4]
for dn '20141'
.Aug 21 21:57:01.689: %IPPHONE-6-REG_ALARM: 24: Name=SEP00141C48E126 Load=8.0(5.0)
Last=Phone-Reg-Rej
.Aug 21 21:57:04.261: //Shared-Line/EVENT/shrl_app_event_notify_handler:Event notification
received: event = 9, callID = 5401, dn = 20141
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20141'
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry found [ccb = 4742EAD4]
for dn '20141'
.Aug 21 21:57:04.261: //Shared-Line/EVENT/shrl_process_connect:called with state = 3,
callID = 5401, peer callID = 5399, dn = 20141, usrContainer = 4A7CACA4
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_connect_upd_callinfo:Parsed To:
20141@15.6.0.2, to-tag: 2ed5b927-6ad6
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_connect_upd_callinfo:Parsed Contact:
20141@15.6.0.2 for sipCallId: E8583537-6F0211DD-96A69BA1-1228BEFB@15.10.0.1
.Aug 21 21:57:04.261: //Shared-Line/EVENT/shrl_connect_upd_callinfo:Obtained call instance
inst: 0
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_connect_upd_callinfo:CONNECT from shared
line for incoming shared-line call.
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_find_peer_by_ipaddr:Trying to match peer for
member 20141@15.6.0.2
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_find_peer_by_ipaddr:Matching peer [40002]
session target parsed = 15.6.0.2
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_connect_upd_callinfo:Matching member found:
20141@15.6.0.2
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_update_remote_name:Updating shared-line call
dialog info 5401

.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_process_connect:Updated callinfo for callid:
5401, member: '20141@15.6.0.2', peer-tag: 40002
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_process_connect:Notify remote users about
CALL-CONNECT.
.Aug 21 21:57:04.261: //Shared-Line/EVENT/shrl_send_dialog_notify:Sending NOTIFY to remote
user: 20141@15.6.0.1
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_send_dialog_notify:Sending NOTIFY to remote
user: 20141@15.6.0.1 about state 3 on incoming call from 20141@15.6.0.2 privacy OFF
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_send_dialog_notify:Dialog msg: dir: 1,
orient: 2, local_tag: 2ed5b927-6ad6, remote_tag: 89DCF0-139B, local_uri: 20141@15.6.0.2,
remote_uri: 20143@15.10.0.1
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_send_dialog_notify:Dialog notify sent
successfully
.Aug 21 21:57:04.261: //Shared-Line/INFO/shrl_process_connect:Shared-Line '20141':
Successfully sent notify for callid: 5401
.Aug 21 21:57:04.265: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20141'
.Aug 21 21:57:04.265: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry found [ccb = 4742EAD4]
for dn '20141'
.Aug 21 21:57:04.265: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20143'
.Aug 21 21:57:04.265: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry not found for dn
'20143'
.Aug 21 21:57:04.269: //Shared-Line/INFO/shrl_find_ccb_by_demote_dn:Demoted dn: 20143
.Aug 21 21:57:04.269: //Shared-Line/INFO/shrl_update_totag:Shared-Line not enabled for
'20143'
.Aug 21 21:57:04.269: //Shared-Line/EVENT/shrl_app_event_notify_handler:Event notification
received: event = 21, callID = 5401, dn = 20141
.Aug 21 21:57:04.269: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20141'
.Aug 21 21:57:04.269: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry found [ccb = 4742EAD4]
for dn '20141'
Cisco Unified CME Commands: Debug
debug shared-line
363
Cisco Unified CME Command Reference
OL-10894-01
.Aug 21 21:57:04.269: //Shared-Line/EVENT/shrl_process_callerid_update:called with state =
7, callID = 5401, peer callID = 5399, dn = 20141
.Aug 21 21:57:04.269: //Shared-Line/INFO/shrl_process_callerid_update:Updated callinfo for
callid: 5401, member: '20141@15.6.0.2', peer-tag: 40002
.Aug 21 21:57:04.269: //Shared-Line/EVENT/shrl_is_outbound:Check for shared line call type
callid 5401for user = 20141
.Aug 21 21:57:04.269: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20141'
.Aug 21 21:57:04.269: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry found [ccb = 4742EAD4]
for dn '20141'
.Aug 21 21:57:04.269: //Shared-Line/EVENT/shrl_barge_type:Check for shared line call type
callid 5401for user = 20141
.Aug 21 21:57:04.269: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20141'
.Aug 21 21:57:04.269: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry found [ccb = 4742EAD4]
for dn '20141'
.Aug 21 21:57:04.273: //Shared-Line/INFO/shrl_find_ccb_by_dn:Searching Shared-Line table
for dn '20141'
.Aug 21 21:57:04.273: //Shared-Line/INFO/shrl_find_ccb_by_dn:Entry found [ccb = 4742EAD4]
for dn '20141'
.Aug 21 21:57:04.281: //Shared-Line/EVENT/shrl_notify_done_handler:NOTIFY_DONE received
for subID: 5 respCode: 17
.Aug 21 21:57:04.281: //Shared-Line/INFO/shrl_find_ccb_by_subid:Search ccb for subid: 5
.Aug 21 21:57:04.281: //Shared-Line/INFO/shrl_find_ccb_by_subid:Found the entry ccb:
4742EAD4 member: 20141@15.6.0.1
.Aug 21 21:57:04.281: //Shared-Line/INFO/shrl_free_spi_respinfo:Free ASNL resp info for
subID = 5
Related Commands Command Description
shared-line Creates a directory number to be shared by multiple SIP phones.
show shared-line Displays information about active calls using SIP shared lines.
Cisco Unified CME Commands: Debug
debug voice register errors
364
Cisco Unified CME Command Reference
OL-10894-01
debug voice register errors
To display debug information on voice register module errors during registration in a Cisco Unified
CallManager Express (Cisco Unified CME) or Cisco Unified Session Initiation Protocol (SIP)
Survivable Remote Site Telephony (SRST) environment, use the debug voice register errors command
in privileged EXEC mode. To disable debugging, use the no form of the command.
debug voice register errors
no debug voice register errors
Syntax Description This command has no arguments or keywords
Command Default Disabled
Command Modes Privileged EXEC mode
Command History
Usage Guidelines Registration errors include failure to match pools or any internal errors that happen during registration.
Examples Cisco Unified CME
The following is sample output for this command for a registration request with authentication enabled:

*May 6 18:07:26.971: VOICE_REG_POOL: Register request for (4901) from (10.5.49.83)
*May 6 18:07:26.971: VOICE_REG_POOL: key(9499C07A000036A3) added to nonce table
*May 6 18:07:26.975: VOICE_REG_POOL: Contact doesn't match any pools
*May 6 18:07:26.975: //4/89D7750A8005/SIP/Error/ccsip_spi_register_incoming_registration:
Registration Authorization failed with authorization header=

If there are no voice register pools configured for a particular registration request, the message “Contact
doesn’t match any pools” is displayed.
When authentication is enabled and if the phone requesting registration cannot be authenticated, the
message “Registration Authorization failed with authorization header” is displayed.
Cisco Unified SIP SRST
The following is sample output from this command:
Cisco IOS Release Modification
12.2(15)ZJ This command was introduced for Cisco SIP SRST 3.0
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T for
Cisco SIP SRST 3.0.
12.4(4)T This command was added to Cisco Unified CME 3.4 and
Cisco SIP SRST 3.4.
Cisco Unified CME Commands: Debug
debug voice register errors
365
Cisco Unified CME Command Reference
OL-10894-01
Router# debug voice register errors
*Apr 22 11:52:54.523 PDT: VOICE_REG_POOL: Contact doesn't match any pools
*Apr 22 11:52:54.539 PDT: VOICE_REG_POOL: Register request for (33015) from (10.2.152.39)
*Apr 22 11:52:54.539 PDT: VOICE_REG_POOL: Contact doesn't match any pools.
*Apr 22 11:52:54.559 PDT: VOICE_REG_POOL: Register request for (33017) from (10.2.152.39)
*Apr 22 11:53:04.559 PDT: VOICE_REG_POOL: Maximum registration threshold for pool(3) hit
If there are no voice register pools configured for a particular registration request, the message “Contact
doesn’t match any pools” is displayed.
If the max registrations command is configured, when registration requests reach the maximum limit,
the “Maximum registration threshold for pool (x) hit” message is displayed for the particular pool.
Table 9 describes the significant fields shown in the display.
Related Commands
Table 9 debug voice register errors Field Descriptions
Field Description
Contact (doesn’t match any pools) Contact refers to the location of the SIP devices and the
IP address.
key (MAC address) Unique MAC address of a locally available individual SIP
phone used to support a degree of authentication in
Cisco Unified CME.
Register request for (telephone number)
from (IP address).
The unique key for each registration is the telephone number.
Registration Authorization (failed with
authorization header)
Registration Authorization message is displayed when
authenticate command is configured in Cisco Unified CME.
Command Description
debug voice register
events
Displays debug information on voice register module events during SIP
phone registrations in a Cisco Unified CME or Cisco Unified SIP SRST
environment.
Cisco Unified CME Commands: Debug
debug voice register events
366
Cisco Unified CME Command Reference
OL-10894-01
debug voice register events
To display debug information on voice register module events during Session Initiation Protocol (SIP)
phone registrations in a Cisco Unified CallManager Express (Cisco Unified CME) or Cisco Unified SIP
Survivable Remote Site Telephony (SRST) environment, use the debug voice register events command
in privileged EXEC mode. To disable debugging, use the no form of this command.
debug voice register events
no debug voice register events
Syntax Description This command has no arguments or keywords
Command Default Disabled
Command Modes Privileged EXEC mode
Command History
Usage Guidelines Using the debug voice register events command should suffice to view registration activity.
Registration activity includes matching of pools, registration creation, and automatic creation of dial
peers. For more details and error conditions, you can use the debug voice register errors command.
Cisco Unified CME
The following example shows output from this command:
*May 6 18:07:27.223: VOICE_REG_POOL: Register request for (4901) from (1.5.49.83)
*May 6 18:07:27.223: VOICE_REG_POOL: Contact matches pool 1 number list 1
*May 6 18:07:27.223: VOICE_REG_POOL: key(4901) contact(10.5.49.83) add to contact table
*May 6 18:07:27.223: VOICE_REG_POOL: No entry for (4901) found in contact table
*May 6 18:07:27.223: VOICE_REG_POOL: key(4901) contact(10.5.49.83) added to contact
tableVOICE_REG_POOL pool->tag(1), dn->tag(1), submask(1)
*May 6 18:07:27.223: VOICE_REG_POOL: Creating param container for dial-peer 40001.
*May 6 18:07:27.223: VOICE_REG_POOL: Created dial-peer entry of type 0
*May 6 18:07:27.223: VOICE_REG_POOL: Registration successful for 4901, registration id is
2
...
The phone number 4901 associated with voice register pool 1, voice register dn 1, registered
successfully. A dynamic normal (type 0) VoIP dial peer has been created for entry 4901. The dial peer
can be verified using the show voice register dial-peers and show sip-ua status registrar commands.
Cisco IOS Release Modification
12.2(15)ZJ This command was introduced for Cisco SIP SRST 3.0
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T for
Cisco SIP SRST 3.0.
12.4(4)T This command was added to Cisco CME 3.4 and Cisco SIP SRST 3.4.
Cisco Unified CME Commands: Debug
debug voice register events
367
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified SIP SRST
The following is sample output from this command:
Router# debug voice register events
Apr 22 10:50:21.731 PDT: VOICE_REG_POOL: Contact matches pool 1
Apr 22 10:50:21.731 PDT: VOICE_REG_POOL: key(91011) contact(192.168.0.2) add to contact
table
Apr 22 10:50:21.731 PDT: VOICE_REG_POOL: key(91011) exists in contact table
Apr 22 10:50:21.731 PDT: VOICE_REG_POOL: contact(192.168.0.2) exists in contact table, ref
updated
Apr 22 10:50:21.731 PDT: VOICE_REG_POOL: Created dial-peer entry of type 1
Apr 22 10:50:21.731 PDT: VOICE_REG_POOL: Registration successful for 91011, registration
id is 257
The phone number 91011 registered successfully, and type 1 is reported in the debug, which means that
there is a preexisting VoIP dial peer.
Apr 22 10:50:38.119 PDT: VOICE_REG_POOL: Register request for (91021) from (192.168.0.3)
Apr 22 10:50:38.119 PDT: VOICE_REG_POOL: Contact matches pool 2
Apr 22 10:50:38.123 PDT: VOICE_REG_POOL: key(91021) contact(192.168.0.3) add to contact
table
Apr 22 10:50:38.123 PDT: VOICE_REG_POOL: key(91021) exists in contact table
Apr 22 10:50:38.123 PDT: VOICE_REG_POOL: contact(192.168.0.3) exists in contact table, ref
updated
Apr 22 10:50:38.123 PDT: VOICE_REG_POOL: Created dial-peer entry of type 1
Apr 22 10:50:38.123 PDT: VOICE_REG_POOL: Registration successful for 91021, registration
id is 258
A dynamic VoIP dial peer has been created for entry 91021. The dial peer can be verified using the show
voice register dial-peers and show sip-ua status registrar commands.
Apr 22 10:51:08.971 PDT: VOICE_REG_POOL: Register request for (95021) from (10.2.161.50)
Apr 22 10:51:08.971 PDT: VOICE_REG_POOL: Contact matches pool 3
Apr 22 10:51:08.971 PDT: VOICE_REG_POOL: key(95021) contact(10.2.161.50) add to contact
table
Apr 22 10:51:08.971 PDT: VOICE_REG_POOL: No entry for (95021) found in contact table
Apr 22 10:51:08.975 PDT: VOICE_REG_POOL: key(95021) contact(10.2.161.50) added to contact
table
Apr 22 10:51:08.979 PDT: VOICE_REG_POOL: Created dial-peer entry of type 0
Apr 22 10:51:08.979 PDT: VOICE_REG_POOL: Registration successful for 95021, registration
id is 259
Apr 22 10:51:09.019 PDT: VOICE_REG_POOL: Register request for (95012) from (10.2.161.50)
Apr 22 10:51:09.019 PDT: VOICE_REG_POOL: Contact matches pool 3
Apr 22 10:51:09.019 PDT: VOICE_REG_POOL: key(95012) contact(10.2.161.50) add to contact
table
Apr 22 10:51:09.019 PDT: VOICE_REG_POOL: No entry for (95012) found in contact table
Apr 22 10:51:09.023 PDT: VOICE_REG_POOL: key(95012) contact(10.2.161.50) added to contact
table
Apr 22 10:51:09.027 PDT: VOICE_REG_POOL: Created dial-peer entry of type 0
Apr 22 10:51:09.027 PDT: VOICE_REG_POOL: Registration successful for 95012, registration
id is 260
Apr 22 10:51:09.071 PDT: VOICE_REG_POOL: Register request for (95011) from (10.2.161.50)
Apr 22 10:51:09.071 PDT: VOICE_REG_POOL: Contact matches pool 3
Apr 22 10:51:09.071 PDT: VOICE_REG_POOL: key(95011) contact(10.2.161.50) add to contact
table
Apr 22 10:51:09.071 PDT: VOICE_REG_POOL: No entry for (95011) found in contact table
Apr 22 10:51:09.075 PDT: VOICE_REG_POOL: key(95011) contact(10.2.161.50) added to contact
table
Apr 22 10:51:09.079 PDT: VOICE_REG_POOL: Created dial-peer entry of type 0
Apr 22 10:51:09.079 PDT: VOICE_REG_POOL: Registration successful for 95011, registration
id is 261
Apr 22 10:51:09.123 PDT: VOICE_REG_POOL: Register request for (95500) from (10.2.161.50)
Apr 22 10:51:09.123 PDT: VOICE_REG_POOL: Contact matches pool 3
Cisco Unified CME Commands: Debug
debug voice register events
368
Cisco Unified CME Command Reference
OL-10894-01
Apr 22 10:51:09.123 PDT: VOICE_REG_POOL: key(95500) contact(10.2.161.50) add to contact
table
Apr 22 10:51:09.123 PDT: VOICE_REG_POOL: No entry for (95500) found in contact table
Apr 22 10:51:09.127 PDT: VOICE_REG_POOL: key(95500) contact(10.2.161.50) added to contact
table
Apr 22 10:51:09.131 PDT: VOICE_REG_POOL: Created dial-peer entry of type 0
Apr 22 10:51:09.131 PDT: VOICE_REG_POOL: Registration successful for 95500, registration
id is 262
*Apr 22 11:52:54.523 PDT: VOICE_REG_POOL: Contact doesn't match any pools
*Apr 22 11:52:54.539 PDT: VOICE_REG_POOL: Register request for (33015) from (10.2.152.39)
*Apr 22 11:52:54.539 PDT: VOICE_REG_POOL: Contact doesn't match any pools
*Apr 22 11:52:54.559 PDT: VOICE_REG_POOL: Register request for (33017) from (10.2.152.39)
Table 10 describes the significant fields shown in the display.
Related Commands
Table 10 debug voice register events Field Descriptions
Field Description
Contact Indicates the location of the SIP devices and may indicate the
IP address.
contact table The table that maintains the location of the SIP devices.
key The phone number is used as the unique key to maintain
registrations of SIP devices.
multiple contact More than one registration matches the same phone number.
no entry The incoming registration was not found.
type 0 Normal dial peer.
type 1 Existing normal dial peer.
type 2 Proxy dial peer.
type 3 Existing proxy dial peer.
type 4 Dial-plan dial peer.
type 5 Existing dial-plan dial peer.
type 6 Alias dial peer.
type 7 Existing alias dial peer.
un-registration successful The incoming unregister was successful.
Register request/registration id number The internal unique number for each registration; useful for
debugging particular registrations.
Command Description
debug voice register
errors
Displays debug information on voice register module errors during
registration in a Cisco Unified CME or Cisco Unified SIP SRST
environment.
show sip-ua status
registrar
Displays all the SIP endpoints that are currently registered with the contact
address.
show voice register
dial-peers
Displays details of Cisco Unified SIP SRST configuration and of all
dynamically created VoIP dial peers.
369
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified Commands: E
Revised: October 22, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified Commands: E
elin
370
Cisco Unified CME Command Reference
OL-10894-01
elin
To create a PSTN number that replaces a 911 caller’s extension, use the elin command in voice
emergency response location configuration mode. To remove the number, use the no form of this
command.
elin {1 | 2} number
no elin [1 | 2]
Syntax Description
Command Default No replacement number is created.
Command Modes Voice emergency response location configuration (cfg-emrgncy-resp-location)
Command History
Usage Guidelines Use this command to specify an ELIN, a PSTN number that will replace the caller’s extension.
The PSAP will see this number and use it to query the ALI database to locate the caller. The PSAP also
uses this command for callbacks.
You can configure a second ELIN using the elin 2 command. If two ELINs are configured, the system
selects an ELIN using a round-robin algorithm. If an ELIN is not defined for the ERL, the PSAP sees
the original calling number.
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
elin 1 4085550100
{1 | 2} Number index.
number PSTN number that replaces a 911 caller’s extension.
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 for 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.
Cisco Unified Commands: E
elin
371
Cisco Unified CME Command Reference
OL-10894-01
subnet 10.0.0.0 255.0.0.0
subnet 2 192.168.0.0 255.255.0.0
Related Commands Command Description
subnet Defines which IP phones are part of this ERL.
Cisco Unified Commands: E
elin (voice emergency response settings)
372
Cisco Unified CME Command Reference
OL-10894-01
elin (voice emergency response settings)
To create a default ELIN that is used if no ERL has a subnet mask that matches the current 911 caller’s
IP phone address, use the elin command in voice emergency response settings configuration mode. To
remove the number, use the no form of this command.
elin number
no elin
Syntax Description
Command Default No default ELIN number is created.
Command Modes Voice emergency response settings configuration (cfg-emrgncy-resp-settings)
Command History
Usage Guidelines Use this command to specify an E.164 number to be the default ELIN if the 911 caller’s IP phone address
does not match the subnet of any location in any ERL zone. The default ELIN can be an existing ELIN
already defined in an ERL or it can be unique.
Examples In this example, the ELIN (4085550101) defined in the voice emergency response settings configuration
is used if the 911 caller’s IP phone address does not match any of the voice emergency response
locations. After the 911 call is placed to the PSAP, the PSAP has 120 minutes to call back 408 555-0101
to reach the 911 caller. If the call history has expired (after 120 minutes), any callback is routed to
extension 7500.
voice emergency response settings
callback 7500
elin 4085550101
expiry 120
number An E.164 number to be used as the default ELIN.
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.
Cisco Unified Commands: E
elin (voice emergency response settings)
373
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
callback Default phone number to contact if a 911 callback cannot find the last 911
caller from the ERL.
expiry Number of minutes a 911 call is associated to an ELIN in case of a callback
from the 911 operator.
logging Syslog informational message printed to the console each time an emergency
call is made.
voice emergency
response settings
Creates a tag for identifying settings for E911 behavior.
Cisco Unified Commands: E
emexternal
374
Cisco Unified CME Command Reference
OL-10894-01
emexternal
To remove the login page under the Extension Mobility option from the Services menu on IP phones in
Cisco Unified CME, use the em external command in telephony-service configuration mode. To return
to default, use the no form of this command.
em external
no em external
Syntax Description This command has no keywords or arguments.
Command Default Login page for Extension Mobility is accessible under the Extension Mobility option in the Services
menu.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command removes the Extension Mobility login page from the Sevices menu on all IP phones
registered in a Cisco Unified CME system on which Extension Mobility is enabled.
Examples The following partial output shows the configuration for this command:
router# show running-configuration
.
.
.
telephony-service
em external
em logout 1:0
max-ephones 10
max-dn 100
ip source-address 10.0.0.1 port 2000
url authentication http://10.0.0.1/CCMCIP/authenticate.asp
cnf-file location flash:
cnf-file perphone
max-conferences 8 gain -6
transfer-system full-consult
create cnf-files version-stamp Jan 01 2002 00:00:00
!

Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified Commands: E
emexternal
375
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
ip http server Enables the HTTP server on the Cisco Unified CME router that hosts the
service URL for the Extension Mobility Login and Logout page.
Cisco Unified Commands: E
emadmin login
376
Cisco Unified CME Command Reference
OL-10894-01
emadmin login
To permit an external application to log into a Cisco Unified IP phone that is enabled for Extension
Mobility in Cisco Unified CME, use the emadmin login command in privileged EXEC mode.
emadmin login name ephone-tag
Syntax Description
Command Default External application cannot log into an Extension Mobility phone.
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines This command enables an external application, such as a CSTA client application, to log into an
Extension Mobility phone.
Before using this command, configure a credential in Extension Mobility by using the user command in
voice-user-profile configuration mode.
The IP phone to be accessed must be enabled for Extension Mobility.
The application remains logged into the phone until it is manually or automatically logged out from the
Extension Mobility phone
This command does not have a no form.
Examples The following example shows how to configure this command to log an application into an Extension
Mobility phone (2) using the “user204” credential:
Router# login user204 2
Router#
Related Commands
name Credential for Extension Mobility. This credential must be already
configured by using the user command in voice-user-profile configuration
mode.
ephone-tag Unique identifier for IP phone that is enabled for Extension Mobility. This
tag must already be configured by using the ephone command.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
emadmin logout Logs out an external application from Extension Mobility.
em logout Creates up to three time-of-day timers for automatically logging out all
Extension Mobility users.
Cisco Unified Commands: E
emadmin login
377
Cisco Unified CME Command Reference
OL-10894-01
logout-profile Enables an IP phone for Extension Mobility.
max-idle-time Creates an idle-duration timer for automatically logging out an Extension
Mobility user.
user Creates an authentication credential to be used by Extension Mobility.
Command Description
Cisco Unified Commands: E
emadmin logout
378
Cisco Unified CME Command Reference
OL-10894-01
emadmin logout
To manually log out an external application from Extension Mobility, use the emadmin logout
command in privileged EXEC mode. To return to default, use the no form of this command.
emadmin logout name
no emadmin logout name
Syntax Description
Command Default Application remains logged into the Extension Mobility phone until logged out.
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines This command enables an external application, such as a CSTA client application, to log out of an
Extension Mobility phone.
Examples The following example shows how to configure this command to log out an application that logged into
an Extension Mobility phone using the “user204” credential:
Router# logout user204
Router#
Related Commands
name Already-configured credential in Extension Mobility user profile.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
user Creates an authentication credential to be used by Extension Mobility.
Cisco Unified Commands: E
emergency response callback
379
Cisco Unified CME Command Reference
OL-10894-01
emergency response callback
To define a dial peer that is used for 911 callbacks from the PSAP, use the emergency response callback
command in voice dial-peer configuration mode. To remove the definition of the dial peer as an incoming
link from the PSAP, use the no form of this command.
emergency response callback
no emergency response callback
Syntax Description This command has no arguments or keywords.
Command Default The dial peer is not defined as an incoming link from the PSAP.
Command Modes Dial-peer configuration (config-dial-peer)
Command History
Usage Guidelines Use this command to define which dial peer is used for 911 callbacks from the PSAP. You can define
multiple dial peers with this command.
Examples The following example shows a dial peer defined as an incoming link from the PSAP. If 408 555-0100
is configured as the ELIN for an ERL, this dial peer recognizes that an incoming call from 408 555-0100
is a 911 callback.
dial-peer voice 100 pots
incoming called-number 4085550100
port 1/1:D
direct-inward-dial
emergency response callback
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 for 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.
Cisco Unified Commands: E
emergency response callback
380
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
emergency response
location
Associates an ERL to either a SIP phone, ephone, or dial peer.
emergency response
zone
Defines a dial peer that is used by the system to route emergency calls to the
PSAP.
voice emergency
response location
Creates a tag for identifying an ERL for the enhanced 911 service.
Cisco Unified Commands: E
emergency response location
381
Cisco Unified CME Command Reference
OL-10894-01
emergency response location
To associate an emergency response location (ERL) for Enhanced 911 Services with a dial peer, ephone,
ephone-template, voice register pool, or voice register template, use the emergency response location
command in dial peer, ephone, ephone-template, voice register pool, or voice register template
configuration mode. To remove the association, use the no form of this command.
emergency response location tag
no emergency response location tag
Syntax Description
Command Default No ERL tag is associated with a dial peer, ephone, ephone-template, voice register pool, or voice register
template.
Command Modes Dial-peer configuration (config-dial-peer)
Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Voice register pool configuration (config-register-pool)
Voice register template configuration (config-register-template)
Command History
Usage Guidelines Use this command to assign an ERL to phones individually. Depending on the type of phones (endpoints)
that you have, you can assign an ERL to a phone’s:
• Dial-peer configuration
• Ephone
• Ephone-template
• Voice register pool
• Voice register template
tag Unique number that identifies an existing ERL tag defined by the voice
emergency response location command.
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
in the ephone-template and voice register template
configuration modes.
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.
Cisco Unified Commands: E
emergency response location
382
Cisco Unified CME Command Reference
OL-10894-01
Note The ephone-template and voice register template modes are not for Cisco Unified SRST or
Cisco Unified SIP SRST. Voice register pool mode is not available for Cisco Unified SRST.
These methods of associating a phone with an ERL are alternatives to assigning a group of phones that
are on the same subnet as an ERL.
The tag used by this command is an integer from 1 to 2147483647 and refers to an existing ERL tag that
is defined by the voice emergency response location command. If the tag does not refer to a valid ERL
configuration, the phone is not associated to an ERL. For Cisco Unified IP phones, the IP address is used
to find the inclusive ERL subnet. For phones on a VoIP trunk or FXS/FXO trunk, the PSAP gets a reorder
tone.
Examples The following example shows how to assign an ERL to a phone’s dial peer:
dial-peer voice 12 pots
emergency response location 18
The following example shows how to assign an ERL to a phone’s ephone:
ephone 41
emergency response location 22
The following example shows how to assign an ERL to one or more SCCP phones:
ephone-template 6
emergency response location 8
The following example shows how to assign an ERL to a phone’s voice register pool:
voice register pool 4
emergency response location 21
The following example shows how to assign an ERL to one or more SIP phones:
voice register template 4
emergency response location 8
Related Commands Command Description
emergency response
callback
Defines a dial peer that is used for 911 callbacks from the PSAP.
emergency response
zone
Defines a dial peer that is used by the system to route emergency calls to the
PSAP.
voice emergency
response location
Creates a tag for identifying an ERL for the enhanced 911 service.
Cisco Unified Commands: E
emergency response zone
383
Cisco Unified CME Command Reference
OL-10894-01
emergency response zone
To define a dial peer that is used by the system to route emergency calls to a PSAP, use the
emergency response zone command in voice dial-peer configuration mode. To remove the definition of
the dial peer as an outgoing link to the PSAP, use the no form of this command.
emergency response zone zone-tag
no emergency response zone
Syntax Description
Command Default The dial peer is not defined as an outgoing link to the PSAP. Therefore, E911 services are not enabled.
Command Modes Dial-peer configuration (config-dial-peer)
Command History
Usage Guidelines Use this command to specify that any calls using this dial peer are processed by the E911 software. To
enable any E911 processing, the emergency response zone command must be enabled under a dial peer.
If no zone tag is specified, the system looks for a matching ELIN to the E911 caller’s phone by searching
each emergency response location that was configured using the emergency response location
command.
If a zone tag is specified, the system looks for a matching ELIN using sequential steps according to the
contents of the configured zone. For example, if the E911 caller’s phone has an explicit ERL assigned,
the system first looks for that ERL in the zone. If not found, it then searches each location within the
zone according to assigned priority numbers, and so on. If all steps fail to find a matching ELIN, the
default ELIN is assigned to the E911 caller’s phone. If no default ELIN is configured, the E911 caller’s
automatic number identification (ANI) number is communicated to the Public Safety Answering Point
(PSAP).
This command can be defined in multiple dial peers. The zone tag option allows only ERLs defined in
that zone to be routed on this dial peer. Also, this command allows callers dialing the same emergency
number to be routed to different voice interfaces based on the zone that includes their ERL.
zone-tag Identifier (1-100) for the emergency response zone.
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)
The zone-tag argument was added and this
command was added for 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.
Cisco Unified Commands: E
emergency response zone
384
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows a dial peer defined as an outgoing link to the PSAP. Emergency response
zone 10 is created and only calls from this zone are routed through 1/0/0.
dial-peer voice 911 pots
destination-pattern 9911
prefix 911
emergency response zone 10
port 1/0/0
Related Commands Command Description
emergency response
callback
Defines a dial peer that is used for 911 callbacks from the PSAP.
emergency response
location
Associates an ERL to either a SIP phone, ephone, or dial peer.
voice emergency
response location
Creates a tag for identifying an ERL for E911 services.
voice emergency
response zone
Creates an emergency response zone within which ERLs can be grouped.
Cisco Unified Commands: E
emkeep-history
385
Cisco Unified CME Command Reference
OL-10894-01
emkeep-history
To disable Automatic Clear Call History for Extension Mobility phones in Cisco Unified CME, use the
em keep-history command in telphony-service configuration mode. To return to the default, use the no
form of this command.
em keep-history
no em keep-history
Syntax Description This command has no arguments or keywords.
Command Default Call history record is automatically cleared when a user logs out from an Extension Mobility phone.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command disables Automatic Clear Call History for Extension Mobility phones in
Cisco Unified CME.
In Cisco Unified CME 4.3 and later versions, the EM manager in Cisco Unified CME sends commands
to a phone to clear call history anytime a user is logs out from Extension Mobility. Use this command in
telephony-service configuration mode to disable this feature at a system-level.
Examples The following example shows how to configure Extension Mobility in Cisco Unified CME to keep, not
clear, call histories after users log out from Extension Mobility phones:
Router(config)# telephony-service
Router(config-telephony)# em keep-history
Router(config-telephony)#
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 integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified Commands: E
emlogout
386
Cisco Unified CME Command Reference
OL-10894-01
emlogout
To configure up to three time-of-day based timers for automatically logging out all Extension Mobility
users, use the em logout command in telephony-service configuration mode. To disable the timer, use
the no form of this command.
em logout time1 [time2] [time3]
no command time1 [time2] [time3]
Syntax Description
Command Default No time-of-day timer is created for automatically logging out Extension Mobility users.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command creates up to three time-of-day timers for automatically logging out all Extension
Mobility users. If an Extension Mobility user is using the phone when automatic logout occurs, the user
is logged out after the active call is completed.
The call history record is automatically cleared when a user logs out from an Extension Mobility phone.
To disable Automatic Clear Call History on all Extension Mobility phones, use the em keep-history
command in telephony-service configuration mode.
Examples The following example shows how to configure two time-of-day timers to automatically log out all
logged-on Extension Mobility users at 5:30 PM and again at midnight each day:
Router(config)# telephony-service
Router(config-telephony)# em logout 17:30 24:00
Router(config-telephony)#

Related Commands
time Time of day after which all users that are logged into Extension Mobility are
logged out from Extension Mobility. Range: 00:00 to 24:00 on a 24-hour
clock.
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 integrated into
Cisco IOS Release 12.4(20)T.
Command Description
em keep-history Disables Automatic Clear Call History for Extension Mobility in
Cisco Unified CME.
Cisco Unified Commands: E
ephone
387
Cisco Unified CME Command Reference
OL-10894-01
ephone
To enter Ethernet phone (ephone) configuration mode for an IP phone for the purposes of creating and
configuring an ephone, use the ephone command in global configuration mode. To disable the ephone
and remove the IP phone configuration, use the no form of this command.
ephone phone-tag
no ephone phone-tag
Syntax Description
Command Default No Cisco IP phone is configured.
Command Modes Global configuration (config)
Command History
Usage Guidelines Use the ephone command to enter ephone configuration mode. Use ephone configuration mode to create
and configure Cisco Unified IP phones in Cisco Unified CME.
Before this command can be used for the first time, you must set the maximum number of ephones using
the max-ephones command in telephony-service configuration mode. The maximum number of ephones
varies by router platform and software version.
Examples The following example enters ephone configuration mode for a phone with the identifier 4 and assigns
ephone-dn 1 to button 1:
Router(config)# ephone 4
Router(config-ephone)# button 1:1

Related Commands
phone-tag Unique sequence number that identifies an ephone during configuration
tasks. The maximum number is platform-dependent; refer to Cisco IOS -line
interface (CLI) help.
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.
Description
button Assigns a button number to the Cisco IP phone directory number.
ephone-dn Enters ephone-dn configuration mode.
mac-address Configures the MAC address of a Cisco IP phone.
Cisco Unified Commands: E
ephone
388
Cisco Unified CME Command Reference
OL-10894-01
max-ephones Configures the maximum number of Cisco IP phones that can be supported
by a router.
restart (ephone) Performs a fast reboot of a single phone associated with a Cisco CME router.
restart all (telephony-
service)
Performs a fast reboot of all phones associated with a Cisco CME router.
Description
Cisco Unified Commands: E
ephone-dn
389
Cisco Unified CME Command Reference
OL-10894-01
ephone-dn
To enter ephone-dn configuration mode to configure a directory number for an IP phone line, intercom
line, paging line, voice-mail port, or message-waiting indicator (MWI), use the ephone-dn command in
global configuration mode. To delete an ephone-dn, use the no form of this command.
ephone-dn dn-tag [dual-line | octo-line]
no ephone-dn dn-tag
Syntax Description
Command Default No ephone-dn is configured.
Command Modes Global configuration (config)
Command History
Usage Guidelines Use this command to enter ephone-dn configuration mode to create directory numbers. In ephone-dn
configuration mode, you assign an extension number using the number command, a name to appear in
the local directory using the name command, and other parameters using various commands.
Before using the ephone-dn command, you must set the maximum number of ephone-dns to support in
your system by using the max-dn command. The maximum number of ephone-dns that you can create
depends on the software version, router platform, and amount of memory that you have installed.
A dual-line ephone-dn has one virtual voice port and two channels to handle two independent calls. This
capacity allows call waiting, call transfer, and conference functions within a single directory number.
Dual-line mode is supported on all phone types, but is not appropriate for voice-mail numbers,
intercoms, or ephone-dns used for message-waiting indicators, paging, loopback, or hunt groups.
Overlays of single-line hunt groups onto dual-line buttons are supported.
dn-tag Unique number that identifies an ephone-dn during configuration tasks.
Range is 1 to the number set by the max-dn command.
dual-line (Optional) Enables two calls per directory number.
octo-line (Optional) Enables eight calls per directory number.
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 dual-line keyword was added.
12.3(4)T Cisco CME 3.4 The dual-line keyword was integrated into
Cisco IOS Release 12.3(4)T.
12.4(15)XZ Cisco Unified CME 4.3 The octo-line keyword was added.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified Commands: E
ephone-dn
390
Cisco Unified CME Command Reference
OL-10894-01
An octo-line directory number supports up to eight active calls, both incoming and outgoing, on a single
phone button. Unlike a dual-line directory number, which is shared exclusively among phones, an
octo-line directory number can split its channels among the phones sharing the directory number. All
phones sharing the octo-line directory number are allowed to initiate or receive calls on the idle channels
of the directory number.
Ephone-dns are created in single-line mode if the dual-line or octo-line keyword is not used. To change
an ephone-dn from one mode to another, for example from dual-line mode to single-line mode, you must
delete the ephone-dn and then re-create it.
Examples The following example shows how to create directory number 1 with extension 5576:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 5576

The following example shows an ephone-dn with the number 1001 in dual-line mode. The no huntstop
command allows calls to continue to hunt to other ephone-dns if this one is busy or does not answer. The
huntstop channel command disables call hunting to the second channel of this ephone-dn if the first
channel is busy or does not answer.
Router(config)# ephone-dn 10 dual-line
Router(config-ephone-dn)# number 1001
Router(config-ephone-dn)# no huntstop
Router(config-ephone-dn)# huntstop channel

The following example shows an ephone-dn with the number 2001 in octo-line mode. The huntstop
channel command enables call hunting to up to six channels of this ephone-dn. The remaining two
channels are available for outgoing calls or features such as call transfer, call waiting, and conferencing.
Router(config)# ephone-dn 20 octo-line
Router(config-ephone-dn)# number 2001
Router(config-ephone-dn)# huntstop channel 6
Related Commands Command Description
huntstop (ephone-dn and
ephone-dn-template)
Disables call hunting for directory numbers or channels.
max-dn Sets the maximum number of ephone-dns that can be configured.
name Associates a name with an extension (ephone-dn).
number Associates a telephone or extension number with a directory number
(ephone-dn).
Cisco Unified Commands: E
ephone-dn-template
391
Cisco Unified CME Command Reference
OL-10894-01
ephone-dn-template
To enter ephone-dn-template configuration mode and create an ephone-dn template containing a
standard set of ephone-dn features, use the ephone-dn-template command in global configuration
mode. To delete an ephone-dn template, use the no form of this command.
ephone-dn-template template-tag
no ephone-dn-template template-tag
Syntax Description
Command Default No ephone-dn template is created.
Command Modes Global configuration (config)
Command History
Usage Guidelines Use this command to create an ephone-dn template. An ephone-dn template contains a set of ephone-dn
attributes that you can easily apply to one or more ephone-dns.
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
Type? in ephone-dn-template configuration mode to see the commands that are available in this mode.
The following example shows CLI help for ephone-dn-template configuration mode:
Router(config-ephone-dn-template)# ?
Ephone Dn template configuration commands:
call-forward Define E.164 telephone number for call forwarding
call-waiting Config call-waiting option
caller-id Configure port caller id parameters
corlist Class of Restriction on dial-peer for this dn
default Set a command to its defaults
description dn desc, for DN Qualified Display Name
exit Exit from ephone-dn-template configuration mode
hold-alert Set Call On-Hold timeout alert parameters
huntstop Stop hunting on Dial-Peers
mwi set message waiting indicator options (mwi)
no Negate a command or set its defaults
pickup-group set the call pickup group number for the DN
translate Translation rule
translation-profile Translation profile
template-tag Identifier for this ephone-dn template. Range is from 1 to 15.
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.
Cisco Unified Commands: E
ephone-dn-template
392
Cisco Unified CME Command Reference
OL-10894-01
After creating an ephone-dn template, apply the template to one or more ephone-dns using the
ephone-dn-template command in ephone-dn configuration mode. Even though you can define up to 15
different ephone templates, you cannot apply more than one template to a particular ephone-dn.
If you try to apply a second ephone-dn template to an ephone-dn that already has a template applied to
it, the second template will overwrite the first ephone-dn template configuration after you use the restart
command to reboot the phone.
To view your ephone-dn-template configurations, use the show telephony-service ephone-dn-template
command. To see which ephone-dns have templates applied to them, use the show running-config
command.
Examples The following example creates ephone-dn template 3, which sets call forwarding on busy and no answer
to forward calls to extension 4000 and sets the pickup group to 4. Ephone-dn template 3 is then applied
to ephone-dn 23 and ephone-dn 33, which appear on ephones 13 and 14, respectively.
ephone-dn-template 3
call-forwarding busy 4000
call-forwarding noan 4000 timeout 30
pickup group 4
ephone-dn 23
number 2323
ephone-dn-template 3
ephone-dn 33
number 3333
ephone-dn-template 3
ephone 13
button 1:23
ephone 14
button 1:33

Related Commands Command Description
ephone-dn-template
(ephone-dn)
Applies an ephone-dn template to an ephone-dn.
restart (ephone) Performs a fast reboot of a single phone associated with a
Cisco Unified CME router.
restart
(telephony-service)
Performs a fast reboot of one or all phones associated with a
Cisco Unified CME router.
show
telephony-service
ephone-dn-template
Displays ephone-dn-template configurations.
Cisco Unified Commands: E
ephone-dn-template (ephone-dn)
393
Cisco Unified CME Command Reference
OL-10894-01
ephone-dn-template (ephone-dn)
To apply an ephone-dn template to an ephone-dn, use the ephone-dn-template command in ephone-dn
configuration mode. To remove the ephone-dn template, use the no form of this command.
ephone-dn-template template-tag
no ephone-dn-template template-tag
Syntax Description
Command Default No ephone-dn template is applied to the ephone-dn.
Command Modes Ephone-dn configuration (config-ephone-template)
Command History
Usage Guidelines Use the ephone-dn-template command in ephone-dn configuration mode to apply an ephone-dn
template to an ephone. You cannot apply more than one ephone-dn template to an ephone-dn.
If you try to apply a second ephone-dn template to an ephone-dn that already has an ephone-dn template
applied to it, the second template will overwrite the first ephone-dn template configuration.
To view your ephone-dn-template configurations, use the show telephony-service ephone-dn-template
command.
Examples The following example shows how to create ephone-dn template 3, which sets call forwarding on busy
and no answer to forward calls to extension 4000 and sets the pickup group to 4, and apply the template
to ephone-dn 23 and ephone-dn 33, which appear on ephones 13 and 14, respectively.
ephone-dn-template 3
call-forwarding busy 4000
call-forwarding noan 4000 timeout 30
pickup group 4
ephone-dn 23
number 2323
ephone-dn-template 3
ephone-dn 33
number 3333
ephone-dn-template 3
template-tag The template tag for a template created with the ephone-dn-template
command in global configuration mode. Range is from 1 to 15.
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.
Cisco Unified Commands: E
ephone-dn-template (ephone-dn)
394
Cisco Unified CME Command Reference
OL-10894-01
ephone 13
button 1:23
ephone 14
button 1:33

Related Commands Command Description
ephone-dn Enters ephone-dn configuration mode.
ephone-dn-template Creates an ephone-dn template and enters ephone-dn-template
configuration mode.
show
telephony-service
ephone-dn-template
Displays ephone-dn template configurations.
Cisco Unified Commands: E
ephone-hunt
395
Cisco Unified CME Command Reference
OL-10894-01
ephone-hunt
To enter ephone-hunt configuration mode for the purposes of creating and configuring a hunt group for
use in a Cisco Unified CME system, use the ephone-hunt command in global configuration mode. To
delete a hunt group, use the no form of this command.
ephone-hunt hunt-tag {longest-idle | peer | sequential}
no ephone-hunt hunt-tag
Syntax Description
Command Default No hunt group is defined.
Command Modes Global configuration (config)
Command History
Usage Guidelines Use the ephone-hunt command to enter ephone-hunt configuration mode. Use ephone-hunt
configuration mode to create ephone hunt groups in a Cisco Unified CME system.
A hunt group is a list of phone numbers that are assigned to take turns receiving incoming calls for one
number, a pilot number that is defined with the pilot command. The list of numbers in the hunt group is
defined using the list command. If a number in the list is busy or does not answer, the call is redirected
to the next number in the list. The last number tried is the final number, which is defined using the final
command.
hunt-tag Unique sequence number that identifies the ephone hunt group during
configuration tasks. Range is from 1 to 100.
longest-idle Hunt group in which calls go to the ephone-dn that has been idle the longest.
peer Hunt group in which the first extension to ring is the number to the right (in
the list) of the extension that was the last one to ring when the hunt group
was last called. Ringing proceeds in a circular manner, left to right, for the
number of hops specified when the ephone hunt group is defined.
sequential Hunt group in which extensions ring in the order in which they are listed, left
to right, when the hunt group is defined.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.3(11)T Cisco CME 3.2 The longest-idle keyword was added.
12.4(4)XC Cisco Unified CME 4.0 The maximum number of hunt groups was
increased from 10 to 100.
12.4(9)T Cisco Unified CME 4.0 This command with the maximum number of hunt
groups increased to 100 was integrated into
Cisco IOS Release 12.4(9)T.
Cisco Unified Commands: E
ephone-hunt
396
Cisco Unified CME Command Reference
OL-10894-01
The order in which the numbers are chosen can be longest-idle, peer, or sequential.
• If the order is longest-idle, each hop is directed to the ephone-dn that has been idle the longest. Idle
time is determined from the last time that a phone registered, reregistered, or went on-hook.
• If the order is peer, the first number to which calls are directed is the number to the right of the
number in the list that was the last number to ring on the previous occasion that the hunt group was
called. If that number is busy or does not answer, the call is directed to the next number in the list
and, in the process, circles back to the beginning of the list. In peer hunt groups, the hops command
specifies how many times a call can hop from number to number before going to the final number,
after which the call is no longer forwarded.
• If the order is sequential, the first number to which calls are directed is always the first number in
the list. If that number is busy or does not answer, the call is redirected to the next available number
in the list, from left to right.
Note If the number of times that a call is redirected to a new number exceeds 5, the max-redirect command
must be used to increase the allowable number of redirects in the Cisco Unified CME system.
To configure a new hunt group, you must specify the longest-idle, peer, or sequential keyword. To
change an existing ephone hunt group configuration, the keyword is not required. To change the type of
hunt group from peer to sequential or sequential to peer, you must remove the existing hunt group first
using the no form of the command and then recreate it.
Examples The following example defines longest-idle ephone hunt group 1 with a pilot number 7501, a final
number 8000, and 11 numbers in the list. After a call is redirected six times (makes six hops), it is
redirected to the final number 8000.
ephone-hunt 1 longest-idle
pilot 7501
list 7001, 7002, 7023, 7028, 7045, 7062, 7067, 7072, 7079, 7085, 7099
final 8000
preference 1
hops 6
timeout 20
no-reg

The following example defines peer hunt group number 2. Callers dial the pilot number 5610 to reach
the hunt group. The first extension to ring the first time that this hunt group is called is 5601. If 5601
does not answer, the hunt proceeds from left to right, beginning with the extension directly to the right
of 5601, for four hops. If none of those extensions answers before the hops limit is reached, the call is
forwarded to extension 6000, which is the number for the voice-mail service.
If extension 5601 answers the first call, then the second time someone calls the hunt group, the first
extension to ring is 5602. If this call hops until extension 5617 answers it, then the third time someone
calls the hunt group, the first extension to ring is 5633. If extension 5633 does not answer, the call is
redirected to extension 5601, and so forth.
Router(config)# ephone-hunt 2 peer
Router(config-ephone-hunt)# pilot 5610
Router(config-ephone-hunt)# list 5601, 5602, 5617, 5633
Router(config-ephone-hunt)# final 6000
Router(config-ephone-hunt)# hops 4
Router(config-ephone-hunt)# preference 1
Router(config-ephone-hunt)# timeout 30
Router(config-ephone-hunt)# exit

Cisco Unified Commands: E
ephone-hunt
397
Cisco Unified CME Command Reference
OL-10894-01
The following example defines sequential hunt group number 1. When callers dial extension 5601, the
first phone to ring is 5001, then 5002, 5017, and 5028. If none of those extensions answers, the call is
forwarded to extension 6000, which is the number for the voice-mail service.
Router(config)# ephone-hunt 1 sequential
Router(config-ephone-hunt)# pilot 5601
Router(config-ephone-hunt)# list 5001, 5002, 5017, 5028
Router(config-ephone-hunt)# final 6000
Router(config-ephone-hunt)# preference 1
Router(config-ephone-hunt)# timeout 30
Router(config-ephone-hunt)# exit

Related Commands Description
final Defines the last ephone-dn in an ephone hunt group.
hops Defines the number of times that a call is redirected to the next ephone-dn in
a peer ephone-hunt-group list before proceeding to the final ephone-dn.
list Defines the ephone-dns that participate in an ephone hunt group.
max-redirect Changes the current number of allowable redirects in a Cisco Unified CME
system.
no-reg (ephone-hunt) Specifies that the pilot number of this ephone hunt group should not register
with the H.323 gatekeeper.
pilot Defines the ephone-dn that is dialed to reach an ephone hunt group.
preference
(ephone-hunt)
Sets preference order for the ephone-dn associated with an
ephone-hunt-group pilot number.
timeout (ephone-hunt) Sets the number of seconds after which a call that is not answered is
redirected to the next number in the hunt-group list.
Cisco Unified Commands: E
ephone-hunt login
398
Cisco Unified CME Command Reference
OL-10894-01
ephone-hunt login
To authorize an ephone-dn to dynamically join and leave an ephone hunt group, use the ephone-hunt
login command in ephone-dn configuration mode. To disable this capability, use the no form of this
command.
ephone-hunt login
no ephone-hunt login
Syntax Description This command has no arguments or keywords.
Command Default An ephone-dn is not allowed to dynamically join and leave ephone hunt groups.
Command Modes Ephone-dn configuration (config-ephone-dn)
Command History
Usage Guidelines Use the show ephone-hunt command to display current hunt group members, including those who
joined the group dynamically.
Examples The following example creates five ephone-dns and a hunt group that includes the first two ephone-dns
and two wildcard slots. The last three ephone-dns are enabled for group hunt dynamic membership. Each
of them can join and leave the hunt group whenever one of the slots is available.
ephone-dn 22
number 4566
ephone-dn 23
number 4567
ephone-dn 24
number 4568
ephone-hunt login
ephone-dn 25
number 4569
ephone-hunt login
ephone-dn 26
number 4570
ephone-hunt login
ephone-hunt 1 peer
Cisco IOS Release Cisco Product Modification
12.4(4)XC Cisco Unified CME 4.0 This command was introduced.
12.4(9T Cisco Unified CME 4.0 This command was integrated into Cisco IOS
Release 12.4(9)T.
Cisco Unified Commands: E
ephone-hunt login
399
Cisco Unified CME Command Reference
OL-10894-01
list 4566,4567,*,*
final 7777

Related Commands Description
show ephone-hunt Displays ephone-hunt group configuration, current status, and statistics.
Cisco Unified Commands: E
ephone-hunt statistics write-all
400
Cisco Unified CME Command Reference
OL-10894-01
ephone-hunt statistics write-all
To write ephone-hunt statistics information to a file, use the ephone-hunt statistics write-all command
in privileged EXEC mode.
ephone-hunt statistics write-all location
Syntax Description
Command Modes Privileged EXEC (#)
Command History
Usage Guidelines Use this command to write out, in hourly increments, all the ephone hunt group statistics for the past
seven days. This command is intended be used when normal hunt group statistics collection is
interrupted, perhaps due to TFTP server failure. The commands that are normally used to provide
hunt-group statistics are hunt-group report delay hours, hunt-group report every hours, hunt-group
report url, and statistics collect. These commands allow you to specify shorter, more precise reporting
periods and file-naming conventions.
Note Each year on the day that daylight saving time adjusts the time back by one hour at 2 a.m., the original
1 a.m. to 2 a.m. statistics for that day are lost because they are overwritten by the new 1 a.m. to 2 a.m.
statistics.
Examples The following example writes the ephone hunt group statistics to a file in flash called “huntstats.” See
the hunt-group report url command for explanations of the output fields.
Router# ephone-hunt statistics write-all flash:huntstats
Writing out all ephone hunt statistics to tftp now.
11:13:58 UTC Fri Apr 29 2005,
,
01, Fri 11:00 - 12:00, HuntGp, 01, 01, 00000, 00000, 00000, 0000, 0000, 000000, 000000,
0000, 00000, 000000, 000000,
01, Fri 12:00 - 13:00, HuntGp, 00, 00, 00000, 00000, 00000, 0000, 0000, 000000, 000000,
0000, 00000, 000000, 000000,
01, Fri 13:00 - 14:00, HuntGp, 00, 00, 00000, 00000, 00000, 0000, 0000, 000000, 000000,
0000, 00000, 000000, 000000,
01, Fri 14:00 - 15:00, HuntGp, 00, 00, 00000, 00000, 00000, 0000, 0000, 000000, 000000,
0000, 00000, 000000, 000000,
01, Fri 15:00 - 16:00, HuntGp, 00, 00, 00000, 00000, 00000, 0000, 0000, 000000, 000000,
0000, 00000, 000000, 000000,
.
location The URL or filename to which the statistics should be written.
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.
Cisco Unified Commands: E
ephone-hunt statistics write-all
401
Cisco Unified CME Command Reference
OL-10894-01
.
.
Related Commands Command Description
show ephone-hunt Displays ephone hunt group information.
show ephone-hunt
statistics
Displays ephone hunt group statistics.
hunt-group report
delay hours
Delays hunt-group statistics collection for a specified number of hours.s
hunt-group report
every hours
Sets the hourly interval at which Cisco Unified CME B-ACD call statistics
are automatically transferred to a file.
hunt-group report url Sets filename parameters and the URL path where Cisco Unified CME
B-ACD call statistics are to be sent using TFTP.
statistics collection Enables the collection of call statistics for an ephone hunt group.
Cisco Unified Commands: E
ephone-template
402
Cisco Unified CME Command Reference
OL-10894-01
ephone-template
To create an ephone template to configure a set of phone features and to enter ephone-template
configuration mode, use the ephone-template command in global configuration mode. To delete an
ephone template, use the no form of this command.
ephone-template template-tag
no ephone-template template-tag
Syntax Description
Command Default No ephone template is created.
Command Modes Global configuration (config)
Command History
Usage Guidelines Use this command to create an ephone template containing a set of ephone commands. The template can
then be easily applied to one or more ephones.
If you use an ephone template to apply a command to a phone and you also use the same command in
ephone configuration mode for the same phone, the value that you set in ephone configuration mode has
priority.
template-tag Identifier for this ephone template. Range is from 1 to 20.
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 maximum number of templates that can be
created was increased from 5 to 20.
12.4(9)T Cisco Unified CME 4.0 The modification to increase the maximum
number of templates that can be created from 5 to
20 was integrated into Cisco IOS Release
12.4(9)T.
Cisco Unified Commands: E
ephone-template
403
Cisco Unified CME Command Reference
OL-10894-01
Type ? in ephone-template configuration mode to see the commands that are available in this mode and
that can be included in an ephone-template. The following example shows CLI help for ephone-template
configuration mode at the time that this document was written:
Router(config-ephone-template)#?
Ephone template configuration commands:
after-hour ephone exempt from after-hour blocking
codec Set preferred codec for calls with other phones on this
router
default Set a command to its defaults
exit Exit from ephone-template configuration mode
fastdial Define ip-phone fastdial number
features define features blocked
keep-conference Do not disconnect conference when conference initiator
hangs-up.Connect remaining parties together directly using
call transfer.
keepalive Define keepalive timeout period to unregister IP phone
keyphone Identify an IP phone as keyphone
mtp Always send media packets to this router
network-locale Select the network locale for this template.
night-service Define night-service bell
no Negate a command or set its defaults
paging-dn set audio paging dn group for phone
service Service configuration in ephone template
softkeys define softkeys per state
speed-dial Define ip-phone speed-dial number
transfer transfer related configuration
transfer-park customized transfer to park configuration
transfer-pattern customized transfer-pattern configuration
type Define ip-phone type
user-locale Select the user locale for this template.

After creating an ephone template, apply the template to one or more ephones using the
ephone-template command in ephone configuration mode. Even though you can define up to 20
different ephone templates, you cannot apply more than one template to a particular ephone.
After applying a template to an ephone or removing a template from an ephone, use the following
commands:
• restart—Performs a fast reboot of the phone.
• create cnf-files—Rebuilds configuration files.
If you try to apply a second ephone template to an ephone that already has an ephone template applied
to it, the second template will overwrite the first ephone template configuration after you use the restart
command to reboot the phone.
To view your ephone-template configurations, use the show telephony-service ephone-template
command. To see which ephones have templates applied to them, use the show running-config
command.
Examples The following example creates two ephone templates. The softkeys commands in ephone-template
configuration mode define what soft keys are displayed and their order. Template 1 is applied to
ephone 32, which has the extension 2555, and template 2 is applied to ephone 38, which has the
extension 2666.
ephone-template 1
softkeys idle Dnd Redial Newcall Pickup Login
softkeys seized Redial Cfwdall Gpickup Pickup
softkeys alerting Callback Endcall
Cisco Unified Commands: E
ephone-template
404
Cisco Unified CME Command Reference
OL-10894-01
softkeys connected Confrn Hold Endcall
ephone-template 2
softkeys idle Redial Pickup
softkeys seized Redial Pickup
softkeys connected Hold Endcall
ephone-dn 25
number 2555
ephone-dn 26
number 2666
ephone 32
button 1:25
ephone-template 1
ephone 38
button 1:26
ephone-template 2
The following example creates an ephone template to block the use of Park and Trnsfer soft keys. It is
applied to extension 2333.
ephone-template 15
features blocked Park Trnsfer
ephone-dn 2
number 2333
ephone 3
button 1:2
ephone-template 15
Related Commands Command Description
create cnf-files Builds phone configuration files.
ephone-template
(ephone)
Applies an ephone template to an ephone.
restart (ephone) Performs a fast reboot of a single phone associated with a
Cisco Unified CME router.
restart
(telephony-service)
Performs a fast reboot of one or all phones associated with a
Cisco Unified CME router.
show
telephony-service
ephone-template
Displays ephone-template configurations.
Cisco Unified Commands: E
ephone-template (ephone)
405
Cisco Unified CME Command Reference
OL-10894-01
ephone-template (ephone)
To apply an ephone template to a particular SCCP phone in Cisco Unified CME, use the
ephone-template command in ephone configuration mode. To remove the ephone template, use the no
form of this command.
ephone-template template-tag
no ephone-template template-tag
Syntax Description
Command Default No ephone template is applied to a phone.
Command Modes Ephone configuration (config-ephone)
Command History
Usage Guidelines This command in ephone configuration mode applies an ephone template to a particular phone.
In Cisco Unified CME 4.3 and later versions, an ephone template cannot be applied to a particular phone
unless its configuration file includes its MAC address. If you attempt to apply a template to a phone for
which the MAC address in not configured, a message appears. To configure the MAC address for a
Cisco Unified IP phone, use the mac-address command in ephone configuration mode.
After applying an ephone template, use the restart command to perform a fast reboot of the phone.
You cannot apply more than one ephone template at a time to any phone. If you attempt to apply a second
ephone template to phone to which an ephone template is already applied, the second template will
overwrite the first ephone template configuration after you reboot the phone.
template-tag Unique identifier for a template created by using the ephone-template
command in global configuration mode. Range is 1 to 20.
Cisco IOS Release Cisco Product Modification
12.3(11)T Cisco CME 3.2 This command was introduced.
12.4(4)XC Cisco Unified 4.0 The maximum number of ephone templates that
can be created was increased from 5 to 20.
12.4(9)T Cisco Unified 4.0 This command with an increased range for the
template-tag argument was integrated into
Cisco IOS Release 12.4(9)T.
12.4(15)XZ Cisco Unified CME 4.3 This command was modified to specify that before
an ephone template can be applied to a particular
phone, the Mac address for that phone must be
present in its configuration file.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified Commands: E
ephone-template (ephone)
406
Cisco Unified CME Command Reference
OL-10894-01
If you use an ephone template to apply a command to a phone and you also use the same command in
ephone configuration mode for the same phone, the value set in ephone configuration mode has priority
over the value set in ephone-template configuration mode.
To view your ephone-template configurations, use the show telephony-service ephone-template
command.
Examples The following example defines ephone templates 1 and 2 and applies ephone template 1 to ephones 1
through 3 and ephone template 2 to ephone 4.
ephone-template 1
softkeys idle Dnd Redial Newcall Pickup Login
softkeys seized Redial Cfwdall Gpickup Pickup
softkeys alerting Callback Endcall
softkeys connected Confrn Hold Endcall
softkeys hold Newcall Resume
ephone-template 2
softkeys idle Redial Pickup
softkeys seized Redial Pickup
softkeys alerting Endcall
softkeys connected Hold Endcall
softkeys hold Resume
ephone 1
ephone-template 1
ephone 2
ephone-template 1
ephone 3
ephone-template 1
ephone 4
ephone-template 2
ephone 5
ephone-template 2
The following example creates an ephone template to block the use of Park and Transfer
soft keys on extension 2333.
ephone-template 15
features blocked Park Trnsfer
ephone-dn 2
number 2333
ephone 3
button 1:2
ephone-template 15

Related Commands Command Description
ephone-template Creates an ephone-template and enters ephone-template configuration
mode.
mac-address Associates the MAC address of a Cisco Unified IP phone with an ephone
configuration in Cisco Unified CME.
Cisco Unified Commands: E
ephone-template (ephone)
407
Cisco Unified CME Command Reference
OL-10894-01
restart (ephone) Performs a fast reboot of a single phone in Cisco Unified CME.
restart
(telephony-service)
Performs a fast reboot of one or all phones in Cisco Unified CME.
show
telephony-service
ephone-template
Displays ephone-template configurations.
Command Description
Cisco Unified Commands: E
ephone-type
408
Cisco Unified CME Command Reference
OL-10894-01
ephone-type
To add a Cisco Unified IP phone type by defining an ephone-type template, use the ephone-type
command in global configuration mode. To remove an ephone type, use the no form of this command.
ephone-type phone-type [addon]
no ephone-type phone-type
Syntax Description
Command Default Ephone type is not defined.
Command Modes Global configuration (config)
Command History
Usage Guidelines This command adds a user-defined template for a phone type to a Cisco Unified CME system. This
configuration template defines a set of attributes that describe the features of the new phone type. Use
this command to add phone types that are not already defined in the system.
If you use a phone-type argument that matches a system-defined phone type, a message displays
notifying you that the ephone-type is built-in and cannot be changed. For a list of system-defined phone
types, see the type command.
Use the create cnf-files command for the new phone type to take effect.
Examples The following example shows the Nokia E61 added with an ephone-type template, which is then
assigned to ephone 2:
ephone-type E61
device-id 376
device-name E61 Mobile Phone
num-buttons 1
max-presentation 1
no utf8
no phoneload
!
!
phone-type Unique label that identifies the type of phone. Value is any alphanumeric
string up to 32 characters.
addon (Optional) Phone type is an add-on module, such as the Cisco Unified
IP Phone 7915 Expansion Module.
Cisco IOS Release Cisco Product Modification
12.4(15)XZ Cisco Unified CME 4.3
Cisco Unifieid SRST 4.3
This command was introduced.
12.4(20)T Cisco Unified CME 7.0
Cisco Unifieid SRST 7.0
This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified Commands: E
ephone-type
409
Cisco Unified CME Command Reference
OL-10894-01
telephony-service
load E61 SCCP61.8-2-2SR2S
max-ephones 100
max-dn 240
ip source-address 15.7.0.1 port 2000
cnf-file location flash:
cnf-file perphone
voicemail 8900
max-conferences 8 gain -6
transfer-system full-consult
create cnf-files version-stamp 7960 Sep 25 2007 21:25:47
!
!
ephone 2
mac-address 001C.821C.ED23
type E61
button 1:2
Related Commands Command Description
create cnf-files Builds the eXtensible Markup Language (XML) configuration files that are
required for IP phones.
device-id Specifies the device ID for a phone type in an ephone-type template.
device-name Assigns a name to a phone type in an ephone-type template.
load Associates a type of Cisco Unified IP phone with a phone firmware file.
type Assigns a phone type to an SCCP phone.
Cisco Unified Commands: E
expiry
410
Cisco Unified CME Command Reference
OL-10894-01
expiry
To set the time after which emergency callback history expires, use the expiry command in voice
emergency response settings configuration mode. To remove the number, use the no form of this
command.
expiry time
no expiry
Syntax Description
Command Default The default expiry time is 180 minutes.
Command Modes Voice emergency response settings configuration (cfg-emrgncy-resp-settings)
Command History
Usage Guidelines Use this command to specify the amount of time (in minutes) to keep emergency caller history for each
ELIN. The time can be an integer in the range of 2 to 2880 minutes. The default value is 180 minutes.
Examples In this example, the ELIN (4085550101) defined in the voice emergency response settings configuration
is used if the 911 caller’s IP phone address does not match any of the voice emergency response
locations. After the 911 call is placed to the PSAP, the PSAP has 120 minutes to call back 408 555-0101
to reach the 911 caller. If the call history has expired (after 120 minutes), any callback is routed to
extension 7500.
voice emergency response settings
callback 7500
elin 4085550101
expiry 120
Related Commands
time Identifier (2-2880) in minutes for the maximum time the 911 caller history is
available for callback.
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.
Cisco Unified Commands: E
expiry
411
Cisco Unified CME Command Reference
OL-10894-01
Command Description
callback Default phone number to contact if a 911 callback cannot find the last 911
caller from the ERL.
elin E.164 number used as the default ELIN if no matching ERL to the 911
caller’s IP phone address is found.
logging Syslog informational message printed to the console every time an
emergency call is made.
voice emergency
response settings
Creates a tag for identifying settings for E911 behavior.
Cisco Unified Commands: E
extension-assigner tag-type
412
Cisco Unified CME Command Reference
OL-10894-01
extension-assigner tag-type
To enable provision tags for identifying ephone configurations when using the extension assigner
application, use the extension-assigner tag-type command in telephony-service configuration mode. To
return to the default setting of using the ephone tag, use the no form of this command.
extension-assigner tag-type {ephone-tag | provision-tag}
no extension-assigner tag-type
Syntax Description
Command Default Ephone tags are used to identify ephone configurations for the extension assigner application.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command enables you to use provision tags for identifying ephone configurations to be assigned by
the extension application application.
A provision tag is an unique number other than an ephone tag, such as a jack number or an extension
number, for identifying the ephone configuration to be assigned to a particular IP phone by the extension
assigner application.
Use this command to specify which type of tag, ephone tag or provision tag, is to be used to identify
ephone configurations for the extension assigner application. The default configuration is ephone tag.
If you use this command with the provision-tag keyword, use the provision-tag command to create
provision tags.
Examples The following example shows that this command is configured to enable provision tags to be used for
identifying the ephone configurations to be assigned by the extension assigner application. Note that
provision tag 1001 is configured for ephone 1. During phone installation, the installation technician can
press 1001 on the telephone keypad to assign the ephone 1 configuration, with extension number 1001
on button 1, to the IP phone being installed.
Telephony-service
extension-assigner tag-type provision-tag
auto assign 101-102
ephone-tag Ephone tags must be used to identify ephone configurations.
provision-tag Provision tags must be used to identify ephone configurations.
Cisco IOS Release Cisco Product Modification
12.4(4)XC4 Cisco Unified CME 4.0(3) This command was introduced.
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.
Cisco Unified Commands: E
extension-assigner tag-type
413
Cisco Unified CME Command Reference
OL-10894-01
auto-reg-ephone
Ephone-dn 101
number 1001
Ephone-dn 102
number 1002
Ephone 1
provision-tag 1001
mac-address 02EA.EAEA.0001
button 1:101
Ephone 2
provision-tag 1002
mac-address 02EA.EAEA.0002
button 1:102
Related Commands Command Description
provision-tag Creates a provision tag for identifying an ephone configuration.
Cisco Unified Commands: E
extension-range
414
Cisco Unified CME Command Reference
OL-10894-01
extension-range
To define a range of extension numbers for a specific MOH group in Cisco Unified CME or
Cisco Unified SRST, use the extension-range command in voice-moh-group configuration mode. To
define a range of extension numbers for a specific directory number in Cisco Unified CME, use the
extension-range command in ephone-dn configuration mode. To disable the extension-range command,
use the no form of this command.
extension-range starting-extension to ending-extension
no extension-range starting-extension to ending-extension
Syntax Description
Command Default No extension- range is configured.
Command Modes Voice MOH group configuration (config-voice-moh-group)
Ephone-dn configuration (config-ephone-dn)
Command History
Usage Guidelines This command configured in voice moh-group configuration mode identifies MOH clients calling
extension numbers specified under the extension range configured for a MOH group in
Cisco Unified CME or Cisco Unified SRST. This command in ephone-dn configuration mode identifies
MOH clients calling extension numbers specified under the extension range configured for a directory
number in Cisco Unified CME
You can define multiple extension-ranges in the same MOH group or directory number.
The extension can be expressed in hexadecimal digits ranging from 0-9 or A-F and should not exceed
the limit of 32 digits.
The starting-extension and ending-extension numbers must contain the same number of digits.
The ending extension number must be of a greater value than the starting extension number.
Extension-range for a MOH group must not overlap with any other extension-range configured in any
other MOH group.
starting-extension Hexidecimal digits (0-9 or A-F) that define the starting extension number in
an extension range. Maximum length: 32 digits.
ending-extension Hexidecimal digits (0-9 or A-F) that define the last extension number in an
extension range. Value of the ending extensing must be larger than value of
the starting extension. Maximum length: 32 digits.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0
Cisco Unified SRST 8.0
This command was introduced.
Cisco Unified Commands: E
extension-range
415
Cisco Unified CME Command Reference
OL-10894-01
Note If an extension range is defined in a MOH group and it is also defined under ephone-dn, the
extension range defined under ephone-dn takes precedence.
Examples The following example shows two extension ranges configured under voice moh-group 1:
Router(config)# voice moh-group 1
Router(config-voice-moh-group)# moh flahs:/minuet.wav
Router(config-voice-moh-group)# description Marketing
Router(cconfig-voice-moh-group)# extension range 1000 to 1999
Router(config-voice-moh-group)# extension range 3000 to 3999
Router(config-voice-moh-group)#

Related Commands Command Description
moh Enables music on hold from an audio file.
voice-moh-group Enters voice moh-group configuration mode.
Cisco Unified Commands: E
external-ring (voice register global)
416
Cisco Unified CME Command Reference
OL-10894-01
external-ring (voice register global)
To specify the type of ring sound used on Cisco Session Initiation Protocol (SIP) or Cisco SCCP IP
phones for external calls, use the external-ring command in voice register global configuration mode.
To return to the default ring sound, use the no form of this command.
external-ring {bellcore-dr1 | bellcore-dr2 | bellcore-dr3 | bellcore-dr4 | bellcore-dr5}
no external-ring
Syntax Description
Command Default The default ring sound is an internal ring pattern.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines When set, this command defines varying ring tones so that you can discriminate between internal and
external calls from Cisco SIP or Cisco SCCP IP phones.
Examples The following example shows how to specify that Bellcore DR1 be used for external ringing on
Cisco SIP IP phones:
Router(config)# voice register global
Router(config-register-global)# external-ring bellcore-dr1

bellcore-dr1
bellcore-dr2
bellcore-dr3
bellcore-dr4
bellcore-dr5
Standard distinctive ringing patterns as defined in the standard
GR-506-CORE, LSSGR: Signaling for Analog Interfaces.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
417
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: F
Revised: October 22, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified CME Commands: F
fac
418
Cisco Unified CME Command Reference
OL-10894-01
fac
To enable all standard feature access codes (FACs) or to create and enable individual custom FACs, use
the fac command in telephony-service configuration mode. To disable FACs, use the no form of this
command.
fac {standard | custom {alias alias-tag custom-fac to existing-fac [extra-digits]} | feature
custom-fac}}
no fac {standard | custom {alias alias-tag | feature}}
Syntax Description standard All predefined standard FACs are enabled.
custom User-defined FAC for selecting a particular feature or function from the
predefined set of features is enabled.
alias Alternative FAC for dialing an existing FAC or existing FAC plus extra digits
without removing the existing FAC is enabled.
alias-tag Unique number that identifies this alias during configuration tasks.
Range: 0 to 9.
custom-fac User-defined code to dial using the keypad on an IP or analog phone. Code
can be up to 256 characters and can contain numbers 0 to 9 and * and #.
Note ## is not supported for FACs on SIP phones.
to Maps custom FAC being configured to specified target.
existing-fac Already configured custom FAC that is automatically dialed when the phone
user dials the custom FAC being configured.
extra-digits (Optional) Additional digits that are automatically dialed when the phone
user dials the custom FAC being configured. Valid entries are:
• target extension—Telephone or extension number in
Cisco Unified CME to which the incoming calls are forwarded. Used
with the Call Forward feature.
• group number—Pickup group number, for a group other than the local
group number. Used with the Pickup Group feature.
• pickup extension—Telephone or extension number in
Cisco Unified CME to be picked up when ringing. To be used with the
Pickup Direct feature.
• park-slot number—Number on which calls are to be temporarily
parked. Use with the Call Park feature. Target park slot must be already
configured in Cisco Unified CME.
• pilot number—Telephone or extension number configured as a the pilot
number for an ephone hunt group to be joined. Hunt group to be joined
must allow dynamic membership.
Cisco Unified CME Commands: F
fac
419
Cisco Unified CME Command Reference
OL-10894-01
Command Default FACs are disabled on IP phones.
Command Modes Telephony-service configuration (config-telephony)
feature Predefined alphabetic string that identifies a particular feature or function.
Valid entries are:
• callfwd all—Directs system to forward all incoming calls for this
telephone or extension number.
• callfwd cancel—Directs system to cancel the call-forward-all selection.
• ccw—Disables the Call Waiting feature.
• dnd—Enables Do Not Disturb (DND) feature on SCCP phones. Not
supported for SIP phones.
• dpark-retrieval—Enables Directed Call Park Retrieval feature. Applies
to both SIP and SCCP phones.
• ephone-hunt cancel—Leaves an ephone hunt group that is configured
to allow dynamic membership.
• ephone-hunt hlog—Activates or deactivates hunt group logout
functionality, changing the status of the an ephone-dn for a hunt group
agent from ready to not-ready or from not-ready to ready.
• ephone-hunt hlog-phone—Activates or deactivates phone-level hunt
group logout functionality, changing the status of all the extensions on
a hunt group member phone from ready to not-ready or from not-ready
to ready.
• ephone-hunt join—Joins an ephone hunt group that is configured to
allow dynamic membership. If multiple hunt groups have been created
that allow dynamic membership, the hunt group to be joined is identified
by its pilot number.
• park—Enables Call Park feature.
• pickup direct—Picks up a ringing call at any extension. Applies to both
SIP and SCCP phones.
• pickup group—Picks up a ringing call in a different pickup group than
yours. Applies to both SIP and SCCP phones.
• pickup local—Picks up a ringing call in your pickup group. Applies to
both SIP and SCCP phones.
• redial—Redials the last number called.
• trnsfvm—Activates the Transfer to Voice-Mail feature.
• voicemail—Dials the voice-mail number.
Cisco Unified CME Commands: F
fac
420
Cisco Unified CME Command Reference
OL-10894-01
Command History
Usage Guidelines Use this command to enable all predefined standard FACs or to create one or more custom FACs.
FACs enable phone users to use the keypad on an analog or IP phone registered in Cisco Unified CME
to select or activate/deactivate a particular feature or function from a predefined set of features. For
example, a phone user might press **1, then press 2345 to forward all incoming calls to extension 2345.
Standard FACs and custom FACs are mutually exclusive. You can enable all standard FACs or create and
enable one or more custom FACs.
Most FACs are valid only immediately after a phone user goes off-hook. The only exception is the
call-park FAC. The call-park FAC actually invokes a call transfer to a park slot. To use the call-park FAC,
a phone user must have an active call and must press the Transfer soft key (IP phone) or hookflash
(analog phone) before dialing the call-park FAC. Dialing the FAC for the Call Park feature does not use
the Park soft key function.
Use the fac standard command to enable all predefined standard FACs for all SCCP phones registered
in Cisco Unified CME.
Use the fac custom command to create an individual custom FAC for selecting a particular feature or
function from the predefined feature set.
Use the fac custom command with the alias keyword to create an alternative (custom) FAC for dialing
an existing FAC, or existing FAC plus extra digits without removing the existing FAC. For example, an
alias can be created to allow the phone user to press **1 to forward all incoming calls to a particular
extension without requiring the phone user to dial the target extension number.
To disable all custom FACs, use the fac standard command, which enables all standard FACs. To
disable all standard FACs or to disable an individual custom FAC, use the no form of the fac command.
Use the show telephony-service fac command to display a list of FACs that are configured on the
Cisco Unified CME router.
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 Standard FAC and trnsfvm keyword for a custom
FAC were added for transfer to voice mail.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into Cisco IOS
Release 12.4(20)T.
12.4(22)YB Cisco Unified CME 7.1 The dpark-retrieval keyword was added and
support for SIP phones was added for the park
direct, park group, and park local keywords.
12.4(24)T Cisco Unified CME 7.1 This command was integrated into Cisco IOS
Release 12.4(24)T.
15.0(1)XA Cisco Unified CME 8.0 This command was modified. The ccw keyword
was added for a custom FAC.
Cisco Unified CME Commands: F
fac
421
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to enable standard FACs for all phones:
Router(config)# telephony-service
Router(config-telephony)# fac standard
fac standard is set!

The following example shows the output from the show telephony-service fac command when standard
FACs are enabled:
Router# show telephony-service fac

telephony-service fac standard
callfwd all **1
callfwd cancel **2
pickup local **3
pickup group **4
pickup direct **5
park **6
dnd **7
redial **8
voicemail **9
ephone-hunt join *3
ephone-hunt cancel #3
ephone-hunt hlog *4
ephone-hunt hlog-phone *5
trnsfvm *6
dpark-retrieval **10
cancel call waiting *1

The following example shows how the standard FAC for the Call Forward All feature is changed to a
custom FAC (#45). Then an alias is created to map a second custom FAC to #45 plus an extension (1111).
The second custom FAC (#44) allows the phone user to press #44 to forward all calls all calls to
extension 1111, without requiring the phone user to dial the extra digits that are the extension number.
Router(config)# telephony-service
Router(config-telephony)# fac custom callfwd all #45
fac callfwd all code has been configured to #45
Router(config-telephony)# fac custom alias 0 #44 to #451111
fac alias0 code has been configurated to #44!
alias0 map code has been configurated to #451111!

The following example shows how to create three aliases for the Group Pickup feature. The FAC for
group pickup is **4. The three new custom FACs are #1, #2, and #4 to pickup groups 121, 122, and 124,
respectively. This allows a phone user to press #1 to pick up calls in group 121, #2 to pick up calls in
group 122, and #4 to pick up calls in group 124.
Router(config)# telephony-service
Router(config-telephony)# fac custom pickup group **4
fac pickup group code has been configured to **4
Router(config-telephony)# fac custom alias 1 #1 to **4121
fac alias1 code has been configurated to #1!
alias1 map code has been configurated to **4121!
Router(config-telephony)# fac custom alias 2 #2 to **4122
fac alias2 code has been configurated to #2!
alias2 map code has been configurated to **4122!
Router(config-telephony)# fac custom alias 4 #4 to **4124
fac alias4 code has been configurated to #4!
alias4 map code has been configurated to **4124!

Cisco Unified CME Commands: F
fac
422
Cisco Unified CME Command Reference
OL-10894-01
The following example shows the output from the show telephony-service fac command when custom
FACs are configured:
Router# show telephony-service fac

telephony-service fac custom
callfwd all #45
alias 0 #44 to #451111
alias 1 #1 to **4121
alias 2 #2 to **4122
alias 4 #4 to **4124
Related Commands Command Description
show telephony-service fac Displays list of FACs that are configured on Cisco Unified CME.
Cisco Unified CME Commands: F
fastdial
423
Cisco Unified CME Command Reference
OL-10894-01
fastdial
To create an entry for a personal speed-dial number, use the fastdial command in ephone or
ephone-template configuration mode. To delete a personal speed-dial number, use the no form of this
command.
fastdial dial-tag number name name-string
no fastdial dial-tag
Syntax Description
Command Default No personal speed-dial numbers are present.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines This command is supported only on certain Cisco Unified IP phones, such as the 7940, 7960, 7960G,
7970G, and 7971G-GE. To determine whether personal speed-dial menu is supported on your IP phone,
see the Cisco Unified CME user documentation for your IP phone model.
Phone users access personal speed-dial numbers through the Directories > Local Services > Personal
Speed Dial menu. Personal speed-dial numbers appear on this menu in the order in which they are
entered during configuration.
dial-tag Unique sequence number that is used to identify a particular personal
speed-dial number during configuration tasks. Range is from 1 to 24.
number Telephone number or extension to be dialed.
name name-string Label to appear in the Personal Speed Dial menu, containing a string of up
to 24 alphanumeric characters. Personal speed dial is handled through an
XML request, so characters that have special meaning to HTTP, such as
ampersand (&), percent sign (%), semicolon (;), angle brackets (< >), and
vertical bars (||), are not allowed.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
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.
Cisco Unified CME Commands: F
fastdial
424
Cisco Unified CME Command Reference
OL-10894-01
If you use an ephone template to apply a command to a phone and you also use the same command in
ephone configuration mode for the same phone, the value that you set in ephone configuration mode has
priority.
Examples The following example creates a directory of five personal speed-dial numbers for an IP phone:
Router(config)# ephone 1
Router(config-ephone)# fastdial 1 5001 name Front Register
Router(config-ephone)# fastdial 2 5002 name Security
Router(config-ephone)# fastdial 3 5003 name Rear Register
Router(config-ephone)# fastdial 4 5004 name Office
Router(config-ephone)# fastdial 5 912135550122 Accounting

Related Commands Command Description
ephone-template
(ephone)
Applies a template to the ephone being configured.
show
telephony-service
ephone-template
Displays the contents of ephone templates.
Cisco Unified CME Commands: F
fastdial (voice register pool)
425
Cisco Unified CME Command Reference
OL-10894-01
fastdial (voice register pool)
To create personal speed-dial numbers, use the fastdial command in voice register pool configuration
mode. To delete a personal speed-dial number, use the no form of this command.
fastdial dial-tag number [name name-string]
no fastdial dial-tag
Syntax Description
Command Default No personal speed-dial numbers are defined.
Command Modes Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines This command creates personal speed-dial numbers through Cisco Unified CME. Support for this
command depends on the model of SIP phone:
• Cisco Unified IP Phone 7941G, 7941GE, 7961G, 7961GE, 7970G, and 7971GE—Personal
speed-dial numbers can be created through Cisco Unified CME and not by the user on the phone.
• Cisco Unified IP Phone 7905, 7912, 7940, and 7960—Personal speed-dial numbers can only be
created by the user directly on the phone and not through Cisco Unified CME.
Phone users access personal speed-dial numbers through the Directories > Personal Speed Dial menu.
Personal speed-dial numbers display on this menu in alphabetical order.
dial-tag Unique number that identifies a particular personal speed-dial number
during configuration tasks. Range: 1 to 24.
number Telephone number or extension to be dialed.
name name-string (Optional) Label to appear in the Personal Speed Dial menu, containing a
string of up to 24 alphanumeric characters. Personal speed dial is handled
through an XML request, so characters that have special meaning to HTTP,
such as ampersand (&), percent sign (%), semicolon (;), angle brackets (< >),
and vertical bars (||), are not allowed.
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.
Cisco Unified CME Commands: F
fastdial (voice register pool)
426
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows a directory of five personal speed-dial numbers defined for a SIP phone:
Router(config)# voice register pool 1
Router(config-register-pool)# fastdial 1 5001 name Front Register
Router(config-register-pool)# fastdial 2 5002 name Security
Router(config-register-pool)# fastdial 3 5003 name Rear Register
Router(config-register-pool)# fastdial 4 5004 name Office
Router(config-register-pool)# fastdial 5 912135550122 Accounting

Related Commands Command Description
show voice register pool Displays all configuration information associated with a particular voice
register pool.
Cisco Unified CME Commands: F
feature-button
427
Cisco Unified CME Command Reference
OL-10894-01
feature-button
To configure a feature button, use the feature-button command in ephone, ephone-template, voice
logout-profile, or voivce user-profile configuration mode. To disable a feature button, use the no form
of this command.
feature-button tag {dnd | privacy}
no feature-button
Syntax Description
Command Default No feature-button is configured.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Voice user-profile configuration (config-user-profile)
Voice logout-profile configuration (config-logout-profile)
Command History
Usage Guidelines Use this command to configure a DnD feature button as a short cut for the DnD softkey.
This command with the privacy keyword takes precedence over the privacy-button command. If a
feature-button is configured for DnD, the privacy-button command will be ignored and the privacy
button must be configured through the feature-button command to take effect.
Examples The following example shows how to configure feature button.
Router(config)# ephone 1
Router(config-ephone) feature-button 1 privacy
Router(config-ephone) feature-button 2 dnd

Related Commands
tag Identifier for feature button. The valid values are 1 and 2.
privacy Feature button for Privacy is active.
dnd Feature button for Do Not Disturb is active.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
privacy-button Enables the privacy feature button on an IP phone.
Cisco Unified CME Commands: F
feature-button
428
Cisco Unified CME Command Reference
OL-10894-01
show telephony-service
ephone
Display the information about ephone configuration in a Cisco
CallManager Express (Cisco CME) system.
show telephony-service
ephone-dn-template
Displays the information about ephone-template’s configurations.
Command Description
Cisco Unified CME Commands: F
features blocked
429
Cisco Unified CME Command Reference
OL-10894-01
features blocked
To prevent one or more features from being used on a Cisco Unified CME phone, use the features
blocked command in ephone-template configuration mode. To allow all features to be used, use the no
form of this command.
features blocked [CFwdAll] [Confrn] [GpickUp] [Park] [PickUp] [Trnsfer]
no features blocked
Syntax Description
Command Default Features are not blocked.
Command Modes Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines Use this command to specify one or more features to be blocked in an ephone template, then apply the
template in ephone configuration mode to one or more ephones to prevent the use of the specified
features by those ephones. This feature can be used on IP phones and analog phones. After applying the
template, any soft keys associated with the blocked features will still be visible but will not have any
effect.
Use the show telephony-service ephone-template command to display the contents of ephone
templates.
CFwdAll Call forward all calls.
Confrn Conference.
GpickUp Group call pickup.
Park Call park.
PickUp Directed or local call pickup. This includes pickup last-parked call and
pickup from another extension or park slot.
Trnsfer Call transfer.
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.
Cisco Unified CME Commands: F
features blocked
430
Cisco Unified CME Command Reference
OL-10894-01
Examples In the following example, call park and call transfer are blocked on ephone 3.
ephone-template 1
features blocked Park Trnsfer
ephone-dn 2
number 2333
ephone 3
button 1:2
ephone-template 1
The following example blocks the use of the conference feature on ephone 3, which is an analog phone,
by using a template.
ephone-template 1
features blocked Confrn
ephone-dn 78
number 2579
ephone 3
ephone-template 1
mac-address C910.8E47.1282
type anl
button 1:78

Related Commands Command Description
ephone-template
(ephone)
Applies a template to the ephone being configured.
show
telephony-service
ephone-template
Displays the contents of ephone templates.
Cisco Unified CME Commands: F
feed
431
Cisco Unified CME Command Reference
OL-10894-01
feed
To enable an audio stream for multicast from a external live audio feed connected directly to the router
by a foreign exchange office (FXO) or an E&M analog voice port, use the feed command in ephone-dn
configuration mode. To disable the multicast audio stream, use the no form of this command.
feed ip ip-address port port-number [route ip-address] [out-call outcall-number]
no feed ip
Syntax Description
Command Default No multicast audio stream is enabled on an extension.
Command Modes Ephone-dn configuration
Command History
Usage Guidelines When this command is used, a connection for a live feed audio stream is established as an automatically
connected voice call. If the out-call keyword is used, the Cisco CME system calls out to the specified
number for the audio stream. If the out-call keyword is not used, it is assumed that the call is incoming
to the ephone-dn. This includes VoIP calls if voice activity detection (VAD) is disabled. The typical
operation is for the Cisco CME ephone-dn to establish a call to a local router E&M voice port.
Connection via E&M is the recommended mechanism because it requires minimal external components.
The E&M port must be placed in 4-wire operation, using E&M immediate signaling and with the
auto-cut-through option enabled. You directly connect a line-level audio feed (standard audio jack) to
pins 3 and 6 of an E&M RJ-45 connector. The E&M WAN interface card (WIC) has a built-in audio
transformer that provides appropriate electrical isolation for the external audio source. (The audio
ip ip-address Indicates that a particular audio stream is to be used as a multicast source and
specifies the destination IP address for multicast.
port port-number Specifies the media port for multicast. Range is from 2000 to 65535. Port
2000 is recommended because this port is already used for normal
Real-Time Transport Protocol (RTP) media transmissions between IP
phones and the Cisco CallManager Express (Cisco CME) router.
route ip-address (Optional) Indicates the specific router interface on which to transmit the IP
multicast packets. The default is that the audio stream is automatically
output on the interface that corresponds to the address that was configured
with the ip source-address command.
out-call outcall-number (Optional) Sets up a call to the outcall number in order to connect to a live
audio feed. If this keyword is not used, the live feed is assumed to derive
from an incoming call to the ephone-dn that is being configured.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
Cisco Unified CME Commands: F
feed
432
Cisco Unified CME Command Reference
OL-10894-01
connection on the E&M port does not require loop current.) The signal immediate and
auto-cut-through commands disable E&M signaling on this voice port. A G.711 audio packet stream is
generated by the digital signal processor (DSP) on the E&M port.
If you are using an FXO voice port for live-feed audio stream instead of an E&M port, connect the source
to the FXO voice port. This connection requires an external adapter to supply normal telephone company
(telco) battery voltage with the correct polarity to the tip-and-ring leads of the FXO port. The adapter
must also provide transformer-based isolation between the external audio source and the tip-and-ring
leads of the FXO port.
If the out-call keyword is used, an outbound call to the live-feed source is attempted (or reattempted)
every 30 seconds until the call is connected to the ephone-dn (extension) for which the feed command
was configured. Note that this ephone-dn is not associated with a physical phone.
The related moh (ephone-dn) and multicast moh commands provide the ability to multicast an audio
stream that is also being used as the source for Cisco CME system music on hold (MOH).
Note IP phones do not support multicast at 224.x.x.x addresses.
Examples The following example sets up a call to extension 7777 for a live audio stream and sends it via multicast:
Router(config)# ephone-dn 55
Router(config-ephone-dn)# feed ip 239.1.1.1 port 2000 route 10.10.23.3 out-call 7777

Related Commands Command Description
auto-cut-through Enables call completion when an M-lead response is not provided.
ip source-address Identifies the IP address and port through which IP phones communicate
with a Cisco CME router.
moh (ephone-dn) Enables music on hold from a live feed and multicast of the MOH audio
stream.
moh
(telephony-service)
Enables music on hold from an audio file.
multicast moh Enables multicast of a music-on-hold audio stream.
signal Specifies the type of signaling for a voice port.
Cisco Unified CME Commands: F
file text (voice register global)
433
Cisco Unified CME Command Reference
OL-10894-01
file text (voice register global)
To generate ASCII text files of the configuration profiles for SIP phones, use the file text command in
voice register global configuration mode. To return to the default, use the no form of this command.
file text
no file text
Syntax Description This command has no arguments or keywords.
Command Default System directly generates only binary files for configuration profiles.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines Use this command to generate an ASCII text fils of the configuration profile for Cisco Unified IP Phone
7905s and 7905Gs, Cisco Unified IP Phone 7912s and 7912Gs, Cisco ATA-186s, or Cisco ATA-188s.
Examples The following example shows how to generate an ASCII text file version of the configuration profiles
for Cisco Unified IP Phone 7905s and 7905Gs, Cisco Unified IP Phone 7912s and 7912Gs,
Cisco ATA-186s, or Cisco ATA-188s:
Router(config)# voice register global
Router(config-register-global)# mode cme
Router(config-register-global)# file text
Router(config-register-global)# create profile

Related Commands
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
create profile (voice
register global)
Generates the configuration profiles required for SIP phone.
show voice register profile Displays the contents of configuration files that are in ASCII text
format.
Cisco Unified CME Commands: F
filename
434
Cisco Unified CME Command Reference
OL-10894-01
filename
To specify a custom XML file that contains the dial patterns to use for a SIP dial plan, use the filename
command in voice register dialplan configuration mode. To remove the file, use the no form of this
command.
filename filename
no filename
Syntax Description
Command Default A custom file is not used for the dial plan.
Command Modes Voice register dialplan configuration (config-register-dialplan)
Command History
Usage Guidelines This command selects a custom XML file containing dial patterns for the SIP dial plan. The file specified
with this command must be loaded into flash memory. You must use the type command to specify the
type of phone for which the dial plan is being defined before you can use this command. After you define
a dial plan, assign it to a SIP phone by using the dialplan command.
The pattern command and filename command are mutually exclusive. You can use either the pattern
command to define dial patterns manually, or the filename command to select a custom dial pattern file
that is loaded in system flash.
If the custom XML file contains any errors, the dial plan might not work properly on the phone.
To remove a dial plan that is created using a custom XML file, use the reset command after removing
the dial plan from the phone and creating a new configuration profile. Removing a dial plan that uses a
dial pattern XML file does not take effect if you restart the phone with the restart command.
Note This command is not supported for Cisco Unified IP Phone 7905 or 7912.
Examples The following example shows that a custom file named sample.xml is specified for dial plan 2.
Router(config)# voice register dialplan 2
Router(config-register-dialplan)# type 7940-7960-others
Router(config-register-dialplan)# filename sample.xml
filename Name of the XML file in flash memory.
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.
Cisco Unified CME Commands: F
filename
435
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
dialplan Assigns a dial plan to a SIP phone.
pattern Defines a dial pattern for a SIP dial plan.
show voice register
dialplan
Displays all configuration information for a specific SIP dial plan.
type (voice register
dialplan)
Defines a phone type for a SIP dial plan.
Cisco Unified CME Commands: F
final
436
Cisco Unified CME Command Reference
OL-10894-01
final
To define the last extension (ephone-dn) in an ephone hunt group, use the final command in ephone-hunt
configuration mode. To remove this number from the hunt group, use the no form of this command.
final number
no final
Syntax Description
Command Default No final number is defined.
Command Modes Ephone-hunt configuration (config-ephone-hunt)
Command History
Usage Guidelines This command defines the last extension in a hunt group and the destination of incoming calls to a
hunt-group pilot number that are unanswered after being routed through the directory numbers in the
hunt group list.
To avoid an infinite loop, use the max-redirect command.
Examples The following example defines ephone-dn 6000 as the last number of hunt group number 1:
Router(config)# ephone-hunt 1 sequential
Router(config-ephone-hunt)# final 6000

Related Commands
number Extension or phone number. Can be an ephone-dn primary or secondary
number, voice-mail number, pilot number of another hunt group, or FXS
caller-ID number.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
Command Description
fwd-final Specifies the final destination of an unanswered call that has been transferred
into a hunt group.
hops Defines the number of times that a call is redirected to the next ephone-dn in
a peer ephone-hunt-group list before proceeding to the final ephone-dn.
list Defines the ephone-dns that participate in an ephone hunt group.
max-redirect Changes the number of allowable redirects in a Cisco Unified CME system.
Cisco Unified CME Commands: F
final
437
Cisco Unified CME Command Reference
OL-10894-01
no-reg (ephone-hunt) Specifies that the pilot number of an ephone hunt group should not register
with the H.323 gatekeeper.
pilot Defines the ephone-dn that is dialed to reach an ephone hunt group.
preference
(ephone-hunt)
Sets preference order for the ephone-dn associated with an
ephone-hunt-group pilot number.
timeout (ephone-hunt) Sets the number of seconds after which a call that is not answered is
redirected to the next number in the ephone-hunt-group list.
Command Description
Cisco Unified CME Commands: F
final (voice hunt-group)
438
Cisco Unified CME Command Reference
OL-10894-01
final (voice hunt-group)
To define the last extension in a voice hunt group, use the final command in voice hunt-group
configuration mode. To remove this number from the hunt group, use the no form of this command.
final number
no final
Syntax Description
Command Default No final number is defined in the voice hunt group.
Command Modes Voice hunt-group configuration (config-voice-hunt-group)
Command History
Usage Guidelines This command defines the last extension in a hunt group and the destination of incoming calls to a
hunt-group pilot number that are unanswered after being routed through the directory numbers in the
hunt group list.
To avoid an infinite loop, if a final number in one hunt group is configured as a pilot number of another
hunt group, the pilot number of the first hunt group cannot be configured as a final number in any hunt
group.
Examples The following example shows how to define extension 6000 as the last number of hunt group 1:
Router(config)# voice hunt-group 1 sequential
Router(config-voice-hunt-group)# final 6000
Related Commands
number Telephone or extension number. Can be an E.164 number, voice-mail
number, pilot number of another hunt group, or FXS caller-ID number.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
hops (voice
hunt-group)
Defines the number of times that a call is redirected to the next number in a
peer hunt-group list before proceeding to the final number.
list (voice hunt-group) Defines the numbers that participate in a voice hunt group.
max-redirect (voice
register global)
Changes the current number of allowable redirects in a Cisco CME system.
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.
Cisco Unified CME Commands: F
forward local-calls
439
Cisco Unified CME Command Reference
OL-10894-01
forward local-calls
To allow internal (local) calls to be forwarded, use the forward local-calls command in ephone-dn or
ephone-hunt configuration mode. To prevent internal calls from being forwarded, use the no form of this
command.
forward local-calls
no forward local-calls
Syntax Description This command has no arguments or keywords.
Command Default Internal calls are forwarded as specified in the ephone-dn or ephone-hunt configuration of the called
party.
Command Modes Ephone-dn configuration (config-ephone-dn)
Ephone-hunt configuration (config-ephone-hunt)
Command History
Usage Guidelines Internal, or local, calls are defined as those calls that originate from other ephone-dns in the same
Cisco Unified CME system.
When the no forward local-calls command is used in ephone-dn configuration mode, internal calls to
that ephone-dn are not forwarded if the ephone-dn is busy or does not answer. If the ephone-dn is busy,
the caller hears a busy signal. If the ephone-dn does not answer, the caller hears a ringback signal. The
call is not forwarded even if call forwarding is enabled for the ephone-dn.
When the no forward local-calls command is used in ephone-hunt configuration mode, internal calls to
a hunt-group pilot number are sent only to the first member of the group. If the first group member is
busy, the caller hears a busy signal. If the first group member does not answer, the caller hears a ringback
signal. The call is not forwarded to subsequent hunt group members.
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.
Cisco Unified CME Commands: F
forward local-calls
440
Cisco Unified CME Command Reference
OL-10894-01
Examples In the following example, extension 2222 dials the pilot number 3000 and is forwarded to extension
3011. If 3011 is busy, the caller hears a busy tone. If 3011 does not answer, the caller hears ringback.
The call is not forwarded, even after the timeout expires.
ephone-hunt 17 sequential
pilot 3000
list 3011, 3021, 3031
timeout 10
final 7600
no forward local-calls

In the following example, extension 2222 calls extension 3675 and hears ringback or a busy signal. If an
external caller reaches extension 3675 and there is no answer, the call is forwarded to extension 4000.
ephone-dn 25
number 3675
no forward local-calls
call-forward noan 4000 timeout 30

Cisco Unified CME Commands: F
forwarding local (voice register global)
441
Cisco Unified CME Command Reference
OL-10894-01
forwarding local (voice register global)
To use the forwarding-party number and name (the local number and name) in calls forwarded using
local hairpin call routing on a SIP phone, use the forwarding local command in voice register global
configuration mode. To return to the default, use the no form of this command.
forwarding local
no forwarding local
Syntax Description This command has no arguments or keywords.
Command Default Calling-party name and number used.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command replaces a calling-party number and name with the local forwarding-party number and
name in hairpinned forwarded calls.
Examples The following example shows how to enable local forwarding:
Router(config)# voice register global
Router(config-register-global)# forwarding local

Related Commands
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
call-forward b2bua all
(voice register dn and
voice register pool)
Enables call forwarding for a SIP B2BUA so that all incoming calls are
forwarded to another extension.
Cisco Unified CME Commands: F
from-ring
442
Cisco Unified CME Command Reference
OL-10894-01
from-ring
To specify that on-hook time stamps for ephone hunt group agents should be updated when calls ring as
well as when calls are answered in a longest-idle ephone hunt group, use the from-ring command in
ephone-hunt configuration mode. To return to the default, use the no form of this command.
from-ring
no from-ring
Syntax Description This command has no keywords or arguments.
Command Default On-hook time stamps are updated only when calls are answered by agents.
Command Modes Ephone-hunt configuration
Command History
Usage Guidelines This command is used only with longest-idle ephone hunt groups. In a longest-idle hunt group, the
algorithm for choosing the the next agent to receive a call is based on a comparison of on-hook time
stamps. The agent with the smallest on-hook time stamp value is chosen when the next call comes to the
hunt group.
This command can be used to specify that on-hook time stamps should be updated when calls ring agents
as well as when calls are answered by agents.
The show ephone-hunt command displays on-hook time stamps.
Examples The following example defines longest-idle ephone hunt group 1 with a pilot number 7501, a final
number 8000, and five numbers in the list. Because the from-ring command is used, on-hook time
stamps will be recorded when calls ring agents as well as when calls are answered. After a call is
redirected three times (makes six hops), it is redirected to the final number, 8000.
ephone-hunt 1 longest-idle
pilot 7501
list 7001, 7002, 7023, 7028, 7045
final 8000
from-ring
hops 3
timeout 20
telephony-service
max-redirect 8
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.
Cisco Unified CME Commands: F
from-ring
443
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
show ephone-hunt Displays configuration information, current status, and statistics for ephone
hunt groups.
Cisco Unified CME Commands: F
fwd-final
444
Cisco Unified CME Command Reference
OL-10894-01
fwd-final
To specify the final destination of a call that has been transferred into a hunt group and is unanswered,
use the fwd-final command in ephone-hunt configuration mode. To return to the default, use the no form
of this command.
fwd-final {orig-phone | final}
no fwd-final {orig-phone | final}
Syntax Description
Command Default Calls are sent to the final number that is specified in the hunt group configuration.
Command Modes Ephone-hunt configuration (config-ephone)
Command History
Usage Guidelines This command is used for routing only unanswered transferred calls. Transferred calls are incoming calls
to an ephone hunt group that were previously answered by a Cisco Unified CME extension and
transferred into the hunt group.
The orig-phone keyword specifies that an unanswered transferred call is routed back to the extension
that originally answered the call and transferred it to the hunt group.
The final keyword specifies that an unanswered transferred call is routed to the last extension in the hunt
group as defined by using the final command.
Examples The following example sets up a peer hunt group with three ephone-dns to answer calls. An unanswered
transferred call will be routed to the ephone-dn that transferred it to the ephone hunt group pilot number.
A DID call that dials the pilot number directly will be routed to extension 7600 if it is unanswered by
the hunt group.
ephone-hunt 17 peer
pilot 3000
list 3011, 3021, 3031
hops 3
final 7600
fwd-final orig-phone
orig-phone Phone that originally answered a call before transferring it to the pilot
number of a hunt group.
final Last extension in the hunt group as specified in the hunt group configuration.
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.
Cisco Unified CME Commands: F
fwd-final
445
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
final Defines the last extension (ephone-dn) in an ephone hunt group.
Cisco Unified CME Commands: F
fxo hook-flash
446
Cisco Unified CME Command Reference
OL-10894-01
fxo hook-flash
To enable display of a flash soft key on a Cisco IP Phones 7940 and 7940G or Cisco IP Phones 7960 and
7960G in a Cisco CallManager Express (Cisco CME) system, use the fxo hook-flash command in
telephony-service configuration mode. To disable display of the flash soft key, use the no form of this
command.
fxo hook-flash
no fxo hook-flash
Syntax Description This command has no arguments or keywords.
Command Default The flash soft key is disabled.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Certain public switched telephony network (PSTN) services, such as three-way calling and call waiting,
require hookflash intervention from the phone user. A soft key labeled flash provides this functionality
for the Cisco IP Phones 7940 and 7940G and the Cisco IP Phones 7960 and 7960G users on foreign
exchange office (FXO) lines attached to the Cisco CME system. The flash soft key is enabled using the
fxo hook-flash command.
Once a flash soft key has been enabled on an IP phone, it is available to provide hookflash functionality
during all calls except local IP-phone-to-IP-phone calls. Note that hookflash-controlled services can be
activated only if they are supported by the PSTN connection that is involved in the call. The availability
of the flash soft key does not guarantee that hookflash-based services are actually accessible to the phone
user.
The flash soft key display is automatically disabled for local IP-phone-to-IP-phone calls.
This command must be followed by a quick reboot of the phones using the restart all command.
Examples The following example enables the flash soft key on the Cisco IP Phones 7940 and 7940G and the
Cisco IP Phones 7960 and 7960G:
Router(config)# telephony-service
Router(config-telephony)# fxo hook-flash

Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
Cisco Unified CME Commands: F
fxo hook-flash
447
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Description
restart (ephone) Performs a fast reboot of a single phone associated with a Cisco CME router.
restart
(telephony-service)
Performs a fast reboot of one or all phones associated with a Cisco CME
router.
Cisco Unified CME Commands: F
fxo hook-flash
448
Cisco Unified CME Command Reference
OL-10894-01
449
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: H
Revised: February 27, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified CME Commands: H
headset auto-answer line
450
Cisco Unified CME Command Reference
OL-10894-01
headset auto-answer line
To enable auto-answer on the specified line when the headset key is engaged, use the headset
auto-answer command in ephone configuration mode. To disable headset auto-answer for this line, use
the no form of this command.
headset auto-answer line line-number
no headset auto-answer line line-number
Syntax Description
Command Default Headset auto-answer is not enabled.
Command Modes Ephone configuration (config-ephone)
Command History
Usage Guidelines This command enables headset auto-answer on a particular line. A line, as used in this command, is not
identical to a phone button. A line, as used in this command, represents the ability for a call connection
on this phone, and the line numbers generally follow a top-to-bottom sequence starting with the number
1.
The following examples represent common situations pertaining to a button:line relationship:
• button 1:1—A single ephone-dn is associated with a single ephone button. Counts as one line.
• button 1o1,2,3,4,5—Five ephone-dns are overlaid on a single ephone button. Counts as one line.
• button 2x1—An ephone button acts as an extension for an overlaid ephone button. Counts as one
line.
• Button is unoccupied or programmed for speed-dial. Does not count as a line.
Examples The following example shows how to enable headset auto-answer for line 1 (button 1) and line 4
(button 4), which has overlaid ephone-dns but counts as a single line in this context. In this example,
four (1, 2, 3, and 4) buttons are defined for ephone 3.
ephone 3
button 1:2 2:4 3:6 4o21,22,23,24,25
headset auto-answer line 1
headset auto-answer line 4

line-number Phone line that should be automatically answered.
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.
Cisco Unified CME Commands: H
headset auto-answer line
451
Cisco Unified CME Command Reference
OL-10894-01
The following example shows how to enable headset auto-answer for line 2 (button 2), which has
overlaid ephone-dns, and line 3 (button 3), which is an overlay rollover line. In this example, three (1,
2, and 3) buttons are defined for ephone 17.
ephone 17
button 1:2 2o21,22,23,24,25 3x2
headset auto-answer line 2
headset auto-answer line 3

The following example shows how to enable headset auto-answer for line 2 (button 3) and line 3
(button 5). In this case, the button numbers do not match the line numbers because buttons 2 and 4 are
not used.
ephone 25
button 1:2 3:4 5:6
headset auto-answer line 2
headset auto-answer line 3

Cisco Unified CME Commands: H
hold-alert
452
Cisco Unified CME Command Reference
OL-10894-01
hold-alert
To set a repeating audible alert notification when a call is on hold on a Cisco Unified IP phone, use the
hold-alert command in ephone-dn or ephone-dn-template configuration mode. To disable this feature,
use the no form of this command.
hold-alert timeout {idle | originator | shared}
no hold-alert timeout {idle | originator | shared}
Syntax Description
Command Default Audible alert notification for on-hold calls is disabled. Only a visual indication is provided.
Command Modes Ephone-dn configuration (config-ephone)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
Usage Guidelines Use the hold-alert command to set an audible alert notification on a Cisco Unified IP phone to remind
the phone user that a call is on hold. The timeout argument specifies the time interval in seconds from
the time the call is placed on hold to the time the on-hold audible alert is generated. The alert is repeated
every timeout seconds.
When the idle keyword is enabled, a one-second burst of ringing on the phone is generated on the IP
phone that placed the call in the hold state, but only if the phone is in the idle state. If the phone is in
active use, no on-hold alert is generated.
When the originator keyword is enabled, a one-second burst of ringing is generated on the phone that
placed the call in the hold state, but only if the phone is in the idle state. If the phone is in use on another
call, an audible beep (call-waiting tone) is generated.
timeout Interval after which an audible alert notification is repeated, in seconds.
Range is from 15 to 300. There is no default.
idle Alerts only when the phone is idle.
originator Alerts whether the phone is idle or busy.
shared Alerts only when the extension is idle but alerts all phones that share the line.
Cisco IOS Release Cisco Product Modification
12.2(2)XT Cisco ITS 2.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.4(4)XC Cisco Unified CME 4.0 This command was made available in
ephone-dn-template configuration mode.
12.4(9)T Cisco Unified CME 4.0 This command in ephone-dn-template
configuration mode was integrated into Cisco IOS
Release 12.4(9)T.
Cisco Unified CME Commands: H
hold-alert
453
Cisco Unified CME Command Reference
OL-10894-01
When the shared keyword is enabled, a one-second ring burst is generated for all the idle phones that
share the extension with the on-hold call. Phones that are in use do not receive an audio beep
(call-waiting tone) alert. Only the phone that placed the call on hold hears a call-waiting beep if it is busy.
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
Examples The following example sets audible alert notification to idle on extension 1111:
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 1111
Router(config-ephone-dn)# name phone1
Router(config-ephone-dn)# hold-alert 100 idle

The following example uses an ephone-dn template to set audible alert notification for extension 1111
to only occur when the phone is idle:
Router(config)# ephone-dn-template 3
Router(config-ephone-dn-template)# hold-alert 100 idle
Router(config-ephone-dn-template)# exit
Router(config)# ephone-dn 1
Router(config-ephone-dn)# number 1111
Router(config-ephone-dn)# name phone1
Router(config-ephone-dn)# ephone-dn-template 3

Related Commands Command Description
ephone-dn-template
(ephone-dn)
Applies ephone-dn-template to the ephone-dn being configured.
Cisco Unified CME Commands: H
hold-alert (voice register global)
454
Cisco Unified CME Command Reference
OL-10894-01
hold-alert (voice register global)
To set a repeating audible alert notification when a call is on hold on all supported SIP phones directly
connected in Cisco Unified CME, use the command in voice register global configuration mode. To
disable this feature, use the no form of this command.
hold-alert timeout
no hold-alert
Syntax Description
Command Default Audible alert notification for on-hold calls is disabled. Only a visual indication is provided.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command sets an audible alert notification on all supported SIP phones in a Cisco Unified CME
system to remind the phone user that a call is on hold. The alert is repeated after a specific interval as
defined by the timeout argument.
Note This command does not apply to Cisco ATAs that have been configured for SIP in Cisco Unified CME.
Examples The following example shows how to set audible alert notification on SIP phones for on-hold calls:
Router(config)# voice register global
Router(config-register-global)# mode cme
Router(config-register-global)# hold-alert 30

Related Commands
timeout Interval after which an audible alert notification is repeated, in seconds.
Range is from 15 to 300. There is no default.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Description
call-waiting (voice
register pool)
Enables call waiting on a SIP phone.
mode (voice register
global)
Enables the mode for provisioning SIP phones in a Cisco CallManager
Express (Cisco CME) system.
Cisco Unified CME Commands: H
hops
455
Cisco Unified CME Command Reference
OL-10894-01
hops
To define the number of times that a call can proceed to the next ephone-dn in a peer or longest-idle
ephone hunt group before the call proceeds to the final ephone-dn, use the hops command in ephone
hunt configuration mode. To return to the default number of hops, use the no form of this command.
hops number
no hops number
Syntax Description
Command Default The number of hops automatically adjusts to the number of ephone hunt group members.
Command Modes Ephone-hunt configuration (config-ephone-hunt)
Command Modes
Usage Guidelines This command is valid only for peer and longest-idle ephone hunt groups in Cisco Unified CallManager
Express systems.
This command is required when you are configuring the auto logout command for peer and longest-idle
hunt groups.
number Number of hops before the call proceeds to the final ephone-dn. Range is
from 2 to 20, but the value must be less than or equal to the number of
extensions that are specified in the list command. Default automatically
adjusts to the number of hunt group members.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.3(7)T Cisco CME 3.1 The maximum number of hops was restricted to
the number of extensions specified in the list
command.
12.3(11)XL Cisco CME 3.2.1 Increased maximum number of hops to 20.
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 The default was changed from 2 hops to
automatically adjust the number of hops to the
number of ephone hunt group members.
12.4(9)T Cisco Unified CME 4.0 The modification to change the default was
integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: H
hops
456
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example sets the number of hops to 6 for peer hunt group 3:
Router(config)# ephone-hunt 3 peer
Router(config-ephone-hunt)# hops 6
Related Commands Command Description
auto logout Enables the automatic change of an ephone hunt group agent's ephone-dn to
not-ready status.
final Defines the last ephone-dn in an ephone hunt group.
list Defines the ephone-dns that participate in an ephone hunt group.
max-redirect Changes the current number of allowable redirects in a Cisco Unified CME
system.
no-reg (ephone-hunt) Specifies that the pilot number of this ephone hunt group should not register
with the H.323 gatekeeper.
pilot Defines the ephone-dn that is dialed to reach an ephone hunt group.
preference
(ephone-hunt)
Sets preference order for the ephone-dn associated with an
ephone-hunt-group pilot number.
timeout (ephone-hunt) Sets the number of seconds after which a call that is not answered is
redirected to the next number in the hunt-group list.
Cisco Unified CME Commands: H
hops (voice hunt-group)
457
Cisco Unified CME Command Reference
OL-10894-01
hops (voice hunt-group)
To define the number of times that a call can hop to the next number in a peer hunt group before the call
proceeds to the final number, use the hops command in voice hunt-group configuration mode. To return
to the default number of hops, use the no form of this command.
hops number
no hops
Syntax Description
Command Default The default is the number of directory-number arguments configured in the list command.
Command Modes Voice hunt-group configuration (config-voice-hunt-group)
Command History
Usage Guidelines This command is valid only for peer or longest-idle voice hunt groups in Cisco Unified CME systems.
Examples The following example shows how to set the number of hops to 6 for peer voice hunt group 1:
Router(config)# voice hunt-group 1 peer
Router(config-voice-hunt-group)# list 1000, 1001, 1002, 1003, 1004, 1005, 1006, 006, 1007,
1008, 1009
Router(config-voice-hunt-group)# hops 6

Related Commands
number Number of hops before the call proceeds to the final number. Range is
2 to 10, but the value must be less than or equal to the number of extensions
that are specified in the list command. The default is the same number as
there are destinations defined under the list command.
Cisco IOS Release Cisco product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
final (voice hunt-group) Defines the last extension in a voice hunt group.
list (voice hunt-group) Defines the directory numbers that participate in a 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.
Cisco Unified CME Commands: H
hunt-group logout
458
Cisco Unified CME Command Reference
OL-10894-01
hunt-group logout
To enable separate handling of DND and HLog functionality for hunt-group agents and to display the
HLog soft key on phones, use the hunt-group logout command in telephony-service configuration
mode. To return to the default, use the no form of this command.
hunt-group logout [DND | HLog]
no hunt-group logout [DND | HLog]
Syntax Description
Command Default DND and HLog functionality is not separate and the HLog soft key will not be displayed on phones.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines When Do Not Disturb (DND) functionality is activated, no calls are received at the phone, including
ephone hunt group calls. DND is activated and canceled using the DND soft key or the DND feature
access code (FAC).
When HLog functionality is activated, hunt-group agents are placed in not-ready status and hunt-group
calls are blocked from the phone. Other calls that directly dial the phone’s extension numbers are still
received at the phone. HLog is activated and canceled using the HLog soft key or an HLog FAC.
If the auto logout command is used, the Automatic Agent Status Not-Ready feature is invoked for an
ephone hunt group. This feature is triggered when an ephone-dn member does not answer a specified
number of ephone hunt group calls. The following actions take place:
• If the hunt-group logout HLog command has been used, the agent is placed in not-ready status.
The agent’s ephone-dn will not receive further hunt group calls but will receive calls that directly
dial the ephone-dn’s extension numbers. An agent in not-ready status can return to ready status by
pressing the HLog soft key or by using the HLog FAC.
DND Agent phones do not answer the number of calls specified in the auto logout
command and are automatically placed in both DND status and not-ready
status. The HLog soft key is not displayed on phones.
HLog Agent phones do not answer the number of calls specified in the auto logout
command and are automatically placed only in not-ready status. The HLog
soft key is displayed on phones in addition to the DND soft key.
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.
Cisco Unified CME Commands: H
hunt-group logout
459
Cisco Unified CME Command Reference
OL-10894-01
• If the hunt-group logout HLog command has not been used or if the hunt-group logout DND
command has been used, the phone on which the ephone-dn appears is placed into DND mode, in
which the ephone-dn does not receive any calls at all, including hunt-group calls. The red lamp on
the phone lights to indicate DND status. An agent in DND mode can return to ready status by
pressing the DND soft key or by using the DND FAC.
Note When an agent who is a dynamic member of a hunt group is in not-ready status, the agent’s slot in the
ephone hunt group is not relinquished. It remains reserved by the agent until the agent leaves the group.
Examples The following example creates hunt group 3 with three agents (extensions 1001, 1002, and 1003). It
specifies that after one unanswered call, an agent should be put into not-ready status but not into DND
status.
Router(config)# telephony-service
Router(config-telephony)# hunt-group logout HLog
Router(config-telephony)# exit

Router(config)# ephone-hunt 3 peer
Router(config-ephone-hunt)# pilot 4200
Router(config-ephone-hunt)# list 1001, 1002, 1003
Router(config-ephone-hunt)# timeout 10
Router(config-ephone-hunt)# auto logout
Router(config-ephone-hunt)# final 4500

Related Commands Command Description
auto logout Enables the automatic change of an agent’s ephone-dn to not-ready status
after a specified number of hunt-group calls are not answered.
Cisco Unified CME Commands: H
hunt-group report delay hours
460
Cisco Unified CME Command Reference
OL-10894-01
hunt-group report delay hours
To delay the automatic transfer of Cisco CallManager Express (Cisco CME) basic automatic call
distribution (B-ACD) call statistics to a file, use the hunt-group report delay hours command in
telephony-service configuration mode. To remove to the delay setting, use the no form of this command.
hunt-group report delay number hours
no hunt-group report delay number hours
Syntax Description
Command Default No hunt-group report delay is configured.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command is used for Cisco CME basic automatic call distribution (B-ACD) and auto-attendant
(AA) service only.
The hunt-group report delay hours command is used as part of a statistics reporting configuration that
allows Cisco CME B-ACD call statistics to be sent automatically to files using TFTP. For detailed
information, see Cisco CME B-ACD and Tcl Call-Handling Applications.
Statistics are collected and stored (statistics collect command and hunt-group report url command) in
specified intervals (hunt-group report every hours command). The default is for the statistics to be
collected one hour after the specified interval. Because calls are counted when they end, some of the
longer calls may not be counted. For example, if there is a call from 1:35 p.m. to 3:30 p.m., the interval
is 1 hour, and there is no delay, TFTP will write the 1 p.m. to 2 p.m. statistics at 3 p.m. However, at 3
p.m., the 1:35 p.m. call is still active, so the call will not be counted at that time as occurring in the 1 p.m.
to 2 p.m. time slot. When the call finishes at 3:30 p.m., it will be counted as occurring from 1 p.m. to
2 p.m. The show hunt-group command will report it, but TFTP will have already sent out its report. To
include the 1:35 p.m. call, you could use the hunt-group report delay hours command to delay TFTP
statistics reporting for an extra hour so the 1 p.m. to 2 p.m. report will be written at 4 p.m. instead of
3 p.m.
number Number of hours by which the collection of statistics can be extended for the
statistics collection periods configured with the hunt-group report every
hours command. The range is from 1 to 10.
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.
Cisco Unified CME Commands: H
hunt-group report delay hours
461
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows a configuration in which statistics are reported for B-ACD calls that occur
within three-hour time frames, but the collection of the statistic collection is extended for an extra hour
to include calls that did not end within the three-hour time period:
Router(config)# telephony-service
Router(config-telephony)# hunt-group report every 3 hours
Router(config-telephony)# hunt-group report delay 1 hours

The following is an example of a report that the previous configuration might send to a file if the
statistics collect command was entered at 18:20:
23:00:00 UTC Tue Dec 20 2004,
,
01, Tue 18:00 - 19:00, HuntGp, 02, 01, 00005, 00002, 0003, 0006, 000001, 000001, 0011,
01, Tue 19:00 - 20:00, HuntGp, 02, 02, 00000, 00000, 0000, 0000, 000000, 000000, 0000,
01, Tue 20:00 - 21:00, HuntGp, 02, 02, 00006, 00003, 0003, 0009, 000001, 000003, 0012,

Statistics collection has to take place for at least three hours for the statistics to be written to a file. The
following is a chronology of events:
• At 19:00, the statistics collection was active for 40 minutes, so no statistics were written to file.
• At 20:00, the statistics collection was active for 1 hour and 40 minutes, so no statistics were written
to file.
• At 21:00, the statistics collection was active for 2 hours and 40 minutes, so no statistics were written
to file.
• At 22:00, the statistics collection was active for 3 hours and 40 minutes but there is a one-hour delay,
so no statistics were written to file.
• At 23:00 the statistics were written to a file using TFTP.
Related Commands Command Description
hunt-group report
every hours
Sets the hourly interval after which Cisco CME B-ACD call statistics are
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.
statistics collect Enables the collection of Cisco CME B-ACD call data for an ephone hunt
group.
Cisco Unified CME Commands: H
hunt-group report every hours
462
Cisco Unified CME Command Reference
OL-10894-01
hunt-group report every hours
To set the hourly interval at which Cisco CallManager Express (Cisco CME) basic automatic call
distribution (B-ACD) call statistics are automatically transferred to a file, use the hunt-group report
every hours command in telephony-service configuration mode. To remove the interval setting, use the
no form of this command.
hunt-group report every number hours
no hunt-group report every number hours
Syntax Description
Command Default No hourly interval is configured.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command is used for Cisco CME basic automatic call distribution (B-ACD) and auto-attendant
(AA) service only.
The hunt-group report every hours command is used as part of a statistics reporting configuration that
allows Cisco CME B-ACD call statistics to be sent automatically to files by means of TFTP. For detailed
information, see Cisco CME B-ACD and Tcl Call-Handling Applications.
Because calls are counted when they end, some of the longer calls may not be counted in the report. To
delay the time in which statistics are collected and transferred you may configure a delay time with the
hunt-group report delay hours command.
Examples The following example sets the statistics collection to occur every three hours. There is no delay.
Router(config)# telephony-service
Router(config-telephony)# hunt-group report every 3 hours
number Number of hours after which auto-attendant (AA) call statistics are collected
and reported. The range is from 1 to 84.
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.
Cisco Unified CME Commands: H
hunt-group report every hours
463
Cisco Unified CME Command Reference
OL-10894-01
The following is an example of a report that the previous configuration might send to a file if the
statistics collect command was entered at 18:20:
22:00:00 UTC Tue Dec 20 2005,
,
01, Tue 18:00 - 19:00, HuntGp, 02, 01, 00005, 00002, 0003, 0006, 000001, 000001, 0011,
01, Tue 19:00 - 20:00, HuntGp, 02, 02, 00000, 00000, 0000, 0000, 000000, 000000, 0000,
01, Tue 20:00 - 21:00, HuntGp, 02, 02, 00006, 00003, 0003, 0009, 000001, 000003, 0012,
Statistics collection has to take place for at least three hours for the statistics to be written to a file. The
following is a chronology of events:
• At 19:00, the statistics collection was active for 40 minutes, so no statistics were written to file.
• At 20:00, the statistics collection was active for 1 hour and 40 minutes, so no statistics were written
to file.
• At 21:00, the statistics collection was active for 2 hours and 40 minutes, so no statistics were written
to file.
• At 22:00, the statistics collection was active for 3 hours and 40 minutes, so statistics were written
to a file using TFTP.
If the previous example were configured for a delay of one hour using the hunt-group report delay 1
hours command, the statistics would be written one hour later at 23:00.
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 url Sets filename parameters and the URL path where Cisco CME B-ACD call
statistics are to be sent using TFTP.
statistics collect Enables the collection of Cisco CME B-ACD call statistics for an ephone
hunt group.
Cisco Unified CME Commands: H
hunt-group report url
464
Cisco Unified CME Command Reference
OL-10894-01
hunt-group report url
To set filename parameters and the URL path where Cisco Unified CME basic automatic call
distribution (B-ACD) call statistics are to be sent using TFTP, use the hunt-group report url command
in telephony-service configuration mode. To remove the report URL settings and stop statistics from
being sent to files, use the no form of this command.
hunt-group report url [prefix tftp://ip-address/directory-name.../prefix | suffix from-number to
to-number]
no hunt-group report url [prefix tftp://ip-address/directory-name.../prefix | suffix from-number to
to-number]
Syntax Description
Command Default No statistics are sent to files.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Use this command for Cisco Unified CME basic automatic call distribution (B-ACD) and auto-attendant
(AA) service only. For detailed information, see Cisco CME B-ACD and Tcl Call-Handling
Applications.
prefix Sets the parameters for how the filenames must start.
tftp://ip-address-path/ IP address to the files where AA call data is sent using TFTP.
directory-name.../ Names of directories, separated by forward slashes (/) to declare the path to
the files where AA call data is sent.
prefix Specifies a common beginning to be used for the filenames.
suffix Sets numeric parameters for unique endings for the filenames.
from-number Number at which the suffix range starts. The range is from 0 to 1. There is
no default.
to to-number Number at which the suffix range ends. The range is from 1 to 200. There is
no default.
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.
12.4(4)XC Cisco Unified CME 4.0 Call-hold statistics were added to the output for
Cisco Unified CME B-ACD hunt groups.
12.4(9)T Cisco Unified CME 4.0 Call-hold statistics in the output for
Cisco Unified CME B-ACD hunt groups was
integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: H
hunt-group report url
465
Cisco Unified CME Command Reference
OL-10894-01
The hunt-group report url command is used with the hunt-group every hour command to collect
statistics about ephone hunt groups that are part of Cisco Unified CME B-ACD services. Data is
collected for all agents combined and for individual agents. The data includes statistics on the number
of calls received, the amount of time the calls had to wait to be answered, the amount of time they spent
on hold or in queue, and so forth.
The hunt-group report url command transfers these call statistics to files using TFTP for time periods
set by the hunt-group every hours command. Each set of statistics for each time period is sent to a
different file that is named using the arguments in the hunt-group report url command. For example,
the first set of statistics may go to a file named test001, the second set to test002, and so forth.
Prior to using the hunt-group report url command, you must create files with matching prefixes and
suffixes. For example, for the following configuration:
telephony-service
hunt-group report url prefix tftp://239.1.1.1/dirname/dirname/data
hunt-group report url suffix 0 to 3
you must have files named data0, data1, data2, and data3 at the designated directory location
(tftp://239.1.1.1/dirname/dirname).
For the following configuration, you must have files named data00, data01, data02, ... data50:
telephony-service
hunt-group report url prefix tftp://239.1.1.1/dirname/dirname/data
hunt-group report url suffix 0 to 50
For the following configuration, you must have files named data000, data002, ... data200:
telephony-service
hunt-group report url prefix tftp://239.1.1.1/dirname/dirname/data
hunt-group report url suffix 0 to 200
The files must be must empty read-and-write files. The following is an example of the statistics sent to
a file using TFTP:
23:00:00 UTC Wed Apr 23 2003,
01, Wed 21:00 - 22:00, HuntGp, 02, 02, 00005, 00002, 0003, 0006, 000001, 000001, 0011,
01, Wed 21:00 - 22:00, Agent, 8001, 00002, 000001, 000001, 00002, 000002, 000002,
01, Wed 21:00 - 22:00, Agent, 8003, 00001, 000001, 000001, 00000, 000000, 000000,
01, Wed 21:00 - 22:00, Queue, 00002, 00002, 00000, 00002, 00003, 00000, 00000, 00000,
00000,
The order of the data fields corresponds to the order of the descriptions issued by the show hunt-group
command. See the “Examples” section for explanations of the data fields. The Cisco CME B-ACD and
Tcl Call-Handling Applications document discusses how hunt-group reports align with the show
hunt-group command output. Once the statistics are in a file, they can be sent to an application, such as
Microsoft Excel or Access, to be merged into a chart or graph for easier reading.
For the report mechanism to collect data, you must first issue the statistics collect command.
Examples The following configuration uses TFTP to send AA call statistics to files named test00, test01, ... test90
located at tftp://239.1.1.1/dirname/dirname/test:
Router(config)# telephony-service
Router(config-telephony)# hunt-group report url prefix
tftp://239.1.1.1/dirname/dirname/test
Router(config-telephony)# hunt-group report url suffix 0 to 90
Cisco Unified CME Commands: H
hunt-group report url
466
Cisco Unified CME Command Reference
OL-10894-01
The following example displays the raw data output that was transferred to files in TFTP format after
the hunt-group report every hours command was used. Table 11 through Table 13 describe what each
number in the example represents. Table 11 explains the first line of data, Table 12 explains the second
and third lines of data, and Table 13 explains the fourth line of data.
18:00:00 UTC Tue Apr 23 2003,
,
01, Tue 16:00 - 17:00, HuntGp, 06, 06, 00002, 00002, 00000, 0006, 0011, 000004, 000006,
0000, 00002, 000002, 000005,
01, Tue 16:00 - 17:00, Agent, 8001, 00001, 000002, 000002, 00001, 000003, 000003, 00002,
000003, 000003, 00002, 000001, 000001,
01, Tue 16:00 - 17:00, Agent, 8003, 00001, 000006, 000006, 00001, 000005, 000005, 00000,
000000, 000000, 00000, 000000, 000000,
01, Tue 16:00 - 17:00, Queue, 00002, 00002, 00000, 00001, 00001, 00000, 00000, 00000,
00000,
Table 11 explains the first line of TFTP-format statistics, which are the main statistics that present data
for the hunt group as a whole.
Table 11 Ephone Hunt Group TFTP Format Main Statistics
Hunt Group Data Line Example (Entire Hunt Group):
01, Tue 16:00 - 17:00, HuntGp, 06, 06, 00002, 00002, 00000, 0006, 0011, 000004,
000006, 0000, 00002, 000002, 000005,
Data Explanation
01 Statistics for hunt group 1 are provided in this line of data.
Tue 16:00 - 17:00 Period during which the statistics were collected.
HuntGp Main statistics for a complete hunt group are provided in
this line of data.
06 Maximum number of agents.
06 Minimum number of agents.
00002 Total calls.
00002 Answered calls.
00000 Abandoned calls.
0006 Average time to answer, in seconds.
0011 Longest time to answer, in seconds.
000004 Average time in call, in seconds.
000006 Longest time in call, in seconds.
0000 Average time before abandonment, in seconds.
00002 Calls on hold.
000002 Average time on hold, in seconds.
000005 Longest time on hold, in seconds.
Cisco Unified CME Commands: H
hunt-group report url
467
Cisco Unified CME Command Reference
OL-10894-01
Table 12 explains the next two lines of TFTP-format statistics in the example, which provide data for
individual agents. Note that only the second line is presented in the table, but the third line follows the
same format.
In the table, some statistics are marked with the following comments.
• Direct—Indicates calls that were made directly to the hunt group pilot number.
• Queue—Indicates calls that passed through a Cisco Unified CME B-ACD call queue.
Table 12 Ephone Hunt Group TFTP Format Per-Agent Statistics
Agent Data Line Example:
01, Tue 16:00 - 17:00, Agent, 8001, 00001, 000002, 000002, 00001, 000003, 000003,
00002, 000003, 000003, 00002, 000001, 000001,
Data Explanation
01 Statistics for hunt group 1 are provided in this line of data.
Tue 16:00 - 17:00 Period during which these statistics were collected.
Agent Hunt group statistics for a single agent are provided in this
line of data.
8001 Agent number.
00001 Total calls answered (Direct).
000002 Average time in call, in seconds (Direct).
000002 Longest time in call, in seconds (Direct).
00001 Total calls on hold (Direct).
000003 Average hold time, in seconds (Direct).
000003 Longest hold time, in seconds (Direct).
00002 Total calls answered (Queue).
000003 Average time in call, in seconds (Queue).
000003 Longest time in call, in seconds (Queue).
00002 Total calls on Hold (Queue).
000001 Average hold time, in seconds (Queue).
000001 Longest hold time, in seconds (Queue).
Cisco Unified CME Commands: H
hunt-group report url
468
Cisco Unified CME Command Reference
OL-10894-01
Table 13 explains the final line of data in the example, which is the data for the B-ACD queue.
Related Commands
Table 13 Ephone Hunt Group TFTP Format Queue-Related Statistics
Queue-Related Data Line Example:
01, Tue 16:00 - 17:00, Queue, 00002, 00002, 00000, 00001, 00001, 00000, 00000,
00000, 00000,
Data Explanation
01 Statistics for hunt group 1 are provided in this line of data.
Tue 16:00 - 17:00 Period during which these statistics were collected.
Queue Queue-related statistics are provided in this line of data.
00002 Total number of calls presented to the queue.
00002 Calls answered by agents.
00000 Number of calls in the queue.
00001 Average time to answer, in seconds.
00001 Longest time to answer, in seconds.
00000 Number of abandoned calls.
00000 Average time before abandonment, in seconds.
00000 Calls forwarded to voice mail.
00000 Calls answered by voice mail.
Command Description
ephone-hunt Defines an ephone hunt group and enters ephone-hunt configuration mode.
hunt-group report
delay hours
Delays the automatic transfer of Cisco Unified CME B-ACD call statistics
to a file.
hunt-group report
every hours
Sets the hourly interval after which Cisco Unified CME B-ACD call
statistics are automatically transferred to a file.
statistics collect Enables the collection of Cisco Unified CME B-ACD call statistics for an
ephone hunt group.
Cisco Unified CME Commands: H
huntstop (ephone-dn and ephone-dn-template)
469
Cisco Unified CME Command Reference
OL-10894-01
huntstop (ephone-dn and ephone-dn-template)
To disable call hunting for directory numbers or channels, use the huntstop command in ephone-dn or
ephone-dn-template configuration mode. To reset to the default, use the no form of this command.
huntstop [channel number-of-channels]
no huntstop [channel number-of-channels]
Syntax Description
Command Default Ephone-dn huntstop is enabled.
Channel huntstop is disabled for dual-line directory numbers.
Channel huntstop is set to 8 for octo-line directory numbers.
Command Modes Ephone-dn configuration (config-ephone-dn)
Ephone-dn-template configuration (config-ephone-dn-template)
Command History
channel (Optional) For dual-line and octo-line directory numbers. Prevents incoming
calls from hunting to the next channel if the first channel is busy or does not
answer.
number-of-channels Supported for octo-line directory numbers only. Number of channels
available to accept incoming calls. Remaining channels are reserved for
outgoing calls or features such as call transfer, call waiting, and
conferencing. Range: 1 to 8. Default: 8.
Cisco IOS Release Cisco Product Modification
12.1(5)YD Cisco ITS 1.0 This command was introduced.
12.2(2)XT Cisco ITS 2.0 This command was implemented on the
Cisco 1750 and Cisco 1751.
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 channel keyword was introduced.
12.3(4)T Cisco CME 3.0 This channel keyword was integrated into
Cisco IOS Release 12.3(4)T.
12.4(4)XC Cisco Unified CME 4.0 This command was added to ephone-dn-template
configuration mode.
12.4(9)T Cisco Unified CME 4.0 This command in ephone-dn-template
configuration mode was integrated into Cisco IOS
Release 12.4(9)T.
12.4(15)XZ Cisco Unified CME 4.3 The number-of-channels argument was added for
octo-lines.
12.4(20)T Cisco Unified CME 7.0 This command with the number-of-channels
argument for octo-lines was integrated into
Release 12.4(20)T.
Cisco Unified CME Commands: H
huntstop (ephone-dn and ephone-dn-template)
470
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines Use this command without the channel keyword to disable call hunting for ephone-dns. An incoming
call does not roll over (hunt) to another ephone-dn if the called number is busy or does not answer and
a call hunt strategy has been established that includes this ephone-dn. A huntstop prevents hunt-on-busy
from redirecting a call from a busy phone into a dial-peer with a catch-all default destination. Use the
no huntstop command to disable huntstop and allow hunting for ephone-dns.
Channel huntstop works in a similar way, but it affects call hunting behavior for the two channels of a
dual-line ephone-dn. Use the channel keyword to prevent incoming calls from hunting to the second
channel of an ephone-dn if the first channel is busy or does not answer. Incoming calls hunt forward to
the next ephone-dn in the hunt sequence instead of to the next channel on the same ephone-dn.
For example, an incoming call might search through the following ephone-dns and channels:
ephone-dn 10 (channel 1)
ephone-dn 10 (channel 2)
ephone-dn 11 (channel 1)
ephone-dn 11 (channel 2)
ephone-dn 12 (channel 1)
ephone-dn 12 (channel 2)
If the huntstop channel command is not enabled (the default), a call might ring for 30 seconds on
ephone-dn 10 (channel 1) and then after 30 seconds move to ephone-dn 10 (channel 2), which is usually
not the desired behavior. It is useful to reserve the second channel of a dual-line ephone-dn for call
transfer, call waiting, or conferencing.
The number argument is required for an octo-line directory number when using the channel keyword.
This argument limits the number of channels for incoming calls on an octo-line directory number and
reserves the other channels for outgoing calls or features such as call transfer or conferencing. The router
selects idle channels from the lowest number to the highest. This argument is supported only for an
octo-line directory number.
In an ephone-dn template, you can apply separate huntstop channel commands for dual-line directory
numbers and octo-line directory numbers.
If you use an ephone-dn template to apply a command to an ephone-dn and you also use the same
command in ephone-dn configuration mode for the same ephone-dn, the value that you set in ephone-dn
configuration mode has priority.
Examples The following example shows huntstop is disabled for ephone-dn 1. The huntstop attribute is set to OFF
and allows calls to extension 5001 to hunt to another directory number when directory number 1 is busy.
ephone-dn 1
number 5001
no huntstop

The following example shows a typical configuration in which enabling huntstop (default) is required:
ephone-dn 1
number 5001

ephone 4
button 1:1
mac-address 0030.94c3.8724

dial-peer voice 5000 voip
destination-pattern 5...
session target ipv4:192.168.17.225

Cisco Unified CME Commands: H
huntstop (ephone-dn and ephone-dn-template)
471
Cisco Unified CME Command Reference
OL-10894-01
In the previous example, the huntstop attribute for the dial peer is set to ON by default and prevents calls
to extension 5001 from being rerouted to the on-net H.323 dial peer for 5... when extension 5001 is busy
(the three periods are used as wildcards).
The following example shows another configuration in which huntstop is not desired and is explicitly
disabled. In this example, ephone 4 is configured with two lines, each with the same extension number
5001. This allows the second line to provide call-waiting notification for extension number 5001 when
the first line is in use. Setting no huntstop on the first line (ephone-dn 1) allows incoming calls to hunt
to the second line (ephone-dn 2) when the first line is busy.
Ephone-dn 2 has call forwarding set to extension 6000, which corresponds to a locally attached
answering machine connected to a foreign exchange station (FXS) voice port. In this example, the plain
old telephone system (POTS) dial peer for extension 6000 also has the dial-peer huntstop attribute
explicitly set to prevent further hunting.
ephone-dn 1
number 5001
no huntstop
preference 1
call-forward noan 6000

ephone-dn 2
number 5001
preference 2
call-forward busy 6000
call-forward noan 6000

ephone 4
button 1:1 2:2
mac-address 0030.94c3.8724

dial-peer voice 6000 pots
destination-pattern 6000
huntstop
port 1/0/0
description answering-machine

The following example shows a dual-line configuration in which an ephone-dn template is used to
prevent calls from hunting to the second channel of any ephone-dn. The calls hunt through the first
channels for each ephone-dn in the order 10, 11, 12.
ephone-dn-template 2
huntstop channel

ephone-dn 10 dual-line
number 1001
no huntstop
ephone-dn-template 2

ephone-dn 11 dual-line
number 1001
no huntstop
ephone-dn-template 2
preference 1

ephone-dn 12 dual-line
number 1001
no huntstop
ephone-dn-template 2
preference 2

Cisco Unified CME Commands: H
huntstop (ephone-dn and ephone-dn-template)
472
Cisco Unified CME Command Reference
OL-10894-01
The following example shows a configuration in which incoming calls to octo-line directory number 7
are limited to four, freeing the other four channels for outgoing calls or features such as call transfer or
conferencing.
ephone-dn 7 octo-line
number 2001
name Smith, John
huntstop channel 4

The following example shows an ephone-dn template configuration in which the huntstop is set for both
dual-line and octo-line directory numbers.
ephone-dn-template 1
huntstop channel
huntstop channel 4
Related Commands Command Description
huntstop (dial-peer) Disables further dial-peer hunting if a call fails using hunt groups.
number Associates a telephone or extension number with a directory number
(ephone-dn).
Cisco Unified CME Commands: H
huntstop (voice register dn)
473
Cisco Unified CME Command Reference
OL-10894-01
huntstop (voice register dn)
To disable call hunting behavior for a directory number on a SIP phone, use the huntstop command in
voice register dn configuration mode. To reset to the default, use the no form of this command.
huntstop [channel number]
no huntstop [channel number]
Syntax Description
Command Default Call hunting is enabled for the directory number.
Channel huntstop is disabled (0) for the directory number.
Command Modes Voice register dn configuration (config-register-dn)
Command History
Usage Guidelines This command disables call hunting behavior for a directory number on a SIP IP phone so that an
incoming call does not roll over (hunt) to another directory number if the called directory number is busy
or does not answer and if a hunting strategy has been established that includes this directory number. A
huntstop allows you to prevent hunt-on-busy from redirecting a call from a busy phone into a dial-peer
setup with a catch-all default destination. Use the no huntstop command to disable huntstop and allow
hunting for directory numbers (default).
The channel keyword and number argument limits the number of channels for incoming calls to a
directory number and reserves the other channels for outgoing calls or features such as call transfer or
conferencing. The router selects idle channels from the lowest number to the highest.
channel number (Optional) Number of channels available to accept incoming calls. Remaining
channels are reserved for outgoing calls or features such as call transfer, call
waiting, and conferencing. Range: 1 to 50. Default: 0 (disabled).
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
12.4(22)YB Cisco Unified CME 7.1 The channel keyword and number argument were
added.
12.4(24)T Cisco Unified CME 7.1 This command has been integrated into Cisco IOS
Release 12.4(24)T.
Cisco Unified CME Commands: H
huntstop (voice register dn)
474
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows a typical configuration in which huntstop is required. The huntstop
command is enabled and prevents calls to extension 5001 from being rerouted to the on-net H.323 dial
peer for 5... when extension 5001 is busy (three periods are used as wild cards).
voice register dn 1
number 5001
huntstop

voice register pool 4
button 1:1
mac-address 0030.94c3.8724

dial-peer voice 5000 voip
destination-pattern 5...
session target ipv4:192.168.17.225

The following example shows a configuration in which huntstop is not desired (default). In this example,
directory number 4 is configured with two lines, each with the same extension number 5001. This is done
to allow the second line to provide call-waiting notification for extension number 5001 when the first
line is in use. Not enabling huntstop on the first line (directory number 1) allows incoming calls to hunt
to the second line (directory number 2) on phone 4 when the directory number 1 line is busy.
Directory number 2 has call forwarding set to extension 6000, which corresponds to a locally attached
answering machine connected to a foreign exchange station (FXS) voice port. In this example, the plain
old telephone system (POTS) dial peer for extension 6000 has the dial-peer huntstop attribute explicitly
set to prevent further hunting.
voice register dn 1
number 5001
preference 1
call-forward noan 6000

voice register dn 2
number 5001
preference 2
call-forward busy 6000
call-forward noan 6000

voice register pool 4
button 1:1 2:2
mac-address 0030.94c3.8724

dial-peer voice 6000 pots
destination-pattern 6000
huntstop
port 1/0/0
description answering-machine

The following example shows a configuration in which incoming calls to directory number 23 are
blocked if the total number of calls to extension 8123 exceeds 4. This frees the other channels for
outgoing calls or features such as call transfer or conferencing.
voice register dn 23
number 8123
shared-line max-calls 4
huntstop channel 4
Cisco Unified CME Commands: H
huntstop (voice register dn)
475
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
huntstop (dial-peer) Disables all further dial-peer hunting if a call fails on the dial peer.
shared-line Creates a directory number to be shared by multiple SIP phones.
Cisco Unified CME Commands: H
huntstop (voice register dn)
476
Cisco Unified CME Command Reference
OL-10894-01
477
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: I
Revised:October 22, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified CME Commands: I
ica
478
Cisco Unified CME Command Reference
OL-10894-01
ica
To specify the audio file used for the isolated code announcement, use the ica command in voice MLPP
configuration mode. To disable use of this audio file, use the no form of this command.
ica audio-url
no ica
Syntax Description
Command Default No announcement is played.
Command Modes Voice MLPP configuration (config-voice-mlpp)
Command History
Usage Guidelines This command specifies the G.711 a-law or u-law 8-KHz encoded audio file (.wav or .au format) for the
announcement that plays to callers when service or equipment problems prevent completion of their call.
The mlpp indication command must be enabled (default) for a phone to play precedence
announcements.
This command is not supported by Cisco IOS help. If you type ?, Cisco IOS help does not display a list
of valid entries.
Examples The following example shows that the audio file played for the isolated code announcement is named
ica.au located in flash:
Router(config)# voice mlpp
Router(config-voice-mlpp)# ica flash:ica.au
Related Commands
audio-url Location of the announcement audio file in URL format. Valid storage
locations are TFTP, FTP, HTTP, and flash memory.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
bnea Specifies the audio file used for the busy station not equipped for
preemption announcement.
upa Specifies the audio file used for the unauthorized precedence
announcement.
vca Specifies the audio file used for the vacant code announcement.
mlpp indication Enables MLPP indication on an SCCP phone or analog FXS port.
mlpp preemption Enables preemption capability on an SCCP phone or analog FXS port.
Cisco Unified CME Commands: I
id (voice register pool)
479
Cisco Unified CME Command Reference
OL-10894-01
id (voice register pool)
To explicitly identify a locally available individual Cisco SIP IP phone, or when running Cisco Unified
Session Initiation Protocol (SIP) Survivable Remote Site Telephony (SRST), set of Cisco SIP IP phones,
use the id command in voice register pool configuration mode. To remove local identification, use the
no form of this command.
id {network address mask mask | ip address mask mask | mac address}
no id {network address mask mask | ip address mask mask | mac address}
Syntax Description
Command Default No SIP IP phone is configured.
Command Modes Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines Configure this command before configuring any other command in voice register pool configuration
mode.
This command allows explicit identification of an individual Cisco SIP IP phone to support a degree of
authentication, which is required to accept registrations, based upon the following:
• Verification of the local Layer 2 MAC address using the router’s Address Resolution Protocol (ARP)
cache.
• Verification of the known single static IP address (or DHCP dynamic IP address within a specific
subnet) of the Cisco SIP IP phone.
When the mac address keyword and argument are used, the IP phone must be in the same subnet as that
of the router’s LAN interface, such that the phone’s MAC address is visible in the router’s ARP cache.
Once a MAC address is configured for a specific voice register pool, remove the existing MAC address
before changing to a new MAC address.
network address
mask mask
The network address mask mask keyword/argument combination is used to
accept SIP Register messages for the indicated phone numbers from any IP
phone within the specified IP subnet.
ip address mask mask The ip address mask mask keyword/argument combination is used to
identify an individual phone.
mac address The mac address keyword/argument combination is used to identify the
MAC address of a particular Cisco IP phone.
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.
Cisco Unified CME Commands: I
id (voice register pool)
480
Cisco Unified CME Command Reference
OL-10894-01
Note For Cisco Unified SIP SRST, this command also allows explicit identification of locally available set of
Cisco SIP IP phones.
Examples The following is partial sample output from the show running-config command. The id command
identifies the MAC address of a particular Cisco IP phone. The output shows that voice register pool 1
has been set up to accept SIP Register messages from a specific IP phone through the use of the id
command.
voice register pool 1
id mac 0030.94C2.A22A
preference 5
cor incoming call91 1 91011
translate-outgoing called 1
proxy 10.2.161.187 preference 1 monitor probe icmp-ping
alias 1 94... to 91011 preference 8
voice-class codec 1

Related Commands Command Description
mode (voice register
global)
Enables the mode for provisioning SIP phones in a Cisco
Unified CallManager Express (Cisco Unified CME) system.
Cisco Unified CME Commands: I
index (lpcor ip-phone)
481
Cisco Unified CME Command Reference
OL-10894-01
index (lpcor ip-phone)
To add a logical partitioning class of restriction (LPCOR) group to the IP-phone subnet table, use the
index command in LPCOR ip-phone subnet configuration mode. To remove a resource, use the no form
of this command.
index index-number lpcor-group {ipv4-address network-mask [vrf vrf-name] | dhcp-pool
pool-name}
no index index-number
Syntax Description
Command Default No index entry is configured.
Command Modes LPCOR ip-phone subnet configuration (cfg-lpcor-ipphone-subnet)
Command History
Usage Guidelines This command is used for mobility-type phones only, which can include Extension Mobility phones,
teleworker remote phones, and Cisco IP Communicator softphones.
Two IP-phone subnet tables, containing up to 50 index entries, can be defined on each
Cisco Unified CME router. One table is for incoming calls and the other table is for outgoing calls.
A LPCOR policy is dynamically associated with calls to and from a mobility-type phone by matching
its current IP address or DHCP pool in the IP-phone subnet table. If the LPCOR policy cannot be
provisioned from the IP-phone subnet table, the default LPCOR policy for mobility-type phones is used.
Entries in the IP-phone subnet tables are indexed in ascending order. The lookup of entries is in
sequential ascending order. After Cisco Unified CME finds a matching entry, the corresponding LPCOR
policy is associated with the call. Even if there are other entries that are a better match, only the first
match is used.
index-number Number of the LPCOR subnet index entry. Range: 1 to 50.
lpcor-group Name of a LPCOR resource-group policy.
ipv4-address IPv4 address of the LPCOR policy.
network-mask Subnet mask for the associated IPv4 address.
vrf vrf-name (Optional) Dynamic Host Configuration Protocol (DHCP) server uses the
VPN routing and forwarding (VRF) table that is associated with the access
point name (APN).
dhcp-pool pool-name User-defined name of the DHCP pool. The pool name can be a symbolic
string (such as Sales) or an integer (such as 0).
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified CME Commands: I
index (lpcor ip-phone)
482
Cisco Unified CME Command Reference
OL-10894-01
For instance, in the example below, if a call originates from an IP phone with IP address 10.1.10.3,
LPCOR policy local_g4 is associated with the incoming call instead of LPCOR policy local_g5 even
though local_g5 is a better match.
Examples The following example shows an IP-phone subnet table for incoming calls that has four entries:
voice lpcor ip-phone subnet incoming
index 1 local_g4 10.1.10.0 255.255.255.0
index 2 remote_g4 171.19.0.0 255.255.0.0
index 3 local_g5 10.1.10.2 255.255.255.255
index 4 local_g5 10.1.10.3 255.255.255.255
Related Commands Command Description
lpcor type Specifies the LPCOR type for an IP phone.
voice lpcor ip-phone mobility Sets the default LPCOR policy for mobility-type phones.
voice lpcor policy Creates a LPCOR policy for a resource group.
Cisco Unified CME Commands: I
index (lpcor ip-trunk)
483
Cisco Unified CME Command Reference
OL-10894-01
index (lpcor ip-trunk)
To add a logical partitioning class of restriction (LPCOR) resource group to the IP trunk subnet table,
use the index command in LPCOR IP-trunk subnet configuration mode. To remove a resource, use the
no form of this command.
index number lpcor-group {ipv4-address network-mask | hostname host-name}
no index number
Syntax Description
Command Default No index entry is configured.
Command Modes LPCOR IP-trunk subnet configuration (cfg-lpcor-iptrunk-subnet)
Command History
Usage Guidelines One IP-trunk subnet table, containing up to 50 index entries, can be defined on each Cisco Unified CME
router for incoming VoIP trunk calls (H.323 or SIP).
An incoming VoIP trunk call is associated with a LPCOR policy by matching the remote IP address to
an entry in the incoming IP-trunk subnet table. If that is not successful, the LPCOR policy in voice
service configuration mode is applied.
Entries in the IP-trunk subnet table are indexed in ascending order. The lookup of entries is in sequential
ascending order. After Cisco Unified CME finds a matching entry, it associates the corresponding
LPCOR policy with the call. Even if there are other entries that are a better match, only the first match
is used.
In the following example, an incoming VoIP call with a remote IP address of 172.19.22.25 is associated
with sip_group1 even though voip_group2 is a better match.
Examples The following example shows an IP-trunk subnet table with six index entries:
voice lpcor ip-trunk subnet incoming
index 1 h323_group1 172.19.33.0 255.255.255.0
index 2 sip_group1 172.19.22.0 255.255.255.0
index 3 voip_group2 172.19.33.25 255.255.255.255
index 4 voip_group3 172.19.22.26 255.255.255.255
number Number of the LPCOR subnet index entry. Range: 1 to 50.
lpcor-group Name of a LPCOR resource-group policy.
ipv4-address IPv4 address of the LPCOR policy.
network-mask Subnet mask of the associated IPv4 address.
hostname host-name User-defined IP host name.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified CME Commands: I
index (lpcor ip-trunk)
484
Cisco Unified CME Command Reference
OL-10894-01
index 5 sip_s1 hostname sipserver1
index 6 sip_s2 hostname sipserver2
Related Commands Command Description
lpcor incoming Associates an incoming call with a LPCOR resource-group policy.
voice lpcor policy Ccreates a LPCOR policy for a resource group.
Cisco Unified CME Commands: I
intercom(ephone-dn)
485
Cisco Unified CME Command Reference
OL-10894-01
intercom(ephone-dn)
To create an intercom by programming a pair of extensions (ephone-dns) to automatically call and
answer each other, use the intercom command in ephone-dn configuration mode. To remove an
intercom, use the no form of this command.
intercom extension-number [[barge-in [no-mute] | no-auto-answer | no-mute] [label label]] |
label label]
no intercom
Syntax Description
Command Default Intercom functionality is disabled.
Command Modes Ephone-dn configuration (config-ephone-dn)
Command History
Usage Guidelines This command is used to dedicate a pair of Cisco ephone-dns for use as a “press to talk” two-way
intercom between Cisco IP phones. Intercom lines cannot be used in shared-line configurations. If an
ephone-dn is configured for intercom operation, it must be associated with one Cisco IP phone only. The
intercom attribute causes an IP extension (ephone-dn) to operate in autodial fashion for outbound calls
and autoanswer-with-mute for inbound calls.
The barge-in keyword allows inbound intercom calls to force an existing call on the called phone into
the call-hold state to allow the intercom call to be answered immediately. The no-auto-answer keyword
creates for the IP phone line a connection that resembles a private line, automatic ringdown (PLAR). The
label keyword defines a text label for the intercom.
extension-number Extension or telephone number to which calls are placed.
barge-in (Optional) Allows inbound intercom calls to force an existing call into the
call-hold state and the intercom call to be answered immediately.
label label (Optional) Defines an alphanumeric label for the intercom, of up to 30
characters.
no-auto-answer (Optional) Disables the intercom auto-answer feature.
no-mute (Optional) Allows an intercom call to be answered without deactivating a
speaker’s mute key.
Cisco IOS Release Cisco Product Modification
12.2(2)XT Cisco ITS 2.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.3(11)XL Cisco CME 3.2.1 The no-mute keyword was added.
12.3(14)T Cisco CME 3.3 This command was integrated into Cisco IOS
Release 12.3(14)T.
Cisco Unified CME Commands: I
intercom(ephone-dn)
486
Cisco Unified CME Command Reference
OL-10894-01
Following this command, the intercom ephone-dns are assigned to ephones using the button command.
Following the button command, the restart command must be used to initiate a quick reboot of the
phones to which this intercom is assigned.
The default intercom command behavior is speakers are set to mute automatically when phones receive
intercom calls. For example, if phone user 1 places an intercom call and connects to phone user 2, user 2
will hear user 1, but user 1 will not hear user 2. To be heard, user 2 must first disable the speaker’s mute
function. The benefit is people who receive intercom calls can use the mute button to control when they
will be heard initially.
The no-mute keyword deactivates the speaker mute function when IP phones receive intercom calls. For
example, if phone user 1 makes an intercom call to phone user 2, both users will hear each other upon
connection. The benefit is that people who receive intercom calls do not have to disable their speaker’s
mute function to be heard, but their conversations and nearby background sounds will be heard the
moment an intercom call to them is connected—regardless of whether they are ready to take a call or not.
Examples The following example sets the intercom on Cisco IP phone directory number 1:
Router(config)# ephone-dn 1
Router(config-ephone-dn) number A5001
Router(config-ephone-dn) name “intercom”
Router(config-ephone-dn) intercom A5002 barge-in

The following example shows intercom configuration between two Cisco IP phones:
ephone-dn 18
number A5001
name “intercom”
intercom A5002 barge-in
ephone-dn 19
number A5002
name “intercom”
intercom A5001 barge-in
ephone 4
button 1:2 2:4 3:18
ephone 5
button 1:3 2:6 3:19
In the example, ephone-dn 18 and ephone-dn 19 are set as an intercom pair. Ephone-dn 18 is associated
with button 3 of Cisco IP phone (ephone) 4, and ephone-dn 19 is associated with button number 3 of
Cisco IP phone (ephone) 5. Button 3 on Cisco IP phone 4 and button 3 on Cisco IP phone 5 are set as a
pair to provide intercom service to each other.
The intercom feature acts as a combination speed-dial PLAR and autoanswer with mute. If the barge-in
keyword is set on the ephone-dn that receives the intercom call, the existing call is forced into the hold
state, and the intercom call is accepted. If the phone user has the handset off hook (that is, not in
speakerphone mode), the user hears a warning beep, and the intercom call is immediately connected with
two-way audio. If the phone user is using speakerphone mode, the intercom connects with the
microphone mute activated.
Note Any caller can dial in to an intercom extension, and a call to an intercom extension that is originated by
a nonintercom caller triggers an automatic answer exactly like a legitimate intercom call. To prevent
nonintercom originators from manually dialing an intercom destination, you can use alphabetic
characters when you assign numbers to intercom extensions using the number command. These
characters cannot be dialed from a normal phone but can be dialed by preprogrammed intercom
extensions whose calls are made by the router.
Cisco Unified CME Commands: I
intercom(ephone-dn)
487
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
button Associates ephone-dns with individual buttons on Cisco IP phones and
specifies ring behavior per button.
number Associates a telephone or extension number with an extension (ephone-dn).
restart (ephone) Performs a fast reboot of a single phone associated with a Cisco CME router.
restart
(telephony-service)
Performs a fast reboot of one or all phones associated with a Cisco CME
router.
Cisco Unified CME Commands: I
internal-call
488
Cisco Unified CME Command Reference
OL-10894-01
internal-call
To assign an MOH group for calls from an internal directory number, use the internal-call command in
telephony-service configuration mode. To disable the internal-call command, use the no form of this
command.
internal-call moh-group-tag
no internal-call
Syntax Description
Command Default No internal-call is configured.
Command Modes Telephony-service configuration (config-telephony-service)
Command History
Usage Guidelines Before using this command make sure you have MOH-groups configured under voice-moh-group
configuration mode. This command allows you to assign a MOH-group for all calls from an internal
directory number. MOH group tag identifies the unique number assigned to a MOH group. Range for
MOH group tag is from 0 to 5, where 0 represents MOH configuration in telephony service.
Examples The following example shows MOH-group 4 assigned for an internal directory number:
telephony-service
internal-call moh-group 4
em logout 0:0 0:0 0:0
max-ephones 58
max-dn 192
ip source-address 15.1.0.161 port 2000
max-conferences 8 gain -6
moh music-on-hold.au
multicast moh 239.1.1.1 port 2000
transfer-system full-consult
Related Commands
moh-group-tag Specifies a MOH-group number to be used for calls from an internal
directory number. Range is from 0 to 5, where 0 represents MOH
configuration in telephony-service configuration mode.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
voice-moh-group Enter voice-moh-group configuration mode.
moh filename Enables music on hold from a flash audio feed
Cisco Unified CME Commands: I
internal-call
489
Cisco Unified CME Command Reference
OL-10894-01
multicast moh Enables multicast of the music-on-hold audio stream.
extension-range Specifies the extension range for a clients calling a
voice-moh-group.
Command Description
Cisco Unified CME Commands: I
ip qos dscp (telephony-service and voice register global)
490
Cisco Unified CME Command Reference
OL-10894-01
ip qos dscp (telephony-service and voice register global)
To set the Differentiated Services Code Point (DSCP) for marking the quality of service (QoS)
requirements for each packet, use the ip qos dscp command in telephony-service or voice register global
configuration mode. To reset to the default value, use the no form of this command.
ip qos dscp {{number | af | cs | default | ef} {media | service | signaling | video}}
no ip qos dscp {{number | af | cs | default | ef} {media | service | signaling | video}}
Syntax Description number DSCP value. Range: 0 to 63.
af Sets DSCP to assured forwarding bit pattern.
• af11—bit pattern 001010
• af12—bit pattern 001100
• af13—bit pattern 001110
• af21—bit pattern 010010
• af22—bit pattern 010100
• af23—bit pattern 010110
• af31—bit pattern 011010
• af32—bit pattern 011100
• af33—bit pattern 011110
• af41—bit pattern 100010
• af42—bit pattern 100100
• af43—bit pattern 100110
cs Sets DSCP to class-selector codepoint.
• cs1—codepoint 1 (precedence 1)
• cs2—codepoint 2 (precedence 2)
• cs3—codepoint 3 (precedence 3)
• cs4—codepoint 4 (precedence 4)
• cs5—codepoint 5 (precedence 5)
• cs6—codepoint 6 (precedence 6)
• cs7—codepoint 7 (precedence 7)
default Sets DSCP to default bit pattern of 000000.
ef Sets DSCP to expedited forwarding bit pattern 101110.
media Applies DSCP to media payload packets.
service Applies DSCP to phone service including HTTP traffic.
signaling Applies DSCP to signaling packets.
video Applies DSCP to video stream.
Cisco Unified CME Commands: I
ip qos dscp (telephony-service and voice register global)
491
Cisco Unified CME Command Reference
OL-10894-01
Defaults DSCP for media is ef.
DSCP for service is 0.
DSCP for signaling is cs3.
DSCP for video is af41.
Command Modes Telephony-service configuration (config-telephony)
Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command allows you to set different priority levels for different types of network traffic sent by the
Cisco Unified CME router. Differentiated Services is a method of prioritizing specific network traffic
based on the QoS specified by each packet. You can set different DSCP values, for example, for video
and audio streams.
Cisco Unified CME downloads the configured DSCP value to the phones in their configuration files and
all control messages and RTP streams are marked with the preferred DSCP value. Use this command in
telephony-service mode to set the DSCP for SCCP phones. Use the command in voice register global
mode to set the value for SIP phones.
If the DSCP is configured for the gateway interface using the service-policy command or in the dial peer
using the ip qos dscp command, the value set with those commands takes precedence over the DSCP
value configured with this command.
Examples The following examples show the configuration of DSCP for different types of packets.
voice register global
mode cme
ip qos dscp af11 media
ip qos dscp cs2 signal
ip qos dscp af43 video
ip qos dscp 25 service

telephony-service
load 7960-7940 P00308000500
max-ephones 100
max-dn 240
ip source-address 10.7.0.1 port 2000
ip qos dscp af11 media
ip qos dscp cs2 signal
ip qos dscp af43 video
ip qos dscp 25 service
Related Commands
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.
Cisco Unified CME Commands: I
ip qos dscp (telephony-service and voice register global)
492
Cisco Unified CME Command Reference
OL-10894-01
Command Description
ip qos dscp Sets the DSCP for QoS in a dial peer.
service-policy Assigns a policy map to an interface that will be used as the service
policy for the interface.
Cisco Unified CME Commands: I
ip source-address (credentials)
493
Cisco Unified CME Command Reference
OL-10894-01
ip source-address (credentials)
To enable the Cisco Unified CME or Cisco Unified SRST router to receive credential service messages
through the specified IP address and port, use the ip source-address command in credentials
configuration mode. To disable the router from receiving messages, use the no form of this command.
ip source-address ip-address [port [port]]
no ip source-address
Syntax Description
Command Default Default port number in Cisco Unified CME is 2444.
Default port number in Cisco Unified SRST is 2445.
Command Modes Credentials configuration (config-credentials)
Command History
Usage Guidelines Cisco Unified CME
This command is used with Cisco Unified CME phone authentication to identify a Cisco Unified CME
router on which a CTL provider is being configured.
Cisco Unified SRST
The ip source-address command is a mandatory command to enable secure SRST. If the port number is
not provided, the default value (2445) is used. The IP address is usually the IP address of the secure
SRST router.
ip-address Router IP address, typically one of the addresses of the Ethernet port of the
local router.
port port (Optional) TCP port for credentials service communication. Range is
from 2000 to 9999. Cisco Unified CME default is 2444. SRST default
is 2445.
Cisco IOS Release Cisco Product Modification
12.3(14)T Cisco SRST 3.3 This command was introduced for Cisco SRST.
12.4(4)XC Cisco Unified CME 4.0 This command was introduced for
Cisco Unified CME.
12.4(9)T Cisco Unified CME 4.0 This command for Cisco Unified CME was
integrated in Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: I
ip source-address (credentials)
494
Cisco Unified CME Command Reference
OL-10894-01
Examples Cisco Unified CME
The following example creates a CTL provider on a Cisco Unified CME router that is not running the
CTL client.
Router(config)# credentials
Router(config-credentials)# ip source-address 172.19.245.1 port 2444
Router(config-credentials)# trustpoint ctlpv
Router(config-credentials)# ctl-service admin user4 secret 0 c89L8o

Cisco Unified SRST
The following example enters credentials configuration mode and sets the IP source address and port:
Router(config)# credentials
Router(config-credentials)# ip source-address 10.6.21.4 port 2445

Related Commands Description
ctl-service admin Specifies a user name and password to authenticate the CTL client during
the CTL protocol.
debug credentials Sets debugging on the credentials service that runs between a
Cisco Unified CME CTL provider and the CTL client or between an SRST
router and Cisco Unified CallManager.
show credentials Displays the credentials settings on a Cisco Unified CME or SRST router.
trustpoint
(credentials)
Specifies the name of the trustpoint to be associated with a
Cisco Unified CME CTL provider certificate or with an SRST router
certificate.
Cisco Unified CME Commands: I
ip source-address (telephony-service)
495
Cisco Unified CME Command Reference
OL-10894-01
ip source-address (telephony-service)
To identify the IP address and port through which IP phones communicate with a Cisco Unified CME
router, use the ip source-address command in telephony-service configuration mode. To disable the
router from receiving messages from Cisco Unified IP phones, use the no form of this command.
ip source-address ip-address [port port] [secondary ip-address [rehome seconds]] [any-match |
strict-match]
no ip source-address
Syntax Description
Command Default IP address for communicating with phones is not defined.
Command Modes Telephony-service configuration (config-telephony)
Command History
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 from 2000 to 9999. Default is 2000.
secondary (Optional) Second Cisco Unified CME router with which phones can
register if the primary Cisco Unified CME router fails.
rehome seconds (Optional) Used only by Cisco Unified IP phones that have registered with a
Cisco Unified SRST router. This keyword defines a delay that is used by
phones to verify the stability of their primary SCCP controller
(Cisco Unified CallManager or Cisco Unified CME) before the phones
reregister with it. This parameter is ignored by phones unless they are
registered to a secondary Cisco Unified SRST router. The range is from 0
to 65535 seconds. The default is 120 seconds.
Note The use of this parameter is a phone behavior and is subject to
change, based on the phone type and phone firmware version.
any-match (Optional) Disables strict IP address checking for registration. This is the
default.
strict-match (Optional) Requires strict IP address checking for registration.
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.4(4)XC Cisco Unified CME 4.0 The secondary ip-address and rehome seconds
keyword-argument pairs were added.
12.4(9)T Cisco Unified CME 4.0 This command with the secondary ip-address and
rehome seconds keyword-argument pairs was
integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: I
ip source-address (telephony-service)
496
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines This mandatory command enables a router to receive messages from Cisco Unified IP phones through
the specified IP address and port. The Cisco Unified CME router cannot communicate with the
Cisco Unified CME phones if the IP address is not provided. If the port number is not provided, the
default is port 2000. The IP address is usually the IP address of the Ethernet port to which the phones
are connected.
Use the any-match keyword to instruct the router to permit Cisco Unified IP phone registration, and use
the strict-match keyword to instruct the router to reject IP phone registration attempts if the IP server
address used by the phone does not match the source address exactly.
Prior to Cisco IOS Telephony Services (Cisco ITS) V2.1, this command helped the router to
autogenerate the SEPDEFAULT.cnf file, which was stored in the flash memory of the router. The
SEPDEFAULT.cnf file contains the IP address of one of the Ethernet ports of the router to which the
phone should register. In ITS V2.1, Cisco CME 3.0, and later versions, the configuration files have been
moved to system:/its/. The file named Flash:SEPDEFAULT.cnf that was used with previous Cisco ITS
versions is now obsolete, but is retained as system:/its/SEPDEFAULT.cnf to support upgrades from older
phone firmware.
For systems using Cisco ITS V2.1 or later versions, the IP phones receive their initial configuration
information and phone firmware from the TFTP server associated with the router. In most cases, the
phones obtain the IP address of their TFTP server using the option 150 command and Dynamic Host
Configuration Protocol (DHCP). For Cisco ITS or Cisco CME operation, the TFTP server address
obtained by the Cisco Unified IP phones should point to the router IP address. The Cisco IP phones
attempt to transfer a configuration file called XmlDefault.cnf.xml. This file is automatically generated
by the router through the ip source-address command and is placed in router memory. The
XmlDefault.cnf.xml file contains the IP address that the phones use to register for service, using the
Skinny Client Control Protocol (SCCP). This IP address should correspond to a valid Cisco CME router
IP address (and may be the same as the router TFTP server address).
Similarly, when an analog telephone adapter (ATA) such as the ATA-186 is attached to the
Cisco Unified CME router, the ATA receives very basic configuration information and firmware from
the TFTP server XmlDefault.cnf.xml file. The XmlDefault.cnf.xml file is automatically generated by the
Cisco Unified CME router with the ip source-address command and is placed in the router’s flash
memory.
By specifying a second Cisco Unified CME router in the ip source-address command, you improve the
failover time for phones.
Examples The following example sets the IP source address and port:
Router(config)# telephony-service
Router(config-telephony)# ip source-address 10.6.21.4 port 2000 strict-match
The following example establishes the router at 10.5.2.78 as a secondary router:
Router(config)# telephony-service
Router(config-telephony)# ip source-address 10.0.0.1 port 2000 secondary 10.5.2.78
497
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: K
Revised: J uly 11, 2008
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.
Cisco Unified CME Commands: K
keepalive (ephone and ephone-template)
498
Cisco Unified CME Command Reference
OL-10894-01
keepalive (ephone and ephone-template)
To set the length of the time interval between successive keepalive messages from the
Cisco Unified CME router to a particular IP phone, use the keepalive command in ephone or
ephone-template configuration mode. To reset this length to the default value, use the no form of this
command.
keepalive seconds
no keepalive
Syntax Description
Defaults Default is 30 seconds
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines This command allows the keepalive interval to be set for individual phones, typically so that wireless
phone batteries are not run down too quickly by overly frequent keepalive signals.
If the router fails to receive three successive keepalive messages, it considers the phone to be out of
service until the phone reregisters.
If the keepalive (telephony-service) command and this command are set to different time intervals, the
value that you set in ephone configuration mode has priority for the particular phone only.
If you use an ephone template to apply a command to a phone and you also use the same command in
ephone configuration mode for the same phone, the value that you set in ephone configuration mode has
priority.
Examples The following example sets the keepalive interval to 300 seconds:
Router(config)# ephone 1
Router(config-ephone)# keepalive 300

seconds Interval time, in seconds. Range is from 10 to 65535. Default is 30.
Cisco IOS Release Cisco Product Modification
12.2(15)T Cisco CME 2.1 This command was introduced.
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.
Cisco Unified CME Commands: K
keepalive (ephone and ephone-template)
499
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
ephone-template
(ephone)
Applies template to ephone being configured.
keepalive
(telephony-service)
Sets the time interval for keepalive messages between IP phones and the
Cisco Unified CME router.
Cisco Unified CME Commands: K
keepalive (telephony-service)
500
Cisco Unified CME Command Reference
OL-10894-01
keepalive (telephony-service)
To set the length of the time interval between successive keepalive messages from the
Cisco CallManager Express router to IP phones, use the keepalive command in telephony-service
configuration mode. To reset this length to the default value, use the no form of this command.
keepalive seconds
no keepalive
Syntax Description
Command Default Default is 30 seconds.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines If the router fails to receive three successive keepalive messages, it considers the phone to be out of
service until the phone reregisters.
If the keepalive (telephony-service) command and the keepalive (ephone) command are set to different
time intervals, the value that you set in ephone configuration mode has priority for the particular phone
only.
Examples The following example sets the keepalive time interval to 40 seconds:
Router(config)# telephony-service
Router(config-telephony)# keepalive 40
Related Commands
seconds Interval time, in seconds. Range is from 10 to 65535. Default is 30.
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.
Command Description
keepalive (ephone) Sets the time interval for keepalive messages between a particular IP phone
and the Cisco CME router.
Cisco Unified CME Commands: K
keepalive (voice register session-server)
501
Cisco Unified CME Command Reference
OL-10894-01
keepalive (voice register session-server)
To define the duration for registrations of external feature servers after which the registration expires,
use the keepalive command in voice register session-server configuration mode. To return to the default,
use the no form of this command.
keepalive seconds
no keepalive
Syntax Description
Command Default Default is 300 seconds.
Command Modes Voice register session-server configuration (config-register-fs)
Command History
Usage Guidelines This command defines the duration for registration, in seconds, after which the registration expires
unless the feature server reregisters before the registration expiry.
Examples The following partial output shows the configuration for a session manager for an external feature server,
including a keepalive expiry of 360 seconds:
router# show running-configuration
!
!
voice register session-server 1
register-id CSR1
keepalive 360

Related Commands
seconds Duration for registration, in seconds. Range: 60 to 3600. Default: 300.
Cisco IOS Release Cisco Product Modification
12.4(11)XW2 Cisco Unified CME 4.2 This command was introduced.
12.4(15)XY Cisco Unified CME 4.2 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.4920)T.
Command Description
register id Creates an ID for explicitly identifying an external feature server during
Register requests.
Cisco Unified CME Commands: K
keep-conference
502
Cisco Unified CME Command Reference
OL-10894-01
keep-conference
To allow conference initiators to exit from conference calls and to either end or maintain the conference
for the remaining parties, use the keep-conference command in ephone or ephone-template
configuration mode. To return to the default, use the no form of this command.
keep-conference [drop-last] [endcall] [local-only]
no keep-conference
Syntax Description
Defaults A conference initiator can hang up or press the EndCall soft key to end a conference and disconnect all
parties or press the Confrn soft key to drop only the last party that was connected to the conference.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
drop-last (Optional) The action of the Confrn soft key is changed; the conference
initiator can press the Confrn soft key (IP phone) or hookflash (analog
phone) to drop the last party.
Note Analog phones connected to the Cisco Unified CME system
through a Cisco VG 224 require Cisco IOS Release 12.3(11)YL1 or
a later release to use this feature.
endcall (Optional) The action of the EndCall soft key is changed; the conference
initiator can hang up or press the EndCall soft key to leave the conference
and keep the other two parties connected.
Note If this option is not enabled, pressing the EndCall soft key
terminates the conference and disconnects all parties.
local-only (Optional) The conference initiator can hang up to end the conference and
leave the other two parties connected only if one of the remaining parties is
local to the Cisco Unified CME system (an internal extension).
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 drop-last and local-only keywords were
added, and this command was made available in
ephone-template configuration mode.
12.4(9)T Cisco Unified CME 4.0 The drop-last and local-only keywords, and this
command in ephone-template configuration mode
were integrated into Cisco IOS Release 12.4(9)T.
Cisco Unified CME Commands: K
keep-conference
503
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines
Note This feature uses call transfer to connect the two remaining parties of a conference when a conference
initiator leaves the conference. To use this feature, you must configure the transfer-system command
using the full-blind, full-consult, or full-consult dss keywords.
If you use an ephone template to apply a command to a phone and you also use the same command in
ephone configuration mode for the same phone, the value that you set in ephone configuration mode has
priority.
If the keep-conference command is configured with no keywords, a conference initiator can hang up to
leave the conference and the other two parties will remain connected. Alternatively, the conference
initiator can use the EndCall soft key to terminate the conference and disconnect all parties.
If the keep-conference command is configured with no keywords, a conference initiator can use the
Confrn soft key (IP phone) or hookflash (analog phone) to break up the conference but stay connected
to both parties. The oldest call will be put on hold, and the most recent call will be actively connected
to the initiator. The conference initiator can navigate between the two parties by pressing the Hold soft
key or the appropriate line button on the phone.
If the endcall keyword is used, the conference initiator can hang up or press the EndCall soft key to leave
the conference with the other two parties remaining connected.
In Cisco CME 3.2.3 and later versions, if the keep-conference command is not configured (the default)
or if the no keep-conference command is used, a conference initiator can drop the last party that was
added to the conference by pressing the Confrn soft key (IP phone) or hookflash (analog phone).
Note Analog phones connected to the Cisco Unified CME system through a Cisco VG 224 require Cisco IOS
Release 12.3(11)YL1 or a later release to use this feature.
Examples In the following example, extension 3555 initiates a three-way conference. After the conference is
established, extension 3555 can press the Confrn soft key to disconnect the last party that was connected
and remain connected to the first party that was connected. If extension 3555 hangs up from the
conference, the other two parties remain connected if one of them is local to the Cisco Unified CME
system.
ephone-dn 35
number 3555
ephone 24
button 1:35
keep-conference drop-last local-only

In the following example, extension 3666 initiates a three-way conference. After the conference is
established, extension 3666 can press the Confrn soft key to disconnect the last party that was connected
and remain connected to the first party that was connected. Also, extension 3666 can hang up from a
three-way conference to terminate the conference and disconnect all parties or can press the EndCall soft
key to leave the conference and keep the other two parties connected.
ephone-dn 36
number 3666
ephone 25
button 1:36
keep-conference drop-last endcall
Cisco Unified CME Commands: K
keep-conference
504
Cisco Unified CME Command Reference
OL-10894-01

In the following example, extension 3777 initiates a three-way conference. After the conference is
established, extension 3777 can press the Confrn soft key to disconnect the last party that was connected
and remain connected to the first party that was connected. Also, extension 3777 can hang up from a
three-way conference to terminate the conference and disconnect all parties or press the EndCall soft key
to leave the conference and keep the other two parties connected only if one of the two parties is local
to the Cisco Unified CME system.
ephone-dn 38
number 3777
ephone 27
button 1:38
keep-conference drop-last endcall local-only

In the following example, extension 3999 initiates a three-way conference. After the conference is
established, extension 3999 can hang up to terminate the conference and disconnect all parties or press
the EndCall soft key to leave the conference and keep the other two parties connected only if one of the
two parties is local to the Cisco Unified CME system.
ephone-dn 39
number 3999
ephone 29
button 1:39
keep-conference endcall local-only

Related Commands Command Description
ephone-template
(ephone)
Applies template to ephone being configured.
max-conferences Sets the maximum number of three-party conferences simultaneously
supported by the Cisco Unified CME router.
transfer-system Specifies the call transfer method for IP phone extensions that use the
ITU-T H.450.2 standard.
Cisco Unified CME Commands: K
keep-conference (voice register pool)
505
Cisco Unified CME Command Reference
OL-10894-01
keep-conference (voice register pool)
To allow IP phone conference initiators to exit from conference calls and keep the remaining parties
connected, use the keep-conference command in voice register pool configuration mode. To disable the
keep-conference feature, use the no form of this command.
keep-conference
no keep-conference
Syntax Description This command has no arguments or keywords.
Defaults Default is enabled.
Command Modes Voice register pool configuration (config-register-pool)
Command History
Usage Guidelines When the conference initiator hangs up, Cisco CallManager Express (Cisco CME) executes a call
transfer to connect the two remaining lines. The remaining calls are transferred without consultation. To
facilitate call transfer, the transfer-attended command or transfer-blind command must be enabled.
Conference initiators can disconnect from their conference calls by pressing the Confrn (conference) soft
key. When an initiator uses the Confrn soft key to disconnect from the conference call, the oldest call
leg is put on hold, leaving the initiator connected to the most recent call leg. The conference initiator can
then navigate between the two separate parties by pressing either the Hold soft key or the line buttons to
select the desired call.
Examples The following example shows how to configure this command, if it was previously disabled, to keep
remaining conference legs after the conference initiator hangs up.
Router(config)# voice register pool 1
Router(config-register-pool)# keep-conference
Related Commands
Cisco IOS Release Version Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Command Description
conference (voice
register template)
Enables a soft key for conference in a SIP phone template.
max-conferences Sets the maximum number of three-party conferences simultaneously
supported by the Cisco CME router.
Cisco Unified CME Commands: K
keep-conference (voice register pool)
506
Cisco Unified CME Command Reference
OL-10894-01
transfer-attended
(voice register
template)
Enables a soft key for attended transfer in a SIP phone template.
transfer-blind (voice
register template)
Enables a soft key for blind transfer in a SIP phone template.
voice register template Enters voice register template configuration mode and defines a template of
common parameters for SIP phones.
Command Description
Cisco Unified CME Commands: K
keygen-retry
507
Cisco Unified CME Command Reference
OL-10894-01
keygen-retry
To specify the number of times that a CAPF server sends a key-generation request, use the keygen-retry
command in CAPF-server configuration mode. To return to the default, use the no form of this
command.
keygen-retry number
no keygen-retry
Syntax Description
Command Default Number of retries is 3.
Command Modes CAPF-server configuration (config-capf-server)
Command History
Usage Guidelines This command is used with Cisco Unified CME phone authentication.
Examples The following example specifies that the key generation process should be tried 5 times.
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

Related Commands
number Number of retries. Range is from 0 to 100. Default is 3.
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.
Description
keygen-timeout Specifies the number of minutes that the CAPF server waits for a
key-generation response from a phone.
Cisco Unified CME Commands: K
keypad-normalize
508
Cisco Unified CME Command Reference
OL-10894-01
keypad-normalize
To impose a 200-millisecond delay before each keypad message from an IP phone, use the
keypad-normalize command in ephone or ephone-template configuration mode. To return to the
default, use the no form of this command.
keypad-normalize
no keypad-normalize
Syntax Description This command has no keywords or arguments.
Command Default Keypad messages are handled as fast as the system can handle them, without an imposed delay.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines This command normalizes the processing of incoming keypad messages from an IP phone so that one
message is processed every 200 milliseconds. This is useful for handling the personal speed dial
(fastdial) feature when the destination of the call tends to be slower in accepting the digits, or when
converting keypad messages into appropriate digit events on the network side, such as RFC 2833 digits.
If you use an ephone template to apply a command to a phone and you also use the same command in
ephone configuration mode for the same phone, the value that you set in ephone configuration mode has
priority.
Examples The following example normalizes the sending of digits from ephone 43.
ephone 43
button 1:29
keypad-normalize

Related Commands
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.
Command Description
ephone-template
(ephone)
Applies template to ephone being configured.
Cisco Unified CME Commands: K
keyphone
509
Cisco Unified CME Command Reference
OL-10894-01
keyphone
To designate a Cisco Unified IP phone as a marked or “key” phone when using the Cisco Unified CME
eXtensible Markup Language (XML) application program interface (API), use the keyphone command
in ephone or ephone-template configuration mode. To remove the keyphone designation, use the no form
of this command.
keyphone
no keyphone
Syntax Description This command has no arguments or keywords.
Defaults The phone that is being configured is not a “key” phone.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines This command is used with the XML API to mark a Cisco Unified IP phone as a “key” phone to be
tracked while using the XML API. The XML API can be instructed to report the status of only the “key”
phones in the system for network management purposes, for example.
If you use an ephone template to apply a command to a phone and you also use the same command in
ephone configuration mode for the same phone, the value that you set in ephone configuration mode has
priority.
Examples The following example sets the phone with the phone tag of 1 as a “key” phone for the XML API:
Router(config)# ephone 1
Router(config-ephone)# keyphone

Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
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.
Cisco Unified CME Commands: K
keyphone
510
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Description
ephone-template
(ephone)
Applies template to ephone being configured.
511
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: L
Revised: October 22, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified CME Commands: L
label
512
Cisco Unified CME Command Reference
OL-10894-01
label
To create a text identifier instead of a phone-number display for an extension on an IP phone console,
use the label command in ephone-dn configuration mode. To delete a label, use the no form of this
command.
label string
no label string
Syntax Description
Command Default No label is defined.
Command Modes Ephone-dn configuration (config-ephone)
Command History
Usage Guidelines One label is allowed per extension (ephone-dn). The ephone-dn must already have a number that was set
using the number command before a label can be created for it.
This command must be followed by a quick reboot of the phone on which the label appears, using the
restart command.
Examples The following example creates three phone labels to appear in place of three phone numbers on IP phone
console displays:
Router(config)# ephone-dn 10
Router(config-ephone-dn)# label user10
Router(config-ephone-dn)# exit
Router(config)# ephone-dn 20
Router(config-ephone-dn)# label user20
Router(config-ephone-dn)# exit
Router(config)# ephone-dn 30
Router(config-ephone-dn)# label user30
Router(config-ephone-dn)# exit

string Alphanumeric string of up to 30 characters.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
Cisco Unified CME Commands: L
label
513
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Description
number Associates a telephone or extension number with an ephone-dn in a
Cisco CME system.
restart (ephone) Performs a fast reboot of a single phone associated with a Cisco CME router.
restart
(telephony-service)
Performs a fast reboot of one or all phones associated with a Cisco CME
router.
Cisco Unified CME Commands: L
label (voice register dn)
514
Cisco Unified CME Command Reference
OL-10894-01
label (voice register dn)
To create a text identifier instead of a phone-number display for an extension on a SIP phone console,
use the label command in voice register dn configuration mode. To delete a label, use the no form of this
command.
label string
no label string
Syntax Description
Command Default No label is created.
Command Modes Voice register dn configuration (config-register-dn)
Command History
Usage Guidelines One label is allowed per extension (directory number). The directory number must already have a
number that was set by using the number command before a label can be created for it.
After you configure this command, restart the phone by using the reset command.
Examples The following example shows how to create three phone labels to appear in place of three phone numbers
on Cisco IP phone console displays:
Router(config)# voice register dn 10
Router(config-register-dn)# label user10
Router(config-register-dn)# exit
Router(config)# voice register dn 20
Router(config-register-dn)# label user20
Router(config-register-dn)# exit
Router(config)# voice register dn 30
Router(config-register-dn)# label user30
Router(config-register-dn)# exit

Related Commands
string Alphanumeric string of up to 30 characters.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Cisco Unified CME Commands: L
label (voice register dn)
515
Cisco Unified CME Command Reference
OL-10894-01
Description
number (voice register
dn)
Associates a telephone or extension number with a directory number in a
Cisco CME system.
reset (voice register
pool)
Performs a compete reboot of a single SIP phone associated with a
Cisco CME router.
reset (voice register
global)
Performs a complete reboot of all SIP phones associated with a Cisco CME
router.
Cisco Unified CME Commands: L
list (ephone-hunt)
516
Cisco Unified CME Command Reference
OL-10894-01
list (ephone-hunt)
To create a list of extensions that are members of a Cisco Unified CME ephone hunt group, use the list
command in ephone-hunt configuration mode. To remove a list from the router configuration, use the no
form of this command.
list number[, number...]
no list
Syntax Description
Command Default No list is defined.
Command Modes Ephone-hunt configuration (config-ephone)
Command History
Usage Guidelines Use this command to create a list of member numbers for defining a hunt group.
List must contain 1 to 20 numbers.
A number cannot be added to a list unless it was already defined by using the number command.
Add or delete all numbers in a hunt group list at one time. You cannot add or single number to an existing
list or remove one number from a list.
Any number in the list cannot be a pilot number of a parallel hunt group.
number Preconfigured extension or E.164 number.
An asterisk (*) can take the place of an extension number to represent a
wildcard slot. An agent at an authorized ephone-dn can dynamically join and
leave a hunt group if a wildcard slot is available. There can be up to 20
wildcard slots in a hunt group.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.3(11)XL Cisco CME 3.2.1 The number of ephone-dns allowed was increased
to 20.
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 The use of wildcard asterisks (*) in the dn-number
argument was introduced.
12.4(9)T Cisco Unified CME 4.0 The use of wildcard asterisks (*) in the dn-number
argument was integrated into Cisco IOS Release
12.4(9)T.
Cisco Unified CME Commands: L
list (ephone-hunt)
517
Cisco Unified CME Command Reference
OL-10894-01
To allow dynamic membership in a hunt group, use asterisks to represent wildcard slots in the list
command. To allow an ephone-dn to use one of the wildcard slots to dynamically join a hunt group, use
the ephone-hunt login command under that ephone-dn. Ephone-dns are disallowed from joining hunt
groups by default, so you have to explicitly allow this behavior for each ephone-dn that you want to be
able to log into hunt groups.
The show ephone-hunt command displays the numbers associated to ephone-dns that are joined to
groups at the time that the command is run, in addition to static members of the hunt group. Static hunt
group members are the numbers that are explicitly named in the list command.
Examples The following example creates sequential hunt group number 7, which contains four static members
(ephone-dns):
Router(config)# ephone-hunt 7 sequential
Router(config-ephone-hunt)# list 7711, 7712, 7713, 7714
The following example creates five ephone-dns and a hunt group that includes the first two ephone-dns
as static members and two wildcard slots for dynamic hunt group members. The last three ephone-dns
are enabled for dynamic membership in the hunt group. Any of them can join the hunt group whenever
one of the wildcard slots is available. Once an ephone-dn has joined a hunt group, it can leave at any
time.
ephone-dn 22
number 4566
ephone-dn 23
number 4567
ephone-dn 24
number 4568
ephone-hunt login
ephone-dn 25
number 4569
ephone-hunt login
ephone-dn 26
number 4570
ephone-hunt login
ephone-hunt 1 peer
list 4566,4567,*,*
final 7777

Related Commands Description
ephone-hunt login Allows an ephone-dn to dynamically join and leave an ephone hunt group.
final Defines the last ephone-dn in an ephone hunt group.
hops Defines the number of times that a call is redirected to the next ephone-dn in
a peer ephone-hunt-group list before proceeding to the final ephone-dn.
max-redirect Changes the current number of allowable redirects in a Cisco CME system.
no-reg (ephone-hunt) Specifies that the pilot number of this ephone hunt group should not register
with the H.323 gatekeeper.
number (ephone-dn) Associates an extension or telephone number with a directory number.
Cisco Unified CME Commands: L
list (ephone-hunt)
518
Cisco Unified CME Command Reference
OL-10894-01
pilot Defines the ephone-dn that is dialed to reach an ephone hunt group.
preference
(ephone-hunt)
Sets preference order for the ephone-dn associated with an
ephone-hunt-group pilot number.
show ephone-hunt Displays ephone-hunt group configuration, current status, and statistics.
timeout (ephone-hunt) Sets the number of seconds after which a call that is not answered is
redirected to the next number in the hunt-group list.
Description
Cisco Unified CME Commands: L
list (voice hunt-group)
519
Cisco Unified CME Command Reference
OL-10894-01
list (voice hunt-group)
To define a list of extensions that are members of a voice hunt-group, use the list command in voice
hunt-group configuration mode. To remove a list, use the no form of this command.
list number, number[, number...]
no list
Syntax Description
Command Default No hunt group list is defined.
Command Modes Voice hunt-group configuration (config-voice-hunt-group)
Command History
Usage Guidelines This command creates the list of numbers to include in a voice hunt-group. Phones with these numbers
ring when the hunt group pilot number is dialed. The numbers must be assigned to directory numbers
with the number command.
All numbers in a hunt group list are added or deleted at one time. You cannot add a number to an existing
list or remove a number from a list.
The pilot number of a parallel hunt group and shared-line numbers are not supported.
A phone number associated with an FXO port is not supported in parallel hunt groups.
Examples The following example shows how to create a sequential hunt group containing four extensions:
Router(config)# voice hunt-group 1 sequential
Router(config-voice-hunt-group)# list 7711, 7712, 7713, 7714
number Extension or E.164 number assigned to a phone in Cisco Unified CME. List
must contain 2 to 32 numbers.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
12.4(15)XZ Cisco Unified CME 4.3 The maximum numbers allowed in a list was
expanded from 10 to 32 and support for SCCP
phones was added.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: L
list (voice hunt-group)
520
Cisco Unified CME Command Reference
OL-10894-01
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 phone
number in a peer hunt-group list before proceeding to the final number.
number (ephone-dn) Associates an extension or telephone number with a directory number.
number (voice register dn) Associates an extension or telephone number with a directory number.
pilot (voice hunt-group) Defines the phone number that callers dial to reach a 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
number in the hunt group.
Cisco Unified CME Commands: L
live-record
521
Cisco Unified CME Command Reference
OL-10894-01
live-record
To define the extension number that is dialed when the LiveRcd soft key is pressed on a
Cisco Unified IP Phone, use the live-record command in telephony-service configuration mode. To
reset to the default value, use the no form of this command.
live-record phone-number
no live-record
Syntax Description
Command Default Live record is disabled.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command specifies the telephone number that is speed-dialed to access the Live Record feature
when the LiveRcd soft key on a Cisco Unified IP phone is pressed. This telephone number is used for
all Cisco Unified IP phones connected to the router.
This telephone number must match the Live Record number configured in Cisco Unity Express.
DISCLAIMER FOR RECORDING A CONVERSATION
The use of monitoring, recording, or listening devices to eavesdrop, monitor, retrieve, or record phone conversations or other sound activities, whether
or not contemporaneous with transmission, may be illegal in certain circumstances under federal, state and/or local laws. Legal advice should be
sought prior to implementing any practice that monitors or records any phone conversation. Some laws require some form of notification to all parties
to a phone conversation, such as by using a beep tone or other notification method or requiring the consent of all parties to the phone conversation,
prior to monitoring or recording the phone conversation. Some of these laws incorporate strict penalties. In cases where local laws require a periodic
beep while a conversation is being recorded, the Cisco Unity Express voice-mail system provides a user with the option of activating “the beep.” Prior
to activating the Cisco Unity Express live record function, check the laws of all applicable jurisdictions. This is not legal advice and should not take
the place of obtaining legal advice from a lawyer.
IN ADDITION TO THE GENERAL DISCLAIMER THAT ACCOMPANIES THIS CISCO PRODUCT, CISCO ADDITIONALLY DISCLAIMS
ANY AND ALL LIABILITY, BOTH CIVIL AND CRIMINAL, AND ASSUMES NO RESPONSIBILITY FOR THE UNAUTHORIZED AND/OR
ILLEGAL USE OF THIS CISCO UNITY EXPRESS PRODUCT. THIS DISCLAIMER OF LIABILITY INCLUDES, BUT IS NOT NECESSARILY
LIMITED TO, THE UNAUTHORIZED AND/OR ILLEGAL RECORDING AND MONITORING OF TELEPHONE CONVERSATIONS IN
VIOLATION OF APPLICABLE FEDERAL, STATE AND/OR LOCAL LAWS.
Examples The following example shows that the phone number 914085550100 is speed-dialed to record a call
when the LiveRcd button is pressed:
Router(config)# telephony-service
Router(config-telephony)# live-record 914085550100
phone-number Telephone number that is dialed when the LiveRcd soft key is pressed.
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 integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: L
live-record
522
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
ephone-template
(ephone)
Applies an ephone template to an ephone.
softkeys connected Modifies the order and type of soft keys that display on an IP phone during
the connected call state.
voicemail Defines the telephone number that is speed-dialed when the Messages button
is pressed on an IP phone.
Cisco Unified CME Commands: L
load (telephony-service)
523
Cisco Unified CME Command Reference
OL-10894-01
load (telephony-service)
To associate a type of Cisco Unified IP phone with a phone firmware file, use the load command in
telephony-service configuration mode. To disassociate a type of phone from a phone firmware file, use
the no form of this command.
load phone-type firmware-file
no load phone-type
Syntax Description phone-type Type of phone. The following phone types are predefined in the system:
• 7902—Cisco Unified IP Phone 7902G.
• 7905—Cisco Unified IP Phone 7905G.
• 7910—Cisco Unified IP Phone 7910 and 7910G.
• 7911—Cisco Unified IP Phone 7911G.
• 7912—Cisco Unified IP Phone 7912G.
• 7914—Cisco Unified IP Phone 7914 Expansion Module.
• 7920—Cisco Unified Wireless IP Phone 7920.
• 7921—Cisco Unified Wireless IP Phone 7921.
• 7931—Cisco Unified IP Phone 7931G.
• 7935—Cisco Unified IP Conference Station 7935.
• 7936—Cisco Unified IP Conference Station 7936.
• 7941—Cisco Unified IP Phone 7941G.
• 7941GE—Cisco Unified IP Phone 7941G-GE.
• 7942—Cisco Unified IP Phone 7942.
• 7945—Cisco Unified IP Phone 7945
• 7960-7940—Cisco Unified IP Phones 7960 and 7960G and
Cisco Unified IP Phone 7940 and 7940G.
• 7961—Cisco Unified IP Phone 7961G.
• 7961GE—Cisco Unified IP Phone 7961G-GE.
• 7962—Cisco Unified IP Phone 7962.
• 7965—Cisco Unified IP Phone 7965.
• 7970—Cisco Unified IP Phone 7970G.
• 7971—Cisco Unified IP Phone 7971G-GE.
• 7975—Cisco Unified IP Phone 7975.
• 7985—Cisco Unified IP Phone 7985.
• ata—Cisco ATA-186 and Cisco ATA-188.
Note You can also add a new phone type to your configuration by using
the ephone-type command.
Cisco Unified CME Commands: L
load (telephony-service)
524
Cisco Unified CME Command Reference
OL-10894-01
Command Default Firmware files are not associated with phone types.
Command Modes Telephony-service configuration (config-telephony)
Command History
firmware-file Filename of the IP phone firmware for a particular phone type.
• In Cisco Unified CME 7.0/4.3 and earlier versions, do not use the file
suffix (.bin, .sbin, .loads) for any phone type except the Cisco ATA and
Cisco Unified IP Phone 7905 and 7912.
• In Cisco Unified CME 7.0(1) and later versions, you must use the
complete filename, including the file suffix, for phone firmware versions
later than version 8-2-2 for all phone types.
• Filenames are case-sensitive.
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(11)YT Cisco ITS 2.1 Support was added for the Cisco IP Phone 7914
Expansion Module.
12.2(15)T Cisco ITS 2.1 This command was integrated into Cisco IOS
Release 12.2(15)T.
12.2(15)ZJ Cisco CME 3.0 The following keywords were added to this
command: 7902, 7905, and 7912.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.3(7)T Cisco CME 3.1 The 7920 and 7936 keywords were added.
12.3(11)XL Cisco CME 3.2.1 The 7970 keyword was added.
12.3(14)T Cisco CME 3.3 The 7971 keyword was added, and this command
was integrated into Cisco IOS Release 12.3(14)T.
12.4(4)XC Cisco Unified CME 4.0 The 7911, 7941, 7941GE, 7961, and 7961GE
keywords were added.
12.4(9)T Cisco Unified CME 4.0 This command was integrated into Cisco IOS
Release 12.4(9)T.
12.4(6)XE Cisco Unified CME 4.0(2) The 7931 keyword was added.
12.4(4)XC4 Cisco Unified CME 4.0(3) The 7931 keyword was added.
12.4(11)T Cisco Unified CME 4.0(3) This command was integrated into
Cisco IOS Release 12.3(11)T.
12.4(11)XJ2 Cisco Unified CME 4.1 The 7921 and 7985 keywords were introduced.
12.4(15)T Cisco Unified CME 4.1 This command was integrated into Cisco IOS
Release 12.4(15)T.
12.4(15)T1 Cisco Unified CME 4.1(1) The 7942, 7945, 7962, 7965, and 7975 keywords
were introduced.
Cisco Unified CME Commands: L
load (telephony-service)
525
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines This command updates the Cisco Unified CME configuration file for the specified type of Cisco Unified
IP phone to add the name of the firmware file to be loaded by a particular phone type. The firmware
filename also provides the version number for the phone firmware that is in the file. When a phone is
started up or rebooted, the phone reads the configuration file to determine which firmware file it must
load and then looks for that firmware file on the TFTP server.
If applicable, Cisco Unified IP phones update themselves with new phone firmware whenever they are
started up or rebooted.
A separate load command is needed for each type of phone. The Cisco Unified IP Phones 7940 and
7940G and the Cisco Unified IP Phones 7960 and 7960G have the same phone firmware and share the
7960-7940 keyword.
Before Cisco Unified CME 7.0(1):
• Do not include the file suffix (.bin, .sbin, .loads) for any phone type except Cisco ATA and
Cisco Unified IP Phone 7905 and 7912 when you configure the load command in telephony-service
configuration mode. For example:
Router(config-telephony)# load 7941 SCCP41.8-2-2SR2S
Router(config-telephony)#
• You must also configure the tftp-server command to enable TFTP access to the firmware files by
Cisco Unified IP phones.
In Cisco Unified CME 7.0(1) and later versions:
• You must use the complete filename, including the file suffix, when you configure the load
command for phone firmware versions later than version 8-2-2 for all phone types. For example:
Router(config-telephony)# load 7941 SCCP41.8-3-3S.loads
Router(config-telephony)#
• The load command is enhanced to automatically create TFTP bindings for phone firmware files if
the cnf-location command is configured with the flash or slot0 argument. You are no longer required
to configure the tftp-server command to create TFTP bindings only if the location of the cnf files
is router flash or slot 0 memory. If the cnf-location command is configured for something other than
flash or slot 0, such as a TFTP server (url) or system memory (system:its/), you still must configure
the tftp-server command to create TFTP bindings for phone firmware files. Use the complete
filename, including the file suffix, when you configure the tftp-server command for phone firmware
versions later than version 8-2-2 for all phone types.
To verify TFTP bindings, including the dictionary, language, and tone configuration files that are
associated with the ISO-3166 codes that have been selected, use the show telephony-service
tftp-bindings command.
12.4(15)XZ Cisco Unified CME 4.3 Support for user-defined phone types created with
the ephone-type command was added.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
12.4(20)YA Cisco Unified CME 7.0(1) Support for automatically creating bindings for
firmware files only if the cnf-file location is flash
or slot0 was added.
12.4(20)T1 Cisco Unified CME 7.0 The 7925 keyword was introduced.
12.4(22)T Cisco Unified CME 7.0(1) This command was integrated into
Cisco IOS Release 12.4(22)T.
Cisco IOS Release Cisco Product Modification
Cisco Unified CME Commands: L
load (telephony-service)
526
Cisco Unified CME Command Reference
OL-10894-01
After associating a firmware files with a Cisco Unified IP phones, use the reset command to reboot the
phones.
Examples Cisco Unified CME 7.0and Earlier Versions
The following example shows how to identify the Cisco Unified IP phone firmware file to be used by the
Cisco Unified IP Phones 7960 and 7960G and Cisco Unified IP Phone 7910G.
Router(config)# telephony-service
Router(config-telephony)# load 7960-7940 P00303020209
Router(config-telephony)# load 7910 P00403020209
Router(config-telephony)# exit
Router(config)# tftp-server flash:P00303020209.bin
Router(config)# tftp-server flash:P00403020209.bin
Related Commands Command Description
cnf-location Specifies a storage location for phone configuration files.
ephone-type Adds a Cisco Unified IP phone type by defining a phone-type
template.
reset Resets a Cisco Unified IP phone.
show telephony-service
tftp-bindings
Provides a list of configuration files that are accessible to IP phones
using TFTP.
tftp-server Enables TFTP access to firmware files on the TFTP server.
Cisco Unified CME Commands: L
load (voice register global)
527
Cisco Unified CME Command Reference
OL-10894-01
load (voice register global)
To associate a type of IP phone with a phone firmware file, use the load command in voice register global
configuration mode. To disassociate a type of phone from a phone firmware file, use the no form of this
command.
load phone-type firmware-file
no load phone-type
Syntax Description
Command Default The firmware file is not associated with the type of phone.
Command Modes Voice register global configuration (config-register-global)
phone-type Type of IP phone. The following choices are valid:
• 3951—Cisco Unified IP Phone 3911 and 3951.
• 7905—Cisco Unified IP Phone 7905 and 7905G.
• 7906—Cisco Unified IP Phone 7906G.
• 7911—Cisco Unified IP Phone 7911G.
• 7912—Cisco Unified IP Phone 7912 and 7912G.
• 7941—Cisco Unified IP Phone 7941G.
• 7941GE—Cisco Unified IP Phone 7941GE.
• 7942—Cisco Unified IP Phone 7942.
• 7945—Cisco Unified IP Phone 7945.
• 7960–7940—Cisco Unified IP Phone 7940 and 7940G and Cisco IP Phones 7960
and 7960G.
• 7961—Cisco Unified IP Phone 7961G.
• 7961GE—Cisco Unified IP Phone 7961GE.
• 7962—Cisco Unified IP Phone 7962.
• 7965—Cisco Unified IP Phone 7965.
• 7970—Cisco Unified IP Phone 7970G.
• 7971—Cisco Unified IP Phone 7971GE.
• 7975—Cisco Unified IP Phone 7975.
• ATA—Cisco ATA-186 and Cisco ATA-188.
firmware-file Filename for the Cisco Unified IP phone firmware to be associated with the IP phone
type. Do not use the .bin or .load file extension, except for the Cisco Unified IP phone
7905, 7912, or ATA. Filenames are case sensitive.
Cisco Unified CME Commands: L
load (voice register global)
528
Cisco Unified CME Command Reference
OL-10894-01
Command History
Usage Guidelines This command updates the Cisco Unified CME configuration file for the specified type of IP phone to
add the name of the correct firmware file that the phone should load. This filename also provides the
version number for the phone firmware that is in the file. Later, whenever a phone is started up or
rebooted, the phone reads the configuration file to determine the name of the firmware file that it should
load and then looks for that firmware file on the TFTP server.
A separate load command is needed for each type of phone. The Cisco Unified IP Phone 7940 and
7940G and Cisco Unified IP Phone 7960 and 7960G have the same phone firmware and share the
7960-7940 keyword. The Cisco Unified IP Phone 3911 and Cisco Unified IP Phone 3951 have the same
phone firmware and share the 3951 keyword.
For certain IP phones, such as the Cisco Unified IP Phone 7906G, 7911G, 7941G, 7941GE, 7961G,
7961GE, 7970G, and 7971G, there are multiple firmware files. For these phones, use the
TERMnn.x-y-x-w.loads or SIPnn.x-y-x-w.loads firmware filename for the load command, without the
.loads file extension. For these phones, you do not configure the load command for any firmware file
other than the TERM.loads or SIP.loads firmware file.
Following the load command, use the tftp-server command to enable TFTP access to the file by
Cisco Unified IP phones. The file extension is required when using the tftp-server command.
The load command must be followed by a reboot of the phones. Plug in a new IP phone or use the reset
command to reboot an IP phone that is already connected to the Cisco router.
Examples The following example shows how to configure the load command to indicate which phone firmware is
to be used by a Cisco Unified IP Phone 7960 and 7960G, a Cisco Unified IP Phone 7912 and 7912G, and
a Cisco Unified IP Phone 7941GEs. The tftp-server command is used to specify the location of the
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
12.4(11)XJ Cisco Unified CME 4.1 The 3951, 7911, 7941, 7941GE, 7961, 7961GE,
7970 and 7971 keywords were added.
12.4(15)T Cisco Unified CME 4.1 The 3951, 7911, 7941, 7941GE, 7961, 7961GE,
7970, and 7971 keywords were integrated into
Cisco IOS Software Release 12.4(15)T.
12.4(15)XZ Cisco Unified CME 4.3 The 7942, 7945, 7962, 7965, and 7975 keywords
were added.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into Cisco IOS
Release 12.4(20)T.
Cisco Unified CME Commands: L
load (voice register global)
529
Cisco Unified CME Command Reference
OL-10894-01
phone firmware files, including all firmware files for the Java-based Cisco Unified IP Phone 7941GE.
Note that while no file extension is used with the load command, the file extension is required when
using the tftp-server command.
Router(config)# voice register global
Router(config-register-global)# load 7960-7940 P00303020209
Router(config-register-global)# load 7912 P00403020209
Router(config-register-global)# load 7941 TERM41.7-0-3-0S
Router(config-register-global)# exit
Router(config)# tftp-server flash:P00303020209.bin
Router(config)# tftp-server flash:P00403020209.bin
Router(config)# tftp-server flash:SIP41.8-0-3-0S.loads
Router(config)# tftp-server flash:term61.default.loadsterm
Router(config)# tftp-server flash:41.default.loads
Router(config)# tftp-server flash:CVM41.2-0-2-26.sbn
Router(config)# tftp-server flash:cnu41.2-7-6-26.sbn
Router(config)# tftp-server flash:Jar41.2-9-2-26.sbn

Related Commands Command Description
reset (voice register global) Performs a complete reboot of all SIP phones associated with a
Cisco Unified CME router.
show voice register global Displays all global configuration parameters associated with SIP
phones.
tftp-server Enables TFTP access to firmware files on the TFTP server.
type (voice register pool) Defines a phone type for a SIP phone.
Cisco Unified CME Commands: L
load-cfg-file
530
Cisco Unified CME Command Reference
OL-10894-01
load-cfg-file
To load configuration files on the TFTP server and to sign configuration files that are not created by
Cisco Unified CME, use the load-cfg-file command in telephony-service configuration mode. To return
to the default, use the no form of this command.
load-cfg-file file-url alias file-alias [sign] [create]
no load-cfg-file file-url alias file-alias
Syntax Description
Command Default A file is not loaded on the TFTP server.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command is used with Cisco Unified CME phone authentication to sign configuration files that are
not created by Cisco Unified CME. This command also loads the signed and unsigned versions of the
file on the TFTP server. To simply serve an already signed file on the TFTP server, use this command
without the sign and create keywords.
The create keyword should be used with the sign keyword the first time that this command is used for
each file. The create keyword is not maintained in the running configuration; this command prevents
signed files from being recreated during every reload.
Examples The following example creates a file called ringlist.xml.sgn in slot0 and serves both ringlist.xml and
ringlist.xml.sgn on the TFTP server.
telephony-service
load-cfg-file slot0:Ringlist.xml alias Ringlist.xml sign create
The following example serves P00307010200.sbn on the TFTP server without creating a signed file.
telephony-service
load-cfg-file slot0:P00307010200.sbn alias P00307010200.sbn
file-url Complete path of a configuration file in a local directory.
alias file-alias Name of the file on the TFTP server.
sign Signs the file and serves it on the TFTP server.
create Creates the signed file in the local directory.
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.
Cisco Unified CME Commands: L
loc2
531
Cisco Unified CME Command Reference
OL-10894-01
loc2
To specify the audio file used for the loss of C2 features announcement, use the loc2 command in voice
MLPP configuration mode. To disable use of this audio file, use the no form of this command.
loc2 audio-url
no loc2
Syntax Description
Command Default No announcement is played.
Command Modes Voice MLPP configuration (config-voice-mlpp)
Command History
Usage Guidelines This command specifies the G.711 a-law or u-law 8-KHz encoded audio file (.wav or .au format) for the
announcement that plays to callers when the call leaves the Cisco Unified CME router on the trunk or
when the user places a call to a different domain.
The mlpp indication command must be enabled (default) for a phone to play precedence
announcements.
This command is not supported by Cisco IOS help. If you type ?, Cisco IOS help does not display a list
of valid entries.
Examples The following example shows that the audio file played for the isolated code announcement is named
ica.au located in flash:
Router(config)# voice mlpp
Router(config-voice-mlpp)# loc2 flash:loc2.au
Related Commands
audio-url Location of the announcement audio file in URL format. Valid storage
locations are TFTP, FTP, HTTP, and flash memory.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Command Description
bnea Specifies the audio file used for the busy station not equipped for
preemption announcement.
upa Specifies the audio file used for the unauthorized precedence
announcement.
vca Specifies the audio file used for the vacant code announcement.
Cisco Unified CME Commands: L
loc2
532
Cisco Unified CME Command Reference
OL-10894-01
mlpp indication Enables MLPP indication on an SCCP phone or analog FXS port.
mlpp preemption Enables preemption capability on an SCCP phone or analog FXS port.
Command Description
Cisco Unified CME Commands: L
location (voice emergency response zone)
533
Cisco Unified CME Command Reference
OL-10894-01
location (voice emergency response zone)
To include a location within an emergency response zone, use the location command in voice emergency
response zone mode. To assign specific priorites to the locations, use the priority tag. To remove the
location, use the no form of this command.
location location-tag [priority <1-100>]
no location location-tag
Syntax Description
Command Modes Voice emergency response zone configuration (cfg-emrgncy-resp-zone)
Command History
Usage Guidelines Use this command to create locations within emergency response zones. The tag must be the same as the
tag that is defined using the voice emergency response location command. This allows routing of 911
calls to different PSAPs. Priority is optional and allows searching locations in a specified priority order.
If there are locations with assigned priorities and locations configured without priorities, the prioritized
locations are searched before those without an assigned priority.
Examples The following example shows an assignment of ERLs to two zones, 10 and 11, to route callers to two
different PSAPs. The locations for ERLs in zone 10 are searched in sequential order for a phone address
match. The calls from zone 10 have an ELIN from ERLs 8, 9, and 10. The calls from zone 11 have an
ELIN from ERLs 2, 3, 4, and 5. The locations for ERLs in zone 11 have priorities assigned and is
searched in order of the assigned priority and not the ERL tag number.
voice emergency response zone 10
location 8
location 9
location 10
voice emergency response zone 11
location 5 priority 1
location 3 priority 2
location 4 priority 3
location 2 priority 10
location-tag Identifier for the emergency response zone location.
priority 1-100 Identifier (1-100) for the priority ranking of locations, 1 being the highest priority.
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.
Cisco Unified CME Commands: L
location (voice emergency response zone)
534
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
emergency response
callback
Defines a dial peer that is used for 911 callbacks from the PSAP.
emergency response
location
Associates an ERL to either a SIP phone, ephone, or dial peer.
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.
Cisco Unified CME Commands: L
log password
535
Cisco Unified CME Command Reference
OL-10894-01
log password
Effective with Cisco Unified CME 4.0, the log password command was replaced by the xml user
command in telephony-service configuration mode. See the xml user command for more information.
For Cisco CME 3.4 and earlier versions, to set a local password for an eXtensible Markup Language
(XML) Application Programming Interface (API) query, use the log password command in
telephony-service configuration mode. To remove the password definition, use the no form of this
command.
log password password-string
no log password password-string
Syntax Description
Command Default No password is defined.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines The local password is used to authenticate XML API requests on the network management server. If the
password is not set, an XML API query fails local authentication.
The password string is stored as plain text. No encryption is supported.
Examples The following example defines a local password for XML API requests:
Router(config)# telephony-service
Router(config-telephony)# log password ewvpil
password-string Character string that is a password for XML API queries. Maximum length
is 28 characters. Longer strings are truncated.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.4(4)XC Cisco Unified CME 4.0 This command was replaced by the xml user
command.
12.4(9)T Cisco Unified CME 4.0 This command was replaced by the xml user
command.
Cisco Unified CME Commands: L
log table
536
Cisco Unified CME Command Reference
OL-10894-01
log table
To set parameters for the table used to capture phone events used for the eXtensible Markup Language
(XML) Application Programming Interface (API), use the log table command in telephony-service
configuration mode. To reset parameters to their default values, use the no form of this command.
log table {max-size entries | retain-timer minutes}
no log table {max-size | retain-timer}
Syntax Description
Command Default Default number of entries in table is 150.
default number of minutes to retain entries in table is 15.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines Cisco Unified CME captures and time-stamps events, such as phones registering and unregistering and
extension status, and stores them in an internal buffer. This command sets the maximum number of
events, or entries, that can be stored in the table. One event equals one entry. The retain-timer keyword
sets the number of minutes that events are kept in the buffer before they are deleted.
The event table can be viewed using the show fb-its-log command.
Examples The following example sets the maximum size of the table at 750 events and sets the retention time at
30 minutes:
Router(config)# telephony-service
Router(config-telephony)# log table max-size 750
Router(config-telephony)# log table retain-timer 30

Related Commands
max-size entries Number of entries in the log table. Range is from 0 to 1000. Default is 150.
retain-timer minutes Number of minutes to retain entries in the log table. Range is from 2 to 500.
Default is 15.
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
Description
show fb-its-log Displays information about the Cisco CME XML API configuration,
statistics on XML API queries, and event logs.
Cisco Unified CME Commands: L
logging (voice emergency response settings)
537
Cisco Unified CME Command Reference
OL-10894-01
logging (voice emergency response settings)
To enable sylog messages to capture emergency call data, use the logging command in voice emergency
response settings configuration mode. To disable logging, use the no form of this command.
logging
no logging
Syntax Description This command has no arguments or keywords.
Command Default This command is enabled by default.
Command Modes Voice emergency response settings configuration (cfg-emrgncy-resp-settings)
Command History
Usage Guidelines Use this command to enable syslog messages to be announced for every 911 emergency call that is made.
The syslog messages can be used by third party applications to send pager or e-mail notifications to an
in-house support number. This optional command is enabled by default.
Examples In this example, the ELIN (4085550101) defined in the voice emergency response settings configuration
is used if the 911 caller’s IP phones address does not match any of the voice emergency response
locations. After the 911 call is placed to the PSAP, the PSAP has 120 minutes to call back 408 555-0101
to reach the 911 caller. If the call history has expired (after 120 minutes), any callback is routed to
extension 7500. The outbound 911 calls do not emit a syslog message to the logging facility (for
example, a local buffer, console, or remote host).
voice emergency response settings
callback 7500
elin 4085550101
expiry 120
no logging
Related Commands
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.
Cisco Unified CME Commands: L
logging (voice emergency response settings)
538
Cisco Unified CME Command Reference
OL-10894-01
Command Description
callback Default phone number to contact if a 911 callback cannot find the last 911
caller from the ERL.
elin E.164 number used as the default ELIN if no matching ERL to the 911
caller’s IP phone address is found.
expiry Number of minutes a 911 call is associated with an ELIN in case of a
callback from the 911 operator.
voice emergency
response settings
Creates a tag for identifying settings for E911 behavior.
Cisco Unified CME Commands: L
login (telephony-service)
539
Cisco Unified CME Command Reference
OL-10894-01
login (telephony-service)
To define the timer for automatically deactivating user login on SCCP phones in a Cisco Unified CME
system, use the login command in telephony-service configuration mode. To revert to the default values
for automatic logout, use the no form of this command.
login [timeout [minutes]] [clear time]
no login
Syntax Description
Command Default User login is deactivated after a phone is idle for 60 minutes.
User login for all phones is deactivated at 24:00.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines This command defines the after-hours login timer. Individual users on specified phones can override call
blocking by logging in using a personal identification number (PIN). The after-hours login timer
deactivates user login on all phones at a specific time and deactivates a login session automatically after
a phone is idle for a specified period of time.
The login command applies only to IP phones that have soft keys, such as the Cisco Unified
IP Phone 7940 and 7940G and the Cisco Unified IP Phone 7960 and 7960G.
For this command to take effect, fast reboot and reregister all phones in Cisco Unified CME by using the
restart all command in telephony-service configuration mode.
When a Cisco Unified CME router is rebooted, the login status for all phones is reset to the default.
timeout (Optional) Period of phone idleness after which user login is deactivated.
minutes (Optional) Number of minutes for which an IP phone can be idle before the
user is logged out automatically. Range: 1 to 1440. Default: 60.
clear time (Optional) Time of day after which user login for all IP phones is
deactivated. Range: 00:00 to 24:00 on a 24-hour clock. Default: 24:00
(midnight).
Cisco IOS Release Cisco Product Modification
12.2(15)ZJ Cisco CME 3.0 This command was introduced.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
12.4(11)XJ2 Cisco Unified CME 4.1 Minimum value for the minutes argument was
lowered from 5 minutes to 1 minute.
12.4(15)T Cisco Unified CME 4.1 This command with the modifications was
integrated into Cisco IOS Release 12.4(15)T.
Cisco Unified CME Commands: L
login (telephony-service)
540
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example sets the after-hours login timer to deactivate logged in phone users automatically
after a 2-hour idle time and after 11:30 p.m.
Router(config)# telephony-service
Router(config-telephony)# login timeout 120 clear 2330

Related Commands Description
after-hour exempt Specifies that an IP phone does not have any of its outgoing calls blocked
even though call blocking has been defined.
after-hours block
pattern
Defines a pattern of digits for blocking outgoing calls from IP phones.
after-hours date Defines a recurring period based on date during which outgoing calls that
match defined block patterns are blocked on IP phones.
after-hours day Defines a recurring period based on day of the week during which outgoing
calls that match defined block patterns are blocked on IP phones.
pin Sets a global/individual PIN for phone users to deactivate call blocking
during call blocking periods.
restart
(telephony-service)
Performs a fast reboot of one or all phones associated with a Cisco Unified
CME router.
show ephone login Displays the login states of all phones.
Cisco Unified CME Commands: L
logo (voice register global)
541
Cisco Unified CME Command Reference
OL-10894-01
logo (voice register global)
To specify a file to display on SIP phones, use the logo command in voice register global configuration
mode. To disable the display of the file, use the no form of this command.
logo url
no logo
Syntax Description
Command Default No file is specified for display on idle phones.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines Use this command to define the URL for the file to be used by SIP phones connected in
Cisco Unified CME. The file that is displayed must be encoded in eXtensible Markup Language (XML)
by using the Cisco XML document type definition (DTD). For more information about Cisco DTD
formats, see the Cisco IP Phone Services Application Development Notes.
After you configure this command, restart the phones by using the reset command.
Examples The following example shows how to specify that the file logo.xml should be displayed on SIP phones:
Router(config)# voice register global
Router(config-register-global)# logo http://mycompany.com/files/logo.xml

Related Commands
url URL as defined in RFC 2396.
Cisco IOS Release Version Modification
12.4(4)T Cisco CME 3.4 This command was introduced.
Description
reset (voice register
pool)
Performs a complete reboot of one phone associated with a Cisco CME
router.
reset (voice register
global)
Performs a complete reboot of one or all phones associated with a
Cisco CME router.
Cisco Unified CME Commands: L
logout-profile
542
Cisco Unified CME Command Reference
OL-10894-01
logout-profile
To enable an IP phone for extension mobility and to apply a default logout profile to the phone, use the
logout-profile command in ephone configuration mode. To disable extension mobility, use the no form
of this command.
logout-profile profile-tag
no logout-profile profile-tag
Syntax Description
Command Default IP phone is not enabled for extension mobility.
Command Modes Ephone configuration (config-ephone)
Command History
Usage Guidelines Use this command in ephone configuration mode to enable a supported IP phone registered in
Cisco Unified CME for extension mobility and to apply a default logout profile to the ephone being
configured.
In Cisco Unified CME 4.2, extension mobility is supported only on SCCP IP phones.
Extension mobility is not supported on non-display IP phones.
Extension mobility is not supported for analog devices.
Before using this command, you must create a logout profile to be applied to this phone by using the
voice logout-profile command.
You cannot apply more than one logout profile to an ephone. If you attempt to apply a second logout
profile to an ephone to which a profile has already been applied, the second profile will overwrite the
first logout profile configuration.
profile-tag Unique identifier for a default logout profile to be applied. Previously
created by using the voice logout-profile command in voice logout-profile
configuration mode. Range: 1 to maximum number of phones supported by
platform.
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 is integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: L
logout-profile
543
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows the ephone configuration for three different Cisco Unified IP phones. All
three phones are enabled for extension mobility and share the same logout profile number (1), to be
downloaded when these phones boot and when no phone user is logged into these phones:
ephone 1
mac-address 000D.EDAB.3566
type 7960
logout-profile 1
ephone 2
mac-address 0012.DA8A.C43D
type 7970
logout-profile 1
ephone 3
mac-address 1200.80FC.9B01
type 7911
logout-profile 1

Related Commands Command Description
reset (voice
logout-profile and
voice user-profile)
Performs a complete reboot of all IP phones to which a particular
logout-profile or user-profile is downloaded.
voice logout-profile Enters voice profile configuration mode to configure a default logout profile
for extension mobility.
Cisco Unified CME Commands: L
loopback-dn
544
Cisco Unified CME Command Reference
OL-10894-01
loopback-dn
To create a virtual loopback voice port (loopback-dn) to establish a demarcation point for VoIP calls and
supplementary services, use the loopback-dn command in ephone-dn configuration mode. To delete a
loopback-dn configuration, use the no form of this command.
loopback-dn dn-tag [forward number-of-digits | strip number-of-digits] [prefix prefix-digit-string]
[suffix suffix-digit-string] [retry seconds] [auto-con] [codec {g711alaw | g711ulaw}]
no loopback-dn
Syntax Description
Command Default All calls are set to forward all digits and not to strip any digits.
Prefix is not defined.
Suffix is not defined.
Retry is disabled.
dn-tag Unique sequence number that identifies the ephone-dn that is being paired
for loopback with the ephone-dn that is currently being configured. The
paired ephone-dn must be one that is already defined in the system.
forward
number-of-digits
(Optional) Number of digits in the original called number to forward to the
other ephone-dn in the loopback-dn pair. Range is from 1 to 32 digits.
Default is to forward all digits.
strip number-of-digits (Optional) Number of leading digits to be stripped from the original called
number before forwarding to the other ephone-dn in the loopback-dn pair.
Range is from 1 to 32 digits. Default is not to A-law strip any digits.
prefix
prefix-digit-string
(Optional) Defines a string of digits to add in front of the forwarded called
number. Maximum number of digits in the string is 32. Default is that no
prefix is defined.
suffix suffix-digit-string (Optional) Defines a string of digits to add to the end of the forwarded called
number. Maximum number of digits in the string is 32. Default is that no
suffix is defined. If you add a suffix that starts with the pound character (#),
the string must be enclosed in quotation marks.
retry seconds (Optional) Number of seconds to wait before retrying the loopback target
when it is busy or unavailable. Range is from 0 to 32767. Default is that retry
is disabled and appropriate call-progress tones are passed to the call
originator.
auto-con (Optional) Immediately connects the call and provides in-band alerting
while waiting for the far-end destination to answer. Default is that automatic
connection is disabled.
codec (Optional) Explicitly forces the G.711 A-law or G.711 mu-law voice coding
type to be used for calls that pass through the loopback-dn. This overrides
the G.711 coding type that is negotiated for the call and provides mu-law to
A-law conversion if needed. Default is that Real-Time Transport Protocol
(RTP) voice packets are passed through the loopback-dn without considering
the G.711 coding type negotiated for the calls.
g711alaw G.711 A-law, 64000 bits per second, for T1.
g711ulaw G.711 mu-law, 64000 bits per second, for E1.
Cisco Unified CME Commands: L
loopback-dn
545
Cisco Unified CME Command Reference
OL-10894-01
Automatic connection is disabled.
RTP voice packets are passed through the loopback-dn without considering the G.711 coding type
negotiated for the call.
Command Modes Ephone-dn configuration (config-ephone-dn)
Command History
Usage Guidelines The loopback-dn command is used to configure two ephone-dn virtual voice ports as
back-to-back-connected voice-port pairs. A call presented on one side of the loopback-dn pair is
reoriginated as a new call on the opposite side of the loopback-dn pair. The forward, strip, prefix, and
suffix keywords can be used to manipulate the original called number that is presented to the incoming
side of the loopback-dn pair to generate a modified called number to use when reoriginating the call at
the opposite side of the loopback-dn pair. For loopback-dn configurations, you must always configure
ephone-dn virtual voice ports as cross-coupled pairs.
Note Use of loopback-dn configurations within a VoIP network should be restricted to resolving critical
network interoperability service problems that cannot otherwise be solved. Loopback-dn configurations
are intended to be used in VoIP network interworking situations in which the only other alternative would
be to make use of back-to-back-connected physical voice ports. Loopback-dn configurations emulate the
effect of a back-to-back physical voice-port arrangement without the expense of the physical voice-port
hardware. A disadvantage of loopback-dn configurations is that, because digital signal processors
(DSPs) are not involved in a loopback-dn arrangement, the configuration does not support interworking
or transcoding between calls that use different voice codecs. In many cases, the use of back-to-back
physical voice ports that do use DSPs to resolve VoIP network interworking issues is preferred, because
it introduces fewer restrictions in terms of supported codecs and call flows. Also, loopback-dns do not
support T.38 fax relay.
Note We recommend that you create the basic ephone-dn configuration for both ephone-dn entries before
configuring the loopback-dn option under each ephone-dn. The loopback-dn mechanism should be used
only in situations where the voice call parameters for the calls on either side of the loopback-dn use
compatible configurations; for example, compatible voice codec and dual tone multifrequency (DTMF)
relay parameters. Loopback-dn configurations should be used only for G.711 voice calls.
Cisco IOS Release Cisco Product Modification
12.2(2)XT Cisco ITS 2.0 This command was introduced.
12.2(2)XT3 Cisco ITS 2.0 The suffix keyword was added.
12.2(8)T Cisco ITS 2.0 This command was integrated into Cisco IOS
Release 12.2(8)T and the auto-con keyword was
added.
12.2(11)T Cisco ITS 2.01 The suffix keyword was added.
12.2(11)YT Cisco ITS 2.1 The strip keyword was added.
12.2(11)YT2 Cisco ITS 2.1 The codec keyword was added.
12.2(15)T Cisco ITS 2.1 This command was integrated into Cisco IOS
Release 12.2(15)T.
Cisco Unified CME Commands: L
loopback-dn
546
Cisco Unified CME Command Reference
OL-10894-01
The loopback-dn arrangement allows an incoming telephone call to be terminated on one side of the
loopback-dn port pair and a new pass-through outgoing call to be originated on the other side of the
loopback-dn port pair. The loopback-dn port pair normally works with direct cross-coupling of their call
states; the alerting call state on the outbound call segment is associated with the ringing state on the
inbound call segment.
The loopback-dn mechanism allows for call operations (such as call transfer and call forward) that are
invoked for the call segment on one side of the loopback-dn port pair to be isolated from the call segment
that is present on the opposite side of the loopback-dn port pair. This approach is useful when the
endpoint devices associated with the two different sides have mismatched call-transfer and
call-forwarding capabilities. The loopback-dn arrangement allows for call-transfer and call-forward
requests to be serviced on one side of the loopback-dn port pair by creating hairpin-routed calls when
necessary. The loopback-dn arrangement avoids the propagation of call-transfer and call-forward
requests to endpoint devices that do not support these functions.
The loopback-dn command provides options for controlling the called-number digits that are passed
through from the incoming side to the outgoing side. The available digits can be manipulated with the
forward, strip, prefix, and suffix keywords.
The forward keyword defines the number of digits in the original called number to forward to the other
ephone-dn in the loopback-dn pair. The default is set to forward all digits. The strip keyword defines the
number of leading digits to be stripped from the original called number before forwarding to the other
ephone-dn in the loopback-dn pair. The default is set to not strip any digits. The forward and strip
commands are mutually exclusive and can be used with any combination of the prefix and suffix
keywords.
The prefix keyword defines a string of digits to add in front of the forwarded number.
The suffix keyword is most commonly used to add a terminating “#” (pound-sign) character to the end
of the forwarded number to indicate that no more digits should be expected. The pound-sign character
indicates to the call-routing mechanism that is processing the forwarded number that the forwarded
number is complete. Providing an explicit end-of-number character also avoids a situation in which the
call-processing mechanism waits for the interdigit timeout period to expire before routing the call
onward using the forwarded number.
Note The Cisco IOS -line interface (CLI) requires that arguments with character strings that start with the
pound-sign (#) character be enclosed within quotation marks; for example, “#”.
The retry keyword is used to suppress a far-end busy indication on the outbound call segment. Instead
of returning a busy signal to the call originator (on the incoming call segment), a loopback-dn presents
an alerting or ringing tone to the caller and then periodically retries the call to the final far-end
destination (on the outgoing call segment). This is not bidirectional. To prevent calls from being routed
into the idle outgoing side of the loopback-dn port pair during the idle interval that occurs between
successive outgoing call attempts, configure the outgoing side of the loopback-dn without a number so
that there is no number to match for the inbound call.
The auto-con keyword is used to configure a premature trigger for a connected state for an incoming
call segment while the outgoing call segment is still in the alerting state. This setup forces the voice path
to open for the incoming call segment and support the generation of in-band call progress tones for busy,
alerting, or ringback. The disadvantage of the auto-con keyword is premature opening of the voice path
during the alerting stage and also triggering of the beginning of billing for the call before the call has
been answered by the far end. These disadvantages should be considered carefully before you use the
auto-con keyword.
Cisco Unified CME Commands: L
loopback-dn
547
Cisco Unified CME Command Reference
OL-10894-01
The codec keyword is used to explicitly select the A-law or mu-law type of G.711 and to provide A-law
to mu-law conversion if needed. Setting the codec type on one side of the loopback-dn forces the
selection of A-law or mu-law for voice packets that are transmitted from that side of the loopback-dn.
To force the A-law or mu-law G.711 codec type for both voice packet directions, set the codec type on
both sides of the loopback-dn. Loopback-dn configurations are used only with G.711 calls. Other voice
codec types are not supported.
Examples The following example creates a loopback-dn configured with the forward and prefix keywords:
Router(config)# ephone-dn 7
Router(config-ephone-dn)# loopback-dn 15 forward 5 prefix 41
The following example creates a loopback-dn that appends the pound-sign (#) character to forwarded
numbers to indicate the end of the numbers:
Router(config)# ephone-dn 7
Router(config-ephone-dn)# loopback-dn 16 suffix “#”
The following example shows a loopback-dn configuration that pairs ephone-dns 15 and 16. An
incoming call (for example, from VoIP) to 4085550101 matches ephone-dn 16. The call is then
reoriginated from ephone-dn 15 and sent to extension 50101. Another incoming call (for example, from
a local IP phone) to extension 50151 matches ephone-dn 15. It is reoriginated from ephone-dn 16 and
sent to 4085550151.
ephone-dn 15
number 5015.
loopback-dn 16 forward 5 prefix 40855
caller-id local
no huntstop
!
ephone-dn 16
number 408555010.
loopback-dn 15 forward 5
caller-id local
no huntstop
Related Commands Description
ephone-dn Enters ephone-dn configuration mode.
show ephone-dn
loopback
Displays information about loopback ephone-dns that have been created in a
Cisco CME system.
Cisco Unified CME Commands: L
lpcor incoming
548
Cisco Unified CME Command Reference
OL-10894-01
lpcor incoming
To associate an incoming call with a logical partitioning class of restriction (LPCOR) resource-group
policy, use the lpcor incoming command in ephone, ephone-template, trunk group, voice port, voice
register pool, voice register template, or voice service configuration mode. To reset to the default, use
the no form of this command.
lpcor incoming lpcor-group
no lpcor incoming
Syntax Description
Command Default LPCOR policy is not associated with the incoming call.
Command Modes Ephone configuration (config-ephone)
Ephone template configuration (config-ephone-template)
Trunk group configuration (config-trunk-group)
Voice port configuration (config-voiceport)
Voice register pool configuration (config-register-pool)
Voice register template configuration (config-register-temp)
Voice service configuration (conf-voi-serv)
Command History
Usage Guidelines Analog Phones
An incoming call to an analog phone is associated with the LPCOR policy specified with this command
in the voice port. Otherwise the LPCOR policy specified in the trunk group is used.
SCCP IP Phones (Local or Remote)
An incoming call to an SCCP IP phone is associated with the LPCOR policy specified with this
command in ephone or ephone template configuration mode. The ephone configuration has precedence
over the ephone-template configuration. All directory numbers on the phone share the same LPCOR
setting.
SIP IP Phones (Local or Remote)
An incoming call to a SIP IP phone is associated with the LPCOR policy specified with this command
in voice register pool or voice register template configuration mode. The voice register pool
configuration has precedence over the voice register template configuration. All directory numbers on
the phone share the same LPCOR setting.
lpcor-group Name of the LPCOR resource group.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified CME Commands: L
lpcor incoming
549
Cisco Unified CME Command Reference
OL-10894-01
Note • This command is not supported for phones configured with the lpcor type mobility command.
• Phones that share a directory number must be configured with the same LPCOR policy. Different
LPCOR settings on shared-line phones are not supported.
PSTN Trunks
An incoming call to the PSTN is associated with the LPCOR policy specified with this command in the
voice port. Otherwise the LPCOR policy specified in the trunk group is used. The voice port
configuration takes precedence.
VoIP Trunks (H.323or SIP)
An incoming call to a VoIP trunk is associated with the LPCOR policy specified with this command in
voice service configuration mode if the remote IP address is not found in the IP trunk subnet table created
with the voice lpcor ip-trunk subnet incoming command.
Examples The following example shows the command used in different configuration modes:
voice service voip
lpcor incoming voip_group1
!
trunk group analog1
lpcor incoming analog_group1
lpcor outgoing analog_group1
!
voice-port 1/1/0
lpcor incoming vp_group1
lpcor outgoing vp_group1
!
voice register pool 3
lpcor type remote
lpcor incoming sip_group3
lpcor outgoing sip_group3
id mac 001E.BE8F.96C0
type 7940
number 1 dn 3
!
ephone 2
mac-address 001C.821C.ED23
type 7960
button 1:2
lpcor type remote
lpcor incoming ephone_group2
lpcor outgoing ephone_group2
Related Commands Command Description
lpcor outgoing Associates an outgoing call with a LPCOR resource-group policy.
lpcor type Specifies the LPCOR type for an IP phone.
voice lpcor ip-trunk subnet
incoming
Creates a LPCOR IP-trunk subnet table for incoming calls from a VoIP
trunk.
voice lpcor policy Creates a LPCOR policy for a resource group.
Cisco Unified CME Commands: L
lpcor outgoing
550
Cisco Unified CME Command Reference
OL-10894-01
lpcor outgoing
To associate an outgoing call with a logical partitioning class of restriction (LPCOR) resource-group
policy, use the lpcor outgoing command in dial peer, ephone, ephone template, trunk group, voice port,
voice register pool, or voice register template configuration mode. To reset to the default, use the no form
of this command.
lpcor outgoing lpcor-group
no lpcor outgoing
Syntax Description
Command Default LPCOR policy is not associated with the outgoing call.
Command Modes Dial peer configuration (config-dial-peer)
Ephone configuration (config-ephone)
Ephone template configuration (config-ephone-template)
Trunk group configuration (config-trunk-group)
Voice port configuration (config-voiceport)
Voice register pool configuration (config-register-pool)
Voice register template configuration (config-register-temp)
Command History
Usage Guidelines Analog Phones
An outgoing call from an analog phone is associated with the LPCOR policy specified with this
command in the voice port. Otherwise the LPCOR policy specified in the trunk group is used.
SCCP IP Phones (Local or Remote)
An outgoing call from an SCCP IP phone is associated with the LPCOR policy specified with this
command in ephone configuration or ephone template configuration mode. The ephone configuration
has precedence over the ephone-template configuration. All directory numbers on the phone share the
same LPCOR setting.
SIP IP Phones (Local or Remote)
An outgoing call from a SIP IP phone is associated with the LPCOR policy specified with this command
in voice register pool or voice register template configuration mode. The voice register pool
configuration has precedence over the voice register template configuration. All directory numbers on
the phone share the same LPCOR setting.
lpcor-group Name of the LPCOR resource group.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified CME Commands: L
lpcor outgoing
551
Cisco Unified CME Command Reference
OL-10894-01
Note • This command is not supported for phones configured with the lpcor type mobility command.
• Phones that share a directory number must be configured with the same LPCOR policy. Different
LPCOR settings on shared-line phones are not supported.
PSTN Trunks
An outgoing call from the PSTN uses the LPCOR policy specified with this command in the voice port
if the outbound dial peer is configured with the port command. Otherwise the outgoing call uses the
LPCOR policy specified with this command in the trunk group if the outbound dial peer is configured
with the trunkgroup command.
VoIP Trunks (H.323or SIP)
An outgoing VoIP call uses the LPCOR policy specified with this command in the outbound dial peer.
Otherwise the outgoing call uses the default LPCOR policy.
Examples The following example shows the command used in different configuration modes:
trunk group analog1
lpcor incoming analog_group1
lpcor outgoing analog_group1
!
voice-port 1/1/0
lpcor incoming vp_group1
lpcor outgoing vp_group1
!
dial-peer voice 2 voip
destination-pattern 2...
lpcor outgoing voip_group2
session protocol sipv2
session target ipv4:192.168.97.1
!
voice register pool 3
lpcor type remote
lpcor incoming sip_group3
lpcor outgoing sip_group3
id mac 001E.BE8F.96C0
type 7940
number 1 dn 3
!
ephone 2
mac-address 001C.821C.ED23
type 7960
button 1:2
lpcor type remote
lpcor incoming ephone_group2
lpcor outgoing ephone_group2
Related Commands Command Description
lpcor incoming Associates an incoming call with a LPCOR resource-group policy.
lpcor type Specifies the LPCOR type for an IP phone.
port (dial-peer) Associates a dial peer with a voice port.
Cisco Unified CME Commands: L
lpcor outgoing
552
Cisco Unified CME Command Reference
OL-10894-01
trunkgroup Associates a dial peer with a trunk group.
voice lpcor policy Creates a LPCOR policy for a resource group.
Command Description
Cisco Unified CME Commands: L
lpcor type
553
Cisco Unified CME Command Reference
OL-10894-01
lpcor type
To specify the logical partitioning class of restriction (LPCOR) type for an IP phone, use the lpcor type
command in ephone, ephone-template, voice register pool, or voice register template configuration
mode. To reset to the default, use the no form of this command.
lpcor type {local | mobile | remote}
no lpcor type
Syntax Description
Command Default LPCOR feature is disabled for the IP phone.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Voice register pool configuration (config-register-pool)
Voice register template configuration (config-register-temp)
Command History
Usage Guidelines According to the Telecom Regulatory Authority of India (TRAI) requirements, an IP phone can accept
both PSTN and VoIP calls if it is locally registered to Cisco Unified CME through the LAN. Select the
local keyword for this type of phone.
If an IP phone is registered remotely to Cisco Unified CME through the WAN, PSTN calls must be
blocked from that remote IP phone. Select the remote keyword for this type of phone.
A static LPCOR policy is applied to an IP phone if the phone registers to Cisco Unified CME from the
same region (local or remote) permanently.
If an IP phone moves between the local and remote regions, such as an Extension Mobility phone,
Cisco IP Communicator softphone, or remote teleworker, select the mobile keyword. The LPCOR policy
is assigned dynamically based on the phone’s currently registered IP address.
If you use a phone template to apply a command to a phone and you also use the same command in the
phone configuration of the same phone, the value in phone configuration has priority.
Examples The following example shows that SCCP IP phone 2 is set to the remote LPCOR type:
ephone 2
mac-address 001C.821C.ED23
type 7960
local IP phone always registers to Cisco Unified CME through the LAN.
mobile IP phone can register to Cisco Unified CME through the LAN or WAN.
remote IP phone always registers to Cisco Unified CME through the WAN.
Cisco IOS Release Cisco Product Modification
15.0(1)XA Cisco Unified CME 8.0 This command was introduced.
Cisco Unified CME Commands: L
lpcor type
554
Cisco Unified CME Command Reference
OL-10894-01
button 1:2
lpcor type remote
lpcor incoming ephone_group2
lpcor outgoing ephone_group2
Related Commands Command Description
lpcor incoming Associates a LPCOR resource-group policy with an incoming call.
lpcor outgoing Associates a LPCOR resource-group policy with an outgoing call.
voice lpcor policy Creates a LPCOR policy for a resource group.
555
Cisco Unified CME Command Reference
OL-10894-01
Cisco Unified CME Commands: M
Revised: October 22, 2009
This chapter contains commands to configure and maintain Cisco Unified Communications Manager
Express (formally known as Cisco Unified CallManager Express). The commands are presented in
alphabetical order. Some commands required for configuring Cisco Unified Communications Manager
Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master
index or search online to find these commands.
Cisco Unified CME Commands: M
mac-address (ephone)
556
Cisco Unified CME Command Reference
OL-10894-01
mac-address (ephone)
To associate the MAC address of a Cisco IP phone with an ephone configuration in a Cisco CallManager
Express (Cisco CME) system, use the mac-address command in ephone configuration mode. To
disassociate the MAC address from an ephone configuration, use the no form of this command.
mac-address [mac-address]
no mac-address
Syntax Description
Command Default There are no default behavior or values for this command.
Command Modes Ephone configuration (config-ephone)
Command History
Usage Guidelines Use this command to specify the MAC address of a specific Cisco IP phone in order to physically
identify the Cisco IP phone in a Cisco CME configuration. The MAC address of each Cisco IP phone is
printed on a sticker that is placed on the bottom of the phone.
If you choose to register phones before configuring them, the mac-address command can be used during
configuration without entering the mac-address argument. The Cisco CME system detects MAC
addresses and automatically populates phone configurations with their corresponding MAC addresses
and phone types. This capability is not supported for voice-mail ports and is supported only by
Cisco CME 3.0 and later versions. To use this capability, enable Cisco CME by using the following
commands: max-ephones, max-dn, create cnf-files, and ip source-address. After these commands
have been used, phones can start to register. Then, when you are configuring a registered ephone and you
use the mac-address command with no argument, the MAC address of the phone is automatically read
into the configuration. The equivalent functionality is available through the Cisco CME graphic user
interface (GUI).
If you choose to configure phones before registering them, the MAC address for each ephone must be
entered during configuration.
mac-address Identifying MAC address of an IP phone, which is found on a sticker located
on the bottom of the phone.
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 mac-address argument was made optional to enable
automatic MAC address assignment after registration of
phones.
12.3(4)T Cisco CME 3.0 This command was integrated into Cisco IOS
Release 12.3(4)T.
Cisco Unified CME Commands: M
mac-address (ephone)
557
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example associates the MAC address CFBA.321B.96FA with the IP phone that has
phone-tag 22:
Router(config)# ephone 22
Router(config-ephone)# mac-address CFBA.321B.96FA

Related Commands Description
create cnf-files Builds the XML configuration files that are required for IP phones used with
Cisco IOS Telephony Services V2.1, Cisco CallManager Express 3.0, or
later versions.
ip source-address Identifies the IP address and port through which IP phones communicate
with a Cisco CME router.
max-dn Sets the maximum number of ephone-dns to be supported by a Cisco CME
router.
max-ephones Sets the maximum number of ephones to be supported by a Cisco CME
router.
show ephone
registered
Displays status and information for registered IP phones.
Cisco Unified CME Commands: M
mac-address (voice-gateway)
558
Cisco Unified CME Command Reference
OL-10894-01
mac-address (voice-gateway)
To define the MAC address of the voice gateway to autoconfigure, use the mac-address command in
voice-gateway configuration mode. To remove the MAC address from the configuration, use the no form
of this command.
mac-address mac-address
no mac-address
Syntax Description
Command Default No MAC address is defined for the voice gateway to be autoconfigured.
Command Modes Voice-gateway configuration (config-voice-gateway)
Command History
Usage Guidelines This command defines the MAC address of the Cisco voice gateway that downloads its XML
configuration file from Cisco Unified CME using the Autoconfiguration feature.
Examples The following example associates the MAC address 001F.A30F.8331 for the Cisco VG224 voice
gateway associated with tag 1:
voice-gateway system 1
network-locale FR
type VG224
mac-address 001F.A30F.8331
voice-port 0-23
create cnf-files
Related Commands
mac-address MAC address of the voice gateway.
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.
Command Description
type (voice-gateway) Defines the type of voice gateway to autoconfigure in
Cisco Unified CME.
voice-port (voice-gateway) Identifies the analog ports on the voice gateway that register to
Cisco Unified CME.
Cisco Unified CME Commands: M
mailbox-selection (dial-peer)
559
Cisco Unified CME Command Reference
OL-10894-01
mailbox-selection (dial-peer)
To set a policy for selecting a mailbox for calls from a Cisco Unified CME system that are diverted
before being sent to a Cisco Unity Express or PBX voice-mail pilot number, use the mailbox-selection
command in dial-peer configuration mode. To return to the default, use the no form of this command.
mailbox-selection {last-redirect-num | orig-called-num}
no mailbox-selection
Syntax Description
Command Default Cisco Unity Express uses the last number to which the call was diverted before it was sent to voice mail
as the mailbox number. Some legacy PBX systems use the originally called number as the mailbox
number.
Command Modes Dial-peer configuration (config-dial-peer)
Command History
Usage Guidelines When Cisco Unified CME diverts a call, it captures the reroute information which will be used to
compose a reroute request. A dial-peer match will be performed against the diverted-to number. If this
is the voice mail pilot number and the mailbox-selection command has been used to install a policy, the
reroute information will be amended as directed by the command. The originator will pick up the
modified reroute request, build the diversion information and include it in the new diverted call to the
voice-mail pilot number.
This command should be used on the outbound dial peer for the pilot number of the voice-mail system.
This command might not work properly in certain network topologies, including the following cases:
• When the last redirecting endpoint is not hosted on Cisco Unified CME. This rarely occurs with a
PBX.
• When a call is forwarded across several SIP trunks. Multiple SIP Diversion Headers (stacking
hierarchy) are not supported in Cisco IOS software.
• When a call is forwarded across non Cisco voice gateways that do not support the optional H450.3
originalCalledNr field.
last-redirect-num (PBX voice mail only) The mailbox to which the call will be sent is the
number that diverted the call to the voice-mail pilot number (the last number
to divert the call).
orig-called-num (Cisco Unity Express only) The mailbox to which the call will be sent is the
number that was originally dialed before the call was diverted.
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.
Cisco Unified CME Commands: M
mailbox-selection (dial-peer)
560
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to set a policy to select the mailbox of the originally called number
when a call is diverted to a Cisco Unity Express or PBX voice-mail system with the pilot number 7000.
dial-peer voice 7000 voip
destination-pattern 7000
session target ipv4:10.3.34.211
codec g711ulaw
no vad
mailbox-selection orig-called-num
Cisco Unified CME Commands: M
mailbox-selection (ephone-dn)
561
Cisco Unified CME Command Reference
OL-10894-01
mailbox-selection (ephone-dn)
To set a policy for selecting a mailbox for calls that are diverted before being sent to a Cisco Unity
voice-mail pilot number, use the mailbox-selection command in ephone-dn configuration mode. To
return to the default, use the no form of this command.
mailbox-selection {last-redirect-num}
no mailbox-selection
Syntax Description
Command Default Cisco Unity uses the originally called number as the mailbox number.
Command Modes Ephone-dn configuration (config-ephone-dn)
Command History
Usage Guidelines This command sets the policy for selecting a mailbox for diverted calls.
This command is used on the ephone-dn associated with the voice-mail pilot number.
This command can only be used with SCCP phones.
This command might not work properly in certain network topologies, including the following cases:
• When the last redirecting endpoint is not hosted on Cisco Unified CME. This may rarely occur with
a PBX.
• When a call is forwarded across several SIP trunks. Multiple SIP Diversion Headers (stacking
hierarchy) are not supported in Cisco IOS software.
• When a call is forwarded across non Cisco voice gateways that do not support the optional H450.3
originalCalledNr field.
Examples The following example sets a policy to select the mailbox of the last redirecting number when a call is
diverted to a Cisco Unity voice-mail system with the pilot number 8000.
ephone-dn 2583
number 8000
mailbox-selection last-redirect-num
last-redirect-num The mailbox to which the call will be sent is the last number to divert the call.
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.
Cisco Unified CME Commands: M
max-calls-per-button
562
Cisco Unified CME Command Reference
OL-10894-01
max-calls-per-button
To set the maximum number of calls allowed on an octo-line directory number on an SCCP phone, use
the max-calls-per-button command in ephone or ephone-template configuration mode. To reset to the
default, use the no form of this command.
max-calls-per-button number-of-calls
no max-calls-per-button
Syntax Description
Command Default Maximum number of calls allowed on an octo-line is 8.
Command Modes Ephone configuration (config-ephone)
Ephone-template configuration (config-ephone-template)
Command History
Usage Guidelines This command limits the maximum number of calls, both incoming and outgoing, that can be active on
each octo-line directory number on an SCCP phone. This command applies to all octo-line directory
numbers on the phone.
This command must be set to a value that is more than or equal to the value set with the
busy-trigger-per-button command.
For phones that do not support octo-line directory numbers such as the Cisco Unified IP Phone 7902,
7920, or 7931, and analog phones connected to the Cisco VG224 or Cisco ATA, we recommend that you
set the max-calls-per-button command to 2. Otherwise, after the phone type is identified with either the
type command or during phone registration, this command is automatically set to 2.
If you use an ephone template to apply a command to an ephone and you also use the same command in
ephone configuration mode for the same ephone, the value that you set in ephone configuration mode
has priority.
Examples The following example sets the maximum calls allowed on octo-lines to 4 on ephone 1.
Router(config)# ephone 1
Router(config-ephone)# max-calls-per-button 4
number-of-calls Maximum number of calls. Range: 1 to 8. Default: 8.
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 4.3 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: M
max-calls-per-button
563
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
busy-trigger-per-button Sets the maximum number of incoming calls allowed on an octo-line
directory number before it triggers Call Forward Busy on the phone.
ephone-dn Configures a directory number for SCCP phones.
type Assigns a phone type to an SCCP phone.
Cisco Unified CME Commands: M
max-conferences
564
Cisco Unified CME Command Reference
OL-10894-01
max-conferences
To set the maximum number of three-party conferences that are supported simultaneously by the
Cisco CallManager Express (Cisco CME) router, use the max-conferences command in
telephony-service configuration mode. To reset this number to the default, use the no form of this
command.
max-conferences max-conference-number [gain -6 | 0 | 3 | 6]
no max-conferences
Syntax Description
Command Default Default is half the maximum number of simultaneous three-party conferences for each platform.
Command Modes Telephony-service configuration (config-telephony)
Command History
max-conference number Maximum number of three-party conferences that are supported
simultaneously by the router. This number is platform-dependent, and the
default is half the maximum for each platform. The following are the
maximum values for this argument:
• Cisco 1700 series, Cisco 2600 series, Cisco 2801—8
• Cisco 2811, Cisco 2821, Cisco 2851, Cisco 3600 series, Cisco 3700
series—16
• Cisco 3800 series—24 (requires Cisco IOS Release 12.3(11)XL or
higher)
Note Each individual Cisco IP phone can host a maximum of one
conference at a time. You cannot create a second conference on the
phone if you already have an existing conference on hold.
gain (Optional) Increases the sound volume of VoIP and public switched
telephony network (PSTN) parties joining a conference call. The allowable
decibel units are -6 db, 0 db, 3 db, and 6 db. The default is -6 db.
Cisco IOS Release Cisco Product Modification
12.2(2)XT Cisco ITS 2.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.3(11)XL1 Cisco CME 3.2.1 The gain keyword was added.
12.3(14)T Cisco CME 3.3 This command was integrated into Cisco IOS
Release 12.3(14)T.
Cisco Unified CME Commands: M
max-conferences
565
Cisco Unified CME Command Reference
OL-10894-01
Usage Guidelines This command supports three-party conferences for local and on-net calls only when all conference
participants are using the G.711 codec. Conversion between G.711 mu-law and A-law is supported.
Mixing of the media streams is supported by the Cisco IOS processor. The maximum number of
simultaneous conferences is limited to the platform-specific maximums.
The gain keyword’s functionality is applied to inbound audio packets, so conference participants can
more clearly hear a remote PSTN or VoIP caller joining their call. Note that this functionality cannot
discriminate between a remote VoIP/foreign exchange office (FXO) source, which requires a volume
gain, and a remote VoIP/IP phone, which does not require a volume gain and may therefore incur some
sound distortions.
Examples The following example sets the maximum number of conferences for a Cisco IP phone to 4 and
configures a gain of 6 db for inbound audio packets from remote PSTN or VoIP calls joining a
conference:
Router(config)# telephony-service
Router(config-telephony)# max-conferences 4 gain 6

Cisco Unified CME Commands: M
max-dn
566
Cisco Unified CME Command Reference
OL-10894-01
max-dn
To set the maximum number of extensions (ephone-dns) to be supported by a Cisco Unified CME router,
use the max-dn command in telephony-service configuration mode. To reset this number to the default
value, use the no form of this command.
max-dn max-directory-numbers [preference preference-order] [no-reg {primary | both}]
no max-dn
Syntax Description
Command Default The default is 0.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines The max-dn command limits the number of extensions (ephone-dns) available in a Cisco Unified CME
system. The maximum number of ephone-dns that you can create depends on the software version, router
platform, and amount of memory that you have installed. Type ? to display range.
The max-ephones command similarly limits the number of IP phones in a Cisco Unified CME system.
max-directory-numbers Maximum number of extensions (ephone-dns) to allow in the Cisco CME
system. The maximum you can set depends on the software version, router
platform, and amount of memory that you have installed. Type ? to display
range. The default is 0.
preference
preference-order
(Optional) Sets a preference value for the primary number of an ephone-dn.
Refer to CLI help for a range of numeric options, where 0 is the highest
preference. Default is 0.
no-reg (Optional) Globally disables ephone registration with an H.323 gatekeeper
or SIP proxy.
primary Primary ephone-dn numbers only.
both Both primary and secondary ephone-dn numbers.
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.4(4)XC Cisco Unified 4.0 The preference, no-reg, primary, and both
keywords were introduced.
12.4(9)T Cisco Unified 4.0 The preference, no-reg, primary, and both
keywords were integrated into Cisco IOS Release
12.4(9)T.
Cisco Unified CME Commands: M
max-dn
567
Cisco Unified CME Command Reference
OL-10894-01
Note You can increase the number of allowable extensions to the maximum; but after the maximum allowable
number is configured, you cannot reduce the limit without rebooting the router.
If registration with an H.323 gatekeeper or SIP proxy is enabled globally (the default), you can override
the setting per extension by using the no-reg keyword in the number command for individual
ephone-dns.
After using this command, you can provision individual extensions using the Cisco Unified CME
graphic user interface (GUI) or the router CLI in ephone-dn configuration mode.
Examples The following example sets the maximum number of extensions (ephone-dns) to 12:
Router(config)# telephony-service
Router(config-telephony)# max-dn 12
The following example sets the maximum number of extensions to 150 and specifies that the primary
number of each extension should receive a dial-peer preference order of 1:
Router(config)# telephony-service
Router(config-telephony)# max-dn 150 preference 1
The following example sets the maximum number of extensions to 200 and specifies that they should
not register both primary and secondary numbers with the H.323 gatekeeper:
Router(config)# telephony-service
Router(config-telephony)# max-dn 200 no-reg both
The following example sets the maximum number of extensions to 200 and specifies that ephone-dn 36
should not register its primary number with the gatekeeper:
Router(config)# telephony-service
Router(config-telephony)# max-dn 200
Router(config-telephony)# exit
Router(config)# ephone-dn 36
Router(config-ephone-dn)# number 75373 no-reg primary
Related Commands Description
ephone-dn Enters ephone-dn configuration mode.
max-ephones Sets the maximum number of phones supported by the router.
number Associates a telephone or extension number with an ephone-dn.
Cisco Unified CME Commands: M
max-dn (voice register global)
568
Cisco Unified CME Command Reference
OL-10894-01
max-dn (voice register global)
To set the maximum number of SIP phone directory numbers (extensions) that are supported by a Cisco
router, use the max-dn command in voice register global configuration mode. To reset to the default, use
the no form of this command.
max-dn max-directory-numbers
no max-dn
Syntax Description
Command Default Before Cisco Unified CME 7.1 and Cisco Unified SIP SRST 7.1, default is maximum number supported
by platform.
In Cisco Unified CME 7.1 and Cisco Unified SIP SRST 7.1 and later versions, default is 0.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command limits the number of SIP phone directory numbers (extensions) available in a
Cisco Unified CME system. The max-dn command is platform specific. It defines the limit for the voice
register dn command. The max-pool command similarly limits the number of SIP phones in a
Cisco CME system.
You can increase the number of allowable extensions to the maximum; but after the maximum allowable
number is configured, you cannot reduce the limit without rebooting the router. You cannot reduce the
number of allowable extensions without removing the already-configured directory numbers with
dn-tags that have a higher number than the maximum number to be configured.
max-directory-numbers Maximum number of extensions (ephone-dns) supported by the
Cisco router. The maximum number is version and platform dependent;
type ? to display range.
• In Cisco CME 3.4 to Cisco Unified CME 7.0 and in Cisco SIP SRST
3.4 to Cisco Unified SIP SRST 7.0: Default is maximum number
supported by platform.
• In Cisco Unified CME 7.1 and Cisco Unified SIP SRST 7.1 and later
versions: Default is 0.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
12.4(22)YB Cisco Unified CME 7.1
Cisco Unified SIP SRST 7.1
The default value was changed to 0.
12.4(24)T Cisco Unified CME 7.1
Cisco Unified SIP SRST 7.1
This command was integrated into Cisco IOS
release 12.4(24)T.
Cisco Unified CME Commands: M
max-dn (voice register global)
569
Cisco Unified CME Command Reference
OL-10894-01
Note This command can also be used for Cisco Unified SIP SRST.
Examples The following example shows how to set the maximum number of directory numbers to 48:
Router(config)# voice register global
Router(config-register-global)# max-dn 48

Related Commands Command Description
voice register dn Enters voice register dn configuration mode to define an extension
for a SIP phone line.
max-pool (voice register
global)
Sets the maximum number of SIP voice register pools that are
supported in a Cisco SIP SRST or Cisco CME environment.
Cisco Unified CME Commands: M
max-ephones
570
Cisco Unified CME Command Reference
OL-10894-01
max-ephones
To set the maximum number of Cisco IP phones to be supported by a Cisco CallManager Express
(Cisco CME) router, use the max-ephones command in telephony-service configuration mode. To reset
this number to the default value, use the no form of this command.
max-ephones max-phones
no max-ephones
Syntax Description
Command Default Default is 0.
Command Modes Telephony-service configuration (config-telephony)
Command History
Usage Guidelines The max-ephones command limits the number of Cisco IP phones supported on the router. The
maximum number you can set is platform- and version-dependent. Use CLI help to determine the
maximum number of ephones you can set, as shown in this example:
Router(config-telephony)# max-ephones ?
<1-48> Maximum phones to support
The max-dn command similarly limits the number of extensions (ephone-dns) in a Cisco CME system.
Note You can increase the number of phones; but after the maximum allowable number is configured, you
cannot reduce the limit of the Cisco IP phones without rebooting the router.
After using this command, configure phones by using the Cisco CME graphic user interface (GUI) or
the router CLI in ephone configuration mode.
max-phones Maximum number of phones supported by the Cisco CME router. The
maximum number is version- and platform-dependent; refer to Cisco IOS
command-line interface (CLI) help. Default is 0.
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.4(15)XZ Cisco Unified CME 4.3 This command was modified to set the maximum
number of phones that can register to
Cisco Unified CME.
12.4(20)T Cisco Unified CME 7.0 This command was integrated into
Cisco IOS Release 12.4(20)T.
Cisco Unified CME Commands: M
max-ephones
571
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example sets the maximum number of Cisco IP phones in a Cisco CME system to 24:
Router(config)# telephony-service
Router(config-telephony)# max-ephones 24
Related Commands Command Description
ephone Enters ephone configuration mode.
max-dn Sets the maximum number of extensions (ephone-dns) that can be
supported by the router.
Cisco Unified CME Commands: M
max-idle-time
572
Cisco Unified CME Command Reference
OL-10894-01
max-idle-time
To create an idle-duration timer for automatically logging out an Extension Mobility user, use the
max-idle-time command in voice user-profile configuration mode. To remove the timer, use the no form
of this command.
max-idle-time minutes
no max-idle-time
Syntax Description
Command Default No timer is created.
Command Modes Voice user-profile configuration (config-user-profile)
Command History
Usage Guidelines This command creates an idle-duration timer for automatically logging a user out from Extension
Mobility. The timer monitors the phone and if the specified maximum idle time is exceeded, the EM
manager logs out the user. Typically this command is used to log out users who fail to manually log out
of Extension Mobility before leaving a phone.
The call history record is automatically cleared when a user logs out from an Extension Mobility phone.
To disable Automatic Clear Call History on all Extension Mobility phones, use the keep call-history
command in telephony-service configuration mode.
After creating or modifying a profile, use the reset command in voice user-profile configuration mode
to reset all phones on which this profile is downloaded to propagate the modifications.
Examples The following example shows how to create a 30-minute idle-duration timer in user profile 1:
Router(config)# voice user-profile 1
Router(config-user-profile)# max-idle-time 30
Router(config-user-profile)# reset
Router(config-user-profile)#

minutes Maximum number of minutes an Extension Mobility phone is idle after
which the logged-in user is logged out from Extension Mobility.
Range:1 to 9999.
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 integrated into Cisco IOS
Release 12.4(20)T.
Cisco Unified CME Commands: M
max-idle-time
573
Cisco Unified CME Command Reference
OL-10894-01
Related Commands Command Description
keep call-history Disables Automatic Clear Call History for Extension Mobility in
Cisco Unified CME.
reset (voice
logout-profile and
voice user-profile)
Performs a complete reboot of all IP phones on which a particular logout
profile or user profile is downloaded.
Cisco Unified CME Commands: M
maximumbit-rate (video)
574
Cisco Unified CME Command Reference
OL-10894-01
maximumbit-rate (video)
To modify the maximum IP phone video bandwidth in Cisco Unified CME, use the maximum bit-rate
command in video configuration mode. To restore the default maximum bit-rate, use the no form of this
command.
maximum bit-rate value
no maximum bit-rate
Syntax Description
Command Default Maximum bit-rate of video bandwidth is 1,000,000 kb/s.
Command Modes Video configuration (config-tele-video)
Command History
Usage Guidelines Use this command to modify the default value of the maximum video bandwidth for all video-capable
phones associated with a Cisco Unified CME router. Default value is 1,000,000 kb/s.
Examples The following example sets a maximum bit-rate of 256 kb/s.
Router(config)# telephony-service
Router(config-telephony)# video
Router(conf-tele-video)# maximum bit-rate 256
value Video bandwidth in kb/s Range is 0 to 10000000. Default value is 10000000.
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.
Cisco Unified CME Commands: M
max-pool (voice register global)
575
Cisco Unified CME Command Reference
OL-10894-01
max-pool (voice register global)
To set the maximum number of Session Initiation Protocol (SIP) voice register pools that are supported
in Cisco Unified SIP SRST or Cisco Unified CME, use the max-pool command in voice register global
configuration mode. To reset the maximum number to the default, use the no form of this command.
max-pool max-voice-register-pools
no max-pool
Syntax Description
Command Default Before Cisco Unified CME 7.1 and Cisco Unified SIP SRST 7.1, default is maximum number supported
by platform.
In Cisco Unified CME 7.1 and Cisco Unified SIP SRST 7.1 and later versions, default is 0.
Command Modes Voice register global configuration (config-register-global)
Command History
Usage Guidelines This command limits the number of SIP phones supported by Cisco Unified CME. The max-pool
command is platform specific and defines the limit for the voice register pool command.
The max-dn command similarly limits the number of directory numbers (extensions) in Cisco
Unified CME.
You can increase the number of phones; but after the maximum allowable number is configured, you
cannot reduce the limit of the SIP phones without rebooting the router.
Note This command can also be used for Cisco Unified SIP SRST.
max-voice-register-pools Maximum number of SIP voice register pools supported by the Cisco router.
The upper limit of voice register pools is version- and platform-dependent;
type ? for range.
• In Cisco CME 3.4 to Cisco Unified CME 7.0 and in Cisco SIP SRST
3.4 to Cisco Unified SIP SRST 7.0: Default is maximum number
supported by platform.
• In Cisco Unified CME 7.1 and Cisco Unified SIP SRST 7.1 and later
versions: Default is 0.
Cisco IOS Release Cisco Product Modification
12.4(4)T Cisco CME 3.4
Cisco SIP SRST 3.4
This command was introduced.
12.4(22)YB Cisco Unified CME 7.1
Cisco Unified SIP SRST 7.1
The default value was changed to 0.
12.4(24)T Cisco Unified CME 7.1
Cisco Unified SIP SRST 7.1
This command was integrated into Cisco IOS
release 12.4(24)T.
Cisco Unified CME Commands: M
max-pool (voice register global)
576
Cisco Unified CME Command Reference
OL-10894-01
Examples The following example shows how to set the maximum number of Cisco SIP IP phones in Cisco
Unified SIP SRST or Cisco Unified CME to 24:
Router(config)# voice register global
Router(config-register-global)# max-pool 24

Related Commands Command Description
max-dn (voice register
global)
Set the maximum number of SIP phone directory numbers (extensions) that
are supported by a Cisco Unified CME router.
Cisco Unified CME Commands: M
max-presentation
577
Cisco Unified CME Command Reference
OL-10894-01
max-presentation
To set the number of call presentation lines supported by a phone type, use the max-presentation
command in ephone-type configuration mode. To reset to the default, use the no form of this command.
max-presentation number
no max-presentation
Syntax Description
Command Default No display lines are supported by the phone type.
Command Modes Ephone-type configuration (config-ephone-type)
Command History
Usage Guidelines This command defines the number of presentation lines that are supported for the type of phone being
added with an ephone-type template.
number Number of presentation lines. Range: 1 to 100. Default: 0. See Table 1 for
the number of presentation lines supported by each phone type.
Cisco IOS Release Cisco Product Modification
12.4(15)XZ Cisco Unified CME 4.3
Cisco Unified SRST 4.3
This command was introduced.
12.4(20)T Cisco Unified CME 7.0
Cisco Unified SRST 7.0
This command was integrated into
Cisco IOS Release 12.4(20)T.
Table 14 Supported Values for Ephone-Type Commands
Supported Device device-id device-type num-buttons max-presentation
Cisco Unified IP Phone 7915
Expansion Module with 12 buttons
227 7915 12 0 (default)
Cisco Unified IP Phone 7915
Expansion Module with 24 buttons
228 7915 24 0
Cisco Unified IP Phone 7916
Expansion Module with 12 buttons
229 7916 12 0
Cisco Unified IP Phone 7916
Expansion Module with 24 buttons
230 7916 24 0
Cisco Unified Wireless IP Phone 7925 484 7925 6 4
Cisco Unified IP
Conference Station 7937G
431 7937 1 6
Nokia E61 376 E61