13-Voice Command Reference

HomeSupportResource CenterReference GuidesCommand ReferencesH3C MSR810 2600 3600 Routers Command References(V7)-R0707-6W30113-Voice Command Reference
03-Dial program commands
Title Size Download
03-Dial program commands 100.74 KB

Dial program commands

The following compatibility matrix shows the support of hardware platforms for dial programs:

 

Hardware

Dial program 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 number substitution

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 dial programs, some device models require the Voice Software License. For more information, see license management in Fundamentals Configuration Guide.

caller-group

Use caller-group to configure a voice entity to permit or deny calls from numbers in a subscriber group.

Use undo caller-group to remove the configuration.

Syntax

caller-group { deny | permit } group-id

undo caller-group { { deny | permit } group-id | all }

Default

A voice entity permits all calling numbers.

Views

POTS entity view

VoIP enti‌ty view

IVR entity view

Predefined user roles

network-admin

Parameters

deny: Denies calls from numbers in a subscriber group.

permit: Permits calls from numbers in a subscriber group.

group-id: Specifies a subscriber group by its ID in the range of 1 to 2147483647.

all: Specifies all subscriber groups.

Examples

# Configure VoIP entity 1 to permit calls from numbers in subscriber group 1.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] caller-group permit 1

Related commands

subscriber-group

caller-permit

Use caller-permit to configure a voice entity to permit calling numbers.

Use undo caller-permit to remove the configuration.

Syntax

caller-permit caller-string

undo caller-permit { caller-string | all }

Default

A voice entity permits all calling numbers.

Views

POTS entity view

VoIP entity view

IVR entity view

Predefined user roles

network-admin

Parameters

all: Specifies all the configured calling numbers.

caller-string: Specifies a string of 1 to 31 characters in the format of { [ + ] string [ $ ] }| $. The voice entity uses the string to match calling numbers. The following describes the symbols in the format:

·     Plus sign (+): If the plus sign (+) is at the beginning of the string, the string indicates an E.164 standard number. For example, +110022 indicates that 110022 is an E.164 standard number.

·     Dollar sign ($): Can be used only at the end of the string. The calling number must exactly match the portion of the string before the dollar sign. When the string contains only a dollar sign ($), the permitted calling number is null. If the string has no dollar sign, the calling numbers starting with the string are permitted. For example, the caller-permit 20 command permits all calling numbers starting with 20.

·     string: Consists of characters that can include digits 0 through 9, and pound sign (#), asterisk (*), dot (.), exclamation point (!), plus sign (+), percent sign (%), brackets ([ ]), parentheses (()), and hyphen (-). Brackets ([ ]) or parentheses (( )) each are two characters, and any other symbol is one character.

Table 1 Description of characters in a string

Character

Description

0-9

Digits 0 through 9.

Pound sign (#) or asterisk (*)

Indicates a valid digit.

Dot (.)

Wildcard, which can match any valid digit. For example, 555…. can match any 7-digit number beginning with 555.

Exclamation point (!)

Indicates that the preceding subexpression appears zero or one time. For example, 56!1234 can match 51234 and 561234.

Plus sign (+)

Indicates that the preceding subexpression appears one or more times. For example, 9876(54)+ can match 987654, 98765454, 9876545454, and so on.

Percent sign (%)

Indicates that the preceding subexpression appears zero or more times. For example, 9876(54)% can match 9876, 987654, 98765454, 9876545454, and so on.

Hyphen (-)

Connects two digits to indicate a range of numbers, for example, [1-9] indicates 1 to 9 inclusive.

The hyphen (-) can appear only in brackets ([ ]).

Brackets ([ ])

Indicates a range. Only numbers 0 through 9 are allowed in the range. For example, [1-36] matches 1, 2, 3, or 6.

Parentheses (( ))

Indicates a string of characters. For example, (123) indicates the character string 123. It is usually used together with signs such as exclamation point (!), percent sign (%), and plus sign (+). For example, 408(12)+ can match the character string 40812 or 408121212, but not 408 (that is, the string 12 must appear a minimum of one time).

 

 

NOTE:

·     An exclamation point (!), plus sign (+), or percent sign (%) must follow a valid digit or digit string.

·     To use brackets ([ ]) and parentheses (( )) together, use them in the form of "( [ ] )". The "( ( ) )", "[ [ ] ]", and "[ ( ) ]" forms are not allowed.

 

Usage guidelines

You can configure a maximum of 32 permitted calling numbers for a voice entity.

Examples

# Configure VoIP entity 2 to permit calls from number 1000 and from numbers starting with 20.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 2 voip

[Sysname-voice-dial-entity2] caller-permit 1000$

[Sysname-voice-dial-entity2] caller-permit 20

description

Use description to configure a description for a subscriber group.

Use undo description to restore the default.

Syntax

description text

undo description

Default

No description is configured for a subscriber group.

Views

Subscriber group view

Predefined user roles

network-admin

Parameters

text: Specifies a description, a case-sensitive string of 1 to 80 characters.

Examples

# Configure a description of international for subscriber group 10.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] subscriber-group 10

[Sysname-voice-dial-group10] description international

dial-prefix

Use dial-prefix to configure a dial prefix for a POTS entity.

Use undo dial-prefix to restore the default.

Syntax

dial-prefix string

undo dial-prefix

Default

No dial prefix is configured for a POTS entity.

Views

POTS entity view

Predefined user roles

network-admin

Parameters

string: Specifies a dial prefix, a string of 1 to 31 characters. Valid characters are digits 0 through 9, comma (,), pound sign (#), and asterisk (*).

Table 2 Description of characters in the string argument

Character

Description

0-9

Digits 0 through 9.

Comma (,)

One comma represents a pause of 500 milliseconds and it can be positioned anywhere in a number.

Pound sign (#) or asterisk (*)

Indicates a valid digit.

 

Usage guidelines

After you configure a dial prefix, the device adds the prefix before each called number. If the called number exceeds 31 digits, the device sends only the first 31 digits.

Examples

# Specify a dial prefix of 0 for POTS entity 3.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 3 pots

[Sysname-voice-dial-entity3] dial-prefix 0

Related commands

match-template

dial-program

Use dial-program to enter dial program view.

Use undo dial-program to remove all the settings from dial program view.

Syntax

dial-program

undo dial-program

Views

Voice view

Predefined user roles

network-admin

Examples

# Enter dial program view.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

dot-match

Use dot-match to configure a dot match rule.

Use undo dot-match to restore the default.

Syntax

dot-match { end-only | left-right | right-left }

undo dot-match

Default

The dot match rule is end-only.

Views

Number-substitute view

Predefined user roles

network-admin

Parameters

end-only: Matches the digits that correspond to the ending dots (.) in the input template.

left-right: Matches from left to right the digits that correspond to the dots in the input template. The number of matching digits is the number of dots in the output template.

right-left: Matches from right to left the digits that correspond to the dots in the input template. The number of matching digits is the number of dots in the output template.

 

 

NOTE:

The input and output templates are configured using the rule command.

 

Usage guidelines

The dots here are virtual match digits. Virtual match digits refer to those matching the variable part such as dot (.), plus sign (+), percent sign (%), exclamation point (!), and brackets ([]) in a regular expression. For example, when 1255 is matched with the regular expression 1[234]55, the virtual match digit is 2, when matched with the regular expression 125+, the virtual match digit is 5, and matched with the regular expression 1..5, the virtual match digits are 25.

Examples

# Set the dot match rule to right-left for number substitution rule list 20.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] number-substitute 20

[Sysname-voice-dial-substitute20] dot-match right-left

Related commands

rule

entity hunt

Use entity hunt to configure a voice entity selection order.

Use undo entity hunt to restore the default.

Syntax

entity hunt hunt-number

undo entity hunt

Default

The hunt-number is 0.

Views

Dial program view

Predefined user roles

network-admin

Parameters

hunt-number: Specifies a hunt number in the range of 0 to 7. A hunt number corresponds to a voice entity selection order that includes selection rules.

0: Specifies longest match, voice entity priority, random selection.

1: Specifies longest match, voice entity priority, least recent use.

2: Specifies voice entity priority, longest match, random selection.

3: Specifies voice entity priority, longest match, least recent use.

4: Specifies least recent use, longest match, voice entity priority.

5: Specifies least recent use, voice entity priority, longest match.

6: Specifies random selection.

7: Specifies least recent use.

Table 3 Selection rules

Selection rule

Description

Longest match

Selects the voice entity that matches (from left to right) the most digits of the dialed number.

Voice entity priority

Selects the voice entity with the highest priority (configured by using the priority command).

Random selection

Selects a voice entity in a random manner.

Least recent use

Selects the voice entity that has waited for the longest time since being last selected.

 

Usage guidelines

If the first rule matches multiple voice entities, the second rule applies, and so on.

Examples

# Specify the voice entity selection order determined by hunt number 3.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity hunt 3

Related commands

priority

first-rule

Use first-rule to configure the preferred number substitution rule.

Use undo first-rule to restore the default.

Syntax

first-rule id

undo first-rule

Default

No preferred number substitution rule exists.

Views

Number-substitute view

Predefined user roles

network-admin

Parameters

id: Specifies the preferred number substitution rule by its ID in the range of 0 to 31.

Usage guidelines

The system first uses the preferred number substitution rule to match the number. If the match fails or the preferred number substitution rule is not configured, the system uses other rules in the order of sequence numbers.

Examples

# Specify rule 4 in number substitution list 20 as the preferred number substitution rule.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] number-substitute 20

[Sysname-voice-dial-substitute20] rule 4 663 3

[Sysname-voice-dial-substitute20] first-rule 4

Related commands

rule

match-template

Use match-template to configure a calling number match template for a subscriber group.

Use undo match-template to delete calling number match templates for a subscriber group.

Syntax

match-template match-string

undo match-template { match-string | all }

Default

No calling number match templates are configured for a subscriber group.

Views

Subscriber group view

Predefined user roles

network-admin

Parameters

all: Specifies all calling number match templates.

match-string: Specifies a calling number match string of 1 to 31 characters in the format of { [ + ] string [ $ ] }| $. The following describes the characters in the format:

·     Plus sign (+): If the plus sign (+) is at the beginning of the string, the string indicates an E.164 standard number. For example, +110022 indicates that 110022 is an E.164 standard number.

·     Dollar sign ($): Can be used only at the end of the string. The calling number must exactly match the portion of the string before the dollar sign. When the string contains only a dollar sign ($), the permitted calling number is null. If the string has no dollar sign, the calling numbers starting with the string are permitted. For example, the match-template 20 command permits all calling numbers starting with 20.

·     string: Consists of characters that can include digits 0 through 9, and pound sign (#), asterisk (*), dot (.), exclamation point (!), plus sign (+), percent sign (%), brackets ([ ]), parentheses (()), and hyphen (-). Brackets ([ ]) or parentheses (( )) each are two characters, and any other symbol is one character.

Table 4 Description of characters in a string

Character

Description

0-9

Digits 0 through 9.

Pound sign (#) or asterisk (*)

Indicates a valid digit.

Dot (.)

Wildcard, which can match any valid digit. For example, 555…. can match any 7-digit number beginning with 555.

Exclamation point (!)

Indicates that the preceding subexpression appears zero or one time. For example, 56!1234 can match 51234 and 561234.

Plus sign (+)

Indicates that the preceding subexpression appears one or more times. For example, 9876(54)+ can match 987654, 98765454, 9876545454, and so on.

Percent sign (%)

Indicates that the preceding subexpression appears zero or more times. For example, 9876(54)% can match 9876, 987654, 98765454, 9876545454, and so on.

Hyphen (-)

Connects two digits to indicate a range of numbers, for example, [1-9] indicates 1 to 9, inclusive.

The hyphen (-) can appear only in brackets ([ ]).

Brackets ([ ])

Indicates a range. Only numbers 0 through 9 are allowed in the range. For example, [1-36] matches 1, 2, 3, or 6.

Parentheses (( ))

Indicates a string of characters. For example, (123) indicates the character string 123. It is usually used together with signs such as exclamation point (!), percent sign (%), and plus sign (+). For example, 408(12)+ can match the character string 40812 or 408121212, but not 408 (the string 12 must appear a minimum of one time).

 

 

NOTE:

·     An exclamation point (!), plus sign (+), or percent sign (%) must follow a valid digit or digit string.

·     To use brackets ([ ]) and parentheses (( )) together, use them in the form of "( [ ] )". The "( ( ) )", "[ [ ] ]", and "[ ( ) ]" forms are not allowed.

 

Examples

# Configure the calling number match template 1… for subscriber group 2 to match 4-digit calling numbers starting with 1.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] subscriber-group 2

[Sysname-voice-dial-group2] match-template 1…

max-conn

Use max-conn to set the maximum number of calls allowed by a voice entity.

Use undo max-conn to restore the default.

Syntax

max-conn max-number

undo max-conn

Default

The number of calls allowed by a voice entity is not limited.

Views

POTS entity view

VoIP entity view

IVR entity view

Predefined user roles

network-admin

Parameters

max-number: Specifies the maximum number of calls allowed by a voice entity, in the range of 0 to 120.

Examples

# Set the maximum number of calls allowed by VoIP entity 10 to 5.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 10 voip

[Sysname-voice-dial-entity10] max-conn 5

number-match

Use number-match to configure a global number match mode.

Use undo number-match to restore the default.

Syntax

number-match { longest | shortest }

undo number-match

Default

Shortest match is used.

Views

Dial program view

Predefined user roles

network-admin

Parameters

longest: Specifies longest match.

shortest: Specifies shortest match.

Examples

# Specify longest match.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] number-match longest

Related commands

terminator

number-substitute

Use number-substitute to create a number substitution rule list and enter its view, or enter the view of an existing number substitution rule list.

Use undo number-substitute to delete number substitution rule lists.

Syntax

number-substitute list-number

undo number-substitute { list-number | all }

Default

No number substitution rule lists exist.

Views

Dial program view

Predefined user roles

network-admin

Parameters

list-number: Specifies an ID for the number substitution rule list, in the range of 1 to 2147483647.

all: Specifies all number substitution rule lists.

Examples

#Create a number substitution rule list and enter number-substitute view.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] number-substitute 1

[Sysname-voice-dial-substitute1]

priority

Use priority to set a priority for a voice entity.

Use undo priority to restore the default.

Syntax

priority priority

undo priority

Default

The priority for a voice entity is 0.

Views

POTS entity view

VoIP entity view

IVR entity view

Predefined user roles

network-admin

Parameters

priority: Specifies a priority in the range of 0 to 10. The smaller the value, the higher the priority.

Usage guidelines

If a number matches multiple voice entities, the device selects the voice entity with the highest priority.

Examples

# Set the priority to 5 for POTS entity 10.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 10 pots

[Sysname-voice-dial-entity10] priority 5

private-line

Use private-line to configure private line auto ring-down (PLAR).

Use undo private-line to disable PLAR.

Syntax

private-line string

undo private-line

Default

PLAR is disabled.

Views

FXS/FXO/E&M interface view

Digital voice interface view

Predefined user roles

network-admin

Parameters

string: Specifies the called number, which is a string of 1 to 31 characters that can include digits 0 through 9, asterisk (*), and pound sign (#).

Usage guidelines

PLAR enables the subscriber line to automatically call the specified called number when the phone goes off-hook.

Examples

# Enable PLAR for the called number 1000.

<Sysname> system-view

[Sysname] subscriber-line2/1/1

[Sysname-subscriber-line2/1/1] private-line 1000

rule

Use rule to configure a number substitution rule.

Use undo rule to remove number substitution rules.

Syntax

rule id input-template output-template [ number-type input-number-type output-number-type | numbering-plan input-numbering-plan output-numbering-plan ] *

undo rule { id | all }

Default

No number substitution rules exist.

Views

Number-substitute view

Predefined user roles

network-admin

Parameters

all: Specifies all number substitution rules.

id: Specifies an ID for the substitution rule, in the range of 0 to 31.

input-template: Configures an input template of 1 to 31 characters in the format of [ ^ ] [ + ] string [ $ ]. The following describes the signs in the format:

·     Caret (^): Indicates the match begins with the first character of the string.

·     Plus sign (+): If the plus sign (+) is at the beginning of the string, the string indicates an E.164 standard number.

·     Dollar sign ($): Indicates that the last digit of a number must match the last character of the string.

·     string: Consists of characters that can include digits 0 through 9, and pound sign (#), asterisk (*), dot (.), exclamation point (!), and percent sign (%).

Table 5 Description of characters in a string

Character

Meaning

0-9

Digits from 0 through 9.

Pound sign (#) or asterisk (*)

Indicates a valid digit.

Dot (.)

Wildcard, which can match any valid digit. For example, 555…. can match any 7-digit number beginning with 555.

Exclamation point (!)

Indicates that the preceding subexpression appears zero or one time. For example, 56!1234 can match 51234 and 561234.

Percent sign (%)

Indicates that the preceding subexpression appears zero or more times. For example, 9876(54)% can match 9876, 987654, 98765454, 9876545454, and so on.

 

 

NOTE:

An exclamation point (!) or percent sign (%) must follow a valid digit or digit string.

 

output-template: Configures an output template, which is a string of 1 to 31 characters that can include digits 0 through 9, pound sign (#), asterisk (*), plus sign (+) and dot (.). The first character can be a plus sign (+). Table 5 describes these characters.

number-type: Specifies input and output number types.

input-template-type: Specifies an input number type. Table 6 describes the values for this argument.

Table 6 Input number types

Number type

Description

abbreviated

Abbreviated number.

any

Any number.

international

International number.

national

National number that is not in the local network.

network

Service network number.

reserved

Reserved number.

subscriber

Local network number.

unknown

Number of an unknown type.

 

output-template-type: Specifies an output number type. Table 7 describes the values for this argument.

Table 7 Output number types

Number type

Description

abbreviated

Abbreviated number.

international

International number.

national

National number that is not in the local network.

network

Service network number.

reserved

Reserved number.

subscriber

Local network number.

unknown

Number of an unknown type.

 

numbering-plan: Specifies input and output numbering plans.

input-numbering-plan: Specifies an input numbering plan. Table 8 describes the values for this argument.

Table 8 Input numbering plans

Numbering plan

Description

any

Any numbering plan.

data

Data numbering plan.

isdn

ISDN telephone numbering plan.

national

National numbering plan.

private

Private numbering plan.

reserved

Reserved numbering plan.

telex

Telex numbering plan.

unknown

Unknown numbering plan.

 

output-numbering-plan: Specifies an output numbering plan. Table 9 describes the values for this argument.

Table 9 Output numbering plans

Numbering plan

Description

data

Data numbering plan.

isdn

ISDN telephone numbering plan.

national

National numbering plan.

private

Private numbering plan.

reserved

Reserved numbering plan.

telex

Telex numbering plan.

unknown

Unknown numbering plan.

 

Usage guidelines

The following describes the functions of dots in the input-template and output-template arguments:

·     Dots in the output-template argument are invalid if the dot match rule is end-only.

If you set the dot match rule to end-only by using the dot-match command, the dots in the output-template argument are invalid. The digits matching the dots at the end of the input template are added to the end of the output number.

For example, suppose you configure the following commands on the calling router where number substitution has been configured for called numbers:

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] number-substitute 1

[Sysname-voice-dial-substitute1] dot-match end-only

[Sysname-voice-dial-substitute1] rule 0 ^..10...$ ...267410.

If you dial the number 9810765, the number that matches the input template is 765, and the output number is 267410765.

·     Extra dots in the output-template argument are discarded.

·     If you set the dot match rule to right-left or left-right by using the dot-match command, and the output template has more dots than the input template, all digits matching the dots in the input template replace the corresponding dots in the output template from left to right, and the remaining dots in the output template are discarded.

For example, suppose you configure the following commands on the calling router where number substitution has been configured for called numbers:

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] number-substitute 1

[Sysname-voice-dial-substitute1] dot-match right-left

[Sysname-voice-dial-substitute1] rule 0 ^..10...$ ..267410..

If you dial the number 9810765, the number that matches the input template is 8765, and the output number is 8726741065.

Examples

# Configure a number substitution rule for number substitution rule list 1. The input template is ^..01...$, and the output template is ...1.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] number-substitute 1

[Sysname-voice-dial-substitute1] rule 0 ^..01...$ ...1

Related commands

dot-match

first-rule

substitute (Voice dial-program view)

substitute (Voice entity view/Voice subscriber-line view)

send-number

Use send-number to configure the number sending mode.

Use undo send-number to restore the default.

Syntax

send-number { digit-number | all | truncate }

undo send-number

Default

The truncate mode is used.

Views

POTS entity view

Predefined user roles

network-admin

Parameters

digit-number: Specifies the number of digits (extracted from the end of a number) to be sent, in the range of 0 to 31. It must be no greater than the total number of digits in the called number.

all: Sends all the digits of a called number.

truncate: Sends a truncated called number. When the match-template command configured on the voice entity contains dots (.), only the digits that match the dots are sent.

Examples

# Configure POTS entity 10 to send all the digits of called numbers.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 10 pots

[Sysname-voice-dial-entity10] send-number all

Related commands

match-template

subscriber-group

Use subscriber-group to create a subscriber group and enter its view, or enter the view of an existing subscriber group.

Use undo subscriber-group to delete subscriber groups.

Syntax

subscriber-group group-id

undo subscriber-group { group-id | all }

Default

No subscriber groups exist.

Views

Dial program view

Predefined user roles

network-admin

Parameters

group-id: Specifies a subscriber group ID in the range of 1 to 2147483647.

all: Specifies all subscriber groups.

Usage guidelines

You can create a maximum of 10 subscriber groups.

Examples

# Create subscriber group 1 and enter its view.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] subscriber-group 1

[Sysname-voice-dial-group1]

substitute (voice entity view, voice interface view)

Use substitute to apply a number substitution rule list to the calling or called numbers on a voice entity or a voice interface.

Use undo substitute to remove the application.

Syntax

substitute { called | calling } list-number

undo substitute { called | calling }

Default

No number substitution rule list is applied to a voice entity (the voice entity does not perform number substitution).

Views

POTS/VoIP/IVR entity view

Voice interface view

Predefined user roles

network-admin

Parameters

called: Applies the number substitution rule to called numbers.

calling: Applies the number substitution rule to calling numbers.

list-number: Specifies a number substitution rule list by its number in the range of 1 to 2147483647.

Examples

# Apply number substitution rule list 6 to called numbers on POTS entity 10.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 10 pots

[Sysname-voice-dial-entity10] substitute called 6

# Apply number substitution rule list 6 to called numbers on voice interface 2/1/1.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] subscriber-line2/1/1

[Sysname-voice-line2/1/1] substitute called 6

Related commands

number-substitute

rule

substitute (dial program view)

Use substitute to apply a number substitution rule list to the calling or called numbers of incoming or outgoing calls.

Use undo substitute to remove the application.

Syntax

substitute { incoming-call | outgoing-call } { called | calling } list-number

undo substitute { incoming-call | outgoing-call } { called | calling } { list-number | all }

Default

No number substitution rule list is applied (no number substitution is performed).

Views

Dial program view

Predefined user roles

network-admin

Parameters

incoming-call: Applies the number substitution rule list to incoming calls.

outgoing-call: Applies the number substitution rule list to outgoing calls.

called: Applies the number substitution rule list to called numbers.

calling: Applies the number substitution rule list to calling numbers.

all: Specifies all number substitution rule lists.

list-number: Specifies a number substitution rule list by its number in the range of 1 to 2147483647.

Usage guidelines

You can apply a maximum of 32 number substitution rule lists.

Examples

# Apply number substitution rule list 5 to the called numbers of incoming calls.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] substitute incoming-call called 5

# Apply number substitution rule lists 5, 6, and 8 to the called numbers of outgoing calls.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] substitute outgoing-call called 5

[Sysname-voice-dial] substitute outgoing-call called 6

[Sysname-voice-dial] substitute outgoing-call called 8

Related commands

number-substitute

rule

terminator

Use terminator to configure a dial terminator.

Use undo terminator to restore the default.

Syntax

terminator character

undo terminator

Default

No dial terminator is configured.

Views

Dial program view

Predefined user roles

network-admin

Parameters

character: Specifies a dial terminator, a single character that can be a digit, pound sign (#), or asterisk (*).

Usage guidelines

The dial terminator identifies the end of a number. The device immediately places a call upon receiving the dial terminator.

Do not configure a character included in a called number as a dial terminator.

Examples

# Specify the pound sign (#) as the dial terminator.

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] terminator #