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