Cisco Unified Communications Manager Express Command Reference
Cisco Unified CME Commands: show presence global through system message
Downloads: This chapterpdf (PDF - 1.58MB) The complete bookPDF (PDF - 29.95MB) | Feedback

Cisco Unified CME Commands: show presence global through subnet

Table Of Contents

Cisco Unified CME Commands: show presence global through subnet

show presence global

show presence subscription

show sdspfarm

show shared-line

show telephony-service admin

show telephony-service all

show telephony-service bulk-speed-dial

show telephony-service conference hardware

show telephony-service directory-entry

show telephony-service ephone

show telephony-service ephone-dn

show telephony-service ephone-dn-template

show telephony-service ephone-template

show telephony-service fac

show telephony-service security-info

show telephony-service tftp-bindings

show telephony-service voice-port

show voice emergency

show voice emergency addresses

show voice emergency all

show voice emergency callers

show voice emergency zone

show voice fac statistics

show voice hunt-group

show voice hunt-group statistics

show voice lpcor

show voice moh-group

show voice moh-group statistics

show voice register all

show voice register credential

show voice register dial-peers

show voice register dialplan

show voice register dn

show voice register global

show voice register hfs

show voice register pool

show voice register pool after-hour-exempt

show voice register pool attempted-registrations

show voice register pool cfa

show voice register pool connected

show voice register pool ip

show voice register pool mac

show voice register pool on-hold

show voice register pool phone-load

show voice register pool registered

show voice register pool remote

show voice register pool ringing

show voice register pool telephone-number

show voice register pool type

show voice register pool unregistered

show voice register profile

show voice register session-server

show voice register statistics

show voice register template

show voice register tftp-bind

show voice hunt-group

shutdown(telephony-service)

snr

snr answer-too-soon

snr answer-too-soon (voice register dn)

snr calling-number local

snr calling-number local (voice register dn)

snr mode

snr ring-stop

snr ring-stop (voice register dn)

snr (voice register dn)

softkeys alerting

softkeys connected 

softkeys connected (voice register template)

softkeys hold

softkeys idle

softkeys idle (voice register template)

softkeys remote-in-use

softkeys remote-in-use (voice register template)

softkeys ringin (voice register template)

softkeys ringing

softkeys seized

softkeys seized (voice register template)

source-addr

source-address (voice register global)

speed-dial

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

speed-dial (voice register pool)

srst dn line-mode

srst dn template

srst ephone description

srst ephone template

srst mode auto-provision

standby username password

statistics collect

statistics collect (voice hunt-group)

system message

subnet


Cisco Unified CME Commands: show presence global through subnet


Revised: March 15, 2013

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

show presence global

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

show presence global

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.4(11)XJ

This command was introduced.

12.4(15)T

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


Usage Guidelines

This command displays the configuration settings for presence.

Examples

The following example displays output from the show subscription global:

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

Table 40 describes the significant fields shown in the display.

Table 39 show subscription global Field Descriptions 

Field
Description

Presence feature enable

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

Presence allow external watchers

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

Presence max subscription allowed

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

Presence number of subscriptions

Current number of active presence subscriptions.

Presence allow external subscribe

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

Presence call list enable

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

Presence server IP address

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

Presence sccp blfsd retry interval

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

Presence sccp blfsd retry limit

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

Presence router mode

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


Related Commands

Command
Description

allow watch

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

allow subscribe

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

debug presence

Displays debugging information about the presence service.

presence enable

Allows the router to accept incoming presence requests.

server

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

show presence subscription

Displays information about active presence subscriptions.

watcher all

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


show presence subscription

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

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

Syntax Description

details

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

presentity telephone-number

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

subid subscription-id

(Optional) Displays information for the specific subscription ID.

summary

(Optional) Displays summary information about active subscription requests.


Command Default

Information for all active presence subscriptions is displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.4(11)XJ

This command was introduced.

12.4(15)T

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

12.4(24)T

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


Usage Guidelines

This command displays details about the currently active presence subscriptions

Examples

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

Presence Active Subscription Records Details:
=============================================
 
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               : 4085550103@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 summary command showing that device-based BLF monitoring is enabled on two phones.

Watcher Presentity SubID Expires SibID Status

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

D 2036@10.6.2.6 2038@10.6.2.254 33 3600 0 idle

2036@10.6.2.6 2038@10.6.2.254 35 3600 0 idle

D 2036@10.6.2.6 8883@10.6.2.254 37 3600 0 unknown

 

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

Router# show presence subscription subid 133
 
Presence Active Subscription Records:
=============================================
 
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 40 describes the significant fields shown in the display.

Table 40 show presence subscription Field Descriptions 

Field
Description

Watcher

IP address of the watcher.

Presentity

IP address of the presentity.

Expires

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

line status

Status of the line:

Idle—Line is not being used.

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

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

watcher type

Whether the watcher is local or remote.

presentity type

Whether the presentity is local or remote.

Watcher phone type

Type of phone, either SCCP or SIP.

subscription type

The type of presence subscription, either incoming or outgoing.

retry limit

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

sibling subID

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

sdb

Voice port of the presentity.

dp

Dial peer of the presentity.

watcher dial peer tag

Dial peer tag of the watcher device.


Related Commands

Command
Description

allow watch

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

blf-speed-dial

Enables BLF monitoring for a speed-dial number on a phone registered to Cisco Unified CME.

debug ephone blf

Displays debugging information for BLF presence features.

debug presence

Displays debugging information about the presence service.

presence

Enables presence service and enters presence configuration mode.

presence enable

Allows the router to accept incoming presence requests.

show presence global

Displays configuration information about the presence service.


show sdspfarm

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

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

Syntax Description

units

Displays the configured and registered DSP farms.

sessions

Displays the transcoding streams.

active

Displays all active sessions.

callID

Displays activities for a specific caller ID.

number

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

statistics

Displays session statistics.

summary

Displays summary information.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Products
Modification

12.3(11)T

Cisco CME 3.2

This command was introduced.


Examples

The following is sample output from the show sdspfarm units :

Router# show sdspfarm units
 
   
mtp-1 Device:MTP123456782012 TCP socket:[-1]  UNREGISTERED
actual_stream:0 max_stream 0 IP:0.0.0.0  0  Unknown 0 keepalive 0  
 
   
mtp-2 Device:MTP000a8aeaca80 TCP socket:[5]  REGISTERED
actual_stream:40 max_stream 40 IP:10.5.49.160  11001  MTP YOKO keepalive 12074  
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 :
Router# show sdspfarm sessions active
 
   
Stream-ID:3 mtp:2 1.5.49.160  20174  Local:2000 START  
 usage:MoH  (DN=3  , CH=1) FE=TRUE  
 codec:G729  duration:20 vad:0 peer Stream-ID:4 
 
   
Stream-ID:4 mtp:2 1.5.49.160  17072  Local:2000 START  
 usage:MoH  (DN=3  , CH=1) FE=FALSE 
 codec:G711Ulaw64k  duration:20 vad:0 peer Stream-ID:3 
 
   

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

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

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

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

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

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

Table 41 describes the fields shown in the show sdspfarm display.

Table 41 show sdspfarm Field Descriptions  

Field
Description

act-streams

Active streams that are currently involved in calls.

alloc-streams

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

callID

Caller ID that the active stream is in.

Codec

Codec in use.

confID

ConfID that is used to communicate with DSP farms.

discard

Number of packets that are discarded.

dstCall-ID

Caller ID of the destination IP call leg.

Duration or dur

Packet rates, in milliseconds.

ID

Transcoding stream sequence number in Cisco CME.

in-pak

Number of incoming packets from the source call leg.

Local

Local port for voice packets.

max-mtps

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

max-streams

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

mtp or MTP

MTP sequence number where the transcoding stream is located.

out-pak

Number of outgoing packets sending to source call leg.

peer Stream-ID

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

recv-pak

Number of voice packets received from DSP farm.

srcCall-ID

Source caller ID of the source IP call leg.

State

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

Stream-ID

Transcoding stream sequence number in Cisco CME.

TCP-socket

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

usage

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

vad

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

xmit-pak

Number of packets that are sent to DSP farm.


Related Commands

Command
Description

sdspfarm tag

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

sdspfarm transcode sessions

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

sdspfarm units

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


show shared-line

To display information about the Session Initiation Protocol (SIP) shared lines, use the show shared-line command in user EXEC or privileged EXEC mode.

show shared-line {call | details | subscription | summary}

Syntax Description

call

Displays information about all active calls on shared lines.

details

Displays detailed information about each shared line.

subscription

Displays information for specific subscriptions to shared lines.

summary

Displays summary information about active subscriptions to shared lines.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.4(24)T

This command was introduced.


Examples

The following is sample output from the show shared-line call command:

Router# show shared-line call
 
   
Shared-Line active call info:
 
   
Shared-Line: '20141',  active calls: 3
Local User       Local Address                Remote User       Remote Address 	 CallID
==========       =====================        ===========       ===================== ====
20141            20141@10.6.0.2                20143             20143@10.10.0.1 	3168
 
20141            20141@10.6.0.1                Barge             20143@10.10.0.1 	3209
 
20141            20141@10.6.0.2                20141             20141@10.10.0.1 	3210

The following is sample output from the show shared-line details command:

Router# show shared-line details

Shared-Line info details:

 

Shared-Line: '20141', subscribed users: 2, max calls limit: 10

Index Users sub_id peer_tag Status

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

1 20141@10.6.0.1 5 40001 ACTIVE

2 20141@10.6.0.2 6 40002 ACTIVE

Free call queue size: 7, Active call queue size: 3

 

Message queue size: 20, Event queue size: 64

 

The following is sample output from the show shared-line subscription command:

Router# show shared-line subscription

Shared-Line Subscription Info:

 

Subscriptions to: '20141', total subscriptions: 2

SubID Subscriber Expires Sub-Status

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

5 20141@10.6.0.1 3600 NOTIFY_ACKED

6 20141@10.6.0.2 3600 NOTIFY_ACKED

 

The following is sample output from the show shared-line summary command:

Router# show shared-line summary

Shared-Line info summary:

Shared-Line: '20141', subscribed users: 2, max calls limit: 10

 

Table 42 describes the significant fields shown in the displays.

Table 42 show shared-line Field Descriptions 

Field
Description

Expires

Number of seconds until the subscription expires.

Local Address

IP address of the local phone involved in the shared line call.

Local User

Extension number of the shared line.

Remote Address

IP address of the remote phone involved in the shared line call.

Remote User

Extension of the remote phone involved in the shared line call.

SubID

Subscription ID.

Subscriber

Extension number of the shared line and the IP address of the phone subscriber.

Sub-Status

Status of the subscription.

Users

IP addresses of the phones using the shared line.


Related Commands

Command
Description

debug shared-line

Displays debugging information about SIP shared lines.


show telephony-service admin

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

show telephony-service admin

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.2(2)XT

2.0

This command was introduced.

12.2(8)T

2.0

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


Examples

The following is sample output from this command:

Router# show telephony-service admin
 
   
admin_username Admin
admin_password word
edit DN through Web: enabled.
edit TIME through Web: enabled.
 
   

Table 43 describes the significant fields in this output.

Table 43 show telephony-service admin Field Descriptions  

Field
Description

admin_username

Username of system administrator.

admin_password

Password of system administrator.

edit DN through Web

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

edit TIME through Web

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


Related Commands

Command
Description

dn-webedit

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

time-webedit

Enables setting of time through the web interface.


show telephony-service all

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

show telephony-service all

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.1(5)YD

Cisco Unified CME 1.0

This command was introduced.

12.2(8)T

Cisco Unified CME 2.0

This command was integrated int Cisco IOS Release 12.2(8)T.

15.2(2)T

Cisco Unified CME 9.0

This command was modified to display the total number of data collected from both ephone and voice hunt groups.


Usage Guidelines

Use the show telephony-service all command to display the total number of ephone and voice hunt groups that have statistics collection turned on.

Examples

The following is a sample output from the show telephony-service all command:

Router# show telephony-service all
 
   
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
 
   

The following is a sample output from the show telephony-service all command. The output shows that call statistics are collected for 14 hunt groups, including 6 ephone and 8 voice hunt groups.

Router# show telephony-service all
CONFIG (Version=8.7)
=====================
Version 8.7
Max phoneload sccp version 17
Max dspfarm sccp version 18
Cisco Unified Communications Manager Express
For on-line documentation please see:
http://www.cisco.com/en/US/products/sw/voicesw/ps4625/tsd_products_support_series_home.htm
l
 
   
protocol mode default
ip source-address 1.4.190.80 port 2000
ip qos dscp:
 ef (the MS 6 bits, 46, in ToS, 0xB8) for media
 cs3 (the MS 6 bits, 24, in ToS, 0x60) for signal
 af41 (the MS 6 bits, 34, in ToS, 0x88) for video
 default (the MS 6 bits, 0, in ToS, 0x0) for serviceservice directed-pickup
load 6921 SCCP69xx.9-0-3-0
load 6961 SCCP69xx.8-5-3-0
max-ephones 14
max-dn 56
max-conferences 4 gain -6
dspfarm units 0
dspfarm transcode sessions 0
conference software
privacy
no privacy-on-hold
hunt-group report url prefix tftp://223.255.254.254/ngm/huntgp/uc500/test
hunt-group report url suffix 0 to 20
hunt-group report every 1 hours
# of hunt-group collect data: 14
hunt-group report delay 0 hours
Number of ephone hunt-group configured: 6
hunt-group logout DND
max-redirect 20
cnf-file location: system:
cnf-file option: PER-PHONE-TYPE
 
   

The following is another sample output from the show telephony-service all command. The output shows that call statistics are collected for seven hunt groups, including three ephone and four voice hunt groups.

Router# show telephony-service all
.
.
.
.
.
hunt-group report url prefix tftp://223.255.254.254/ngm/huntgp/uc500/test
hunt-group report url suffix 0 to 20
hunt-group report every 1 hours
# of hunt-group collect data: 7
hunt-group report delay 0 hours
Number of ephone hunt-group configured: 3
.
.
.
.
.

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

Table 44 show telephony-service all Field Descriptions  

Field
Description

button

Button on the Cisco IP phone.

call-forward noan

Call forward no answer is set.

cnf-file location

Storage location for phone configuration files. System (default), flash or slot 0 memory, and external TFTP server.

cnf-file option

Specifies the use of different phone configuration files by type of phone or by individual phone.

cos

Not applicable; unused.

destination-pattern

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

dial-peer voice

Voice dial peer.

dialplan-pattern

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

ephone

Cisco IP phone.

ephone-dn

Cisco IP phone directory number.

huntstop

Huntstop is set.

ip source-address

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

keepalive

IP phone keepalive period, in seconds.

mac-address

MAC address.

max-dn

Maximum directory numbers.

max-ephones

Maximum numbers of Cisco IP phones.

number

Cisco IP phone number.

port

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

pots

POTS dial peer set.

speed-dial

Speed-dial is set.

station-id number

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

timeout

Timeout is set.

timeout ringing

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

transfer-pattern

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

type

Not applicable; unused.

voicemail

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

voice-port

(Virtual) voice port designator.

# of hunt-group collect data

Total number of data collected from both ephone and voice hunt groups.


Related Commands

Command
Description

show telephony dial-peer

Displays dial peers for extensions in a Cisco Unified CME system.

show telephony voice-port

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


show telephony-service bulk-speed-dial

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

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

Syntax Description

global

Global lists that can be accessed by all users.

local

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

list-id

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

index-id

Identification number for an entry.

phone-tag

Ephone identifier (phone-tag).

summary

List of registered bulk speed-dial text files.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

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


Examples

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

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

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

Router# show telephony-service bulk-speed-dial global 9 1234
 
   
Number: 1800 200 1345 name: Jay Smith Private: yes Extension: No
 
   

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

Router# show telephony-service bulk-speed-dial local 2 7 1 all
    Index  Number                  Name                 Hide    Append
    1000   918005550164            ABC Co Front Desk      no     no 
    1003   919005550167            ABC Co File room       no     no 
    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 45 describes the significant fields shown in the display.

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

Field
Description

List-id

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

Entries

Number of entries in the speed-dial file.

Size

Size of the file, in KB.

Reference

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

url

Location of the text file, in URL format.

Index

Identification number for an entry.

Number

Number to be dialed and displayed on the phone.

Name

Name to be displayed on the phone.

Hide

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

Append

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


Related Commands

Command
Description

bulk-speed-dial list (ephone)

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

bulk-speed-dial list (telephony-service)

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

bulk-speed-dial prefix

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


show telephony-service conference hardware

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

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

Syntax Description

ad-hoc

(Optional) Ad-hoc hardware conferences.

detail

(Optional) Detailed information for all conferences.

video

(Optional) Video conferences.

meetme

(Optional) Meet-me hardware conferences.

number

(Optional) Conference number.

telephone-number

(Optional) Telephone or extension number.


Command Modes

Privileged EXEC (#)

Command History

Release
Cisco Product
Modification

12.4(11)XJ2

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

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

15.1(4)M

Cisco Unified CME 8.6

This command was modified to include the video option.

15.2(2)T

Cisco Unified CME9.0

This command was modified to add hardware conference information on Cisco Unified SIP IP phones to the output display.


Usage Guidelines

Use the show telephony-service conference hardware command to display ad-hoc and meet-me hardware conferences information, including which parties are still in the conference.

Examples

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

Router# show telephony-service conference hardware detail
 
   

Conference Type Active Max Peak Master MasterPhone Last

cur(initial)

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

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

Conference parties:

8006 (admin)

8004

8012

    8044
 
   
 
   

The following is a sample output that displays information for a meet-me video conference:

Router# show telephony-service conference hardware detail video
Conference   Type              Active  Max  Peak    Master         MasterPhone   Last
                                                                   cur(initial) 
     
================================================================================
=============
9999         Meetme-Video          10    16    10   n/a            0     (  0)   9012        
Conference parties (number:phone)
    9012  :12 :Audio
    7001  :Video
    9003  :3 :Audio
    7047  :Audio
    7015  :Video
    3667  :Audio
    9024  :24 :Audio
    9023  :23 :Video
    3665  :Video
    9022  :22 :Video
 
   
 
   

The following is another sample output from the show telephony-service conference hardware detail command. The output shows an ad-hoc video hardware conference among three participants, two of which are Cisco Unified SIP IP phones.

Router# show telephony-service conference hardware detail
Conference   Type Active  Max  Peak  Master                 MasterPhone Last
                                                                                                     
cur(initial)      
========================================================================
B000             Ad-hoc Video    3         4       3        3915 SIP3915     15(15)              
5801 RM5801   
Conference parties (number:phone)
   5801 5801 :Video
   3916 SIPPHONE3916 :16 :Video
   3915 SIPPHONE3915 :15  (admin):Video
 
   
 
   

The following is a sample output from the show telephony-service conference hardware ad-hoc command:

Router# show telephony-service conference hardware ad-hoc
Conference   Type Active  Max  Peak  Master                 MasterPhone   Last
                                                                                                     	
cur(initial)      
========================================================================
B000             Ad-hoc Video    3         4       3        3915 SIP3915     15(15)              
5801 RM5801   
 
   
 
   

The following is a sample output from the show telephony-service conference hardware meetme command:

Router# show telephony-service conference hardware meetme
Conference   Type                Active  Max  Peak    Master                MasterPhone   
Last
                                                                                                          
cur(initial)      
========================================================================
7788            Meetme Video     4        4       4         3916 SIP3916    16(16)              
5802 RM5802   
 
   
 
   

The following is a sample output from the show telephony-service conference hardware number command:

Router# show telephony-service conference hardware number B000
Conference   Type                 Active  Max  Peak  Master                 MasterPhone   
Last
                                                                                                     
cur(initial)      
========================================================================
B000             Ad-hoc Video    3         4       3        3915 SIP3915     15(15)              
5801 RM5801   
 
   
 
   

The following is another sample output from the show telephony-service conference hardware number command:

Router# show telephony-service conference hardware number 7788
Conference   Type                Active   Max  Peak  Master                MasterPhone   
Last
                                                                                                        
cur(initial)      
========================================================================
7788             Meetme Video   4         4        4       3917 SIP3917    17(17)               
4801  SCCP4801        

Table 46 describes the significant fields shown in the display, listed in alphabetical order.

Table 46 show telephony-service conference hardware Field Descriptions 

Field
Description

Active

Number of active parties in the conference.

admin

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

Dial in to any conference directly through the conference number.

Use the ConfList soft key to list conference parties.

Remove any party from any conference.

Conference

Conference directory number (DN).

Conference parties

DNs in the conference.

Last

Last participant to join the conference.

Master

Conference creator.

MasterPhone
cur(initial)

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

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

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

Max

Maximum number of participants allowed in the conference.

Peak

Maximum number of participants in the conference at any time.

Type

Type of conference: meet-me or ad hoc.


show telephony-service directory-entry

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

show telephony-service directory-entry

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.2(15)ZJ

3.0

This command was introduced.

12.3(4)T

3.0

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


Usage Guidelines

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

Examples

The following is sample output from this command:

Router# show telephony-service directory-entry
 
   
directory entry 1 4085550123 name Smith, John
 
   

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

Table 47 show telephony-service directory-entry Field Descriptions 

Field
Description

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

Sequence number or unique identifier for a directory entry.

name (shown as Smith, John)

Name that appears in the directory associated with the number.

number (shown as 4085550123 in the example)

Telephone number or extension for the directory entry.


Related Commands

Command
Description

directory entry

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

show telephony-service all

Displays detailed configuration of a Cisco CME system.

show telephony-service ephone-dn

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


show telephony-service ephone

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

show telephony-service ephone

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

12.1(5)YD

Cisco CME 1.0

This command was introduced.

12.2(8)T

Cisco CME 2.0

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

12.4(11)XJ2

Cisco Unified CME 4.1

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

12.4(15)T

Cisco Unified CME 4.1

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

15.0(1)XA

Cisco Unified CME 8.0

This command was modified. The output was enhanced to include the setting of the feature-button command and information about logical partitioning class of restriction (LPCOR).

15.1(1)T

Cisco Unified CME 8.0

This command was integrated into Cisco IOS Release 15.1(1)T.


Examples

The following is sample output from this command:

Router# show telephony-service ephone

 

Number of Configured ephones 2 (Registered 2)

ephone 1

Device Security Mode: Non-Secure

mac-address 1234.4321.7000

type 7960

button 1:1

keepalive 30 auxiliary 30

multicast-moh

max-calls-per-button 8

busy-trigger-per-button 0

Always send media packets to this router: No

Preferred codec: g711ulaw

conference drop-mode never

conference add-mode all

conference admin: No

privacy: Yes

feature-button 1 Dnd

user-locale US

network-locale US

lpcor type: remote

lpcor (incoming): ephone_group2 (outgoing): ephone_group2

!

ephone 2

Device Security Mode: Non-Secure

mac-address 1234.4321.6000

type 7960

button 1:2

keepalive 30 auxiliary 30

multicast-moh

max-calls-per-button 8

busy-trigger-per-button 0

Always send media packets to this router: No

Preferred codec: g711ulaw

conference drop-mode never

conference add-mode all

conference admin: No

privacy: Yes

feature-button 1 Dnd

user-locale US

network-locale US

lpcor type: local

lpcor (incoming): ephone_group1 (outgoing): ephone_group1

!

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

Table 48 show telephony-service ephone Field Descriptions   

Field
Description

button

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

conference add-mode

Who can add parties to a conference:

creator—Only the creator can add parties.

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

conference drop-mode

When conferences are dropped:

creator—Conference terminates when the creator hangs up.

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

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

conference admin

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

Dial in to any conference directly through the conference number

Use the ConfList soft key to list conference parties

Remove any party from any conference

ephone

Cisco IP phone.

feature-button

Displays the type of feature button on the ephone. Feature type can be configured with privacy or DND.

lpcor (incoming)

Setting of the lpcor incoming command.

lpcor (outgoing)

Setting of the lpcor outgoing command.

lpcor type

Setting of the lpcor type command.

mac-address

MAC address of the Cisco IP phone.

speed-dial

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

type

Model type of phone.


Related Commands

Command
Description

show telephony-service all

Displays detailed configuration for a Cisco Unified CME system.

show telephony-service dial-peer

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

show telephony-service ephone-dn

Displays information for extensions in Cisco Unified CME.

show telephony-service voice-port

Displays configurations for virtual voice ports in Cisco Unified CME.


show telephony-service ephone-dn

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

show telephony-service ephone-dn

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.1(5)YD

1.0

This command was introduced

12.2(8)T

2.0

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


Examples

The following is sample output from this command:

Router# show telephony-service ephone-dn
 
   
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 49 describes significant fields in this output, in alphabetical order.

Table 49 show telephony-service ephone-dn Field Descriptions 

Field
Description

call-forward noan

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

ephone-dn

Cisco IP phone directory number.

huntstop

Huntstop is set.

number

Cisco IP phone number.

timeout

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


Related Commands

Command
Description

show telephony-service all

Displays the detailed configuration of all the Cisco IP phones.

show telephony-service dial-peer

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

show telephony-service voice-port

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


show telephony-service ephone-dn-template

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

show telephony-service ephone-dn-template

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

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


Usage Guidelines

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

Examples

The following is sample output from this command:

Router# show telephony-service ephone-dn-template
 
   
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)XJ2

Cisco Unified CME 4.1

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

12.4(15)T

Cisco Unified CME 4.1

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

12.4(15)XY

Cisco Unified CME  4.2(1)

Emergency response location (ERL) information assigned to an ephone displays in the output.

12.4(20)T

Cisco Unified CME  7.0

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

15.0(1)XA

Cisco Unified CME 8.0

This command was modified. Logical partitioning class of restriction (LPCOR) information was added to the output.

15.1(1)T

Cisco Unified CME 8.0

This command was integrated into Cisco IOS Release 15.1(1)T.


Usage Guidelines

Use this command to display the contents of each ephone template that is defined. Use the show running-config command to display the association of templates to specific ephones.

Examples

The following is sample output from this command:

Router# show telephony-service ephone-template

 

ephone-template 1

softkey idle Cfwdall Dnd Gpickup Join Pickup RmLstC

softkey connected Acct ConfList Confrn Endcall Hold Join Park

conference drop-mode never

conference add-mode all

conference admin: No

max-calls-per-button 8

busy-trigger-per-button 0

privacy default

MLPP max precedence level -1

MLPP indication Enabled

MLPP preemption Enabled

Always send media packets to this router: No

Preferred codec: g711ulaw

keepalive 30 auxiliary 30

User Locale: US

Network Locale: US

Emergency Response Location: 6

lpcor type: remote

lpcor (incoming): local_sccp_phone_1 (outgoing): local_sccp_phone_1

 

Table 50 describes significant fields in this output.

Table 50 show telephony-service ephone Field Descriptions   

Field
Description

ephone-template

Identifier for the ephone template.

softkey hold

Soft keys displayed during the hold call stage.

softkey idle

Soft keys displayed during the call-idle call stage.

softkey seized

Soft keys displayed during the call-seized call stage.

softkey alerting

Soft keys displayed during the call-alerting call stage.

softkey connected

Soft keys displayed during the call-connected call stage.

conference drop-mode

When conferences are dropped:

creator: Conference terminates when the creator hangs up.

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

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

conference add-mode

Who can add parties to a conference:

creator: Only the creator can add parties.

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

conference admin

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

Dial in to any conference directly through the conference number.

Use the ConfList soft key to list conference parties.

Remove any party from any conference.

Always send media packets to this router

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

Preferred codec

Codec to use when initiating a call.

button-layout

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

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

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

User Locale

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

Network Locale

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

Emergency response location

Identification of the ERL defined with the emergency response location command.

lpcor (incoming)

Setting of the lpcor incoming command.

lpcor (outgoing)

Setting of the lpcor outgoing command.

lpcor type

Setting of the lpcor type command.


Related Commands

Command
Description

ephone-template

Creates an ephone template.


show telephony-service fac

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

show telephony-service fac

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

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


Usage Guidelines

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

Examples

The following example displays the set of standard FACs:

Router# show telephony-service fac
 
   
telephony-service fac standard
 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 when the ISO-3166 code for Germany has been selected for both language and tones:

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

tftp-server system:/its/SEPDEFAULT.cnf

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

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

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

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

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

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

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

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

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

Related Commands

Command
Description

network-locale

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

user-locale

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


show telephony-service voice-port

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

show telephony-service voice-port

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.1(5)YD

1.0

This command was introduced.

12.2(8)T

2.0

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


Usage Guidelines

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

Examples

The following is sample output from this command:

Router# show telephony-service voice-port
 
   
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 51 describes significant fields in this output, in alphabetical order.

Table 51 show telephony-service voice-port Field Descriptions 

Field
Description

station-id number

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

timeout ringing

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

voice-port

Virtual voice port.


Related Commands

Command
Description

show telephony-service all

Displays the detailed configuration of all the Cisco IP phones.

show telephony-service dial-peer

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

show telephony-service ephone-dn

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


show voice emergency

To display the IP address, subnet mask, and ELIN for each emergency response location, use the show voice emergency command in user EXEC or privileged EXEC mode.

show voice emergency

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(15)XY

Cisco Unified CME  4.2(1)
Cisco Unified SRST 4.2(1)
Cisco Unified SIP SRST 4.2(1)

This command was introduced.

12.4(20)T

Cisco Unified CME  7.0
Cisco Unified SRST 7.0
Cisco Unified SIP SRST 7.0

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


Usage Guidelines

Use this command to display the IP address, subnet mask, and ELIN for each emergency response location.

Examples

The following example shows sample output which includes IP mask and ELIN information for each ERL:

EEMERGENCY RESPONSE LOCATIONS
ERL               | ELIN 1     | ELIN2      | SUBNET 1        | SUBNET 2       
1                 | 6045550101 |            | 10.0.0.0        | 255.0.0.0 
2                 | 6045550102 | 6045550106 | 192.168.0.0     | 255.255.0.0 
3                 |            | 6045550107 | 172.16.0.0      | 255.255.0.0 
4                 | 6045550103 |            | 192.168.0.0     | 255.255.0.0 
5                 | 6045550105 |            | 209.165.200.224 | 255.0.0.0 
6 6045550198      |            | 6045550109 | 209.165.201.0   | 255.255.255.224 
 
   

Related Commands

Command
Description

voice emergency response location

Creates a tag for identifying an ERL for E911 services.


show voice emergency addresses

To display address information for each emergency response location, use the show emergency addresses command in user EXEC or privileged EXEC mode.

show voice emergency addresses

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(15)XY

Cisco Unified CME  4.2(1)
Cisco Unified SRST 4.2(1)
Cisco Unified SIP SRST 4.2(1)

This command was introduced.

12.4(20)T

Cisco Unified CME  7.0
Cisco Unified SRST 7.0
Cisco Unified SIP SRST 7.0

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


Usage Guidelines

This command displays the physical address of each emergency response location.

Examples

The following example shows a sample output which includes physical address information for the ERL:

Router# show voice emergency addresses
 
   
3850 Zanker Rd, San Jose,604,5550101
225 W Tasman Dr, San Jose,604,5550102
275 W Tasman Dr, San Jose,604,5550103
518 Bellew Dr,Milpitas,604,5550104
400 Tasman Dr,San Jose,604,5550105
    3675 Cisco Way,San Jose,604,5550106
 
   

Related Commands

Command
Description

address

Specifies a comma separated text entry (up to 250 characters) of an ERL's civic address.

show voice emergency all

Displays all emergency response location information.

voice emergency response location

Creates a tag for identifying an ERL for E911 services.


show voice emergency all

To display all emergency response location information, use the show voice emergency all command in user EXEC or privileged EXEC mode.

show voice emergency all

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(15)XY

Cisco Unified CME  4.2(1)
Cisco Unified SRST 4.2(1)
Cisco Unified SIP SRST 4.2(1)

This command was introduced.

12.4(20)T

Cisco Unified CME  7.0
Cisco Unified SRST 7.0
Cisco Unified SIP SRST 7.0

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


Usage Guidelines

Use this command to display all information configured for each emergency response location.

Examples

The following example shows a sample output, displaying all ERL-related information for ERL 1 and 3.

VOICE EMERGENCY RESPONSE SETTINGS
   Callback Number: 6045550103
   Emergency Line ID Number: 6045550155
   Expiry: 2 minutes
   Logging Enabled
 
   
EMERGENCY RESPONSE LOCATION 1
   Name: Cisco Systems 1
   Address: 3850 Zanker Rd, San Jose,elin.1.3,elin.4.10 
   IP Address 1: 209.165.200.226 IP mask 1: 255.255.255.254
   IP Address 2: 209.165.202.129 IP mask 2: 255.255.0.0
   Emergency Line ID 1: 6045550180
   Emergency Line ID 2: 
   Last Caller:  6045550188 [Jan 30 2007 16:05.52 PM]
   Next ELIN For Emergency Call: 6045550166
 
   
EMERGENCY RESPONSE LOCATION 3
   Name: Cisco Systems 3
   Address: 225 W Tasman Dr, San Jose,elin.1.3,elin.4.10 
   IP Address 1: 209.165.202.133 IP mask 1: 255.255.0.0
   IP Address 2: 209.165.202.130 IP mask 2: 255.0.0.0
   Emergency Line ID 1: 
   Emergency Line ID 2: 6045550150
   Last Caller:  
   Next ELIN For Emergency Call: 6045550151
 
   

Related Commands

Command
Description

address

Specifies a comma separated text entry (up to 250 characters) of an ERL's civic address.

elin

Specifies a PSTN number that will replace the caller's extension.

name

Specifies a string (up to 32-characters) used internally to identify or describe the emergency response location.

subnet

Defines which IP phones are part of this ERL.

voice emergency response location

Creates a tag for identifying an ERL for the E911 services.


show voice emergency callers

To display a list of 911 calls made over the last three hours, use the show emergency callers command in privileged EXEC mode.

show voice emergency callers

Syntax Description

This command has no arguments or keywords.

Command Default

No list of 911 calls is displayed.

Command Modes

Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(15)T

Cisco Unified CME  4.1
Cisco Unified SRST 4.1
Cisco Unified SIP SRST 4.1

This command was introduced. For Cisco Unified CME, this command is supported in SRST fallback mode only.

12.4(15)XY

Cisco Unified CME  4.2(1)
Cisco Unified SRST 4.2(1)
Cisco Unified SIP SRST 4.2(1)

This command was added to Cisco Unified CME.

12.4(20)T

Cisco Unified CME  7.0
Cisco Unified SRST 7.0
Cisco Unified SIP SRST 7.0

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


Usage Guidelines

Use this command to display a list of all 911 calls made in the past three hours. The list shows the originating number, the ELIN used, and the time the call was placed.

Examples

The following example shows sample output, which includes the originating number, the ELIN used, and the time the call was placed:

router# show voice emergency callers
 
   
EMERGENCY CALLS CALL BACK TABLE
ELIN                      | CALLER                     | TIME                
6045550181                | 8155550151                | Oct 12 2006 04:05:21
6045550182                | 8155550152                | Oct 12 2006 04:05:21
 
   

Related Commands

Command
Description

voice emergency response location

Creates a tag for identifying an ERL for the enhanced 911 service.


show voice emergency zone

To display each emergency response zone's list of locations in priority order, use the show voice emergency zone command in user EXEC or privileged EXEC mode.

show voice emergency zone

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(15)XY

Cisco Unified CME 4.2(1)
Cisco Unified SRST 4.2(1)
Cisco Unified SIP SRST 4.2(1)

This command was introduced.

12.4(20)T

Cisco Unified CME  7.0
Cisco Unified SRST 7.0
Cisco Unified SIP SRST 7.0

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


Usage Guidelines

Use this command to display a list of the locations, in priority order, of all configured emergency response zones.

Examples

The following example shows a sample output which displays the ERL locations for emergency response zones 90 and 100.

EMERGENCY RESPONSE ZONES
 zone 90
    location 4
    location 5
    location 6
    location 7
    location 2147483647
 zone 100
    location 1 priority 1
    location 2 priority 2
    location 3 priority 3
 
   

Related Commands

Command
Description

location

Identifies locations within an emergency response zone.

voice emergency response location

Creates a tag for identifying an ERL for the enhanced 911 service.

voice emergency response zone

Creates an emergency response zone within which ERLs can be grouped.


show voice fac statistics

To display the FAC failure statistics collected by the system, use the show voice fac statistics command in privileged EXEC mode.

show voice fac statistics

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(3)T

Cisco Unified CME 8.5

This command was introduced.


Usage Guidelines

Use this command to display the forced athentication code (FAC) success or failure statistics collected by the system.

Examples

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

Router# show voice fac statistics

Voice FAC statistics for failure calls:

Total basic calls: 5

Total forward calls: 1

 
   

Related Commands

Command
Description

show call active voice

Displays call information for voice calls that are in progress.

show call history voice

Displays the call history table for voice calls.


show voice hunt-group

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

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

Syntax Description

hunt-group-tag

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

brief

(Optional) Displays brief information on all voice hunt groups in a Cisco CME system.

longest-idle

(Optional) Displays summary of longest-idle voice hunt groups.

parallel

(Optional) Displays summary of parallel voice hunt groups.

peer

(Optional) Displays summary of peer voice hunt groups.

sequential

(Optional) Displays summary of sequential voice hunt groups.


Command Modes

Privileged EXEC (# )

Command History

Release
Modification

12.4(24)T

This command was introduced in a release earlier than Cisco IOS Release 12.4(24)T.

15.2(2)T

This command was modified to add stat collect as a field.


Usage Guidelines

Use the show voice hunt-group command to get information about voice hunt group configuration on the gateway as an alternative to the show running-config command.

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

Examples

The following is a sample output from the show voice hunt-group command, displaying all voice hunt groups configured on the router:

Router# show voice hunt-group
 
   
Group 1
    type: longest-idle
    preference: 0
    preference (sec): 0
    timeout: 0
    final_number: 1
Group 34
    type: parallel
    pilot number: 3, peer-tag 2147483647
    secondary number: 4, peer-tag 2147483646
    preference: 0
    preference (sec): 0
    timeout: 0
    final_number:
 
   

The following is a sample output from the show voice hunt-group command, displaying the configuration for all the configured voice hunt groups:

Router# show voice hunt-group
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 a sample output from the show voice hunt-group command, displaying information for a particular voice hunt group as specified by the hunt-group-tag number:

Router# show voice hunt-group 5
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 a sample output from the show voice hunt-group command, displaying information about all the voice hunt groups of a particular type:

Router# show voice hunt-group longest-idle 
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 is a sample output from the show voice hunt-group command with the keyword brief:

Router# show voice hunt-group 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
 
   

The following is a sample output from the show voice hunt-group command, indicating that call statistics is being collected:

Router# show voice hunt-group 1
Group 1
    type: parallel
    pilot number: 5000, peer-tag 2147483647
    list of numbers: 5001,5002,5011,5012,
    preference: 0
    preference (sec): 0
    timeout: 12
    final_number: 5012
    stat collect: yes
 
   

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

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

Table 72 describes the significant fields shown in the output.

Table 52 show voice hunt-group Field Descriptions 

Field
Description

Group

Tag number of voice hunt group.

type

Type of voice hunt group. The available voice hunt group types are: longest-idle, parallel, peer and sequential.

pilot number

Number that callers dial to reach the specified voice hunt group.

secondary-number

Alternate number for the specified voice hunt group.

list of numbers

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

preference

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

preference (sec)

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

timeout

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

final_number

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

hops

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

stat collect

Yes indicates that call statistics are being collected for a voice hunt group.

peer-tag

Peer hunting tag.


Related Commands

Command
Description

final (voice hunt-group)

Defines the last extension in a voice hunt group.

hops (voice hunt-group)

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

list (voice hunt-group)

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

pilot (voice hunt-group)

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

timeout (voice hunt-group)

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

voice hunt-group

Configures voice hunt groups and the associated parameters.


show voice hunt-group statistics

To display call statistics from voice hunt groups, use the show voice hunt-group statistics command in privileged EXEC mode.

show voice hunt-group group-id statistics {last hours hours | start day time [to day time]}

Syntax Description

group-id

Identifier for the voice hunt group. Range: 1 to 100.

last

Displays the latest call statistics for a voice hunt group for a specified number of hours, counting backward from the current hour. Range: 1 to 167.

hours hours

Number of hours that the call statistics are displayed.

start

Defines the start of the period for which the call statistics are displayed. Default duration is one hour.

day

Abbreviated day of the week. The following abbreviations are valid: sun, mon, tue, wed, thu, fri, sat.

time

Hour of the day. Range: 0 to 23.

to

(Optional) Defines the time the display of the call statistics ends.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

15.2(2)T

This command was introduced.


Usage Guidelines

Use the show voice hunt-group statistics command to display the average and longest times for a voice hunt group to answer a call, make a call, or put a call on hold. The command can also display the number of answered and abandoned calls, the number of calls forwarded to or answered by voice mail, and the number of error calls.

The output is dependent on call activity. If there is no activity, no data is displayed.

If your Cisco Unified CME system is configured with the basic automatic call distribution (B-ACD) and auto-attendant service, you can enable the collection of call statistics for every voice hunt group with the voice hunt-group statistics collect command. Additional data is displayed for all agents combined and for individual agents.


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


For remote Cisco Unified SCCP IP phones in voice hunt groups, the hold and resume statistics are not updated.

Examples

The following is a sample output from the show voice hunt-group statistics command. The output includes direct calls to a voice hunt group number and calls from queue/B-ACD.

Router# show voice hunt-group 1 statistics last 1 h
Wed 04:00 - 05:00
	Max Agents: 3
	Min Agents: 3
	Total Calls: 9
	Answered Calls: 7
	Abandoned Calls: 2
	Average Time to Answer (secs): 6
	Longest Time to Answer (secs): 13
	Average Time in Call (secs): 75
	Longest Time in Call (secs): 161
	Average Time before Abandon (secs): 8
	Calls on Hold: 2
	Average Time in Hold (secs): 16	
	Longest Time in Hold (secs): 21
	Per agent statistics:
		Agent: 5012
			From Direct Call:
				Total Calls Answered: 3
				Average Time in Call (secs): 70
				Longest Time in Call (secs): 150
				Totals Calls on Hold: 1
				Average Hold Time (secs): 21
				Longest Hold Time (secs): 21
			From Queue:
				Total Calls Answered: 3
				Average Time in Call (secs): 55
				Longest Time in Call (secs): 78
				Total Calls on Hold: 2
				Average Hold Time (secs): 19
				Longest Hold Time (secs): 26
		Agent: 5013
			From Direct Call:
				Total Calls Answered: 3
				Average Time in Call (secs): 51
				Longest Time in Call (secs): 118
				Totals Calls on Hold: 1
				Average Hold Time (secs): 11
				Longest Hold Time (secs): 11
			From Queue:
				Total Calls Answered: 1
				Average Time in Call (secs): 4
				Longest Time in Call (secs): 4
		Agent: 5014
			From Direct Call:
				Total Calls Answered: 1
				Average Time in Call (secs): 161
				Longest Time in Call (secs): 161
			From Queue:
				Total Calls Answered: 1
				Average Time in Call (secs): 658
				Longest Time in Call (secs): 658
	Queue related statistics:
		Total calls presented to the queue: 5
		Calls handoff to IOS: 5
		Number of calls in the queue: 0
		Average time to handoff (secs): 2
		Longest time to handoff (secs): 3
		Number of abandoned calls: 0
		Average time before abandon (secs): 0
		Calls forwarded to voice mail: 0
		Calls answered by voice mail: 0
		Number of error calls: 0		
 
   

The following is a sample output from the show voice hunt-group statistics command. The output focuses on queue-related statistics.

Queue related statistics:
      Total calls presented to the queue: 8
      Calls handoff to IOS: 3
      Number of calls in the queue: 1
      Average time to handoff (secs): 10
      Longest time to handoff (secs): 15
      Number of abandoned calls: 4
      Average time before abandon (secs): 7
      Calls forwarded to voice mail: 0
      Calls answered by voice mail: 0
      Number of error calls: 0
 
   

The following is a sample output from the show voice hunt-group statistics command. The output shows that no call statistics were collected from voice hunt group 1 from 2:00 to 4:00 on a Monday.

Router# show voice hunt-group 1 stat start Mon 2 to Mon 4
Mon 02:00 - 03:00
    No info
Mon 03:00 - 04:00
    No info
Mon 04:00 - 05:00
    No info
 
   

Table 53 describes the significant fields shown in the display.

Table 53 show voice hunt-group statistics Field Descriptions 

Field
Description

Max agent

Maximum number of hunt group agents.

Min agent

Minimum number of hunt group agents.

Average time to answer (secs)

Average length of time that all calls to Cisco Unified CME B-ACD waited before being answered.

Longest time to answer (secs)

Longest length of time before calls to Cisco Unified CME B-ACD were answered.

Average time in call (secs)

Average length of time that unanswered calls waited before going to an agent.

Longest time in call (secs)

Longest length of time that all calls to Cisco Unified CME B-ACD that went to an agent waited in a call queue.

Average time before abandon (secs)

Average length of time that unanswered calls waited before hanging up.

Calls on hold

Total number of calls that were placed on hold.

Average time in hold (secs)

Average length of time that calls were kept on hold for all agents.

Longest time in hold (secs)

Longest length of time that a call spent between being placed on hold and being picked up by agents.

Total calls answered

Total number of calls to Cisco Unified CME B-ACD that were answered by an agent.

Total calls on hold

Total number of calls that were placed on hold for this agent.

Average hold time (secs)

Average length of time that calls waited on hold for this agent.

Longest hold time (secs)

Longest length of time that a call to this agent was spent between being placed on hold and being picked up.

Total calls presented to the queue

Total number of calls made to Cisco Unified CME B-ACD.

Calls handoff to IOS

Total number of calls handed off to IOS.

Number of calls in the queue

Total number of calls in the queue.

Average time to handoff (secs)

Average length of time before a call was handed off to IOS

Longest time to handoff (secs)

Longest length of time before a call was handed off to IOS.

Number of abandoned calls

Total number of calls to Cisco Unified CME B-ACD that hung up before being answered.

Calls forwarded to voice mail

Total number of calls to Cisco Unified CME B-ACD that were forwarded to voice mail.

Calls answered by voice mail

Total number of calls to Cisco Unified CME B-ACD that were answered by voice mail.

Number of error calls

Total number of error calls.


Related Commands

Command
Description

voice hunt-group statistics collect

Enables the collection of call statistics for voice hunt groups.


show voice lpcor

To display information about logical partitioning class of restriction (LPCOR) policies and calls, use the show voice lpcor policy command in user EXEC or privileged EXEC mode.

show voice lpcor {ip-phone dn | policy lpcor-group | statistics}

Syntax Description

ip-phone dn

Displays the LPCOR policy associated with each directory number.

policy lpcor-group

Displays the LPCOR policy for the specified resource group.

statistics

Displays statistics for LPCOR calls that failed.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

15.0(1)XA

Cisco Unified CME 8.0

This command was introduced.

15.1(1)T

Cisco Unified CME 8.0

This command was integrated into Cisco IOS Release 15.1(1)T.


Usage Guidelines

This command displays information about the LPCOR policies configured on the router. You can display the LPCOR information by directory number, for a specific policy, or the number and type of LPCOR calls that fail.

Examples

The following is sample output from the show voice lpcor ip-phone dn command.

Router# show voice lpcor ip-phone dn

 

ephone-dn 1 number 9111:
  ephone 1:
    Lpcor Type: local Incoming: local_sccp_phone_11 Outgoing: local_sccp_phone_1
1
 
ephone-dn 2 number 9112:
  ephone 2:
    Lpcor Type: local Incoming: local_sccp_phone_12 Outgoing: local_sccp_phone_1
2
 
ephone-dn 3 number 9113:
  ephone 3:
    Lpcor Type: local Incoming: local_sccp_phone_13 Outgoing: local_sccp_phone_1
3
 
ephone-dn 4 number 9114:
  ephone 4:
    Lpcor Type: local Incoming: local_sccp_phone_14 Outgoing: local_sccp_phone_1
4

 

The following is sample output from the show voice lpcor policy command:

Router# show voice lpcor policy voip_siptrunk

 

voice lpcor policy voip_siptrunk (group 1):

 ( accept ) voip_siptrunk (group 1)

 ( reject ) voip_h323trunk (group 2)

 ( reject ) pstn_trunk (group 3)

 ( reject ) cue_vmail_local (group 4)

 ( reject ) cue_vmail_remote (group 5)

 ( reject ) vmail_unity (group 6)

 ( accept ) local_sccp (group 7)

 ( accept ) local_sip (group 8)

 ( reject ) remote_sccp (group 9)

 ( reject ) remote_sip (group 10)

 ( accept ) analog_vg224 (group 11)

 ( reject ) analog_fxs (group 12)

 

The following is sample output from the show voice lpcor statistics command:

Router# show voice lpcor statistics

 

Voice LPCOR statistics for failure calls:

 Total basic calls: 5

 Total forward calls: 1

 Total transfer calls: 2

 Total conference calls: 0

 Total park retrieval calls: 1

 Total pick up calls: 0

Related Commands

Command
Description

clear voice lpcor statistics

Clears all LPCOR statistics.

lpcor incoming

Associates an incoming call with a LPCOR resource-group policy.

lpcor outgoing

Associates an outgoing call with a LPCOR resource-group policy.

voice lpcor policy

Creates a LPCOR policy for a resource group.


show voice moh-group

To display information about voice moh-groups, use the show voice moh-group command in in privileged EXEC mode.

show voice moh-group

Syntax Description

This command has no arguments or keywords

Command Modes

Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

15.0(1)XA

Cisco Unified CME  8.0
Cisco Unified SRST 8.0

This command was introduced.

15.1(1)T

Cisco Unified CME  8.0
Cisco Unified SRST 8.0

This command was integrated into Cisco IOS Release 15.1(1)T.


Examples

The following sample output shows general information about voice moh-groups in Cisco Unifiede CME or Cisco Unified SRST.

Router# show voice moh-group 
voice moh-group 1
 description this moh group is for sales
 moh hello.au
 multicast moh 239.1.1.1 port 16386 route 239.1.1.3 239.1.1.3
 extension-range 1000 to 1999
 extension-range 2000 to 2999
 extension-range 3000 to 3999
extension-range 20000 to 22000
 extension-range A1000 to A1999
 
   
voice moh-group 2
 description (not configured)
 moh minuet.au
 multicast moh 239.23.4.10 port 2000
 extension-range 7000 to 7999
 extension-range 8000 to 8999
 
   
voice moh-group 3
 description This is for marketing
 moh happy.au
 multicast moh 239.15.10.1 port 3000
 extension-range 9000 to 9999
 
   
voice moh-group 4
 description (not configured)
moh sun.au
 multicast moh 239.16.12.1 port 4000
 extension-range 10000 to 19999
 
   
voice moh-group 5
 description (not configured)
 moh flower.wav
 multicast moh 239.12.1.2 port 5000
 extension-range ABCD to DECF
 extension-range 0012 to 0024
 extension-range 0934 to 0964
 
   
=== Total of 5 voice moh-groups ===

e

 

Examples

Command
Description

showcall-manager-fallback all

Displays the detailed configuration of all Cisco IP phones, directory numbers, voice ports, and dial peers in your network during Cisco Unified Communications Manager fallback.

show ephone summary

Displays the information about the MOH files in use

show voice moh-group statistics

Displays the MOH subsystem statistics information


show voice moh-group statistics

To display the MOH subsystem statistics information, use the show voice moh-group command in privileged EXEC mode.

show voice moh-group statistics

Syntax Description

This command has no arguments or keywords

Command Modes

Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

15.0(1)XA

Cisco Unified CME 8.0
Cisco Unified SRST  8.0

This command was introduced.

15.1(1)T

Cisco Unified CME 8.0
Cisco Unified SRST 8.0

This command was integrated into Cisco IOS Release 15.1(1)T.


Examples

In the following example, the MOH Group Streaming Interval Timing Statistics shows the media packet counts during streaming intervals.

Each packet counter is of 32 bit size and holds a count limit of 4294967296 intervals. This means that with 20 milliseconds packet interval (for G.711), the counters restart from 0 any time after 2.72 years (2 years 8 months). You must use the e clear voice moh-group statistics once in every two years to reset the packet counters.

MOH Group Packet Transmission Timing Statistics shows the maximum and minimum amount of time (in microseconds) taken by the MOH groups to send out media packets.

The MOH Group Loopback Interval Timing Statistics is available when loopback interface is configured as part of the multicast MOH routes in Cisco Unified SRST . These counts are loopback packet counts within certain streaming timing intervals.

router# show voice moh-group statistics 
MOH Group Streaming Interval Timing Statistics:
Grp#  ~19 msec     20~39      40~59      60~99     100~199   200+ msec
==== ========== ========== ========== ========== ========== ==========
 0:       25835   17559966      45148          0          0          1
 1:       19766   17572103      39079          0          0          1
 2:       32374   17546886      51687          0          0          1
 3:       27976   17555681      47289          0          0          1
 4:       34346   17542940      53659          0          0          1
 5:       14971   17581689      34284          0          0          1
 
   
MOH Group Packet Transmission Timing Statistics:
Grp#  max(usec)  min(usec) 
==== ========== ========== 
 0:          97          7.
 1:          95          7.
 2:          97          7.
 3:          96          7.
 4:          94          7.
 5:          67          7.
 
   

MOH Group Loopback Interval Timing Statistics:

loopback event array: svc_index=1542, free_index=1549, max_q_depth=31

Grp# ~19 msec 20~39 40~59 60~99 100~199 200+ msec

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

0: 8918821 8721527 10023 0 1 1

1: 9007373 8635813 7184 0 1 1

2: 8864760 8772851 12758 0 1 1

3: 8924447 8715457 10464 0 1 1

4: 8858393 8778957 13017 0 1 1

5: 9005511 8639936 4919 0 1 1

Statistics collect time: 4 days 2 hours 5 minutes 39 seconds.

Related Commands

Command
Description

show ephone-dn

Displays MOH group information for a phone directory number.

show ephone summary

Displays the information about the MOH files in use

show voice moh-group

Displays the MOH groups configured


show voice register all

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

show voice register all

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

12.2(15)ZJ

Cisco SIP SRST 3.0

This command was introduced.

12.3(4)T

Cisco SIP SRST 3.0

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

12.4(4)T

Cisco CME 3.4
Cisco SIP SRST 3.4

This command was added to Cisco CME.

15.0(1)XA

Cisco SIP SRST 8.0

This command was modified to display the signaling transport protocol.

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SIP SRST 8.1

The output display of this command was modified.

15.2(4)M

Cisco Unified CME 9.1

This command was modified to include Key Expansion Module (KEM) data in the output display.


Usage Guidelines

KEM data are displayed for Cisco Unified CME only. Cisco Unified SRST is unable to gather all the configuration details about KEMs from Cisco Unified CM.

Examples

Cisco Unified SIP SRST

The following is a sample output of the show voice register all command:

Router# show voice register all
 
   
VOICE REGISTER GLOBAL
=====================
CONFIG [Version=8.1]
========================
  Version 8.1
  Mode is srst
  Max-pool is 10
  Max-dn is 10
  Outbound-proxy is enabled and will use global configured value
  Security Policy: DEVICE-DEFAULT
  timeout interdigit 10
  network-locale[0] US    (This is the default network locale for this box)
  network-locale[1] US 
  network-locale[2] US 
  network-locale[3] US 
  network-locale[4] US 
  user-locale[0] US    (This is the default user locale for this box)
  user-locale[1] US 
  user-locale[2] US 
  user-locale[3] US 
  user-locale[4] US   Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
VOICE REGISTER DN
=================
Dn Tag 1
Config:
  Number is 45111
  Preference is 0
  Huntstop is disabled
  Pool 1    has this DN configured for line 1
Dn Tag 2
Config:
  Number is 45112
  Preference is 0
  Huntstop is disabled
  Pool 2    has this DN configured for line 1
Dn Tag 3
Config:
  Number is 45113
  Preference is 0
  Huntstop is disabled
  Pool 3    has this DN configured for line 1, 2
Dn Tag 4
Config:
Dn Tag 7
Config:
  Number is 451110
  Preference is 0
  Huntstop is disabled
  Pool 1    has this DN configured for line 4
Dn Tag 8
Config:   
  Pool 1    has this DN configured for line 3
 
   
VOICE REGISTER POOL
===================
 Pool Tag 1
Config:
  Mac address is 001B.535C.D410
  Number list 1 : DN 1
  Number list 3 : DN 8
  Number list 4 : DN 7
  Proxy Ip address is 0.0.0.0
  DTMF Relay is disabled
  kpml signal is disabled
  Lpcor Type is none
 
   
  Reason for unregistered state: 
         No registration request since last reboot/unregister
 
   
 
   
Dialpeers created:
 
   
Statistics:
  Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 
   
 Pool Tag 2
Config:
  Mac address is 0015.C68E.6D13
  Number list 1 : DN 2
  Proxy Ip address is 0.0.0.0
  DTMF Relay is disabled
  kpml signal is disabled
  Lpcor Type is none
 
   
  Reason for unregistered state: 
         No registration request since last reboot/unregister
 
   
 
   
Dialpeers created:
 
   
Statistics:
  Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 Pool Tag 3
Config:
  Mac address is 0021.5553.8998
  Number list 1 : DN 3
  Number list 2 : DN 3
  Proxy Ip address is 0.0.0.0
  DTMF Relay is disabled
  kpml signal is enabled
  Lpcor Type is none
 
   
  Reason for unregistered state: 
         No registration request since last reboot/unregister
 
   
 
   
Dialpeers created:
 
   
Statistics:
  Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   

Cisco Unified CME

The following is a sample output of the show voice register all command:

Router# show voice register all
 
   
1) show voice register all
 
   
VOICE REGISTER GLOBAL
=====================
CONFIG [Version=8.1]
========================
  Version 8.1
  Mode is cme
  Max-pool is 10
  Max-dn is 10
  Outbound-proxy is enabled and will use global configured value
  Security Policy: DEVICE-DEFAULT
  Source-address is 8.3.3.5 port 5060
  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
  Privacy is enabled
  Privacy-on-hold is disabled
  Dst auto adjust is enabled
    start at Apr week 1 day Sun time 02:00
    stop  at Oct week 8 day Sun time 02:00
  Max redirect number is 5
  IP QoS DSCP:
    ef (the MS 6 bits, 46, in ToS, 0xB8) for media
    cs3 (the MS 6 bits, 24, in ToS, 0x60) for signal
    af41 (the MS 6 bits, 34, in ToS, 0x88) for video
    default (the MS 6 bits, 0, in ToS, 0x0) for service
  Telnet Level: 0
  Tftp path is flash:
  Generate text file is disabled
  Tftp files are created, current syncinfo 0001140473454008
  OS79XX.TXT is not created
  timeout interdigit 10
  network-locale[0] US    (This is the default network locale for this box)
  network-locale[1] US 
  network-locale[2] US 
  network-locale[3] US 
  network-locale[4] US 
  user-locale[0] US    (This is the default user locale for this box)
  user-locale[1] US 
  user-locale[2] US 
  user-locale[3] US 
  user-locale[4] US   Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 
   
 
   
VOICE REGISTER DN
=================
Dn Tag 1
Config:
  Number is 45111
  Preference is 0
  Huntstop is disabled
  Auto answer is disabled
  Pool 1    has this DN configured for line 1
Dn Tag 2
Config:
  Number is 45112
  Preference is 0
  Huntstop is disabled
  Auto answer is disabled
  call-forward b2bua noan 999 timeout 8
  after-hour exempt
  Pool 2    has this DN configured for line 1
  Pool 7    has this DN configured for line 1
Dn Tag 3
Config:
  Number is 45113
  Preference is 0
  Huntstop is disabled
  Auto answer is disabled
  call-forward b2bua all 87687
  Pool 3    has this DN configured for line 1, 2
Dn Tag 4
Config:
  Auto answer is disabled
Dn Tag 7
Config:
  Number is 451110
  Preference is 0
  Huntstop is disabled
  Auto answer is disabled
  after-hour exempt
  Pool 1    has this DN configured for line 4
Dn Tag 8
Config:
  Auto answer is disabled
  call-forward b2bua all 678
  after-hour exempt
  Pool 1    has this DN configured for line 3
 
   
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
  Anonymous call block is disabled
  Dialplan Tag is 1
  softkey connected  Confrn
  Lpcor type none
  Pool 4 has this template configured
 
   
VOICE REGISTER DIALPLAN
=======================
Dialplan Tag 1
Config:
  Type is 7905-7912
  Template 1 has this dialplan configured
  Pool 4 has this dialplan configured
 
   
VOICE REGISTER POOL
===================
 Pool Tag 1
Config:
  Mac address is 001B.535C.D410
  Type is 7960
  Number list 1 : DN 1
  Number list 3 : DN 8
  Number list 4 : DN 7
  Proxy Ip address is 0.0.0.0
  DTMF Relay is disabled
  Call Waiting is enabled
  DnD is disabled
  Busy trigger per button value is 0
  call-forward phone all is 4566
  call-forward b2bua all 4555
  keep-conference is enabled
  Lpcor Type is none
 
   
  Transport type is udp
  service-control mechanism is not supported
  Privacy feature is not configured.
  Privacy button is disabled
  Reason for unregistered state: 
         No registration request since last reboot/unregister
 
   
 
   
Dialpeers created:
 
   
Statistics:
  Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 
   
 Pool Tag 2
Config:
  Mac address is 0015.C68E.6D13
  Type is 7960
  Number list 1 : DN 2
  Proxy Ip address is 0.0.0.0
  DTMF Relay is disabled
  Call Waiting is enabled
  DnD is disabled
  Busy trigger per button value is 0
  call-forward phone noan is 9886, timeout 98
  keep-conference is enabled
  username pool2 password lab
  Lpcor Type is none
 
   
  Transport type is udp
  service-control mechanism is not supported
  Privacy feature is not configured.
  Privacy button is disabled
  Reason for unregistered state: 
         No registration request since last reboot/unregister
 
   
 
   
Dialpeers created:
 
   
Statistics:
  Active registrations  : 0
          
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 
   
 Pool Tag 3
Config:
  Mac address is 0021.5553.8998
  Type is 7975
  Number list 1 : DN 3
  Number list 2 : DN 3
  Proxy Ip address is 0.0.0.0
  DTMF Relay is disabled
  Call Waiting is enabled
  DnD is enabled
  Busy trigger per button value is 0
  call-forward phone all is 45112
  call-forward b2bua all 45111
  after-hour exempt
  keep-conference is enabled
  kpml signal is enabled
  Lpcor Type is none
 
   
  Transport type is udp
  service-control mechanism is not supported
  Privacy feature is not configured.
  Privacy button is disabled
  Reason for unregistered state: 
         No registration request since last reboot/unregister
 
   
 
   
Dialpeers created:
 
   
Statistics:
  Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 
   
 Pool Tag 4
Config:
  Mac address is 8989.9867.8769
  Proxy Ip address is 0.0.0.0
  DTMF Relay is disabled
  Call Waiting is enabled
  DnD is disabled
  Busy trigger per button value is 0
  keep-conference is enabled
  template is 1
  Lpcor Type is none
 
   
  Transport type is udp
  service-control mechanism is not supported
  Privacy feature is not configured.
  Privacy button is disabled
  Reason for unregistered state: 
         No registration request since last reboot/unregister
 
   
 
   
Dialpeers created:
 
   
Statistics:
  Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 
   
 Pool Tag 7
Config:
  Mac address is 0018.BAC8.D2B1
  Number list 1 : DN 2
  Proxy Ip address is 0.0.0.0
  DTMF Relay is disabled
  Call Waiting is enabled
  DnD is disabled
  Busy trigger per button value is 0
  keep-conference is enabled
  Lpcor Type is none
 
   
  Transport type is udp
  service-control mechanism is not supported
  Privacy feature is not configured.
  Privacy button is disabled
  Reason for unregistered state: 
         No registration request since last reboot/unregister
 
   
 
   
Dialpeers created:
 
   
Statistics:
  Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 
   

The following is an example of a partial output of the show voice register all command, showing KEM data with the phone type information:

Router# show voice register all
Pool Tag 5
Config:
  Mac address is B4A4.E328.4698
  Type is 9971 addon 1 CKEM
  Number list 1 : DN 2
  Number list 2 : DN 3
  Proxy Ip address is 0.0.0.0
  DTMF Relay is disabled
  Call Waiting is enabled
  DnD is disabled
  Video is enabled
  Camera is enabled
  Busy trigger per button value is 0
  keep-conference is enabled
  registration expires timer max is 200 and min is 60
  kpml signal is enabled
  Lpcor Type is none

The following is a sample output of the show voice register all command, showing the three KEMs configured with phone type 9971:

Router# show voice register all
Pool Tag 4
Config:
  Mac address is B4A4.E328.4698
  Type is 9971 addon 1 CKEM 2 CKEM 3 CKEM
  Number list 1 : DN 4
  Number list 2 : DN 5
  Number list 3 : DN 9
 
   
 
   

Table 54 describes the significant fields shown in this output.

Table 54 show voice register all Field Descriptions 

Field
Description

Pool Tag

Shows the assigned tag number of the current voice register pool.

Config

Shows the voice register pool.

Network address and Mask

Shows network address and mask information when the id command is configured.

Number list, Pattern, and Preference

Shows the number command configuration.

Proxy IP address

Shows the proxy command configuration.

Default preference

Shows the default preference value of this pool.

Incoming called number

Shows the incoming called-number command configuration.

Translate outgoing called tag

Shows the translate-outgoing command configuration.

Class of Restriction List Tag

Shows the COR tag.

Incoming corlist name

Shows the cor command configuration.

Application

Shows the application command configuration for this pool.

Dialpeers created

Lists all the dial peers created and their contents. Dial-peer contents differ for each application and are not described here.

Statistics

Shows the registration statistics for this pool.

Active registrations

Shows the current active registrations.

Total Registration Statistics

Shows the total registration statistics for this pool.

Registration requests

Shows the incoming registration requests.

Registration success

Shows the successful registrations.

Registration failed

Shows the failed registrations.

unRegister requests

Shows the incoming unregister/registration expire requests.

unRegister success

Reports the number of successful unregisters.

unRegister failed

Reports the number of failed unregisters.


Related Commands

Command
Description

application (voice register pool)

Selects the session-level application for the dial peer associated with an individual Cisco Unified SIP IP phone in a Cisco Unified CME environment or for a group of phones in a Cisco Unified SIP SRST environment.

cor (voice register pool)

Configures a class of restriction on the VoIP dial peers associated with directory numbers.

id (voice register pool)

Explicitly identifies a locally available, individual Cisco Unified SIP IP phone or, when running Cisco Unified SIP SRST, a set of Cisco Unified SIP IP phones.

incoming called-number (dial peer)

Specifies a digit string that can be matched by an incoming call to associate the call with a dial peer.

number (voice register pool)

Indicates the E.164 phone numbers that the registrar permits to handle the Register message from a Cisco Unified SIP IP phone.

proxy (voice register pool)

Autogenerates additional VoIP dial peers to reach the main proxy whenever a Cisco Unified SIP IP phone registers with a Cisco Unified SIP SRST gateway.

show sip-ua status registrar

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

show voice register dial-peers

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

show voice register pool

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

translate-outgoing (voice register pool)

Allows an explicit setting of translation rules on the VoIP dial peer to modify a phone number dialed by any Cisco Unified IP phone user.


show voice register credential

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

show voice register credential

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XJ

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

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


Examples

The following is sample output from this command:

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

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

Table 55 show voice register credential Field Descriptions 

Field
Description

username

Username that is authorized.

password

Password that is authorized.

service

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

file index

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


Related Commands

Command
Description

authenticate (voice register global)

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

credential load

Reloads a credential file into Flash memory.

show voice register all

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


show voice register dial-peers

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

show voice register dial-peers [pool tag]

Syntax Description

pool tag

Number of entries in attempted registrations table. Size range from 0 to 50.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.2(15)ZJ

Cisco SIP SRST 3.0

This command was introduced.

12.3(4)T

Cisco SIP SRST 3.0

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

12.4(4)T

Cisco CME 3.4
Cisco SIP SRST 3.4

This command was added to Cisco CME.

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SIP SRST 8.1

This command was modified. Pool tag keyword- argument was added. Command output display was also modified to display dial-peers specific to a pool.


Usage Guidelines

Use this command to display the dial-peers associated with a pool. To display the dynamic dial-peers associated with a specific pool, use the pool keyword followed by the pool tag. When using the pool keyword, you must specify the pool tag.

Examples

Cisco Unified CME adn Cisco Unified SIP SRST

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

Router#show voice register dial-peers

Dial-peers for Pool 1

dial-peer voice 40001 voip

destination-pattern 45111

session target ipv4:8.3.3.111:5060

session protocol sipv2

 call-fwd-all 4555

 after-hours-exempt FALSE

dial-peer voice 40002 voip

destination-pattern 45113

session target ipv4:8.33.33.111:5060

session protocol sipv2

after-hours-exempt FALSE

Dial-peers for Pool 2

 dial-peer voice 40003 voip

destination-pattern 45112

session target ipv4:8.33.33.112:5060

session protocol sipv2

 call-fwd-noan-timeou 8

 call-fwd-noan 999

 after-hours-exempt TRUE

Cisco Unified CME and Cisco Unified SRST

The following is a sample output from this command displaying all statistical information related to pool 1:

Router# show voice register dial-peers pool 1

Dial-peers for Pool 1:

dial-peer voice 40004 voip

destination-pattern 1000

redirect ip2ip

session target ipv4:9.13.18.40:19633

session protocol sipv2

dtmf-relay rtp-nte sip-notify

digit collect kpml

codec g711ulaw bytes 160

after-hours-exempt FALSE

dial-peer voice 40001 voip

destination-pattern 2000

redirect ip2ip

session target ipv4:9.13.18.40:19634

session protocol sipv2

dtmf-relay rtp-nte sip-notify

digit collect kpml

codec g711ulaw bytes 160

after-hours-exempt FALSE

 
   

Related Commands

Command
Description

show sip-ua status registrar

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

show voice register all

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

show voice register pool

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


show voice register dialplan

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

show voice register dialplan {tag | all}

Syntax Description

tag

Number that identifies the SIP dialplan. Range: 1 to 24.

all

(Optional) Displays all the dialplans defined in a system.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XJ

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

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

15.1(2)T

Cisco Unified CME 8.1

This command was modified. All keyword was added. Pools and templates that have dialplan configured are also displayed in the output.


Usage Guidelines

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

In Cisco Unified CME 8.1 and later, show voice register dialplan command also displays the pools and templates that have the dialplan configured. The pools which have the diaplan configured by virtue of inclusion of a template is also displayed as part of the pool list display. If a dialplan is configured under both template and pool, the dialplan under the pool takes precedence and the pool is displayed.

When used with the all keyword, the show voice register diaplan command displays configuration information for all the dialplans defined in a system.

Examples

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

Router# show voice register dialplan 1
 
   

Dialplan Tag 1

Config:

Type is 7905-7912

Template 1 has this dialplan configured

Pool 4 has this dialplan configured

The following is a sample output from this command displaying information for all the dialplans configured in a system:

Router# show voice register dialplan all
Dialplan Tag 1

Config:

Type is 7905-7912

Pattern 1 is 9879, timeout is 0, user option is phone, button is default

Pattern 24 is 908, timeout is 0, user option is phone, button is default

Dialplan Tag 2

Config:

Type is 7940-7960-others

Pattern 3 is 9845, timeout is 0, user option is phone, button is default

  Pattern 20 is 9098, timeout is 0, user option is phone, button is default
 
   

 
   

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

Table 56 show voice register dialplan Field Descriptions 

Field
Description

Config

List of configuration options defined for this SIP dial plan.

Dialplan Tag

Tag number of the requested SIP dial plan.

Pattern

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

Type

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


Related Commands

Command
Description

dialplan

Assigns a dial plan to a SIP phone.

pattern (voice register dialplan)

Defines a dial pattern for a SIP dial plan.

show voice register all

Displays all Cisco Unified CME configurations and register information.

show voice register pool

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

type (voice register dialplan)

Defines a phone type for a SIP dial plan.

voice register dialplan

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

voice register pool

Enters voice register pool configuration mode for SIP phones.


show voice register dn

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

show voice register dn {tag | all}

Syntax Description

tag

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

all

(Optional) Displays configuration information associated with all voice register dns defined in a system.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4 and Cisco SIP SRST 3.4

This command was introduced.

15.1(2)T

Cisco CME 8.1 and Cisco SIP SRST 8.1

This command was modified.The display output now shows pools that have DNs configured under them. All keyword was added to show configuration information for all voice register dns defined in system.


Usage Guidelines

In Cisco Unified CME 8.1 and Cisco Unified SIP SRST 8.1, the show voice register dn command displays the pools that have the DNs configured under them. When used with all keyword, the show voice register dn command displays configuration information for all the DNs defined in a system.

Examples

Cisco Unified SIP CME

The following is a sample output from this command:

Router# show voice register dn 1

Dn Tag 1

Config:

Number is 11

Preference is 10

Huntstop is enabled

Translation-profile incoming saaa

Allow watch is enabled

Pool 1 has this DN configured for line 1

Cisco Unified SIP SRST

The following is a sample output from this command:

Router# show voice register dn 2

Dn Tag 1

Config:

Number is 11

Preference is 10

Huntstop is enabled

Translation-profile incoming saaa

Allow watch is enabled

Pool 1 has this DN configured for line 1

Cisco Unified SIP SRST

The following is a sample output from this command displaying information for all the dns:

Dn Tag 1
Config:
  Number is 11
  Preference is 10
  Huntstop is enabled
  Translation-profile incoming saaa
  Allow watch is enabled
  Pool 1    has this DN configured for line 1
 
   
Dn Tag 2
Config:
  Number is 12
  Preference is 1
  Huntstop is enabled
  Allow watch is enabled
  Pool 2    has this DN configured for line 1, 2

Cisco Unified SIP CME

The following is a sample output from this command displaying information for all the dns:

Router# show voice register dn all
 
   
Dn Tag 1
Config:
  Number is 45111
  Preference is 0
  Huntstop is disabled
  Auto answer is disabled
Dn Tag 2
Config:
  Number is 45112
  Preference is 0
  Huntstop is disabled
  Auto answer is disabled
  call-forward b2bua noan 999 timeout 8
  after-hour exempt
  Pool 2    has this DN configured for line 1
  Pool 7    has this DN configured for line 1
Dn Tag 3
Config:
  Number is 45113
  Preference is 0
  Huntstop is disabled
  Auto answer is disabled
  call-forward b2bua all 87687  
  Preference is 0
  Huntstop is disabled
  Auto answer is disabled
  call-forward b2bua all 87687
  Pool 1    has this DN configured for line 1
  Pool 3    has this DN configured for line 1, 2
Dn Tag 4
Config:
  Auto answer is disabled
Dn Tag 7
Config:
  Number is 451110
  Preference is 0
  Huntstop is disabled
  Auto answer is disabled
  after-hour exempt
  Pool 1    has this DN configured for line 4
Dn Tag 8
Config:
  Auto answer is disabled
  call-forward b2bua all 678
  after-hour exempt
  Pool 1    has this DN configured for line 3
 
   

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

Table 57 show voice register dn Field Descriptions 

Field
Description

Auto answer

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

Config

List of configuration options defined for this voice register dn.

Dn Tag

Tag number of the requested voice register dn.

Huntstop

Status of huntstop behavior defined with the huntstop command.

Number

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

Preference

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


Related Commands

Command
Description

show voice register pool

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

show voice register dn all

Displays information associated with all the dns configured in a system.

voice register dn

Enters voice register dn configuration mode to define an extension for a SIP phone line.


show voice register global

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

show voice register global

Syntax Description

This command has no arguments or keywords.

Command Default

Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)T

Cisco CME 3.4
Cisco SIP SRST 3.4

This command was introduced.

15.0(1)XA

Cisco SIP SRST 8.0

This command was modified to display the signaling transport protocol.

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SIP SRST 8.1

This command was modified to include global statistics in the output display.

15.2(2)T

Cisco Unified CME 9.0

This command was modified to include conference hardware in the output display.


Examples

Cisco Unified CME

The following is a sample output from the show voice register global command used in Cisco Unified CME:

Router# show voice register global
 
   
CONFIG [Version=8.1]
========================
  Version 8.1
  Mode is cme
  Max-pool is 10
  Max-dn is 10
  Outbound-proxy is enabled and will use global configured value
  Security Policy: DEVICE-DEFAULT
  Source-address is 8.3.3.5 port 5060
  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
  Privacy is enabled
  Privacy-on-hold is disabled
  Dst auto adjust is enabled
    start at Apr week 1 day Sun time 02:00
    stop  at Oct week 8 day Sun time 02:00
  Max redirect number is 5
  IP QoS DSCP:
    ef (the MS 6 bits, 46, in ToS, 0xB8) for media
    cs3 (the MS 6 bits, 24, in ToS, 0x60) for signal
    af41 (the MS 6 bits, 34, in ToS, 0x88) for video
    default (the MS 6 bits, 0, in ToS, 0x0) for service
  Telnet Level: 0
  Tftp path is flash:
  Generate text file is disabled
  Tftp files are created, current syncinfo 0001140473454008
  OS79XX.TXT is not created
  timeout interdigit 10
  network-locale[0] US    (This is the default network locale for this box)
  network-locale[1] US 
  network-locale[2] US 
  network-locale[3] US 
  network-locale[4] US 
  user-locale[0] US    (This is the default user locale for this box)
  user-locale[1] US 
  user-locale[2] US 
  user-locale[3] US 
  user-locale[4] US   Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 
   

The following is a sample output from the show voice register global command. The output shows that hardware conferencing is enabled.

Router# show voice register global
CONFIG [Version=8.7]
========================
  Version 8.7
  Mode is cme
  Max-pool is 50
  Max-dn is 100
  Outbound-proxy is enabled and will use global configured value
  Security Policy: DEVICE-DEFAULT
  Forced Authorization Code Refer is enabled
  Source-address is 1.5.40.20 port 5060
  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
  Video is enabled
  Camera is enabled
  Privacy is enabled
  Privacy-on-hold is disabled
  Conference hardware is enabled
  Dst auto adjust is enabled
start at Apr week 1 day Sun time 02:00
stop  at Oct week 8 day Sun time 02:00
 
   

Cisco Unified SIP SRST

The following is a sample output from the show voice register global command used in Cisco Unified SIP SRST:

Router# show voice register global
CONFIG [Version=8.1]
========================
  Version 8.1
  Mode is srst
  Max-pool is 10
  Max-dn is 10
  Outbound-proxy is enabled and will use global configured value
  Security Policy: DEVICE-DEFAULT
  timeout interdigit 10
  network-locale[0] US    (This is the default network locale for this box)
  network-locale[1] US 
  network-locale[2] US 
  network-locale[3] US 
  network-locale[4] US 
  user-locale[0] US    (This is the default user locale for this box)
  user-locale[1] US 
  user-locale[2] US 
  user-locale[3] US 
  user-locale[4] US   Active registrations  : 0
 
   
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 0
    Registration success   : 0
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : 
    Last unregister request time : 
    Register success time        : 
    Unregister success time      : 
 
   
 
   

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

Table 58 show voice register global Field Descriptions 

Field
Description

Conference hardware

Shows whether the Cisco Unified SIP IP phone will perform local mixing on its own or request Cisco Unified CME to perform hardware conferencing using its DSP resource.

Date-format

Value of date-format command.

DST auto adjust

Setting of dst auto-adjust command.

Forwarding local

Setting of forwarding local command.

Generate text file

Setting of text file command.

Hold-alert

Setting of hold-alert command.

Load

Value of load command.

Max-dn

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

Max-pool

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

Max redirect number

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

Mode

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

MWI registration

Setting of mwi command.

MWI stutter

Setting of mwi stutter command.

Time-format

Value of time-format command.

Time-zone

Number of the timezone selected with the timezone command.

TFTP path

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

Version

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


Related Commands

Command
Description

show sip-ua status registrar

Displays all the Cisco Unified SIP IP phones currently registered with the contact address.

show voice register all

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

show voice register dial-peers

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

voice register global

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


show voice register hfs

To display the HTTP File-Fetch Server (HFS) file bindings of firmware files accessible to Cisco Unified SIP IP phones, use the show voice register hfs command in privileged EXEC mode.

show voice register hfs

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Privileged EXEC

Command History

Release
Modification

15.2(1)T

This command was introduced.


Usage Guidelines

Use the show voice register hfs command with Cisco Unified CME 8.8 or a later version.

This command displays the bindings of firmware files that are accessible to Cisco Unified SIP IP phones using the HFS download service.

Examples

The following is a sample output from the show voice register hfs command:

Router(config)# show voice register hfs
 
   
Fetch Service Enabled = Y
   App enabled port = 6970
   Use default port = N
   Registered session-id = 19
 
Default home path = flash:/
   Ongoing fetches from home = 0
 
HTTP File Server Bindings
   No. of bindings = 11
   No. of url table entries = 9
   No. of alias table entries = 9
 
   

Related Commands

Command
Description

create profile (voice register global)

Generates the configuration profile files required for SIP phones.

hfs enable

Enables the HFS download service on an IP Phone in a Cisco Unified CME system.


show voice register pool

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

show voice register pool {pool-tag | all }[brief]

Syntax Description

pool-tag

Tag number of the voice register pool for which information is displayed. Range is 1 to 262.

Note The maximum number of pools is version and platform dependent.

all

Displays the information of all the voice register pools.

brief

(Optional) Displays brief information of all voice register pools.


Command Modes

Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

12.2(15)ZJ

Cisco SIP SRST

This command was introduced.

12.3(4)T

Cisco SIP SRST

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

12.4(4)T

Cisco CME 3.4
Cisco SIP SRST 3.4

This command was added to Cisco CME.

12.4(15)XY

Cisco Unified CME  4.2(1)
Cisco Unified SIP SRST 4.2(1)

This command was modified to include emergency response location information in the output display.

12.4(20)T

Cisco Unified CME  7.0
Cisco Unified SIP SRST 7.0

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

15.0(1)XA

Cisco Unified CME 8.0

This command was modified to include logical partitioning class of restriction (LPCOR) information in the output display.

15.1(1)T

Cisco Unified CME 8.0

This command was integrated into Cisco IOS Release 15.1(1)T.

15.1(2)T

Cisco Unified CME 8.1

This command was modified. The all and brief keywords were added. Voice-class stun-usage information is displayed in the output.

15.2(2)T

Cisco Unified CME 9.0

This command was modified to include conference admin, conference add mode, and conference drop mode in the output display.

15.2(4)M

Cisco Unified CME 9.1
Cisco Unified SIP SRST 9.1

This command was modified to include Key Expansion Module (KEM) data in the output display.


Examples

Cisco Unified CME

The following is a sample output of the show voice register pool command, displaying information for voice register pool 33 in Cisco Unified CME:

Router# show voice register pool 33
 
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
 Proxy Ip address is 0.0.0.0
 DTMF Relay is disabled
 Call Waiting is enabled
 DnD is disabled
 Busy trigger per button value is 0
 keep-conference is enabled
 template is 1
 Emergency response location 3
 Lpcor Type is local 
 Lpcor Incoming is sip_group
 Lpcor Outgoing is sip_group
 
 Transport type is udp 
 service-control mechanism is not supported 
 Privacy feature is not configured. 
 Privacy button is disabled 
 
Dialpeers created: 
 
Statistics: 
 Active registrations : 0 
 
 Total SIP phones registered: 0 
 Total Registration Statistics 
  Registration requests : 0 
  Registration success : 0 
  Registration failed : 0 
  unRegister requests : 0 
  unRegister success : 0 
  unRegister failed : 0 
 

The following is a sample output of the show voice register pool command. The output shows that a meet-me hardware conference administrator has been assigned, the conference creator or any of the participants can add a new participant, and the conference creator can terminate the active video hardware conference by hanging up.

Router# show voice register pool 15
 Pool Tag 15
Config:
  Mac address is 1C17.D340.81F0
  Type is 9951
  Number list 1 : DN 15
  Proxy Ip address is 0.0.0.0
  Current Phone load version is Cisco-CP9951/9.0.1
  DTMF Relay is enabled, sip-notify
  Call Waiting is enabled
  DnD is disabled
  Video is enabled
  Camera is enabled
  Busy trigger per button value is 0
  feature-button 5 DnD
  feature-button 6 MeetMe
  keep-conference is enabled
  registration expires timer max is 86400 and min is 60
  template is 1
  kpml signal is enabled
  Lpcor Type is none
 
   
  Transport type is udp
  service-control mechanism is supported
  registration Call ID is 1c17d340-81f00002-6c48fe8e-03013c10@1.5.40.105 
  Registration method: per line
  Privacy feature is not configured.
  Privacy button is disabled
  active primary line is: 3915
 
   
  contact IP address: 1.5.40.105 port 5060
 
   
  Phone SIS Version:  5.0.0
  GW SIS Version:  1.0.0
  conference admin: yes
  conference add mode: all
  conference drop mode: creator
  paging-dn: config 0 [multicast]  effective 0 [multicast]
...

The following is an example of a partial output of the show voice register pool all command, showing KEM data with the phone type information:

Router# show voice register pool all
Pool Tag 5
Config:
Mac address is B4A4.E328.4698
Type is 9971 addon 1 CKEM
Number list 1 : DN 2
Number list 2 : DN 3
Proxy Ip address is 0.0.0.0
DTMF Relay is disabled
Call Waiting is enabled
DnD is disabled
Video is enabled
Camera is enabled
Busy trigger per button value is 0
keep-conference is enabled
registration expires timer max is 200 and min is 60
kpml signal is enabled
Lpcor Type is none
 
   
 
   

The following is a sample output of the show voice register pool all command, showing the three KEMs configured with phone type 9971:

Router# show voice register pool all
Pool Tag 4
Config:
Mac address is B4A4.E328.4698
Type is 9971 addon 1 CKEM 2 CKEM 3 CKEM
Number list 1 : DN 4
Number list 2 : DN 5
Number list 3 : DN 9
 
   
 
   

Cisco Unified SIP SRST

The following is a sample output of the show voice register pool command, displaying all information for voice register pool 1 in Cisco Unified SIP SRST:

Router# show voice register pool 1
 
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
 
Emergency response location 6
 
   

Voice class stun usage

The following is a sample output of the show voice register pool command, displaying voice-class stun-usage information for voice register pool 51:

Router# show voice register pool 51
 
   
 Pool Tag 51
Config:
  Mac address is 0011.209F.5D60
  Type is 7960
  Number list 1 : DN 51
  Proxy Ip address is 0.0.0.0
  Current Phone load version is Cisco-SIPGateway/IOS-12.x
  DTMF Relay is disabled
  Call Waiting is enabled
  DnD is disabled
  Busy trigger per button value is 0
  keep-conference is enabled
  template is 10
  Lpcor Type is none
  
Transport type is udp
  service-control mechanism is not supported
  registration Call ID is 2BA38EE3-17D311DB-800BCD81-A9AD11F0
  Privacy feature is not configured.
  Privacy button is disabled
  active primary line is: 16263646
 
   
  contact IP address: 192.168.0.87 port 5060
 
   
  Reason for unregistered state:
         No registration request since last reboot/unregister
 
   
  voice-class stun-usage is enabled. tag is 1
 
   
Dialpeers created:
Dial-peers for Pool 51:
 
   
Statistics:
 
   
  Active registrations  : 0
  Total SIP phones registered: 0
  Total Registration Statistics
    Registration requests  : 2
    Registration success   : 2
    Registration failed    : 0
    unRegister requests    : 2
    unRegister success     : 2
    unRegister failed      : 0
    Attempts to register
           after last unregister : 0
    Last register request time   : 13:43:27.839 IST Tue Apr 20 2010
 
   

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

Table 59 show voice register pool Field Descriptions 

Field
Description

Active registrations

Shows the current active registrations.

Application

Shows the application command configuration for this pool.

Call Waiting

Shows the call-waiting command configuration.

Class of Restriction List Tag

Shows the COR tag.

Conference add mode

Shows the current setting of the hardware conference privilege for adding participants.

Conference admin

Shows whether the Cisco Unified SIP IP phone is assigned as the hardware conference administrator or not.

Conference drop mode

Shows who can terminate an active ad-hoc hardware conference by hanging up.

Config

Shows the voice register pool.

Default preference

Shows the default preference value of this pool.

Dialpeers created

Lists all the dial peers created and their contents. Dial-peer contents differ for each application and are not described here.

DnD

Shows the setting of the dnd-control command.

DTMF Relay

Shows the setting of the dtmf-relay command.

Emergency response location

Shows the ephone's emergency response location to which an emergency response team is dispatched when an emergency call is made.

Incoming called number

Shows the incoming called-number command configuration.

Incoming corlist name

Shows the cor command configuration.

keep-conference

Shows the status of the keep-conference command.

Lpcor Incoming

Shows the setting of the lpcor incoming command.

Lpcor Outgoing

Shows the setting of the lpcor outgoing command.

Lpcor Type

Shows the setting of the lpcor type command.

Mac address

Shows the MAC address of the Cisco Unified SIP IP phone as defined by the id command.

Network address and Mask

Shows network address and mask information when the id command is configured.

Number list, Pattern, and Preference

Shows the number command configuration.

Pool Tag

Shows the assigned tag number of the current pool.

Proxy IP address

Shows the proxy command configuration; that is, the IP address of the external SIP server.

Registration failed

Shows the failed registrations.

Registration requests

Shows the incoming registration requests.

Registration success

Shows the successful registrations.

Statistics

Shows the registration statistics for this pool.

Template

Shows the template-tag number for the template applied to the Cisco Unified SIP IP phone.

Total Registration Statistics

Shows the total registration statistics for this pool.

Translate outgoing called tag

Shows the translate-outgoing command configuration.

Type

Shows the phone type identified for the Cisco Unified SIP IP phone using the type command.

unRegister failed

Reports the number of failed unregisters.

unRegister requests

Shows the incoming unregister/registration expiry requests.

unRegister success

Reports the number of successful unregisters.

Username Password

Shows the values within the authentication credential.


Related Commands

Command
Description

application (voice register pool)

Selects the session-level application for the dial peer associated with an individual Cisco Unified SIP IP phone in a Cisco Unified CME environment or for a group of phones in a Cisco Unified SIP SRST environment.

call-waiting (voice register pool)

Enables the call-waiting option on a SIP phone.

cor (voice register pool)

Configures a class of restriction on the VoIP dial peers associated with directory numbers.

dnd-control (voice register template)

Enables the Do-Not-Disturb (DND) soft key on SIP phones.

dtmf-relay (voice register pool)

Specifies the list of dual-tone multifrequency (DTMF) relay methods that can be used to relay DTMF audio tones between SIP endpoints.

id (voice register pool)

Explicitly identifies a locally available, individual Cisco Unified SIP IP phone or, when running Cisco Unified SIP SRST, a set of Cisco Unified SIP IP phones.

incoming called-number (dial peer)

Specifies a digit string that can be matched by an incoming call to associate the call with a dial peer.

keep-conference (voice register pool)

Allows IP phone conference initiators to exit from conference calls and keep the remaining parties connected.

lpcor incoming

Associates an incoming call with a logical partitioning class of restriction (LPCOR) resource-group policy.

lpcor outgoing

Associates an outgoing call with an LPCOR resource-group policy.

lpcor type

Specifies the LPCOR type for an IP phone.

number (voice register pool)

Indicates the E.164 phone numbers that the registrar permits to handle the Register message from a Cisco Unified SIP IP phone.

proxy (voice register pool)

Autogenerates additional VoIP dial peers to reach the main proxy whenever a Cisco Unified SIP IP phone registers with a Cisco Unified SIP SRST gateway.

show sip-ua status registrar

Displays all the Cisco Unified SIP IP phones registered with the contact address.

show voice register all

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

show voice register dial-peer

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

translate-outgoing (voice register pool)

Allows an explicit setting of translation rules on the VoIP dial peer to modify a phone number dialed by any Cisco Unified IP phone user.

type (voice register pool)

Defines a phone type for a SIP phone.

voice register pool

Enters voice register pool configuration mode for Cisco Unified SIP IP phones.


show voice register pool after-hour-exempt

To display the details of a phone that has after-hour-exempt enabled on it, use the show voice register after-hour-exempt command in privileged EXEC mode.

show voice register after-hour-exempt

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of a phone that has after-hour-exempt enabled. Individual phones can be exempted from call blocking using the after-hour exempt.

Examples

Cisco Unified CME

The following is a sample output from this command displaying information for phones with after after-hour-exempt:

Router# show voice register pool after-hour-exempt
Pool ID              IP Address      Ln DN  Number               State
==== =============== =============== == === ==================== ============
1    001B.535C.D410  8.3.3.111       3  8                        UNREGISTERED
                                     4  7   451110               UNREGISTERED
2    0015.C68E.6D13                  1  2   45112                UNREGISTERED
3    0021.5553.8998                  1  3   45113                UNREGISTERED
                                     2  3   45113                UNREGISTERED
7    0018.BAC8.D2B1                  1  2   45112                UNREGISTERED
 
   

Cisco Unified SRST

The following is a sample output from this command displaying information for phones with after after-hour-exempt:

Router# show voice register pool after-hour-exempt
Pool ID              IP Address      Ln DN  Number               State
==== =============== =============== == === ==================== ============
1    9.13.18.40      9.13.18.40      1  1   1000                 REGISTERED  
                                     2  2   2000                 REGISTERED  
                                     3  3   3000                 REGISTERED  
                                     4  4   4000                 REGISTERED  
                                     5  5   5000                 UNREGISTERED
                                     6  6   6000                 UNREGISTERED
                                     7  7   7000                 UNREGISTERED
 
   
 
   

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

Table 60 show voice register pool after-hour exempt field descriptions 

Field
Description

DN

Directory number of the phone.

IP Address/port

IP address and port number of the phones.

LN

Line number of the phone.

Number

Number of the phones that have after-hour exempt enabled.

Pool

Shows the current pool.

State

Registration state.


Related Commands

Command
Description

after-hour exempt(voice register pool)

Specifies that an IP phone does not have any of its outgoing calls blocked although call blocking is defined.

show voice register all

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

show voice register pool

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

voice register pool

Enters voice register pool configuration mode for SIP phones.


show voice register pool attempted-registrations

To display the details of phones that attempt to register with Cisco Unified CME or Cisco Unified SRST and fail, use the show voice register pool attempted-registrations command in privileged EXEC mode.

show voice register pool attempted-registrations

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of the phones that attempt to register with Cisco Unified CME or Cisco Unified SRST and fail. If the phone registers successfully after some time, the attempted registration entry will still show up in the attempted-registration table. Use the clear voice register attempted-registrations command to remove the entry from the attempted registration table.

Examples

Cisco Unified CME and Cisco Unified SRST

The following is a sample output from this command displaying information for show voice register pool attempted-registrations:

Router# show voice register pool attempted-registrations

Phones that have attempted registrations and have failed:

MAC address: 001b.535c.d410

IP address : 8.3.3.111

Attempts : 5

 Time of first attempt : *10:49:51.542 UTC Wed Oct 14 2009

Time of latest attempt: *10:50:00.886 UTC Wed Oct 14 2009

Reason for failure :

No pool match for the registration request

MAC address: 0015.c68e.6d13

IP address : 8.33.33.112

Attempts : 4

Time of first attempt : *10:49:53.418 UTC Wed Oct 14 2009

Time of latest attempt: *10:50:00.434 UTC Wed Oct 14 2009

Reason for failure :

No pool match for the registration request

MAC address: 0009.43E9.0B35

IP address : 9.13.40.83

Attempts : 1

Time of first attempt : *10:49:57.866 UTC Wed Oct 14 2009

Time of latest attempt: *10:49:57.866 UTC Wed Oct 14 2009

Reason for failure :

No pool match for the registration request

The following is a sample output from this command displaying information for show voice register pool attempted-registrations when none of the phones fail:

Router# show voice register pool attempted-registrations

Phones that have attempted registrations and have failed: NONE

Related Commands

Command
Description

attempted-registrations size

Allows to set the size of the table that stores information related to SIP phones that attempt to register and fail.

clear voice register attempted-registrations

Clears entries from the attempted-registration table.


show voice register pool cfa

To display the voice register pool details of a phone that has Call Forward All (CFA) enabled, use the show voice register pool cfa command in privileged EXEC mode.

show voice register pool cfa

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(2)T

Cisco Unified CME 8.1

This command was introduced.


Usage Guidelines

Use this command to display the voice register pool details of the phone with CFA feature enabled. When Call Forward All feature is enabled on Cisco Unified SIP IP phones such as 7940, 7941, 7941GE, 7942, 7945, 7960, 7961, 7961GE, 7962, 7965, 7970, 7971, 7975 through the CFA phone button. The show voice register pool cfa command displays only the call forward all B2BUA details.

The show voice register pool cfa command also displays the line number and DN number if available under the pool configuration. If call-forward-all is configured under both pool and DN. the configuration under DN takes precedence.

Examples

Cisco Unified CME and Cisco Unified SRST

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

Router# show voice register pool cfa
 
   

Pool Ln DN Number Call Forward All Number

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

1 2 8 678

0 1 45111 4555

4 7 451110 4555

3 1 3 45113 87687

2 3 45113 87687

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

Table 61 show voice register pool ip field descriptions 

Field
Description

Call Forward All Number

Number to which the calls are forwarded

DN

Voice register DN tag of the line.

LN

Line number of the telephone number.

Pool

Tag ID of the pool.


Related Commands

Command
Description

call forward b2bua all

Enables call forward all.

show voice register all

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

show voice register pool

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

show voice register pool detail all

Displays the details of all the pools defined in the system.


show voice register pool connected

To display the details of SIP phones that are in connected state, use the show voice register pool connected command in privileged EXEC mode.

show voice register pool connected [brief]

Syntax Description

brief

(Optional) Displays brief details of SIP phones that are in connected state.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of the phone that are currently in connected state (in conversation). The output for show voice register pool connected command shows details of both calls originating from the SIP phones and calls made towards SIP phones. When used with brief keyword, the show voice register pool connected command displays a brief detail of phones in connected state.

Cisco Unified CME and Cisco Unified SRST

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

Router# show voice register pool connected

Outbound calls from SIP line phones:

Pool tag: 1

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

MAC Address : 001B.535C.D410

Contact IP : 8.3.3.111

Phone Number : 45111

Remote Number : 45112

Call 2

SIP Call ID : 001b535c-d4100010-79612b5a-336b0db5@8.3.3.111

State of the call : STATE_ACTIVE (7)

Substate of the call : SUBSTATE_NONE (0)

Calling Number : 45111

Called Number : 45112

Bit Flags : 0xC0401C 0x100 0x4

CC Call ID : 7

Source IP Address (Sig ): 8.3.3.5

Destn SIP Req Addr:Port : [8.3.3.111]:5060

Destn SIP Resp Addr:Port: [8.3.3.111]:50076

Destination Name : 8.3.3.111

Number of Media Streams : 1

Number of Active Streams: 1

RTP Fork Object : 0x0

Media Mode : flow-through

Media Stream 1

State of the stream : STREAM_ACTIVE

Stream Call ID : 7

Stream Type : voice-only (0)

Stream Media Addr Type : 1

Negotiated Codec : g729r8 (20 bytes)

Codec Payload Type : 18

Negotiated Dtmf-relay : inband-voice

Dtmf-relay Payload Type : 0

QoS ID : -1

Local QoS Strength : BestEffort

Negotiated QoS Strength : BestEffort

Negotiated QoS Direction : None

Local QoS Status : None

Media Source IP Addr:Port: [8.3.3.5]:17580

Media Dest IP Addr:Port : [8.3.3.111]:26298

Options-Ping ENABLED:NO ACTIVE:NO

Inbound calls to SIP line phones:

Pool tag: 2

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

MAC Address : 0015.C68E.6D13

Contact IP : 8.33.33.112

Phone Number : 45112

Remote Number : 45111

Call 3

SIP Call ID : 4DA52F97-ADA311DE-8019803A-FF3E4CBC@8.3.3.5

State of the call : STATE_ACTIVE (7)

Substate of the call : SUBSTATE_NONE (0)

Calling Number : 45111

Called Number : 45112

Bit Flags : 0xC04018 0x100 0x80

CC Call ID : 8

Source IP Address (Sig ): 8.3.3.5

Destn SIP Req Addr:Port : [8.33.33.112]:5060

Destn SIP Resp Addr:Port: [8.33.33.112]:5060

Destination Name : 8.33.33.112

Number of Media Streams : 1

Number of Active Streams: 1

RTP Fork Object : 0x0

Media Mode : flow-through

Media Stream 1

State of the stream : STREAM_ACTIVE

Stream Call ID : 8

Stream Type : voice-only (0)

Stream Media Addr Type : 1

Negotiated Codec : g729r8 (20 bytes)

Codec Payload Type : 18

Negotiated Dtmf-relay : inband-voice

Dtmf-relay Payload Type : 0

QoS ID : -1

Local QoS Strength : BestEffort

Negotiated QoS Strength : BestEffort

Negotiated QoS Direction : None

Local QoS Status : None

Media Source IP Addr:Port: [8.3.3.5]:16384

Media Dest IP Addr:Port : [8.33.33.112]:30040

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

Router# show voice register pool connected brief

Pool IP Address Number Remote Number

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

1 8.3.3.111 45111 45112

Inbound calls to SIP line phones:

Pool IP Address Number Remote Number

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

2 8.33.33.112 45112 45111

Related Commands

Command
Description

show sip-ua calls

Displays active user agent client (UAC) and user agent server (UAS) information on SIP calls

show voice register all

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

show voice register pool

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


show voice register pool ip

To display the details of a SIP phone with a specific IP address, use the show voice register pool ip command in privileged EXEC mode.

show voice register pool ip ip-address

Syntax Description

ip-address

IPv4 address of the SIP phone .


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of a phone with a specific IP-address. When the pool ID is configured as a mac address or an IP address the registered pools contain the IP address information. The pool information is displayed if the IP addresses match.

When the pool ID is IP and the pool is unregistered, IP address configured under pool is compared with the input IP. When the pool ID is network contact, the IP address of each phone that is registered is compared with the input IP address.

Examples

Cisco Unified CME and Cisco Unified SRST

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

Router# show voice register pool ip 8.3.3.111

Pool ID IP Address Ln DN Number State

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

1 001B.535C.D410 8.3.3.111 1 1 45111 REGISTERED

4 7 451110 UNREGISTERED

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

Table 62 show voice register pool ip field descriptions 

Field
Description

DN

Voice register DN tag of the line.

ID

Phone identification (ID) address.

IP Address

IP address of the SIP phone.

LN

Line number of the telephone number.

Number

Number of the phones that have a mac address.

Pool

Tag ID of the pool.

State

Registration state of the line.


Related Commands

Command
Description

show voice register all

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

show voice register pool

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


show voice register pool mac

To display the details of voice register pool associated with a specific phone type, use the show voice register pool mac command in privileged EXEC mode.

show voice register pool mac H.H.H

Syntax Description

H.H.H

MAC address of the SIP phone attempting to register.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of the phone with the mac address H.H.H. The command displays only the pools that are configured with an ID as mac.

Examples

Cisco Unified CME and Cisco Unified SRST

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

Router# show voice register pool mac 001B.535C.D410

Pool ID IP Address Ln DN Number State

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

1 001B.535C.D410 8.3.3.111 1 1 45111 REGISTERED

4 7 451110 UNREGISTERED

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

Table 63 show voice register pool mac field descriptions 

Field
Description

DN

Voice register DN tag of the line.

ID

Phone identification (ID) address.

IP Address

IP address of the SIP phone.

LN

Line number of the telephone number.

Number

Number of the phones that have a mac address.

Pool

Tag ID of the pool.

State

Registration state of the line.


Related Commands

Command
Description

show voice register all

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

show voice register pool

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


show voice register pool on-hold

To display the details of phones that are currently on-hold, use the show voice register pool oh-hold command in privileged EXEC mode.

show voice register pool on-hold [brief]

Syntax Description

brief

(Optional) Displays brief details of SIP phones that are currently on-hold.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of the phone that are currently on-hold. The show voice register pool on-hold command output also displays a field to show if the hold was a locally initiated hold (initiated on the phone) or if the hold was initiated on the remote end. When used with brief keyword, the show voice register pool on-hold command displays a brief information of the phones that are currently put on hold by the remote caller or have put the remote caller on hold. The "Hold-Origin" field specifies the type of the hold, which can be either remote or local. Local indicates that the call is placed on hold by the local phone and remote indicates that call is placed on hold by the remote phone. In case of double-hold, the hold origin will display the value "Local and Remote".

Examples

Cisco Unified CME and Cisco Unified SRST

The following is a sample output from this command displaying information for phones ringing in a voice register pool:

Router# show voice register pool on-hold brief

Outbound calls from SIP line phones:

Pool IP Address Number Remote Number Hold Origin

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

1 8.3.3.111 45111 45112 Remote & Local

Inbound calls to SIP line phones:

Pool IP Address Number Remote Number Hold Origin

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

2 8.33.33.112 45112 45111 Remote & Local

 
   

Cisco Unified CME and Cisco Unified SRST

The following is a sample output from this command displaying information for phones on-hold:

Router# show voice register pool on-hold

Outbound calls from SIP line phones:

Pool tag: 1

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

MAC Address : 001B.535C.D410

Contact IP : 8.3.3.111

Phone Number : 45111

Remote Number : 45112

Local Hold : CALL HOLD Pressed on SIP Phone

Call 4

SIP Call ID : 001b535c-d4100010-79612b5a-336b0db5@8.3.3.111

State of the call : STATE_ACTIVE (7)

Substate of the call : SUBSTATE_NONE (0)

Calling Number : 45111

Called Number : 45112

Bit Flags : 0xC0401C 0x10100 0x4

CC Call ID : 7

Source IP Address (Sig ): 8.3.3.5

Destn SIP Req Addr:Port : [8.3.3.111]:5060

Destn SIP Resp Addr:Port: [8.3.3.111]:50076

Destination Name : 8.3.3.111

Number of Media Streams : 1

Number of Active Streams: 1

RTP Fork Object : 0x0

Media Mode : flow-through

Media Stream 1

State of the stream : STREAM_ACTIVE

Stream Call ID : 7

Stream Type : voice-only (0)

Stream Media Addr Type : 1

Negotiated Codec : g729r8 (20 bytes)

Codec Payload Type : 18

Negotiated Dtmf-relay : inband-voice

Dtmf-relay Payload Type : 0

QoS ID : -1

Local QoS Strength : BestEffort

Negotiated QoS Strength : BestEffort

Negotiated QoS Direction : None

Local QoS Status : None

Media Source IP Addr:Port: [8.3.3.5]:17580

Media Dest IP Addr:Port : [8.3.3.111]:26298

Options-Ping ENABLED:NO ACTIVE:NO

Inbound calls to SIP line phones:

Pool tag: 2

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

MAC Address : 0015.C68E.6D13

Contact IP : 8.33.33.112

Phone Number : 45112

Remote Number : 45111

Remote Hold : SIP Phone has received CALL HOLD

Call 5

SIP Call ID : 4DA52F97-ADA311DE-8019803A-FF3E4CBC@8.3.3.5

State of the call : STATE_ACTIVE (7)

Substate of the call : SUBSTATE_NONE (0)

Calling Number : 45111

Called Number : 45112

Bit Flags : 0xC04018 0x4100 0x80

CC Call ID : 8

Source IP Address (Sig ): 8.3.3.5

Destn SIP Req Addr:Port : [8.33.33.112]:5060

Destn SIP Resp Addr:Port: [8.33.33.112]:5060

Destination Name : 8.33.33.112

Number of Media Streams : 1

Number of Active Streams: 1

RTP Fork Object : 0x0

Media Mode : flow-through

Media Stream 1

State of the stream : STREAM_ACTIVE

Stream Call ID : 8

Stream Type : voice-only (0)

Stream Media Addr Type : 1

Negotiated Codec : g729r8 (20 bytes)

Codec Payload Type : 18

Negotiated Dtmf-relay : inband-voice

Dtmf-relay Payload Type : 0

QoS ID : -1

Local QoS Strength : BestEffort

Negotiated QoS Strength : BestEffort

Negotiated QoS Direction : None

Local QoS Status : None

Media Source IP Addr:Port: [8.3.3.5]:16384

Media Dest IP Addr:Port : [8.33.33.112]:30040

Options-Ping ENABLED:NO ACTIVE:NO

Related Commands

Command
Description

show voice register all

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

show sip-ua calls

Displays active user agent client (UAC) and user agent server (UAS) information on SIP calls

show voice register pool

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


show voice register pool phone-load

To display the details of phone-loads associated with phones that are registered to Cisco Unified CME, use the show voice register pool phone-load command in privileged EXEC mode.

show voice register pool phone-load

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

15.1(2)T

Cisco Unified CME 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of the phone-loads associated with phones that are registered with Cisco Unified CME. The phone-load information is taken from the REGISTER message sent by the phone.

Examples

The following is a sample output from this command displaying information for voice register pool phone-load:

Router# show voice register pool phone-load

Pool Device Name Current Version Previous Version

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

1 SEP001B535CD410 Cisco-CP7960G/8.0

Related Commands

Command
Description

load(voice register global)

Associates a type of Cisco Unified IP phone with a phone firmware file.

show voice register all

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

show voice register pool

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

voice register pool

Enters voice register pool configuration mode for SIP phones.


show voice register pool registered

To display the details of phones that successfully register to Cisco Unified Communications Manager Express (Cisco Unified CME), use the show voice register pool registered command in privileged EXEC mode.

show voice register pool registered

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Cisco IOS Release
Version
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.

15.2(4)M

Cisco Unified CME 9.1
Cisco Unified SIP SRST 9.1

This command was modified to display Key Expansion Module (KEM) details with the phone type information.


Usage Guidelines

Use the show voice register pool registered command to display the details of phones that are successfully registered to Cisco Unified CME and Cisco Unified Survivable Remote Site Telephony (Cisco Unified SRST).

Examples

Cisco Unified CME

The following is a sample output displaying information for a registered voice register pool in Cisco Unified CME:

Router# show voice register pool registered
Pool Tag 1
Config:
  Mac address is 001B.535C.D410
  Type is 7960
  Number list 1 : DN 1
  Number list 3 : DN 8
  Number list 4 : DN 7
  Proxy Ip address is 0.0.0.0
  Current Phone load version is Cisco-CP7960G/8.0
  DTMF Relay is disabled
  Call Waiting is enabled
  DnD is disabled
  Busy trigger per button value is 0
  call-forward phone all is 4566
  call-forward b2bua all 4555
  keep-conference is enabled
  Lpcor Type is none
  Transport type is udp
  service-control mechanism is supported
  registration Call ID is 001b535c-d410790d-17a6877e-5d04bbc5@8.3.3.111 
  Privacy feature is not configured.
  Privacy button is disabled
  active primary line is: 45111
 
   
  contact IP address: 8.3.3.111 port 5060
Dialpeers created:
Dial-peers for Pool 1:
dial-peer voice 40001 voip
 destination-pattern 45111
 session target ipv4:8.3.3.111:5060
 session protocol sipv2
  call-fwd-all         4555           
  after-hours-exempt   FALSE          
 
   
Statistics:
  Active registrations  : 1
 
   
  Total SIP phones registered: 1
  Total Registration Statistics
    Registration requests  : 1
    Registration success   : 1
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : *11:40:32.263 UTC Wed Oct 14 2009 
    Last unregister request time : 
    Register success time        : *11:40:32.267 UTC Wed Oct 14 2009 
    Unregister success time      : 
 
   
 
   

The following is a sample output displaying information for a registered voice register pool with a Cisco Unified 9971 Session Initiation Protocol (SIP) IP phone attached to a Cisco SIP IP Phone CKEM 36-Button Line Expansion Module:

 
   
Router# show voice register pool registered
Pool Tag 5
Config:
Mac address is B4A4.E328.4698
Type is 9971 addon 1 CKEM
Number list 1 : DN 2
Number list 2 : DN 3
Proxy Ip address is 0.0.0.0
DTMF Relay is disabled
Call Waiting is enabled
DnD is disabled
Video is enabled
Camera is enabled
Busy trigger per button value is 0
keep-conference is enabled
registration expires timer max is 200 and min is 60
kpml signal is enabled
Lpcor Type is none
 
   

Cisco Unified SRST

The following is a sample output displaying information for a registered voice register pool in Cisco Unified SRST:

 
   
Router# show voice register pool registered
 Pool Tag 1
Config:
  Ip address is 9.13.18.40, Mask is 255.255.0.0
  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
  Number list 7 : DN 7
  Proxy Ip address is 0.0.0.0
  DTMF Relay is enabled, rtp-nte, sip-notify
  kpml signal is enabled
  Lpcor Type is none
 
   
 
   
Dialpeers created:
 
   
Dial-peers for Pool 1:
 
   
dial-peer voice 40004 voip
 destination-pattern 1000
 redirect ip2ip
 session target ipv4:9.13.18.40:19633
 session protocol sipv2
 dtmf-relay rtp-nte sip-notify
 digit collect kpml
 codec  g711ulaw bytes 160
  after-hours-exempt   FALSE          
 
   
dial-peer voice 40001 voip
 destination-pattern 2000
 redirect ip2ip
 session target ipv4:9.13.18.40:19634
 session protocol sipv2
 dtmf-relay rtp-nte sip-notify
 digit collect kpml
 codec  g711ulaw bytes 160
  after-hours-exempt   FALSE          
 
   
dial-peer voice 40002 voip
 destination-pattern 3000
 redirect ip2ip
 session target ipv4:9.13.18.40:19635
 session protocol sipv2
 dtmf-relay rtp-nte sip-notify
 digit collect kpml
 codec  g711ulaw bytes 160
  after-hours-exempt   FALSE          
 
   
dial-peer voice 40003 voip
 destination-pattern 4000
 redirect ip2ip
 session target ipv4:9.13.18.40:19636
 session protocol sipv2
 dtmf-relay rtp-nte sip-notify
 digit collect kpml
 codec  g711ulaw bytes 160
  after-hours-exempt   FALSE          
 
   
Statistics:
  Active registrations  : 4
 
   
  Total SIP phones registered: 1
  Total Registration Statistics
    Registration requests  : 4
    Registration success   : 4
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : .05:22:55.604 UTC Tue Oct 6 2009 
    Last unregister request time : 
    Register success time        : .05:22:55.604 UTC Tue Oct 6 2009 
    Unregister success time      : 
 
   

Table 64 contains descriptions of significant fields shown in the show voice register pool registered command output, listed in alphabetical order.

Table 64 show voice register pool registered Field Descriptions 

Field
Description

Active registrations

Shows the current active registrations.

Application

Shows the application command configuration for this pool.

Call Waiting

Shows the setting of the call-waiting command.

Class of Restriction List Tag

Shows the COR tag.

Config

Shows the voice register pool.

Current phone-load

Shows the current version of the phone load.

Default preference

Shows the default preference value of this pool.

Dialpeers created

Results in a list of all dial peers created and their contents. Dial-peer contents differ for each application and are not described here.

DnD

Shows the setting of the dnd-control command.

DTMF Relay

Shows the setting of the dtmf-relay command.

Emergency response location

Shows the ephone's emergency response location to which an emergency response team is dispatched when an emergency call is made.

Incoming called number

Shows the incoming called-number command configuration.

Incoming corlist name

Shows the cor command configuration.

keep-conference

Shows the status of the keep-conference command.

Lpcor Incoming

Shows the setting of the lpcor incoming command.

Lpcor Outgoing

Shows the setting of the lpcor outgoing command.

Lpcor Type

Shows the setting of the lpcor type command.

Mac address

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

Network address and Mask

Shows network address and mask information when the id command is configured.

Number list, Pattern, and Preference

Shows the number command configuration.

Pool Tag

Shows the assigned tag number of the current pool.

Previous phone-load

Shows the version of the previous phone load.

Proxy IP address

Shows the proxy command configuration; that is, the IP address of the external SIP server.

Registration failed

Shows the failed registrations.

Registration requests

Shows the incoming registration requests.

Registration success

Shows the successful registrations.

Statistics

Shows the registration statistics for this pool.

statistics time-stamps

Shows the registration statistics for this pool with specific time stamps.

Template

Shows the template-tag number for the template applied to this SIP phone.

Total Registration Statistics

Shows the total registration statistics for this pool.

Translate outgoing called tag

Shows the translate-outgoing command configuration.

Type

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

unRegister failed

Reports the number of failed unregisters.

unRegister requests

Shows the incoming unregister/registration expiry requests.

unRegister success

Reports the number of successful unregisters.

Username Password

Shows the values within the authentication credential.


Related Commands

Command
Description

application (voice register pool)

Selects the session-level application for the dial peer associated with an individual Cisco Unified SIP IP phone in a Cisco Unified CME environment or for a group of phones in a Cisco Unified SIP SRST environment.

call-waiting (voice register pool)

Enables the call-waiting option on a SIP phone.

cor (voice register pool)

Configures a class of restriction on the VoIP dial peers associated with directory numbers.

dnd-control (voice register template)

Enables the Do-Not-Disturb (DND) soft key on SIP phones.

dtmf-relay (voice register pool)

Specifies the list of dual-tone multifrequency (DTMF) relay methods that can be used to relay DTMF audio tones between SIP endpoints.

id (voice register pool)

Explicitly identifies a locally available, individual Cisco Unified SIP IP phone or, when running Cisco Unified SIP SRST, a set of Cisco Unified SIP IP phones.

incoming called-number (dial peer)

Specifies a digit string that can be matched by an incoming call to associate the call with a dial peer.

keep-conference (voice register pool)

Allows IP phone conference initiators to exit from conference calls and keep the remaining parties connected.

lpcor incoming

Associates an incoming call with a logical partitioning class of restriction (LPCOR) resource-group policy.

lpcor outgoing

Associates an outgoing call with an LPCOR resource-group policy.

lpcor type

Specifies the LPCOR type for an IP phone.

number (voice register pool)

Indicates the E.164 phone numbers that the registrar permits to handle the Register message from a Cisco Unified SIP IP phone.

proxy (voice register pool)

Autogenerates additional VoIP dial peers to reach the main proxy whenever a Cisco Unified SIP IP phone registers with a Cisco Unified SIP SRST gateway.

show voice register all

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

show voice register dial-peers

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

show voice register pool

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

show voice register pool unregistered

Displays the details of voice register pools that do not have any phones registered.

translate-outgoing (voice register pool)

Allows an explicit setting of translation rules on the VoIP dial peer to modify a phone number dialed by any Cisco Unified IP phone user.

type (voice register pool)

Defines a phone type for a SIP phone.

voice register pool

Enters voice register pool configuration mode for SIP phones.


show voice register pool remote

To display the details of phones that are at a remote location, use the show voice register pool remote command in privileged EXEC mode.

show voice register pool remote

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified  SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of the phones that are at remote location and do not have an address resolution protocol (ARP) entry.If the pool id is MAC or IP, the entire pool detail is displayed in a brief format. If the pool id is network, only the line details with remote contact IP address are displayed. In Cisco Unified  SRST, if the pool id is IP and if the pool is not registered, the configured IP is checked to see if it is a remote IP.

Examples

Cisco Unified CME

The following is a sample output from this command displaying information for remote phones:

Router# show voice register pool remote

Pool ID IP Address Ln DN Number State

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

1 001B.535C.D410 8.3.3.111 1 1 45111 REGISTERED

3 8 UNREGISTERED

4 7 451110 UNREGISTERED

2 8.3.3.112 1 2 45112 REGISTERED

3 8.3.0.0 1 3 45113 REGISTERED

Cisco Unified SRST

The following is a sample output from this command displaying information for remote phones:

Router# show voice register pool remote

Pool ID IP Address Ln DN Number State

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

1 001B.535C.D410 8.33.33.111 1 1 45111 REGISTERED

3 8 UNREGISTERED

4 7 451110 UNREGISTERED

2 8.33.33.112 8.33.33.112 1 2 45112 REGISTERED

3 8.3.0.0 8.3.44.116 1 3 45113 REGISTERED

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

Table 65 show voice register pool telephone number field descriptions 

Field
Description

DN

Directory number of the phone.

ID

Phone identification (ID) address.

IP Address

IP address and port number of the phones

LN

Line number of the phone.

Number

Number of the phones.

Pool

Shows the current pool.

State

Registration state.


Related Commands

Command
Description

show voice register all

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

show voice register dial-peer

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

show voice register pool

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

voice register pool

Enters voice register pool configuration mode for SIP phones.


show voice register pool ringing

To display the details of phones that are currently in ringing state, use the show voice register pool ringing command in privileged EXEC mode.

show voice register pool ringing [brief]

Syntax Description

brief

(Optional) Displays brief details of SIP phones that are currently in ringing state.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of the phone that are currently in ringing state. When used with the brief keyword, the show voice register pool ringing brief command only displays information related to calls that are bound towards the SIP phones.

Examples

Cisco Unified CME and Cisco Unified SRST

The following is a sample output from this command displaying information for phones ringing in a voice register pool:

Router# show voice register pool ringing brief
 
   

Pool IP Address Number Remote Number

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

2 8.33.33.112 45112 45111

 
   

Cisco Unified CME and Cisco Unified SRST

The following is a sample output from this command displaying information for phones ringing in a voice register pool:

Router# show voice register pool ringing

Pool tag: 2

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

MAC Address : 0015.C68E.6D13

Contact IP : 8.33.33.112

Phone Number : 45112

Remote Number : 45111

Call 1

SIP Call ID : C0B5DA7-ADA311DE-8011803A-FF3E4CBC@8.3.3.5

State of the call : STATE_RECD_PROCEEDING (4)

Substate of the call : SUBSTATE_PROCEEDING_PROCEEDING (2)

Calling Number : 45111

Called Number : 45112

Bit Flags : 0xC00018 0x100 0x280

CC Call ID : 5

Source IP Address (Sig ): 8.3.3.5

Destn SIP Req Addr:Port : [8.33.33.112]:5060

Destn SIP Resp Addr:Port: [8.33.33.112]:5060

Destination Name : 8.33.33.112

Number of Media Streams : 1

Number of Active Streams: 1

RTP Fork Object : 0x0

Media Mode : flow-through

Media Stream 1

State of the stream : STREAM_ACTIVE

Stream Call ID : 5

Stream Type : voice+dtmf (1)

Stream Media Addr Type : 1

Negotiated Codec : No Codec (0 bytes)

Codec Payload Type : 255 (None)

Negotiated Dtmf-relay : inband-voice

Dtmf-relay Payload Type : 0

QoS ID : -1

Local QoS Strength : BestEffort

Negotiated QoS Strength : BestEffort

Negotiated QoS Direction : None

Local QoS Status : None

Media Source IP Addr:Port: [8.3.3.5]:16882

Related Commands

Command
Description

show sip-ua calls

Displays active user agent client (UAC) and user agent server (UAS) information on SIP calls

show voice register all

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

show voice register pool

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


show voice register pool telephone-number

To display the details of a phone line with a specific telephone-number, use the show voice register pool telephone-number command in privileged EXEC mode.

show voice register pool telephone-number number

Syntax Description

number

Number identifying a specific phone.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of the phone line with the specified telephone-number. If the line is registered, the contact ip address will be displayed. When the phone line is not registered and the pool ID type is network IP, the IP address is not displayed. When the phone line is not registered but some other line is registered for the same pool with MAC or IP address, then the IP address is displayed.

Examples

Cisco Unified CME

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

Router# show voice register pool telephone number 45112

Pool ID IP Address Ln DN Number State

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

2 0015.C68E.6D13 1 2 45112 UNREGISTERED

7 0018.BAC8.D2B1 1 2 45112 UNREGISTERED

Cisco Unified SRST

Router# show voice register pool telephone-number 1000

Pool ID IP Address Ln DN Number State

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

1 9.13.18.40 9.13.18.40 1 1 1000 REGISTERED

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

Table 66 show voice register pool telephone number field descriptions 

Field
Description

DN

Directory number of the phone.

ID

Phone identification (ID) address.

IP Address

IP address and port number of the phones

LN

Line number of the phone.

Number

Number of the phones.

Pool

Shows the current pool.

State

Registration state.


Related Commands

Command
Description

show voice register all

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

show voice register pool

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

show voice register pool detail all

Displays the details of all the pools defined in the system.


show voice register pool type

To display the details of voice register pools associated with a specific phone type, use the show voice register pool type command in privileged EXEC mode.

show voice register pool type type

Syntax Description

type

3911, 3951, 7905, 7906, 7911, 7912, 7940, 7941, 7941GE, 7942, 7945, 7960, 7961, 7961GE, 7962, 7965, 7970, 7971, 7975, ATA (Cisco SIP Phone ATA), CKEM (Cisco SIP Key Expansion Module), P100 (PingTel Xpressa 100), P600 (Polycom SoundPoint 600).


Command Modes

Privileged EXEC (#)

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(2)T

Cisco Unified CME 8.1

This command was introduced.

15.2(4)M

Cisco Unified CME 9.1

This command was modified to add CKEM as a value for the type argument to display the details of voice register pools associated with all the phones configured with KEMs.


Usage Guidelines

Use the show voice register pool type command to display the details of voice register pools associated with a specific phone type.

The show voice register pool type command only takes the configured value of the phone type into consideration.

The CKEM value is available for Cisco Unified CME only and is not available for Cisco Unified SRST.

Examples

The following is a sample output of the show voice register pool type command for a Cisco Unified 7960 SIP IP phone, displaying all statistical information:

Router# show voice register pool type 7960
 
   
Pool ID              IP Address      Ln DN  Number               State
==== =============== =============== == === ==================== ============
1    001B.535C.D410  8.3.3.111       1  1   45111                REGISTERED  
                                     4  7   451110               UNREGISTERED
2    0015.C68E.6D13                  1  2   45112                UNREGISTERED
 
   

The following is a sample output of the show voice register pool type command, showing all the phones configured with KEMs:

Router# show voice register pool type CKEM
Pool ID              IP Address      Ln DN  Number               State
==== =============== =============== == === ==================== ============
4    B4A4.E328.4698  9.45.31.111     1  4   5589$                REGISTERED
 
   
 
   

Related Commands

Command
Description

show voice register all

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

show voice register pool

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


show voice register pool unregistered

To display the details of the voice registration pools that do not have any phones registered, use the show voice register pool unregistered command in privileged EXEC mode.

show voice register pool unregistered

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

15.1(2)T

Cisco Unified CME 8.1
Cisco Unified SRST 8.1

This command was introduced.


Usage Guidelines

Use this command to display the details of the pools that do not have any active registrations. In Cisco Unified SRST, if multiple phones are trying to register through the same pool and if one phone successfully registers and the others do not, the pool is not considered as an unregistered pool, as it does have an active registration of the registered phone.

Examples

Cisco Unified CME and Cisco Unified SRST

The following is a sample output from this command displaying information for pools with no active registeration:

Router# show voice register pool unregistered

Pool Tag: 2

MAC Address : 0015.C68E.6D13

No. of attempts to register: 0

Unregister time :

Last register request time :

Reason for state unregister:

No registration request since last reboot/unregister

Pool Tag: 3

MAC Address : 0021.5553.8998

No. of attempts to register: 0

Unregister time :

Last register request time :

Reason for state unregister:

No registration request since last reboot/unregister

Pool Tag: 4

MAC Address : 8989.9867.8769

No. of attempts to register: 0

Unregister time :

Last register request time :

Reason for state unregister:

No registration request since last reboot/unregister

Related Commands

Command
Description

show voice register all

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

show voice register pool

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

show voice register pool registered

Displays details of phones that sucessfully register to Cisco Unified CME or Cisco Unified SRST.

voice register pool

Enters voice register pool configuration mode for SIP phones.


show voice register profile

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

show voice register profile text tag

Syntax Description

tag

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


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4

This command was introduced.


Usage Guidelines

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

Examples

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

Router# show voice register profile text 4
 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 67 contains descriptions of significant fields shown in this output, listed in alphabetical order.

Table 67 show voice register profile Field Descriptions 

Field
Description

Attended Transfer

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

Auto Lookup

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

Blind Transfer

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

Call Waiting

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

Call Forward Number

Number to which incoming calls are forwarded

Conference

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

Directories URL

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

NTPIP

IP address for the NTP source

Pool tag

Pool tag of the configuration file being requested.

SIP Reg On

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

UI Password

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

UID

Authenticatuion credential for SIP phone.

Use Login ID

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


Related Commands

Command
Description

create profile (voice register global)

Generates the configuration profiles required for SIP phone.

file text (voice register global)

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

reset (voice register global)

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

voice register global

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


show voice register session-server

To display the call details of the registered session servers, use the show voice register session-server command in privileged EXEC mode.

show voice register session-server

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.4(22)T

This command was introduced in a release earlier than Cisco IOS Release 12.4(22)T.


Examples

The following is sample output from the show voice register session-server command:

Router# show voice register session-server
 
   
Feature server 2, keepalive 60, register-uri CISCO-80NVCGATW_1259887561000
Session reg_number 569, refID 9B2783C0
Route point voice_reg_pool 28 reg_number 570
Route point voice_reg_pool 9 reg_number 571
Route point voice_reg_pool 19 reg_number 572
Route point voice_reg_pool 22 reg_number 573
Subscription sub_id 1133, calledNumber 1242
Subscription sub_id 1135, calledNumber 1054
Subscription sub_id 1138, calledNumber 1155
Subscription sub_id 1140, calledNumber 1188
Subscription sub_id 1142, calledNumber 261
Subscription sub_id 1146, calledNumber 1055
Subscription sub_id 1147, calledNumber 1100
Subscription sub_id 1149, calledNumber 1025
Subscription sub_id 1152, calledNumber 264
Subscription sub_id 1154, calledNumber 267
Subscription sub_id 1156, calledNumber 1185
Subscription sub_id 1157, calledNumber 1218
Subscription sub_id 1160, calledNumber 1056
Subscription sub_id 1161, calledNumber 263
Subscription sub_id 1163, calledNumber 1186
Subscription sub_id 1165, calledNumber 1243
Subscription sub_id 1167, calledNumber 1053
Subscription sub_id 1169, calledNumber 1120
Subscription sub_id 1171, calledNumber 1154
Subscription sub_id 1173, calledNumber 265
 
   

Table 68 describes the significant fields shown in this output.

Table 68 show voice register session-server Field Descriptions

Field
Definition

Feature server

The number of active feature servers.

keepalive

Interval, in seconds, at which the peer sends keepalive messages. The range is from 1 to 60 seconds. The default is 60 seconds.

register-uri

The registered Uniform Resource Identifier (URI) for the server.

Session reg_number

The registered number of the session.

Route point voice_reg_pool

Denotes the registered virtual device for application redirection.

Subscription sub_id

The subidentification number of the subscription.


show voice register statistics

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

show voice register statistics [global | pool tag]

Syntax Description

global

(Optional) Displays aggregate statistics associated with the SIP phone registration event.

pool tag

(Optional) Displays registration pool statistics associated with a specific pool tag. The maximum number of pools is version and platform dependent. Type ? to display a list of values.


Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Cisco Product
Modification

12.2(15)ZJ

Cisco SIP SRST 3.0

This command was introduced.

12.3(4)T

Cisco SIP SRST 3.0

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

12.4(4)T

Cisco CME 3.4
Cisco SIP SRST 3.4

This command was added to Cisco CME.

15.1(2)T

Cisco CME 8.1
Cisco SIP SRST 8.1

This command was modified. The global and pool keywords and tag argument were added. The output display was also modified to show more information about pools in unregistered state and time-stamps of registration event.


Usage Guidelines

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

In Cisco Unified CME 8.1 and Cisco Unified SIP SRST 8.1, the time-stamps for the events is displayed along with other registration related statistics. The command output also displays the reason for pools in unregistered state. Use the show voice register statistics command with pool tag keyword to display registration pool statistics associated with a specific pool.

When using the global keyword, the show voice register command output displays the aggregate statistics associated with SIP phone registration. The output of this command also displays the attempted-registrations table.

Examples

Cisco Unified CME and Cisco Unified SRST

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

 
   
Router# show voice register statistics
Sample Output:
Global statistics
  Active registrations  : 2
 
   
  Total SIP phones registered: 2
  Total Registration Statistics
    Registration requests  : 3
    Registration success   : 2
    Registration failed    : 1
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
    after last unregister        : 1 
    Last Register Request Time   : *11:42:31.783 UTC Wed Sep 16 2009 
    Last Unregister Request Time : 
    Register Success Time        : *11:11:56.707 UTC Wed Sep 16 2009 
    Unregister Success Time      : 
 
   
Register pool 1 statistics
  Active registrations  : 1
 
   
  Total SIP phones registered: 1
  Total Registration Statistics
    Registration requests  : 1
    Registration success   : 1
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
    after last unregister        : 0 
    Last Register Request Time   : *11:11:54.615 UTC Wed Sep 16 2009 
    Last Unregister Request Time : 
    Register Success Time        : *11:11:54.623 UTC Wed Sep 16 2009 
    Unregister Success Time      : 
 
   
Register pool 2 statistics
  Active registrations  : 1
 
   
  Total SIP phones registered: 1
  Total Registration Statistics
    Registration requests  : 1
    Registration success   : 1
    Registration failed    : 0
    unRegister requests    : 0
    unRegister success     : 0
    unRegister failed      : 0
    Attempts to register 
    after last unregister        : 0 
    Last Register Request Time   : *11:11:56.707 UTC Wed Sep 16 2009 
    Last Unregister Request Time : 
    Register Success Time        : *11:11:56.707 UTC Wed Sep 16 2009 
    Unregister Success Time      :

Cisco Unified CME and Cisco Unified SRST

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

Router# show voice register statistics global

Global Statistics:

Active registrations : 1

Total SIP phones registered: 2

Total Registration Statistics

R egistration requests : 97715

Registration success : 3

Registration failed : 97712

unRegister requests : 1

unRegister success : 1

unRegister failed : 0

Attempts to register

after last unregister : 97712

Last register request time : *06:45:11.127 UTC Wed Oct 14 2009

Last unregister request time : *11:56:22.179 UTC Tue Oct 13 2009

Register success time : *12:10:37.263 UTC Tue Oct 13 2009

Unregister success time : *11:56:22.182 UTC Tue Oct 13 2009

Phones that have attempted registrations and have failed:

MAC address: 001b.535c.d410

IP address : 8.3.3.111

Attempts : 97712

 Time of first attempt : *12:20:32.775 UTC Tue Oct 13 2009

Time of latest attempt: *06:46:14.815 UTC Wed Oct 14 2009

Reason for failure :

Unauthorized registration request

Cisco Unified CME and Cisco Unified SRST

The following is a sample output from this command displaying all statistical information associated with pool 1:

Router# show voice register statistics pool 1
 
   
Pool 1 Statistics: 
  Active registrations  : 0
 
   
  Total SIP phones registered: 1
  Total Registration Statistics
    Registration requests  : 2
    Registration success   : 2
    Registration failed    : 0
    unRegister requests    : 1
    unRegister success     : 1
    unRegister failed      : 0
    Attempts to register 
           after last unregister : 0 
    Last register request time   : *12:10:37.259 UTC Tue Oct 13 2009 
    Last unregister request time : *11:56:22.179 UTC Tue Oct 13 2009 
    Register success time        : *12:10:37.263 UTC Tue Oct 13 2009 
    Unregister success time      : *11:56:22.182 UTC Tue Oct 13 2009 
 
   
 
   
  Reason for unregistered state: 
         No registration request since last reboot/unregister 
 
   

Table 69 describes the significant fields shown in this output.

Table 69 show voice register statistics Field Descriptions 

Field
Description

Statistics:

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

Active registrations

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

Last Register Request Time

Used with all, pool, and statistics keywords. Shows details such as day, date, and time when the phones requested to register the last time.

Last unRegister Request Time

Used with all, pool, and statistics keywords. Shows details such as day, date, and time when the phones requested to unregister the last time.

Total Registration Statistics

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

Registration requests

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

Registration success

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

Registration failed

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

unRegister requests

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

unRegister success

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

unRegister failed

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

Global statistics

Used with the statistics keyword. Details all active registrations.

Register pool number statistics

Used with the statistics keyword. Details specific pool statistics.


Related Commands

Command
Description

show voice register all

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

show voice register pool

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

show voice register pool attempted-registrations

Displays the details of phones that attempt to register with Cisco Unified CME or Cisco Unified SRST and fail.


show voice register template

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

show voice register template {template-tag | all}

Syntax Description

template-tag

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

all

Displays all configuration information associated with all the Cisco Unified SIP IP phone templates.


Command Modes

Privileged EXEC (#)

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4

This command was introduced.

12.4(15)XY

Cisco Unified CME  4.2(1)

This command was modified to include emergency response location (ERL) information assigned to a Cisco Unified SIP IP phone in the output display.

12.4(20)T

Cisco Unified CME 7.0

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

15.0(1)XA

Cisco Unified CME 8.0

This command was modified to include logical partitioning class of restriction (LPCOR) information in the output display.

15.1(1)T

Cisco Unified CME 8.0

This command was integrated into Cisco IOS Release 15.1(1)T.

15.1(2)T

Cisco Unified CME 8.1

This command was modified. All keyword was added. Pools that have the template defined are also displayed in the output. Voice-class stun-usage information is displayed in the output.

15.2(2)T

Cisco Unified CME 9.0

This command was modified to include conference admin, conference add mode, and conference drop mode in the output display.


Usage Guidelines

Use the show voice register template command to display all configuration information associated with a Cisco Unified SIP IP phone template defined in a system. Use the all keyword with the show voice register template command to display the details of all the templates defined in the system. A maximum of 10 templates can be configured and hence, the details of a maximum of 10 templates are displayed in the output.

Examples

The following is a sample output from the show voice register template command displaying information for a voice register template:

Router# show voice register template 1
 
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
  Anonymous call block is disabled
  Voicemail is 56789, timeout 15
  softkey connected  Confrn Endcall Hold Trnsfer
  softkey hold  Newcall Resume
  softkey idle  Cfwdall Newcall Redial
  softkey seized  Cfwdall Endcall Redial
  Emergency response location 6
  Lpcor type local
  Lpcor incoming sccp_phone1
  Lpcor outgoing sccp_phone1

The following is a sample output from the show voice register template command displaying voice-class stun-usage information for voice register template 10:

Router# show voice register template 10
 
   
Temp Tag 10
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
  Anonymous call block is disabled
  softkey connected  Park Confrn Endcall Hold Trnsfer
  voice-class stun-usage is enabled. tag is 1
  Lpcor type none
  Pool 2 has this template configured
  Pool 3 has this template configured
  Pool 5 has this template configured
  Pool 6 has this template configured
  Pool 7 has this template configured
  Pool 8 has this template configured
  Pool 9 has this template configured
  Pool 10 has this template configured
  Pool 11 has this template configured
  Pool 50 has this template configured
 

The following is a sample output from the show voice register template command. The output shows that a hardware conference administrator has been assigned, only the conference creator can add a new participant, and the conference creator can terminate the active video hardware conference by hanging up.

Router# show voice register template 5
Temp Tag 5
Config:
  Attended Transfer is enabled
  Blind Transfer is enabled
  Semi-attended Transfer is enabled
  Conference softkey is enabled
  Caller-ID block is disabled
  DnD control is enabled
  Video is disabled
  Camera is enabled
  Anonymous call block is disabled
  Lpcor type none
  paging-dn 0 [multicast]
  conference admin: yes
  conference add mode: creator

conference drop mode: creator

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

Table 70 show voice register template Field Descriptions 

Field
Description

Anonymous call block

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

Attended Transfer

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

Blind Transfer

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

Caller-ID block

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

Conference

Status of conference soft key defined with the conference command.

Conference admin

Shows whether the Cisco Unified SIP IP phone is assigned as the hardware conference administrator or not.

Conference add mode

Current setting of hardware conference privilege for adding participants.

Conference drop mode

Shows who can terminate an active ad-hoc hardware conference by hanging up.

Config:

List of configuration options defined for this template.

Dnd controls

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

Emergency response location

The ephone's emergency response location to which an emergency response team is dispatched when an emergency call is made.

Lpcor incoming

Setting of the lpcor incoming command.

Lpcor outgoing

Setting of the lpcor outgoing command.

Lpcor type

Setting of the lpcor type command.

Temp Tag

Tag number of the requested template.

VAD

Status of voice activity detection defined with the vad command.

Voicemail

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


Related Commands

Command
Description

show voice register all

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

voice register template

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


show voice register tftp-bind

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

show voice register tftp-bind

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release
Version
Modification

12.4(4)T

Cisco CME 3.4

This command was introduced.


Usage Guidelines

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

Examples

The following is sample output from this command:

Router(config)# show voice register tftp-bind

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

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

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

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

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

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

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

 
   
 
   
 
   

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

Table 71 show voice register tftp-bind Field Descriptions 

Field
Description

ata<mac-address>

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

ata<mac-address>.txt

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

gk<mac-address>

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

gk<mac>.txt

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

Id<mac-address>

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

Id<mac-address>.txt

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

SIPDefault.cnf

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

SIP<mac-address>.cnf

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

syncinfo.xml

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


Related Commands

 
Description

create profile (voice register global)

Generates the configuration profiles required for SIP phones.

reset (voice register dn)

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

reset (voice register pool)

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

text file (voice register global)

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

tftp-path (voice register global)

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

voice register global

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


show voice hunt-group

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

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

Syntax Description

hunt-group-tag

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

brief

(Optional) Displays brief information on all voice hunt groups in a Cisco CME system.

longest-idle

(Optional) Displays summary of longest-idle voice hunt groups.

parallel

(Optional) Displays summary of parallel voice hunt groups.

peer

(Optional) Displays summary of peer voice hunt groups.

sequential

(Optional) Displays summary of sequential voice hunt groups.


Command Modes

Privileged EXEC (# )

Command History

Release
Modification

12.4(24)T

This command was introduced in a release earlier than Cisco IOS Release 12.4(24)T.

15.2(2)T

This command was modified to add stat collect as a field.


Usage Guidelines

Use the show voice hunt-group command to get information about voice hunt group configuration on the gateway as an alternative to the show running-config command.

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

Examples

The following is a sample output from the show voice hunt-group command, displaying all voice hunt groups configured on the router:

Router# show voice hunt-group
 
   
Group 1
    type: longest-idle
    preference: 0
    preference (sec): 0
    timeout: 0
    final_number: 1
Group 34
    type: parallel
    pilot number: 3, peer-tag 2147483647
    secondary number: 4, peer-tag 2147483646
    preference: 0
    preference (sec): 0
    timeout: 0
    final_number:
 
   

The following is a sample output from the show voice hunt-group command, displaying the configuration for all the configured voice hunt groups:

Router# show voice hunt-group
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 a sample output from the show voice hunt-group command, displaying information for a particular voice hunt group as specified by the hunt-group-tag number:

Router# show voice hunt-group 5
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 a sample output from the show voice hunt-group command, displaying information about all the voice hunt groups of a particular type:

Router# show voice hunt-group longest-idle 
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 is a sample output from the show voice hunt-group command with the keyword brief:

Router# show voice hunt-group 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
 
   

The following is a sample output from the show voice hunt-group command, indicating that call statistics is being collected:

Router# show voice hunt-group 1
Group 1
    type: parallel
    pilot number: 5000, peer-tag 2147483647
    list of numbers: 5001,5002,5011,5012,
    preference: 0
    preference (sec): 0
    timeout: 12
    final_number: 5012
    stat collect: yes
 
   

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

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

Table 72 describes the significant fields shown in the output.

Table 72 show voice hunt-group Field Descriptions 

Field
Description

Group

Tag number of voice hunt group.

type

Type of voice hunt group. The available voice hunt group types are: longest-idle, parallel, peer and sequential.

pilot number

Number that callers dial to reach the specified voice hunt group.

secondary-number

Alternate number for the specified voice hunt group.

list of numbers

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

preference

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

preference (sec)

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

timeout

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

final_number

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

hops

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

stat collect

Yes indicates that call statistics are being collected for a voice hunt group.

peer-tag

Peer hunting tag.


Related Commands

Command
Description

final (voice hunt-group)

Defines the last extension in a voice hunt group.

hops (voice hunt-group)

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

list (voice hunt-group)

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

pilot (voice hunt-group)

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

timeout (voice hunt-group)

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

voice hunt-group

Configures voice hunt groups and the associated parameters.


shutdown(telephony-service)

To shut down the Skinny Client Control Protocol (SCCP) server listening socket, use the shutdown command in telephony-service configuration mode. To enable service, use the no form of this command.

shutdown

no shutdown

Syntax Description

This command has no arguments or keywords.

Command Default

No shutdown is enabled

Command Modes

Telephony-service configuration (config-telephony)
Group configuration (conf-tele-group)
Call-manager-fallback configuration (config-ccm-fallback)

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(1)T

Cisco Unified CME  8.0
Cisco Unified SRST  8.0

This command was introduced


Usage Guidelines

The shutdown command allows you to shut down the SCCP server listening sockets when you want to change or remove the IP address set up on your system. For example, If you have IPv6 address and you want to change the IP address set up to dual stack (IPv4 and IPv6) you can use the shutdown command.

Examples

The following example shows SCCP server listening sockets being shut down under telephony- service.

Router(config-telephony)#shut down 
shutdown
 
   

The following example shows SCCP server listening sockets being shut down for group 2 (under group mode) in telephony service.

Router(config-telephony)#group 2

Router(conf-tele-group)#shutdown

The following example shows SCCP server listening sockets being shut down under call-manager-fallback mode.

Router(config-telephony)#group 2

Router(conf-cm-fallback)#shutdown

Related Commands

Command
Description

protocol -mode

Allows you to configure a preferred IP address mode for SCCP IP phones.

ip source address

Identifies the IP address and port through which IP phones communicate with a Cisco Unified CME router.


snr

To enable Single Number Reach (SNR) on an extension of an SCCP IP phone, use the snr command in ephone-dn configuration mode. To disable SNR on the extension, use the no form of this command.

snr e164-number delay seconds timeout seconds [cfwd-noan extension-number]

no snr

Syntax Description

e164-number

E.164 telephone number to ring if IP phone extension does not answer.

delay seconds

Sets the number of seconds that the call rings the IP phone before ringing the remote phone. Range: 0 to 10. Default: disabled.

timeout seconds

Sets the number of seconds that the call rings after the configured delay. Call continues to ring for this length of time on the IP phone even if the remote phone answers the call. Range: 5 to 60. Default: disabled.

cfwd-noan extension-number

(Optional) Forwards the call to this target number if the phone does not answer after both the delay and timeout seconds have expired. This is typically the voice mail number.

Note This option is not supported for calls from FXO trunks because the calls connect immediately.


Command Default

Single Number Reach is not enabled on the extension.

Command Modes

Ephone-dn configuration (config-ephone-dn)

Command History

Release
Cisco Product
Modification

12.4(22)YB

Cisco Unified CME 7.1

This command was introduced.

12.4(24)T

Cisco UnifiedCME 7.1

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


Usage Guidelines

This command enables the SNR feature on the extension. The SNR feature allows users to answer incoming calls on their desktop IP phone or at a remote destination and to pick up in-progress calls on the desktop phone or the remote destination without losing the connection. If an incoming call to this extension is answered immediately, the call is treated as a normal call.

If the call is not answered within the number of seconds set with the delay keyword, Cisco Unified CME rings the remote number while continuing to ring the SNR extension. If the call is answered by the desktop IP phone within the number of seconds set with the timeout keyword, the call to the remote number is disconnected. If the call is answered on the IP phone, the user can send the call to the remote phone by pressing the Mobility soft key.

If the call is not answered by the IP phone within the number of seconds set with the timeout keyword, the ringing call appearance on the IP phone is deleted. This call is marked as hold state on the IP phone. If the user answers the call on the remote phone, the user can pull back the call to the IP phone by pressing the Resume soft-key.

Examples

The following example shows extension 1001 is enabled for SNR. After a call rings at this number for 5 seconds, the call also rings at the remote number 4085550133. The call continues ringing on both phones for 15 seconds. If the call is not answered after a total of 20 seconds, the call no longer rings and is forwarded to the voice-mail number 2001.

ephone-dn 10

 number 1001

 mobility

 snr 4085550133 delay 5 timeout 15 cfwd-noan 2001

Related Commands

Command
Description

mobility

Enables the Mobility feature on an extension of an SCCP IP phone.

number

Associates a telephone or extension number with an ephone-dn.

softkeys connected

Modifies the order and type of soft keys that display on an IP phone during the connected call state.

softkeys idle

Modifies the order and type of soft keys that display on an IP phone during the idle call state.


snr answer-too-soon

To set the SNR answer to soon timer, use the snr answer-too-soon command in ephone-dn mode. To reset the default, use the no form of the command.

snr answer-too-soon time

no snr answer-too-soon

Syntax Description

time

Time, in seconds. Range: 1 to 5.


Command Default

No answer too soon timer is set.

Command Modes

Ephone-dn configuration (config-ephone-dn)

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(3)T

Cisco Unified CME 8.5

This command was introduced.


Usage Guidelines

Use this command to enable timer for answering the call on an SNR mobile phone. You can set a timer from 1 to 5 seconds. If the call is answered within the timer, the mobile leg is disconnected.

Examples

Router(config)ephone-dn 10

Router(config-ephone-dn)#snr answer-too-soon 4

Related Commands

Command
Description

snr

Enables SNR on the extension of an SCCP IP phone.


snr answer-too-soon (voice register dn)

To set the time in which Single Number Reach (SNR) calls are prevented from being diverted to the voice mailbox of a mobile phone, use the snr answer-too-soon command in voice register dn configuration mode. To allow SNR calls to be diverted to the voice mailbox, use the no form of the command.

snr answer-too-soon time

no snr answer-too-soon

Syntax Description

time

Time, in seconds. Range: 1 to 5.


Command Default

No answer-too-soon time is set. Calls may be diverted to the voice mailbox when a user's mobile phone is not answered or is turned off.

Command Modes

Voice register dn configuration (config-register-dn)

Command History

Release
Modification

15.2(2)T

This command was introduced.


Usage Guidelines

Use the snr answer-too-soon command to set the time in which SNR calls are prevented from being diverted to the voice mailbox of a mobile phone. When the call is diverted to the voice mailbox within the set time, the mobile phone call leg is disconnected.

Examples

The following example shows how SNR calls are prevented from being diverted to the voice mailbox of a mobile phone for 2 seconds:

Router(config)# voice register dn  3
Router(config-register-dn)# number 1004
Router(config-register-dn)# name John Smith
Router(config-register-dn)# mobility
Router(config-register-dn)# snr calling-number local
Router(config-register-dn)# snr 9900 delay 1 timeout 10
Router(config-register-dn)# snr ring-stop
Router(config-register-dn)# snr answer-too-soon 2
 
   

Related Commands

Command
Description

snr (voice register dn)

Enables the SNR feature on an extension of a Cisco Unified SIP IP phone.


snr calling-number local

To replace the calling-party number with the single number reach (SNR) extension number in calls forwarded to the remote phone, use the snr calling-number local command in ephone-dn configuration mode. To reset to the default, use the no form of this command.

snr calling-number local

no snr calling-number local

Syntax Description

This command has no arguments or keywords.

Command Default

Calling-party number is not replaced.

Command Modes

Ephone-dn configuration (config-ephone-dn)

Command History

Cisco IOS Release
Cisco Product
Modification

15.0(1)XA

Cisco Unified CME 8.0

This command was introduced.

15.1(1)T

Cisco Unified CME 8.0

This command was integrated into Cisco IOS Release 15.1(1)T.


Usage Guidelines

This command replaces the original calling party number with the SNR extension number (local number) in the caller ID display for SNR calls forwarded to the remote phone. When the call is forwarded to the remote phone, such as a mobile phone, the caller ID shows the SNR number that the caller dialed, not the number of the original calling party.

Examples

The following example shows that the original calling party number is replaced by the SNR extension number 1234 when the call is forwarded to the mobile phone:

ephone-dn 1

 number 1234

 mobility

 snr 4085550123 delay 5 timeout 15 cfwd-noan 2001

 snr calling-number local

Related Commands

Command
Description

calling-number local

Replaces a calling-party number and name with the forwarding-party number and name for all calls.

mobility

Enables the Mobility feature on an extension of an SCCP IP phone.

snr

Enables SNR on the extension of an SCCP IP phone.


snr calling-number local (voice register dn)

To replace the calling party number displayed on the configured mobile phone with the local Single Number Reach (SNR) number, use the snr calling-number local command in voice register dn configuration mode. To return to the default, use the no form of this command.

snr calling-number local

no snr calling-number local

Syntax Description

This command has no arguments or keywords.

Command Default

The number of the calling party is displayed on the mobile phone configured to receive SNR calls.

Command Modes

Voice register dn configuration (config-register-dn)

Command History

Release
Modification

15.2(2)T

This command was introduced.


Examples

The following example shows how the snr calling-number local command is used to display the local SNR number instead of the calling party's number on the mobile phone:

Router(config)# voice register dn  3
Router(config-register-dn)# number 1004
Router(config-register-dn)# name John Smith
Router(config-register-dn)# mobility
Router(config-register-dn)# snr calling-number local
Router(config-register-dn)# snr 9900 delay 1 timeout 10
Router(config-register-dn)# snr ring-stop
Router(config-register-dn)# snr answer-too-soon 2
 
   

Related Commands

Command
Description

snr (voice register dn)

Enables the SNR feature on an extension of a Cisco Unified SIP IP phone.


snr mode

To set the mode for the Single Number Reach (SNR) directory number (DN), use the snr mode command in ephone-dn configuration mode. To return to the default, use the no form of this command.

snr mode [virtual]

no snr mode

Syntax Description

virtual

Enables the virtual mode for an SNR DN when it is unregistered or floating.

Note Virtual mode is activated when the DN state remains up when it should be in the down state.


Command Default

No DN mode is set for the SNR feature.

Command Modes

Ephone-dn configuration (config-ephone-dn)

Command History

Release
Modification

15.2(2)T

This command was introduced.


Usage Guidelines

A virtual SNR DN is a DN not associated with any registered phone but is a number that can be called, have its calls forwarded to a preconfigured mobile phone, or put on an Auto Hold state when the mobile phone answers the call or the time delay is reached. In the Auto Hold state, the DN can either be floating or unregistered. A floating DN is a DN not configured with any phone while an unregistered DN is one associated with phones not registered to a Cisco Unified CME system.

A ringback tone is heard when a call is made to a virtual DN.

To enable the SNR feature, the SNR DN must be in the up state, the Mobility feature must be enabled, and the time delay or timeout value configured with the snr command must be reached.

Examples

The following example sets the virtual DN mode for SNR on ephone-dn 1:

Router(config)# ephone-dn 1
Router(config-ephone-dn)# snr mode virtual

Related Commands

Command
Description

ephone-dn

Enters ephone-dn configuration mode to configure a DN for an IP phone line, intercom line, paging line, voice-mail port, or MWI.

snr

Enables SNR on an extension of a Cisco Unified SCCP IP phone.


snr ring-stop

To stop the IP phone from ringing after the SNR call is answered on a mobile phone, use the snr ring-stop command in ephone-dn configuration mode. To reset the default value, use the no form of the command.

snr ring-stop

no snr ring-stop

Syntax Description

This command has no arguments or keywords.

Command Default

Phone continues to ring after the SNR call is answered on a mobile phone.

Command Modes

Ephone-dn configuration (conf-ephone-dn)

Command History

Cisco IOS Release
Cisco Product
Modification

15.1(3)T

Cisco Unified CME 8.5

This command was introduced.


Usage Guidelines

Use this command to stop the IP phone from ringing after the SNR call is answered on a mobile phone.

Examples

Router(config-ephone-dn)10

Router(config-ephone-dn)#snr ring-stop

Related Commands

Command
Description

snr

Enables SNR on the extension of an SCCP IP phone.


snr ring-stop (voice register dn)

To end the ringing on a Cisco Unified SIP IP phone after the Single Number Reach (SNR) call is answered on the configured mobile phone, use the snr ring-stop command in voice register dn configuration mode. To allow the Cisco Unified SIP IP phone to continue ringing even after the SNR call has been answered, use the no form of the command.

snr ring-stop

no snr ring-stop

Syntax Description

This command has no arguments or keywords.

Command Default

The Cisco Unified SIP IP phone continues to ring even after the SNR call is answered on a mobile phone.

Command Modes

Voice register dn configuration (config-register-dn)

Command History

Release
Modification

15.2(2)T

This command was introduced.


Examples

The following example shows how to end the ringing on a Cisco Unified SIP IP phone:

Router(config)# voice register dn  3
Router(config-register-dn)# number 1004
Router(config-register-dn)# name John Smith
Router(config-register-dn)# mobility
Router(config-register-dn)# snr calling-number local
Router(config-register-dn)# snr 9900 delay 1 timeout 10
Router(config-register-dn)# snr ring-stop
Router(config-register-dn)# snr answer-too-soon 2
 
   

Related Commands

Command
Description

snr (voice register dn)

Enables the SNR feature on an extension of a Cisco Unified SIP IP phone.


snr (voice register dn)

To enable the Single Number Reach (SNR) feature on an extension of a Cisco Unified SIP IP phone, use the snr command in voice register dn configuration mode. To disable the SNR feature on the extension, use the no form of the command.

snr e164-number delay seconds timeout seconds [cfwd-noan extension-number]

no snr

Syntax Description

e164-number

E.164 telephone number to call when the Cisco Unified SIP IP phone extension does not answer.

delay seconds

Sets the number of seconds that the Cisco Unified SIP IP phone rings when called. When the time delay is reached, the call is tranferred to the PSTN phone and the SNR directory number. Range: 0 to 30. Default: 5.

timeout seconds

Sets the number of seconds that the Cisco Unified SIP IP phone rings after the configured time delay. When the timeout value is reached, no call is displayed on the phone. You have to use the Resume soft key to pull back or the Mobility soft key to send the call to a mobile phone. Range: 30 to 60. Default: 60.

Note When the default is enabled, the Cisco Unified SIP IP phone continues to ring for 60 seconds even if the remote phone answers the call.

cfwd-noan extension-number

(Optional) Forwards the call to the extension number when the phone does not answer after both the time delay and timeout values are reached. The extension number is typically the voice mail number.

Note This option is not supported for calls from FXO trunks because the calls connect immediately.


Command Default

The SNR feature is not enabled on the extension of a Cisco Unified SIP IP phone.

Command Modes

Voice register dn configuration (config-register-dn)

Command History

Release
Modification

15.2(2)T

This command was introduced.


Usage Guidelines

Use the snr command to enable the SNR feature on an extension of a Cisco Unified SIP IP phone.

The SNR feature allows you to answer incoming calls on your desktop IP phones or at a remote destination. It also allows you to pick up in-progress calls on a desktop phone or at a remote destination without losing the connection. If an incoming call to the extension is answered immediately, the call is treated as a normal call.

If the call is not answered within the number of seconds set with the delay keyword, Cisco Unified CME rings the remote number while continuing to ring the SNR extension. If the call is answered by the desktop IP phone within the number of seconds set with the timeout keyword, the call to the remote number is disconnected. If the call is answered on the IP phone, you can send the call to the remote phone by pressing the Mobility soft key.

If the call is not answered by the IP phone within the number of seconds set with the timeout keyword, the call is dislayed on the IP phone as being in the hold state. If the user answers the call on the remote phone, the user can pull back the call to the IP phone by pressing the Resume soft key.

Examples

The following example shows that extension 1004 is enabled for SNR. After a call rings at this number for one second, the call also rings at the remote number 9900. The call continues ringing on both phones for 10 seconds. If the call is not answered after a total of 11 seconds, the call no longer rings and is forwarded to the voice-mail number 1007.

Router(config)# voice register dn  3
Router(config-register-dn)# number 1004
Router(config-register-dn)# name John Smith
Router(config-register-dn)# mobility
Router(config-register-dn)# snr calling-number local
Router(config-register-dn)# snr 9900 delay 1 timeout 10 cfwd-noan 1007
Router(config-register-dn)# snr ring-stop
Router(config-register-dn)# snr answer-too-soon 2
 
   

Related Commands

Command
Description

mobility (voice register dn)

Enables the Mobility feature on an extension of a Cisco Unified SIP IP phone.

snr answer-too-soon (voice register dn)

Sets the time in which SNR calls are prevented from being diverted to the voice mailbox of a mobile phone.

snr calling-number local (voice register dn)

Replaces the calling party number displayed on the configured mobile phone with the local SNR number.

snr ring-stop (voice register dn)

Ends the ringing on a Cisco Unified SIP IP phone after the Single SNR call is answered on the configured mobile phone.


softkeys alerting

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

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

no softkeys alerting

Syntax Description

Acct

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

Callback

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

Endcall

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


Defaults

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

Command Modes

Ephone-template configuration (config-ephone-template)

Command History

Cisco IOS Release
Cisco CME Version
Modification

12.3(11)T

3.2

This command was introduced.


Usage Guidelines

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

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

Examples

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

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

Related Commands

Command
Description

ephone-template (ephone)

Applies an ephone template to an ephone.

softkeys connected

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

softkeys idle

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

softkeys seized

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


softkeys connected 

To modify the order and type of soft keys that display on an IP phone during the connected call state, use the softkeys connected command in ephone-template configuration mode. To reset to the default, use the no form of this command.

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

no softkeys connected

Syntax Description

Acct

(Optional) Soft key that provides access to configured accounts.

ConfList

(Optional) Soft key that lists all parties in a conference.

Confrn

(Optional) Soft key that connects callers to a conference call.

Endcall

(Optional) Soft key that ends the current call.

Flash

(Optional) Soft key that provides hookflash functionality for public switched telephony network (PSTN) services on calls connected to the PSTN via a foreign exchange office (FXO) port. Also called "hookflash."

HLog

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

Hold

(Optional) Soft key that places an active call on hold and resumes the call.

Join

(Optional) Soft key that joins an established call to conference.

LiveRcd

(Optional) Soft key that enables recording of a call.

Mobility

(Optional) Soft key that forwards the call to the PSTN number defined by the Single Number Reach (SNR) feature.

Park

(Optional) Soft key that places an active call on hold, so it can be retrieved from another phone in the system.

RmLstC

(Optional) Soft key that removes the last party added to the conference. This soft key only works for the conference creator.

Select

(Optional) Soft key that selects a call or a conference on which to take action.

TrnsfVM

(Optional) Soft key that transfers a call to a voice-mail extension number.

Trnsfer

(Optional) Soft key that transfers active calls to another extension.


Command Default

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

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

Without HLog support: Hold, EndCall, Trnsfer, Confrn, Acct, Flash, Park

Command Modes

Ephone-template configuration (config-ephone-template)

Command History

Cisco IOS Release
Cisco Product
Modification

12.3(11)T

Cisco CME 3.2

This command was introduced.

12.4(4)XC

Cisco Unified CME 4.0

The HLog keyword was added.

12.4(11)XJ

Cisco Unified CME 4.1

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

12.4(15)T

Cisco Unified CME 4.1

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

12.4(15)XZ

Cisco Unified CME 4.3

The LiveRcd and TrnsfVM keywords were added.

12.4(20)T

Cisco Unified CME 7.0

This command with the LiveRcd and TrnsfVM keywords was integrated into Cisco IOS Release 12.4(20)T.

12.4(22)YB

Cisco Unified CME 7.1

The Mobility keyword was added.

12.4(24)T

Cisco UnifiedCME 7.1

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


Usage Guidelines

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

Configure the ConfList, Join, and RmLstC soft keys for conferencing functions. These soft keys are supported for hardware-based conferencing only and require the appropriate DSP farm configuration.


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


Examples

In the following example, ephone template 1 modifies the soft keys displayed for the seized, alerting, and connected call states:

Router(config)# ephone-template 1

Router(config-ephone-template)# softkeys seized Redial Cfwdall Pickup

Router(config-ephone-template)# softkeys alerting Callback Endcall

Router(config-ephone-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

ephone

Enters ephone configuration mode for an IP phone.

ephone-template (ephone)

Applies an ephone template to an ephone.

fxo-hook-flash

Enables display of the Flash soft key.

hunt-group logout

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

softkeys alerting

Modifies the soft-key display for the alerting call state.

softkeys idle

Modifies the soft-key display for the idle call state.

softkeys ringing

Modifies the soft-key display for the ringing call state.

softkeys seized

Modifies the soft-key display for the seized call state.


softkeys connected (voice register template)

To modify the soft key display during the connected call state on Cisco Unified SIP IP phones, use the softkeys connected command in voice register template configuration mode. To return to the default, use the no form of this command.

softkeys connected {[ConfList] [Confrn] [Endcall] [Hold] [Park] [RmLstC] [Trnsfer] [iDivert]}

no softkeys connected

Syntax Description

ConfList

(Optional) Lists all the participants in a conference.

Confrn

(Optional) Connects callers to a conference call. This soft key also enables ad-hoc conference creators to initiate a conference.

Endcall

(Optional) Ends the current call.

Hold

(Optional) Places an active call on hold and resumes the call.

Park

(Optional) Places an active call on hold so it can be retrieved from another phone in the system.

RmLstC

(Optional) Removes the last conference participant.

Trnsfer

(Optional) Transfers active calls to another extension.

iDivert

(Optional) Immediately diverts a call to a voice-messaging system.


Command Default

The default soft keys for the connected call state and the order in which they appear on Cisco Unified SIP IP phones are, from first to last: ConfList, Confrn, Endcall, Hold, Park, RmLstC, Trnsfer, and iDivert.

Command Modes

Voice register template configuration (config-register-temp)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XJ

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

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

12.4(22)YB

Cisco Unified CME 7.1

The Park keyword was added.

15.1(3)T

Cisco Unified CME 8.5

The iDivert keword was added.

15.2(2)T

Cisco Unified CME 9.0

This command was modified. The syntax description for the Confrn soft key was updated. The ConfList and RmLastC keywords were added.


Usage Guidelines

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

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

The ConfList and RmLastC soft keys are added in the connected state when hardware conference is enabled.

This command is not supported on the Cisco Unified 7905, 7912, 7940, and 7960 SIP IP Phones.

Examples

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

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

The following is a sample output from the show voice register template command. The output shows that the iDivert soft key is in connected state.

Router# show voice register template 1
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
  Anonymous call block is disabled
  Softkeys connected iDivert

Related Commands

Command
Description

softkeys hold (voice register template)

Modifies the soft key display on Cisco Unified SIP IP phones during the hold call state.

softkeys idle (voice register template)

Modifies the soft key display on Cisco Unified SIP IP phones during the idle call state.

softkeys seized (voice register template)

Modifies the soft key display on Cisco Unified SIP IP phones during the seized call state.

template (voice register pool)

Applies a phone template to a Cisco Unified SIP IP phone.


softkeys hold

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

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

no softkeys hold

Syntax Description

Join

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

Newcall

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

Resume

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

Select

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


Command Default

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

Command Modes

Ephone-template configuration (config-ephone-template)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(4)XC

Cisco Unified CME 4.0

This command was introduced.

12.4(9)T

Cisco Unified CME 4.0

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

12.4(11)XJ2

Cisco Unified CME 4.1

The Join and Select keywords were added.

12.4(15)T

Cisco Unified CME 4.1

This command with the Join and Select keywords was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

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

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

Configure the Join and Select soft keys for conferencing functions. These soft keys are supported for hardware-based conferencing only and require the appropriate DSP farm configuration..

Examples

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

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

Related Commands

Command
Description

ephone

Enters ephone configuration mode for an IP phone.

ephone-template

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

ephone-template (ephone)

Applies an ephone template to an ephone.

softkeys alerting

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

softkeys connected

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

softkeys idle

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

softkeys seized

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


softkeys idle

To modify the order and type of soft keys that display on an IP phone during the idle call state, use the softkeys idle command in ephone template configuration mode. To reset to the default, use the no form of this command.

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

no softkeys idle

Syntax Description

Cfwdall

(Optional) Soft key that forwards all calls.

ConfList

(Optional) Soft key that lists all parties in a conference.

Dnd

(Optional) Soft key that enables the Do-Not-Disturb features. This key is a toggle; pressing it a second time disables DND.

Gpickup

(Optional) Soft key that selectively picks up calls coming into a phone number that is a member of a pickup group.

HLog

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

Join

(Optional) Soft key that joins an established call to a conference.

Login

(Optional) Soft key that provides personal identification number (PIN)-controlled access to restricted phone features.

Mobility

(Optional) Soft key that enables Single Number Reach (SNR) feature. This key is a toggle; pressing it a second time disables SNR.

Newcall

(Optional) Soft key that opens a line on a speaker phone to place a new call.

Pickup

(Optional) Soft key that selectively picks up calls coming into another extension.

Redial

(Optional) Soft key that redials the last number dialed.

RmLstC

(Optional) Soft key that removes the last party added to the conference. This soft key removes the last party only when the conference creator presses it.


Command Default

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

FXO Trunk: Redial, NewCall, DoNotDisturb

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

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

Command Modes

Ephone-template configuration (config-ephone-template)

Command History

Cisco IOS Release
Cisco Product
Modification

12.3(11)T

Cisco CME 3.2

This command was introduced.

12.4(4)XC

Cisco Unified CME 4.0

The HLog keyword was added.

12.4(9)T

Cisco Unified CME 4.0

The HLog keyword was integrated into Cisco IOS Release 12.4(9)T.

12.4(11)XJ2

Cisco Unified CME 4.1

The ConfList, Join, and RmLstC keywords were added.

12.4(15)T

Cisco Unified CME 4.1

This command with the ConfList, Join, and RmLstC keywords was integrated into Cisco IOS Release 12.4(15)T.

12.4(22)YB

Cisco Unified CME 7.1

The Mobility keyword was added.

12.4(24)T

Cisco unified CME 7.1

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


Usage Guidelines

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

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

Configure the ConfList, Join, and RmLstC soft keys for conferencing functions. These soft keys are supported for hardware-based conferencing only and require the appropriate DSP farm configuration.


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


Examples

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

Router(config)# ephone-template 1

Router(config-ephone-template)# softkeys idle Redial Cfwdall Pickup

Router(config-ephone-template)# softkeys alerting Callback Endcall

Router(config-ephone-template)# softkeys connected Confrn Hold Endcall

 
   

Related Commands

Command
Description

ephone

Enters ephone configuration mode for an IP phone.

ephone-template

Creates an ephone template.

ephone-template (ephone)

Applies an ephone template to an ephone.

hunt-group logout

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

softkeys alerting

Configures soft-key display during the alerting call state.

softkeys connected

Configures soft-key display during the connected call state.

softkeys seized

Configures soft-key display during the seized call state.


softkeys idle (voice register template)

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

softkeys idle {[Cfwdall] [DND] [Gpickup] [Newcall] [Pickup] [Redial]}

no softkeys idle

Syntax Description

Cfwdall

(Optional) Soft key for "call forward all." Forwards all calls.

DND

(Optional) Soft key that enables the Do-Not-Disturb feature.

Gpickup

(Optional) Soft key that allows a user to pickup a call that is ringing on another phone.

Newcall

(Optional) Soft key that opens a line on a speakerphone to place a new call.

Pickup

(Optional) Soft key that allows a user to pickup a call that is ringing on another phone that is a member of the same pickup group.

Redial

(Optional) Soft key that redials the last number dialed.


Command Default

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

Command Modes

Voice register template configuration (config-register-temp)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XJ

Cisco Unified CME 4.1

This command was introduced.

12.4(15)T

Cisco Unified CME 4.1

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

12.4(22)YB

Cisco Unified CME 7.1

The DND keyword was added.

12.4(24)T

Cisco Unified CME 7.1

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


Usage Guidelines

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

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

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

Examples

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

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

Related Commands

Command
Description

softkeys connected (voice register template)

Modifies the soft-key display on SIP phones during the connected call state.

softkeys hold (voice register template)

Modifies the soft-key display on SIP phones during the hold call state.

softkeys idle (voice register template)

Modifies the soft-key display on SIP phones during the idle call state.

softkeys seized (voice register template)

Modifies the soft-key display on SIP phones during the seized call state.

template (voice register pool)

Applies a phone template to a SIP phone.


softkeys remote-in-use

To modify the order and type of soft keys that display on the IP phone during the remote-in-use call state, use the softkeys remote-in-use command in ephone-template configuration mode. To reset to the default, use the no form of this command.

softkeys remote-in-use {[CBarge] [Newcall]}

no softkeys remote-in-use

Syntax Description

CBarge

(Optional) Soft key that allows a user to barge into a call on a shared octo-line directory number.

Newcall

(Optional) Soft key that opens a line on a speakerphone to place a new call.


Command Default

The default soft keys for the remote-in-use call state and the order in which they appear on IP phones are Newcall, CBarge.

Command Modes

Ephone-template configuration (config-ephone-template)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(15)XZ

Cisco Unified CME 4.3

This command was introduced.

12.4(20)T

Cisco Unified CME 7.0

This command was itegrated into Cisco IOS Release 12.4(20)T.


Usage Guidelines

The remote-in-use call state is when another phone is connected to a call on an octo-line directory number shared by this phone.

Examples

In the following example, ephone template 1 modifies the soft keys displayed for the alerting, connected, and remote-in-use call states:

Router(config)# ephone-template 1

Router(config-ephone-template)# softkeys alerting Callback Endcall

Router(config-ephone-template)# softkeys connected Confrn Hold Endcall

Router(config-ephone-template)# softkeys remote-in-use CBarge Newcall

Related Commands

Command
Description

ephone-template (ephone)

Applies an ephone template to an ephone.

softkeys alerting

Modifies the soft-key display for the alerting call stage.

softkeys idle

Modifies the soft-key display for the idle call stage.

softkeys seized

Modifies the soft-key display for the seized call stage.


softkeys remote-in-use (voice register template)

To modify the soft-key display during the remote-in-use call state on SIP shared-line phones, use the softkeys remote-in-use command in voice register template configuration mode. To reset to the default, use the no form of this command.

softkeys remote-in-use {[Barge] [Newcall] [cBarge]}

no softkeys remote-in-use

Syntax Description

Barge

(Optional) Soft key that allows a user to join a call on a shared line.

Newcall

(Optional) Soft key that opens a line on a phone to place a new call.

cBarge

(Optional) Soft key that allows a user to join a call on a shared line and to turn the call into a conference call.


Command Default

The default soft keys for the remote-in-use call state and the order in which they appear on SIP phones are Barge, Newcall, cBarge.

Command Modes

Voice register template configuration (config-register-temp)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(22)YB

Cisco Unified CME 7.1

This command was introduced.

12.4(24)T

Cisco Unified CME 7.1

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


Usage Guidelines

The remote-in-use call state is when another phone is connected to a call on a directory number shared by this phone.

Examples

In the following example, SIP phone template 1 modifies the soft keys displayed for the alerting, connected, and remote-in-use call states:

Router(config)# voice register template 1

Router(config-register-temp)# softkeys alerting Callback Endcall

Router(config-register-temp)# softkeys connected Confrn Hold Endcall

Router(config-register-temp)# softkeys remote-in-use CBarge Newcall

Related Commands

Command
Description

softkeys alerting (voice register template)

Modifies the soft-key display on SIP phones during the alerting call state.

softkeys idle (voice register template)

Modifies the soft-key display on SIP phones during the idle call state.

softkeys seized (voice register template)

Modifies the soft-key display on SIP phones during the seized call state.

template (voice register pool)

Applies a phone template to a SIP phone.


softkeys ringin (voice register template)

To modify the soft-key display during the ringing call state on SIP phones, use the softkeys ringIn command in ephone-template configuration mode. To remove the softkeys ringIn configuration, use the no form of this command.

softkeys ringIn [Answer] [DND]

no softkeys ringIn

Syntax Description

Answer

(Optional) Soft key that picks up an incoming call.

DND

(Optional) Soft key that enables the Do Not Disturb feature.


Command Default

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

Command Modes

Voice register template configuration (config-register-temp)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(22)YB

Cisco Unified CME 7.1

This command was introduced.

12.4(24)T

Cisco Unified CME 7.1

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


Usage Guidelines

Use this command to create a template in which you specify which soft keys are displayed, and in what order, on an IP phone during the ringing call state. The ringing calling state is after a call is received and before the call is connected.

Any soft key that is not explicitly specified with this command is disabled if this command is used to change the default soft keys.

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

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

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

Examples

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

Router(config)# voice register template 1

Router(config-register-template)# softkeys ringing Answer Dnd Hlog

Router(config-register-template)# softkeys alerting Callback Endcall

Router(config-register-template)# softkeys connected Confrn Hold Endcall

Related Commands

Command
Description

softkeys connected (voice register template)

Modifies the soft-key display on SIP phones during the connected call state.

softkeys hold (voice register template)

Modifies the soft-key display on SIP phones during the hold call state.

softkeys idle (voice register template)

Modifies the soft-key display on SIP phones during the idle call state.

softkeys seized (voice register template)

Modifies the soft-key display on SIP phones during the seized call state.


softkeys ringing

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

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

no softkeys ringing

Syntax Description

Answer

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

Dnd

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

HLog

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


Command Default

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

Command Modes

Ephone-template configuration (config-ephone-template)

Command History

Cisco IOS Release
Cisco Product
Modification

12.4(11)XW

Cisco Unified CME 4.2

This command was introduced.

12.4(15)XY

Cisco Unified CME 4.2(1)

This command was introduced.

12.4(15)XZ

Cisco Unified CME 4.3

This command was introduced.

12.4(20)T

Cisco Unified CME 7.0

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


Usage Guidelines

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

Any soft key that is not explicitly configured is disabled.

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

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

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

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

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

Examples

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

Router(config)# telephony-service

Router(config-telephony)# ephone-template 1

Router(config-ephone-template)# softkeys ringing Answer Dnd Hlog

Router(config-ephone-template)# softkeys alerting Callback Endcall

Router(config-ephone-template)# softkeys connected Confrn Hold Endcall

 

Related Commands

Command
Description

dnd feature ring

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

ephone-template (ephone)

Applies an ephone template to an ephone.

hunt-group logout

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

softkeys alerting

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

softkeys connected

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

softkeys idle

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

softkeys seized

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


softkeys seized

<