cc/td/doc/product/voice/its/cme34
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table Of Contents

Cisco Unified CME Commands: show presence global through system message

show presence global

show presence subscription

show sdspfarm

show telephony-service admin

show telephony-service all

show telephony-service bulk-speed-dial

show telephony-service conference hardware

show telephony-service dial-peer

show telephony-service directory-entry

show telephony-service ephone

show telephony-service ephone-dn

show telephony-service ephone-dn-template

show telephony-service ephone-template

show telephony-service fac

show telephony-service security-info

show telephony-service tftp-bindings

show telephony-service voice-port

show voice register all

show voice register credential

show voice register dial-peers

show voice register dialplan

show voice register dn

show voice register global

show voice register pool

show voice register profile

show voice register statistics

show voice register template

show voice register tftp-bind

show voice-huntgroup

softkeys alerting

softkeys connected

softkeys connected (voice register template)

softkeys hold

softkeys idle

softkeys idle (voice register template)

softkeys ringing

softkeys seized

softkeys seized (voice register template)

source-addr

source-address (voice register global)

speed-dial

speed-dial (voice logout-profile and voice user-profile)

speed-dial (voice register pool)

srst dn line-mode

srst dn template

srst ephone description

srst ephone template

srst mode auto-provision

statistics collect

supplementary-service sip

system message


Cisco Unified CME Commands: show presence global through system message


Last Updated: July 19, 2007
First Published: February 27, 2006

This chapter contains commands to configure and maintain Cisco Unified Communications Manager Express (formally known as Cisco Unified CallManager Express). The commands are presented in alphabetical order. Some commands required for configuring Cisco Unified Communications Manager Express (Cisco Unified CME) may be found in other Cisco IOS command references. Use the command reference master index or search online to find these commands.

show presence global

To display configuration information about the presence service, use the show presence global command in user EXEC or privileged EXEC mode.

show presence global

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.4(11)XJ

This command was introduced.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

This command displays the configuration settings for presence.

Examples

The following example displays output from the show subscription global command:

Router# show subscription global

Presence Global Configuration Information:
=============================================
Presence feature enable : TRUE
Presence allow external watchers : FALSE
Presence max subscription allowed : 100
Presence number of subscriptions : 0
Presence allow external subscribe : FALSE
Presence call list enable : TRUE
Presence server IP address : 0.0.0.0
Presence sccp blfsd retry interval : 60
Presence sccp blfsd retry limit : 10
Presence router mode : CME mode

Table 31 describes the significant fields shown in the display.

Table 31 show subscription global Field Descriptions 

Field
Description

Presence feature enable

Indicates whether presence is enabled on the router with the presence command.

Presence allow external watchers

Indicates whether internal presentities can be watched by external watchers, as set by the watcher all command

Presence max subscription allowed

Maximum number of presence subscriptions allowed by the max-subscription command.

Presence number of subscriptions

Current number of active presence subscriptions.

Presence allow external subscribe

Indicates whether internal watchers are allowed to subscribe to status notifications from external presentities, as set by the allow subscribe command.

Presence call list enable

Indicates whether the Busy Lamp Field (BLF) call-list feature is enabled with the presence call-list command.

Presence server IP address

Displays the IP address of an external presence server defined with the server command.

Presence sccp blfsd retry interval

Retry timeout, in seconds, for BLF speed-dial numbers on SCCP phones set by the sccp blf-speed-dial retry interval command.

Presence sccp blfsd retry limit

Maximum number of retries allowed for BLF speed-dial numbers on SCCP phones set by the sccp blf-speed-dial retry interval command.

Presence router mode

Indicates whether the configuration mode is set to Cisco Unified CME or Cisco Unified SRST by the mode command.


Related Commands

Command
Description

allow watch

Allows a directory number on a phone registered to Cisco Unified CME to be watched in a presence service.

allow subscribe

Allows internal watchers to monitor external presence entities (directory numbers).

debug presence

Displays debugging information about the presence service.

presence enable

Allows the router to accept incoming presence requests.

server

Specifies the IP address of a presence server for sending presence requests from internal watchers to external presence entities.

show presence subscription

Displays information about active presence subscriptions.

watcher all

Allows external watchers to monitor internal presence entities (directory numbers).


show presence subscription

To display information about active presence subscriptions, use the show presence subscription command in user EXEC or privileged EXEC mode.

show presence subscription [details | presentity telephone-number | subid subscription-id | summary]

Syntax Description

details

(Optional) Displays detailed information about presentities, watchers, and presence subscriptions.

presentity telephone-number

(Optional) Displays information on the presentity specified by the destination telephone number.

subid subscription-id

(Optional) Displays information for the specific subscription ID.

summary

(Optional) Displays summary information about active subscription requests.


Command Default

Information for all active presence subscriptions is displayed.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.4(11)XJ

This command was introduced.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

This command displays details about the currently active presence subscriptions

Examples

The following is sample output from the show presence subscription details command:

Presence Active Subscription Records Details:
=============================================

Subscription ID : 1
Watcher : 6002@10.4.171.60
Presentity : 6005@10.4.171.34
Expires : 3600 seconds
Subscription Duration : 1751 seconds
line status : idle
watcher type : local
presentity type : local
Watcher phone type : SIP Phone
subscription type : Incoming Indication
retry limit : 0
sibling subID : 0
sdb : 0
dp : 6555346C
watcher dial peer tag : 40001
number of presentity : 1

Subscription ID : 2
Watcher : 6002@10.4.171.60

Presence Active Subscription Records:
=============================================

Subscription ID : 30
Watcher : 4085256003@10.4.171.34
Presentity : 5001@10.4.171.20
Expires : 3600 seconds
line status : idle
watcher type : local
presentity type : remote
Watcher phone type : SCCP [BLF Call List]
subscription type : Outgoing Request
retry limit : 0
sibling subID : 23
sdb : 0
dp : 0
watcher dial peer tag : 0

The following is sample output from the show presence subscription summary command:

Router# show presence subscription summary

Presence Active Subscription Records Summary: 15 subscription
Watcher Presentity SubID Expires SibID Status
======================== ======================== ====== ======= ====== ======
6002@10.4.171.60 6005@10.4.171.34 1 3600 0 idle
6005@10.4.171.81 6002@10.4.171.34 6 3600 0 idle
6005@10.4.171.81 6003@10.4.171.34 8 3600 0 idle
6005@10.4.171.81 6002@10.4.171.34 9 3600 0 idle
6005@10.4.171.81 6003@10.4.171.34 10 3600 0 idle
6005@10.4.171.81 6001@10.4.171.34 12 3600 0 idle
6001@10.4.171.61 6003@10.4.171.34 15 3600 0 idle
6001@10.4.171.61 6002@10.4.171.34 17 3600 0 idle
6003@10.4.171.59 6003@10.4.171.34 19 3600 0 idle
6003@10.4.171.59 6002@10.4.171.34 21 3600 0 idle
6003@10.4.171.59 5001@10.4.171.34 23 3600 24 idle
6002@10.4.171.60 6003@10.4.171.34 121 3600 0 idle
6002@10.4.171.60 5002@10.4.171.34 128 3600 129 idle
6005@10.4.171.81 1001@10.4.171.34 130 3600 131 busy
6005@10.4.171.81 7005@10.4.171.34 132 3600 133 idle

The following is sample output from the show presence subscription subid command:

Router# show presence subscription subid 133

Presence Active Subscription Records:
=============================================

Subscription ID : 133
Watcher : 6005@10.4.171.34
Presentity : 7005@10.4.171.20
Expires : 3600 seconds
line status : idle
watcher type : local
presentity type : remote
Watcher phone type : SIP Phone
subscription type : Outgoing Request
retry limit : 0
sibling subID : 132
sdb : 0
dp : 0
watcher dial peer tag : 0

Table 31 describes the significant fields shown in the display.

Table 32 show presence subscription Field Descriptions 

Field
Description

Watcher

IP address of the watcher.

Presentity

IP address of the presentity.

Expires

Number of seconds until the subscription expires. Default is 3600.

line status

Status of the line:

Idle—Line is not being used.

In-use—User is on the line, whether or not this line can accept a new call.

Unknown—Phone is unregistered or this line is not allowed to be watched.

watcher type

Whether the watcher is local or remote.

presentity type

Whether the presentity is local or remote.

Watcher phone type

Type of phone, either SCCP or SIP.

subscription type

The type of presence subscription, either incoming or outgoing.

retry limit

Maximum number of times the router attempts to subscribe for the line status of an external SCCP phone when either the presentity does not exist or the router receives a terminated NOTIFY from the external presence server. Set with the sccp blf-speed-dial retry-interval command.

sibling subID

Sibling subscription ID if presentity is remote. If value is 0, presentity is local.

sdb

Voice port of the presentity.

dp

Dial peer of the presentity.

watcher dial peer tag

Dial peer tag of the watcher device.


Related Commands

Command
Description

allow watch

Allows a directory number on a phone registered to Cisco Unified CME to be watched in a presence service.

debug ephone blf

Displays debugging information for Busy Lamp Field (BLF) presence features.

debug presence

Displays debugging information about the presence service.

presence

Enables presence service and enters presence configuration mode.

presence enable

Allows the router to accept incoming presence requests.

show presence global

Displays configuration information about the presence service.


show sdspfarm

To display the status of the configured digital signal processor (DSP) farms and transcoding streams, use the show sdspfarm command in privileged EXEC mode.

show sdspfarm {units | sessions {active | callID number | statistics | summary}}

Syntax Description

units

Displays the configured and registered DSP farms.

sessions

Displays the transcoding streams.

active

Displays all active sessions.

callID

Displays activities for a specific caller ID.

number

Displays caller ID number displayed by the show voip rtp connection command.

statistics

Displays session statistics.

summary

Displays summary information.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.3(11)T

3.2

This command was introduced.


Examples

The following is sample output from the show sdspfarm units command:

Router# show sdspfarm units

mtp-1 Device:MTP123456782012 TCP socket:[-1] UNREGISTERED
actual_stream:0 max_stream 0 IP:0.0.0.0 0 Unknown 0 keepalive 0

mtp-2 Device:MTP000a8aeaca80 TCP socket:[5] REGISTERED
actual_stream:40 max_stream 40 IP:10.5.49.160 11001 MTP YOKO keepalive 12074
Supported codec:G711Ulaw
G711Alaw
G729
G729a
G729b
G729ab

max-mtps:2, max-streams:240, alloc-streams:40, act-streams:0

The following is sample output from the show sdspfarm sessions active command:
Router# show sdspfarm sessions active

Stream-ID:3 mtp:2 1.5.49.160 20174 Local:2000 START
usage:MoH (DN=3 , CH=1) FE=TRUE
codec:G729 duration:20 vad:0 peer Stream-ID:4

Stream-ID:4 mtp:2 1.5.49.160 17072 Local:2000 START
usage:MoH (DN=3 , CH=1) FE=FALSE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:3

The following is sample output from the show sdspfarm sessions callID command:

Router# show sdspfarm sessions callid 51M

Stream-ID:6, srcCall-ID:51, codec:G729AnnexA , dur:20ms, vad:0, dstCall-ID:52, confID:5, mtp:2^
Peer Stream-ID:5, srcCall-ID:52, codec:G711Ulaw64k , dur:20ms, vad:0, dstCall-ID:51, confID:5, mtp:2^
Router-2015# show sdspfarm sessions callid 52
Stream-ID:5, srcCall-ID:52, codec:G711Ulaw64k , dur:20ms, vad:0, dstCall-ID:51, confID:5, mtp:2
Peer Stream-ID:6, srcCall-ID:51, codec:G729AnnexA , dur:20ms, vad:0, dstCall-ID:52, confID:5, mtp:2

The following is sample output from the show sdspfarm sessions statistics command:

Router# show sdspfarm sessions statistics

Stream-ID:1 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:1014 in-pak:0 discard:0
Stream-ID:2 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:3 mtp:2 10.5.49.160 20174 Local:2000START MoH (DN=3 , CH=1) FE=TRUE
codec:G729 duration:20 vad:0 peer Stream-ID:4
recv-pak:0 xmit-pak:0 out-pak:4780 in-pak:0 discard:0
Stream-ID:4 mtp:2 10.5.49.160 17072 Local:2000START MoH (DN=3 , CH=1) FE=FALSE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:3
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:5 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:6 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:7 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:8 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:9 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:10 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:11 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:12 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:13 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:14 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:15 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:16 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:17 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:18 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:19 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:20 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:21 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:22 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:23 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:24 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:25 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:26 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:27 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:28 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:29 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:30 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:31 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:32 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:33 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:34 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:35 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:36 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:37 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:38 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:39 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0
Stream-ID:40 mtp:2 0.0.0.0 0 Local:0IDLE
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:0
recv-pak:0 xmit-pak:0 out-pak:0 in-pak:0 discard:0

The following is sample output from the show sdspfarm sessions summary command:

Router# show sdspfarm sessions summary

max-mtps:2, max-streams:240, alloc-streams:40, act-streams:2
ID MTP State CallID confID Usage Codec/Duration
==== ===== ====== =========== ====== ============================= ==============
1 2 IDLE -1 0 G711Ulaw64k /20ms
2 2 IDLE -1 0 G711Ulaw64k /20ms
3 2 START -1 3 MoH (DN=3 , CH=1) FE=TRUE G729 /20ms
4 2 START -1 3 MoH (DN=3 , CH=1) FE=FALSE G711Ulaw64k /20ms
5 2 IDLE -1 0 G711Ulaw64k /20ms
6 2 IDLE -1 0 G711Ulaw64k /20ms
7 2 IDLE -1 0 G711Ulaw64k /20ms
8 2 IDLE -1 0 G711Ulaw64k /20ms
9 2 IDLE -1 0 G711Ulaw64k /20ms
10 2 IDLE -1 0 G711Ulaw64k /20ms
11 2 IDLE -1 0 G711Ulaw64k /20ms
12 2 IDLE -1 0 G711Ulaw64k /20ms
13 2 IDLE -1 0 G711Ulaw64k /20ms
14 2 IDLE -1 0 G711Ulaw64k /20ms
15 2 IDLE -1 0 G711Ulaw64k /20ms
16 2 IDLE -1 0 G711Ulaw64k /20ms
17 2 IDLE -1 0 G711Ulaw64k /20ms
18 2 IDLE -1 0 G711Ulaw64k /20ms
19 2 IDLE -1 0 G711Ulaw64k /20ms
20 2 IDLE -1 0 G711Ulaw64k /20ms
21 2 IDLE -1 0 G711Ulaw64k /20ms
22 2 IDLE -1 0 G711Ulaw64k /20ms
23 2 IDLE -1 0 G711Ulaw64k /20ms
24 2 IDLE -1 0 G711Ulaw64k /20ms
25 2 IDLE -1 0 G711Ulaw64k /20ms
26 2 IDLE -1 0 G711Ulaw64k /20ms
27 2 IDLE -1 0 G711Ulaw64k /20ms
28 2 IDLE -1 0 G711Ulaw64k /20ms
29 2 IDLE -1 0 G711Ulaw64k /20ms
30 2 IDLE -1 0 G711Ulaw64k /20ms
31 2 IDLE -1 0 G711Ulaw64k /20ms
32 2 IDLE -1 0 G711Ulaw64k /20ms
33 2 IDLE -1 0 G711Ulaw64k /20ms
34 2 IDLE -1 0 G711Ulaw64k /20ms
35 2 IDLE -1 0 G711Ulaw64k /20ms
36 2 IDLE -1 0 G711Ulaw64k /20ms
37 2 IDLE -1 0 G711Ulaw64k /20ms
38 2 IDLE -1 0 G711Ulaw64k /20ms
39 2 IDLE -1 0 G711Ulaw64k /20ms
40 2 IDLE -1 0 G711Ulaw64k /20ms

Table 33 describes the fields shown in the show sdspfarm command display.

Table 33 show sdspfarm Field Descriptions  

Field
Description

act-streams

Active streams that are currently involved in calls.

alloc-streams

Number of transcoding streams that are actually allocated to all DSP farms that are registered to Cisco CME.

callID

Caller ID that the active stream is in.

Codec

Codec in use.

confID

ConfID that is used to communicate with DSP farms.

discard

Number of packets that are discarded.

dstCall-ID

Caller ID of the destination IP call leg.

Duration or dur

Packet rates, in milliseconds.

ID

Transcoding stream sequence number in Cisco CME.

in-pak

Number of incoming packets from the source call leg.

Local

Local port for voice packets.

max-mtps

Maximum number of Message Transfer Parts (MTPs) that are currently allowed to register in Cisco CME.

max-streams

Maximum number of transcoding streams that are currently allowed in Cisco CME.

mtp or MTP

MTP sequence number where the transcoding stream is located.

out-pak

Number of outgoing packets sending to source call leg.

peer Stream-ID

Stream sequence number of the other stream paired in the same transcoding session. (Two transcoding streams make up a transcoding session).

recv-pak

Number of voice packets received from DSP farm.

srcCall-ID

Source caller ID of the source IP call leg.

State

Current state of the transcoding stream, could be IDLE, SEIZE, START, STOP, or END.

Stream-ID

Transcoding stream sequence number in Cisco CME.

TCP-socket

Socket number for DSP farm (similar to TCP socket for show ephone output).

usage

Current usage of the stream; for example, Ip-Ip (IP to IP transcoding), MOH (for MOH transcoding) and Conf (conference).

vad

Voice-activity detection (VAD) flag for the transcoding stream. It should always be 0 (False).

xmit-pak

Number of packets that are sent to DSP farm.


Related Commands

Command
Description

sdspfarm tag

Permits a DSP farm to be to registered to Cisco CME and be associated with an SCCP client interface's MAC address.

sdspfarm transcode sessions

Specifies the maximum number of transcoding sessions allowed per Cisco CME router.

sdspfarm units

Specifies the maximum number of DSP farms that are allowed to be registered to Cisco CME.


show telephony-service admin

To display information about the Cisco CallManager Express (Cisco CME) system administrator, use the show telephony-service admin command in user EXEC or privileged EXEC mode.

show telephony-service admin

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.2(2)XT

2.0

This command was introduced on the following platforms: Cisco 1750, Cisco 1751, Cisco 2600 series, Cisco 3600 series, and Cisco IAD2420 series.

12.2(8)T

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

2.0

This command was implemented on the Cisco 2600XM and Cisco 2691.

12.2(11)T

2.0.1

This command was integrated into Cisco IOS Release 12.2(11)T and implemented on the Cisco 1760.


Examples

The following is sample output from this command:

Router# show telephony-service admin

admin_username Admin
admin_password word
edit DN through Web: enabled.
edit TIME through Web: enabled.

Table 34 describes the significant fields in this output.

Table 34 show telephony-service admin Field Descriptions  

Field
Description

admin_username

Username of system administrator.

admin_password

Password of system administrator.

edit DN through Web

Whether editing of extensions through the GUI has been enabled using the dn-webedit command.

edit TIME through Web

Whether changing the router time through the GUI has been enabled using the time-webedit command.


Related Commands

Command
Description

dn-webedit

Enables adding of extensions (ephone-dns) through the web interface.

time-webedit

Enables setting of time through the web interface.


show telephony-service all

To display detailed configuration for phones, voice ports, and dial peers in a Cisco CallManager Express (Cisco CME) system, use the show telephony-service all command in user EXEC or privileged EXEC mode.

show telephony-service all

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.1(5)YD

1.0

This command was introduced on the Cisco 2600 series, Cisco 3600 series, and Cisco IAD2420 series.

12.2(2)XT

2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T

2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T1

2.0

This command was implemented on the Cisco 2600XM and Cisco 2691.

12.2(11)T

2.01

This command was implemented on the Cisco 2600XM and Cisco 2691.


Examples

The following is sample output from this command:

Router# show telephony-service all

CONFIG
======
ip source-address 10.0.0.1 port 2000
max-ephones 24
max-dn 24
dialplan-pattern 1 408734....
voicemail 11111
transfer-pattern 510734....
keepalive 30


ephone-dn 1
number 5001
huntstop

ephone-dn 2
number 5002
huntstop
call-forward noan 5001 timeout 8

ephone-dn 3
number 5003
huntstop


ephone 1
mac-address 0030.94C3.37CB
type 0
button 1:1
speed-dial 1 5002
speed-dial 2 5003
cos 0
!
ephone 2
mac-address 0030.94C3.F96A
type 0
button 1:2 2:3 3:4
speed-dial 1 5004
speed-dial 2 5001
cos 0
!


voice-port 50/0/1
station-id number 5001
!
voice-port 50/0/2
station-id number 5002
timeout ringing 8
!

dial-peer voice 20025 pots
destination-pattern 5001
huntstop
port 50/0/1

dial-peer voice 20026 pots
destination-pattern 5002
huntstop
call-forward noan 5001
port 50/0/2

dial-peer voice 20027 pots
destination-pattern 5003
huntstop
port 50/0/3

Table 35 describes significant fields in this output, in alphabetical order.

Table 35 show telephony-service all Field Descriptions  

Field
Description

button

Button on the Cisco IP phone.

call-forward noan

Call forward no answer is set.

cos

Not applicable; unused.

destination-pattern

Destination pattern (telephone number) configured for this dial peer.

dial-peer voice

Voice dial peer.

dialplan-pattern

Dial-plan pattern is set to expand the abbreviated extension numbers to fully qualified E.164 numbers.

ephone

Cisco IP phone.

ephone-dn

Cisco IP phone directory number.

huntstop

Huntstop is set.

ip source-address

IP address used by Cisco IP phones to register with the router for service.

keepalive

IP phone keepalive period, in seconds.

mac-address

MAC address.

max-dn

Maximum directory numbers.

max-ephones

Maximum numbers of Cisco IP phones.

number

Cisco IP phone number.

port

TCP port number used by Cisco IP phones to communicate with the router.

pots

POTS dial peer set.

speed-dial

Speed-dial is set.

station-id number

Number used for caller ID purposes when calls are made using the line.

timeout

Timeout is set.

timeout ringing

Maximum amount of time that the phone is allowed to ring before the call is disconnected.

transfer-pattern

Transfer pattern is set to allow transfer of calls to a specified number.

type

Not applicable; unused.

voicemail

A voice-mail (speed-dial) number is set.

voice-port

(Virtual) voice port designator.


Related Commands

Command
Description

show telephony dial-peer

Displays dial peers for extensions in a Cisco CME system.

show telephony voice-port

Displays virtual voice-port configuration for extensions in a Cisco CME system.


show telephony-service bulk-speed-dial

To display information about bulk speed-dial lists, use the show telephony-service bulk-speed-dial command in privileged EXEC mode.

show telephony-service bulk-speed-dial {global list-id index-id [all] | local phone-tag list-id index-id [all] | summary}

Syntax Description

global

Global lists that can be accessed by all users.

local

Personal lists that can be accessed by users configured to use the lists.

list-id

Digit that identifies the list. Range is from 0 to 9.

index-id

Identification number for an entry.

phone-tag

Ephone identifier (phone-tag).

summary

List of registered bulk speed-dial text files.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Examples

The following example displays the list of bulk speed-dial text files that have been configured in the system:

Router# show telephony-service bulk-speed-dial summary

List-id    Entries      Size    Reference url
0 40 3840 Global     tftp://192.168.254.254/phonedirs/uut.csv
1 20 1920 Global     phoneBook.csv
8 15 1440 Global     tftp://192.168.254.254/phonedirs/big.txt
9 20 1920 Global     tftp://192.168.254.254/phonedirs/phoneBook.csv
6 24879 2388384 ephone-2   tftp://192.168.254.254/phonedirs/big.txt1
7 20 1920 ephone-2   phoneBook.csv
6 24879 2388384 ephone-3   big.txt1
7 20 1920 ephone-3   phoneBook.csv
4 Global List(s) 4 Local List(s)

The following example displays the single entry 1234 from list 9:

Router# show telephony-service bulk-speed-dial global 9 1234

Number: 1800 200 1345 name: Jay Smith Private: yes Extension: No

The following example displays all index entries starting with 1 for personal list number 7 for ephone 2:

Router# show telephony-service bulk-speed-dial local 2 7 1 all
Index Number Name Hide Append
1000 918005550164 ABC Co Front Desk      no no
1003 919005550167 ABC Co File room       no no
1100 918005550118 no no
1200 918005550184 ABC Co President       no no
1301 918005550152 no no
1342 91800,5550185 ABC Co Sales           no no
1682 91800555,,0115 ABC Co Service         no no

Table 36 describes the significant fields shown in the display.

Table 36 show telephony-service bulk-speed-dial Field Descriptions 

Field
Description

List-id

Digit that identifies the list. Range is from 0 to 9.

Entries

Number of entries in the speed-dial file.

Size

Size of the file, in KB.

Reference

Assignment of the list: global if assigned to all ephones, or a specific ephone number.

url

Location of the text file, in URL format.

Index

Identification number for an entry.

Number

Number to be dialed and displayed on the phone.

Name

Name to be displayed on the phone.

Hide

Yes indicates that this number should not be displayed when it is dialed.

Append

Yes indicates that additional digits can be dialed by the user after this number has been speed-dialed before the call is completed.


Related Commands

Command
Description

bulk-speed-dial list (ephone)

Enables a personal bulk speed-dial list for an ephone.

bulk-speed-dial list (telephony-service)

Enables a global bulk speed-dial list for all users of a Cisco Unified CME system.

bulk-speed-dial prefix

Sets the prefix code that phone users dial to access speed-dial numbers from a bulk speed-dial list.


show telephony-service conference hardware

To display information about hardware conferences in a Cisco CallManager Express (Cisco CME) system, use the show telephony-service conference hardware command in privileged EXEC mode.

show telephony-service conference hardware [ad-hoc [detail] | detail | meetme [detail] | number telephone-number]

Syntax Description

ad-hoc

(Optional) Ad hoc conferences.

detail

(Optional) Detailed information for all conferences.

meetme

(Optional) Meet-me conferences.

number

(Optional) Conference number.

telephone-number

(Optional) Telephone or extension number.


Command Modes

Privileged EXEC

Command History

Release
Cisco Product
Modification

12.4(11)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.


Usage Guidelines

Use this command to display information about ad hoc and meet-me conferences, such as verifying which parties are still in the conference.

Examples

The following sample output displays information for a four-party ad hoc conference. Extension 8044 created the conference by calling extension 8012, then adding extension 8004 to the conference. The conference administrator, extension 8006, called into the conference after it was established.

Router# show telephony-service conference hardware detail

Conference Type Active Max Peak Master MasterPhone Last

cur(initial)

=================================================================================

8893 Ad-hoc 4 8 4 8044 29 ( 29) 8006

Conference parties:

8006 (admin)

8004

8012

8044

Table 37 describes the significant fields shown in the display.

Table 37 show telephony-service conference hardware Field Descriptions 

Field
Description

Active

Number of active parties in the conference.

admin

Ad hoc and meet-me hardware conference administrator. The administrator can:

Dial in to any conference directly through the conference number

Use the ConfList soft key to list conference parties

Remove any party from any conference

Conference

Conference directory number (DN).

Conference parties

DNs in the conference.

Last

Last party to join the conference.

Master

Conference creator.

MasterPhone
cur(initial)

cur—Current master phone. The phone that hosts the conference creator now.

(initial)—Initial master phone. The phone that hosted the conference creator when the conference was created.

Because you can transfer the conference creator, the current master phone may be different from the initial master phone.

Max

Maximum parties allowed in the conference.

Peak

Maximum parties in the conference at any time.

Type

Type of conference: meet-me or ad hoc.


show telephony-service dial-peer

To display dial peer information for extensions in a Cisco CallManager Express (Cisco CME) system, use the show telephony-service dial-peer command in user EXEC or privileged EXEC mode.

show telephony-service dial-peer

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.1(5)YD

1.0

This command was introduced on the Cisco 2600 series, Cisco 3600 series, and Cisco IAD2420 series.

12.2(2)XT

2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T

2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T1

2.0

This command was implemented on the Cisco 2600XM and Cisco 2691.

12.2(11)T

2.01

This command was implemented on the Cisco 2600XM and Cisco 2691.


Usage Guidelines

The dial peers cannot be edited manually. To change values associated with dial peers, use the ephone-dn command.

Examples

The following is sample output from this command:

Router# show telephony-service dial-peer

dial-peer voice 20025 pots
destination-pattern 5001
huntstop
port 50/0/1

dial-peer voice 20026 pots
destination-pattern 5002
huntstop
call-forward noan 5001
port 50/0/2

dial-peer voice 20027 pots
destination-pattern 5003
huntstop
port 50/0/3

dial-peer voice 20028 pots
destination-pattern 5004
huntstop
port 50/0/4

Table 38 describes significant fields in this output, in alphabetical order.

Table 38 show telephony-service dial-peer Field Descriptions 

Field
Description

call-forward noan

Call forward no answer is set.

destination-pattern

Destination pattern (telephone number) configured for this dial peer.

dial-peer voice

Voice dial peer.

huntstop

Huntstop is set.

port

(Virtual) voice port designator.

pots

Plain old telephone service (POTS) dial peer set.


Related Commands

Command
Description

ephone

Enters ephone configuration mode.

ephone-dn

Enters ephone-dn configuration mode.

show telephony-service all

Displays detailed configuration for a Cisco CME system.

show telephony-service ephone-dn

Displays information for extensions (ephone-dns) in a Cisco CME system.

show telephony-service voice-port

Displays virtual voice-port configuration of extensions in a Cisco CME system.


show telephony-service directory-entry

To display the entries made using the directory entry command, use the show telephony-service directory-entry command in user EXEC or privileged EXEC mode.

show telephony-service directory-entry

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.2(15)ZJ

3.0

This command was introduced.

12.3(4)T

3.0

This command was integrated into Cisco IOS Release 12.3(4)T.


Usage Guidelines

This command lists directory entries that are made using the directory entry command but does not list entries that are made using the name and number commands in ephone-dn configuration mode.

Examples

The following is sample output from this command:

Router# show telephony-service directory-entry

directory entry 1 4085550123 name Smith, John

Table 39 describes significant fields in this output, in alphabetical order.

Table 39 show telephony-service directory-entry Field Descriptions 

Field
Description

directory directory-tag (shown as 1 in the example)

Sequence number or unique identifier for a directory entry.

name (shown as Smith, John)

Name that appears in the directory associated with the number.

number (shown as 4085550123 in the example)

Telephone number or extension for the directory entry.


Related Commands

Command
Description

directory entry

Adds an entry to a local phone directory that can be displayed on IP phones.

show telephony-service all

Displays detailed configuration of a Cisco CME system.

show telephony-service ephone-dn

Displays information for extensions (ephone-dns) in a Cisco CME system.


show telephony-service ephone

To display configuration for the Cisco IP phones, use the show telephony-service ephone command in user EXEC or privileged EXEC mode.

show telephony-service ephone

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.1(5)YD

Cisco Unified CME 1.0

This command was introduced on the Cisco 2600 series, Cisco 3600 series, and Cisco IAD2420 series.

12.2(2)XT

Cisco Unified CME 2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T

Cisco Unified CME 2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T1

Cisco Unified CME 2.0

This command was implemented on the Cisco 2600XM and Cisco 2691.

12.2(11)T

Cisco Unified CME 2.01

This command was implemented on the Cisco 2600XM and Cisco 2691.

12.4(11)XJ

Cisco Unified CME 4.1

The conference add-mode, conference drop-mode, and conference admin fields were added.

12.4(15)T

Cisco Unified CME 4.1

This command with modifications was integrated into Cisco IOS Release 12.4(15)T.


Examples

The following is sample output from this command:

Router# show telephony-service ephone

ephone 1
mac-address 0030.94C3.37CB
type 0
button 1:1
speed-dial 1 5002
speed-dial 2 5003
cos 0
conference drop-mode never
conference add-mode all
conference admin: Yes
!
ephone 2
mac-address 0030.94C3.F96A
type 0
button 1:2 2:3 3:4
speed-dial 1 5004
speed-dial 2 5001
cos 0
!

Table 40 describes significant fields in this output.

Table 40 show telephony-service ephone Field Descriptions   

Field
Description

button

Button number on IP phone, separator to denote ring characteristics and ephone-dn tag. A colon (:) separator denotes a normal ring.

conference add-mode

Who can add parties to a conference:

creator—Only the creator can add parties.

all—Any party can add other parties if the creator remains in the conference.

conference drop-mode

When conferences are dropped:

creator—Conference terminates when the creator hangs up.

local—Conference terminates when the last local party in the conference hangs up or drops out of the conference.

never—Conference is not dropped, even if the creator hangs up, as long as three parties remain in the conference.

conference admin

Ad hoc and meet-me hardware conference administrator. The administrator can:

Dial in to any conference directly through the conference number

Use the ConfList soft key to list conference parties

Remove any party from any conference

cos

Not used.

ephone

Cisco IP phone.

mac-address

MAC address of the Cisco IP phone.

type

Not used.

speed-dial

Speed-tag (unique identifier) and the number that is programmed for that speed-tag.


Related Commands

Command
Description

show telephony-service all

Displays detailed configuration for a Cisco Unified CME system.

show telephony-service dial-peer

Displays dial-peer information for extensions in a Cisco Unified CME system.

show telephony-service ephone-dn

Displays information for extensions (ephone-dns) in a Cisco Unified CME system.

show telephony-service voice-port

Displays configurations for virtual voice ports in a Cisco Unified CME system.


show telephony-service ephone-dn

To display information about extensions (ephone-dns) in a Cisco CallManager Express (Cisco CME) system, use the show telephony-service ephone-dn command in user EXEC or privileged EXEC mode.

show telephony-service ephone-dn

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.1(5)YD

1.0

This command was introduced on the Cisco 2600 series, Cisco 3600 series, and Cisco IAD2420 series.

12.2(2)XT

2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T

2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T1

2.0

This command was implemented on the Cisco 2600XM and Cisco 2691.

12.2(11)T

2.01

This command was implemented on the Cisco 2600XM and Cisco 2691.


Examples

The following is sample output from this command:

Router# show telephony-service ephone-dn

ephone-dn 1
 number 5001
 huntstop

ephone-dn 2
 number 5002
 huntstop
 call-forward noan 5001 timeout 8

ephone-dn 3
 number 5003
 huntstop

ephone-dn 4
 number 5004
 huntstop

Table 41 describes significant fields in this output, in alphabetical order.

Table 41 show telephony-service ephone-dn Field Descriptions 

Field
Description

call-forward noan

Call forwarding is set to no answer. Other available options are call-forward busy and call-forward all.

ephone-dn

Cisco IP phone directory number.

huntstop

Huntstop is set.

number

Cisco IP phone number.

timeout

Timeout setting for call forwarding when an extension does not answer.


Related Commands

Command
Description

show telephony-service all

Displays the detailed configuration of all the Cisco IP phones.

show telephony-service dial-peer

Displays dial peer information for extensions (ephone-dns) in a Cisco CME system.

show telephony-service voice-port

Displays configurations for virtual voice ports in a Cisco CME system.


show telephony-service ephone-dn-template

To display information about ephone-dn-template configurations, use the show telephony-service ephone-dn-template command in user EXEC or privileged EXEC mode.

show telephony-service ephone-dn-template

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

This command displays contents of ephone-dn templates. Use the show running-config command to display the association of templates to particular ephone-dns.

Examples

The following is sample output from this command:

Router# show telephony-service ephone-dn-template

ephone-template 1
 softkeys idle Newcall Redial Cfwdall Dnd Pickup Gpickup Login
 codec g711ulaw
 User Locale: US
 Network Locale: US

ephone-template 2
 softkeys idle Redial Newcall Dnd Cfwdall Pickup Gpickup Login
 codec g711ulaw
 User Locale: US
 Network Locale: US

Related Commands

Command
Description

ephone-dn-template

Creates an ephone-dn template and enters ephone-dn-template configuration mode.


show telephony-service ephone-template

To display the contents of ephone-templates, use the show telephony-service ephone-template command in user EXEC or privileged EXEC mode.

show telephony-service ephone-template

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.3(11)T

Cisco CME 3.2

This command was introduced.

12.4(11)XJ

Cisco Unified CME 4.1

The conference add-mode, conference drop-mode, and conference admin fields were added.

12.4(15)T

Cisco Unified CME 4.1

This command with the conference add-mode, conference drop-mode, and conference admin fields was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

This command displays the contents of each ephone template that has been defined. Use the show running-config command to display the association of templates to particular ephones.

Examples

The following is sample output from this command:

Router# show telephony-service ephone-template

ephone-template 1
softkey hold Join Newcall Resume Select
softkey idle Cfwdall ConfList Dnd Gpickup HLog Join Login Newcall Pickup Redial RmLstC
softkey seized Callback Cfwdall Endcall Gpickup HLog Meetme Pickup Redial
softkey alerting Acct Callback Endcall
softkey connected Acct ConfList Confrn Endcall Flash HLog Hold Join Park RmLstC Select Trnsfer
conference drop-mode local
conference add-mode creator
conference admin: Yes
Always send media packets to this router: No
Preferred codec: g711ulaw
button-layout 7931 1
User Locale: US
Network Locale: US

Table 40 describes significant fields in this output.

Table 42 show telephony-service ephone Field Descriptions   

Field
Description

ephone-template

Identifier for the ephone template.

softkey hold

Soft keys displayed during the hold call stage.

softkey idle

Soft keys displayed during the call-idle call stage.

softkey seized

Soft keys displayed during the call-seized call stage.

softkey alerting

Soft keys displayed during the call-alerting call stage.

softkey connected

Soft keys displayed during the call-connected call stage.

conference drop-mode

When conferences are dropped:

creator—Conference terminates when the creator hangs up.

local—Conference terminates when the last local party in the conference hangs up or drops out of the conference.

never—Conference is not dropped, even if the creator hangs up, as long as three parties remain in the conference.

conference add-mode

Who can add parties to a conference:

creator—Only the creator can add parties.

all—Any party can add other parties if the creator remains in the conference.

conference admin

Ad hoc and meet-me hardware conference administrator. The administrator can:

Dial in to any conference directly through the conference number

Use the ConfList soft key to list conference parties

Remove any party from any conference

Always send media packets to this router

Always send media packets to this Cisco Unified CME router, which acts as a proxy and forwards the packets to the destination, instead of sending them directly to the destination IP phone.

Preferred codec

Codec to use when initiating a call.

button-layout

Type of IP phone and number of fixed line or feature set.

1—Button 24=Menu. Button 23=Headset.

2—Button 24=Menu. Button 23=Headset. Button 22=Directories. Button 21=Messages.

User Locale

Locale that is associated with the phone user interface. The user locale identifies a set of detailed information, including language and font, to support users.

Network Locale

Locale that is associated with the phone. The network locale contains a definition of the tones and cadences that are used by the phones and gateways in the device pool in a specific geographic area.


Related Commands

Command
Description

ephone-template

Creates an ephone template and enters ephone-template configuration mode.


show telephony-service fac

To display current feature access codes (FACs), use the show telephony-service fac command in privileged EXEC mode.

show telephony-service fac

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

Phone users dial FACs to access phone features. The set of standard FACs must be enabled using the fac standard command before phone users can use them. Individual FACs can be changed using the fac custom command.

Examples

The following example displays the set of standard FACs:

Router# show telephony-service fac

telephony-service fac standard
 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

Related Commands

Command
Description

fac

Enables standard FACs or creates a custom FAC.


show telephony-service security-info

To display the security-related information that is configured under telephony-service, use the show telephony-service security-info command in privileged EXEC configuration mode.

show telephony-service security-info

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

This command is used with Cisco Unified CME phone authentication.

Examples

The following example displays security information that was configured under telephony-service.

Router# show telephony-service security-info

Skinny Server Trustpoint for TLS: cisco1
TFTP Credentials Trustpoint: cisco1
Server Security Mode: Secure
Global Device Security Mode: Authenticated

show telephony-service tftp-bindings

To display the current configuration files accessible to IP phones, use the show telephony-service tftp-bindings command in user EXEC or privileged EXEC mode.

show telephony-service tftp-bindings

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.2(11)YT

2.1

This command was introduced.

12.2(15)T

2.1

This command was integrated into Cisco IOS Release 12.2(15)T.


Usage Guidelines

Use this command with Cisco IOS Telephony Services V2.1, Cisco CallManager Express 3.0, or a later version.

This command provides a list of configuration files that are accessible to IP phones using TFTP, including the dictionary, language, and tone configuration files that are associated with the ISO-3166 codes that have been selected using the user-locale and network-locale commands.

Examples

The following is sample output from the show telephony-service tftp-bindings command when the ISO-3166 code for Germany has been selected for both language and tones:

Router(config)# show telephony-service tftp-bindings


tftp-server system:/its/SEPDEFAULT.cnf

tftp-server system:/its/SEPDEFAULT.cnf alias SEPDefault.cnf

tftp-server system:/its/XMLDefault.cnf.xml alias XMLDefault.cnf.xml

tftp-server system:/its/ATADefault.cnf.xml

tftp-server system:/its/XMLDefault7960.cnf.xml alias SEP00036B54BB15.cnf.xml

tftp-server system:/its/germany/7960-font.xml alias German_Germany/7960-font.xml

tftp-server system:/its/germany/7960-dictionary.xml alias German_Germany/7960-dictionary.xml

tftp-server system:/its/germany/7960-kate.xml alias German_Germany/7960-kate.xml

tftp-server system:/its/germany/SCCP-dictionary.xml alias German_Germany/SCCP-dictionary.xml

tftp-server system:/its/germany/7960-tones.xml alias Germany/7960-tones.xml


Related Commands

Command
Description

network-locale

Sets the definition of the tones and cadences on the Cisco IP Phones 7940 and 7940G and the Cisco IP Phones 7960 and 7960G for a specific geographic area.

user-locale

Sets language for displays on the Cisco IP Phones 7940 and 7940G and the Cisco IP Phones 7960 and 7960G.


show telephony-service voice-port

To display configurations of virtual voice ports in a Cisco CallManager Express (Cisco CME) system, use the show telephony-service voice-port command in user EXEC or privileged EXEC mode.

show telephony-service voice-port

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.1(5)YD

1.0

This command was introduced on the Cisco 2600 series, Cisco 3600 series, and Cisco IAD2420 series.

12.2(2)XT

2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T

2.0

This command was implemented on the Cisco 1750 and Cisco 1751.

12.2(8)T1

2.0

This command was implemented on the Cisco 2600XM and Cisco 2691.

12.2(11)T

2.01

This command was implemented on the Cisco 2600XM and Cisco 2691.


Usage Guidelines

This command displays virtual voice-port configurations for a Cisco CME system. Each ephone-dn corresponds to a virtual voice port. For example, the ephone-dn with dn-tag 7 corresponds to virtual voice port 50/0/7. The virtual voice port provides the telephone line associated with the Cisco IP phone extension (ephone-dn).

Examples

The following is sample output from this command:

Router# show telephony-service voice-port

voice-port 50/0/1
station-id number 5001
!
voice-port 50/0/2
station-id number 5002
timeout ringing 8
!
voice-port 50/0/3
station-id number 5003
!
voice-port 50/0/4
station-id number 5004
!

Table 43 describes significant fields in this output, in alphabetical order.

Table 43 show telephony-service voice-port Field Descriptions 

Field
Description

station-id number

Phone number used for caller ID purposes for calls made from this voice port.

timeout ringing

Maximum amount of time that a phone is allowed to ring before the call is disconnected.

voice-port

Virtual voice port.


Related Commands

Command
Description

show telephony-service all

Displays the detailed configuration of all the Cisco IP phones.

show telephony-service dial-peer

Displays dial-peer information for extensions in a Cisco CME system.

show telephony-service ephone-dn

Displays information for extensions (ephone-dns) in a Cisco CME system.


show voice register all

To display all Cisco Unified Session Initiation Protocol (SIP) Survivable Remote Site Telephony (SRST) and Cisco Unified CallManager Express (Cisco Unified CME) configurations and register information, use the show voice register all command in privileged EXEC mode.

show voice register all

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.2(15)ZJ

Cisco SIP SRST 3.0

This command was introduced.

12.3(4)T

Cisco SIP SRST 3.0

This command was integrated into Cisco IOS Release 12.3(4)T.

12.4(4)T

Cisco CME 3.4 and Cisco SIP SRST 3.4

This command was added to Cisco CME.


Examples

Cisco Unified SIP SRST

The following is sample output from this command displaying all register information:

Router# show voice register all

Pool Tag 1
Config:
Network address is 192.168.0.0, Mask is 255.255.0.0
Number list 1 : Pattern is 50.., Preference is 2
Proxy Ip address is 0.0.0.0
Default preference is 2
Incoming called number is
Translate outgoing called tag is 1
Class of Restriction List Tag: default
Incoming corlist name is allowall
Application is default.new

Dialpeers created:

dial-peer voice 40007 voip
application default.new
corlist incoming allowall
preference 2
incoming called-number 5001
destination-pattern 5001
redirect ip2ip
session target ipv4:192.168.0.3
session protocol sipv2
translate-outgoing called 1
voice-class codec 1

Statistics:
Active registrations : 2

Total Registration Statistics
Registration requests : 47
Registration success : 47
Registration failed : 0
unRegister requests : 45
unRegister success : 45
unRegister failed : 0

Cisco Unified CME

The following is sample output from this command displaying all register information:

Router# show voice register all

VOICE REGISTER GLOBAL ===================== CONFIG [Version=4.0(0)] ======================== Version 4.0(0) Mode is cme Max-pool is 24 Max-dn is 72 Source-address is 172.18.202.243 port 5060 Load ata ATA030200SIP041111A.zup Load 7960-40 is P0S3-07-4-00 Time-format is 12 Date-format is YY-M-D Time-zone is 5 Hold-alert is enabled Mwi stutter is enabled Mwi registration for full E.164 is enabled Forwarding local is enabled Dst auto adjust is enabled start at Apr week 1 day Sun time 02:00 stop at Oct week 8 day Sun time 02:00 Voicemail number is 7788 Max redirect number is 20 Telnet Level: 2 Tftp path is system:/cme/sipphone Generate text file is enabled Tftp files are created, current syncinfo 0002917733516824 OS79XX.TXT is not created VOICE REGISTER DN ================= Dn Tag 1 Config: Number is 7001 Preference is 0 Huntstop is disabled Name christoper robert Auto answer is disabled Label is jennifer nicole Dn Tag 2 Config: Number is 7002 Preference is 0 Huntstop is disabled Name Jenny Auto answer is disabled Dn Tag 3 Config: Number is 7003 Preference is 0 Huntstop is disabled Name nino Auto answer is disabled Dn Tag 4 Config: Number is 7004 Preference is 0 Huntstop is disabled Auto answer is disabled Dn Tag 5 Config: Number is 7005 Preference is 0 Huntstop is disabled Name ABBY Auto answer is disabled Dn Tag 6 Config: Number is 7006 Preference is 0 Huntstop is disabled Name jayce Auto answer is disabled MWI registration is enabled. Dn Tag 7 Config: Number is 7007 Preference is 0 Huntstop is disabled Name bugs Auto answer is enabled Label is daffy Dn Tag 8 Config: Number is 7008 Preference is 0 Huntstop is disabled Name Bob Auto answer is disabled VOICE REGISTER TEMPLATE ======================= Temp Tag 1 Config: Attended Transfer is enabled Blind Transfer is enabled Semi-attended Transfer is enabled Conference is enabled Caller-ID block is disabled DnD control is enabled Anoymous call block is disabled Temp Tag 2 Config: Attended Transfer is enabled Blind Transfer is enabled Semi-attended Transfer is enabled Conference is disabled Caller-ID block is disabled DnD control is enabled Anoymous call block is disabled Voicemail is 7788, timeout 5 Temp Tag 3 Config: Attended Transfer is enabled Blind Transfer is enabled Semi-attended Transfer is enabled Conference is enabled Caller-ID block is disabled DnD control is enabled Anoymous call block is disabled Temp Tag 5 Config: Attended Transfer is enabled Blind Transfer is enabled Semi-attended Transfer is enabled Conference is enabled Caller-ID block is disabled DnD control is enabled Anoymous call block is disabled VOICE REGISTER POOL =================== Pool Tag 1 Config: Mac address is 000D.ED22.EDFE Type is 7960 Number list 1 : DN 1 Proxy Ip address is 0.0.0.0 Default preference is 1 DTMF Relay is disabled Call Waiting is disabled DnD is disabled keep-conference is enabled template is 1 Dialpeers created: Statistics: Active registrations : 0 Total Registration Statistics Registration requests : 0 Registration success : 0 Registration failed : 0 unRegister requests : 0 unRegister success : 0 unRegister failed : 0 Pool Tag 2 Config: Mac address is 000D.ED23.CBA0 Type is 7960 Number list 1 : DN 2 Number list 2 : DN 2 Proxy Ip address is 0.0.0.0 Default preference is 1 DTMF Relay is enabled, rtp-nte Call Waiting is enabled DnD is disabled speed-dial 3 7001 speed-dial 4 7701 keep-conference is enabled template is 1 Dialpeers created: dial-peer voice 40003 voip <----------------------------------------------------------------------------------------- --------------------------------- destination-pattern 7002 redirect ip2ip session target ipv4:172.18.202.251:5060 session protocol sipv2 dtmf-relay rtp-nte after-hours-exempt FALSE Statistics: Active registrations : 2 Total Registration Statistics Registration requests : 2 Registration success : 2 Registration failed : 0 unRegister requests : 0 unRegister success : 0 unRegister failed : 0 Pool Tag 3 Config: Mac address is 0030.94C3.035E Type is 7960 Number list 1 : DN 3 Number list 3 : DN 3 Proxy Ip address is 0.0.0.0 DTMF Relay is disabled Call Waiting is enabled DnD is disabled keep-conference is enabled template is 2 Dialpeers created: Statistics: Active registrations : 0 Total Registration Statistics Registration requests : 0 Registration success : 0 Registration failed : 0 unRegister requests : 0 unRegister success : 0 unRegister failed : 0 Pool Tag 5 Config: Mac address is 0012.019B.3FD8 Type is ATA Number list 1 : DN 5 Proxy Ip address is 0.0.0.0 Default preference is 1 DTMF Relay is disabled Call Waiting is enabled DnD is disabled keep-conference is enabled Dialpeers created: Statistics: Active registrations : 0 Total Registration Statistics Registration requests : 0 Registration success : 0 Registration failed : 0 unRegister requests : 0 unRegister success : 0 unRegister failed : 0 Pool Tag 6 Config: Mac address is 0012.019B.3E88 Type is ATA Number list 1 : DN 6 Number list 2 : DN 7 Proxy Ip address is 0.0.0.0 Default preference is 1 DTMF Relay is enabled, rtp-nte Call Waiting is enabled DnD is disabled call-forward b2bua all 7788 keep-conference is enabled template is 2 Dialpeers created: dial-peer voice 40001 voip <----------------------------------------------------------------------------------------- ------------------ destination-pattern 7006 redirect ip2ip session target ipv4:172.18.202.32:5060 session protocol sipv2 dtmf-relay rtp-nte call-fwd-all 7788 after-hours-exempt FALSE dial-peer voice 40002 voip destination-pattern 7007 redirect ip2ip session target ipv4:172.18.202.32:5060 session protocol sipv2 dtmf-relay rtp-nte call-fwd-all 7788 after-hours-exempt FALSE Statistics: Active registrations : 2 Total Registration Statistics Registration requests : 2 Registration success : 2 Registration failed : 0 unRegister requests : 0 unRegister success : 0 unRegister failed : 0 Nothing configured yet Pool Tag 8 Config: Mac address is 0006.D737.CC42 Type is 7940 Number list 1 : DN 8 Proxy Ip address is 0.0.0.0 Default preference is 1 DTMF Relay is disabled Call Waiting is enabled DnD is disabled keep-conference is enabled template is 5 Dialpeers created: Statistics: Active registrations : 0 Total Registration Statistics Registration requests : 0 Registration success : 0 Registration failed : 0 unRegister requests : 0 unRegister success : 0 unRegister failed : 0 Pool Tag 9 Config: Mac address is 0030.94C3.0831 Proxy Ip address is 0.0.0.0 DTMF Relay is disabled Call Waiting is enabled DnD is disabled keep-conference is enabled Dialpeers created: Statistics: Active registrations : 0 Total Registration Statistics Registration requests : 0 Registration success : 0 Registration failed : 0 unRegister requests : 0 unRegister success : 0 unRegister failed : 0 Pool Tag 10 Config: Mac address is 000D.ED22.EDFE Proxy Ip address is 0.0.0.0 DTMF Relay is disabled Call Waiting is disabled DnD is disabled call-forward b2bua all 1234 keep-conference is enabled Dialpeers created: Statistics: Active registrations : 0 Total Registration Statistics Registration requests : 0 Registration success : 0 Registration failed : 0 unRegister requests : 0 unRegister success : 0 unRegister failed : 0 Nothing configured yet

Table 47 describes significant fields shown in this output.

Table 44 show voice register all Field Descriptions 

Field
Description

Pool Tag

Used with the all and pool keywords. Shows the assigned tag number of the current pool.

Config:

Used with the all and pool keywords. Shows the voice register pool.

Network address and Mask

Used with the all and pool keywords. Shows network address and mask information if the id command is configured.

Number list, Pattern, and Preference

Used with the all and pool keywords. Shows the number command configuration.

Proxy IP address

Used with the all and pool keywords. Shows the proxy command configuration.

Default preference

Used with the all and pool keywords. Shows the default preference value of this pool.

Incoming called number

Used with the all and pool keywords. Shows the incoming called-number command configuration.

Translate outgoing called tag

Used with the all and pool keywords. Shows the translate-outgoing command configuration.

Class of Restriction List Tag

Used with the all and pool keywords. Shows the COR tag.

Incoming corlist name

Used with the all and pool keywords. Shows the cor command configuration.

Application

Used with the all and pool keywords. Shows the application command configuration for this pool.

Dialpeers created:

Used with the all and pool keywords. What follows is a list of all dial peers created and their contents. Dial-peer contents differ per application and are not described here.

Statistics:

Used with the all, pool, and statistics keywords. Shows the registration statistics for this pool.

Active registrations

Used with the all, pool, and statistics keywords. Shows the current active registrations.

Total Registration Statistics

Used with the all, pool, and statistics keywords. Shows the total registration statistics for this pool.

Registration requests

Used with the all, pool, and statistics keywords. Shows the incoming registration requests.

Registration success

Used with the all, pool, and statistics keywords. Shows the successful registrations.

Registration failed

Used with the all, pool, and statistics keywords. Shows the failed registrations.

unRegister requests

Used with the all, pool, and statistics keywords. Shows the incoming unregister/registration expire requests.

unRegister success

Used with the all, pool, and statistics keywords. Reports the number of successful unregisters.

unRegister failed

Used with the all, pool, and statistics keywords. Reports the number of failed unregisters.


Related Commands

Command
Description

show sip-ua status registrar

Displays all the SIP endpoints currently registered with the contact address.

show voice register all

Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.

show voice register 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.


show voice register credential

To display configuration information associated with a credential file used for authorization, use the show voice register credential command in privileged EXEC mode.

show voice register credential

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XJ

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

This command was integrated into Cisco IOS Release 12.4(15)T.


Examples

The following is sample output from this command:

Router# show voice register credential

username: Jsmith, password: 1234abc, service: PRESENCE , file index 3
username: Ksample, password: xyz1234, service: PRESENCE , file index 3
username: Mmore, password: updwssc, service: PRESENCE , file index 3
username: Sstove, password: 12bms, service: PRESENCE , file index 3
username: Yjones, password: 357llvrus, service: PRESENCE , file index 5
username: Yjones2, password: 55rrtuv, service: PRESENCE OOD_REFER , file index 5
username: vtemp, password: 1234567, service: PRESENCE , file index 5

Table 49 contains descriptions of fields shown in the output, listed in order of appearance.

Table 45 show voice register credential Field Descriptions 

Field
Description

username

Username that is authorized.

password

Password that is authorized.

service

Type of service for which the credential file is used; presence or Out-of-dialog REFER (OOD-R).

file index

Identification number of the credential file defined with the authenticate command.


Related Commands

Command
Description

authenticate (voice register global)

Defines the authenticate mode for SIP phones in a Cisco Unified CME system.

credential load

Reloads a credential file into Flash memory.

show voice register all

Displays all Cisco Unified CME and Cisco Unified SIP SRST configurations and register information.


show voice register dial-peers

To display details of all dynamically created VoIP dial peers associated with the Cisco Unified Session Initiation Protocol (SIP) Survivable Remote Site Telephony (SRST) or Cisco Unified CallManager Express (Cisco Unified CME) register event, use the show voice register dial-peers command in privileged EXEC mode.

show voice register dial-peers

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.2(15)ZJ

Cisco SIP SRST 3.0

This command was introduced.

12.3(4)T

Cisco SIP SRST 3.0

This command was integrated into Cisco IOS Release 12.3(4)T.

12.4(4)T

Cisco CME 3.4
Cisco SIP SRST 3.4

This command was added to Cisco CME.


Examples

Cisco Unified SIP SRST

The following is sample output from this command displaying all dial peers:

Router# show voice register dial-peers

dial-peer voice 40024 voip
corlist incoming call91
preference 5
destination-pattern 91011
redirect ip2ip
session target ipv4:192.168.0.2
session protocol sipv2
translate-outgoing called 1
voice-class codec 1

dial-peer voice 40025 voip
destination-pattern 40891011
redirect ip2ip
session target ipv4:192.168.0.2
session protocol sipv2
translate-outgoing called 1
voice-class codec 1

dial-peer voice 40026 voip
preference 8
destination-pattern 94...
redirect ip2ip
session target ipv4:192.168.0.2
session protocol sipv2
translate-outgoing called 1
voice-class codec 1

dial-peer voice 40027 voip
preference 1
destination-pattern 91011
redirect ip2ip
session target ipv4:10.2.161.187
session protocol sipv2
voice-class codec 1
monitor probe icmp-ping 10.2.161.187

Related Commands

Command
Description

show sip-ua status registrar

Displays all the SIP endpoints currently registered with the contact address.

show voice register all

Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.

show voice register pool

Displays all configuration information associated with a particular voice register pool.


show voice register dialplan

To display all configuration information for a specific SIP dial plan, use the show voice register dialplan command in privileged EXEC mode.

show voice register dialplan tag

Syntax Description

tag

Number that identifies the SIP dial plan. Range: 1 to 24.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XJ

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

Use this command to verify the configuration of SIP dial plans. You define a dial plan with the voice register dialplan command and assign it to a SIP phone with the dialplan command.

Examples

The following is sample output from this command displaying information for dial plan 1:

Router# show voice register dialplan 1

Dialplan Tag 1
Config:
Type is 7940-7960-others
Pattern 1 is 2..., timeout is 10, user option is ip, button is default
Pattern 2 is 1234, timeout is 0, user option is ip, button is 4
Pattern 3 is 65..., timeout is 0, user option is phone, button is default
Pattern 4 is 1..., timeout is 0, user option is phone, button is default

Table 47 contains descriptions of significant fields shown in this output, listed in alphabetical order.

Table 46 show voice register dialplan Field Descriptions 

Field
Description

Config:

List of configuration options defined for this SIP dial plan.

Dialplan Tag

Tag number of the requested SIP dial plan.

Pattern

Dial pattern defined for a SIP dial plan with the pattern command in voice register dialplan configuration mode.

Type

Phone type defined for a SIP dial plan with the type command.


Related Commands

Command
Description

dialplan

Assigns a dial plan to a SIP phone.

pattern (voice register dialplan)

Defines a dial pattern for a SIP dial plan.

show voice register all

Displays all Cisco Unified CME configurations and register information.

show voice register pool

Displays all configuration information associated with a particular voice register pool.

type (voice register dialplan)

Defines a phone type for a SIP dial plan.

voice register dialplan

Enters voice register dialplan configuration mode to define a dial plan for SIP phones.

voice register pool

Enters voice register pool configuration mode for SIP phones.


show voice register dn

To display all configuration information associated with a specific voice register dn, use the show voice register dn command in privileged EXEC mode.

show voice register dn tag

Syntax Description

tag

Tag number of the voice register dn for which to display information. Range is 1 to 750.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4 and Cisco SIP SRST 3.4

This command was introduced.


Usage Guidelines

This command can also be used for Cisco SIP SRST.

Examples

The following is sample output from this command displaying information for voice register dn 148:

Router# show voice register dn 148

Dn Tag 148
Config:
Number is 1100
Preference is 0
Huntstop is disabled
Auto answer is disabled

Table 47 contains descriptions of significant fields shown in this output, listed in alphabetical order.

Table 47 show voice register dn Field Descriptions 

Field
Description

Auto answer

Status of auto-answer feature defined with the auto-answer command.

Config:

List of configuration options defined for this voice register dn.

Dn Tag

Tag number of the requested voice register dn.

Huntstop

Status of huntstop behavior defined with the huntstop command.

Number

Telephone or extension number set with the number command in voice register dn configuration mode.

Preference

Preference order set with the preference command in voice register dn configuration mode.


Related Commands

Command
Description

show sip-ua status registrar

Displays all the SIP endpoints currently registered with the contact address.

show voice register all

Displays all Cisco SIP SRST and Cisco CME configurations and register information.

show voice register dial-peer

Displays details of all dynamically created VoIP dial peers associated with the Cisco SIP SRST or Cisco CME register event.

show voice register pool

Displays all configuration information associated with a particular voice register pool.

voice register 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.


show voice register global

To display all global configuration parameters associated with SIP phones, use the show voice register global command in privileged EXEC mode.

show voice register global

Syntax Description

This command has no arguments or keywords.

Command Default

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)T

Cisco CME 3.4
Cisco SIP SRST 3.4

This command was introduced.


Examples

Cisco Unified CME

The following is sample output from this command:

Router# show voice register global
CONFIG [Version=3.4(0)]
========================
Version 3.4(0)
Mode is cme
Max-pool is 48
Max-dn is 48
Source-address is 10.0.2.4 port 5060
Load 7960-40 is P0S3-07-4-07
Time-format is 12
Date-format is M/D/Y
Time-zone is 5
Hold-alert is disabled
Mwi stutter is disabled
Mwi registration for full E.164 is disabled
Forwarding local is enabled
Dst auto adjust is enabled
 start at Apr week 1 day Sun time 02:00
 stop at Oct week 8 day Sun time 02:00
Max redirect number is 5
Telnet Level: 2
Tftp path is system:/cme/sipphone
Generate text file is disabled
Tftp files are created, current syncinfo 0002830590524159
OS79XX.TXT is not created
Router#

Cisco Unified SIP SRST

Router# show voice register global

CONFIG [Version=3.4(0)]
======================================================
   Version 3.4(0)
   Mode is SIP SRST
   Max-pool is 10
   Max-dn is 10

Table 48 contains descriptions of significant fields shown in this output, listed in alphabetical order.

Table 48 show voice register global Field Descriptions 

Field
Description

Date-format

Value of date-format command.

DST auto adjust

Setting of dst auto-adjust command.

Forwarding local

Setting of forwarding local command.

Generate text file

Setting of text file command.

Hold-alert

Setting of hold-alert command.

Load

Value of load command.

Max-dn

Reports the maximum number of SIP voice register directory numbers (dns) supported by the Cisco Unified SIP CME or Cisco Unified SIP SRST router as configured with the max-dn command. The maximum possible number is platform-dependent.

Max-pool

Reports the maximum number of SIP voice register pools supported by the Cisco Unified SIP SRST or Cisco Unified CME router as configured with the max-pool command. The maximum possible number is platform-dependent.

Max redirect number

Maximum number of redirects set with the max-redirect command.

Mode

Reports the mode as configured with the mode command. Value can be either Cisco Unified CME or Cisco Unified SIP SRST.

MWI registration

Setting of mwi command.

MWI stutter

Setting of mwi stutter command.

Time-format

Value of time-format command.

Time-zone

Number of the timezone selected with the timezone command.

TFTP path

Directory location of provisioning files for SIP phones that is specified with the tftp-path command.

Version

Reports the Cisco Unified SIP SRST or Cisco Unified CME version number.


Related Commands

Command
Description

show sip-ua status registrar

Displays all the SIP endpoints currently registered with the contact address.

show voice register all

Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.

show voice register dial-peer

Displays details of all dynamically created VoIP dial peers associated with the Cisco Unified SIP SRST or Cisco Unified CME register event.

voice register global

Enters voice register global configuration mode in order to set global parameters for all supported Cisco SIP phones in a Cisco Unified CME or Cisco Unified SIP SRST environment.


show voice register pool

To display all configuration information associated with a particular voice register pool, use the show voice register pool command in privileged EXEC mode.

show voice register pool pool-tag

Syntax Description

pool-tag

Tag number of the voice register pool for which to display information. The maximum number of pools is version and platform dependent; refer to Cisco IOS command-line interface (CLI) help.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.2(15)ZJ

Cisco SIP SRST

This command was introduced.

12.3(4)T

Cisco SIP SRST

This command was integrated into Cisco IOS Release 12.3(4)T.

12.4(4)T

Cisco CME 3.4

This command was introduced.


Examples

Cisco Unified CME

The following is sample output from this command displaying information for voice register pool 33:

Router# show voice register pool 33
Pool Tag 33
Config:
 Mac address is 0009.B7F7.532E
 Type is 7960
 Number list 1 : DN 1
 Number list 2 : DN 2
 Number list 3 : DN 3
 Number list 4 : DN 4
 Number list 5 : DN 5
 Number list 6 : DN 6
 Proxy Ip address is 0.0.0.0
 DTMF Relay is disabled
 Call Waiting is enabled
 keep-conference is enabled
 template is 1

Cisco Unified SIP SRST

The following is sample output from this command displaying all information for voice register pool 1:

Router# show voice register pool 1

Pool Tag 1
Config:
Network address is 192.168.0.0, Mask is 255.255.0.0
Number list 1 : Pattern is 50.., Preference is 2
Proxy Ip address is 0.0.0.0
Default preference is 2
Incoming called number is
Translate outgoing called tag is 1
Class of Restriction List Tag: default
Incoming corlist name is allowall
Application is default.new

Dialpeers created:

dial-peer voice 40007 voip
application default.new
corlist incoming allowall
preference 2
incoming called-number 5001
destination-pattern 5001
redirect ip2ip
session target ipv4:192.168.0.3
session protocol sipv2
translate-outgoing called 1
voice-class codec 1

Statistics:
Active registrations : 2

Total Registration Statistics
Registration requests : 48
Registration success : 48
Registration failed : 0
unRegister requests : 46
unRegister success : 46
unRegister failed : 0

Table 49 contains descriptions of significant fields shown in the Cisco Unified SIP SRST and Cisco Unified CME output, listed in alphabetical order.

Table 49 show voice register pool Field Descriptions 

Field
Description

Active registrations

Used with the all, pool, and statistics keywords. Shows the current active registrations.

Application

Used with the all and pool keywords.  Shows the application command configuration for this pool.

Call Waiting

Setting of call-waiting command.

Config:

Used with the all and pool keywords. Shows the voice register pool.

Class of Restriction List Tag

Used with the all and pool keywords. Shows the COR tag.

Default preference

Used with the all and pool keywords. Shows the default preference value of this pool.

Dialpeers created:

Used with the all and pool keywords. What follows is a list of all dial peers created and their contents. Dial-peer contents differ per application and are not described here.

DnD

Setting of dnd-control command.

DTMF Relay

Setting of dtmf-relay command.

Incoming called number

Used with the all and pool keywords. Shows the incoming called-number command configuration.

Incoming corlist name

Used with the all and pool keywords. Shows the cor command configuration.

keep-conference

Status of keep-conference command.

Mac address

MAC address of this SIP phone as defined by using the id command.

Network address and Mask

Used with the all and pool keywords. Shows network address and mask information if the id command is configured.

Number list, Pattern, and Preference

Used with the all and pool keywords. Shows the number (voice register pool) command configuration.

Pool Tag

Used with the all and pool keywords. Shows the assigned tag number of the current pool.

Proxy Ip address

Used with the all and pool keywords. Shows the proxy command configuration; that is, the IP address of external SIP server.

Registration failed

Used with the all, pool, and statistics keywords. Shows the failed registrations.

Registration requests

Used with the all, pool, and statistics keywords. Shows the incoming registration requests.

Registration success

Used with the all, pool, and statistics keywords. Shows the successful registrations.

Statistics:

Used with the all, pool, and statistics keywords. Shows the registration statistics for this pool.

Template

Template-tag number for template that is applied to this SIP phone.

Translate outgoing called tag

Used with the all and pool keywords. Shows the translate-outgoing command configuration.

Total Registration Statistics

Used with the all, pool, and statistics keywords. Shows the total registration statistics for this pool.

Type

Phone type identified for this SIP phone using the type command.

unRegister requests

Used with the all, pool, and statistics keywords. Shows the incoming unregister/registration expire requests.

unRegister success

Used with the all, pool, and statistics keywords. Reports the number of successful unregisters.

unRegister failed

Used with the all, pool, and statistics keywords. Reports the number of failed unregisters.

Username Password

Values within authentication credential.


Related Commands

Command
Description

show sip-ua status registrar

Displays all the SIP endpoints currently registered with the contact address.

show voice register all

Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.

show voice register dial-peer

Displays details of all dynamically created VoIP dial peers associated with the Cisco Unified SIP SRST or Cisco Unified CME register event.

voice register pool

Enters voice register pool configuration mode for SIP phones.


show voice register profile

To display the content of configuration files that are in ASCII text format, use the show voice register profile command in privileged EXEC mode.

show voice register profile text tag

Syntax Description

tag

Unique identifier for voice register profile to be displayed. Range is 1-500.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4

This command was introduced.


Usage Guidelines

Use this command to display ASCII configuration files for the Cisco IP Phone 7905 and 7905G, Cisco IP Phone 7912 and 7912G, Cisco ATA-186, or Cisco ATA-188. To generate ASCII text files, use the file text command.

Examples

The following is sample output from this command displaying information in the configuration profile for voice register pool 4:

Router# show voice register profile text 4
 Pool Tag: 4
#txt
 AutoLookUp:0
 DirectoriesUrl:0
...
 CallWaiting:1
 CallForwardNumber:0
 Conference:1
 AttendedTransfer:1
 BlindTransfer:1
...
 SIPRegOn:1
 UseTftp:1
 UseLoginID:0
 UIPassword:0
 NTPIP:0.0.0.0
 UID:2468
...

Table 50 contains descriptions of significant fields shown in this output, listed in alphabetical order.

Table 50 show voice register profile Field Descriptions 

Field
Description

Attended Transfer

Setting of soft key for attended transfer in a SIP phone template as defined by using the transfer-attended command. "1" indicates that the soft key is enabled; "0" indicates that the soft key is disabled.

Auto Lookup

1 indicates that Auto Lookup is enabled.
0 indicates that it is disabled.

Blind Transfer

Setting of soft key for blind transfer in a SIP phone template as defined by using the transfer-blind command. "1" indicates that the soft key is enabled; "0" indicates that the soft key is disabled.

Call Waiting

Setting of the call-waiting option on a SIP phone as defined by using the call-waiting command. "1" indicates that the soft key is enabled; "0" indicates that the soft key is disabled.

Call Forward Number

Number to which incoming calls are forwarded

Conference

Setting of soft key for conference in a SIP phone template as defined by using the conference command. "1" indicates that the soft key is enabled; "0" indicates that the soft key is disabled.

Directories URL

1 indicates that the Directories feature button for the phone is enabled. 0 indicates that it is disabled.

NTPIP

IP address for the NTP source

Pool tag

Pool tag of the configuration file being requested.

SIP Reg On

1 indicates that the registration with external proxy server for the phone is enabled.
0 indicates that it is disabled.

UI Password

1 indicates that the UI password is enabled on the phone.
0 indicates that dit is disabled.

UID

Authenticatuion credential for SIP phone.

Use Login ID

1 indicates that "use login id" for phone is enabled.
0 indicates that it is disabled.


Related Commands

Command
Description

create profile (voice register global)

Generates the configuration profiles required for SIP phone.

file text (voice register global)

Generates ASCII text files for the Cisco IP Phone 7905 and 7905G, Cisco IP Phone 7912 and 79012G, Cisco ATA-186, or Cisco ATA-188.

reset (voice register global)

Performs a complete reboot of all SIP phones associated with a Cisco CME router.

voice register global

Enters voice register global configuration mode in order to set global parameters for all supported Cisco SIP phones in a Cisco CME or Cisco SIP SRST environment.


show voice register statistics

To display statistics associated with the registration event, use the show voice register statistics command in privileged EXEC mode.

show voice register statistics

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.2(15)ZJ

Cisco SIP SRST 3.0

This command was introduced.

12.3(4)T

Cisco SIP SRST 3.0

This command was integrated into Cisco IOS Release 12.3(4)T.

12.4(4)T

Cisco CME 3.4
Cisco SIP SRST 3.4

This command was added to Cisco CME.


Usage Guidelines

When using the show voice register statistics command, you can verify that the number of Registration and unRegister successes for global statistics are the sum of the values in the individual pools. Because some Registrations fail even before matching a voice register pool, for Registration and unRegister failed statistics the value is not the sum of the values in the individual pools. Immediate failures are accounted in the global statistics.

Examples

The following is sample output from this command displaying all statistical information:

Router# show voice register statistics

Global statistics
Active registrations : 3
Total Registration Statistics
Registration requests : 7
Registration success : 4
Registration failed : 3
unRegister requests : 1
unRegister success : 1
unRegister failed : 0
Register pool 1 statistics
Active registrations : 1
Total Registration Statistics
Registration requests : 3
Registration success : 2
Registration failed : 1
unRegister requests : 1
unRegister success : 1
unRegister failed : 0
Register pool 2 statistics
Active registrations : 2
Total Registration Statistics
Registration requests : 2
Registration success : 2
Registration failed : 0
unRegister requests : 0
unRegister success : 0
unRegister failed : 0

Table 47 describes significant fields shown in this output.

Table 51 show voice register statistics Field Descriptions 

Field
Description

Statistics:

Used with the all, pool, and statistics keywords. Shows the registration statistics for this pool.

Active registrations

Used with the all, pool, and statistics keywords. Shows the current active registrations.

Total Registration Statistics

Used with the all, pool, and statistics keywords. Shows the total registration statistics for this pool.

Registration requests

Used with the all, pool, and statistics keywords. Shows the incoming registration requests.

Registration success

Used with the all, pool, and statistics keywords. Shows the successful registrations.

Registration failed

Used with the all, pool, and statistics keywords. Shows the failed registrations.

unRegister requests

Used with the all, pool, and statistics keywords. Shows the incoming unregister/registration expire requests.

unRegister success

Used with the all, pool, and statistics keywords. Reports the number of successful unregisters.

unRegister failed

Used with the all, pool, and statistics keywords. Reports the number of failed unregisters.

Global statistics

Used with the statistics keyword. Details all active registrations.

Register pool number statistics

Used with the statistics keyword. Details specific pool statistics.


Related Commands

Command
Description

show sip-ua status registrar

Displays all the SIP endpoints currently registered with the contact address.

show voice register all

Displays all Cisco Unified SIP SRST and Cisco Unified CME configurations and register information.

show voice register dial-peers

Displays details of all dynamically created VoIP dial peers associated with the Cisco Unified SIP SRST or Cisco Unified CME register event.

show voice register pool

Displays all configuration information associated with a particular voice register pool.


show voice register template

To display all configuration information associated with a SIP phone template, use the show voice register template command in privileged EXEC mode.

show voice register template template-tag

Syntax Description

template-tag

Tag number of the template for which to display information. Range is 1 to 5.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4

This command was introduced.


Examples

The following is sample output from this command displaying information for voice register dn 148:

Router# show voice register template 1

Temp Tag 1
Config:
Attended Transfer is enabled
Blind Transfer is enabled
Conference is enabled
Caller-ID block is enabled
DnD control is enabled
Anonymous call block is enabled
Vad is enabled
Voicemail is 56789, timeout 15

Table 52 contains descriptions of significant fields shown in this output, listed in alphabetical order.

Table 52 show voice register template Field Descriptions 

Field
Description

Anonymous call block

Status of anonymous caller blocking defined with the anonymous block command.

Attended Transfer

Status of attended transfer soft key defined with the transfer-attended command.

Blind Transfer

Status of blind transfer soft key defined with the transfer-blind command.

Conference

Status of conference soft key defined with the conference command.

Config:

List of configuration options defined for this template.

Caller-ID block

Status of caller-id feature defined with the caller-id block command.

Dnd controls

Status of Do-Not-Disturb soft key defined with the dnd-control command.

Temp Tag

Tag number of the requested template.

VAD

Status of voice activity detection defined with the vad command

Voicemail

Voicemail extension and timeout value defined with the voice-mail command.


Related Commands

Command
Description

show voice register all

Displays all voice register information, including statistics, pools, and dial peers.

voice register template

Enters voice register template configuration mode and defines a template of common parameters for SIP phones.


show voice register tftp-bind

To display the current configuration files accessible to SIP phones, use the show voice register tftp-bind command in privileged EXEC mode.

show voice register tftp-bind

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4

This command was introduced.


Usage Guidelines

This command provides a list of configuration files that are accessible to SIP phones using TFTP.

Examples

The following is sample output from this command:

Router(config)# show voice register tftp-bind

 tftp-server SIPDefault.cnf url system:/cme/sipphone/SIPDefault.cnf

 tftp-server syncinfo.xml url system:/cme/sipphone/syncinfo.xml

 tftp-server SIP0009B7F7532E.cnf url system:/cme/sipphone/SIP0009B7F7532E.cnf

 tftp-server SIP000ED7DF7932.cnf url system:/cme/sipphone/SIP000ED7DF7932.cnf

 tftp-server SIP0012D9EDE0AA.cnf url system:/cme/sipphone/SIP0012D9EDE0AA.cnf

 tftp-server gk123456789012 url system:/cme/sipphone/gk123456789012

 tftp-server gk123456789012.txt url system:/cme/sipphone/gk123456789012.txt




Table 53 contains descriptions of significant fields shown in this output, listed in alphabetical order.

Table 53 show voice register tftp-bind Field Descriptions 

Field
Description

ata<mac-address>

Cisco SIP configuration profile for a particular Cisco ATA-186 or Cisco ATA-188 as indicated by the <mac-address>. This file is generated by using the create profile command.

ata<mac-address>.txt

ASCII text file of a Cisco SIP configuration profile for a particular Cisco ATA-186 or Cisco ATA-188 as indicated by the <mac-address>. This file is generated by using the file text command.

gk<mac-address>

Cisco  SIP configuration profile for a particular Cisco IP Phone 7912 or Cisco IP Phone 7912G as indicated by the <mac-address>. This file is generated by using the create profile command.

gk<mac>.txt

ASCII text file of a Cisco SIP configuration profile for a particular Cisco IP Phone 7912 or Cisco IP Phone 7912G as indicated by the <mac-address>. This file is generated by using the file text command.

Id<mac-address>

Cisco SIP configuration profile for a particular Cisco IP Phone 7905 or Cisco IP Phone 7912G as indicated by the <mac-address>. This file is generated by using the create profile command.

Id<mac-address>.txt

ASCII text file of a Cisco SIP configuration profile for a particular Cisco IP Phone 7905 or Cisco IP Phone 7912G as indicated by the <mac-address>. This file is generated by using the file text command.

SIPDefault.cnf

Configuration file to be shared by all Cisco SIP IP Phone 7940s and Cisco SIP IP  Phone 7960s. This file is automatically generated by the router through the source-address command and is placed in router memory. The SIPDefault.cnf file contains the IP address that the phones use to register for service, using the Session Initiation Protocol (SIP).

SIP<mac-address>.cnf

Cisco SIP configuration profile for a particular Cisco IP Phone 7940 or Cisco IP Phone 7960 as indicated by the <mac-address>. This file is generated by using the create profile command.

syncinfo.xml

Configuration file to be shared by all Cisco SIP IP Phone 7940s and Cisco SIP IP  Phone 7960s. This file is generated by using the create profile command.


Related Commands

Command
Description

create profile (voice register global)

Generates the configuration profiles required for SIP phones.

reset (voice register dn)

Performs a complete reboot of one phone associated with a Cisco CME router.

reset (voice register pool)

Performs a complete reboot of one or all phones associated with a Cisco CME router.

text file (voice register global)

Generates an ASCII format text file of the Cisco SIP configuration profile for Cisco IP Phone 7905s and 7905Gs, Cisco IP phone 7912s and 7912Gs, Cisco ATA-186s, and Cisco ATA-188s.

tftp-path (voice register global)

Specifies the directory to which the provisioning file for SIP phones in a Cisco CallManager Express (Cisco CME) system will be written.

voice register global

Enters voice register global configuration mode in order to set global parameters for all supported Cisco SIP phones in a Cisco CME or Cisco SIP SRST environment.


show voice-huntgroup

To display configuration information associated with one or all voice hunt groups in a Cisco CallManager (Cisco CME) system, use the show voice-huntgroup command in privileged EXEC mode.

show voice-huntgroup hunt-tag [brief] {longest-idle | parallel | peer | sequential}

Syntax Description

hunt-tag

(Optional) Unique sequence number that identifies the voice hunt group. Range is 1 to 100

brief

(Optional) To display brief information about one or all voice hunt groups in a Cisco CME system.

longest-idle

(Optional) To display summary of one or all longest-idle voice hunt groups.

parallel

(Optional) To display summary of one or all parallel voice hunt groups.

peer

(Optional) To display summary of one or all peer voice hunt groups.

sequential

(Optional) To display summary of one or all sequential voice hunt groups.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4

This command was introduced.


Usage Guidelines

Use this command instead of using show running-config, as an alternate way to get information about voice hunt-group configuration on the gateway.

Use the show voice-huntgroup and show voice-huntgroup brief commands to display hunt group configuration information for all voice hunt groups in a Cisco CME system. Use the show voice-huntgroup tag command to display data regarding a specific hunt-tag configuration created by the voice hunt-group command. Use the longest-idle, parallel, peer, or sequential keywords to display data regarding a specific type of voice hunt group configuration created by the voice hunt-group command.

Examples

The following example is a sample of the output from this command when there is no voice hunt-group configured:

router# show voice hunt-group
 no voice hunt-groups configured
router# show voice hunt-group brief
 no voice hunt-groups configured
router# show voice hunt-group longest-idle
 no voice hunt-groups configured
router#

The following example is the sample output from this command displaying the configuration for all the configured voice hunt-groups:

router# show voice hunt-group
Group 5
 type: parallel
 pilot number: 1234, peer-tag 1234
 list of numbers: 9498889994,9498889993,
 secondary number: 5678, peer-tag 5678
 list preference: 5
 preference (sec): 8
 timeout: 180
 final_number: 4444

Group 8
 type: longest-idle
 pilot number: 6666, peer-tag 6666
 list of numbers: 5106575902,4088531111,4083911375,4089306067,8869395033,88686619633
 preference: 0
 preference (sec): 0
 timeout: 180
 final_number:
 hops: 6

Group 10
 type: longest-idle
 pilot number: 7777777, peer-tag 7777777
 secondary number: 88888888, peer-tag 88888888
 list of numbers: 7654321,87654321,987654321,
 preference: 0
 preference (sec): 0
 timeout: 180
 final_number:
 hops: 3

Group 15
 type: peer
 pilot number: 56789, peer-tag 56789
 list of numbers: 87654321,9876,87654,
 preference: 0
 preference (sec): 0
timeout: 180
 final_number:
 hops: 3

The following is sample output from this command displaying information for a particular voice hunt group as specified by a hunt- tag number:

Router# show voice hunt-group 5
Group 5
 type: parallel
 pilot number: 1234, peer-tag 1234
 secondary number: 5678, peer-tag 5678
 list of numbers: 9498889994,9498889993,
 preference: 5
 preference (sec): 8
 timeout: 20
 final_number: 4444

The following is sample output from this command displaying information about all the voice hunt groups of a particular type:

router# sh voice hunt-group longest-idle
Group 8
 type: longest-idle
 pilot number: 6666, peer-tag 6666
 list of numbers: 5106575902,4088531111,4083911375,4089306067,8869395033,88686619633,
 preference: 0
 preference (sec): 0
 timeout: 180
 final_number:
 hops: 6
Group 10
 type: longest-idle
 pilot number: 7777777, peer-tag 7777777
 secondary number: 88888888, peer-tag 88888888
 list of numbers: 7654321,87654321,987654321,
 preference: 0
 preference (sec): 0
 timeout: 180
 final_number:
 hops: 3

The following example is a sample output of this command plus the brief keyword:

router# show voice-huntgroup brief
TAG TYPE PILOT  LIST
=== ==== ========  =====================================================
5 PAR 1234      9498889-, 9498889-
         5678      9498889-, 9498889-
8 LON 6666 5106575-, 4088531-, 4083911-, 4089306-, 8869395-,.....
10 LON 7777777 7654321, 8765432-, 9876543-
         8888888- 7654321, 8765432-, 9876543-
15 PER 56789 8765432-, 9876, 87654

Table 54 contains descriptions of significant fields shown in this output, listed in alphabetical order.

Table 54 show voice-huntgroup Field Descriptions 

Field
Description

Final_number

Last number in the voice hunt group, after which a call is no longer redirected

Hops

Number of hops before a call proceeds to the final number.

List of numbers

Numbers of the extensions configured in the voice hunt-group command's hunt-tag identifier.

Pilot number

Number that callers dial to reach the voice hunt group.

Preference

Preference order for the extension or telephone number associated with a dial peer. Range is 0 to 8. Default is 0.

Preference (sec)

Preference order for the secondary pilot number. Range is from 0 to 10, where 0 is the highest preference and 10 is the lowest preference. Default is 9.

Secondary number

Additional pilot number for the voice hunt group.

Timeout

Number of seconds after which a call that is not answered at one number is redirected to the next number in the hunt-group list.

Type

voice hunt-group command type. Can be longest-idle, parallel, peer, or sequential.


Related Commands

final (voice hunt-group)

Defines the last extension in a voice hunt group.

hops (voice hunt-group)

Defines the number of times that a call is redirected to the next directory number in a peer voice hunt-group list before proceeding to the final directory number.

list (voice hunt-group)

Defines the directory numbers that participate in a directory number hunt group.

pilot (voice hunt-group)

Defines the voice dn that callers dial to reach a Cisco CallManager Express (Cisco CME) voice hunt group.

timeout (voice hunt-group)

Sets the number of seconds after which a call that is not answered is redirected to the next number in the hunt-group list and defines the last directory number in the hunt group.

voice hunt-group

Defines the type of hunt group.


softkeys alerting

To configure an ephone template for soft-key display during the alerting call stage, use the softkeys alerting command in ephone-template configuration mode. To remove a soft key alerting configuration, use the no form of this command.

softkeys alerting {[Acct] [Callback] [Endcall]}

no softkeys alerting

Syntax Description

Acct

(Optional) Soft-key name that appears on the IP phone during the alerting call stage. Short for "account code." Provides access to configured accounts.

Callback

(Optional) Soft-key name that appears on the IP phone during the alerting call stage. Requests callback notification when a busy called line becomes free.

Endcall

(Optional) Soft-key name that appears on the IP phone during the alerting call stage. Ends the current call.


Defaults

The default soft keys for the alerting call stage and the order in which they appear on IP phones are, from first to last, Acct, Callback, and Endcall.

Command Modes

Ephone-template configuration

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.3(11)T

3.2

This command was introduced.


Usage Guidelines

The alerting call stage is when the remote point is being notified of an incoming call, and the status of the remote point is being relayed to the caller as either ringback or busy.

The number and order of soft keys listed in the softkeys alerting command correspond to the number and order of soft keys that will appear on IP phones.

Examples

In the following example, ephone template 1 is configured for the alerting stage and for the seized and connected call stages:

Router(config)# telephony-service
Router(config-telephony)# ephone-template 1
Router(config-ephone-template)# softkeys seized Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

ephone-template (ephone)

Applies an ephone template to an ephone.

softkeys connected

Configures an ephone template for soft-key display during the connected call stage.

softkeys idle

Configures an ephone template for soft-key display during the idle call stage.

softkeys seized

Configures an ephone template for soft-key display during the seized call stage.


softkeys connected

To configure an ephone template for soft-key display during the connected call stage, use the softkeys connected command in ephone-template configuration mode. To remove a softkeys connected configuration, use the no form of this command.

softkeys connected {[Acct] [ConfList] [Confrn] [Endcall] [Flash] [HLog] [Hold] [Join] [Park] [RmLstC] [Select] [Trnsfer]}

no softkeys connected

Syntax Description

Acct

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Provides access to configured accounts.

ConfList

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Lists all parties in a conference.

Confrn

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Connects callers to a conference call.

Endcall

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Ends the current call.

Flash

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Also called "hookflash." Provides hookflash functionality for public switched telephony network (PSTN) services on calls connected to the PSTN via a foreign exchange office (FXO) port.

HLog

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Places a phone into not-ready status, in which it does not accept hunt-group calls. You must set the hunt-group logout command to HLog for this soft key to be visible. This key is a toggle; pressing it a second time returns the phone to ready status, in which it is available to receive calls.

Hold

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Places an active call on hold and resumes the call.

Join

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Joins an established call to conference.

Park

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Places an active call on hold, so it can be retrieved from another phone in the system.

RmLstC

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Removes the last party added to the conference. This soft key only works for the conference creator.

Select

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Selects a call or a conference on which to take action.

Trnsfer

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Transfers active calls to another extension.


Command Default

The default soft keys for the connected call stage and the order in which they appear on IP phones are, from first to last:

With HLog support: Hold, EndCall, Trnsfer, Confrn, Acct, HookFlash, Park, HLog

Without HLog support: Hold, EndCall, Trnsfer, Confrn, Acct, HookFlash, Park, Resume, NewCall

Command Modes

Ephone-template configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.3(11)T

Cisco CME 3.2

This command was introduced.

12.4(4)XC

Cisco Unified CME 4.0

The HLog keyword was added.

12.4(9)T

Cisco Unified CME 4.0

This command with modifications was integrated into Cisco IOS Release 12.4(9)T.

12.4(11)XJ

Cisco Unified CME 4.1

The ConfList, Join, RmLstC, and Select keywords were added.

12.4(15)T

Cisco Unified CME 4.1

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

The connected call stage is when the connection to a remote point has been established.

The number and order of soft keys listed in the softkeys connected command correspond to the number and order of soft keys that will appear on IP phones.

Configure the ConfList, Join, and RmLstC soft keys for conferencing functions. Use these soft keys with hardware conferencing only.


Note The ConfList (including the Remove, Update, and Exit soft keys within the ConfList function) and RmLstC soft keys do not work on the Cisco Unified IP Phone 7902 and Cisco Unified IP Phone 7935 and 7936.


Examples

In the following example, ephone template 1 is configured for the connected stage and for the seized and alerting call stages:

Router(config)# ephone-template 1
Router(config-ephone-template)# softkeys seized Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

ephone

Enters ephone configuration mode for an IP phone.

ephone-template

Declares and names an ephone template to configure IP phone soft-key display and to enter ephone-template configuration mode.

ephone-template (ephone)

Applies an ephone template to an ephone.

fxo-hook-flash

Enables display of the Flash soft key.

hunt-group logout

Enables separate handling of DND and HLog functionality for hunt-group agents and the display of the HLog soft key on phones.

softkeys alerting

Configures an ephone template for soft-key display during the alerting call stage.

softkeys idle

Configures an ephone template for soft-key display during the idle call stage.

softkeys seized

Configures an ephone template for soft-key display during the seized call stage.


softkeys connected (voice register template)

To modify the soft-key display for the connected call state on SIP phones, use the softkeys connected command in voice register template configuration mode. To remove a softkeys connected configuration, use the no form of this command.

softkeys connected {[Confrn] [Endcall] [Hold] [Trnsfer]}

no softkeys connected

Syntax Description

Confrn

(Optional) Soft-key name that appears on the IP phone during the connected call state. Short for "conference." Connects callers to a conference call.

Endcall

(Optional) Soft-key name that appears on the IP phone during the connected call state. Ends the current call.

Hold

(Optional) Soft-key name that appears on the IP phone during the connected call state. Places an active call on hold and resumes the call.

Trnsfer

(Optional) Soft-key name that appears on the IP phone during the connected call state. Short for "call transfer." Transfers active calls to another extension.


Command Default

The default soft keys for the connected call state and the order in which they appear on SIP phones are, from first to last, Hold, Endcall, Trnsfer, and Confrn.

Command Modes

Voice register template configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XJ

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

The connected call state is when the connection to a remote point is established.

The number and order of soft keys used in this command correspond to the number and order of soft keys that will appear on SIP phones. Any soft key that is not explicitly specified with this command is disabled if this command is used to change the default soft keys.

This command is not supported on the Cisco Unified IP Phone 7905, 7912, 7940, or 7960.

Examples

In the following example, SIP phone template 1 is configured for the connected and seized call states:

Router(config)# voice register template 1
Router(config-register-template)# softkeys seized Redial Cfwdall EndCall
Router(config-register-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

softkeys hold (voice register template)

Configures a SIP phone template for soft-key display during the hold call state.

softkeys idle (voice register template)

Configures a SIP phone template for soft-key display during the idle call state.

softkeys seized (voice register template)

Configures a SIP ephone template for soft-key display during the seized call state.

template (voice register pool)

Applies a phone template to a SIP phone.


softkeys hold

To configure an ephone template to modify soft-key display during the call-hold call stage, use the softkeys hold command in ephone-template configuration mode. To remove a softkeys hold configuration, use the no form of this command.

softkeys hold {[Join] [Newcall] [Resume] [Select]}

no softkeys hold

Syntax Description

Join

(Optional) Soft-key name that appears on an IP phone during the hold call stage. Joins an established call to a conference.

Newcall

(Optional) Soft-key name that appears on an IP phone during the hold call stage. Opens a line on a speaker phone to place a new call.

Resume

(Optional) Soft-key name that appears on an IP phone during the hold call stage. Reconnects with the call on hold.

Select

(Optional) Soft-key name that appears on an IP phone during the hold call stage. Selects a call or a conference on which to take action.


Command Default

The default soft keys for the hold call stage and the order in which they appear on IP phones are alphabetical, from first to last, Join, Newcall, Resume, and Select.

Command Modes

Ephone-template configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.

12.4(11)XJ

Cisco Unified CME 4.1

The Join and Select keywords were added.

12.4(15)T

Cisco Unified CME 4.1

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

You reach the call-hold state by pressing the Hold soft key while you are in the connected state. From the hold state, you can press Resume to return to the connected state or NewCall to start another call, leaving the original call in the call-hold state.

The number and order of soft keys listed in the softkeys hold command correspond to the number and order of soft keys that will appear on IP phones.

Configure the Join and Select soft keys for conferencing functions. These soft keys should be used with hardware conferencing only.

Examples

In the following example, ephone template 1 is configured for the idle, alerting, connected, and hold call stages. It is applied to ephone 25. When ephone 25 has a call on hold, the only soft key that will be available is the Resume soft key.

Router(config)# telephony-service
Router(config-telephony)# ephone-template 1
Router(config-ephone-template)# softkeys idle Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall
Router(config-ephone-template)# softkeys hold Resume
Router(config-ephone-template)# exit

Router(config)# ephone 25
Router(config-ephone)# button 1:39
Router(config-ephone)# ephone-template 1

Related Commands

Command
Description

ephone

Enters ephone configuration mode for an IP phone.

ephone-template

Declares and names an ephone template to configure IP phone soft-key display and enters ephone-template configuration mode

ephone-template (ephone)

Applies an ephone template to an ephone.

softkeys alerting

Configures an ephone template for soft-key display during the alerting call stage.

softkeys connected

Configures an ephone template for soft-key display during the connected call stage.

softkeys idle

Configures an ephone template for soft-key display during the idle call stage.

softkeys seized

Configures an ephone template for soft-key display during the seized call stage.


softkeys idle

To configure an ephone template for soft-key display during the idle call stage, use the softkeys idle command in ephone template configuration mode. To remove a softkeys idle configuration, use the no form of this command.

softkeys idle {[Cfwdall] [ConfList] [Dnd] [Gpickup] [HLog] [Join] [Login] [Newcall] [Pickup] [Redial] [RmLstC]}

no softkeys idle

Syntax Description

Cfwdall

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Forwards all calls.

ConfList

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Lists all parties in a conference.

Dnd

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Enables the Do-Not-Disturb features.

Gpickup

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Selectively picks up calls coming into a phone number that is a member of a pickup group.

HLog

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Places a phone into not-ready status, in which it does not accept hunt-group calls. You must set the hunt-group logout command to HLog for this soft key to be visible. This key is a toggle; pressing it a second time returns the phone to ready status, in which it is available to receive calls.

Join

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Joins an established call to a conference.

Login

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Provides personal identification number (PIN)-controlled access to restricted phone features.

Newcall

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Opens a line on a speaker phone to place a new call.

Pickup

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Selectively picks up calls coming into another extension.

Redial

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Redials the last number dialed.

RmLstC

(Optional) Soft-key name that appears on the IP phone during the idle call stage. Removes the last party added to the conference. This soft key only removes the last party when the conference creator presses it.


Command Default

The default soft keys for the idle call stage and the order in which they appear on IP phones are:

FXO Trunk: Redial, NewCall, DoNotDisturb

With HLog support: Redial, NewCall, CFwdAll, CallPickUp, GrpCallPickUp, DoNotDisturb, Login, HLog

Without HLog support: Redial, NewCall, CFwdAll, CallPickUp, GrpCallPickUp, DoNotDisturb, Login

Command Modes

Ephone-template configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.3(11)T

Cisco CME 3.2

This command was introduced.

12.4(4)XC

Cisco Unified CME 4.0

The HLog keyword was added.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.

12.4(11)XJ

Cisco Unified CME 4.1

The ConfList, Join, and RmLstC keywords were added.

12.4(15)T

Cisco Unified CME 4.1

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

The idle calling stage occurs before a call is made and after a call is complete.

The number and order of soft keys listed in the softkeys idle command correspond to the number and order of soft keys on IP phones.

Configure the ConfList, Join, and RmLstC soft keys for conferencing functions. These soft keys should be used with hardware conferencing only.


Note The ConfList (including the Remove, Update, and Exit soft keys within the ConfList function) and RmLstC soft keys do not work on the Cisco Unified IP Phone 7902 and Cisco Unified IP Phone 7935 and 7936.


Examples

In the following example, ephone template 1 is configured for the idle stage and for the alerting and connected call stages:

Router(config)# telephony-service
Router(config-telephony)# ephone-template 1
Router(config-ephone-template)# softkeys idle Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

ephone

Enters ephone configuration mode for an IP phone.

ephone-template

Declares and names an ephone template to configure IP phone soft-key display and enters ephone-template configuration mode

ephone-template (ephone)

Applies an ephone template to an ephone.

hunt-group logout

Enables separate handling of DND and HLog functionality for hunt-group agents and the display of an HLog soft key on phones.

softkeys alerting

Configures an ephone template for soft-key display during the alerting call stage.

softkeys connected

Configures an ephone template for soft-key display during the connected call stage.

softkeys seized

Configures an ephone template for soft-key display during the seized call stage.


softkeys idle (voice register template)

To modify the soft-key display for the idle call state on SIP phones, use the softkeys idle command in voice register template configuration mode. To remove a softkeys idle configuration, use the no form of this command.

softkeys idle {[Cfwdall] [Newcall] [Redial]}

no softkeys idle

Syntax Description

Cfwdall

(Optional) Soft-key name that appears on the IP phone during the idle call state. Short for "call forward all." Forwards all calls.

Newcall

(Optional) Soft-key name that appears on the IP phone during the idle call state. Opens a line on a speakerphone to place a new call.

Redial

(Optional) Soft-key name that appears on the IP phone during the idle call state. Redials the last number dialed.


Command Default

The default soft keys for the idle call state and the order in which they appear on SIP phones are, from first to last, Redial, Newcall, and Cfwdall.

Command Modes

Voice register template configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XJ

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

The idle calling state occurs before a call is made and after a call is complete.

The number and order of soft keys used in this command correspond to the number and order of soft keys that will appear on SIP phones. Any soft key that is not explicitly specified with this command is disabled if this command is used to change the default soft keys.

This command is not supported on the Cisco Unified IP Phone 7905, 7912, 7940, or 7960.

Examples

In the following example, SIP phone template 1 is configured for the idle and connected call states:

Router(config)# voice register template 1
Router(config-register-template)# softkeys idle Redial Cfwdall
Router(config-register-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

softkeys connected (voice register template)

Configures a SIP phone template for soft-key display during the connected call state.

softkeys hold (voice register template)

Configures a SIP phone template for soft-key display during the hold call state.

softkeys seized (voice register template)

Configures a SIP phone template for soft-key display during the seized call state.

template (voice register pool)

Applies a phone template to a SIP phone.


softkeys ringing

To configure an ephone template for soft-key display during the ringing call state, use the softkeys ringing command in ephone-template configuration mode. To remove the softkeys ringing configuration, use the no form of this command.

softkeys ringing {[Answer] [Dnd] [HLog]}

no softkeys ringing

Syntax Description

Answer

(Optional) Soft-key name that appears on the IP phone during the ringing call state.

Dnd

(Optional) Soft-key name that appears on the IP phone during the ringing call state.

HLog

(Optional) Soft-key name that appears on the IP phone during the ringing call state.


Command Default

The following soft keys are displayed in alphabetical order, first to last, on IP phones during the ringing call state: Answer, Dnd, HLog.

Command Modes

Ephone-template configuration (config-ephone-template)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XW

Cisco Unified CME 4.2

This command was introduced.


Usage Guidelines

Use this command in ephone-template configuration mode to create a template in which you can specify which soft keys are displayed, and in what order, on an IP phone during the ringing call state. In the ringing call state, a call is received and is not yet connected.

Any soft key that is not explicitly configured is disabled.

You can enter any of the keywords in any order. The number and order of soft keys listed in the softkeys ringing command correspond to the number and order of soft keys that will appear on IP phones during the ringing call state.

Configure the Answer keyword with the softkeys ringing command to enable a phone user to answer an incoming call on a line button that is unavailable; for example, if a line button is configured with a dual-line directory number and a call is on hold on one channel of the directory number and another call is ringing on the second channel, the phone user can use the Answer soft key to pick up the incoming call on the second channel.

Configure the HLog keyword with the softkeys ringing command to display the Hlog soft key during the ringing call state. To enable HLog soft key functionality during the call ringing state, you must also configure the hunt-group logout HLog command. If you configure the Hlog soft key and do not configure the hunt-group logout HLog command, the Hlog soft key appears on the phone screen but is not functional. The HLog soft key is a toggle for enabling or disabling the not-ready status, in which the directory number does not accept hunt-group calls.

Configure the Dnd keyword with the softkeys ringing command to enable the phone user to place the phone into Do-Not-Disturb mode. Configure the Dnd soft key and the hunt-group logout DND command to enable the phone user to invoke DND mode and log the phone out of hunt groups in which it is a member.

To apply an ephone template to an IP phone, configure the ephone-template (ephone) command in the ephone configuration mode.

Examples

In the following example, ephone template 1 is configured for the ringing state, and for the alerting and connected call states:

Router(config)# telephony-service
Router(config-telephony)# ephone-template 1
Router(config-ephone-template)# softkeys ringing Answer Dnd Hlog
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

dnd feature ring

Allows phone buttons configured with the feature-ring option to not ring when their phones are in do-not-disturb (DND) mode.

ephone-template (ephone)

Applies an ephone template to an ephone.

hunt-group logout

Enables separate handling of the DND and HLog functions for hunt-group agents.

softkeys alerting

Configures an ephone template for soft-key display during the alerting call state.

softkeys connected

Configures an ephone template for soft-key display during the connected call state.

softkeys idle

Configures an ephone template for soft-key display during the idle call state.

softkeys seized

Configures an ephone template for the soft-key display during the seized call state.


softkeys seized

To configure an ephone template for soft-key display during the seized call stage, use the softkeys seized command in ephone-template configuration mode. To remove a softkeys seized configuration, use the no form of this command.

softkeys seized {[CallBack] [Cfwdall] [Endcall] [Gpickup] [HLog] [MeetMe] [Pickup] [Redial]}

no softkeys seized

Syntax Description

CallBack

(Optional) Soft-key name that appears on the IP phone during the seized call stage. Forwards all calls.

Cfwdall

(Optional) Soft-key name that appears on the IP phone during the seized call stage. Forwards all calls.

Endcall

(Optional) Soft-key name that appears on the IP phone during the seized call stage. Ends the current call.

Gpickup

(Optional) Soft-key name that appears on the IP phone during the seized call stage. Selectively picks up calls coming into a phone number that is a member of a pickup group.

HLog

(Optional) Soft-key name that appears on the IP phone during the connected call stage. Places a phone into not-ready status, in which it does not accept hunt-group calls. You must set the hunt-group logout command to HLog for this soft key to be visible. This key is a toggle; pressing it a second time returns the phone to ready status, in which it is available to receive calls.

MeetMe

(Optional) Soft-key name that appears on the IP phone during the seized call stage. Initiates a meet-me conference.

Pickup

(Optional) Soft-key name that appears on the IP phone during the seized call stage. Selectively picks up calls to another extension.

Redial

(Optional) Soft-key name that appears on the IP phone during the seized call stage. Redials the last number dialed.


Command Default

The default soft keys for the seized call stage and the order in which they appear on IP phones are:

With HLog support: Redial, EndCall, CFwdAll, CallPickUp, GrpCallPickUp, CallBack, HLog

Without HLog support: Redial, EndCall, CFwdAll, CallPickUp, GrpCallPickUp, CallBack

Command Modes

Ephone-template configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.3(11)T

Cisco CME 3.2

This command was introduced.

12.4(4)XC

Cisco Unified CME 4.0

The HLog keyword was added.

12.4(9)T

Cisco Unified CME 40

This command was integrated into Cisco IOS Release 12.4(9)T.

12.4(11)XJ

Cisco Unified CME 4.1

The MeetMe keyword was added.

12.4(15)T

Cisco Unified CME 4.1

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

The seized calling stage is when a caller is attempting a call but has not yet been connected.

The number and order of soft keys listed in the softkeys seized command correspond to the number and order of soft keys on IP phones.

You must configure the MeetMe soft key to initiate a meet-me conference. Use this soft key for hardware conferencing only.

Examples

In the following example, ephone template 1 is configured for the seized stage and for the alerting and connected call stages:

Router(config)# telephony-service
Router(config-telephony)# ephone-template 1
Router(config-ephone-template)# softkeys seized Redial Cfwdall Pickup
Router(config-ephone-template)# softkeys alerting Callback Endcall
Router(config-ephone-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

ephone

Enters ephone configuration mode for an IP phone.

ephone-template

Declares and names an ephone template to configure IP phone soft-key display and enters ephone-template configuration mode

ephone-template (ephone)

Applies an ephone template to an ephone.

hunt-group logout

Enables separate handling of DND and HLog functionality for hunt-group agents and the display of an HLog soft key on phones.

softkeys alerting

Configures an ephone template for soft-key display during the alerting call stage.

softkeys connected

Configures an ephone template for soft-key display during the connected call stage.

softkeys idle

Configures an ephone template for soft-key display during the idle call stage.


softkeys seized (voice register template)

To modify the soft-key display for the seized call state on SIP phones, use the softkeys seized command in voice register template configuration mode. To remove a softkeys seized configuration, use the no form of this command.

softkeys seized {[Cfwdall] [Endcall] [Redial]}

no softkeys seized

Syntax Description

Cfwdall

(Optional) Soft-key name that appears on the IP phone during the seized call state. Short for "Call forward all." Forwards all calls.

Endcall

(Optional) Soft-key name that appears on the IP phone during the seized call state. Ends the current call.

Redial

(Optional) Soft-key name that appears on the IP phone during the seized call state. Redials the last number dialed.


Command Default

The default soft keys for the seized call state and the order in which they appear on SIP phones are, from first to last, Redial, Endcall, and Cfwdall.

Command Modes

Voice register template configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XJ

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

The seized calling state is when a caller goes offhook and before any other action is taken.

The number and order of soft keys used in this command correspond to the number and order of soft keys that will appear on SIP phones. Any soft key that is not explicitly specified with this command is disabled if this command is used to change the default soft keys.

This command is not supported on the Cisco Unified IP Phone 7905, 7912, 7940, or 7960.

Examples

In the following example, SIP phone template 1 is configured for the seized and connected call states:

Router(config)# voice register template 1
Router(config-register-template)# softkeys seized Redial Cfwdall
Router(config-register-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

softkeys connected (voice register template)

Configures a SIP phone template for soft-key display during the connected call state.

softkeys hold (voice register template)

Configures a SIP phone template for soft-key display during the hold call state.

softkeys idle (voice register template)

Configures a SIP phone template for soft-key display during the idle call state.

template (voice register pool)

Applies a template to a SIP phone.


source-addr

To specify the IP address of the certification authority proxy function (CAPF) server on the Cisco Unified CME router, use the source-addr command in CAPF-server configuration mode. To return to the default, use the no form of this command.

source-addr ip-address

no source-addr

Syntax Description

ip-address

IP address of the Cisco Unified CME router.


Command Default

No IP address is entered for the CAPF server in the router configuration.

Command Modes

CAPF-server configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

This command is used with Cisco Unified CME phone authentication.

Examples

The following example identifies the IP address for the CAPF server as 10.10.10.1:

Router(config)# capf-server

Router(config-capf-server)# source address 10.10.10.1

Router(config-capf-server)# trustpoint-label server25

Router(config-capf-server)# cert-oper upgrade all

Router(config-capf-server)# cert-enroll-trustpoint server12 password 0 x8oWiet

Router(config-capf-server)# auth-mode auth-string

Router(config-capf-server)# auth-string generate all

Router(config-capf-server)# port 3000

Router(config-capf-server)# keygen-retry 5

Router(config-capf-server)# keygen-timeout 45

Router(config-capf-server)# phone-key-size 2048


source-address (voice register global)

To identify the IP address and port through which SIP phones communicate with a Cisco CallManager Express (Cisco CME) router, use the source-address command in voice register global configuration mode. To disable the router from receiving messages from SIP phones, use the no form of this command.

source-address ip-address [port port]

no source-address

Syntax Description

ip-address

Preexisting router IP address, typically one of the addresses of the Ethernet port of the router.

port port

(Optional) TCP/IP port number to use for Skinny Client Control Protocol (SCCP). Range is 2000 to 9999. Default is 2000.


Defaults

Port number: 2000

Command Modes

Voice register global configuration

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4

This command was introduced.


Usage Guidelines

This is a mandatory command. The Cisco CallManager Express router cannot communicate with the Cisco CME phones if the IP address is not provided. If the port number is not provided, the default is port 2000. The IP address is usually the IP address of the Ethernet port to which the phones are connected.

This command enables a router to receive messages from Cisco IP phones through the specified IP address and port.

For systems using ITS V2.1, Cisco CME 3.0, or later versions, the IP phones receive their initial configuration information and phone firmware from the TFTP server associated with the router. The TFTP server address obtained by the Cisco IP phones points to the router IP address. The Cisco IP phones transfer a configuration file called SIPDefault.cnf. This file is automatically generated by the router through the source-address command and is placed in router memory. The SIPDefault.cnf file contains the IP address that the phones, using the Session Initiation Protocol (SIP), use to register for service. This IP address corresponds to a valid Cisco CME router IP address (and may be the same as the router TFTP server address).

Examples

The following example shows how to set the IP source address and port:

Router(config)# voice register global
Router(config-register-global)# source-address 10.6.21.4 port 6000

Related Commands

Command
Description

create profile (voice register global)

Generates the configuration profiles required for SIP phones.

file text (voice register global)

Generates ASCII text files for SIP phones.

tftp-path (voice register global)

Specifies the directory to which the provisioning file for SIP phones in a Cisco CallManager Express (Cisco CME) system will be written.

voice register global

Enters voice register global configuration mode in order to set global parameters for all supported Cisco SIP phones in a Cisco CME or Cisco SIP SRST environment.


speed-dial

To create speed-dial definitions for a Cisco Unified IP phone or analog phone that uses an analog telephone adaptor (ATA) in a Cisco Unified CME system, use the speed-dial command in ephone or ephone-template configuration mode. To disable a speed-dial definition, use the no form of this command.

speed-dial speed-tag digit-string [label label-text]

no speed-dial speed-tag

Syntax Description

speed-tag

Unique sequence number that identifies a speed-dial definition during configuration tasks. Range is from 1 to 33.

digit-string

Digits to be dialed when the speed-dial button is pressed on an IP phone or the digits to be dialed when the associated code is entered from an analog phone with an ATA device.

For IP phones, if the first character of this string is the plus sign (+), this speed-dial number is locked and cannot be changed at the phone. If the only character in this string is a pound sign (#), a user-programmable speed-dial button with no speed-dial number attached is defined.

label label-text

(Optional) String that contains identifying text to be displayed next to the speed-dial button. Enclose the string in quotation marks if the string contains a space.


Command Default

No speed-dial definitions are created.

Command Modes

Ephone configuration
Ephone-template configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.1(5)YD

Cisco ITS 1.0

This command was introduced on the Cisco 2600 series, Cisco 3600 series, and Cisco IAD2420 series.

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 and implemented on the Cisco 3725 and Cisco 3745.

12.2(8)T1

Cisco ITS 2.0

This command was implemented on the Cisco 2600XM and Cisco 2691.

12.2(11)T

Cisco ITS 2.01

This command was implemented on the Cisco 1760.

12.2(15)ZJ

Cisco CME 3.0

The number of speed-dial definitions that can be created was increased from 4 to 33. The ability to program speed-dial numbers at the phone and the ability to lock speed-dial numbers were introduced.

12.3(4)T

Cisco CME 3.0

This command was integrated into Cisco IOS Release 12.3(4)T.

12.3(11)XL

Cisco CME 3.2.1

This feature was modified to allow IP phones to access more speed-dial numbers than the number of available buttons on their phones and to allow analog phones to access up to 33 speed-dial numbers.

12.3(14)T

Cisco CME 3.3

This command was integrated into Cisco IOS Release 12.3(14)T.

12.4(4)XC

Cisco Unified CME 4.0

This command was made available in ephone-template configuration mode.

12.4(9)T

Cisco Unified CME 4.0

This command in ephone-template configuration mode was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

The speed-tag argument in this command is a unique identifier for a speed-dial definition on the phone that is being configured.

This command must be followed by a quick reboot of the phone using the restart command.

If you use an ephone template to apply a 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.

This command defines speed-dial numbers that are local to the ephone that is being configured. The directory entry command defines additional, systemwide speed-dial numbers.

IP Phones

For IP phones, speed-dial numbers can be defined by administrators using this command and the digit-string argument. The numbers are locked if the digit-string argument begins with a plus sign (+). Locked numbers cannot be changed at the phone. Speed-dial definitions without speed-dial numbers (those defined with only a pound sign) and speed-dial instances with unlocked digit-string arguments can be changed by users at their IP phones. Changes made to speed-dial definitions are saved in the router nonvolatile random-access memory (NVRAM) configuration after a timer-based delay.

On Cisco Unified IP phones, speed-dial definitions are assigned to available extension buttons that have not been assigned to extensions. Speed-dial definitions are assigned in the order of their identifier (tag) numbers. For example, if you define speed-dial 1, it is assigned to the first phone button that is available after the buttons that have been assigned to extensions. If you have used two buttons for extensions on a phone, speed-dial 1 is assigned to the third physical button on the phone. When you define speed-dial 2, it is assigned to the fourth physical button on the phone, and so on.

If more speed-dial definitions are created than are supported by the IP phone setup, the extra speed-dial configurations can be dialed from IP phones using this procedure:

1. With the phone on-hook, an IP phone user presses a two-digit speed-dial code (that is, 05 for the entry with tag 5). A new soft key, Abbr, appears in the phone display.

2. The phone user picks up the phone handset and presses the Abbr soft key. The full telephone number associated with the speed-dial tag is dialed.

Prior to Cisco IOS Releases 12.3(11)XL and 12.3(14)T, speed-dial entries that were in excess of the number of physical phone buttons available were ignored.

Analog Phones

Analog phone users who use a Cisco ATA-186, Cisco ATA-188, or Cisco VG 224 to connect to a Cisco Unified CME system use a different method to access speed-dial numbers. Analog phone users press the asterisk (*) key and the speed-dial identifier (tag number) to dial a speed-dial number. For instance, an analog phone user presses *1 to speed dial the number that has been programmed as speed-dial 1 on that ephone. Analog phones can have up to 33 local speed-dial numbers programmed by the system administrator. The numbers cannot be programmed from the phone.

Prior to Cisco IOS Releases 12.3(11)XL and 12.3(14)T, analog phones were limited to nine speed-dial numbers.)

Examples

The following example sets speed-dial button 2 to dial the phone user's assistant at extension 5001 and locks the setting so that the phone user cannot change it at the phone:

Router(config)# ephone 23
Router(config-ephone)# speed-dial 2 +5001 label "Assistant"

Related Commands

Command
Description

directory entry

Adds a systemwide phone directory entry or speed-dial entry.

restart (ephone)

Performs a fast reboot of a single IP phone in a Cisco Unified CME system.

restart (telephony-service)

Performs a fast reboot of one or all phones in a Cisco Unified CME system.


speed-dial (voice logout-profile and voice user-profile)

To create speed-dial definitions in a user profile or logout profile for Extension Mobility in Cisco Unified CME, use the speed-dial command in voice user-profile configuration mode or voice logout-profile configuration mode. To disable a speed-dial definition, use the no form of this command.

speed-dial speed-tag number [label label] [blf]

no speed-dial speed-tag

Syntax Description

speed-tag

Unique sequence number that identifies a speed-dial definition during configuration tasks. Range: 1 to 36.

number

Digits to be dialed when the speed-dial button is pressed on an IP phone, or the digits to be dialed when the associated code is entered from an analog phone with an analog telephone adapter (ATA) device.

For IP phones, if the first character of this string is the plus sign (+), this speed-dial number is locked and cannot be changed at the phone. If the only character in this string is a pound sign (#), a user-programmable speed-dial button with no speed-dial number attached is defined.

label label

(Optional) String that contains identifying text to be displayed next to the speed-dial button. Enclose the string in quotation marks if the string contains a space.

blf

(Optional) Enables Busy Lamp Field (BLF) monitoring for a speed-dial number.


Command Default

No speed-dial definition is created.

Command Modes

Voice logout-profile configuration (voice-logout-profile)
Voice user-profile configuration (voice-user-profile)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XW

Cisco Unified CME 4.2

This command was introduced.


Usage Guidelines

Use this command in voice user-profile configuration mode to create a speed-dial definition in a user profile for Extension Mobility. A user profile is downloaded to the IP phone when a user is logged into an IP phone that is registered in Cisco Unified CME and enabled for Extension Mobility.

Use this command in voice logout-profile configuration mode to create a speed-dial definition in a logout profile for Extension Mobility. A logout profile is downloaded to the IP phone when no user is logged into an IP phone that is registered in Cisco Unified CME and enabled for Extension Mobility.

For button appearance, Extension Mobility will associate directory numbers and then associates speed-dial definitions in the logout profile or user profile to phone buttons in a sequential manner. If the profile contains more directory and speed-dial numbers than there are buttons on the physical phone to which the profile is downloaded, the remaining numbers in the profile are ignored.

On Cisco Unified IP phones, speed-dial definitions are assigned to available extension buttons that have not been assigned to extensions. Speed-dial definitions are assigned in the order of their identifier (tag) numbers, from 1 to 36.

Examples

The following example shows the configuration for a user profile to be downloaded when the a phone user logs into a Cisco Unified IP phone that is enabled for Extension Mobility. The lines and speed-dial buttons in this profile that are configured on an IP phone after the user logs in depend on the phone type. For example, if the user logs into a Cisco Unified IP Phone 7970, all buttons are configured according to voice-user profile1. However, if the phone user logs into a Cisco Unified IP Phone 7960, all six lines are mapped to phone buttons and the speed dial is ignored because no button is available for speed dial.


 pin 12345
 user me password pass123
 number 2001 type silent-ring
 number 2002 type beep-ring
 number 2003 type feature-ring
 number 2004 type monitor-ring
 number 2005,2006 type overlay
 number 2007,2008 type cw-overly
 speed-dial 1 3001
 speed-dial 2 3002 blf

Related Commands

Command
Description

logout-profile

Enables Cisco Unified IP phone for Extension Mobility and assigns a logout profile to this phone.

reset (voice logout-profile and voice user-profile)

Performs complete reboot of all IP phones on which a particular logout-profile or user-profile is downloaded.


speed-dial (voice register pool)

To create a speed-dial definition for a SIP phone or analog phone that uses an analog telephone adaptor (ATA) in a Cisco CallManager Express (Cisco CME) system, use the speed-dial command in voice register pool configuration mode. To disable a speed-dial definition, use the no form of this command.

speed-dial speed-tag digit-string [label label-text]

no speed-dial speed-tag

Syntax Description

speed-tag

Unique sequence number that identifies a speed-dial definition during configuration tasks. Range is 1 to 5.

digit-string

Digits to be dialed when the speed-dial button is pressed on an IP phone or the digits to be dialed when the associated code is entered from an analog phone with an ATA device.

For IP phones, if the first character of this string is the plus sign (+), this speed-dial number is locked and cannot be changed at the phone. If the only character in this string is a pound sign (#), a user-programmable speed-dial button with no speed-dial number attached is defined.

label label-text

(Optional) Text string that appears next to the speed-dial button. Enclose the string in quotation marks if the string contains a space.


Defaults

This command has no arguments or keywords.

Command Modes

Voice register pool configuration

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4

This command was introduced.


Usage Guidelines

The speed-tag argument in this command is a unique identifier for a speed-dial definition on the phone that is being configured. On Cisco IP phones, speed-dial definitions are assigned to available extension buttons that have not been assigned to extensions. Speed-dial definitions are assigned in the order of their identifier numbers.

For example, if you define speed-dial 1, it is assigned to the first phone button that is available after the buttons that are assigned to extensions. If you used two buttons for extensions on a phone, speed-dial 1 is assigned to the third physical button on the phone. When you define speed-dial 2, it is assigned to the fourth physical button on the phone.

For IP phones, speed-dial numbers can be assigned by the administrator by using the digit-string argument and can be locked if the digit-string argument begins with a plus sign (+). Locked numbers cannot be changed at the phone. Speed-dial instances without speed-dial numbers (those defined with only a pound sign) and speed-dial instances with unlocked digit-string arguments can be changed by users at their IP phones.

If more speed-dial definitions are created than are supported by the IP phone setup, the extra speed-dial configurations are ignored.

Changes made to speed-dial buttons are saved in the router's nonvolatile random-access memory (NVRAM) configuration after a timer-based delay.

Analog phone users who use a Cisco ATA-186 or Cisco ATA-188 to connect to Cisco CME systems use a different method to access speed-dial numbers. Instead of pressing a speed-dial button, phone users with ATA devices press the asterisk (star) key and a speed-tag number (speed-dial identifier) to dial a speed-dial number. For instance, a phone user with a Cisco ATA-186 presses *1 to dial the number that has been programmed as speed-dial 1 on that phone. Phones with ATA devices are limited to a maximum of nine speed-dial numbers that must be programmed by the system administrator. The numbers cannot be programmed from the phone. With phones that use ATA devices, system administrators must be sure to tell phone users when speed-dial numbers have been programmed for their phones.

After you configure this command, restart the phone by using the reset command.

Examples

The following example shows how to set speed-dial button 2 to dial the head office at extension 5001 and lock the setting so that the phone user cannot change it at the phone:

Router(config)# voice register pool 23
Router(config-register-pool)# speed-dial 2 +5001 label "Head Office"

Related Commands

Command
Description

reset (voice register pool)

Performs a fast reboot of a single IP phone in a Cisco CME system.

reset (voice register global)

Performs a reboot of all SIP phones in a Cisco CME system.

voice register pool

Enters voice register pool configuration mode for SIP phones.


srst dn line-mode

To specify line mode for the ephone-dns that are automatically created in Survivable Remote Site Telephony (SRST) mode on a Cisco Unified CME router, use the srst dn line-mode command in telephony-service configuration mode. To return to the default, use the no form of this command.

srst dn line-mode {dual | single}

no srst dn line-mode

Syntax Description

dual

SRST fallback ephone-dns will be dual-line ephone-dns.

single

SRST fallback ephone-dns will be single-line ephone-dns.


Command Default

Single-line mode

Command Modes

Telephony-service configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

This command specifies whether ephone-dns that are created during fallback should be dual-line or single-line ephone-dns. It applies only to the ephone-dns that are "learned" automatically from ephone configuration information, and not to ephone-dns that are manually prebuilt using Cisco Unified CME commands.

Use the show telephony-service ephone-dn command to display Cisco Unified CME parameters for ephone-dns.

Examples

The following example specifies dual-line mode for all SRST fallback ephone-dns.

telephony-service
 srst dn line-mode dual

Related Commands

Command
Description

show telephony-service ephone-dn

Displays parameters for ephone-dns.


srst dn template

To specify an ephone-dn template to be used in Survivable Remote Site Telephony (SRST) mode on a Cisco Unified CallManager Express (Cisco Unified CME) router, use the srst dn template command in telephony-service configuration mode. To return to the default, use the no form of this command.

srst dn template template-tag

no srst dn template

Syntax Description

template-tag

Identifying number of an existing ephone-dn template. Range is from 1 to 15.


Command Default

No ephone-dn template is specified.

Command Modes

Telephony-service configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

This command applies the specified ephone-dn template to all SRST fallback ephone-dns. Ephone-dn templates are created with the ephone-dn-template command.

Use the show telephony-service ephone-dn-template command to display the contents of ephone-dn templates.

Examples

The following example applies ephone-dn template 2 to all SRST fallback ephone-dns.

telephony-service
 srst dn template 2

Related Commands

Command
Description

ephone-dn-template

Enters ephone-dn-template configuration mode to create an ephone-dn template.

show telephony-service ephone-dn-template

Displays the contents of ephone-dn templates.


srst ephone description

To specify a description to be associated with an ephone in Survivable Remote Site Telephony (SRST) mode on a Cisco Unified CallManager Express (Cisco Unified CME) router, use the srst ephone description command in telephony-service configuration mode. To return to the default, use the no form of this command.

srst ephone description string

no srst ephone description

Syntax Description

string

Description to be associated with an ephone. Maximum string length is 100 characters.


Command Default

No description is specified.

Command Modes

Telephony-service configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

Use the show telephony-service ephone command to display the ephone description to be associated with SRST fallback phones.

Examples

The following example applies a description to all SRST fallback ephones.

telephony-service
 srst ephone description srst fallback auto-provision phone

The following excerpt displays a time-stamped SRST description for ephone 1:

Router# show running-config


ephone 1
 description srst fallback auto-provision phone : Jul 07 2005 17:45:08
 ephone-template 5
 mac-address 100A.7052.2AAE
 button 1:1 2:2

Related Commands

Command
Description

show telephony-service ephone

Displays ephone settings.


srst ephone template

To specify an ephone template to be used in Survivable Remote Site Telephony (SRST) mode on a Cisco Unified CallManager Express (Cisco Unified CME) router, use the srst ephone template command in telephony-service configuration mode. To return to the default, use the no form of this command.

srst ephone template template-tag

no srst ephone template

Syntax Description

template-tag

Identifying number of an existing ephone template. Range is from 1 to 20.


Command Default

No ephone template is specified.

Command Modes

Telephony-service configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

Ephone templates are created with the ephone-template command. This command applies the specified ephone template to all SRST fallback ephones.

Use the show telephony-service ephone-template command to display the contents of ephone templates.

Examples

The following example applies ephone template 3 to all SRST fallback ephones.

telephony-service
 srst ephone template 3

Related Commands

Command
Description

ephone-template

Enters ephone-template configuration mode to create an ephone template.

show telephony-service ephone-template

Displays the contents of ephone templates.


srst mode auto-provision

To enable Survivable Remote Site Telephony (SRST) mode for a Cisco Unified CallManager Express (Cisco Unified CME) router, use the srst mode auto-provision command in telephony-service configuration mode. To return to the default, use the no form of this command.

srst mode auto-provision {all | dn | none}

no srst mode auto-provision

Syntax Description

all

Includes information for learned ephones and ephone-dns in the running configuration.

dn

Includes information for learned ephone-dns in the running configuration.

none

Does not include information for learned ephones or learned ephone-dns in the running configuration. Use this keyword when you want Cisco Unified CME to provide SRST fallback services for Cisco Unified CallManager.


Command Default

SRST mode is disabled.

Command Modes

Telephony-service configuration

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

This command was integrated into Cisco IOS Release 12.4(9)T.


Usage Guidelines

This command puts a Cisco Unified CME router into SRST mode to provide fallback call-processing services for IP phones that have lost connection to their Cisco Unified CallManager. The phones can be preconfigured manually or the Cisco Unified CME-SRST router can dynamically learn their configuration. The keywords in this command allow you to specify how much of the learned phone configurations you want to include in the running configuration of the Cisco Unified CME-SRST router.

Use the none keyword to enable the Cisco Unified CME router to provide SRST fallback services for Cisco Unified CallManager. Use the dn or all keyword to enable the Cisco Unified CME router to learn the ephone-dn or ephone and ephone-dn configuration from Cisco Unified CallManager and include the information in its running configuration.


Note We do not recommend that you use the dn or all keyword if you want Cisco Unified CME to provide SRST fallback services. After the Cisco Unified CME-SRST router learns the phone configuration from Cisco Unified CallManager and you save the configuration, the fallback phones are treated as locally configured phones on the Cisco Unified CME-SRST router which can adversely impact the fallback behavior of those phones.


Examples

The following example shows how to enable the Cisco Unified CME router to provide SRST fallback services for phones connected to Cisco Unified CallManager. Information for learned ephone-dns and ephones is not included in the running configuration.

telephony-service
 srst mode auto-provision none

Related Commands

Command
Description

show telephony-service all

Displays detailed configuration for phones, voice ports, and dial peers in a Cisco Unified CME system.

srst dn line-mode

Specifies line mode for the ephone-dns that are automatically created in SRST mode on a Cisco Unified CME router.


statistics collect

To enable the collection of call statistics for an ephone hunt group, use the statistics collect command in ephone-hunt configuration mode. To stop statistics collection and to delete statistics that have been collected, use the no form of this command.

statistics collect

no statistics collect

Syntax Description

This command has no arguments or keywords.

Defaults

The default is no call statistics data is collected.

Command Modes

Ephone-hunt configuration

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.3(11)XL

3.2.1

This command was introduced.

12.3(14)T

3.3

This command was integrated into Cisco IOS Release 12.3(14)T.


Usage Guidelines

This command is used for the collection of call statistics, such as direct calls to hunt group pilot numbers, or calls to the Basic Automatic Call Distribution (B-ACD) and Auto Attendant service. For detailed information, see Cisco Unified CME B-ACD and Tcl Call-Handling Applications.

The statistics collect command can be used to activate statistics collection for any number of ephone hunt groups.

Statistics collection begins at the time that the statistics collect command is entered. A maximum of one week (168 hours) of statistics can be stored at a time. You can display the statistics with the show hunt-group command or transfer statistics automatically to files using TFTP. The no statistics collect command deletes all statistics that have been collected.

All or some of the statistics can be output with the show hunt-group command or sent to files automatically using TFTP by using the hunt-group report url command hunt-group report every hours commands.

Examples

The following example enables the collection of call statistics for ephone hunt group 1 and ephone hunt group 2:

Router(config)# ephone-hunt 1
Router(config-ephone-hunt)# statistics collect

Router(config)# ephone-hunt 2
Router(config-ephone-hunt)# statistics collect

Related Commands

Command
Description

ephone-hunt

Defines an ephone hunt group and enters ephone-hunt configuration mode.

hunt-group report delay hours

Delays the automatic transfer of Cisco CME B-ACD call statistics to a file.

hunt-group report every hours

Sets the hourly interval at which Cisco CME B-ACD call data is automatically transferred to a file.

hunt-group report url

Sets filename parameters and the URL path where Cisco CME B-ACD call statistics are to be sent using TFTP.

show ephone-hunt statistics

Displays ephone-hunt configuration information and current status and statistics information.


supplementary-service sip

To enable SIP supplementary service capabilities for call forwarding and call transfers across a SIP network, use the supplementary-service sip command in dial-peer or voice service voip configuration mode. To disable supplementary service capabilities, use the no form of this command.

supplementary-service sip {moved-temporarily | refer}

no supplementary-service sip {moved-temporarily | refer}

Syntax Description

moved-temporarily

SIP redirect response for call forwarding.

refer

SIP REFER message for call transfers.


Command Default

SIP supplementary service capabilities are enabled globally.

Command Modes

Dial-peer configuration
Voice-service voip configuration

Command History

Release
Modification

12.4(11)XJ

This command was introduced.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

This command allows you to disable a supplementary service feature (call forwarding or call transfer) if the destination gateway does not support the supplementary service. You can disable the feature either globally or for a specific SIP trunk (dial peer) by using the no form of this command.

The no supplementary-service sip moved-temporarily command prevents the router from sending a redirect response to the destination for call forwarding. The no supplementary-service sip refer command prevents the router from forwarding a REFER message to the destination for call transfers. The router instead attempts to initiate a hairpin call to the new target.

If this command is enabled globally and disabled on a dial peer, the functionality is disabled for the dial peer.

If this command is disabled globally and either enabled or disabled on a dial peer, the functionality is disabled for the dial peer.

This command is supported for calls between SIP phones and for calls between SCCP phones. It is not supported for a mixture of SCCP and SIP phones; for example, it has no effect for calls from a SCCP phone to a SIP phone.

Examples

The following example shows how to disable SIP call transfer capabilities for dial peer 37.

Router(config)# dial-peer voice 37 voip
Router(config-dial-peer)# destination-pattern 555....
Router(config-dial-peer)# session target ipv4:10.5.6.7
Router(config-dial-peer)# no supplementary-service sip refer

The following example shows how to disable SIP call forwarding capabilities globally:

Router(config)# voice service voip
Router(conf-voi-serv)# no supplementary-service sip moved-temporarily

Related Commands

Command
Description

supplementary-service h450.2 (voice-service)

Globally enables H.450.3 capabilities for call transfer.

supplementary-service h450.3 (voice-service)

Globally enables H.450.3 capabilities for call forwarding.


system message

To set a text message for display on idle Cisco IP Phones 7940 and 7940G and Cisco IP Phones 7960 and 7960G in a Cisco CallManager Express (Cisco CME) system, use the system message command in telephony-service configuration mode. To return to the default, use the no form of this command.

system message text-message

no system message

Syntax Description

text-message

Alphanumeric string of approximately 30 characters maximum to display when the phone is idle.


Defaults

The message "Cisco CallManager Express" is displayed.

Command Modes

Telephony-service configuration

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.2(15)ZJ

3.0

This command was introduced.

12.3(4)T

3.0

This command was integrated into Cisco IOS Release 12.3(4)T.


Usage Guidelines

The number of characters that can be displayed is not fixed because IP phones typically use a proportional (as opposed to a fixed-width) font. There is room for approximately 30 alphanumeric characters.

The display message is refreshed with a new message after any of the following events occurs:

A busy phone goes back on-hook.

An idle phone receives a keepalive message.

A phone is restarted.

Examples

The following example sets the message "ABC Company" to display instead of "Cisco CallManager Express" on idle the Cisco IP Phones 7940 and 7940G and the Cisco IP Phones 7960 and 7960G:

Router(config)# telephony-service
Router(config-telephony)# system message ABC Company

Related Commands

Command
Description

telephony-service

Enters telephony-service configuration mode.



hometocprevnextglossaryfeedbacksearchhelp

Posted: Thu Jul 19 11:20:11 PDT 2007
All contents are Copyright © 1992--2007 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.