Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 05-Call services commands | 52.67 KB |
Call services commands
The following compatibility matrix shows the support of hardware platforms for call services:
|
Hardware |
Call service compatibility |
|
MSR810, MSR810-W, MSR810-W-DB, MSR810-LM, MSR810-W-LM, MSR810-10-PoE, MSR810-LM-HK, MSR810-W-LM-HK, MSR810-LMS-EA |
MSR810, MSR810-W, MSR810-W-DB, MSR810-LM, MSR810-W-LM, MSR810-10-PoE, MSR810-LM-HK, MSR810-W-LM-HK: Yes for only call backup MSR810-LMS-EA: No |
|
MSR810-LMS, MSR810-LUS |
No |
|
MSR2600-6-X1 |
No |
|
MSR2600-10-X1 |
Yes |
|
MSR 2630 |
Yes |
|
MSR3600-28, MSR3600-51 |
Yes |
|
MSR3600-28-SI, MSR3600-51-SI |
No |
|
MSR3600-28-X1, MSR3600-28-X1-DP, MSR3600-51-X1, MSR3600-51-X1-DP |
No |
|
MSR3610-I-DP, MSR3610-IE-DP |
No |
|
MSR3610-X1, MSR3610-X1-DP, MSR3610-X1-DC, MSR3610-X1-DP-DC |
Yes |
|
MSR 3610, MSR 3620, MSR 3620-DP, MSR 3640, MSR 3660 |
Yes |
|
MSR3610-G, MSR3620-G |
No |
To support call services, some device models require the Voice Software License. For more information, see license management in Fundamentals Configuration Guide.
call-forwarding
Use call-forwarding to configure call forwarding.
Use undo call-forwarding to delete a call forwarding setting.
Syntax
call-forwarding { on-busy | no-reply | unavailable | unconditional } number number
undo call-forwarding { on-busy | no-reply | unavailable | unconditional }
Default
Call forwarding is disabled.
Views
POTS entity view
Predefined user roles
network-admin
Parameters
on-busy: Enables call forwarding busy.
no-reply: Enables call forwarding no reply.
unavailable: Enables call forwarding unavailable.
unconditional: Enables call forwarding unconditional.
number number: Specifies a forward-to number, a string of 1 to 31 digits (0 through 9).
Usage guidelines
|
|
IMPORTANT: This command takes effect only when an FXS interface is bound to the POTS entity. |
The unconditional, unavailable, on-busy, and no-reply call forwarding types can be configured at the same time. They have a descending order of priority.
Before configuring call forwarding, make sure the initiator can reach the final recipient.
You need to correctly plan forward-to numbers to avoid incorrect numbers and circular calls.
A call can be forwarded a maximum of five times.
Examples
# Enable call forwarding no reply and set the forward-to number to 12345678.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 10 pots
[Sysname-voice-dial-entity10] call-forwarding no-reply number 12345678
# Enable call forwarding busy and set the forward-to number to 12345678.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 10 pots
[Sysname-voice-dial-entity10] call-forwarding on-busy number 12345678
# Enable call forwarding unavailable and set the forward-to number to 12345678.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 10 pots
[Sysname-voice-dial-entity10] call-forwarding unavailable number 12345678
# Enable call forwarding unconditional and set the forward-to number to 12345678.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 10 pots
[Sysname-voice-dial-entity10] call-forwarding unconditional number 12345678
call-hold-format
Use call-hold-format to specify a call hold mode.
Use undo call-hold-format to restore the default.
Syntax
call-hold-format { inactive | sendonly [ moh-number string ] }
undo call-hold-format
Default
The silent mode is used for call hold.
Views
Voice view
Predefined user roles
network-admin
Parameters
inactive: Specifies the silent mode. In this mode, the holding party signals the held party to close the transmit and receive media channels of the held party.
sendonly: Specifies the unidirectional playing mode to play tones or music on hold. In this mode, the holding party opens its transmit media channel and closes its receive media channel.
moh-number string: Specifies an access service number for playing music on hold by a third-party music server, a string of 1 to 31 digits (0 through 9).
Examples
# Specify the unidirectional playing mode for call hold.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] call-hold-format sendonly
display voice mwi
Use display voice mwi to display MWI information for phone numbers with subscription.
Syntax
display voice mwi { all | number number }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all phone numbers with subscription.
number number: Specifies a phone number with subscription, a string of 1 to 31 characters. Valid characters are digits 0 through 9 and plus sign (+).
Examples
# Display MWI information for all phone numbers with subscription.
<Sysname> display voice mwi all
Message Waiting Indication Information:
--------------------------------------------------------------------
MWI type: Solicited
MWI server: 192.168.4.8 port: 5060
MWI expires: 200
---------------------------------------------------------------------
Number: 1515
Messages-Waiting: Yes
Voicemail: 1/3(1/2)
Total: 4(3)
Table 1 Command output
|
Field |
Description |
|
MWI type |
MWI type: Unsolicited or Solicited. |
|
MWI server |
Voice mailbox server, represented by IP address plus port number or domain name. |
|
MWI expires |
Expiration time for the subscription. |
|
Messages-Waiting |
Message waiting identifier: · Yes—There are waiting messages on the voice mail server. · No—There is no waiting message on the voice mail server. |
|
Voicemail |
Number of new messages/number of old messages (number of new urgent messages/ number of old urgent messages). As shown in the above example, Voicemail: 1/3(1/2) indicates that there are 1 new message, 3 old messages, 1 new urgent message, and 2 old urgent messages in the mailbox. |
|
Total |
Total number of normal messages (total number of urgent messages). As shown in the above example, Total: 4(3) indicates that there are 4 normal messages and 3 urgent messages in the mailbox. |
display voice sip subscribe-state
Use display voice sip subscribe-state to display the subscription information for phone numbers.
Syntax
display voice sip subscribe-state
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
You can use this command only when solicited MWI is used.
Examples
# Display subscription information for phone numbers.
<Sysname> display voice sip subscribe-state
Number Server Address Expires Status
--------------------------------------------------------------------------
2233 192.168.4.8:5060 146 online
Table 2 Command output
|
Field |
Description |
|
Number |
Phone number. |
|
Server Address |
Voice mailbox server, represented by IP address plus port number or domain name. |
|
Expires |
Expiration time for the subscription. |
|
Status |
Subscription state of the phone number: · Offline—The subscription fails. · Online—The subscription succeeds. · Logging in—The subscription is in progress. · Logging out—The subscription is being cancelled. |
mwi
Use mwi to enable MWI for an FXS interface.
Use undo mwi to disable MWI for an FXS interface.
Syntax
mwi
undo mwi
Default
MWI is disabled for an FXS interface.
Views
FXS interface view
Predefined user roles
network-admin
Usage guidelines
A voice entity bound to an FXS interface can send SUBSCRIBE messages only after you enable MWI for the FXS interface.
Examples
# Enable MWI for FXS interface 2/1/1.
<Sysname> system-view
[Sysname] subscriber-line 2/1/1
[Sysname-subscriber-line2/1/1] mwi
mwi-server
Use mwi-server to specify a voice mail server.
Use undo mwi-server to restore the default.
Syntax
mwi-server { dns domain-name | ip ip-address } [ port port-number ] [ expires seconds ] [ transport { tcp [ tls ] | udp } ] [ scheme { sip | sips } ] [ unsolicited ]
undo mwi-server
Default
No voice mail server is specified.
Views
SIP view
Predefined user roles
network-admin
Parameters
dns domain-name: Specifies the domain name of the voice mailbox server, which consists of dot-separated strings (for example, aabbcc.com). Each separated string contains no more than 63 characters. A domain name can include case-insensitive letters, digits, hyphens (-), underscores (_), and dots (.), and has a maximum length of 255 characters.
ip ip-address: Specifies the IP address of the voice mailbox server.
port port-number: Specifies the port number of the voice mailbox server, in the range of 1 to 65535. If you specify the ip ip-address option, the default port number is 5060 for UDP and TCP and 5061 for TLS. If you specify the dns domain-name option, you must specify a port number.
expires seconds: Specifies the expiration time of the subscription, in the range of 10 to 72000 seconds. The default is 3600 seconds.
transport: Specifies the transport protocol used for sending SUBSCRIBE messages.
tcp: Specifies TCP as the transport protocol.
tls: Specifies TLS as the transport protocol.
udp: Specifies UDP as the transport protocol. By default, UDP is used
scheme: Specifies a URL scheme to be used during subscription.
sip: Specifies SIP as the URL scheme. By default, SIP is used.
sips: Specifies SIPS as the URL scheme.
unsolicited: Indicates that the SIP UA has subscribed to the voice mail server during registration and can receive NOTIFY messages from the server without sending SUBSCRIBE messages. By default, the SIP UA needs to subscribe to the voice mail server by sending SUBSCRIBE messages before it can receive NOTIFY messages from the server.
Usage guidelines
If TLS is specified as the transport protocol, the port number specified in the mwi-server command must be consistent with the port number configured on the voice mail server.
Examples
# Specify the voice mailbox server with IP address 100.1.1.101 and port number 5060, and set the subscription expiration time to 7200 seconds.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip] mwi-server ip 100.1.1.101 port 5060 expires 7200
