|
|
This chapter explains the function and syntax of the Cisco IOS dial services commands beginning with D. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Dial Services Command Reference, Release 12.1.
To reset a Virtual Private Dialup Network (VPDN) group command or a VPDN subgroup command to its default value, use the default command.
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
accept-dialin Removes the accept-dialin group from the VPDN group. accept-dialout Removes the accept-dialout group from the VPDN group. authen before-forward Removes the authen before-forward command from the VPDN group. dialer Removes the dialer command from the accept-dialout group. dnis Removes all dnis commands from the request-dialin group. domain Removes all domain commands from the request-dialin group. force-local-chap Removes the force-local-chap command from the VPDN group. initiate-to Removes all initiate-to commands from the VPDN group. l2f Removes all l2f commands from the VPDN group. l2tp Removes all l2tp commands from the VPDN group. lcp renegotiation Removes the lcp renegotiation command from the VPDN group. local Removes the local command from the VPDN group. multilink Removes all multilink commands from the VPDN group. pool-member Removes the pool-member command from the request-dialout group. request-dialin Removes the request-dialin group from the VPDN group. request-dialout Removes the request-dialout group from the VPDN group. rotary-group Removes the rotary-group command from the request-dialout group. source-ip Removes the source-ip command from the VPDN group. terminate-from Removes the terminate-from command from the VPDN group. virtual-template Removes the virtual-template command from the accept-dialin group.
To add a description to an interface configuration, use the description command in interface configuration mode. Use the no form of this command to remove the description.
description string
Syntax Description
string Comment or a description to help you remember what is attached to this interface.
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
Syntax Description
dialer-interface Number of the dialer interface.
To allow a dialer to access the authentication, authorization, and accounting (AAA) server for dialing information, use the dialer aaa command in interface configuration mode. To disable this function, use the no form of the command.
dialer aaaSyntax Description
This command has no arguments or keywords.
To enable callback security, use the dialer callback-secure command in interface configuration mode. Use the no form of this command to disable callback security.
dialer callback-secureSyntax Description
This command has no arguments or keywords.
To enable an interface to make return calls when callback is successfully negotiated, use the dialer callback-server command in interface configuration mode. Use the no form of this command to disable return calls.
dialer callback-server [username dialstring]
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.
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:subaddressSyntax Description
DNIS:subaddress | Dialed Number Identification Service, or the called party number, a colon, and the ISDN subaddress. |
To configure caller ID screening and optionally to enable ISDN caller ID callback for legacy dial-on-demand routing (DDR) or the dialer profiles DDR feature, use the dialer caller command in interface configuration mode. Use the no form of this command to disable this feature.
dialer caller number [callback]
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.
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 the command.
dialer congestion-threshold links
Syntax Description
links Number of connected links for congestion threshold in the range 0 to 64000.
Syntax Description
name | Assigns a name to the DNIS group number. |
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. Use the no form of this command to disable this function.
dialer dnsSyntax Description
This command has no arguments or keywords.
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. Use the no form of this command to disable DDR for the interface.
dialer dtrSyntax Description
This command has no arguments or keywords.
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. Use the no form of this command to return to the default value.
dialer enable-timeout seconds
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.
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. Use the no form of this command to return to the default value.
dialer fast-idle seconds
Syntax Description
seconds Idle time, in seconds, that must occur on an interface before the line is disconnected. Acceptable values are positive, nonzero integers.
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. Use the no form of this command to reset the dialer fast-idle timer to the default.
dialer fast-idle seconds
Syntax Description
seconds Number of seconds to wait before placing a different call.
To control access by configuring an interface to belong to a specific dialing group, use the dialer-group command in interface configuration mode. Use the no form of this command to remove an interface from the specified dialer access group.
dialer-group group-number
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.
To allow interesting outgoing packets to be queued until a modem connection is established, use the dialer hold-queue command in interface configuration mode. Use the no form of this command to disable the hold queue.
dialer hold-queue packets timeout seconds
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.
To specify the idle time before the line is disconnected, use the dialer idle-timeout command in interface configuration mode. Use the no form of this command to reset the idle timeout to the default.
dialer idle-timeout seconds
Syntax Description
seconds Idle time, in seconds, that must occur on the interface before the line is disconnected. Acceptable values are positive, nonzero integers.
To specify the idle time before the calls in this map class are disconnected, use the dialer idle-timeout command in map-class dialer configuration mode. Use the no form of this command to reset the idle timeout to the default.
dialer idle-timeout seconds
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.
To specify that dial-on-demand routing (DDR) is to be supported, use the dialer in-band command in interface configuration mode. Use the no form of this command to disable DDR for the interface.
dialer in-band [no-parity | odd-parity]
Syntax Description
no-parity (Optional) Indicates that no parity is to be applied to the dialer string that is sent out to the modem on synchronous interfaces. odd-parity (Optional) Indicates that the dialed number has odd parity (7-bit ASCII characters with the eighth bit as the parity bit) on synchronous interfaces.
To specify the bit rate used on the B channel associated with a specified map class and to specify whether to set up semipermanent connections for this map class, use the dialer isdn command in map-class dialer configuration mode. Use the no form of this command to remove the speed and connection settings.
dialer isdn [speed speed] [spc]
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.
To configure 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, use the dialer isdn short-hold command in map-class dialer configuration mode. Use the no form of the command to reset the ISDN short-hold timer to the default period.
dialer isdn short-hold seconds
Syntax Description
seconds Minimum number of seconds of idle time on the line. Defaults is 120 seconds.
To define a dial-on-demand routing (DDR) dialer list for dialing by protocol or by a combination of a protocol and a previously defined access list, use the dialer-list protocol command in global configuration mode. Use the no form of this command to delete a dialer list.
dialer-list dialer-group protocol protocol-name {permit | deny | list access-list-number | access-group}
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 access-group Filter list name used in the clns filter-set and clns access-group commands.
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 6 for the supported access list types and numbers.
| Access List Type | Access List Number Range (decimal) |
|---|---|
AppleTalk | 600-699 |
Banyan VINES (standard) | 1-100 |
Banyan VINES (extended) | 101-200 |
DECnet | 300-399 |
IP (standard) | 1-99 |
IP (extended) | 100-199 |
Novell IPX (standard) | 800-899 |
Novell IPX (extended) | 900-999 |
Transparent Bridging | 200-299 |
XNS | 500-599 |
To configure bandwidth on demand by setting the maximum load before the dialer places another call to a destination, use the dialer load-threshold interface command. Use the no form of this command to disable the setting.
dialer load-threshold load [outbound | inbound | either]
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.
To configure a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites, use a form of the dialer map command in interface configuration mode; all options are shown in the first form of the command. To delete a particular dialer map entry, use a no form of this command.
dialer map protocol next-hop-address [name hostname] [spc] [speed 56 | speed 64] [broadcast] [modem-script modem-regexp] [system-script system-regexp] [dial-string[:isdn-subaddress]]To configure a serial interface or ISDN interface to place a call to multiple sites and to authenticate calls from multiple sites, use the second form of the dialer map command:
dialer map protocol next-hop-address [name hostname] [spc] [speed 56 | speed 64] [broadcast] [dial-string[:isdn-subaddress]]To configure a serial interface or ISDN interface to support bridging, use the third form of the command:
dialer map bridge [name hostname] [spc] [broadcast] [dial-string[:isdn-subaddress]]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:
dialer map protocol next-hop-address [name hostname] [broadcast] [modem-script
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). (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). (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.
To configure an ISDN interface to place a call to multiple sites, to authenticate calls from multiple sites, and to identify the class name that configures the ISDN Advice of Charge (AOC) short-hold idle timeout, use the following form of the dialer map command in interface configuration mode:
dialer map protocol next-hop-address [name hostname] [spc] [speed 56 | speed 64] [broadcast]
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). (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. (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.
To set up network addressing on an ISDN BRI interface to support semipermanent connections (if the ISDN switch supports such connections), use the following form of the dialer map command in interface configuration mode:
dialer map protocol next-hop-address [name hostname] [spc] [speed 56 | speed 64] [broadcast]
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. (Optional) Indicates that broadcasts should be forwarded to this protocol address. (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.
To define a dialer map for Cisco's snapshot routing protocol on a client router connected to a dial-on-demand routing (DDR) interface, use the dialer map snapshot command in interface configuration mode. Use the no form of this command to delete one or more previously defined snapshot routing dialer maps.
dialer map snapshot sequence-number dial-string
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.
To specify, for a dialer profile, the maximum number of links to a remote destination that can be up at any one time, use the dialer max-link command in interface configuration mode.
dialer max-link number
Syntax Description
number Maximum number of links, in the range 1 through 255. Defaults is 255 links.
To configure the dialer map class for a Network Specific Facilities (NSF) dialing plan to support outgoing calls, use the dialer outgoing command in map-class dialer configuration mode.
dialer outgoing classname
Syntax Description
classname Keyword for a specified AT&T Primary-4ESS NSF dialing plan; the following keywords are supported: sdn, megacomm, and accunet.
To specify, for a dialer interface, which dialing pool to use to connect to a specific destination subnetwork, use the dialer pool command in interface configuration mode.
dialer pool number
Syntax Description
number Dialing pool number, in the range 1 through 255.
To configure a physical interface to be a member of a dialer profile dialing pool, use the dialer pool-member command in interface configuration mode.
dialer pool-member number [priority priority] [min-link minimum] [max-link maximum]
Syntax Description
To set the priority of an interface in a dialer rotary group, use the dialer priority command in interface configuration mode. Use the no form of the command to revert to the default setting.
dialer priority number
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.
To specify, for a dialer interface, the authentication name of the remote router on the destination subnetwork, use the dialer remote-name command in interface configuration mode.
dialer remote-name username
Syntax Description
username Case-sensitive character string identifying the remote device; maximum length is 255 characters.
To reserve links for dial-in and dial-out, use the dialer reserved-links command in interface configuration mode. Use the no form of the command to clear the link.
dialer reserved links {dialin-link | dialout link}
Syntax Description
dialin-link Link reserved for dial-in. dialout-link Link reserved for dial-out.
To include a specified interface in a dialer rotary group, use the dialer rotary-group command in interface configuration mode.
dialer rotary-group number
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.
To specify the method for identifying the outbound line to be used for ISDN or asynchronous dial-on-demand routing (DDR) calls, use the dialer rotor command in interface configuration mode.
dialer rotor {priority | best}
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-yet-untried outbound line.
To specify the string (telephone number) to be called for interfaces calling a single site, use the dialer string command in interface configuration mode. Use the no form of this command to delete the dialer string specified for the interface.
dialer string dial-string[:isdn-subaddress]
Syntax Description
dial-string String of characters to be sent to a DCE device. :isdn-subaddress (Optional) ISDN subaddress.
To specify the string (telephone number) to be used when placing a call from an interface, use the
dialer string command in interface configuration mode. Use the no form of this command to delete the telephone number specified for the interface.
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.
To specify the destination string (telephone number) to be called for interfaces calling a single site, use the dialer string command in interface configuration mode. Use the no form of this command to delete the dialer string specified for the interface.
dialer string dial-string[:isdn-subaddress]
Syntax Description
dial-string String of characters to be sent to a DCE device. :isdn-subaddress (Optional) ISDN subaddress.
To configure the dialer map class for a National Science Foundation (NSF) dialing plan to support outgoing voice calls, use the dialer voice-call command in map-class dialer configuration mode.
dialer voice-callSyntax Description
This command has no arguments or keywords.
To enable a dialer profile or dial-on-demand routing (DDR) dialer to use Layer 2 Tunnel Protocol (L2TP) dialout, use the dialer vpdn command in interface configuration mode. To disable L2TP dialout on a dialer profile or DDR dialer, use the no form of this command.
dialer vpdnSyntax Description
This command has no arguments or keywords.
To specify the length of time the interface waits for a carrier, use the dialer wait-for-carrier-time command in interface configuration mode. Use the no form of this command to reset the carrier wait time value to the default.
dialer wait-for-carrier-time seconds
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.
To specify the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class, use the dialer wait-for-carrier-time command in map-class dialer configuration mode. Use the no form of this command to reset the carrier wait time value to the default.
dialer wait-for-carrier-time seconds
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.
To set a delay time to the backup interface, use the dialer watch-disable command in interface configuration mode. At times, you may want to delay disconnecting the backup interface after the primary interface recovers. Use the no form of this command to disable this feature.
dialer watch-disable seconds
Syntax Description
seconds The timeout value in seconds.
To enable dial-on-demand routing (DDR) backup on an interface using Dialer Watch, configure the interface using the dialer watch-group command in interface configuration mode. Use the no form of this command to disable this feature.
dialer watch-group group-number
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.
To add the list of IP addresses you want monitored, use the dialer watch-list command in global configuration mode. Use the no form of this command to disable this feature.
dialer watch-list group-number ip ip-address address-mask
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.
To disconnect a line, use the disconnect EXEC command.
disconnect [connection]
Syntax Description
connection (Optional) Number of the line or name of the active network connection to be disconnected.
To include a group of Dialed Number identification Service (DNIS) numbers in a customer profile, use the dnis group command in customer profile configuration mode. Use the no form of this command to remove a DNIS group from a customer profile.
dnis group {default | name name}
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.
Syntax Description
domain-name Case-sensitive name of the domain that will be tunneled.
To busyout one or more digital signal level 0s (DS0s), use the ds0 busyout command in controller configuration mode. To cancel busyout on a DS0, use the no form of the command.
ds0 busyout range
Syntax Description
range DS0 number. The range of numbers can be 1 to 24 for T1, for example, 1-10, or 10-24.
Posted: Wed Jul 26 11:40:48 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.