Call services commands -- 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

mdc-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 services commands -- 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

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

Call services commands -- 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

mdc-admin

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

Call services commands -- 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

mdc-admin

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

Call services commands -- 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

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

Call services commands -- 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

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