shared-line sip

To add an ephone-dn as a member of a shared directory number in the
database of the Shared-Line Service Module for a mixed shared line between
Cisco Unified SIP and Cisco Unified SCCP IP phones, use the
shared-linesip command in ephone-dn configuration mode. To
return to the default, use the
no form of this command.

Command Default

Command Modes

Ephone-dn configuration (config-ephone-dn)

Command History

Release

Modification

15.2(2)T

This command was introduced.

Usage Guidelines

Use the
shared-linesip command to add an ephone-dn as a member of a
shared directory number in the database of the Shared-Line Service Module for a
mixed shared line between Cisco Unified SIP IP phones and Cisco Unified SCCP IP
phones. However, a mixed shared line is not enabled when an ephone-dn
nnnn is the only shared directory number
nnnn in the database of the Shared-Line Service Module. It is
only enabled when a corresponding Cisco Unified SIP IP phone with a shared
directory number
nnnn is subscribed.

Mixed shared lines can only be configured on one of several common
directory numbers. All attempts to add more are rejected.

Note

The secondary number of an ephone-dn cannot be used as a search
key in the Shared-Line Service Module.

Features are effectively supported on a mixed shared line when
dial-plan patterns have matching configurations in telephony-service and voice
register global configuration modes using the
dialplanpattern command.

Examples

The following example shows 1001 as the shared line between a Cisco
Unified SCCP IP phone and a Cisco Unified SIP IP phone. The maximum number of
active calls allowed on the mixed shared line is four.

The following
example output displays active sessions between phones (identified by their MAC
addresses) and the CAPF server. The phone ID field lists standard phone
identifications, which include the letters “SEP” plus the MAC addresses of the
phones. The below sample output defines the different session states that can
appear in the output.

A TLS
connection was established on the TCP port that is specified in the
configuration file. After a successful handshake verified the server
certificate, a dialog was started between the CAPF server and the phone’s CAPF
client. The server has challenged the phone by sending an authentication
request and is waiting for a response.

AWAIT
KEYGEN RESP

Phone
authentication was successful. The CAPF server has sent a key generation
request message to the phone and is waiting for a response.

AWAIT
ENCRYPT MSG RESP

A key has
been generated and the CAPF has used the phone’s public key to start the
enrollment process with PKI. The CAPF sent an encrypt-message request to the
phone and is waiting for a response.

AWAIT CA
RESP

The
phone has signed the received message using its private key and the CAPF has
continued the enrollment process. PKI has forwarded the certificate request to
the CA and is waiting for a response.

AWAIT
STORE CERT RESP

Upon
receiving an certificate issued from the CA, the CAPF has sent a
store-certificate request message to the phone. The store-certificate request
contains the certificate to be written to the phone’s flash memory. The CAPF is
waiting for a store-certificate response message to confirm that the
certificate has been stored.

show
credentials

To display the
credentials settings that have been configured for use during Cisco Unified CME
phone authentication communications or secure Cisco Unified SRST fallback, use
the
showcredentials command inprivileged EXEC mode.

showcredentials

Syntax Description

This command has
no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco
IOS Release

Cisco
Product

Modification

12.3(14)T

Cisco
SRST 3.3

This
command was introduced for Cisco SRST.

12.4(4)XC

Cisco
Unified CME 4.0

This
command was introduced for Cisco Unified CME.

12.4(9)T

Cisco
Unified CME 4.0

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

Usage Guidelines

Cisco Unified CME

This command
displays the credentials settings on a Cisco Unified CME router that has been
configured with a CTL provider to be used with Cisco Unified CME phone
authentication.

Cisco Unified SRST

This command
displays the credentials settings on the Cisco Unified SRST router that are
supplied to Cisco Unified CallManager for use during secure SRST fallback.

The following is sample output from the
showcticallcommand. This samples shows that a call was placed from (DN)
201 to (DN) 204 and both directory numbers are now Active (ACT). Note that the
Gcid and callIDs in this sample correspond to those in the output from the
showctigcid command.

<< Table number >> describes the significant fields shown
in the display.

Table 3 show xxx Field Descriptions

Field

Description

GCID

Global Call ID (Gcid)—Unique identifier in for every call on
an outbound leg of a VoIP dial peer for an endpoint. A single Gcid remains the
same for the same call in the system, and is valid for redirect, transfer, and
conference events.

CallID

Unique identifier for each call leg of a call.

Related Commands

Command

Description

clearctisession

Clears the session between a CSTA client application and
Cisco Unified CME.

show ctl-client

To display information about the certificate trust list (CTL) client,
use the
showctl-client command in privileged EXEC
configuration mode.

showctl-client

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 trustpoints and IP addresses known to
the CTL client.

1
indicates that debug for the phone is enabled. 0 indicates that debug is
disabled.

DnD

Do Not
Disturb is set on this phone.

DP tag

Not
used.

ephone-number

Unique
sequence number used to identify this phone during configuration (phone-tag).

IP

Assigned IP address of the Cisco Unified IP phone.

Jitter

Amount
of variation (in milliseconds) of the time interval between voice packets
received by the Cisco Unified IP phone.

keepalive

Number
of keepalive messages received from the Cisco Unified IP phone by the router.

Latency

Estimated playout delay for voice packets received by the Cisco Unified IP
phone.

line
number

Button
number on an IP phone. Line 1 is the button nearest the top of the phone.

Lost

Number
of voice packets lost, as calculated by the Cisco Unified IP phone, on the
basis of examining voice packet time-stamp and sequence numbers during playout.

Lpcor
Incoming

Setting
of the
lpcorincoming command.

Lpcor
Outgoing

Setting
of the
lpcoroutgoing command.

Lpcor
Type

Setting
of the
lpcortype command.

Mac

MAC
address.

Max
Conferences

Maximum
number of allowable conference calls and number of active conference calls.

max_line
number

Maximum
number of line buttons that can be configured on this phone.

mediaActive

1
indicates that an active conversation is in progress. 0 indicates that no
conversation is ongoing.

monitor-ring

This
button is set up as a monitor button.

number

Telephone or extension number associated with the Cisco Unified IP phone button
and its dn-tag.

offhook

1
indicates that the phone is off-hook. 0 indicates that the phone is on-hook.

overlay

This
button contains an overlay set. Use
showephoneoverlayto display the contents of overlay sets.

paging

1
indicates that the phone has received an audio page. 0 indicates that the phone
has not received an audio page.

paging-dn

Ephone-dn that is dedicated for receiving audio pages on this phone. The
paging-dn number is the number of the paging set to which this phone belongs.

Password

Authentication string that the phone user types when logging in to the
web-based Cisco Unified CME GUI.

Port

Port
used for TAPI transmissions.

REGISTERED

The
Cisco Unified IP phone is active and registered. Alternative states are
UNREGISTERED (indicating that the connection to the Cisco Unified IP phone was
closed in a normal manner) and DECEASED (indicating that the connection to the
Cisco Unified IP phone was closed because of a keepalive timeout).

reset

Pending
reset.

reset_sent

Request
for reset has been sent to the Cisco Unified IP phone.

ringing

1
indicates that the phone is ringing. 0 indicates that the phone is not ringing.

Rx Pkts

Number
of received voice packets.

silent-ring

Silent
ring has been set on this button and extension.

socket

TCP
socket number used to connect to IP phone.

speed
dial
speed-tag:digit-stringlabel-text

This
button is a speed-dial button, assigned to the speed-dial sequence number
speed-tag.
It dials
digit-string and displays the text
label-text
next to the button.

sub=3,
sub=4

Subtype
3 means that one Cisco Unified IP Phone 7914 Expansion Module is attached to
the main Cisco Unified IP Phones 7960 and 7960G, and subtype 4 means that two
are attached.

Tag
number

Dn-tag
number, the unique sequence number that identifies an ephone-dn during
configuration, followed by the type of ephone-dn it is.

TAPI
Client IP Address

IP
address of the PC running the TAPI client.

TCP
socket

TCP
socket number used to communicate with the Cisco Unified IP phone. This can be
correlated with the output of other debug and show commands.

Telecaster
model-number

Type
and model of the Cisco Unified IP phone. This information is received from the
phone during its registration with the router.

Tx Pkts

Number
of transmitted voice packets.

Username

Username that the phone user types when logging in to the web-based Cisco
Unified CME GUI.

show ephone
attempted-registrations

To display the
log of ephones that unsuccessfully attempt to register with Cisco Unified CME,
use the
showephoneattempted-registrationscommand in privileged EXEC mode.

showephoneattempted-registrations

Syntax Description

This command has
no keywords or arguments.

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

The
noauto-reg-ephone blocks the automatic registration
of ephones whose MAC addresses are not explicitly listed in the configuration.
When automatic registration is blocked, Cisco Unified CME records the MAC
addresses of phones that attempt to register but cannot because they are
blocked.

Use the
showephoneattempted-registrationsto view the list of phones that have attempted to register but
have been blocked. The
cleartelephony-serviceephone-attempted-registrations clears the list.

Examples

The following
example displays ephones that unsuccessfully attempted to register with Cisco
Unified CME:

Related Commands

show ephone
login

To display the
login states of all local IP phones, use the
showephonelogincommandin privilegedEXECmode.

showephonelogin

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
CME 3.0 Cisco SRST 3.0

This
command was introduced.

12.3(4)T

Cisco
CME 3.0 Cisco SRST 3.0

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

15.0(1)XA

Cisco
Unified CME 8.0 Cisco Unified SRST 8.0

This
command was modified. LOCAL and GLOBAL replace TRUE in the output for “Pin
enabled.”

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.

Usage Guidelines

The
showephonelogin command displays whether an ephone has a
personal identification number (PIN) and whether its owner is logged in.

In Cisco Unified
CME 7.1 and earlier versions, FALSE is displayed if there is no PIN configured
for the specified ephone. TRUE is displayed if there is a PIN configured for
the specified ephone.

In Cisco Unified
CME 8.0 and later versions, the show output is modified as follows:

FALSE is
displayed only if no PIN is defined, neither in an ephone configuration nor in
the telephony-service configuration.

LOCAL is
displayed if an individual PIN is defined for the specific ephone.

GLOBAL is
displayed if a global PIN is defined.

Examples

The following is
sample output from the
showephonelogin command. It shows that a PIN is defined for
ephone 1 and that its owner has not logged in. The other phones do not have
PINs associated with them.

The following is
sample output from the
showephonelogin command. It shows that a PIN is defined for
ephone 1 and that its owner has not logged in. A global PIN is defined also
defined for this system. If the
pin command
is configured in ephone configuration mode and telephony-service configuration
mode, the command in ephone configuration mode takes precedence.

Examples

The following is
sample output from the
showephonelogin command. It shows that a PIN is enabled for
ephone 1 and that its owner has not logged in. The other phones do not have
PINs associated with them.

Related Commands

Command

Description

showephone

Displays statistical information about registered Cisco IP phones.

show ephone
registered summary

To display the
details of all the registered Skinny Client Control Protocol (SCCP) phones that
are sorted based on their phone types, use the show ephone registered summary
command in privileged EXEC mode.

show ephone registered summary

Syntax Description

This command has
no arguments or keywords.

Command Default

This command has
no default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Cisco
IOS Release

Cisco Product

Modification

15.4(3)M

Cisco Unified CME 10.5

This
command was introduced.

Usage Guidelines

Use this command
to view the details of the registered phones configured in the SCCP mode sorted
by phone type.

Examples

The following is
sample output of the registered phones configured in the SCCP mode.

Note

The
* symbol
adjacent to the Directory Number (DN) in the command output indicates that the
Directory Number (DN) is an Overlay-dn.

show ephone rtp
connections

Syntax Description

This command has
no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release

Modification

15.2(1)T

This
command was introduced.

Usage Guidelines

The
showephonertpconnections command displays information on active
RTP calls, including the ephone tag number of the phone with an active call,
the channel of the ephone-dn, and the caller and called party's numbers for the
connection for both local and remote endpoints. The output from this command
provides an overview of all the connections in the system, narrowing the
criteria for debugging pulse code modulation and Cisco Unified CME packets
without a sniffer.

Note

When an ephone
to non-ephone call is made, information on the non-ephone does not appear in a
showephonertpconnections command output. To display the
non-ephone call information, use theshowvoiprtpconnections command.

Examples

The following
sample output shows all the connected ephones in the Cisco Unified CME system.
The sample output shows five active ephone connections with one of the phones
having the
dspfarm-assist keyword configured to transcode the
code on the local leg to the indicated codec. The output also shows four ephone
to ephone calls, represented in the CallID columns of both the RTP connection
source and RTP connection destination by zero values.

Normally, a phone
can have only one active connection but in the presence of a whisper intercom
call, a phone can have two. In the sample output, ephone-40 has two active
calls: it is receiving both a normal call and a whisper intercom call. The
whisper intercom call is being sent by ephone-6, which has an invalid LocalIP
of 0.0.0.0. The invalid LocalIP indicates that it does not receive RTP audio
because it only has a one-way voice connection to the whisper intercom call
recipient.

The below table
explains the fields in the
showephonertpconnections command output.

Table 11 show ephone
rtp connections Field Descriptions

Field

Description

Ephone

Ephone
tag number with an active call.

Line

Line
appearance of the phone.

DN

Ephone-dn
tag.

Chan

Channel
of the ephone-dn.

SrcCallID

CCAPI
CallID for the RTP connection source. For ephone to ephone calls, this will be
0. SrcCallID compares to “CallId” in the
showvoiprtpconnectionscommandoutput.

DstCallID

CCAPI
CallID for the RTP connection destination. For ephone to ephone calls, this
will be 0. DstCallID compares to “dstCallId” in the
showvoiprtpconnectionscommandoutput.

Codec
(xcoded)

Codec
name used by the phone with the active call. If xcoded is ‘Y’, the phone has
the
dspfarm-assist keyword configured to transcode the
code on the local leg to the indicated codec.

SrcNum

Caller’s number for the connection. This number is not necessarily the ephone’s
DN.

DstNum

Called
party’s number for the connection.

LocalIP

Call’s
local IP address and port. This is usually the ephone’s IP address. The IP
address in brackets is either in IPv4 or IPv6 format, followed by a colon and
the port number. The port compares to the “LocalRTP” number in the
showvoiprtpconnectionscommandoutput.

RemoteIP

Call’s
remote IP address and port. For flow-around ephone to ephone calls, this is
usually the other ephone’s IP address. For flow-through trunk calls, this is
usually the Cisco Unified CME’s IP address. The port compares to the “RmtRTP”
number in the
showvoiprtpconnectionscommand output.

Related Commands

Command

Description

showephone

Displays statistical information about registered Cisco IP
phones.

show ephone
summary types

To display the
total count of registered and unregistered phones for each phone type operating
in the Skinny Client Control Protocol (SCCP ) mode, use the
show ephone summary
types command in privileged EXEC mode. To exit the configuration,
use the
no form of
the command.

show ephone summary types

Syntax Description

This command has
no arguments or keywords.

Command Default

This command has
no default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Cisco
IOS Release

Cisco Product

Modification

15.4(3)M

Cisco Unified CME 10.5

This
command was introduced.

Usage Guidelines

This command
displays the number of registered and unregistered phones and lists the details
specific to the model of the phone.

Related Commands

show ephone unregistered

To display information about unregistered phones, use the
showephoneunregistered command in
privilegedEXECmode.

showephoneunregistered

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 CME 3.0 Cisco SRST 3.0

This command was introduced.

12.3(4)T

Cisco CME 3.0 Cisco SRST 3.0

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

Usage Guidelines

There are two ways that an ephone can become unregistered. The first
way is when an ephone is listed in the running configuration but no physical
device has been registered for that ephone. The second way is when an unknown
device was registered at some time after the last router reboot but has since
unregistered.

Related Commands

Displays the total number of registered and unregistered
SCCP phones for each phone type.

show
ephone-dn

To display status
and information for a Cisco IP phone destination number or for extensions
(ephone-dns) in a Cisco Unified CallManager Express (Cisco Unified CME) or
Cisco Unified Survivable Remote Site Telephony (SRST) environment, use the
showephone-dn command in privilegedEXECmode.

showephone-dn [dn-tag]

Syntax Description

dn-tag

(Optional) For Cisco Unified CME, a unique sequence number that is used during
configuration to identify a particular extension (ephone-dn).

(Optional) For Cisco Unified SRST, a destination number tag. The destination
number can be from 1 to 288.

Command Modes

Privileged EXEC (#)

Command History

Cisco
IOS Release

Cisco
Product

Modification

12.1(5)YD

Cisco
CME 1.0 Cisco SRST 1.0

This
command was introduced.

12.2(8)T

Cisco
CME 2.0 Cisco SRST 2.0

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

Examples

Examples

The following
Cisco Unified CME sample output displays status and information for all
ephone-dns:

Router# show ephone-dn
50/0/1 CH1 DOWN
EFXS 50/0/1 Slot is 50, Sub-unit is 0, Port is 1
Type of VoicePort is EFXS
Operation State is UP
Administrative State is UP
No Interface Down Failure
Description is not set
Noise Regeneration is enabled
Non Linear Processing is enabled
Non Linear Mute is disabled
Non Linear Threshold is -21 dB
Music On Hold Threshold is Set to -38 dBm
In Gain is Set to 0 dB
Out Attenuation is Set to 0 dB
Echo Cancellation is enabled
Echo Cancellation NLP mute is disabled
Echo Cancellation NLP threshold is -21 dB
Echo Cancel Coverage is set to 8 ms
Playout-delay Mode is set to adaptive
Playout-delay Nominal is set to 60 ms
Playout-delay Maximum is set to 200 ms
Playout-delay Minimum mode is set to default, value 40 ms
Playout-delay Fax is set to 300 ms
Connection Mode is normal
Connection Number is not set
Initial Time Out is set to 10 s
Interdigit Time Out is set to 10 s
Call Disconnect Time Out is set to 60 s
Ringing Time Out is set to 180 s
Wait Release Time Out is set to 30 s
Companding Type is u-law
Region Tone is set for US
Station name None, Station number 91400
Caller ID Info Follows:
Standard BELLCORE
Translation profile (Incoming):
Translation profile (Outgoing):
Digit Duration Timing is set to 100 ms
50/0/2 CH1 IDLE CH2 IDLE
EFXS 50/0/2 Slot is 50, Sub-unit is 0, Port is 2
Type of VoicePort is EFXS
Operation State is DORMANT
Administrative State is UP
No Interface Down Failure
Description is not set
Noise Regeneration is enabled
Non Linear Processing is enabled
Non Linear Mute is disabled
Non Linear Threshold is -21 dB
Music On Hold Threshold is Set to -38 dBm
In Gain is Set to 0 dB
Out Attenuation is Set to 0 dB
Echo Cancellation is enabled
Echo Cancellation NLP mute is disabled
Echo Cancellation NLP threshold is -21 dB
Echo Cancel Coverage is set to 8 ms
Playout-delay Mode is set to adaptive
Playout-delay Nominal is set to 60 ms
Playout-delay Maximum is set to 200 ms
Playout-delay Minimum mode is set to default, value 40 ms
Playout-delay Fax is set to 300 ms
Connection Mode is normal
Connection Number is not set
Initial Time Out is set to 10 s
Interdigit Time Out is set to 10 s
Call Disconnect Time Out is set to 60 s
Ringing Time Out is set to 180 s
Wait Release Time Out is set to 30 s
Companding Type is u-law
Region Tone is set for US
Station name None, Station number 91450
Caller ID Info Follows:
Standard BELLCORE
Translation profile (Incoming):
Translation profile (Outgoing):
Digit Duration Timing is set to 100 ms

Examples

The following
SRST sample output displays status and information for all ephone-dns:

Router# show ephone-dn 7
50/0/7 INVALID
EFXS 50/0/7 Slot is 50, Sub-unit is 0, Port is 7
Type of VoicePort is EFXS
Operation State is UP
Administrative State is UP
No Interface Down Failure
Description is not set
Noise Regeneration is enabled
Non Linear Processing is enabled
Non Linear Mute is disabled
Non Linear Threshold is -21 dB
Music On Hold Threshold is Set to -38 dBm
In Gain is Set to 0 dB
Out Attenuation is Set to 0 dB
Echo Cancellation is enabled
Echo Cancellation NLP mute is disabled
Echo Cancellation NLP threshold is -21 dB
Echo Cancel Coverage is set to 8 ms
Playout-delay Mode is set to default
Playout-delay Nominal is set to 60 ms
Playout-delay Maximum is set to 200 ms
Playout-delay Minimum mode is set to default, value 4 ms
Playout-delay Fax is set to 300 ms
Connection Mode is normal
Connection Number is not set
Initial Time Out is set to 10 s
Interdigit Time Out is set to 10 s
Call Disconnect Time Out is set to 60 s
Ringing Time Out is set to 8 s
Wait Release Time Out is set to 30 s
Companding Type is u-law
Region Tone is set for US
Station name None, Station number None
Caller ID Info Follows:
Standard BELLCORE
Voice card specific Info Follows:
Digit Duration Timing is set to 100 ms

The following
table describes significant fields in the output from this command.

Table 13 show ephone-dn
Field Descriptions

Field

Description

Administrative State

Administrative (configured) state of the voice port.

alert

The
number of calls that were disconnected by the far-end device when the local IP
phone was in the call alerting state (for example, because the far-end phone
rang but was not answered and the far-end system decided to drop the call
rather than let the phone ring for too long).

answered
(incoming)

The
number of incoming calls that were actually answered (the phone goes off hook
when ringing).

answered
(outgoing)

The
number of outgoing call attempts that were answered by the far end.

busy

The
number of outgoing call attempts that got a busy response.

Call
Disconnect Time Out

Not
applicable to the Cisco IP phone.

called,
calling

Extension numbers of called and calling parties.

Caller
ID Info Follows

Information about the caller ID.

Call
Ref

A
unique per-call identifier used by the SCCP protocol. The Call Ref values are
assigned sequentially within the Cisco CME–SCCP interface, so this value also
indicates the total number of SCCP calls since the router was last rebooted.

chan

Channel
number of an ephone-dn.

CODEC

Codec
type.

Companding Type

Not
applicable to the Cisco IP phone.

connect

The
number of calls that were disconnected by the far-end device when the local IP
phone was in the call connected state.

Connection Mode

Not
applicable to the Cisco IP phone.

Connection Number

Not
applicable to the Cisco IP phone.

Description

Not
applicable to the Cisco IP phone.

Digit
Duration Timing

Not
applicable to the Cisco IP phone.

DN
STATE

Ephone-dn tag number and state of the phone line associated with an extension.

Echo
Cancellation...

Not
applicable to the Cisco IP phone.

Echo
Cancel Coverage

Not
applicable to the Cisco IP phone.

EFXS

Voice
port type.

Far-end
disconnect at...

See
connect, alert, hold, and ring.

Final
Jitter

The
final voice packet receive jitter reported by the IP phone at the end of the
call.

hold

The
number of calls that were disconnected by the far-end device when the local IP
phone was in the call hold state (for example, if the caller was left on hold
for too long and got tired of waiting).

incoming

The
number of incoming calls presented (the phone rings).

In Gain

Not
applicable to the Cisco IP phone.

Initial
Time Out

Amount
of time the system waits for an initial input digit from the caller.

Interdigit Time Out

Amount
of time the system waits for a subsequent input digit from the caller.

Last 64
far-end disconnect cause codes

See the
Mappings of PSTN Cause Codes to SIP Event table for a list of public switch
telephone network (PSTN) cause codes that can be sent as an ISDN cause
information element (IE) and the corresponding Session Interface Protocol (SIP)
event.

Latency

The
final voice packet receive latency reported by the IP phone at the end of the
call.

Lost

Number
of lost packets.

Music
On Hold Threshold

Not
applicable to the Cisco IP phone.

No
Interface Down Failure

State
of the interface.

Noise
Regeneration

Not
applicable to the Cisco IP phone.

Non
Linear...

Not
applicable to the Cisco IP phone.

Operation State

Operational state of the voice port.

Out
Attenuation

Not
applicable to the Cisco IP phone.

outgoing

The
number of outgoing call attempts.

Playout-delay Maximum

Not
applicable to the Cisco IP phone.

Playout-delay...

Not
applicable to the Cisco IP phone.

Port

Port
number for the interface associated with the voice interface card.

Region
Tone

Not
applicable to the Cisco IP phone.

ring

The
number of calls that were disconnected by the far-end device when the local IP
phone was in the ringing state (for example, if the call was not answered and
the caller hung up).

Ringing
Time Out

Duration, in seconds, for which ringing is to continue if a call is not
answered. Set with the
timeoutsringing command.

Rx
Pkts, bytes

Number
of packets and bytes received during the current or last call.

Signal
Level to phone, peak

For
G.711 calls only, this parameter indicates the most recent voice signal level
in the voice IP packets sent from the router to the IP phone. This parameter is
valid only for VoIP or PSTN G.711 calls to the IP phones. This parameter is not
valid for calls between local IP phones, or calls that use codecs other than
G.711. The peak field indicates the peak signal level seen during the entire
call.

Slot

Slot
used in the voice interface card for this port.

Station
name

Station
name.

Station
number

Station
number.

Stream
Port

RTP
port allocated by the given DN/channel.

Sub-unit

Subunit
used in the voice interface card for this port.

Tx
Pkts, bytes

Number
of packets and bytes transmitted during the current call or last call.

Type of
VoicePort

Voice
port type.

VAD

Voice
activity detection.

Voice
card specific info

Information specific to the voice card.

VPM
STATE

State
indication for the VPM software component.

VTSP
STATE

State
indication for the VTSP software component.

Wait
Release Time Out

Time
that a voice port stays in the call-failure state while the router sends a busy
tone, reorder tone, or out-of-service tone to the port.

The following
table lists the PSTN cause codes that can be sent as an ISDN cause information
element (IE) and the corresponding SIP event for each. These are the far-end
disconnect cause codes listed in the output for the
showephone-dnstatisticscommand.

Table 14 Mappings of
PSTN Cause Codes to SIP Events

PSTN
Cause Code

Description

SIP
Event

1

Unallocated number

410
Gone

3

No
route to destination

404 Not
found

16

Normal
call clearing

BYE

17

User
busy

486
Busy here

18

No user
responding

480
Temporarily unavailable

19

No
answer from the user

21

Call
rejected

603
Decline

22

Number
changed

302
Moved temporarily

27

Destination out of order

404 Not
found

28

Address
incomplete

484
Address incomplete

29

Facility rejected

501 Not
implemented

31

Normal
unspecified

404 Not
found

34

No
circuit available

503
Service unavailable

38

Network
out of order

41

Temporary failure

42

Switching equipment congestion

44

Requested channel not available

47

Resource unavailable

55

Incoming class barred within CUG

603
Decline

57

Bearer
capability not authorized

501 Not
implemented

58

Bearer
capability not presently available

63

Service
or option unavailable

503
Service unavailable

65

Bearer
cap not implemented

501 Not
implemented

79

Service
or option not implemented

87

User
not member of CUG

603
Decline

88

Incompatible destination

400 Bad
Request

95

Invalid
message

102

Recover
on timer expiry

408
Request timeout

111

Protocol error

400 Bad
request

127

Interworking unspecified

500
Internal server error

Any
code other than those listed above

500
Internal server error

Related Commands

Command

Description

showephone-dncallback

Displays information about pending callbacks in a Cisco Unified CME or a Cisco
Unified SRST environment.

showephone-dnloopback

Displays information about loopback ephone-dns that have been created in a
Cisco Unified CME or a Cisco Unified SRST environment.

showephone-dnstatistics

Displays display call statistics for a Cisco IP destination or for extensions
(ephone-dns) in a Cisco Unified CME or a Cisco Unified SRST environment.

This
command was modified. The command output was enhanced to display the unlocked
Meet-Me conference setting.

15.1(4)M

Cisco
CME 8.6

This
command was modified to display information on video conferences.

Examples

The following
sample output displays information for the 1397 conference number. There are
three directory numbers and six inactive parties. The number of unlocked DN
tags are displayed at the end of each MeetMe conference.

The following
table describes the significant fields shown in the display.

Table 16 show ephone-dn
conference Field Descriptions

Field

Description

active

Number
of active parties in the conference.

DN tags

Directory numbers (DNs) in the conference.

inactive

Number
of inactive parties in the conference.

number

Conference telephone or extension number.

type

Type of
conference: meet-me or ad hoc.

Related Commands

Command

Description

showephone-dn

Displays status and information for a Cisco IP phone destination number or for
extensions (ephone-dns) in a Cisco Unified CME or a Cisco Unified SRST
environment.

show ephone-dn
loopback

To display
information about loopback ephone-dns that have been created in a Cisco Unified
CallManager Express (Cisco Unified CME) or a Cisco Unified Survivable Remote
Site Telephony (Cisco Unified SRST) environment, use the
showephone-dnloopback command in privilegedEXECmode.

showephone-dnloopback

Syntax Description

This command has
no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Cisco
IOS Release

Cisco
Product

Modification

12.1(5)YD

Cisco
CME 1.0 Cisco SRST 1.0

This
command was introduced.

12.2(8)T

Cisco
CME 2.0 Cisco SRST 2.0

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

Examples

The following
example displays information for a loopback using ephone-dn 21 and ephone-dn
22:

Number
of leading digits to strip before forwarding to the other extension in the
loopback-dn pair.

vector

The
following values describe the media path for voice packets that pass through
the loopback-dn:

0—No
media path or not a loopback-dn path (inactive).

1—Normal path. Loopback-dn has identified the final media destination as a
local IP phone. The media IP address field shows a valid, non-zero value.

2—Hairpin. Media packets are routed back through paired loopback-dns. The final
destination is not known. For example, this can be a VoIP-to-VoIP call path by
a loopback-dn.

3—Hairpin. The final destination is an ephone-dn in a special mode such as
paging.

4—Loopback-dn chain has been detected, in which two loopback-dn pairs have been
connected together.

5—Loopback-dn chain has been detected in which more than two loopback-dn pairs
are connected in series.

Related Commands

Command

Description

loopback-dn

Creates a virtual loopback voice port (loopback-dn) to establish a demarcation
point for VoIP voice calls and supplementary services.

showephone-dn

Displays status and information for a Cisco IP phone destination number or for
extensions (ephone-dns) in a Cisco Unified CME or a Cisco Unified SRST
environment.

show ephone-dn
paging

To display
configuration information on paging groups, use the
showephone-dnpaging command in user EXEC or privileged EXEC
mode.

showephone-dnpaging

Syntax Description

This command has
no arguments or keywords.

Command Modes

User EXEC (>)

Privileged EXEC (#)

Command History

Release

Modification

15.2(2)T

This
command was introduced.

Usage Guidelines

Use the
showephone-dnpaging command to display which paging dn is
specified and which phone is being paged.

Examples

The following is
a sample output from the
showephone-dnpaging command before paging. The output shows two
parts: the static “Paging Configuration” part and the dynamic “Paging Control
Info” part. The output of the
showephone-dnpaging command should be exactly the same before
and after paging.

The following is
a sample output from the
showephone-dnpaging command during paging. In this output, the
“Paging Configuration” part remains the same expect for the changes in state
from IDLE to ACTIVE and OFF to ON. However, the “Paging Control Info” part
displays the changes in the paging control information.

The following
table describes the significant fields shown in the display.

Table 19 show ephone-dn
park Field Descriptions

Field

Description

DN

Ephone-dn
tag (identifier) number for the call-park slot.

(1560)

Extension
number associated with the call-park slot.

park-slot
state

Whether
the call-park slot is in use or idle.

Notify to
( )

Extension
that has been specified for notification. Empty parentheses indicate that no
extension was specified in the configuration.

timeout

Number of
seconds between reminder rings, in seconds.

limit

Number of
reminder rings before a call parked at this slot is disconnected.

Related Commands

Command

Description

park-slot

Creates
a floating extension (ephone-dn) at which calls can be temporarily held
(parked).

show ephone-dn statistics

To display call statistics for a Cisco IP destination or for
extensions (ephone-dns) in a Cisco Unified CallManager Express (Cisco Unified
CME) or a Cisco Unified Survivable Remote Site Telephony (Cisco Unified SRST)
environment, use the
showephone-dn command in privilegedEXECmode.

showephone-dn [dn-tag] statistics

Syntax Description

dn-tag

(Optional) Unique sequence number that is used during
configuration to identify a particular extension (ephone-dn).

statistics

Displays voice quality statistics on calls for a specified
extension or for all extensions.

Command Modes

Privileged EXEC

Command History

Cisco IOS Release

Cisco Product

Modification

12.2(15)ZJ1

Cisco CME 3.0 Cisco SRST 3.0

This command was introduced.

12.3(4)T

Cisco CME 3.0 Cisco SRST 3.0

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

Examples

The following sample output displays statistics for all extensions
(ephone-dns) in a Cisco Unified CME system. There are two ephone-dns (DN1 and
DN3) in this example.

Usage Guidelines

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

Examples

The following
examples are contained in this section:

Examples

The following is
a sample output from the
showephone-hunt command when no argument or keyword
has been entered. The sample contains information for a peer hunt group, a
sequential hunt group, and a longest-idle hunt group. See the table for
descriptions of significant fields in the output.

Examples

A portion of the
showephone-hunt command output displays the ready and
not-ready agent status of extensions in hunt groups. An extension that is ready
is available to receive hunt-group calls. An extension that is in not-ready
status blocks hunt-group calls. An agent toggles an extension from ready to not
ready and back to ready using the HLog soft key or a FAC.

The following
examples display some output that reports different agent status not-ready
conditions within a hunt group. In the hunt group used for these examples,
there are four users: agent1 and agent4 share extension 8001, agent2 is on
extension 8002, and agent3 is on extension 8003.

In the
showephone-hunt output, “logout 0” means that all
instances of the extension are in ready status. Any number greater than zero
next to “logout’ indicates that at least one ephone using the extension has
activated not-ready status.

If agent1 is in
not-ready status, the
showephone-hunt command will display the following
output. The logout value for extension 8001 is 1 because one phone is in
not-ready status.

If all agents
place their phones in not-ready status, the
showephone-hunt command displays the following output.
Note that the logout value of 2 for extension 8001 indicates that both
ephone-dns with that extension number (agent1 and agent4) are in not-ready
status.

Examples

The
showephone-hunt command displays the parameters that
have been set using the
autologout command, which is used for the Automatic
Agent Status Not-Ready feature. The table shows the possible values of the auto
logout field. describes other fields in the output.

The
Automatic Agent Status Not-Ready feature is disabled. This is also the default
if this command is not used.

no auto logout

auto logout: 1 type: both

The
Automatic Agent Status Not-Ready feature is enabled and no options have been
used with the
autologout command. The number of unanswered calls is
1 and the command applies to both static and dynamic hunt group members by
default.

auto logout

auto logout: 2 type: both

Two
unanswered calls will be sent to a hunt group agent before the agent’s status
is automatically changed to not ready. The command applies to both static and
dynamic hunt group members by default.

auto logout 2

auto logout: 3 type: static

Three
unanswered calls will be sent to a hunt group agent before the agent’s status
is automatically changed to not ready. The command applies to static hunt group
members only.

Indicates whether the Automatic Agent Status Not-Ready feature has been
enabled. See the table.

aux-number

Auxiliary number used to generate dial peers for a hunt group. This number is
generated by the
list
command.

description

Description string entered for the ephone hunt group. This value is set using
the
description(ephone-hunt)command.

dn-tag

Directory number (DN) sequence number.

E.164
register

Displays whether a pilot number registers with an H.323 gatekeeper. This value
is set by the
no-reg
command.

final
number

Last
number in the ephone-hunt group, after which a call is no longer redirected.
This value is set by the
final
command.

fwd-final

Final
destination of an unanswered call that has been transferred into a hunt group:
orig-phone means calls are returned to the transferring phone, and final means
calls are sent to the final number specified in the configuration. This value
is set by the
fwd-final
command.

hops

Number
of hops before a call proceeds to the final number. This value is set by the
hops
command.

list of
numbers

Extension numbers that are group members of the specified ephone hunt group.
This value is set by the
list
command.

Number
of agents in the not-ready state (not accepting hunt-group calls).

max
timeout

Maximum
combined timeout for the no-answer periods for all ephone-dns in the
ephone-hunt list. This value is set by the
max-timeout
command.

members
initial state: logout/login

Sets
all static members initial state to logout.

next-to-pick

(Peer
hunt groups only) List number of the agent whose phone will ring when the next
call comes in to the hunt group. (For example, if the order of agents in the
list
command is 451, 452, 453, 454, the list number 2 represents extension 452.)

off-hook agents

Number
of agents who are currently off-hook.

on-hook
time stamp

(Longest-idle hunt groups only) The last on-hook time of the agent, which is
used to determine which agent to ring next time.

peers

Displays the number of ephone-dn dial peers.

peer-tag

Dial-peer sequence number.

pilot
number

Number
that callers dial to reach the ephone hunt group.

preference

Preference order set by the
preference(ephone-hunt)command for the primary pilot number.

preference (sec)

Preference order set by the
preference(ephone-hunt)command for the secondary pilot number.

rna

Number
of unanswered hunt group calls (ring-no-answer) by this agent, used for the
Automatic Agent Status Not-Ready feature.

stat
collect

Indicates whether statistic are being Cisco Unified CME B-ACD data is being
collected. See the
statisticscollect command.

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. Multiple values in this field refer
to the timeouts for the hops between ephone-dns in a hunt group as they appear
in the
list
command. This value is set by the
timeout
command.

type

Type of
ephone hunt group: longest-idle, peer, or sequential.

up/down

Dial
peer is up or down.

Related Commands

Command

Description

autologout

Enables automatic change of agent status to not-ready after a specified number
of hunt-group calls are not answered.

ephone-hunt

Enters ephone-hunt configuration mode to create a hunt group for use in a Cisco
Unified CME system.

hunt-grouplogout

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

memberslogout

Sets
all static members initial state to logout.

show
ephone-hunt statistics

Displays hunt group call statistics.

show ephone-hunt
statistics

To display
ephone-hunt statistics information, use the
showephone-huntstatisticscommand in privileged EXEC mode.

Usage Guidelines

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 per ephone hunt group with the
statisticscollect command. Additional data is displayed for
all agents combined and for individual agents. The additional data includes
statistics such as: the number of calls received, the amount of time the calls
waited to be answered, and the amount of time the calls spent on hold or in a
queue.

Once you have
enabled statistics collection, you can use the
showephone-huntstatisticscommand to display call statistics, or you can use the
hunt-groupreporteveryhours and
hunt-groupreporturl commands to transfer the statistics to files
using TFTP.

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.

Examples

The following
is a sample output that displays call statistics for the past hour for hunt
group 2, which is associated with a Cisco Unified CME B-ACD service:

Router# show ephone-hunt 2 stat last 1 h
Thu 02:00 - 03: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: 8004
From Direct Call:
Total Calls Answered : 3:
Average Time in Call (secs) : 70
Longest Time in Call (secs) : 150
Total 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: 8006
From Direct Call:
Total Calls Answered : 3:
Average Time in Call (secs) : 51
Longest Time in Call (secs) : 118
Total 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: 8044
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: 2
Number of calls in the queue: 1
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
showephone-huntstatistics 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 table
describes the significant fields shown in the output of the
showephone-huntstatisticscommand, in alphabetical order.

Table 24 show
ephone-hunt statistics Field Descriptions

Field

Description

Abandoned calls

Total number of calls abandoned by hunt group agents. This
does not include calls going to the final number.

Answered call

Total number of calls answered by hunt group agents.

Average
time before abandon (secs)

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

Average
hold time (secs)

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

Average
time in call (secs)

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

Average
time in hold (secs)

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

Average
time to answer (secs)

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

Average
time to handoff (secs)

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

Calls
answered by voice mail

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

Calls
exited the queue

Total
number of calls to Cisco Unified CME B-ACD that exited queues.

Calls
forwarded to voice mail

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

Calls
handoff to IOS

Total
number of calls handed off to IOS.

Calls
on hold

Total
number of calls that were placed on hold.

Longest
hold time (secs)

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

Longest
time in call (secs)

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

Longest
time in hold (secs)

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

Longest
time to answer (secs)

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

Longest
time to handoff (secs)

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

Max
agent

Maximum
number of hunt group agents.

Min
agent

Minimum
number of hunt group agents.

Number
of abandoned calls:

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

Number
of error calls

Total
number of misdialed calls.

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 on hold for this agent.

Total
calls presented to the queue

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

Total calls

Total number of direct calls made to the hunt group.

Note

From Cisco Unified CME Release 10.5 onwards, abandoned calls will
not include the calls going to the final number. However, the total calls
includes calls going to the final number. Use the formula "
Final Calls= Total Calls - Answered Calls - Abandoned Calls" ,
to calculate the calls going to the final number.

Related Commands

Command

Description

ephone-hunt

Enters ephone-hunt configuration mode to create a hunt group for use in a Cisco
Unified CME system.

hunt-groupreporteveryhours

Sets
the hourly interval at which Cisco Unified CME B-ACD call statistics are
automatically transferred to a file.

hunt-groupreporturl

Sets
filename parameters and the URL path where Cisco Unified CME B-ACD call
statistics are to be sent using TFTP.

The time
between the last retain-timer-triggered cleanup to the next cleanup.

extension
events

Events
related to extensions that have been captured in the internal buffer.

device
events

Events
related to devices that have been captured in the internal buffer.

overwrites

Events
that are written over previously recorded events in the buffer. Overwrites
occur when the internal buffer size is too small; new events overwrite old
ones. The internal buffer size is set using the
max-size
keyword in the
logtable command.

missed

Events
that happen too quickly for the system to record.

deleted

Events
removed from the internal buffer.

History

Information since the last system restart.

Threads

Current
number of threads configured in the system.

max xml
threads

Maximum
number of concurrent XML threads allowed.

current
thread

XML API
query thread.

read in
process

TRUE
indicates that the xml-test.html file is being read now. FALSE indicates that
the file is not being read.

UTC

Coordinated Universal Time, which is used by the system clock on the Cisco CME
router.

Related Commands

Command

Description

logtable

Sets
the maximum size of the table used to capture phone events used for the Cisco
CME XML API.

show ip address trusted list

To display a list of trusted ip addresses, use the
showipaddresstrustedlistcommand in privileged EXEC mode.

showipaddresstrustedlist

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 a list of trusted IP addresses.

Examples

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

The following
table describes the significant fields shown in the display.

Table 27 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
sccpblf-speed-dialretry-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

allowwatch

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.

debugephoneblf

Displays debugging information for BLF presence features.

debugpresence

Displays debugging information about the presence service.

presence

Enables presence service and enters presence configuration mode.

presenceenable

Allows the router to accept incoming presence requests.

showpresenceglobal

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
showsdspfarm command in privileged EXEC mode.

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

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

The following
table describes the significant fields shown in the display.

Table 32 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-diallist(ephone)

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

bulk-speed-diallist(telephony-service)

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

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

Usage Guidelines

Use the
showtelephony-serviceconferencehardware 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.

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

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
emergencyresponselocation command.

lpcor
(incoming)

Setting
of the
lpcorincoming command.

lpcor
(outgoing)

Setting
of the
lpcoroutgoing command.

lpcor
type

Setting
of the
lpcortype command.

Related Commands

Command

Description

ephone-template

Creates an ephone template.

show telephony-service fac

To display current feature access codes (FACs), use the
showtelephony-servicefac command in privileged EXEC mode.

showtelephony-servicefac

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
facstandard before phone users can use them.
Individual FACs can be changed using the
faccustom command.

show telephony-service tftp-bindings

To display the current configuration files accessible to IP phones,
use the
showtelephony-servicetftp-bindings command in user EXEC or privileged
EXEC mode.

showtelephony-servicetftp-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
showtelephony-servicetftp-bindings when the ISO-3166 code for Germany has been selected for both
language and tones:

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
showvoicehunt-group command in privileged EXEC mode.

Command Modes

Command History

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
showvoicehunt-group command to get information about voice
hunt group configuration on the gateway as an alternative to the
showrunning-config command.

Use the
showvoicehunt-group and
showvoicehunt-groupbrief
commands to display hunt group configuration information for all voice hunt
groups in a Cisco Unified CME system. Use
showvoicehunt-grouphunt-group-tag to display data on a specific
hunt-tag configuration created by the
voicehunt-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
voicehunt-group command.

Examples

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

Syntax Description

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.

hourshours

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
showvoicehunt-groupstatistics 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
voicehunt-groupstatisticscollect 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
showvoicehunt-groupstatistics 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
showvoicehunt-groupstatistics 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
showvoicehunt-groupstatistics command. The output shows that no call
statistics were collected from voice hunt group 1 from 2:00 to 4:00 on a
Monday.

The following
table describes the significant fields shown in the display.

Table 40 show voice
hunt-group statistics Field Descriptions

Field

Description

Abandoned calls

Total number of calls abandoned by hunt group agents. This
does not include calls going to the final number.

Answered call

Total number of calls answered by hunt group agents.

Average time in call (secs)

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

Average time to answer (secs)

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

Average time in hold (secs)

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

Average hold time (secs)

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

Average time to handoff (secs)

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

Calls on hold

Total number of calls that were placed on hold.

Calls handoff to IOS

Total number of calls handed off to IOS.

Calls answered by voice mail

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

Calls forwarded to voice mail

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

Longest time to answer (secs)

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

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.

Longest time in hold (secs)

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

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.

Longest time to handoff (secs)

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

Max agent

Maximum number of hunt group agents.

Min
agent

Minimum
number of hunt group agents.

Number of abandoned calls

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

Number of calls in the queue

Total number of calls in the queue.

Number of error calls

Total number of error calls.

Total calls

Total number of direct calls made to the hunt group.

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.

Total calls presented to the queue

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

Note

From Cisco Unified CME Release 10.5 onwards, abandoned calls will
not include the calls going to the final number. However, the total calls
includes calls going to the final number. Use the formula "
Final Calls= Total Calls - Answered Calls - Abandoned Calls" ,
to calculate the calls going to the final number.

The following
table describes the significant fields shown in this output.

Table 41 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
idcommand 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
incomingcalled-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(voiceregisterpool)

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(voiceregisterpool)

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

Syntax Description

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

Examples

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

show voice
register dialplan

To display all
configuration information for a specific SIP dial plan, use the
showvoiceregisterdialplan 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
voiceregisterdialplan command and assign it to a SIP phone with
the
dialplan
command.

In Cisco Unified
CME 8.1 and later,
showvoiceregisterdialplan
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:

Command Modes

Command History

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

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

Examples

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

The following
table contains descriptions of significant fields shown in this output, listed
in alphabetical order.

Table 44 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
preferencecommand in voice register dn configuration mode.

The following
table contains descriptions of significant fields shown in this output, listed
in alphabetical order.

Table 45 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
dstauto-adjust command.

Forwarding local

Setting
of
forwardinglocal command.

Generate text file

Setting
of
textfile command.

Hold-alert

Setting
ofhold-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-dncommand. 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
mwistutter 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.

The following
is a sample output of the
showvoiceregisterpool 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.

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-controlcommand.

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
incomingcalled-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
lpcorincomingcommand.

Lpcor
Outgoing

Shows
the setting of the
lpcoroutgoingcommand.

Lpcor
Type

Shows
the setting of the
lpcortype 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
idcommand is configured.

Number
list, Pattern, and Preference

Shows
the
numbercommand 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(voiceregisterpool)

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(voiceregisterpool)

Enables the call-waiting option on a SIP phone.

cor(voiceregisterpool)

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

dnd-control(voiceregistertemplate)

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

dtmf-relay(voiceregisterpool)

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

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
showvoiceregisterpoolattempted-registrationscommand in privileged EXEC mode.

showvoiceregisterpoolattempted-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

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

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-registrationssize

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

clearvoiceregisterattempted-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

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

show voice register pool connected

To display the details of SIP phones that are in connected state, use
the
showvoiceregisterpoolconnectedcommand in privileged EXEC mode.

showvoiceregisterpoolconnected [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:

show voice
register pool ip

To display the
details of a SIP phone with a specific IP address, use the
showvoiceregisterpoolipcommand in privileged EXEC mode.

showvoiceregisterpoolipip-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

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

show voice register pool on-hold

To display the details of phones that are currently on-hold, use the
showvoiceregisterpooloh-holdcommand in privileged EXEC mode.

showvoiceregisterpoolon-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

Examples

The following is a sample output from this command displaying
information for phones ringing in a 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:

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
showvoiceregisterpoolregisteredcommand in privileged EXEC mode.

showvoiceregisterpoolregistered

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
showvoiceregisterpoolregistered 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

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

The following
table contains descriptions of significant fields shown in the
showvoiceregisterpoolregistered command output, listed in alphabetical
order.

Table 50 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
incomingcalled-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
lpcorincoming command.

Lpcor
Outgoing

Shows
the setting of the
lpcoroutgoing command.

Lpcor
Type

Shows
the setting of the
lpcortype 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
idcommand is configured.

Number
list, Pattern, and Preference

Shows
the
numbercommand 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-outgoingcommand 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(voiceregisterpool)

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(voiceregisterpool)

Enables the call-waiting option on a SIP phone.

cor(voiceregisterpool)

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

dnd-control(voiceregistertemplate)

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

dtmf-relay(voiceregisterpool)

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

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

translate-outgoing(voiceregisterpool)

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(voiceregisterpool)

Defines a phone type for a SIP phone.

voiceregisterpool

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

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

show voice register pool ringing

To display the details of phones that are currently in ringing state,
use the
showvoiceregisterpoolringingcommand in privileged EXEC mode.

showvoiceregisterpoolringing [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

Examples

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

show voice
register pool telephone-number

To display the
details of a phone line with a specific telephone-number, use the
showvoiceregisterpooltelephone-numbercommand in privileged EXEC mode.

showvoiceregisterpooltelephone-numbernumber

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

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

show voice register pool unregistered

To display the details of the voice registration pools that do not
have any phones registered, use the
showvoiceregisterpoolunregisteredcommand in privileged EXEC mode.

showvoiceregisterpoolunregistered

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

Examples

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

The following
table contains descriptions of significant fields shown in this output, listed
in alphabetical order.

Table 52 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.

Syntax Description

(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
showvoiceregisterstatisticscommand, 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

Examples

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

Command Modes

Command History

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
showvoiceregistertemplate 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
showvoiceregistertemplate 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
showvoiceregistertemplate command displaying information for a
voice register template:

The following
is a sample output from the
showvoiceregistertemplate 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.

The following
table contains descriptions of significant fields shown in this output, listed
in alphabetical order.

Table 56 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
createprofilecommand.

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 thefiletextcommand.

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
createprofilecommand.

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 thefiletextcommand.

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
createprofilecommand.

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 thefiletextcommand.

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
createprofilecommand.

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
createprofilecommand.

Related Commands

Description

createprofile(voiceregisterglobal)

Generates the configuration profiles required for SIP phones.

reset(voiceregisterdn)

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

reset(voiceregisterpool)

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