-
Cisco IOS Dial Services Command Reference, Release 12.1
-
About the Cisco IOS Software Documentation
-
Commands: A through B
-
Commands: C
-
Commands: D
-
Commands: E through IP
-
Commands IS through LAT
-
Commands: LC through MOD
-
Commands: MU through PPP
-
Commands: PRI through SGBP
-
Commands: SHOW A through E
-
Commands: SHOW I through L
-
Commands: SHOW M
-
Commands: SHOW N through X
-
Commands: SL through TN
-
Commands: TR through VIR
-
Commands: VPDN through X
- Appendixes
-
Index
-
Table Of Contents
multilink
To limit the total number multilink PPP (MLP) sessions for all virtual private dialup network (VPDN) multilink users, enter the multilink command in VPDN group configuration mode. To remove the MLP session limit, enter the no form of this command.
multilink {bundle bundles | link links}
no multilink {bundle bundles | link links}
Syntax Description
Command Default
No MLP session limit is set.
Command Modes
VPDN group configuration
Command History
12.0(4)XI
This command was introduced.
12.0(5)T
This command was integrated into Cisco IOS Release 12.0(5)T.
Usage Guidelines
Use the multilink VPDN group configuration command to limit the total number of sessions for all MLP users. Each user requires one bundle, regardless if the user is a remote modem client or an ISDN client.
One modem client using one B channel requires one link. One ISDN BRI node may require up to two links for one BRI line connection. The second B channel of an ISDN BRI node comes up when the maximum threshold is exceeded.
Examples
The following example configures a VPDN group called group1 to initiate Layer 2 Tunnel Protocol (L2TP) tunnels to the tunnel server at IP address 10.2.2.2. Ten MLP bundles are configured for users that dial in to the domain cisco.com. Each bundle is configured to support a maximum of 5 links, limiting the total number of MLP sessions to 50.
Router(config)# vpdn-group group1Router(config-vpdn)# request-dialinRouter(config-vpdn-req-in)# protocol l2tpRouter(config-vpdn-req-in)# domain cisco.comRouter(config-vpdn-req-in)# exitRouter(config-vpdn)# initiate-to ip 10.2.2.2Router(config-vpdn)# multilink bundle 10Router(config-vpdn)# multilink link 5Related Commands
multilink bundle-name
To select a method for naming multilink bundles, use the multilink bundle-name global configuration command. To remove the selection method, use the no form of this command.
multilink bundle-name {authenticated | endpoint | both}
no multilink bundle-name {authenticated | endpoint | both}
Syntax Description
Defaults
Authenticated name of the peer.
Command Modes
Global configuration
Command History
Usage Guidelines
The authenticated keyword defines the selection criteria for the bundle name as the authenticated name, the endpoint discriminator if the link is not authenticated, or the caller ID if neither an authenticated name nor an endpoint is supplied.
The endpoint keyword defines the selection criteria for the bundle name as the endpoint discriminator, the authenticated name if no endpoint is supplied, or the caller ID if neither an authenticated name nor an endpoint is supplied.
The both keyword defines the selection criteria for the bundle name as an authenticated name-endpoint discriminator pair, the authenticated name if no endpoint is supplied, the endpoint discriminator if the link is not authenticated, or the caller ID if neither an authenticated name nor an endpoint is supplied.
Examples
The following example sets the selection criteria for the multilink bundle name as the endpoint discriminator:
multilink bundle-name endpointmultilink max-fragments
To set the maximum number of fragments a packet will be segmented into before being sent over the bundle, use the multilink max-fragments interface configuration command. To reset fragmentation to the default value, use the no form of this command.
multilink max-fragments fragments
no multilink max-fragments
Syntax Description
Defaults
16 fragments
Command Modes
Interface configuration
Command History
Usage Guidelines
Use the multilink max-fragments command to control the number of fragments into which a PPP frame may be fragmented. The multilink max-fragments command has been used to disable fragmentation entirely by setting the number of fragments to 1. This setting is better accomplished using the no ppp multilink fragmentation command.
The limit set using the multilink max-fragments command applies only when Multilink PPP (MLP) is fragmenting packets in a mode where it is constraining the number of fragments rather than the size of the fragments. See the description about fragmentation modes in the section "Usage Guidelines" of the ppp multilink fragment-delay command for more details.
Examples
The following example uses the multilink max-fragments command to fragment each frame into no more than four fragments:
multilink max-fragments 4Related Commands
ppp multilink fragmentation
Enables packet fragmentation.
ppp multilink fragment-delay
Specifies a maximum size, in units of time, for packet fragments on an MLP bundle.
multilink virtual-template
To specify a virtual template from which the specified Multilink PPP (MLP) bundle interface can clone its interface parameters, use the multilink virtual-template command in global configuration mode.
multilink virtual-template number
Syntax Description
Defaults
Disabled. No template number is defined.
Command Modes
Global configuration
Command History
Usage Guidelines
Configuring a specific IP address in a virtual template can result in the establishment of erroneous routes and the loss of IP packets.
Examples
The following example specifies an MLP virtual template to be used and then defines the template to be applied to an MLP bundle interface:
multilink virtual-template 1ip local pool default 2.2.2.2interface virtual-template 1ip unnumbered ethernet 0encapsulation pppppp multilinkppp authentication chapRelated Commands
multilink-group
To designate an interface as part of a multilink leased line bundle, use the multilink-group command in interface configuration mode. To remove an interface from a bundle, use the no form of this command.
multilink-group group-number
no multilink-group
Syntax Description
Defaults
Disabled
Command Modes
Interface configuration
Command History
Usage Guidelines
All interfaces in a multilink bundle must have the same bandwidth.
Examples
The following example designates serial interface 1 as part of multilink bundle 1:
interface serial 1encapsulation pppmultilink-group 1ppp multilinkppp authentication chappulse-time 3Related Commands
netbios nbf
To enable the NetBIOS Frames Protocol (NBF) on an interface, use the netbios nbf command in interface configuration mode. Use the no form of this command to disable NetBIOS Frames Protocol support on an interface.
netbios nbf
no netbios nbf
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Interface configuration
Command History
Examples
The following example enables NetBIOS Frames Protocol on asynchronous interface 1 (connected to remote access client using a NetBEUI application) and Ethernet interface 0 (connected to the remote router):
interface async 1netbios nbfinterface ethernet 0netbios nbfRelated Commands
network-clock-priority
To specify the clock-recovery priority for the BRI voice ports in a BRI voice module (BVM), use the network-clock-priority command in interface configuration mode . Use the no form of this command to restore the default (low) clock-recovery priority.
network-clock-priority {low | high}
no network-clock-priority {low | high}
Syntax Description
low
The BRI port is second priority to recover clock.
high
The BRI port is first priority to recover clock.
Defaults
Each BRI voice port has low clock-recovery priority.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported only on the Cisco MC3810.
This command is only valid for BRI ports configured as TE. It allows you to select which PINX (PBX) is the first-priority clock source.
This command becomes effective only when the BVM is the clock source for the Cisco MC3810; this happens in three ways:
•
When the BVM is specified as the first-priority network clock source through the network-clock-select command.
•
•
The BRI voice port supplying clock operates as a line source; if there are other BRI voice ports configured as TE, they operate in loop-timed mode.
Regardless of the network-clock-priority setting, the first TE-configured BRI voice port that becomes active is automatically chosen to supply clock. The clock source does not change if another BRI voice port configured for network-clock-priority high becomes active.
If the chosen clocking port becomes inactive, the system searches for clock on the active TE-configured ports in the following order:
1.
2.
If the originally chosen port then reactivates, it resumes its role as clock source regardless of its network-clock-priority setting.
If you enter either the no network-clock-priority low or the no network-clock-priority high command, the network clock priority defaults to low.
Examples
The following example configures BRI voice port 1 as a first priority clock source:
interface bri 1network-clock-priority highRelated Commands
network-clock-select
To specify selection priority for the clock sources, use the network-clock-select command in global configuration mode. Use the no form of this command to cancel the network clock selection.
network-clock-select priority {serial 0 | system | bvm | controller}
no network-clock-select priority {serial 0 | system | bvm | controller}
Syntax Description
Defaults
No network clock source is specified.
Command Modes
Global configuration
Command History
11.3MA
This command was introduced.
12.0(3)XG
The BVM as a possible network clock source was added.
Usage Guidelines
When an active clock source fails, the system chooses the next lower priority clock source specified by this command. When a higher-priority clock becomes available, the system automatically reselects the higher-priority clock source.
Note
Use the network-clock-select command to establish the clock-selection priority when there are multiple sources of line (network) clocking in a Cisco MC3810. Possible sources of line clocking for the Cisco MC3810 are the BRI voice module (BVM), the multiflex trunk module (MFT), and a serial port configured for clock rate line.
Examples
The following example sets a possible clock selection priority in a Cisco MC3810 with a digital voice module (DVM) installed:
network-clock-select 1 T1 0 network-clock-select 2 T1 1 network-clock-select 3 serial 0 network-clock-select 4 systemThe following example sets a possible clock selection priority in a Cisco MC3810 with a BRI voice module (BVM) installed:
network-clock-select 1 T1 0 network-clock-select 2 bvm network-clock-select 3 serial 0 network-clock-select 4 systemRelated Commands
number
To add a DNIS number to a dialer DNIS group, use the number command in DNIS group configuration mode followed by the specifying number. Use the no form of this command to remove a DNIS number from a DNIS group.
number number
no number number
Syntax Description
Defaults
No default behavior or values.
Command Modes
DNIS group configuration
Command History
Usage Guidelines
Use the number DNIS group configuration command to enter a DNIS number to a dialer DNIS group. The Cisco IOS software also includes a feature that streamlines the DNIS configuration process. By replacing any digit with an X (for example, issuing the number 555222121x command), clients dialing different numbers, such as 5552221214 or 5552221215, are automatically mapped to the same customer profile. The X variable is a place holder for the digits 1 through 9.
Examples
The following example shows a DNIS group called dnis_isp_1 and DNIS numbers 1234 and 5678 assigned to the DNIS group:
dialer dnis group dnis_isp_1number 1234number 5678Related Commands
pad
To log in to a packet assembler/disassembler (PAD), use the pad command in EXEC mode.
pad {x121-address | hostname} [/cud text] [/debug] [/profile name] [/quiet message] [/reverse] [/use-map]
Syntax Description
Command Modes
User EXEC
Command History
Usage Guidelines
The pad command supports one-word connections. You need not enter the pad command; just entering the address is enough to start the connection. A PAD can also be accessed and X.3 parameters configured with the x28 EXEC command, which uses the standard X.28 user interface.
You can have several PAD connections open at the same time and switch between them. You also can exit a connection and return to the user EXEC prompt at any point. To open a new connection, first exit the current connection by entering the escape sequence (Ctrl-Shift-6 then x [Ctrl^x] by default) to return to the EXEC prompt, then open the new connection. If the /use-map option is selected on the outgoing pad command, the x25 map pad command entries are searched for a matching X.121 destination address. If a match is found, the x25 map pad command entry options (such as CUD and idle) and facilities (such as packet in, packet out, win in, and win out) are applied to the outgoing PAD call.
To display information about packet transmission and X.3 PAD parameter settings, use the show x25 pad command.
To exit a session, simply log off the remote system. Then, terminate the active session by entering the exit command.
Examples
Use the ? command to display pad command options, as shown in this example:
router# pad / ?/cud Call user data/debug Debugging option/profile Use a defined X.3 profile/quiet Suppress informational messages/reverse X25 Address reverse/use-map Use x25 map pad command facilities for outgoing CallsThe following example starts a PAD session:
router> pad 123456789Trying 123456789...Openrouter>You can also access a PAD using standard X.28 commands. The following example enters X.28 mode with the x28 EXEC command and configures a PAD with the set X.3 parameter command. The set command sets the idle time delay to 40 seconds.
router# x28* set 4:40The following example uses the /use-map option to configure a larger window and packet size than the default specified on the interface, and it sets the VC idle time to 2 seconds. Notice that the map values are used rather than the interface default values.
Router-A(config-if)# x25 map pad 2194441 cud gmcmilla windowsize 7 7 packetsize 1024 1024 idle 2Router-A(config-if)# endRouter-A#%SYS-5-CONFIG_I: Configured from console by console.Router-A# pad 2194441 /cud gmcmillla /use-mapTrying 2194441....Open06:31:12: pad_open_connection: found a matching x25 map pad06:31:12: Serial1: X.25 O R1 Call (22) 8 lci 102406:31:12: From(7): 2191111 To(7): 219444106:31:12: Facilities: (6)06:31:12: Packet sizes: 1024 102406:31:12: Window sizes: 7 706:31:12: Call User Data (12): 0x01000000 (pad)06:31:12: Serial1: X.25 I R1 Call Confirm (5) 8 lci 102406:31:12: From(0): To(0):06:31:12: Facilities: (0)06:31:12: PAD0: Call completedRelated Commands
Automatically translates the request to another outgoing protocol connection type when an X.25 connection request to a particular destination address is received.
peer default ip address
To specify an IP address, an address from a specific IP address pool, or an address from the Dynamic Host Configuration Protocol (DHCP) mechanism to be returned to a remote peer connecting to this interface, use the peer default ip address command in interface configuration mode. Use the no form of this command to disable a prior peer IP address pooling configuration on an interface.
To remove the default address from your configuration, use the no form of this command also.
peer default ip address {ip-address | dhcp | pool [pool-name-list]}
no peer default ip address
Syntax Description
Defaults
The default is pool.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command applies to point-to-point interfaces that support the PPP or Serial Line Internet Protocol (SLIP) encapsulation. This command sets the address used on the remote (PC) side.
Note
This command allows an administrator to configure all possible address pooling mechanisms on a interface-by-interface basis.
The peer default ip address command can override the global default mechanism defined by the ip address-pool command on an interface-by-interface basis, as follows:
•
•
•
•
Examples
The following command specifies that this interface will use a local IP address pool called pool3:
peer default ip address pool pool3The following command specifies that this interface will use the IP address 172.140.34.21:
peer default ip address 172.140.34.21The following command reenables the global default mechanism to be used on this interface:
peer default ip address poolThe following example specifies address 192.31.7.51 for async interface 6:
line 20speed 115200interface async 6peer default ip address 192.31.7.51Related Commands
pool-member
To assign a request-dialout virtual private dialup network (VPDN) subgroup to a dialer pool, use the pool-member command in request-dialout configuration mode. To remove the request-dialout VPDN subgroup from a dialer pool, use the no form of this command
pool-member pool-number
no pool-member [pool-number]
Syntax Description
Defaults
Disabled
Command Modes
Request-dialout configuration
Command History
Usage Guidelines
You must first enable the protocol l2tp on the request-dialout VPDN subgroup before you can enable the pool-member command. Removing the protocol l2tp command will remove the pool-member command from the request-dialout subgroup.
You can only configure one dialer profile pool (using the pool-member command) or dialer rotary group (using the rotary-group command). If you attempt to configure a second dialer resource, you will replace the first dialer resource in the configuration.
Examples
The following example configures VPDN group 1 to request L2TP dialout to IP address 172.5.4.6 using dialer profile pool 1 and identifying itself using the local name harold.
vpdn-group 1request-dialoutprotocol l2tppool-member 1initiate-to ip 172.5.4.6local name haroldRelated Commands
pool-range
To assign a range of modems to a modem pool, use the pool-range command in modem-pool configuration mode.
Cisco AS5200 and Cisco AS5300 access servers
pool-range number-number
Syntax Description
Defaults
Disabled. All modems are configured to be part of the system default modem pool.
Command Modes
Modem pool configuration
Command History
Usage Guidelines
For a complete description of modem pools and how they are configured on Cisco access servers, see the command reference page for the modem-pool command.
Replace the number-number variable with the modem TTY line numbers that correspond with the range of modems you want in the modem pool. TTY line numbers start from 1, which map to modem numbers that start from 0. For example, if you want to include modems 1/0 through 1/23 in a pool range, use the TTY line numbers 1 to 24. To verify the modem to TTY line numbering scheme, use the show modem slot/port command.
Note
Examples
The following example assigns modem TTY line numbers 30 to 50 to a modem pool. The DNIS number is set to 2000. The customers dialing 2000 are guaranteed access to 21 modems. The 22nd client to dial in is refused connectivity because the maximum number of allowable connections is exceeded.
modem-pool v90servicepool-range 30-50called-number 2000 max-conn 21exitThe following configuration rejects the pool-range 30 command, because modem TTY line 30 is already a member of the modem pool v90service, which was configured in the previous example. Each modem in the access server is automatically assigned to a unique TTY line. TTY line numbers are assigned according to your shelf, slot, or port hardware configuration.
modem-pool v34servicepool-range 30% TTY 30 is already in another pool.Related Commands
ppp
To start an asynchronous connection using PPP, use the ppp command in EXEC mode.
ppp {/default | {remote-ip-address | remote-name} [@tacacs-server]} [/routing]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
When you connect from a remote node computer to an EXEC session on the access server and want to connect from the access server to a device on the network, issue the ppp command.
If you specify an address for the TACACS server (either /default or tacacs-server), the address must be the first parameter in the command after you type ppp. If you do not specify an address or enter the default keyword, you are prompted for an IP address or host name. You can enter the default keyword at this point.
To terminate a session, disconnect from the device on the network using the command specific to that device. Then, exit from the EXEC by using the exit command.
Examples
The following example shows a line that is in asynchronous mode using PPP encapsulation. The PC's name (ntpc in this example) must be in the Domain Name System (DNS) so that it can be resolved to a real IP address). The PC must be running a terminal emulator program.
ppp ntpc@server1ppp bap call
To set PPP Bandwidth Allocation Protocol (BACP) call parameters, use the ppp bap call command in interface configuration mode. Use the no form of this command to disable processing of a specific type of incoming connection.
ppp bap call {accept | request | timer seconds}
no ppp bap call {accept | request | timer}
Syntax Description
Defaults
accept—Peers can initiate the addition of links to a multilink bundle.
The timer is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command can be included in a virtual interface template for configuring virtual interfaces or can be used to configure a dialer interface.
Examples
The following example configures a dialer interface to accept calls. Accepting calls is the default, but the command is included for the sake of the example.
interface dialer 1ip unnumbered ethernet 0encapsulation pppppp multilink bapppp bap call acceptppp bap link types isdn analogdialer load threshold 30ppp bap timeout pending 60Related Commands
ppp bap callback
To enable PPP Bandwidth Allocation Protocol (BACP) callback and set callback parameters, use the ppp bap callback command in interface configuration mode. Use the no form of this command to remove the PPP BACP callback configuration.
ppp bap callback {accept | request | timer seconds}
no ppp bap callback {accept | request | timer}
Syntax Description
Defaults
Callback is disabled and no callback parameters are set.
The timer is disabled.
Command Modes
Interface configuration
Command History
Examples
The following example configures a BRI interface for active mode BACP:
interface bri 0ip unnumbered ethernet 0dialer load-threshold 10 eitherdialer map ip 172.21.13.101 name bap-peer 14085778899encapsulation pppppp multilink bapppp bap call requestppp bap callback acceptno ppp bap call acceptno ppp bap drop acceptppp bap pending timeout 30ppp bap number default 5664567ppp bap number secondary 5664568Related Commands
ppp bap drop
To set parameters for removing links from a multilink bundle, use the ppp bap drop command in interface configuration mode. Use the no form of this command to disable a specific type of default processing.
ppp bap drop {accept | after-retries | request | timer seconds}
no ppp bap drop {accept | after-retries | request | timer}
Syntax Description
Defaults
accept, request: Peers can initiate link removal and this router also can initiate link removal.
no ppp bap drop after-retries: The link is not dropped when there is no response to drop requests.
timer: Disabled; no default value is defined.
Command Modes
Interface configuration
Command History
Usage Guidelines
The no ppp bap drop accept command disables the router's ability to respond favorably to link drop requests from a peer. However, the router can still remove the link when it receives such requests.
The no ppp bap drop after-retries command is the default behavior; the ppp bap drop after-retries command must be entered explicitly to be effective.
The no ppp bap drop request command disables the router's ability to send link drop requests to a peer. However, the peer can still remove the link on its own behalf; for example, when there is too little traffic to justify keeping the link up.
The ppp bap max command specifies the maximum number of requests and retries.
Examples
The following partial example sets a 60-second wait between drop requests:
ppp bap drop timer 60Related Commands
ppp bap link types
To specify the types of links that can be included in a specific multilink bundle, use the ppp bap link types command in interface configuration mode. Use the no form of this command to remove a type of interface that was previously allowed to be added.
ppp bap link types [isdn] [analog]
no ppp bap link types [isdn] [analog]
Syntax Description
isdn
(Optional) ISDN interfaces can be added to a multilink bundle. This is the default.
analog
(Optional) Asynchronous serial interfaces can be added to a multilink bundle.
Defaults
isdn
Command Modes
