Cisco IOS Dial Services Commands: MU Through PPP

This chapter explains the function and syntax of the Cisco IOS dial services commands from MU through PPP. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Dial Services Command Reference, Release 12.1.

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

number

Number of the virtual template; an integer in the range 1 through 9.

number	Number of the virtual template; an integer in the range 1 through 9.

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

group-number

Number of the multilink bundle (a nonzero number).

group-number	Number of the multilink bundle (a nonzero number).

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.

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.

low	The BRI port is second priority to recover clock.
high	The BRI port is first priority to recover clock.

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

priority

Selection priority for the clock source from 1 (highest) to 4 (lowest).

serial 0

Clocking priority for serial interface 0.

system

Clocking priority for the system clock.

bvm

Clocking priority for the BRI voice module (BVM).

controller

Clocking priority for either the trunk controller (T1/E1 0) or the digital voice module (T1/E1/ 1).

priority	Selection priority for the clock source from 1 (highest) to 4 (lowest).
serial 0	Clocking priority for serial interface 0.
system	Clocking priority for the system clock.
bvm	Clocking priority for the BRI voice module (BVM).
controller	Clocking priority for either the trunk controller (T1/E1 0) or the digital voice module (T1/E1/ 1).

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

number

Specifies a DNIS number, which can have up to 65 digits.

number	Specifies a DNIS number, which can have up to 65 digits.

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

x121-address

Specifies the X.121 address of the X.25 host.

hostname

Specifies the X.25 host name if the host-to-address mapping has been set with the X.25 host command.

/cud text

(Optional) Includes the specified text in the Call User Data field of the outgoing Call Request Packet.

/debug

(Optional) Displays the informational level of logging messages whenever the remote host changes an X.3 parameter setting or sends any other X.29 control packet.

/profile name

(Optional) Sets X.3 PAD parameters for the name script. This is the same as issuing the x29 profile global configuration command when translating X.25. If the X.29 profile is set to default, the profile is applied to all incoming X.25 PAD calls, including the calls used for protocol translation.

/quiet message

(Optional) Suppresses information messages. Replace the argument message with the actual message that you want to suppress.

/reverse

(Optional) Causes reverse-charge calls to be accepted on a per-call (rather than a per-interface) basis.

/use-map

(Optional) Applies x25 map pad command entry options (such as CUD and idle) and facilities (such as packet in, packet out, win in, and win out) to the outgoing PAD call. This function occurs only if a matching X.121 destination address exists in a x25 map pad command entry.

x121-address	Specifies the X.121 address of the X.25 host.
hostname	Specifies the X.25 host name if the host-to-address mapping has been set with the X.25 host command.
/cud text	(Optional) Includes the specified text in the Call User Data field of the outgoing Call Request Packet.
/debug	(Optional) Displays the informational level of logging messages whenever the remote host changes an X.3 parameter setting or sends any other X.29 control packet.
/profile name	(Optional) Sets X.3 PAD parameters for the name script. This is the same as issuing the x29 profile global configuration command when translating X.25. If the X.29 profile is set to default, the profile is applied to all incoming X.25 PAD calls, including the calls used for protocol translation.
/quiet message	(Optional) Suppresses information messages. Replace the argument message with the actual message that you want to suppress.
/reverse	(Optional) Causes reverse-charge calls to be accepted on a per-call (rather than a per-interface) basis.
/use-map	(Optional) Applies x25 map pad command entry options (such as CUD and idle) and facilities (such as packet in, packet out, win in, and win out) to the outgoing PAD call. This function occurs only if a matching X.121 destination address exists in a x25 map pad command entry.

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.

peer default ip address {ip-address | dhcp | pool [pool-name]}

no peer default ip address

Syntax Description

ip-address

Specific IP address to be assigned to a remote peer dialing in to the interface. To prevent duplicate IP addresses from being assigned on more than one interface, this command argument cannot be applied to a dialer rotary group nor to an ISDN interface.

dhcp

Retrieve an IP address from the DHCP server.

pool

Use the global default mechanism as defined by the ip address-pool command unless the optional pool-name argument is supplied. This is the default.

pool-name

(Optional) Name of a local address pool created using the ip local pool command. Retrieve an address from this pool regardless of the global default mechanism setting.

ip-address	Specific IP address to be assigned to a remote peer dialing in to the interface. To prevent duplicate IP addresses from being assigned on more than one interface, this command argument cannot be applied to a dialer rotary group nor to an ISDN interface.
dhcp	Retrieve an IP address from the DHCP server.
pool	Use the global default mechanism as defined by the ip address-pool command unless the optional pool-name argument is supplied. This is the default.
pool-name	(Optional) Name of a local address pool created using the ip local pool command. Retrieve an address from this pool regardless of the global default mechanism setting.

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

pool-number

The dialer pool that this VPDN group belongs to.

pool-number	The dialer pool that this VPDN group belongs to.

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

number-number

Assigns a range of tty lines, which correspond to ranges of modems, to a modem pool. A dash (-) is required between the two modem numbers. The range of modems you can choose from is equivalent to the number of modems in your access server that are not currently associated with another modem pool.

number-number	Assigns a range of tty lines, which correspond to ranges of modems, to a modem pool. A dash (-) is required between the two modem numbers. The range of modems you can choose from is equivalent to the number of modems in your access server that are not currently associated with another modem pool.

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

/default

Makes a PPP connection when a default address has been configured.

remote-ip-address

IP address of the client workstation or PC. This parameter can only be specified if the line is set for dynamic addresses using the async address dynamic line configuration command.

remote-name

Name of the client workstation or PC. This parameter can be specified if the line is set for dynamic addresses using the async address dynamic line configuration command.

@tacacs-server

(Optional) IP address or IP host name of the TACACS server to which the user's TACACS authentication request is sent.

/routing

(Optional) Indicates that the remote system is a router and that routing messages should be exchanged over the link. The line must be configured for asynchronous routing using PPP encapsulation.

/default	Makes a PPP connection when a default address has been configured.
remote-ip-address	IP address of the client workstation or PC. This parameter can only be specified if the line is set for dynamic addresses using the async address dynamic line configuration command.
remote-name	Name of the client workstation or PC. This parameter can be specified if the line is set for dynamic addresses using the async address dynamic line configuration command.
@tacacs-server	(Optional) IP address or IP host name of the TACACS server to which the user's TACACS authentication request is sent.
/routing	(Optional) Indicates that the remote system is a router and that routing messages should be exchanged over the link. The line must be configured for asynchronous routing using PPP encapsulation.

ppp 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

accept

Peer initiates link addition. This is the default.

request

Local side initiates link addition.

timer seconds

Number of seconds to wait between call requests the router sends, in the range 2 to 120 seconds. No default value is set.

accept	Peer initiates link addition. This is the default.
request	Local side initiates link addition.
timer seconds	Number of seconds to wait between call requests the router sends, in the range 2 to 120 seconds. No default value is set.

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

accept

Local router initiates link addition upon peer notification.

request

Local router requests that a peer initiate link addition.

timer seconds

Number of seconds to wait between callback requests the router sends, in the range 2 to 120 seconds. Disabled by default.

accept	Local router initiates link addition upon peer notification.
request	Local router requests that a peer initiate link addition.
timer seconds	Number of seconds to wait between callback requests the router sends, in the range 2 to 120 seconds. Disabled by default.

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

accept

Peer can initiate link removal. Enabled by default.

after-retries

Local router can remove the link without Bandwidth Allocation Protocol (BACP) negotiation when no response to the drop requests arrives.

request

Local router can initiate removal of a link. Enabled by default.

timer seconds

Number of seconds to wait between drop requests sent.

accept	Peer can initiate link removal. Enabled by default.
after-retries	Local router can remove the link without Bandwidth Allocation Protocol (BACP) negotiation when no response to the drop requests arrives.
request	Local router can initiate removal of a link. Enabled by default.
timer seconds	Number of seconds to wait between drop requests sent.

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.

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.

ppp bap max

To set upper limits on the number of retransmissions for PPP Bandwidth Allocation Protocol (BACP), use the ppp bap max command in interface configuration mode. Use the no form of this command to remove any retry limit.

ppp bap max {dial-attempts number | ind-retries number | req-retries number | dialers number}

no ppp bap max {dial-attempts | ind-retries | req-retries | dialers number}

Syntax Description

dial-attempts number

Maximum number of dial attempts to any destination number, in the range 1 to 3. The default is 1 dial attempt.

ind-retries number

Maximum number of retries of a call status indication message, in the range 1 to 10. The default is 3 indication retries.

req-retries number

Maximum number of retries for a particular request, in the range 1 to 5. The default is 3 request retries.

dialers number

Maximum number of free dialers logged, in the range 1 to 10. The default is 5 dialers.

dial-attempts number	Maximum number of dial attempts to any destination number, in the range 1 to 3. The default is 1 dial attempt.
ind-retries number	Maximum number of retries of a call status indication message, in the range 1 to 10. The default is 3 indication retries.
req-retries number	Maximum number of retries for a particular request, in the range 1 to 5. The default is 3 request retries.
dialers number	Maximum number of free dialers logged, in the range 1 to 10. The default is 5 dialers.

ppp bap monitor load

To validate peer requests to add or remove links against the current bundle load and the defined dialer load threshold, use the ppp bap monitor load command in interface configuration mode. Use the no form of this command to specify that incoming link addition requests are not to be subject to the bundle load threshold.

ppp bap monitor load

no ppp bap monitor load

Syntax Description

This command has no arguments or keywords.

ppp bap number

To specify a local telephone number that peers can dial to establish a multilink bundle, use the ppp bap number command in interface configuration mode. Use the no form of this command to remove a previously configured number.

ppp bap number {default phone-number | secondary phone-number | prefix prefix-number}

no ppp bap number {default phone-number | secondary phone-number | prefix prefix-number}

ppp bap number {format national | subscriber}

no ppp bap number {format national | subscriber}

Syntax Description

default phone-number

Primary (base) phone number for the interface and the number that can be used for incoming dial calls.

secondary phone-number

Telephone number for the second B channel. Applies only to BRI interfaces that have a different number for each B channel or to dialer interfaces that are BRIs.

prefix prefix-number

Prefix number for the PPP BAP phone number.

format national | subscriber

Format for the primary phone number to be dialed should be either national or subscriber where the number of digits assigned to the number is as follows:

10-digit number for a national format.

7-digit number for a subscriber format.

default phone-number	Primary (base) phone number for the interface and the number that can be used for incoming dial calls.
secondary phone-number	Telephone number for the second B channel. Applies only to BRI interfaces that have a different number for each B channel or to dialer interfaces that are BRIs.
prefix prefix-number	Prefix number for the PPP BAP phone number.
format national \| subscriber	Format for the primary phone number to be dialed should be either national or subscriber where the number of digits assigned to the number is as follows: 10-digit number for a national format. 7-digit number for a subscriber format.

ppp bap timeout

To specify nondefault timeout values for PPP Bandwidth Allocation Protocol (BACP) pending actions and responses, use the ppp bap timeout command in interface configuration mode. Use the no form of this command to reset the response timeout to the default value, or to remove a pending timeout entirely.

ppp bap timeout {pending seconds | response seconds}

no ppp bap timeout {pending | response}

Syntax Description

pending seconds

Number of seconds to wait before timing out pending actions, in the range 2 to 180 seconds. The default is 20 seconds.

response seconds

Number of seconds to wait for a response before timing out, in the range 2 to 120 seconds. The default is 3 seconds.

pending seconds	Number of seconds to wait before timing out pending actions, in the range 2 to 180 seconds. The default is 20 seconds.
response seconds	Number of seconds to wait for a response before timing out, in the range 2 to 120 seconds. The default is 3 seconds.

ppp bridge appletalk

To enable half-bridging of AppleTalk packets across a serial interface, use the ppp bridge appletalk command in interface configuration mode. Use the no form of this command to disable AppleTalk packet half-bridging.

ppp bridge appletalk

no ppp bridge appletalk

Syntax Description

This command has no arguments or keywords.

ppp bridge ip

To enable half-bridging of IP packets across a serial interface, use the ppp bridge ip command in interface configuration mode. Use the no form of this command to disable IP packet half-bridging.

ppp bridge ip

no ppp bridge ip

Syntax Description

This command has no arguments or keywords.

ppp bridge ipx

To enable half-bridging of Internetwork Packet Exchange (IPX) packets across a serial interface, use the ppp bridge ipx command in interface configuration mode. Use the no form of this command to return to novell-ether encapsulation.

ppp bridge ipx [novell-ether | arpa | sap | snap]

no ppp bridge ipx

Syntax Description

novell-ether

(Optional) Use Novell's Ethernet_802.3 encapsulation. This is the default.

arpa

(Optional) Use Novell's Ethernet_II encapsulation.

sap

(Optional) Use Novell's Ethernet_802.2 encapsulation.

snap

(Optional) Use Novell Ethernet_Snap encapsulation.

novell-ether	(Optional) Use Novell's Ethernet_802.3 encapsulation. This is the default.
arpa	(Optional) Use Novell's Ethernet_II encapsulation.
sap	(Optional) Use Novell's Ethernet_802.2 encapsulation.
snap	(Optional) Use Novell Ethernet_Snap encapsulation.

ppp callback (DDR)

To enable a dialer interface that is not a data terminal ready (DTR) interface to function either as a callback client that requests callback or as a callback server that accepts callback requests, use the ppp callback command in interface configuration mode.

ppp callback {accept | request}

Syntax Description

accept

Enables this dialer interface to accept PPP callback requests (and function as the PPP callback server).

request

Enables this dialer interface to request PPP callback (and function as the PPP callback client).

accept	Enables this dialer interface to accept PPP callback requests (and function as the PPP callback server).
request	Enables this dialer interface to request PPP callback (and function as the PPP callback client).

ppp callback (PPP client)

To enable a PPP client to dial in to an asynchronous interface and request a callback, use the ppp callback command in interface configuration mode. Use the no form of this command to disable callback acceptance.

ppp callback {accept | initiate}

no ppp callback

Syntax Description

accept

Accept callback requests from RFC1570-compliant PPP clients on the interface.

initiate

Initiate a callback to non-RFC1570-compliant PPP clients dialing in to an asynchronous interface.

accept	Accept callback requests from RFC1570-compliant PPP clients on the interface.
initiate	Initiate a callback to non-RFC1570-compliant PPP clients dialing in to an asynchronous interface.

ppp ipcp

To configure the primary and secondary Domain Name System (DNS) addresses, or the primary and secondary WINS server addresses to be supplied to the peer during IP Control Protocol (IPCP) negotiation, use the ppp ipcp command in template configuration mode. To delete a ppp ipcp configuration, use the no form of this command.

ppp ipcp {accept-address} | {dns [primary dns ip-address | secondary dns ip-address]}| {ignore-map} | {wins [primary wins ip-address | secondary wins ip-address]}

no ppp ipcp {accept-address} | {dns [primary dns ip-address | secondary dns ip-address]}| {ignore-map} | {wins [primary wins ip-address | secondary wins ip-address]}

Syntax Description

accept-address

Accept any non-zero IP address from the peer.

dns

Domain name server.

primary dns

(Optional) Primary domain name server. Specify DNS address to provide.

ip-address

(Optional) IP address of the primary or secondary DNS or WINS server.

secondary dns

(Optional) Secondary domain name server.

ignore-map

Ignore dialer map when negotiating peer IP address.

wins

Windows Internet naming service. Specify WINS address to provide.

primary wins

(Optional) Primary Windows Internet naming service.

secondary wins

(Optional) Secondary Windows Internet naming service.

accept-address	Accept any non-zero IP address from the peer.
dns	Domain name server.
primary dns	(Optional) Primary domain name server. Specify DNS address to provide.
ip-address	(Optional) IP address of the primary or secondary DNS or WINS server.
secondary dns	(Optional) Secondary domain name server.
ignore-map	Ignore dialer map when negotiating peer IP address.
wins	Windows Internet naming service. Specify WINS address to provide.
primary wins	(Optional) Primary Windows Internet naming service.
secondary wins	(Optional) Secondary Windows Internet naming service.

ppp max-bad-auth

To configure a point-to-point interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries, use the ppp max-bad-auth command in interface configuration mode. Use the no form of this command to reset to the default of immediate reset.

ppp max-bad-auth number

no ppp max-bad-auth

Syntax Description

number

Number of retries after which the interface is to reset itself. Default is 0.

number	Number of retries after which the interface is to reset itself. Default is 0.

ppp multilink

To enable Multilink PPP (MLP) on an interface and, optionally, to enable dynamic bandwidth allocation, use the ppp multilink command in interface configuration mode. Use the no form of this command to disable Multilink PPP or, optionally, to disable only dynamic bandwidth allocation.

ppp multilink [bap]

no ppp multilink [bap [required]]

Syntax Description

bap

(Optional) Specifies bandwidth allocation control negotiation and dynamic allocation of bandwidth on a link.

required

(Optional) Enforces mandatory negotiation of Bandwidth Allocation Protocol (BACP) for the multilink bundle. The multilink bundle is disconnected if BACP is not negotiated.

bap	(Optional) Specifies bandwidth allocation control negotiation and dynamic allocation of bandwidth on a link.
required	(Optional) Enforces mandatory negotiation of Bandwidth Allocation Protocol (BACP) for the multilink bundle. The multilink bundle is disconnected if BACP is not negotiated.

ppp multilink fragment-delay

To configure a maximum delay allowed for transmission of a packet fragment on a Multilink PPP (MLP) bundle, use the ppp multilink fragment-delay command in interface configuration mode. Use the no form of the command to reset the maximum delay to the default value.

ppp multilink fragment-delay milliseconds

no ppp multilink fragment-delay

Syntax Description

milliseconds

Maximum delay, in milliseconds, allowed for any packet fragment. Default is 30 milliseconds.

milliseconds	Maximum delay, in milliseconds, allowed for any packet fragment. Default is 30 milliseconds.

ppp multilink idle-link

To configure the Multilink PPP (MLP) bundle so that the first link member enters into "receive-only" mode when an additional B channel is added, use the ppp multilink idle-link command in interface configuration mode. Use the no form of this command to remove this functionality.

ppp multilink idle-link

no ppp multilink idle-link

Syntax Description

This command has no arguments or keywords.

ppp multilink interleave

To enable interleaving of Real-Time Transport Protocol (RTP) packets among the fragments of larger packets on a Multilink PPP (MLP) bundle, use the ppp multilink interleave command in interface configuration mode. Use the no form of the command to disable interleaving.

ppp multilink interleave

no ppp multilink interleave

Syntax Description

This command has no arguments and keywords.

ppp quality

To enable Link Quality Monitoring (LQM) on a serial interface, use the ppp quality command in interface configuration mode. Use the no form of this command to disable LQM.

ppp quality percentage

no ppp quality

Syntax Description

percentage

Specifies the link quality threshold. Range is 1 to 100.

percentage	Specifies the link quality threshold. Range is 1 to 100.

ppp reliable-link

To enable Link Access Procedure, Balanced (LAPB) Numbered Mode negotiation for a reliable serial link, use the ppp reliable-link command in interface configuration mode. Use the no form of the command to disable negotiation for a PPP reliable link on a specified interface.

ppp reliable-link

no ppp reliable-link

Syntax Description

This command has no arguments and keywords.

Table of Contents

Cisco IOS Dial Services Commands: MU Through PPP