Syntax Description

string

Comment or a description to help you remember what is attached to this interface.

Defaults

No description is added.

Command Modes

Interface configuration

Command History

Release	Modification
9.21	This command was introduced.

Usage Guidelines

The description command is meant solely as a comment to be put in the configuration to help you remember what certain interfaces are used for. The description appears in the output of the following EXEC commands: more nvram:startup-config, show interfaces, and more system:running-config.

Examples

The following example shows how to add a description for a T1 interface:

interface serial 0
 description Fractional T1 line to Mountain View -- 128 kbps

Related Commands

Command	Description
more nvram:startup-config	Displays the startup configuration file contained in NVRAM or specified by the CONFIG_FILE environment variable.
more system:running-config	Displays the running configuration.
show interfaces	Displays statistics for all interfaces configured on the router or access server.

Syntax Description

This command has no arguments or keywords.

Defaults

This feature is not enabled by default.

Command Modes

Interface configuration of a dialer rotary group leader

Command History

Release	Modification
12.0(3)T	This command was introduced.

Usage Guidelines

This command is required for large scale dialout and Layer 2 Tunneling Protocol (L2TP) dial-out functionality.

Examples

The following example shows how to allow a dialer interface access to the AAA server for dialing information:

interface Dialer0
 dialer aaa

The following example shows how to configure the dialer interface and VPDN group on a LAC for L2TP dialout:

interface Dialer2
 ip unnumbered ethernet 0
 encapsulation ppp
 dialer in-band
 dialer aaa
 dialer-group 1
 ppp authentication chap
 
vpdn-group 1 
 accept-dialout
  protocol l2tp
  dialer 2
 terminate-from hostname fishman

Related Commands

Command	Description
accept dialout	Accepts requests to tunnel L2TP dial-out calls and creates an accept-dialout VPDN subgroup.
dialer congestion-threshold	Specifies congestion threshold in connected links.
dialer vpdn	Enables a Dialer Profile or DDR dialer to use L2TP dial-out.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

Examples

The following partial example configures BRI0 with the commands required to make it function as the callback server on the shared network. Callback security is enabled on BRI0, such that any user other than atlanta will be disconnected and not called back.

interface BRI0
 ip address 171.1.1.9 255.255.255.0
 encapsulation ppp
 dialer callback-secure
 dialer enable-timeout 2
 dialer map ip 171.1.1.8 name atlanta class dial1 81012345678901
 dialer-group 1
 ppp callback accept
 ppp authentication chap
!
map-class dialer dial1
 dialer callback-server username

Related Commands

Command	Description
dialer callback-server	Enables an interface to make return calls when callback is successfully negotiated.
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
map-class dialer	Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.
ppp callback (DDR)	Enables a dialer interface that is not a DTR interface to function either as a callback client that requests callback or as a callback server that accepts callback requests.

Syntax Description

username	(Optional) Identifies the return call by looking up the authenticated host name in a dialer map command. This is the default.
dialstring	(Optional) Identifies the return call during callback negotiation.

Defaults

Disabled. The default keyword is username.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Examples

The following partial example configures BRI 0 to function as the callback server on the shared network:

interface BRI0
 ip address 171.1.1.9 255.255.255.0
 encapsulation ppp
 dialer callback-secure
 dialer enable-timeout 2
 dialer map ip 171.1.1.8 name atlanta class dial1 81012345678901
 dialer-group 1
 ppp callback accept
 ppp authentication chap
!
map-class dialer dial1
 dialer callback-server username

Related Commands

Command	Description
dialer callback-secure	Enables callback security.
dialer enable-timeout	Sets the length of time an interface stays down after a call has completed or failed and before the interface is available to dial again.
dialer hold-queue	Allows interesting outgoing packets to be queued until a modem connection is established.
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
map-class dialer	Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.
ppp callback (DDR)	Enables a dialer interface that is not a DTR interface to function either as a callback client that requests callback or as a callback server that accepts callback requests.

Syntax Description

DNIS:subaddress

Dialed Number Identification Service, or the called party number, a colon, and the ISDN subaddress.

Defaults

No default behavior or values.

Command Modes

Dial-on-demand routing

Command History

Release	Modification
12.0(4)T	This command was introduced.

Usage Guidelines

If you have more than one DNIS-plus-ISDN-subaddress number to configure under the same dialer profile interface, you can configure multiple dialer called commands.

The parser accepts a dialer called command with a DNIS and without the subaddress; however, the call will fail. For a successful call, enter the DNIS, a colon, and the ISDN subaddress after the dialer called command.

Examples

The following example configures a dialer profile for a receiver with DNIS 12345 and ISDN subaddress 6789:

dialer called 12345:6789

Related Commands

Command	Description
dialer caller	Configures caller ID screening and, optionally, enables ISDN caller ID callback for legacy DDR or the dialer profiles DDR feature.

Syntax Description

number	Remote telephone number for which to screen. Use a letter X to represent a single "don't care" digit. The maximum length of each number is 25 characters.
callback	(Optional) Enables callback.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command configures the Cisco IOS software to accept calls from the specified number or, used with the callback keyword, to reject incoming calls from the specified number but to initiate callback to the number. This command also helps bind a dialer profile to—and thus configure—the interface used for a call.

When the optional callback keyword is used, the initial call is rejected (hence, not subject to tolls) and callback is initiated to the calling number.

When Xs are used in the callback number, dialer caller screening is based on a best match system that uses the number of Xs as a criterion. To make callback calls only to specified numbers or ranges of numbers but to accept any other incoming calls, make sure that the number of Xs in any configuration line that uses the callback keyword is less than the number of Xs in any configuration line that does not use the keyword.

For example, if you use at most four Xs in the configuration lines with the callback keyword, then to accept calls from other numbers use at least five Xs in a configuration line that does not use the callback keyword.

Note   Caller ID screening requires a local switch that is capable of delivering the caller ID to the router or access server. If you enable caller ID screening but do not have such a switch, no calls will be allowed in.

Examples

In the following example, callback calls will be made only to numbers in the 555 and 556 exchanges, but any other number can call in:

dialer caller 408555xxxx callback
dialer caller 408556xxxx callback
dialer caller xxxxx 

Related Commands

Command	Description
show dialer	Displays general diagnostic information for interfaces configured for DDR.

Syntax Description

links

Number of connected links for congestion threshold in the range 0 to 64000.

Defaults

The default number of connected links is 64000.

Command Modes

Interface configuration

Command History

Release	Modification
12.0(3)T	This command was introduced.

Usage Guidelines

This command is used to force the dialer to search for another uncongested system (the alternate network access server) in a stack group to dial out using Stack Group Bidding Protocol (SGBP).

Examples

The following example sets the congestion threshold to five connected links on the Dialer 0 interface:

interface Dialer0
 dialer aaa
 dialer congestion-threshold 5

Related Commands

Command	Description
dialer reserved-links	Reserves links for dial-in and dial-out.
sgbp dial-bids	Allows the stack group to bid for dial-out connection.

Syntax Description

name	Assigns a name to the DNIS group number.

Defaults

A dialer DNIS group named default.

Command Modes

Global configuration

Command History

Release	Modification
12.0(4)XI	This command was introduced.

Usage Guidelines

Use the dialer dnis group global configuration command to create a DNIS group. This command enables you to create and populate a DNIS group, which is then added to a profile (customer or discriminator) by using the dnis group command within that profile's configuration mode.

Examples

The following example shows a specific DNIS group named modem-group1 being created with the options available for further configuration:

dialer dnis group modem-group1
 
Dialer Called Configuration Commands:
  call-type  set call-type override
  default    Set a command to its defaults
  exit       Exit from dialer configuration mode
  help       Description of the interactive help system
  no         Negate a command or set its defaults
  number     Enter number in dnis group
 

In the following example, a customer profile called isp_1 is created, a DNIS group called dnis_isp_1 is associated with the customer profile, and DNIS numbers 1234 and 5678 are assigned to the DNIS group. Only DNIS numbers 1234 and 5678 are allocated physical resources by the isp_1 customer profile, which counts and manages the resources for these two DNIS numbers and ignores all other DNIS numbers:

resource-pool profile customer isp_1
dnis group dnis_isp_1
exit
dialer dnis group dnis_isp_1
number 1234
number 5678

Related Commands

Command	Description
resource-pool profile	Creates a resource group for RPM.
dnis group	Includes a group of DNIS numbers in a customer profile.

Syntax Description

This command has no arguments or keywords.

Defaults

The reverse DNS function is disabled by default.

Command Modes

Interface configuration of a dialer rotary group leader.

Command History

Release	Modification
12.0(3)T	This command was introduced.

Usage Guidelines

This command allows the dialer to use reverse DNS to get a profile name for accessing the authentication, authorization, and accounting (AAA) server. This command is not required when using named static routes.

Examples

The following example shows how to allow the dialer to use reverse DNS for name lookup:

interface Dialer0
 dialer aaa
 dialer dns

Related Commands

Command	Description
dialer aaa	Allows a dialer to access the AAA server for dialing information.

Syntax Description

This command has no arguments or keywords.

Defaults

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Examples

The following example enables DDR and specifies DTR dialing on an interface:

dialer dtr

Related Commands

Command	Description
dialer in-band	Specifies that DDR is to be supported.
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
dialer string (legacy DDR)	Specifies the destination string (telephone number) to be called for interfaces calling a single site.

Syntax Description

seconds

Time in seconds that the Cisco IOS software waits before the next call can occur on the specific interface. Acceptable values are positive, nonzero integers. This value must be greater than the serial pulse interval for this interface, set via the pulse-time command.

Defaults

15 seconds

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

This command applies to inbound and outbound calls.

If your phone lines are often busy or down, you might want to enforce a certain period of time before the system repeats an attempt to make a connection with a remote site. Configuring this timeout can prevent outgoing lines and switching equipment from being needlessly overloaded.

Examples

The following example specifies a waiting period of 30 seconds on asynchronous interface 1:

interface async 1
 dialer enable-timeout 30

If the line becomes idle for configured length of time, the current call is disconnected immediately and the new call is placed.

If the line has not yet been idle as long as the fast idle timeout period, the packet is dropped because there is no way to get through to the destination. After the packet is dropped, the fast idle timer remains active and the current call is disconnected as soon as it has been idle for as long as the fast idle timeout.

The fast idle timer will be restarted if, in the meanwhile, another packet is transmitted to the currently connected destination and it is classified as interesting.

This command applies to inbound and outbound calls.

Combining this command with the dialer idle-timeout command allows you to configure lines to stay up for a longer period of time when there is no contention, but to be reused more quickly when there are not enough lines for the current demand.

Examples

The following example specifies a fast idle timeout of 35 seconds on asynchronous interface 1:

interface async 1
  dialer fast-idle 35

Related Commands

Command	Description
dialer idle-timeout (interface configuration)	Specifies the idle time before the line is disconnected.
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.

Syntax Description

seconds

Number of seconds to wait before placing a different call.

Defaults

Defaults to the fast idle timer value set for the interface.

Command Modes

Map-class dialer

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Examples

The following example specifies a dialer fast idle time of 10 seconds:

dialer string 4156884540 class Eng
 
! This map-class ensures that these calls use an ISDN speed of 56 kbps and a
! fast-idle time of 10 seconds.
map-class dialer Eng
 isdn speed 56
 dialer fast-idle 10
 dialer wait-for-carrier-time 30

Related Commands

Command	Description
dialer fast-idle (interface configuration)	Specifies the amount of time that a line for which there is contention will stay idle before it is disconnected and the competing call is placed.
dialer wait-for-carrier-time (map-class dialer configuration)	Specifies the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class.
map-class dialer	Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.

Syntax Description

group-number

Number of the dialer access group to which the specific interface belongs. This access group is defined with the dialer-list command. Acceptable values are nonzero, positive integers between 1 and 10.

Defaults

No access is predefined.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

An interface can be associated with a single dialer access group only; multiple dialer-group assignment is not allowed. A second dialer access group assignment will override the first. A dialer access group is defined with the dialer-group command. The dialer-list command associates an access list with a dialer access group.

Packets that match the dialer group specified trigger a connection request.

Examples

The following example specifies dialer access group number 1.

The destination address of the packet is evaluated against the access list specified in the associated dialer-list command. If it passes, either a call is initiated (if no connection has already been established) or the idle timer is reset (if a call is currently connected).

interface async 1
 dialer-group 1
access-list 101 deny igrp 0.0.0.0 255.255.255.255 255.255.255.255 0.0.0.0 
access-list 101 permit ip 0.0.0.0 255.255.255.255 0.0.0.0 255.255.255.255 
dialer-list 1 protocol ip list 101

Related Commands

Command	Description
dialer-list protocol	Defines a DDR dialer list to control dialing by protocol or by a combination of protocol and an access list.

Syntax Description

packets	Number of packets, in the range 0 to 100 packets, to hold in the queue. This argument is optional with the no form of the command.
timeout seconds	Amount of time in seconds to queue the packets.

Defaults

The outgoing packet queue is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

If no hold queue is configured, packets are dropped during the time required to establish a connection.

Examples

The following command configures a dialer hold queue to hold 10 packets:

dialer hold-queue 10

Related Commands

Command	Description
dialer-group	Controls access by configuring an interface to belong to a specific dialing group.

This command applies to inbound and outbound calls. For example, if a receiving system needs to make outgoing calls, you might configure it with a short idle timeout.

Only packets that match the dialer group reset the idle timer.

Examples

The following example specifies of an idle timeout of 3 minutes (180 seconds) on asynchronous interface 1:

interface async 1
 dialer idle-timeout 180

Related Commands

Command	Description
dialer fast-idle (interface configuration)	Specifies the amount of time that a line for which there is contention will stay idle before it is disconnected and the competing call is placed.
dialer-group	Controls access by configuring an interface to belong to a specific dialing group.

Syntax Description

seconds

Idle time, in seconds, that must occur on an interface associated with a map class before calls are disconnected. Acceptable values are positive, nonzero integers.

Defaults

Defaults to a value set for the interface.

Command Modes

Map-class dialer configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

Examples

The following example sets a dialer idle-timeout interval of 180 seconds:

dialer idle-timeout 180

Related Commands

Command	Description
dialer wait-for-carrier-time (map-class dialer configuration)	Specifies the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class.

The parity setting applies to the dialer string that is sent out to the modem. If you do not specify a parity, or if you specify no parity, no parity is applied to the output number. If odd parity is configured, the dialed number will have odd parity (7-bit ASCII characters with the eighth bit as the parity bit.)

If an interface only accepts calls and does not place calls, the dialer in-band interface configuration command is the only command needed to configure it. If an interface is configured in this manner, with no dialer rotary groups, the idle timer never disconnects the line. It is up to the remote end (the end that placed the call) to disconnect the line based on idle time.

Examples

The following example specifies DDR for asynchronous interface 1:

interface async 1
 dialer in-band

Related Commands

Command	Description
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
dialer string (legacy DDR)	Specifies the string (telephone number) to be called for interfaces calling a single site.

Syntax Description

speed speed	(Optional) Bit rate, in kilobytes per second (kbps), used on the ISDN B channel. Values are 56 and 64. Defaults is 64.
spc	(Optional) Specifies that an ISDN semipermanent connection is to be used for calls associated with this map class.

Defaults

Bit rate is 64 kbps. Semipermanent connections are not set up.

Command Modes

Map-class dialer configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command is valid for ISDN interfaces only.

Examples

The following example configures a speed of 56 kbps and no semipermanent connections for the Eng map class:

dialer string 4156884540 class Eng 
 
! This map-class ensures that these calls use an ISDN speed of 56 kbps and that 
! no semipermanent connection is set up.
map-class dialer Eng
dialer isdn speed 56 

Related Commands

Command	Description
dialer wait-for-carrier-time (map-class dialer configuration)	Specifies the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class.

Syntax Description

seconds

Minimum number of seconds of idle time on the line. Defaults is 120 seconds.

Defaults

Disabled; the router uses a static idle timeout. When this command is enabled, the default short-hold timeout is 120 seconds.

Command Modes

Map-class dialer configuration

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

This command is used for configuring ISDN Advice of Charge (AOC) on Cisco routers.

Use the dialer isdn short-hold command if you subscribe to an ISDN AOC during-call service provided by the local ISDN network and want to use this option. The router uses the frequency at which the network sends the AOC-D message to determine the charging period. If the line has been idle for the short-hold timeout, the call disconnects at the end of the charging period. If the line has not been idle for at least that long, the call is maintained into the next charging period.

Examples

dialer map-class Deutschland 
 dialer idle-timeout 150
 dialer isdn short-hold 120

Related Commands

Command	Description
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites, or to receive calls from multiple sites.
dialer string (dialer profiles)	Specifies the string (telephone number) to be used when placing a call from an interface.
dialer wait-for-carrier-time (map-class dialer configuration)	Specifies the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class.
map-class dialer	Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.

Syntax Description

dialer-group	Number of a dialer access group identified in any dialer-group interface configuration command.
protocol-name	One of the following protocol keywords: appletalk, bridge, clns, clns_es, clns_is, decnet, decnet_router-L1, decnet_router-L2, decnet_node, ip, ipx, vines, or xns.
permit	Permits access to an entire protocol.
deny	Denies access to an entire protocol.
list	Specifies that an access list will be used for defining a granularity finer than an entire protocol.
access-list-number	Access list numbers specified in any DECnet, Banyan VINES, IP, Novell IPX, or XNS standard or extended access lists, including Novell IPX extended service access point (SAP) access lists and bridging types. See Table 7 for the supported access list types and numbers.
access-group	Filter list name used in the clns filter-set and clns access-group commands.

Defaults

No dialer lists are defined.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.
10.3	The following keyword and arguments were added: list access-list-number and access-group

Usage Guidelines

The various no forms of this command have the following effects:

• The no dialer-list 1 command deletes all lists configured with list 1, regardless of the keyword previously used (permit, deny, protocol, or list).

• The no dialer-list 1 protocol protocol-name command deletes all lists configured with list 1 and protocol protocol-name.

• The no dialer-list 1 protocol protocol-name list access-list-number command deletes the specified list.

The dialer-list protocol form of this command permits or denies access to an entire protocol. The dialer-list protocol list form of this command provides a finer permission granularity and also supports protocols that were not previously supported.

Examples

Dialing occurs when an interesting packet (one that matches access list specifications) needs to be output on an interface. Using the standard access list method, packets can be classified as interesting or uninteresting. In the following example, IGRP TCP/IP routing protocol updates are not classified as interesting and do not initiate calls:

access-list 101 deny igrp 0.0.0.0 255.255.255.255 255.255.255.255 0.0.0.0

The following example classifies all other IP packets as interesting and permits them to initiate calls:

access-list 101 permit ip 0.0.0.0 255.255.255.255 0.0.0.0 255.255.255.255

Then the following command places list 101 into dialer access group 1:

dialer-list 1 protocol ip list 101
 

In the following example, DECnet access lists allow any DECnet packets with source area 10 and destination area 20 to trigger calls:

access-list 301 permit 10.0 0.1023 10.0 0.1023
access-list 301 permit 10.0 0.1023 20.0 0.1023
 

Then the following command places access list 301 into dialer access group 1:

dialer-list 1 protocol decnet list 301
 

In the following example, both IP and VINES access lists are defined. The IP access lists define IGRP packets as uninteresting, but permits all other IP packets to trigger calls. The VINES access lists do not allow Routing Table Protocol (RTP) routing updates to trigger calls, but allow any other data packets to trigger calls.

access-list 101 deny igrp 0.0.0.0 255.255.255.255 0.0.0.0 255.255.255.255
access-list 101 permit ip 0.0.0.0 255.255.255.255 0.0.0.0 255.255.255.255
!
vines access-list 107 deny RTP 00000000:0000 FFFFFFFF:FFFF 00000000:0000 FFFFFFFF:FFFF
vines access-list 107 permit IP 00000000:0000 FFFFFFFF:FFFF 00000000:0000 FFFFFFFF:FFFF
 

Then the following two commands place the IP and VINES access lists into dialer access group 1:

dialer-list 1 protocol ip list 101
dialer-list 1 protocol vines list 107
 

In the following example, a Connectionless Network Service (CLNS) filter is defined and then the filter is placed in dialer access group 1:

clns filter-set ddrline permit 47.0004.0001....
!
dialer-list 1 protocol clns list ddrline

Related Commands

Command	Description
access-list	Configures the access list mechanism for filtering frames by protocol type or vendor code.
clns filter-set	Builds a list of CLNS address templates with associated permit and deny conditions for use in CLNS filter expressions.
dialer-group	Controls access by configuring an interface to belong to a specific dialing group.
vines access-list	Creates a VINES access list.

Syntax Description

load	Interface load used to determine whether to initiate another call or to drop a link to the destination. This argument represents a utilization percentage; it is a number between 1 and 255, where 255 is 100%.
outbound	(Optional) Calculates the actual load using outbound data only.
inbound	(Optional) Calculates the actual load using inbound data only.
either	(Optional) Sets the maximum calculated load as the larger of the outbound and inbound loads.

Defaults

No maximum load is predefined.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

When the cumulative load of all UP links (a number n) exceeds the load threshold the dialer adds an extra link and when the cumulative load of all UP links minus one (n - 1) is at or below load threshold then the dialer can bring down that one link. The dialer will make additional calls or drop links as necessary but will never interrupt an existing call to another destination.

The load calculation determines how much of the total bandwidth you are using. A load value of 255 means that you are using one hundred percent of the bandwidth. The load number is required.

See the description of the bandwidth command earlier in this guide for more information.

Examples

In the following example, if the load to a particular destination on an interface in dialer rotary group 5 exceeds interface load 200, the dialer will initiate another call to the destination:

interface dialer 5
 dialer load-threshold 200

Related Commands

Command	Description
busy-message	Creates a "host-failed" message that displays when a connection fails.
dialer reserved-links	Includes a specified interface in a dialer rotary group.
interface dialer	Defines a dialer rotary group.

To configure a serial interface or ISDN interface to support bridging, use the third form of the command:

To configure an asynchronous interface to place a call to a single site that requires a system script or that has no assigned modem script, or to multiple sites on a single line, on multiple lines, or on a dialer rotary group, use the fourth form of the dialer map command:

Syntax Description

protocol	Protocol keywords; one of the following: appletalk, bridge, clns, decnet, ip, ipx, novell, snapshot, vines, and xns.
next-hop-address	Protocol address used to match against addresses to which packets are destined. This argument is not used with the bridge protocol keyword.
name	(Optional) Indicates the remote system with which the local router or access server communicates. Used for authenticating the remote system on incoming calls.
hostname	(Optional) Case-sensitive name or ID of the remote device (usually the host name). For routers with ISDN interfaces, if calling line identification—sometimes called CLI, but also known as caller ID and automatic number identification (ANI)—is provided, the hostname field can contain the number that the calling line ID provides.
spc	(Optional) Specifies a semipermanent connection between customer equipment and the exchange; used only in Germany for circuits between an ISDN BRI and a 1TR6 ISDN switch and in Australia for circuits between an ISDN PRI and a TS-014 switch.
speed 56 | speed 64	(Optional) Keyword and value indicating the line speed in kilobits per second to use. Used for ISDN only. The default speed is speed 64 (64 kbps).
broadcast	(Optional) Indicates that broadcasts should be forwarded to this protocol address.
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 will be 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 will be matched (for asynchronous interfaces).
dial-string[:isdn- subaddress]	(Optional) Telephone number sent to the dialing device when it recognizes packets with the specified next hop address that matches the access lists defined, and the optional subaddress number used for ISDN multipoint connections. The dial string and ISDN subaddress, if used, must be the last item in the command line.

Defaults

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

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

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)—also known as caller ID and ANI—is provided, the hostname field may contain the number that calling line ID provides.

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 in 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 the description of the chat-script command, use the form [modem-script *modulation-type] in the dialer map command; for example, *-v32bis. This form 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 script dialer command.

The period (.) is a wildcard that matches any character, and the asterisk (*) indicates that the preceding character can be duplicated multiple times. For more information about regular expressions, see the "Regular Expressions" appendix in this manual.

If a modem script is specified in the dialer map interface configuration command and a modem script specified in the script dialer 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 there is no modem chat script specified for the line, the first chat script (that is, the one specified in the chat-script global configuration command) that matches the modem script's regular expression is used. If there is a system script 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 could be codex-.* in the script dialer 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 V.32bis modulation.

The modem lines (specified by the argument regexp in the script dialer 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 Challenge Handshake Authentication Protocol (CHAP) or Password Authentication Protocol (PAP) and configured 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—also known as caller ID and ANI—is provided, the hostname field can contain the number that calling line ID provides.

Examples

The following example sets the dialer speed 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, and the dialer map command looks for the specified dialing and the 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
 

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
 

interface async 1
  encapsulation ppp
  ppp authentication chap
  dialer map ip 131.108.2.5 name YYY

Related Commands

Command	Description
chat-script	Places calls over a modem and logs in to remote systems.
ppp bap call	Sets PPP BACP call parameters.
virtual-profile aaa	Enables virtual profiles by AAA configuration.

Syntax Description

protocol	Protocol keywords; one of the following: appletalk, bridge, clns, decnet, ip, ipx, novell, snapshot, vines, and xns.
next-hop-address	Protocol address used to match against addresses to which packets are destined. This argument is not used with the bridge protocol keyword.
name hostname	(Optional) Case-sensitive name or ID of the remote device (usually the host name). For routers with ISDN interfaces, if calling line identification—sometimes called CLI, but also known as caller ID and automatic number identification (ANI)—is provided, the hostname field can contain the number that the calling line ID provides.
spc	(Optional) Specifies a semipermanent connection between customer equipment and the exchange; used only in Germany to configure connections between an ISDN BRI and a 1TR6 ISDN switch type.
speed 56 | speed 64	(Optional) Line speed in kilobits per second to use. Used for ISDN only. The default is speed 64 (64 kbps).
broadcast	(Optional) Indicates that broadcasts should be forwarded to this protocol address.
class class-name	Name of the class that configures the ISDN AOC static dialer timeout period or the short-hold timeout period or both.
dial-string[:isdn-subaddress]	(Optional) Telephone number and optional ISDN subaddress used for ISDN multipoint connections that are sent to the dialing device when it recognizes packets with the specified next hop address that matches the access lists defined. The dial string and ISDN subaddress, if used, must be the last item in the command line.

Defaults

No dialer map is configured. The default speed is 64 kbps. No default class name is provided.

Command Modes

Interface configuration

Command History

Release	Modification
9.1	This command was introduced.
11.3	This version of the dialer map command for AOC was introduced.

Usage Guidelines

This form of the dialer map command is used for configuring ISDN Advice of Charge (AOC) on Cisco routers.

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)—also known as caller ID and ANI—is provided, the hostname field may contain the number that calling line ID provides.

Examples

hostname A
!
username c2503isdn password 7 1511021F0725
username B password 7 110A1016141D29
username C password 7 1511021F072508
isdn switch-type basic-net3
!
interface bri 0
 ip address 10.0.0.35 255.0.0.0
 encapsulation ppp
 dialer idle-timeout 150
 dialer map ip 10.0.0.33 name c2503isdn class Iota 06966600050
 dialer map ip 10.0.0.40 name B class Beta 778578 
 dialer map ip 10.0.0.45 name C class Kappa 778579 
 ppp authentication chap
!
map-class dialer Kappa
 dialer idle-timeout 300
 dialer isdn short-hold 10
!         
map-class dialer Iota
 dialer idle-timeout 300
!
map-class dialer Beta
 dialer idle-timeout 300
 dialer isdn short-hold 10

Related Commands

Command	Description
dialer isdn short-hold	Configures the router to disconnect a call at the end of the current charging period if the line has been idle for at least the specified minimum period.
map-class dialer	Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.
ppp bap call	Sets PPP BACP call parameters.
virtual-profile aaa	Enables virtual profiles by AAA configuration.

Syntax Description

protocol	Protocol keywords; one of the following: appletalk, bridge, clns, decnet, ip, ipx, novell, snapshot, vines, and xns.
next-hop-address	Protocol address used to match against addresses to which packets are destined. This argument is not used with the bridge protocol keyword.
name hostname	(Optional) Case-sensitive name or ID of the remote device (usually the host name). For routers with ISDN interfaces, if calling line identification—sometimes called CLI, but also known as caller ID and automatic number identification (ANI)—is provided, the hostname field can contain the number that the calling line ID provides.
spc	(Optional) Specifies a semipermanent connection between customer equipment and the exchange; used only in Germany to configure connections between an ISDN BRI and a 1TR6 ISDN switch type.
speed 56 | speed 64	(Optional) Line speed in kilobits per second to use. Used for ISDN only. The default speed is 64 kbps.
broadcast	(Optional) Indicates that broadcasts should be forwarded to this protocol address.
dial-string[:isdn- subaddress]	(Optional) Telephone number and optional ISDN subaddress used for ISDN multipoint connections that are sent to the dialing device when it recognizes packets with the specified next hop address that matches the access lists defined. The dial string and ISDN subaddress, if used, must be the last item in the command line.

Defaults

No dialer map is configured. The default speed is 64 kbps. No default class name is provided.

Command Modes

Interface configuration

Command History

Release	Modification
9.1	A simple version of this command was introduced for synchronous serial interfaces using V.25bis dialing.

Usage Guidelines

Typically, this implementation is applicable for BRI in Germany only.

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)—also known as caller ID and ANI—is provided, the hostname field may contain the number that calling line ID provides.

Examples

The following example configures the interface for semipermanent connections in Germany; the IP address and the phone number are provided.

dialer map ip 192.36.48.2 spc 49302345655:3789

Related Commands

Command	Description
dialer isdn short-hold	Configures the router to disconnect a call at the end of the current charging period if the line has been idle for at least the specified minimum period.
map-class dialer	Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.
ppp bap call	Sets PPP BACP call parameters.
virtual-profile aaa	Enables virtual profiles by AAA configuration.

Syntax Description

sequence-number	A number in the range from 1 to 254, inclusive, that uniquely identifies a dialer map. (Optional for the no form.)
dial-string	Telephone number of a remote snapshot server to be called during an active period.

Defaults

No snapshot routing dialer map is defined.

Command Modes

Interface configuration

Command History

Release	Modification
10.3	This command was introduced.

Usage Guidelines  

Examples

The following examples define snapshot dialer maps on a client router:

dialer map snapshot 12 4151231234
dialer map snapshot 13 4151231245

The following example removes one of the previously defined snapshot routing dialer maps on the client router:

no dialer map snapshot 13

Related Commands

Command	Description
dialer reserved-links	Includes a specified interface in a dialer rotary group.
interface dialer	Defines a dialer rotary group.
snapshot client	Configures a client router for snapshot routing.

Syntax Description

number

Maximum number of links, in the range 1 through 255. Defaults is 255 links.

Defaults

255 links

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command is used mainly to set a maximum number of links that is below the maximum possible.

Examples

The following example sets a maximum of six links:

dialer max-link 6 

Related Commands

Command	Description
dialer isdn	Specifies the bit rate used on the B channel associated with a specified map class and specifies whether to set up semipermanent connections for this map class.
dialer wait-for-carrier-time (map-class dialer configuration)	Specifies the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class.

Syntax Description

classname

Keyword for a specified AT&T Primary-4ESS NSF dialing plan; the following keywords are supported: sdn, megacomm, and accunet.

Defaults

This command is disabled; no classname is provided.

Command Modes

Map-class dialer configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

Use this command only to define a dialer map class for an NSF call-by-call service offered by AT&T on Primary-4ESS ISDN switches. This command is not used for other vendors and switch types.

Examples

The following partial example shows a class called sdn to support the Software Defined Network (SDN) dialing plan. For a more complete example using all the related commands, see the map-class dialer command.

dialer outgoing sdn

Related Commands

Command	Description
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
dialer voice-call	Configures the dialer map class for an NSF dialing plan to support outgoing voice calls.
isdn nsf-service	Configures NSF on an ISDN PRI for outgoing calls configured as voice calls
map-class dialer	Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.

Syntax Description

number

Dialing pool number, in the range 1 through 255.

Defaults

Disabled. No default number is specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command applies to dialer interfaces only.

Examples

! This is a dialer profile for reaching remote subnetwork 1.1.1.1.
interface Dialer1
 ip address 1.1.1.1 255.255.255.0
 encapsulation ppp
 dialer remote-name Smalluser
 dialer string 4540
 dialer pool 3
 dialer-group 1
 

interface BRI1
 encapsulation ppp
 dialer pool-member 1 priority 50
 dialer pool-member 2 priority 50
!BRI 1 has a reserved channel in dialer pool 3; the channel remains inactive
!until BRI 1 uses it to place calls.
 dialer pool-member 3 min-link 1
 ppp authentication chap

Related Commands

Command	Description
dialer pool-member	Configures a physical interface to be a member of a dialer profiles dialing pool.
dialer wait-for-carrier-time (map-class dialer configuration)	Specifies the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class.

Syntax Description

number	Dialing pool number, in the range 1 through 255.
priority priority	(Optional) Priority of this interface within the dialing pool, in the range 0 (lowest) to 255 (highest). Interfaces with the highest priority are selected first for dialing out. Default is 0.
min-link minimum	(Optional) Minimum number of B channels on this interface that are reserved for this dialing pool, in the range 0 to 255. Default is 0. A reserved channel is inactive until the specified interface uses it to place calls. Applies to ISDN interfaces only.
max-link maximum	(Optional) Maximum number of B channels on this interface that can be used by this dialing pool, in the range 0 to 255. Default is 255. Applies to ISDN interfaces only.

Defaults

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command applies to asynchronous serial, synchronous serial, BRI, and PRI physical interfaces only. It does not apply to dialer interfaces.

The min-link keyword and value are used primarily for dial backup.

Examples

The following example shows the configuration of one ISDN BRI interface to be a member of dialer pool 2 with priority 100:

interface BRI2
 encapsulation ppp
 dialer pool-member 2 priority 100
 ppp authentication chap
 

In the following example, BRI physical interface configuration BRI 1 has a reserved channel in dialer pool 3. That channel is inactive until BRI 1 uses it to place calls.

interface BRI1
 encapsulation ppp
 dialer pool-member 1 priority 50
 dialer pool-member 2 priority 50
!BRI 1 has a reserved channel in dialer pool 3; the channel remains inactive
!until BRI 1 uses it to place calls.
 dialer pool-member 3 min-link 1
 ppp authentication chap

Related Commands

Command	Description
dialer pool	Specifies for a dialer interface, which dialing pool to use to connect to a specific destination subnetwork.

Syntax Description

number

Priority of an interface in a dialer rotary group; the highest number indicates the highest priority. This is a number from 0 through 255. The default value is 0, the lowest priority.

Defaults

No priority is predefined. When priority is defined, the default value is 0.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

The value 0 indicates the lowest priority, and 255 indicates the highest priority. The dialer priority command controls which interfaces within a dialer rotary group will be used first. Higher priority interfaces (configured with higher n value) are used first.

The dialer priority command gives you the ability to tell the dialer rotary group which free interface (and, by extension for asynchronous interfaces, which modem) to use first. This command applies to outgoing calls only.

For example, a router or access server might have a selection of many modems, some of which are better performers than others. You might have a 19.2-kbps, two 4800-bps, three 1200-bps, and one 300-bps modem on interfaces in one dialer rotary group. You do not want the router or access server to make the call on the 300-baud modem if any of the faster modems are free. You want to use the highest-performance modems first, and the slowest modems last.

Examples

In the following example, asynchronous interface 3 will be used after interfaces with higher priority and before interfaces with lower priority:

interface async 3
 dialer priority 5

Related Commands

Command	Description
interface dialer	Defines a dialer rotary group.
dialer reserved-links	Includes a specified interface in a dialer rotary group.

Syntax Description

username

Case-sensitive character string identifying the remote device; maximum length is 255 characters.

Defaults

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command applies only to dialer interfaces.

Examples

The following partial example sets the name of the remote host to dallas:

dialer remote-name dallas

Related Commands

Command	Description
ppp bap call	Sets PPP BACP call parameters.

Syntax Description

dialin-link	Link reserved for dial-in.
dialout-link	Link reserved for dial-out.

Defaults

By default, no links are reserved.

Command Modes

Interface configuration

Command History

Release	Modification
12.0(3)T	This command was introduced.

Examples

The following example sets dial in reserved links to 1 and dialout reserved links to 0 on the Dialer0 interface:

interface Dialer0
 dialer aaa
 dialer reserved-links 1 0

Related Commands

Command	Description
dialer congestion-threshold	Specifies congestion threshold in connected links.
sgbp dial-bids	Allows the stack group to bid for dialout connection.

Syntax Description

number

Number of the previously defined dialer interface in whose rotary group this interface is to be included. This is a number from 0 to 255. The dialer interface is defined by the interface dialer command.

Defaults

No interfaces are included in a dialer rotary group.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Examples

hostname central-site
! PPP encapsulation is enabled for interface dialer 1. 
interface dialer 1
 encapsulation ppp
 dialer in-band
 ip address 131.108.2.1 255.255.255.0
 ip address 131.126.4.1 255.255.255.0 secondary
!
! The first dialer map command allows the central site and remote site YYY
! to call each other and allows the central site to authenticate site YYY
! when it calls in. The second dialer map command, with no dialer string,
! allows the central site to authenticate remote site ZZZ when it calls in, but
! the central site cannot call remote site ZZZ (no phone number).
 dialer map ip 131.108.2.5 name YYY 14155553434
 dialer map ip 131.126.4.5 name ZZZ
!
! The DTR pulse signals for three seconds on the interfaces in dialer 
! group 1. This holds the DTR low so the modem can recognize that DTR has been
! dropped. 
pulse-time 3
!
! Interfaces async 1 and async 2 are placed in dialer rotary group 1. 
! All of the interface configuration commands (the encapsulation and dialer 
! map commands shown earlier in this example) applied to interface 
! dialer 1 apply to the physical interfaces assigned to the dialer group. 
!
interface async 1
 dialer rotary-group 1
interface async 2
 dialer rotary-group 1 

Related Commands

Command	Description
interface dialer	Defines a dialer rotary group.

Syntax Description

priority	Selects the first outbound line with the highest priority; this is the selection criterion that was previously used.
best	Selects the outbound line with the most recent success. If that line also has the most recent failure, then it will try the line with the least recent failure. If that line also has the most recent failure, it will then try an as-of-yet untried outbound line.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Related Commands

Command	Description
dialer priority	Sets the priority of an interface in a dialer rotary group.

Syntax Description

dial-string	String of characters to be sent to a DCE device.
:isdn-subaddress	(Optional) ISDN subaddress.

Defaults

No strings are predefined.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

To specify multiple strings, use the dialer map command. In general, you include a dialer string or dialer map command if you intend to use a specific interface to initiate a DDR call.

Note   If a dialer string command is specified without a dialer-group command with access lists defined, dialing is never initiated. If the debug dialer command is enabled, an error message is displayed indicating that dialing never will occur.

The string of characters specified for the dial-string argument is the default number used under the following conditions:

• A dialer map command is not included in the interface configuration.

• The next hop address specified in a packet is not included in any of the dialer map interface configuration commands recorded—assuming that the destination address passes any access lists specified for DDR with the dialer-list command.

Examples

The following example specifies a dial-on-demand routing (DDR) telephone number to be tone-dialed on interface async 1 using the dialer string command:

interface async 1
 dialer string T14085553434

Related Commands

Command	Description
dialer-group	Controls access by configuring an interface to belong to a specific dialing group.
dialer in-band	Specifies that DDR is to be supported.
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
script dialer	Specifies a default modem chat script.

Syntax Description

dial-string	Telephone number to be sent to a DCE device.
class class-name	(Optional) Dialer map class associated with this telephone number.

Defaults

No telephone numbers and class names are predefined.

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

Dialer profiles make it unnecessary to use dialer maps to configure DDR.

Note   If a dialer string command is specified without a dialer-group command with access lists defined, dialing is never initiated. If the debug dialer command is enabled, an error message is displayed indicating that dialing never will occur.

Examples

The following example specifies that the dial string 4159991234 be used in calls to destinations defined by the map class sf:

dialer string 4159991234 class sf

Related Commands

Command	Description
dialer wait-for-carrier-time (map-class dialer configuration)	Specifies the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class.
interface dialer	Defines a dialer rotary group.

Syntax Description

dial-string	String of characters to be sent to a DCE device.
:isdn-subaddress	(Optional) ISDN subaddress.

Defaults

No strings are predefined.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

To use this command on an asynchronous interface, you must define a modem chat script for the associated line by using the script dialer command. A script must be used to implement dialing.

In general, you include a dialer string command if you intend to use a specific interface to initiate a dial-on-demand routing (DDR) call.

Note   If a dialer string command is specified without a dialer-group command with access lists defined, dialing is never initiated. If the debug dialer command is enabled, an error message is displayed indicating that dialing never will occur.

The string of characters specified for the dial-string argument is the default number used under the following conditions:

• A dialer map command is not included in the interface configuration.

• The next hop address specified in a packet is not included in any of the dialer map interface configuration commands recorded—assuming that the destination address passes any access lists specified for DDR with the dialer-list command.

Syntax Description

This command has no arguments and keywords.

Defaults

Disabled

Command Modes

Map-class dialer configuration

Command History

Release	Modification
11.0	This command was introduced.

Examples

The following partial example defines a dialer map class to support the SDN dialing plan and to support outgoing voice calls. For a more complete example using all the related commands, see the map-class dialer command.

map-class dialer sdnplan
  dialer voice-call
  dialer outgoing sdn

Related Commands

Command	Description
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
dialer outgoing	Configures the dialer map class for a NSF dialing plan to support outgoing calls.
map-class dialer	Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.

Syntax Description

seconds

Number of seconds that the interface waits for the carrier to come up when a call is placed. Acceptable values are positive, nonzero integers.

Defaults

30 seconds

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Examples

The following example specifies a carrier wait time of 45 seconds on asynchronous interface 1:

interface async 1
 dialer wait-for-carrier-time 45

Related Commands

Command	Description
dialer enable-timeout	Sets the length of time an interface stays down after a call has completed or failed and before the interface is available to dial again.

Syntax Description

seconds

Number of seconds that the interface waits for the carrier to come up when a call is placed. Acceptable values are positive, nonzero integers. The default is 30 seconds.

Defaults

30 seconds

Command Modes

Map-class dialer configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Examples

The following example specifies a carrier wait time of 20 seconds for the Eng class on the Dialer2 interface:

interface Dialer2
 ip address 2.2.2.2 255.255.255.0
 encapsulation ppp
 dialer remote-name Mediumuser
 dialer string 5264540 class Eng
 dialer wait-for-carrier-time 20
 dialer load-threshold 50 either
 dialer pool 1
 dialer-group 2

Related Commands

Command	Description
dialer wait-for-carrier-time (map-class dialer configuration)	Specifies the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class.

Syntax Description

seconds

The timeout value in seconds.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.3T	This command was introduced.

Usage Guidelines

This command is used to add a delay time to the backup interface. The delay time delays the time it takes for the backup interface to disconnect after the primary interface recovers.

Examples

The following example forces a 6-second delay to the backup interface once the primary interface recovers:

interface bri0
 ip address 2.1.1.2 255.255.255.0
 encapsulation ppp
 dialer map ip 3.1.1.1 255.255.255.0 name hubble 5551234
 dialer-group 1
 dialer watch-group 1
 dialer watch-disable 6

Related Commands

Command	Description
show dialer dnis	Displays general diagnostic information for ISDN BRI interfaces configured for DDR.

Syntax Description

group-number

Group number assigned that will point to a globally defined list of IP addresses to watch. The valid range is 1 to 255.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.3T	This command was introduced.

Usage Guidelines

Use the dialer watch-group command on the secondary interface you want to enable DDR backup.

Syntax Description

group-number	Group number assigned to the list. Valid group numbers are between 1 and 255.
ip	IP is the only routed protocol supported for Dialer Watch.
ip-address	IP address or address range to be applied to the list.
address-mask	IP address mask to be applied to the list.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release	Modification
11.3T	This command was introduced.

Usage Guidelines

Use this command to add all IP addresses or networks you want monitored.

There is no software limit to the number of protocol addresses that can be added to the group.

Address matching is exact; therefore, you must apply the specific IP address and mask range for the networks you want monitored.

Use this command with the dialer watch-group interface configuration command. The number of the group list must match the group number. For example, if you use dialer watch-group number 1, you must also use dialer watch-list number 1.

You must configure the standard commands required to enable the router to perform DDR in addition to the Dialer Watch commands. Refer to Cisco IOS Release 12.1 configuration guides and command references for additional information.

The dialer watch-list and dialer watch-group commands can be added in any order.

Examples

The following example adds the IP addresses to be watched:

dialer watch-list 1 ip 3.1.1.0 255.255.255.0
dialer watch-list 1 ip 2.1.1.0 255.255.255.0
dialer watch-list 1 ip 5.1.1.0 255.255.255.0

Syntax Description

connection

(Optional) Number of the line or name of the active network connection to be disconnected.

Command Modes

EXEC

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Do not disconnect a line to end a session. Instead, log off the host, so that the Cisco IOS software can clear the connection. Then end the session. If you cannot log out of an active session, disconnect the line.

Examples

In the following example, the user disconnects from the device Slab to return back to the router:

Slab% disconnect
  Connection closed by remote host
 
router#

Related Commands

Command	Description
login (EXEC)	Enables or changes a login username.

Syntax Description

default	Allows a specified customer profile to accept all DNIS numbers coming into the access server. For example, a stray DNIS number not listed in any customer profile passes through this default DNIS group. Most customer profiles do not have this option configured.
name	Assigns a name to a DNIS group.
name	The name can have up to 23 characters.

Defaults

No DNIS groups are associated with a customer profile.

Command Modes

Customer profile configuration

Command History

Release	Modification
12.0(4)XI	This command was introduced.

Usage Guidelines

Use the dnis group customer profile configuration command to include a group of DNIS numbers in a customer profile or discriminator:

Examples

The following example includes the DNIS group called customer1dnis in the customer1 customer profile:

resource-pool profile customer customer1
 dnis group customer1dnis

Related Commands

Command	Description
dialer dnis group	Creates a DNIS group.
resource-pool profile customer	Creates a customer profile.

Syntax Description

domain-name

Case-sensitive name of the domain that will be tunneled.

Defaults

This function will be used if it is configured; otherwise, it is disabled.

Command Modes

Request-dialin mode or VPDN group configuration mode

Command History

Release	Modification
12.0(4)XI	This command was introduced.
12.0(5)T	This command was migrated to Release 12.0(5)T.

Usage Guidelines

In request-dialin mode, you must first enable a tunneling protocol on the request-dialin VPDN subgroup (using the protocol command) before you can enable the domain command. Removing the protocol command or configuring a different protocol removes the domain command from the request-dialin subgroup. You can configure a request-dialin VPDN subgroup to tunnel calls from multiple DNIS numbers and domain names.

In VPDN group configuration mode, use the domain VPDN group configuration command to support additional domain names for a specific VPDN group. The domain command becomes available in the command line interface after you use the request dialin command for the first time. The domain command allows a VPDN tunnel to be authorized by using the domain name.

Note   Configure the vpdn group command with the request dialin command to enable VPDN. The requestor initiates a dial-in tunnel.

Examples

The following example configures VPDN group 1 to request dial-in to IP address 10.99.67.76 when it receives a PPP call from a username with the domain name jgb.com or ratdog.com:

vpdn-group 1
 request-dialin
  protocol l2tp
  domain jgb.com
  domain ratdog.com
 initiate-to ip 10.99.67.76
 

The following example shows multiple domains tunneling to one HGW/LNS router at 10.1.1.1. Note that the domain command does not appear in the command line interface until you enter the request dialin command:

# vpdn-group california_users
?
VPDN group configuration commands:
  accept   Accept a tunnel open request
  default  Set a command to its defaults
  exit     Exit from VPDN group configuration mode
  no       Negate a command or set its defaults
  request  Request to open a tunnel
 
request dialin l2tp ip 10.1.1.1 domain la.com
?
VPDN group configuration commands:
  backup            Add backup address
  default           Set a command to its defaults
  dnis              Accept a DNIS tunnel
  domain            Accept a domain tunnel
  exit              Exit from VPDN group configuration mode
  force-local-chap  Force a CHAP challenge to be instigated locally
  l2tp              L2TP specific commands
  lcp               LCP specific commands
  loadsharing       Add loadsharing address
  local             local information, like name
  multilink         Configure limits for Multilink
  no                Negate a command or set its defaults
  request           Request to open a tunnel
domain sandiego.com
domain sanjose.com
domain sf.com

Related Commands

Command	Description
accept dialin	Specifies the LNS to use for authenticating, and the virtual template to use for cloning, new virtual access interfaces when an incoming L2TP tunnel connection is requested from a specific peer.
dnis	Configures a VPDN group to tunnel calls from the specified DNIS.
initiate-to	Specifies the IP address that will be tunneled to.
protocol (VPDN)	Specifies the Layer 2 tunneling protocol that the VPDN subgroup will use.
request dialin	Configures a VPDN group to request L2F or L2TP tunnels to a home gateway and creates a request-dialin VPDN subgroup.

Syntax Description

range

DS0 number. The range of numbers can be 1 to 24 for T1, for example, 1-10, or 10-24.

Defaults

Busyout is disabled

Command Modes

Controller configuration

Command History

Release	Modification
11.3(2)AA	This command was introduced, and supported T1 and T3 only.
12.0	This command was migrated to Release 12.0, and supports T1, T3, E1and DMM HMM (Double Modem Module [12] Hex Modem Module [6]).

Usage Guidelines

Use the ds0 busyout command when you to busyout a one or more DS0s (channels). If there is an active call, the software waits until the call terminates by a disconnection; then the DS0 is busied out. First you must specify the T1 line (port) containing the 24 DS0s, using the controller T1 command.

To busyout all DS0s on a trunk card or all modems on a modem card, use the busyout privileged EXEC command.

To display the busyout information, use the show busyout privileged EXEC command.

Note   The ds0 busyout command only applies to cas-group command configurations for channel-associated signalling. This command has no effect on pri-group command configurations.

Examples

In this example, the controller T1 is configured with cas-group (channel-associated signalling). The following example removes DS0s 1 through 10 from dialup services. These DS0s are assigned to the T1 port (line) in shelf 6, slot 0, port 0:

controller t1 6/0/0
 ds0 busyout 1-10
 exit

Related Commands

Command	Description
busyout	Informs the central-office switch that a channel is out of service.
modem busyout	Disables a modem from dialing or answering calls whereby the disabling action is not executed until the active modem returns to an idle state.
modem busyout-threshold	Maintains a balance between the number of DS0s and modems.
modem shutdown	Abruptly shuts down an active or idle modem installed in an access server or router.
show dial-shelf	Displays information about the dial shelf, including clocking information.