Cisco ATA188-I2-A Administration Guide - Page 129

Dial Plan Commands, Dial Plan Rules

Page 129 highlights

Chapter 5 Parameters and Defaults Dial Plan Parameters • Dial Plan Commands, page 5-53 • Dial Plan Rules, page 5-54 • Dial Plan Examples, page 5-58 Dial Plan Commands The following list contains commands that can be used to create you own dial plans: • . -Wildcard, match any digit entered. • - -Additional digits can be entered. This command can be used only at the end of a dial plan rule (for example, 1408t5- is legal usage of the - command, but 1408t5-3... is illegal). • [ ]-Range, which means to match any single digit in the list. Use an underscore ( _ ) to indicate a range of digits. For example, [135] matches the digits 1, 3, and 5. Also, [1_5] matches the digits 1, 2, 3, 4 and 5. The pound key (#) and asterisk (*) are not allowed in the Range command. Also, the Repeat (rn) command does not apply to range, and range cannot include the Subrule matching command. • (subrule0| subrule1| ...|subruleN)-Subrule matching. Using the ( ) and | operators allows you to specify multiple subrules within a dial plan rule so that a subrule match is reached if the entered digits fit one of the subrules. This can be used to reduce the length of the desired dial plan rule by concatenating the group of the subrules with the common rule. For example, a dial plan rule of (1900|1800|17..)555.r3 or three dial plan rules of 1900555.r3|1800555.r3|17..555.r3 are equivalent. A match is reached if 11 digits are entered and the first three digits are either 1900, 1800, or 17..., and the fifth, sixth, and seventh digits are all 5. • >#-Defines the # character as a termination character. When the termination character is entered, the dial string is automatically sent. The termination character can be entered only after at least one user-entered digit matches a dial plan rule. Alternatively, the command >* can be used to define * as the termination character. • tn- Defines the timeout value n, in the unit of seconds, for the interdigit timer. Valid values are 0-9 and a-z, where a-z indicates a range of 10 to 35. • rn-Repeat the last pattern n times, where n is 0-9 or a-z. The values a-z indicate a range of 10 to 26. Use the repeat modifier to specify more rules in less space. Note The commands ># and tn are modifiers, not patterns, and are ignored by the rn command. • |-Used to separate multiple dial plan rules. • ^-Logical not. Match any character except the character immediately following the ^ command. The ^ command can also be used as a negation instruction before the range or subrule matching commands. • S-Seize rule matching. If a dial plan rule matches the sequence of digits entered by the user to this point, and the modifier S is the next command in the dial plan rule, all other rules are negated for the remainder of the call (for example, a dial plan beginning with *S will be the only one in effect if the user first enters the * key). Note All rules apply in the order listed (whichever rule is completely matched first will immediately send the dial string). OL-4804-01 Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator's Guide for H.323 (version 3.0) 5-53

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274

5-53
Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator’s Guide for H.323 (version 3.0)
OL-4804-01
Chapter 5
Parameters and Defaults
Dial Plan Parameters
Dial Plan Commands, page 5-53
Dial Plan Rules, page 5-54
Dial Plan Examples, page 5-58
Dial Plan Commands
The following list contains commands that can be used to create you own dial plans:
.
—Wildcard, match any digit entered.
-
—Additional digits can be entered. This command can be used only at the end of a dial plan rule
(for example, 1408t5- is legal usage of the - command, but 1408t5-3... is illegal).
[ ]—Range, which means to match any single digit in the list. Use an underscore ( _ ) to indicate a
range of digits. For example, [135] matches the digits 1, 3, and 5. Also, [1_5] matches the digits 1,
2, 3, 4 and 5. The pound key (#) and asterisk (*) are not allowed in the Range command. Also, the
Repeat (rn) command does not apply to range, and range cannot include the Subrule matching
command.
(subrule0| subrule1| ...|subruleN)—Subrule matching. Using the
( )
and
|
operators allows you to specify
multiple subrules within a dial plan rule so that a subrule match is reached if the entered digits fit one of
the subrules. This can be used to reduce the length of the desired dial plan rule by concatenating the group
of the subrules with the common rule.
For example, a dial plan rule of (1900|1800|17..)555.r3 or three dial plan rules of
1900555.r3|1800555.r3|17..555.r3 are equivalent. A match is reached if 11 digits are entered and the first
three digits are either 1900, 1800, or 17..., and the fifth, sixth, and seventh digits are all 5.
>#—Defines the # character as a termination character. When the termination character is entered,
the dial string is automatically sent. The termination character can be entered only after at least one
user-entered digit matches a dial plan rule. Alternatively, the command
>*
can be used to define
*
as the termination character.
tn—
Defines the timeout value
n
, in the unit of seconds, for the interdigit timer
.
Valid values are 0-9 and
a-z, where a-z indicates a range of 10 to 35.
rn—Repeat the last pattern n times, where
n
is 0-9 or a-z. The values a-z indicate a range of 10 to
26. Use the repeat modifier to specify more rules in less space.
Note
The commands
>#
and
tn
are modifiers, not patterns, and are ignored by the
rn
command.
|—Used to separate multiple dial plan rules.
^—Logical not. Match any character except the character immediately following the
^
command.
The
^
command can also be used as a negation instruction before the range or subrule matching
commands.
S—Seize rule matching. If a dial plan rule matches the sequence of digits entered by the user to this
point, and the modifier S is the next command in the dial plan rule, all other rules are negated for
the remainder of the call (for example, a dial plan beginning with
*S
will be the only one in effect
if the user first enters the
*
key).
Note
All rules apply in the order listed (whichever rule is completely matched first will immediately send the
dial string).