Command Reference

dialer map

To configure a serial interface or ISDN interface to call one or multiple sites, use a form of the dialer map interface configuration command; all options are shown in the first form of the command. To configure serial interfaces or ISDN interfaces to place a call to multiple sites and to authenticate calls from multiple sites, use the second form of the dialer map command. To configure an asynchronous interface to place a call to a single site that has no modem script assigned or that requires a system script, or to multiple sites on a single line, on multiple lines, or on a dialer rotary group, use the third form of the dialer map command. To delete a particular dialer map entry, use a no form of this command.
dialer map protocol next-hop-address [name hostname] [dial-string[:isdn-subaddress]]
[speed 56 | 64] [broadcast] [modem-script modem-regexp] [system-script system-regexp]

no dialer map protocol next-hop-address [name hostname] [dial-string[:isdn-subaddress]]
[speed 56 | 64] [broadcast] [modem-script modem-regexp] [system-script system-regexp]

dialer map protocol next-hop-address [name hostname] [dial-string[:isdn-subaddress]]
[speed 56 | 64] [broadcast]

no dialer map protocol next-hop-address [name hostname] [dial-string[:isdn-subaddress]]
[speed 56 | 64] [broadcast]

dialer map protocol next-hop-address [name hostname] [dial-string] [broadcast]
[modem-script modem-regexp] [system-script system-regexp]

no dialer map protocol next-hop-address [name hostname] [dial-string] [broadcast]
[modem-script modem-regexp] [system-script system-regexp]

Syntax Description

protocol Protocol keyword. See Table 8-3 in the "Usage Guidelines" section for a list of supported protocols and their keywords.

next-hop-address Protocol address used to match against addresses to which packets are destined.

name (Optional) Indicates the remote system with which the local router communicates.

hostname (Optional) Case-sensitive name or ID of the remote device (usually the host name). For routers with ISDN interfaces, if calling line identification (CLI/ANI/caller ID) is provided, the hostname field can contain the number that the calling line ID provides.

dial-string Telephone number sent to the dialing device when it sees packets with the specified next-hop-address that matches the access lists defined.

:isdn-subaddress (Optional) Subaddress number used for ISDN multipoint connections.

broadcast Indicates that broadcasts should be forwarded to this protocol address.

speed 56 | 64 Indicates the line speed to use. Used for ISDN only.

modem-script (Optional) Indicates the modem script to be used for the connection (for asynchronous interfaces).

modem-regexp (Optional) Regular expression to which a modem script is matched (for asynchronous interfaces).

system-script (Optional) Indicates the system script to be used for the connection (for asynchronous interfaces).

system-regexp (Optional) Regular expression to which a system script is matched (for asynchronous interfaces).

Default

No dialer map is configured. The Default speed is 64 kbps. No scripts are defined for placing calls.

Command Mode

Interface configuration

Usage Guidelines

Table 8-3 lists the protocols supported by the dialer map command.

Table 8-3 Dialer Map Command Supported Protocols

Keyword Protocol

appletalk AppleTalk

bridge Bridging

clns ISO CLNS

decnet DECnet

ip IP

ipx Novell IPX

novell Novell IPX

snapshot Snapshot Routing

vines Banyan VINES

xns Xerox Network Services

Synchronous and ISDN Interfaces

Use the dialer map command with the name keyword in configurations in which remote sites are calling a central site, but the central site is not calling the remote site. With this command, the local device authenticates the remote site using CHAP or PAP, which transmits the remote site's host name to the central site. The central site then uses this name to authenticate the caller, and uses the next hop address to transmit packets to the remote site. Because no dialer string is specified, the central site cannot call the remote router.

For ISDN interfaces only, you can specify an optional speed parameter for dialer map commands if you also specify a dial string. This option informs the ISDN software whether it should place a call at 56 or 64 kbps. If you omit the ISDN speed parameter, the Default is 64 kbps.

For routers with ISDN interfaces, if calling line identification (CLI/ANI/caller ID) is provided, the hostname field may contain the number that the calling line ID provides.

Asynchronous Interfaces

Specify chat scripts for a physical interface that is not part of a dialer rotary group if no chat script is specified for the line or if an additional (system) chat script is required for logon to the remote system.

Configure a dialer map command for each remote destination for that interface.

You do not need to specify a system script under the following conditions:

The modem script can be used to dial and log on to the remote system.

You are calling a system that does not require a login script; that is, a system that answers and immediately goes into protocol mode.

If you adhere to the chat script naming convention suggested in this publication, use the form [modem-script *modulation-type] in the dialer map command; for example, ".*-v32bis." This connection allows you to specify the modulation type that is best for the system you are calling, and allows the modem type for the line to be specified by the modem chat-script command.

The period (.) is a wildcard that matches any character, and the asterisk (*) indicates that the preceding character can be duplicated multiple times.

If the modem-script keyword is specified in the dialer map interface configuration command and a modem script is specified in the modem chat-script line configuration command, the first chat script that matches both is used. If no script matches both, an error message is logged and the connection is not established. If no modem chat script is specified for the line, the first chat script (that is, the one specified using the chat-script global configuration command) that matches the modem script regular expression is used. If a system script is specified in the dialer map interface configuration command, the first chat script to match the regular expression is used.

The modem-script and system-script keywords and corresponding arguments are optional. They are ignored on synchronous interfaces.

If you have named your chat script according to the type of modem and modulation (for example, codex-v32 or telebit v32), your regular expression might be codex-.* in the modem chat-script line configuration command, and *-v32bis in the modem script specified in the dialer map command for a system that you wish to connect to using v32bis modulation.

The modem lines (specified by the argument regexp in the modem chat-script line configuration command) would be set to one of the following regular expressions to match patterns, depending on the kind of modem you have:

codex-.*

telebit-.*

usr-.*

With an interface configured for CHAP or PAP with the name hostname keyword and argument pair, the local device authenticates the remote site using CHAP, which transmits the remote site's host name to the central site. The central site then uses this name to authenticate the caller and uses the next hop address to transmit packets to the remote site. Because no dialer string is specified, the central site cannot call the remote router.

For routers with ISDN interfaces, if calling line identification (CLI/ANI/caller id) is provided, the hostname field can contain the number that calling line id provides.

Examples

In the following example, the dialer speed is set at 56 kbps to call a remote site at 131.108.2.5.
interface async 1        
encapsulation ppp
ppp authentication chap
dialer map ip 131.108.2.5 speed 56
  
The following example shows a dialing chat script and a login chat script. The dialer in-band command enables DDR on asynchronous interface 10. The dialer map command searches for the specified dialing and login scripts, and then uses those scripts to dial 96837890.
chat-script dial ABORT ERROR "" "AT Z" OK "ATDT \T" TIMEOUT 30 CONNECT \c        
chat-script login ABORT invalid TIMEOUT 15 name: billw word: wewpass ">"
                "slip Default"
interface async 10
dialer in-band
dialer map ip 10.55.0.1 modem-script dial system-script login 96837890
  
In the following example, the remote site is calling the central site, and the central site is calling the remote site. The central router can use the name ZZZ to authenticate the remote router when they connect and also can use the dialer string 14155553434 to call the remote router if it is not currently connected.
interface async 1        
dialer map ip 131.108.2.5 name ZZZ 14155553434
  
In the following example, a remote site is calling a central site, but the central site is not calling the remote site. The local device uses CHAP to authenticate the site that is calling. CHAP causes the remote site's name, YYY, to be transmitted to the site it is calling. The central site then uses this name to authenticate the remote site.
interface async 1        
encapsulation ppp
ppp authentication chap
dialer map ip 131.108.2.5 name YYY
  

protocol	Protocol keyword. See Table 8-3 in the "Usage Guidelines" section for a list of supported protocols and their keywords.
next-hop-address	Protocol address used to match against addresses to which packets are destined.
name	(Optional) Indicates the remote system with which the local router communicates.
hostname	(Optional) Case-sensitive name or ID of the remote device (usually the host name). For routers with ISDN interfaces, if calling line identification (CLI/ANI/caller ID) is provided, the hostname field can contain the number that the calling line ID provides.
dial-string	Telephone number sent to the dialing device when it sees packets with the specified next-hop-address that matches the access lists defined.
:isdn-subaddress	(Optional) Subaddress number used for ISDN multipoint connections.
broadcast	Indicates that broadcasts should be forwarded to this protocol address.
speed 56 \| 64	Indicates the line speed to use. Used for ISDN only.
modem-script	(Optional) Indicates the modem script to be used for the connection (for asynchronous interfaces).
modem-regexp	(Optional) Regular expression to which a modem script is matched (for asynchronous interfaces).
system-script	(Optional) Indicates the system script to be used for the connection (for asynchronous interfaces).
system-regexp	(Optional) Regular expression to which a system script is matched (for asynchronous interfaces).

Keyword	Protocol
appletalk	AppleTalk
bridge	Bridging
clns	ISO CLNS
decnet	DECnet
ip	IP
ipx	Novell IPX
novell	Novell IPX
snapshot	Snapshot Routing
vines	Banyan VINES
xns	Xerox Network Services