-
Cisco IOS Dial Technologies Command Reference, Release 12.2
-
Using Cisco IOS Software
-
Commands A through CAS
-
Commands CHA through CPP
-
Commands D
-
Commands EN through IP
-
Commands IS through L2
-
Commands LCP through MOD
-
Commands MU through PPP
-
Commands PRI through SHE
-
Commands SHOW A through SHOW DI
-
Commands SHOW DS through SHOW LI
-
Commands SHOW M through SHOW N
-
Commands SHOW P through SHOW R
-
Commands SHOW S through SHOW V
-
Commands SHU through X
-
Index
-
Table Of Contents
dialer idle-timeout (interface)
dialer string (dialer profiles)
dialer wait-for-carrier-time (interface)
dialer wait-for-carrier-time (map-class)
dial-shelf split backplane-ds0
default (VPDN)
To reset a virtual private dialup network (VPDN) group or a VPDN subgroup to its default value, use the default command in VPDN group or VPDN subgroup mode.
default {accept-dialin | accept-dialout | authen before-forward | dialer | dnis | domain | force-local-chap | initiate-to | l2f | l2tp | lcp renegotiation | local | multilink | pool-member | request-dialin | request-dialout | rotary-group | source-ip | terminate-from | virtual-template}
Syntax Description
Defaults
Disabled
Command Modes
VPDN group
VPDN subgroup
Command History
Usage Guidelines
Using the default command without a keyword is the same as using the no form of this command.
Examples
The following example shows an LNS configured to accept L2F dial-in and L2TP dial-out:
vpdn-group 1accept dialinprotocol l2fvirtual-template 1request dialoutprotocol l2tppool-member 1local name reubenterminate-from hostname ceriseinitiate-to ip 10.3.2.1l2f ignore-mid-sequencel2tp ip udp checksumIf you then issue the default protocol command in request-dialout mode, the configuration will look like this:
vpdn-group 1accept dialinprotocol l2fvirtual-template 1request dialoutlocal name reubenterminate-from hostname ceriseinitiate-to ip 10.3.2.1l2f ignore-mid-sequenceIf you issue the no accept dialin command when the LNS is configured as in the first example, the configuration will change to this:
vpdn-group 1request dialoutprotocol l2tppool-member 1local name reubeninitiate-to ip 10.3.2.1l2tp ip udp checksumdescription (interface)
To add a description to an interface configuration, use the description command in interface configuration mode. To remove the description, use the no form of this command.
description string
no description
Syntax Description
string
Comment or a description to help you remember what is attached to this interface. This string is limited to 238 characters.
Defaults
No description is added.
Command Modes
Interface configuration
Command History
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 0description Fractional T1 line to Mountain View -- 128 kbpsRelated Commands
description (vpdn-group)
To add a description to a VPDN group, use the description command in VPDN group configuration mode. To remove the description, use the no form of this command.
description string
no description
Syntax Description
Defaults
No description is added.
Command Modes
VPDN group configuration
Command History
Examples
The following example shows how to enter a description for a VPDN group:
vpdn-group 333description This is a VPDN group at location 333request-dialinprotocol l2tpdomain dotty.cominitiate-to ip 10.0.0.63local name hooty.comRelated Commands
dialer
To specify the dialer interface that an accept-dialout virtual private dialup network (VPDN) subgroup will use to dial out calls, use the dialer command in accept-dialout configuration mode. To remove the dialer interface from the accept-dialout VPDN subgroup, use the no form of this command.
dialer dialer-interface
no dialer
Syntax Description
Defaults
Disabled
Command Modes
Accept-dialout configuration
Command History
Usage Guidelines
You must first enable Layer 2 Tunneling Protocol (L2TP) on the accept-dialout VPDN subgroup by using the protocol l2tp command before you can enable the dialer command. Removing the protocol command will remove the dialer command from the accept-dialout subgroup.
You can only specify one dialer per accept dialout group. Configuring a second dialer command will replace the first dialer command.
Examples
The following example creates an accept-dialout VPDN subgroup that uses dialer interface 2:
VPDN-group 1accept dialoutprotocol l2tpdialer 2terminate-from hostname ceriseRelated Commands
dialer callback-secure
To enable callback security, use the dialer callback-secure command in interface configuration mode. To disable callback security, use the no form of this command.
dialer callback-secure
no dialer callback-secure
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Interface configuration
Command History
Usage Guidelines
This command affects those users that are not authorized to be called back through configuration of the dialer callback-server command. If the username (the host-name argument in the dialer map command) is not authorized for callback, the call will be disconnected if the dialer callback-secure command is configured.
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 user1 will be disconnected and not called back.
interface BRI0ip address 172.19.1.9 255.255.255.0encapsulation pppdialer callback-securedialer enable-timeout 2dialer map ip 172.19.1.8 name user1 class dial1 81012345678901dialer-group 1ppp callback acceptppp authentication chap!map-class dialer dial1dialer callback-server usernameRelated Commands
dialer callback-server
To enable an interface to make return calls when callback is successfully negotiated, use the dialer callback-server command in interface configuration mode. To disable return calls, use the no form of this command.
dialer callback-server [username dialstring]
no dialer callback-server
Syntax Description
username
(Optional) Looks 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
Examples
The following partial example configures BRI 0 to function as the callback server on the shared network:
interface BRI0ip address 172.19.1.9 255.255.255.0encapsulation pppdialer callback-securedialer enable-timeout 2dialer map ip 172.19.1.8 name atlanta class dial1 81012345678901dialer-group 1ppp callback acceptppp authentication chap!map-class dialer dial1dialer callback-server usernameRelated Commands
dialer called
To configure dial-on-demand routing (DDR) to perform DNIS-plus-ISDN-subaddress binding for dialer profile interfaces, use the dialer called command in dial-on-demand routing configuration mode. To disable DNIS-plus-ISDN-subaddress binding, use the no form of this command.
dialer called DNIS:subaddress
no dialer called DNIS:subaddress
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 configuration
Command History
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:6789Related Commands
Configures caller ID screening and, optionally, enables ISDN caller ID callback for legacy DDR or the dialer profiles DDR feature.
dialer caller
To configure caller ID screening for a dialer rotary group interface or to bind an incoming call to a particular dialer profile, and, optionally, to enable ISDN caller ID callback, use the dialer caller command in interface configuration mode. To disable this feature, use the no form of this command.
dialer caller number [callback]
no dialer caller number [callback]
Syntax Description
Defaults
Caller ID screening, call binding, and ISDN caller ID callback are disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
On a dialer rotary group interface, 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.
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 x's are used in the callback number, dialer caller screening is based on a best match system that uses the number of x's 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 x's in any configuration line that uses the callback keyword is less than the number of x's in any configuration line that does not use the keyword.
For example, if you use at most four x's in the configuration lines with the callback keyword, then to accept calls from other numbers use at least five x's 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.
For dialer profiles, this command helps bind a dialer profile to—and thus configure—the interface used for a call. The dialer command acts as a binding command by associating an incoming call with a specified dialer profile if the caller ID presented by the call matches the dialer caller value.
Note
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 callbackdialer caller 408556xxxx callbackdialer caller xxxxxRelated Commands
dialer clid group
To create a Calling Line Identification (CLID) group in the resource pool and assign it a name, use the dialer clid group command in global configuration mode. To remove a CLID group from the resource pool, use the no form of this command.
dialer clid group clid-group-name
no dialer clid group clid-group-name
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Usage Guidelines
Use the dialer clid group command to create a CLID group and assign it a name. The CLID group name must be the same as the name used when configuring the customer profile.
Customer profiles are configured with a DNIS and/or CLID group and call type. The DNIS and/or CLID and call type of the incoming call is used to find the appropriate customer profile.
Examples
The following example shows the command to configure a CLID group named zot. After you enter this command, the router prompt changes to the CLID configuration mode—Router(config-clid-group)#.
Router(config)# dialer clid group zotRouter(config-clid-group)#Related Commands
Adds a DNIS number to a dialer DNIS group.
Configures a CLID group in a discriminator.
dialer congestion-threshold
To specify congestion threshold in connected links, use the dialer congestion-threshold command in interface configuration mode. To disable this function, use the no form of this command.
dialer congestion-threshold links
no dialer congestion-threshold
Syntax Description
Defaults
The default number of connected links is 64,000.
Command Modes
Interface configuration
Command History
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 interface 0:
interface Dialer0dialer aaadialer congestion-threshold 5Related Commands
Reserves links for dial-in and dial-out.
Allows the stack group to bid for dial-out connection.
dialer dnis group
To create a DNIS group, use the dialer dnis group command in global configuration mode. To remove a specific Dialed Number Identification Service (DNIS) group from the running configuration, use the no form of this command.
dialer dnis group name
no dialer dnis group name
Syntax Description
Defaults
A dialer DNIS group named default.
Command Modes
Global configuration
Command History
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-group1Dialer Called Configuration Commands:call-type set call-type overridedefault Set a command to its defaultsexit Exit from dialer configuration modehelp Description of the interactive help systemno Negate a command or set its defaultsnumber Enter number in dnis groupIn 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_1dnis group dnis_isp_1 exitdialer dnis group dnis_isp_1number 1234number 5678Related Commands
Includes a group of DNIS numbers in a customer profile.
resource-pool profile
Creates a resource group for RPM.
dialer dns
To obtain a user profile name on a remote network using reverse Domain Name System (DNS), use the dialer dns command in interface configuration mode.To disable this function, use the no form of this command.
dialer dns
no dialer dns
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
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 dialer 0dialer aaadialer dnsRelated Commands
dialer dtr
To enable dial-on-demand routing (DDR) on an interface and specify that the serial line is connected by non-V.25bis modems using Electronic Industries Association (EIA) signalling only—specifically, the data terminal ready (DTR) signal—use the dialer dtr command in interface configuration mode. To disable DDR for the interface, use the no form of this command.
dialer dtr
no dialer dtr
Syntax Description
This command has no arguments or keywords.
Defaults
DTR dialing is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
A serial interface configured for DTR dialing can place calls only; it cannot accept them.
When a local interface is configured for DTR dialing, the remote interface (that will be receiving the calls) can be configured for in-band dialing or not configured for anything but encapsulation, depending on the desired behavior. If the remote interface is expected to terminate a call when no traffic is transmitted for some time, it must be configured for in-band dialing (along with access lists and a dummy dialer string). If the remote interface is purely passive, no configuration is necessary.
Rotary groups cannot be configured for DTR dialing.
The dialer map and dialer string commands have no effect on DTR dialers.
Examples
The following example enables DDR and specifies DTR dialing on an interface:
dialer dtrRelated Commands
dialer enable-timeout
To set the length of time an interface stays down after a call has completed or failed and before it is available to dial again, use the dialer enable-timeout command in interface configuration mode. To return to the default value, use the no form of this command.
dialer enable-timeout seconds
no dialer enable-timeout
Syntax Description
Defaults
15 seconds
Command Modes
Interface configuration
Command History
Usage Guidelines
The dialer enable-timeout command can be configured as a line down timer, to keep serial asynchronous or synchronous interface lines down for a certain period of time, and as a callback timer for both serial interfaces and ISDN interfaces.
If your phone lines are often busy or down, you may need 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. In this application, the dialer enable-timeout command applies to both inbound and outbound calls on serial interfaces only (not to calls on ISDN interfaces).
When the dialer enable-timeout command is configured on an ISDN interface, its only effect is to set a callback timer. ISDN interfaces are not held down after a call has failed or completed because these interfaces support several possible calls at a time.
Examples
The following example shows how to specify a timeout period of 30 seconds on asynchronous interface 1 before attempting another connection:
interface async 1dialer enable-timeout 30The following example shows how to configure a BRI interface for legacy dial-on-demand routing (DDR) and ISDN caller ID callback:
interface bri 0description Connected to NTT 81012345678901ip address 10.1.1.7 255.255.255.0no ip mroute-cacheencapsulation pppisdn caller 81012345678902 callbackdialer enable-timeout 2dialer map ip 10.1.1.8 name spanky 81012345678902dialer-group 1ppp authentication chapThe following examples show how to configure a PPP callback server and client.
PPP Callback Server
The PPP callback server is configured on an ISDN BRI interface and requires an enable timeout period and a map class to be defined.
interface bri 0ip address 10.1.1.7 255.255.255.0encapsulation pppdialer callback-securedialer enable-timeout 2dialer map ip 10.1.1.8 name atlanta class dial1 81012345678901dialer-group 1ppp callback acceptppp authentication chapPPP Callback Client
The PPP callback client is also configured on an ISDN BRI interface, but does not require an enable timeout period or a map class to be defined.
map-class dialer dial1dialer callback-server usernameinterface bri 0ip address 10.1.1.8 255.255.255.0encapsulation pppdialer map ip 10.1.1.7 name dallas 81012345678902dialer-group 1ppp callback requestppp authentication chapdialer fast-idle (interface)
To specify 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, use the dialer fast-idle command in interface configuration mode. To return to the default value, use the no form of this command.
dialer fast-idle seconds
no dialer fast-idle
Syntax Description
seconds
Idle time, in seconds, that must occur on an interface before the line is disconnected. Acceptable values are positive, nonzero integers.
Defaults
20 seconds
Command Modes
Interface configuration
Command History
Usage Guidelines
The dialer fast idle timer is activated if there is contention for a line. The dialer fast idle timer is activated if a line is busy, a packet for a different next hop address is received, and the busy line is required to send the competing packet.
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 1dialer fast-idle 35Related Commands
Specifies the idle time before the line is disconnected.
Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
dialer fast-idle (map-class)
To specify the fast idle timer value to use when placing a call to any telephone number associated with a specified class, use the dialer fast-idle command in map-class dialer configuration mode. To reset the dialer fast-idle timer to the default, use the no form of this command.
dialer fast-idle seconds
no dialer fast-idle
Syntax Description
Defaults
Defaults to the fast idle timer value that is set for the interface.
Command Modes
Map-class dialer configuration
Command History
Usage Guidelines
This fast idle timer is associated only with the map class, not the entire interface.
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 Engisdn speed 56dialer fast-idle 10dialer wait-for-carrier-time 30Related Commands
dialer-group
To control access by configuring an interface to belong to a specific dialing group, use the dialer-group command in interface configuration mode. To remove an interface from the specified dialer access group, use the no form of this command.
dialer-group group-number
no dialer-group
Syntax Description
Defaults
No access is predefined.
Command Modes
Interface configuration
Command History
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 1dialer-group 1access-list 101 deny igrp 0.0.0.0 255.255.255.255 255.255.255.255 0.0.0.0access-list 101 permit ip 0.0.0.0 255.255.255.255 0.0.0.0 255.255.255.255dialer-list 1 protocol ip list 101Related Commands
Defines a DDR dialer list to control dialing by protocol or by a combination of protocol and an access list.
dialer hold-queue
To allow interesting outgoing packets to be queued until a modem connection is established, use the dialer hold-queue command in interface configuration mode. To disable the hold queue, use the no form of this command.
dialer hold-queue packets timeout seconds
no dialer hold-queue [packets]
Syntax Description
Defaults
The outgoing packet queue is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
A dialer hold queue can be configured on any type of dialer, including in-band synchronous, asynchronous, data terminal ready (DTR), and ISDN dialers. Rotary groups can be configured with a dialer hold queue. If a rotary group is configured with a hold queue, all members of the group will be configured with a dialer hold queue and no individual member's hold queue can be altered.
If no hold queue is configured, packets are dropped during the time required to establish a connection. Setting packets to 0 using the dialer hold-queue command is equivalent to using the no dialer hold-queue command.
Examples
The following command configures a dialer hold queue to hold 10 packets:
dialer hold-queue 10 timeout 60Related Commands
Controls access by configuring an interface to belong to a specific dialing group.
dialer idle-timeout (interface)
To specify the duration of idle time before a line is disconnected, use the dialer idle-timeout command in interface configuration mode. To reset the idle timeout to the default, use the no form of this command.
dialer idle-timeout seconds [inbound | either]
no dialer idle-timeout
Syntax Description
Defaults
Direction: outbound
Idle time: 120 seconds
Command Modes
Interface configuration
Command History
10.0
This command was introduced.
12.1(1)T
The following keywords were added:
•
•
Usage Guidelines
This command is used on lines for which there is no contention. When contention occurs, the dialer fast-idle command is activated. For example, when a busy line is requested to send another packet to a different destination than it is currently connected to, line contention occurs and the dialer fast-idle command is activated.
By default, 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.
Use the dialer idle-timeout command to set a very high idle timer when Multilink PPP is configured and you want a multilink bundle to be connected indefinitely. (The dialer-load threshold 1 command no longer keeps a multilink bundle of n links connected indefinitely and the dialer-load threshold command no longer keeps a multilink bundle of two links connected indefinitely.)
Examples
The following example specifies an idle timeout of 3 minutes (180 seconds) on asynchronous interface 1. Because the inbound keyword is included, only inbound traffic that matches the dialer group will reset the idle timer.
interface async 1dialer idle-timeout 180 inboundRelated Commands
dialer in-band
To specify that dial-on-demand routing (DDR) is to be supported, use the dialer in-band command in interface configuration mode. To disable DDR for the interface, use the no form of this command.
dialer in-band [no-parity | odd-parity]
no dialer in-band
Syntax Description
Defaults
Disabled. By default, no parity is applied to the dialer string.
Command Modes
Interface configuration
Command History
