Syntax Description

number

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

Defaults

Disabled. No template number is defined.

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

Examples

multilink virtual-template 1
ip local pool default 2.2.2.2
interface virtual-template 1
 ip unnumbered ethernet 0
 encapsulation ppp
 ppp multilink 
 ppp authentication chap

Related Commands

Command	Description
interface virtual-template	Creates a virtual template interface that can be configured and applied dynamically in creating virtual access interfaces.
ip local pool	Configures a local pool of IP addresses to be used when a remote peer connects to a point-to-point interface.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

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 1
 netbios nbf
interface ethernet 0
 netbios nbf

Related Commands

Command	Description
netbios name-cache	Defines a static NetBIOS name cache entry, tying the server with the name netbios-name to the mac-address, and specifying that the server is accessible either locally through the interface-name specified, or remotely through the ring-group group-number specified.
show netbios cache	Displays a list of NetBIOS cache entries.
show nbf sessions	Displays NetBEUI connection information.

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

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

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.

• When the BVM is specified as a lower-priority network clock source, and a higher-priority network clock source is lost.

• When the BVM is the only network clock source.

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. Ports configured as network-clock-priority high in order from lowest (1) to highest (4).

2. Ports configured as network-clock-priority low in order from lowest (1) to highest (4).

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 1
network-clock-priority high

Related Commands

Command	Description
network-clock-select	Specifies selection priority for the clock sources.

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).

Defaults

No network clock source is specified.

Command Modes

Global configuration

Command History

Release	Modification
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 If the BRI backup port (BRI 0) is installed and becomes active, it automatically recovers network clock for as long as it remains active. However, you can not give port BRI 0 a clock-selection priority.

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 system
 

The 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 system

Related Commands

Command	Description
network-clock-switch	Configures the switch delay time to the next priority network clock source when the current network clock source fails.
network-clock-priority	Specifies the clock-recovery priority for the BRI voice ports in a BVM.

Syntax Description

number

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

Defaults

No default behavior or values.

Command Modes

DNIS group configuration

Command History

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

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_1
 number 1234
 number 5678

Related Commands

Command	Description
dnis group	Includes a group of DNIS numbers in a customer profile.

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.

Command Modes

User EXEC

Command History

Release	Modification
11.2	This command was introduced.

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 Calls
 

The following example starts a PAD session:

router> pad 123456789
Trying 123456789...Open
router>
 

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:40
 

The 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 2 
Router-A(config-if)# end
Router-A#
%SYS-5-CONFIG_I: Configured from console by console. 
Router-A# pad 2194441 /cud gmcmillla /use-map
Trying 2194441....Open
 
06:31:12: pad_open_connection: found a matching x25 map pad
06:31:12: Serial1: X.25 O R1 Call (22) 8 lci 1024
06:31:12:   From(7): 2191111 To(7): 2194441
06:31:12:   Facilities: (6)
06:31:12:     Packet sizes: 1024 1024
06:31:12:     Window sizes: 7 7
06:31:12:   Call User Data (12): 0x01000000 (pad)
06:31:12: Serial1: X.25 I R1 Call Confirm (5) 8 lci 1024
06:31:12:   From(0):  To(0): 
06:31:12:   Facilities: (0)
06:31:12: PAD0: Call completed

Related Commands

Command	Description
translate x25	Automatically translates the request to another outgoing protocol connection type when an X.25 connection request to a particular destination address is received.

To remove the default address from your configuration, use the no form of this command also.

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.

Defaults

The default is pool.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

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 replaces the async default ip address command.

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:

• For all interfaces not configured with a peer default IP address mechanism (equivalent to selecting the peer default ip address pool command), the router uses the global default mechanism that is defined by the ip address-pool command.

• If you select the peer default ip address pool pool-name form of this command, then the router uses the locally configured pool on this interface and does not follow the global default mechanism.

• If you select the peer default ip address ip-address form of this command, the specified IP address is assigned to any peer connecting to this interface and any global default mechanism is overridden for this interface.

• If you select the peer default ip address dhcp form of this command, the DHCP proxy-client mechanism is used by default on this interface and any global default mechanism is overridden for this interface.

Examples

The following command specifies that this interface will use a local IP address pool called pool3:

peer default ip address pool pool3
 

The following command specifies that this interface will use the IP address 172.140.34.21:

peer default ip address 172.140.34.21
 

The following command reenables the global default mechanism to be used on this interface:

peer default ip address pool
 

The following example specifies address 192.31.7.51 for async interface 6:

line 20
 speed 115200
interface async 6
 peer default ip address 192.31.7.51
 

Related Commands

Command	Description
async dynamic address	Specifies dynamic asynchronous addressing versus default addressing.
encapsulation slip	Enables SLIP encapsulation.
exec	Allows an EXEC process on a line.
ip address-pool	Enables an address pooling mechanism used to supply IP addresses to dial-in asynchronous, synchronous, or ISDN point-to-point interfaces.
ip dhcp-server	Specifies which DHCP servers to use on a network, and specifies the IP address of one or more DHCP servers available on the network.
ip local pool	Configures a local pool of IP addresses to be used when a remote peer connects to a point-to-point interface.
ppp	Starts an asynchronous connection using PPP.
show cot dsp	Displays the current DHCP settings on point-to-point interfaces.
slip	Starts a serial connection to a remote host using SLIP.

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.

Defaults

Disabled. All modems are configured to be part of the system default modem pool.

Command Modes

Modem pool configuration

Command History

Release	Modification
11.2P	This command was introduced.

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 MICA technologies and Microcom modems support incoming analog calls over ISDN PRI. However, only MICA modems support modem pooling for CT1 and CE1 configurations with channel associated signaling.

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 v90service
 pool-range 30-50
 called-number 2000 max-conn 21
 exit
 

The 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 v34service
 pool-range 30

% TTY 30 is already in another pool.

Related Commands

Command	Description
called-number	Assigns a called party number to a pool of modems.
clear modempool-counters	Clears active or running counters associated with one or more modem pools.
modem-pool	Creates a new modem pool or specifies an existing modem pool, which allows you to physically or virtually partition your access server for dial-in and dial-out access.
show modem-pool	Displays the configuration and connection status for one or more modem pools.

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.

Command Modes

EXEC

Command History

Release	Modification
10.0	This command was introduced.

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@server1

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.

Defaults

accept---Peers can initiate the addition of links to a multilink bundle.

The timer is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

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 1
 ip unnumbered ethernet 0
 encapsulation ppp
 ppp multilink bap
 ppp bap call accept
 ppp bap link types isdn analog
 dialer load threshold 30
 ppp bap timeout pending 60

Related Commands

Command	Description
ppp bap callback	Enables PPP BACP callback and set callback parameters.
ppp bap drop	Sets parameters for removing links from a multilink bundle.
ppp bap link types	Specifies the types of links that can be included in a specific multilink bundle.

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.

Defaults

Callback is disabled and no callback parameters are set.

The timer is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

Examples

The following example configures a BRI interface for active mode BACP:

interface bri 0
 ip unnumbered ethernet 0
 dialer load-threshold 10 either
 dialer map ip 172.21.13.101 name bap-peer 14085778899
 encapsulation ppp
 ppp multilink bap
 ppp bap call request
 ppp bap callback accept
 no ppp bap call accept
 no ppp bap drop accept
 ppp bap pending timeout 30
 ppp bap number default 5664567
 ppp bap number secondary 5664568

Related Commands

Command	Description
ppp bap drop	Sets parameters for removing links from a multilink bundle.
ppp bap link types	Specifies the types of links that can be included in a specific multilink bundle.
show ppp bap	Displays the configuration settings and run-time status for a multilink bundle.

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.

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

Release	Modification
11.3	This command was introduced.

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 60

Related Commands

Command	Description
ppp bap max	Sets upper limits on the number of retransmission for PPP BACP.

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

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

The choice of keywords must suit the interfaces configured for Multilink PPP. For example, if you have configured a dialer rotary with only ISDN interfaces, only the isdn keyword would be appropriate. If the configuration allows both ISDN and asynchronous interfaces, both isdn and analog keywords could be used; the multilink bundle could then consist of both ISDN and asynchronous links. Bandwidth Allocation Protocol (BACP) dynamically determines which interfaces are applicable.

Examples

The following example configures a dialer interface for passive mode BACP and for both ISDN and asynchronous serial links:

interface dialer 1
 ip unnumbered ethernet 0
 encapsulation ppp
 ppp multilink bap
 ppp bap call accept
 ppp bap link types isdn analog
 dialer load threshold 30
 ppp bap timeout pending 60

Related Commands

Command	Description
show ppp bap	Displays the configuration settings and run-time status for a multilink bundle.
ppp bap callback	Enables PPP BACP callback and set callback parameters.

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.

Defaults

1 dial attempt

3 indication retries

3 request retries

5 searches for free dialers

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

In compliance with RFC 2125, the no form of this command explicitly removes any status indication retry limit and is displayed in the router configuration.

The ppp bap max dialers command works in conjunction with the interface commands dialer rotor and dialer priority, which can be used to determine free dialers based upon the priority or the best available. Dialers include all interfaces that are configured under the dialer group leader (the dialer interface itself). The dialer group leader is displayed as the Master Interface in the show ppp bap group output.

BAP bases its link type and phone number decisions upon the ordering of the interfaces. This is suited to a mixed media environment of both ISDN and analog interfaces, where it may be desirable to choose the ISDN link over the asynchronous or vice versa.

Note that this also will limit the number of potential phone numbers which can be included in a CallResponse or CallbackRequest; the maximum number is limited to 20. For example, ten BRI interfaces with two numbers per interface.

Examples

The following partial example accepts the default number of attempts to dial a number and the default number of indication retries, but configures a limit of four times to send requests:

ppp bap max req-retries 4

Related Commands

Command	Description
dialer priority	Sets the priority of an interface in a dialer rotary group.
dialer rotor	Specifies the method for identifying the outbound line to be used for ISDN or asynchronous DDR calls.
ppp bap drop	Sets parameters for removing links from a multilink bundle.
ppp bap monitor load	Validates peer requests to add or remove links against the current bundle load and the defined dialer load threshold.
ppp bap timeout	Specifies nondefault timeout values for PPP BACP pending actions and responses.
show ppp bap group	Displays the configuration settings and run-time status for a multilink bundle.

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

The no form of the command indicates that incoming peer requests to add a link are not subject to the bundle load threshold. However, other criteria must be met before a favorable response is sent.

Examples

The following partial example configures BACP not to validate peer requests against the current bundle load and the configured dialer load threshold:

no ppp bap monitor load

Related Commands

Command	Description
dialer load-threshold	Configures bandwidth on demand by setting the maximum load before the dialer places another call to a destination.

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.

Defaults

No base number is provided.

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.
11.3T	The following keywords were added: prefix format

Usage Guidelines

Use this command to supply a local default number to be exchanged between peers in order to establish a multilink bundle.

This command is applicable on both the dialer interface and the individual physical interfaces.

If a peer requests that a number be supplied and no PPP BACP default number is defined, it might not be possible for the peer to access the interface. However, the peer can access the interface if it has the number already or the number it dialed originally is the same as the number for establishing a Multilink PPP bundle.

Note During BACP negotiations between peers, the called party indicates the number to call for BACP if it is different from the number the peer originally dialed. The called party responds with information about the phone number delta (the changes to be made in the right-most digits dialed). This information indicates the number of digits that are different from the number originally dialed and what those digits should be. For example, if the remote peer dialed 2157659876, and the ppp bap number command had the default number 2157659912, the local router would respond "3 | 912." In the response, a vertical bar ( | ) is used to divide the number of digits to change from the number sequence to use instead. In the "3 | 912" response, the local router instructs the calling interface to replace the right-most three digits with "912" for BACP.

Use the format keyword on the AO/DI server side to specify how many digits should be returned by BAP. BAP will return the numbers based on either a national or subscriber format. The value that is returned is preceded by the prefix before dialing occurs. For example, if the format national keywords are configured, then the national format (which is equivalent to 10 digits) is returned by BAP (during BAP negotiation) from the server.

Note The ppp bap number prefix and ppp bap number format keyword options cannot be combined to a single-string command line; they must be entered in two separate command strings.

Examples

In the following example, the AO/DI client uses a ppp bap prefix value of 9, which indicates that the dialed number of 5551234 will be preceded by a 9. The number that is actually dialed is 95551234. The AO/DI server uses a subscriber format, which indicates that when the client asks the server for the numbers to dial, BAP will return 7-digits.

Client router

interface dialer1
 ppp bap number prefix 9

Server Router

interface dialer1
 ppp bap number format subscriber
 ppp bap number default 5555678

In the following example, the AO/DI client uses a ppp bap prefix value of 1, which indicates that the dialed number of 5551234 will be preceded by a 1. The number that is actually dialed is 19195555678 because the server is using a national format, and BAP therefore, returns 10-digits.

Client Router

interface dialer1
 ppp bap number prefix 1

Server Router

interface dialer1
 ppp bap number format national
 ppp bap number default 9195555678

The following example configures a physical interface with both a default number and a secondary number:

interface bri 0
 ip unnumbered ethernet 0
 dialer load-threshold 10 either
 dialer map ip 172.21.13.101 name bap-peer 14085778899
 encapsulation ppp
 ppp multilink bap
 ppp bap call request
 ppp bap callback accept
 no ppp bap call accept
 no ppp bap drop accept
 ppp bap pending timeout 30
 ppp bap number default 5664567
 ppp bap number secondary 5664568
 

In the following example, a PRI with no BAP number defined accepts incoming dial attempts. The PRI interface has no base phone number defined, so each attempt to add a link would result in a delta of zero being provided to the calling peer. The calling peer should then dial the same number as it originally used to establish the bundle.

interface serial 0:23
 ip unnumbered Ethernet0
 encapsulation ppp
 dialer in-band
 dialer idle-timeout 300
 dialer-group 1
 no fair-queue
 no cdp enable
 ppp authentication chap
 ppp multilink bap
 ppp bap call accept
 ppp bap callback request
 ppp bap timeout pending 20
 ppp bap timeout response 2
 ppp bap max dial-attempts 2
 ppp bap monitor load
 

In the following example, a BRI interface with no BAP number defined initiates outgoing dial attempts. The BRI interface has no base phone number defined, so the number that it uses to establish the bundle is that from the dialer map, and all phone delta operations are applied to that number.

interface bri 0
 ip unnumbered Ethernet0
 encapsulation ppp
 dialer in-band
 dialer idle-timeout 300
 dialer map ip 10.1.1.1 name bap_peer speed 56 19998884444
 dialer-group 1
 no fair-queue
 no cdp enable
 ppp authentication chap
 ppp multilink bap
 ppp bap call request
 ppp bap timeout pending 20
 ppp bap timeout response 2
 ppp bap max dial-attempts 2
 ppp bap monitor load

Related Commands

Command	Description
ppp bap callback	Enables PPP BACP callback and set callback parameters.
show ppp bap	Displays the configuration settings and run-time status for a multilink bundle.

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.

Defaults

Enabled

pending---20 seconds

response---3 seconds

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

The no ppp bap timeout response command resets the timer to the default value.The no ppp bap timeout pending command removes the pending-action timeout entirely (in compliance with the BACP specification).

Examples

The following example configures BACP to wait 45 seconds before timing out pending actions:

interface dialer 1
 ip unnumbered ethernet 0
 encapsulation ppp
 ppp multilink bap
 ppp bap call accept
 ppp bap link types isdn analog
 dialer load threshold 30
 ppp bap timeout pending 45 

Related Commands

Command	Description
ppp bap callback	Enables PPP BACP callback and set callback parameters.
ppp bap drop	Sets parameters for removing links from a multilink bundle.
ppp bap max	Sets upper limits on the number of retransmission for PPP BACP.
show ppp bap	Displays the configuration settings and run-time status for a multilink bundle.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The serial interface must be configured with an AppleTalk address for communication on the Ethernet subnetwork, and the AppleTalk address must have the same AppleTalk cable range as the bridge.

You cannot configure a serial interface for both half-bridging and for transparent bridging.

No more than one half-bridge should be on any subnetwork.

Examples

The following example configures serial interface 0 for half-bridging of AppleTalk. The remote bridge and other Ethernet nodes must be on the same network.

interface serial 0
 ppp bridge appletalk
 appletalk cable-range 301-301
 appletalk zone remote-lan

Related Commands

Command	Description
appletalk cable-range	Enables an extended AppleTalk network.
appletalk zone	Sets the zone name for the connected AppleTalk network.
ppp bridge ip	Enables half-bridging of IP packets across a serial interfaces.
ppp bridge ipx	Enables half-bridging of IPX packets across a serial interfaces.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The interface must be configured with an IP address for communication on the Ethernet subnetwork, and the IP address must be on the same subnetwork as the bridge.

You cannot configure a serial interface for both half-bridging and for transparent bridging.

No more than one half-bridge should be on any subnetwork.

Examples

The following example configures serial interface 0 for half-bridging of IP. The remote bridge and other Ethernet nodes must be on the same subnetwork.

interface serial 0
 ip address 172.69.5.8
 ppp bridge ip

Related Commands

Command	Description
ip address	Sets a primary or secondary IP address for an interface.
ppp bridge appletalk	Enables half-bridging of AppleTalk packets across a serial interfaces.
ppp bridge ipx	Enables half-bridging of IPX packets across a serial interfaces.

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.

Defaults

Default encapsulation is novell-ether.

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The serial interface must be configured with an IPX address for communication on the Ethernet subnetwork, and the IPX address must be on the same subnetwork as the bridge.

You cannot configure a serial interface for both half-bridging and for transparent bridging.

No more than one half-bridge should be on any subnetwork.

Examples

The following example configures serial interface 0 for half-bridging of IPX. The remote bridge and other Ethernet nodes must be on the same subnetwork.

interface serial 0
 ppp bridge ipx 
 ipx network 1800

Related Commands

Command	Description
ipx network	Enables IPX routing on a particular interface and optionally selects the type of encapsulation (framing).
ppp bridge appletalk	Enables half-bridging of AppleTalk packets across a serial interfaces.
ppp bridge ip	Enables half-bridging of IP packets across a serial interfaces.

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).

Defaults

Callback requests are neither accepted nor requested.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

Examples

The following example configures a previously defined dialer interface to accept PPP callback requests:

ppp callback accept

Related Commands

Command	Description
dialer callback-secure	Enables callback security.
map-class dialer	Defines a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback.

Syntax Description

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.

Defaults

Callback requests are not accepted on asynchronous interfaces.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

PPP callback can only be initiated if the interface is configured for authentication using CHAP or PAP.

Examples

The following example accepts a callback request from an RFC-compliant PPP client:

ppp callback accept
 

The following example accepts a callback request from a non-RFC-compliant PPP client:

ppp callback initiate

Related Commands

Command	Description
arap callback	Enables an ARA client to request a callback from an ARA client.
autoselect ppp	Configures a line to start a SLIP session.
call progress tone country	Forces the Cisco IOS software to wait before initiating a callback to a requesting client.
ppp authentication	Enables CHAP or PAP or both and specifies the order in which CHAP and PAP authentication are selected on the interface.
username	Establishes a username-based authentication system, such as PPP CHAP and PAP.

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.

Defaults

No servers are configured.

Command Modes

Template configuration

Command History

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

Usage Guidelines

All PPP and peer-default commands are allowed under this grouping.

Examples

The following examples show use of the ppp ipcp command:

ppp ipcp accept-address
 
ppp ipcp dns 10.1.1.1 10.1.1.2
 
ppp ipcp ignore-map
 
ppp ipcp wins 10.1.1.1 10.1.1.2
 
no ppp ipcp wins 10.1.1.1 10.1.1.2

Syntax Description

number

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

Defaults

Default is 0.

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command applies to any serial interface (asynchronous serial, synchronous serial, or ISDN) on which PPP encapsulation is enabled.

Examples

The following example sets BRI interface 0 to allow two additional retries after an initial authentication failure (for a total of three failed authentication attempts):

interface bri 0
 encapsulation ppp
 ppp authentication chap 
 ppp max-bad-auth 3

Related Commands

Command	Description
exec	Allows an EXEC process on a line.

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.

Defaults

Disabled. When BACP is enabled, the defaults are to accept calls and to set the timeout pending at 30 seconds.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command applies only to interfaces that use PPP encapsulation.

PPP compression is allowed with MLP.

MLP is designed to work over single or multiple interfaces that are configured to support both dial-on-demand rotary groups and PPP encapsulation. This command applies asynchronous serial interfaces, ISDN BRIs, and ISDN PRIs.

MLP and PPP reliable links do not work together.

This command with the bap keyword must be used prior to configuring any ppp bap commands and options. If the bap required option is configured and a reject of the options is received, the multilink bundle is torn down.

The no form of the command without the bap keyword disables both MLP and BACP on the interface.

When BACP negotiation is enabled by this command, the following values are used during negotiations to identify the protocols:

Table 20: BACP and BAP Negotiation Values

Protocol	Hexadecimal Value
BACP	0xC02B
BAP	0xC02D

The dialer load-threshold command is used to enable a rotary group to bring up additional links and to add them to a multilink bundle.

Examples

The following partial example configures a dialer for Multilink PPP; it does not show the configuration of the physical interfaces.

interface Dialer0
 ip address 99.0.0.2 255.0.0.0
 encapsulation ppp
 dialer in-band
 dialer idle-timeout 500
 dialer map ip 99.0.0.1 name atlanta broadcast 81012345678901
 dialer load-threshold 30 either
 dialer-group 1
 ppp authentication chap
 ppp multilink

Related Commands

Command	Description
compress	Configures compression for LAPB, PPP, and HDLC encapsulations.
dialer-group	Controls access by configuring an interface to belong to a specific dialing group.
dialer fast-idle (interface configuration)	Specifies the idle time before the line is disconnected.
dialer load-threshold	Configures bandwidth on demand by setting the maximum load before the dialer places another call to a destination.
encapsulation ppp	Enables PPP encapsulation.
ppp authentication	Enables CHAP or PAP or both and specifies the order in which CHAP and PAP authentication are selected on the interface.
ppp bap timeout	Specifies nondefault timeout values for PPP BACP pending actions and responses.
show ppp bap	Displays the configuration settings and run-time status for a multilink bundle.

Syntax Description

milliseconds

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

Defaults

Disabled. Default delay is 30 milliseconds.

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

The ppp multilink fragment-delay command applies only to interfaces that can configure a bundle interface. These include virtual-templates, dialer interfaces, and ISDN BRI or PRI interfaces.

Multilink PPP chooses a fragment size based on the maximum delay allowed. If real-time traffic requires a certain maximum bound on delay, using this command to set that maximum delay can ensure that a real-time packet will get interleaved within the fragments of a large packet.

Examples

The following example requires a voice to have a maximum bound on delay of 20 milliseconds:

ppp multilink fragment-delay 20 

Related Commands

Command	Description
ip rtp reserve	Reserves a special queue for a set of RTP packet flows belonging to a range of UDP destination ports.
ppp multilink	Enables MLP on an interface and, optionally, enables dynamic bandwidth allocation.
ppp multilink interleave	Enables interleaving of RTP packets among the fragments of larger packets on a MLP bundle.

Syntax Description

This command has no arguments or keywords.

Defaults

Multilink idle-link is not set.

Command Modes

Interface configuration

Command History

Release	Modification
11.3T	This command was introduced.

Usage Guidelines

Use this command to ensure that the primary link in the AO/DI bundle enters "receive-only" mode as soon as the first additional B channel is added to the bundle. Additional member links are added to the Multilink PPP bundle in order to increase traffic throughput and are disconnected once the traffic load is reduced. During this timeframe, the X.25 SVC remains active. The dialer load-threshold value determines the traffic threshold limits for the bundle.

Examples

The following example configures the interface (dialer interface 1) to add additional links to the MLP bundle once the traffic load on the primary link is reached:

interface dialer1
 ppp multilink idle-link

Syntax Description

This command has no arguments and keywords.

Defaults

This function is disabled by default.

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

The ppp multilink interleave command applies only to interfaces that can configure a bundle interface. These include virtual-templates, dialer interfaces, and ISDN BRI or PRI interfaces.

Examples

The following example defines a virtual interface template that enables Multilink PPP interleaving and a maximum real-time traffic delay of 20 milliseconds, and then applies that virtual template to the Multilink PPP bundle:

interface virtual-template 1 
 ip unnumbered ethernet 0
 ppp multilink
 ppp multilink interleave
 ppp multilink fragment-delay 20 
!
multilink virtual-template 1

Related Commands

Command	Description
ip rtp reserve	Reserves a special queue for a set of RTP packet flows belonging to a range of UDP destination ports.
ppp multilink	Enables MLP on an interface and, optionally, enables dynamic bandwidth allocation.
ppp multilink fragment-delay	Configures a maximum delay allowed for transmission of a packet fragment on a MLP bundle.

Syntax Description

percentage

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

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

The percentages are calculated for both incoming and outgoing directions. The outgoing quality is calculated by comparing the total number of packets and bytes sent to the total number of packets and bytes received by the destination node. The incoming quality is calculated by comparing the total number of packets and bytes received to the total number of packets and bytes sent by the destination node.

If the link quality percentage is not maintained, the link is deemed to be of poor quality and is taken down. LQM implements a time lag so that the link does not bounce up and down.

Examples

The following example enables LQM on serial interface 2:

interface serial 2
 encapsulation ppp
 ppp quality 80

Related Commands

Command	Description
exec	Allows an EXEC process on a line.
keepalive	Sets the keepalive timer for a specific interface.

Syntax Description

This command has no arguments and keywords.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

Enabling LAPB Numbered Mode negotiation as a means of providing a reliable link does not guarantee that all connections through the specified interface will in fact use reliable link. It only guarantees that the router will attempt to negotiate reliable link on this interface.

PPP reliable link can be used with PPP compression over the link, but it does not require PPP compression.

PPP reliable link does not work with Multilink PPP.

You can use the show interface command to determine whether LAPB has been established on the link. You can troubleshoot PPP reliable link by using the debug lapb command and the debug ppp negotiations, debug ppp errors, and debug ppp packets commands.

Examples

The following example enables PPP reliable link and predictor compression on interface BRI 0:

interface bri 0
 description Enables predictor compression on BRI 0
 ip address 170.1.1.1 255.255.255.0 
 encapsulation ppp
 dialer map ip 170.1.1.2 name starbuck 14195291357
 compress predictor
 ppp authentication chap
 dialer-group 1
 ppp reliable-link

Related Commands

Command	Description
compress	Configures compression for LAPB, PPP, and HDLC encapsulations.
debug lapb	Displays all traffic for interfaces using LAPB encapsulation.
debug ppp	Displays information on traffic and exchanges in an internetwork implementing the PPP.
show interfaces	Displays statistics for all interfaces configured on the router or access server.