X.25 and LAPB Commands

Use the commands in this chapter to configure Link Access Procedure Balanced (LAPB), X.25, Defense Data Network (DDN) X.25, and Blacker Front End (BFE). X.25 provides remote terminal access; encapsulation for the IP, DECnet, XNS, ISO CLNS, AppleTalk, Novell IPX, Banyan VINES, and Apollo Domain protocols; and bridging.

X.25 virtual circuits can also be switched

Between interfaces---local routing)
Between two routers---remote routing or tunneling)
Over nonserial media---Connection-Mode Network Service (CMNS).

To translate between X.25 and another protocol, refer to the Protocol Translation Configuration Guide and Command Reference publication.

For X.25 and LAPB configuration information and examples, refer to the "Configuring X.25 and LAPB" chapter in the Router Products Configuration Guide.

bfe

To allow the router to participate in emergency mode or to end participation in emergency mode when the interface is configured for x25 bfe-emergency decision and x25 bfe-decision ask, use the bfe EXEC command.

bfe {enter | leave} type number

Syntax Description

enter Causes the router to send a special address translation packet that includes an enter emergency mode command to the BFE if the emergency mode window is open. If the BFE is already in emergency mode, this command enables the sending of address translation information.

leave Disables the sending of address translation information from the router to the BFE when the BFE is in emergency mode.

type Interface type.

number Interface number.

Command Mode

EXEC

Example

The following example enables an interface to participate in BFE emergency mode:

bfe enter serial 0

Related Commands

encapsulation x25
x25 bfe-decision
x25 bfe-emergency

clear x25-vc

To clear switched virtual circuits (SVCs) and to reset permanent virtual circuits (PVCs), use the clear x25-vc privileged EXEC command. To clear all X.25 virtual circuits at once by restarting the packet layer service, use this command without an lcn argument.

clear x25-vc type number [lcn]

Syntax Description

type Interface type.

number Interface number.

lcn (Optional) Virtual circuit.

Command Mode

Privileged EXEC

Example

The following example illustrates how to clear all virtual circuits on an interface:

clear x25-vc serial 1

Related Command

x25 idle

cmns enable

To enable Connection-Mode Network Service (CMNS) on a nonserial interface, use the cmns enable interface configuration command. To disable this capability, use the no form of this command.

cmns enable
no cmns enable

Syntax Description

This command has no arguments or keywords.

Default

The CMNS protocol is implicitly enabled whenever an X.25 encapsulation command is included with a serial interface configuration. A particular nonserial interface, however, must be explicitly configured to use CMNS.

Command Mode

Interface configuration

Usage Guidelines

After processing this command on the LAN interfaces (Ethernet, FDDI, and Token Ring), all the X.25-related interface configuration commands are made available.

Example

The following example enables CMNS on interface Ethernet 0:

interface ethernet 0        
cmns enable

Related Command

x25 map cmns

encapsulation lapb

To exchange datagrams over a serial interface using LAPB encapsulation, use the encapsulation lapb interface configuration command.

encapsulation lapb [dte | dce] [multi | protocol]

Syntax Description

dte (Optional) Specifies operation as a DTE. This is the default LAPB mode.

dce (Optional) Specifies operation as a DCE.

multi (Optional) Specifies use of multiple local-area network (LAN) protocols to be carried on the LAPB line.

protocol (Optional) A single protocol to be carried on the LAPB line. A single protocol can be one of the following: apollo, appletalk, clns (ISO CLNS), decnet, ip, ipx (Novell IPX), vines, and xns. IP is the default protocol.

Defaults

The default serial encapsulation is HDLC. You must explicitly configure a LAPB encapsulation method.

DTE operation is the default LAPB mode. IP is the default protocol.

Command Mode

Interface configuration

Usage Guidelines

LAPB encapsulations are appropriate only for private connections, where you have complete control over both ends of the link. Connections to X.25 networks should use an x25 encapsulation configuration, which operates the X.25 Layer 3 protocol above a LAPB Layer 2.

One end of the link must be a logical DCE and the other end a logical DTE. (This assignment is independent of the interface's hardware DTE/DCE identity.)

Both ends of the LAPB link must specify the same protocol encapsulation.

LAPB encapsulation is supported on serial lines configured for dial-on-demand (DDR) routing. It can be configured on DDR synchronous serial and ISDN interfaces and on DDR dialer rotary groups. It is not supported on asynchronous dialer interfaces.

A single-protocol LAPB encapsulation exchanges datagrams of the given protocol, each in a separate LAPB information frame. You should configure the interface with the protocol-specific parameters needed (for example, a link that carries IP traffic will have an IP address defined for the interface).

A multiprotocol LAPB encapsulation can exchange any or all of the protocols allowed for an serial interface. It also exchanges datagrams, each in a separate LAPB information frame. Since two bytes of protocol identification data precede the protocol data, you do not need to configure the interface with all of the protocol-specific parameters needed for each protocol carried.

Beginning with Cisco IOS Release 11.0, multiprotocol LAPB encapsulation supports transparent bridging. This feature requires use of the encapsulation lapb multi command followed by the bridge-group command, which identifies the bridge group associated with multiprotocol LAPB encapsulation. This feature does not support use of the encapsulation lapb protocol command with a bridge keyword.

Beginning with Release 10.3, LAPB encapsulation supports the priority and custom queueing features.

Example

The following example sets the operating mode as DTE and specifies that AppleTalk protocol traffic will be carried on the LAPB line:

interface serial 1        
encapsulation lapb dte appletalk

Related Command

A dagger (†) indicates that the command is documented in another chapter.

bridge-group†

encapsulation x25

To specify an serial interface's operation as an X.25 device, use the encapsulation x25 interface configuration command.

encapsulation x25 [dte | dce] [ddn | bfe] | [ietf]

Syntax Description

dte (Optional) Specifies operation as a DTE. This is the default X.25 mode.

dce (Optional) Specifies operation as a DCE.

ddn (Optional) Specifies DDN encapsulation on an interface using DDN X.25 standard service

bfe (Optional) Specifies BFE encapsulation on an interface attached to a Blacker Front End device. Available for BFE operation only.

ietf (Optional) Specifies that the interface's datagram encapsulation should default to use of the IETF standard method, as defined by RFC 1356.

Defaults

The default serial encapsulation is HDLC. You must explicitly configure an X.25 encapsulation method.

DTE operation is the default X.25 mode. Cisco's traditional X.25 encapsulation method is the default.

Command Mode

Interface configuration

Usage Guidelines

One end of an X.25 link must be a logical DCE and the other end a logical DTE. (This assignment is independent of the interface's hardware DTE/DCE identity.) Typically, when connecting to a public data network (PDN), the customer equipment acts as the DTE and the PDN attachment acts as the DCE.

Cisco has supported the encapsulation of a number of datagram protocols for quite some time, using a standard means when available and proprietary means when necessary. More recently the IETF adopted a standard, RFC 1356, for encapsulating most types of datagram traffic over X.25. X.25 interfaces use Cisco's traditional method unless explicitly configured for IETF operation; if the ietf keyword is specified, that standard will be used unless Cisco's traditional method is explicitly configured. For details see the x25 map command.

When an X.25 interface is reconfigured, all of the interface's X.25 parameters are initialized except the x25 map commands. The x25 map statements that are configured for an interface are not deleted when the encapsulation is changed, so they will be retained if the interface is later reconfigured for X.25 operation.

A router attaching to the Defense Data Network (DDN) or to a Blacker Front End (BFE) device can be configured to use their respective algorithms to convert between IP and X.121 addresses by using the ddn or bfe options, respectively. An IP address should be assigned to the interface, from which the algorithm will generate the interface's X.121 address; for proper operation, this X.121 address should not be modified.

A router DDN attachment can operate as either a DTE or a DCE device. A BFE attachment can operate only as a DTE device. The ietf option is not available if either the ddn or bfe option is selected.

Example

The following example configures the interface for connection to a Blacker Front End device:

interface serial 0        
encapsulation x25 bfe

lapb interface-outage

To specify a period during which a link will remain connected, even if a brief hardware outage occurs, use the lapb interface-outage interface configuration command.

lapb interface-outage milliseconds

Syntax Description

milliseconds Number of milliseconds a hardware outage can last without having the protocol disconnect the service. The default is 0 milliseconds, which disables this feature.

Default

0 milliseconds, which disables this feature.

Command Mode

Interface configuration

Usage Guidelines

If a hardware outage lasts longer than the LAPB hardware outage period you select, normal protocol operations will occur. The link will be declared to be down and, when it is restored, a link set up will be initiated.

Example

The following example sets the interface outage period to 100 milliseconds. The link will remain connected for outages equal to or shorter than that period.

encapsulation lapb dte ip        
lapb interface-outage 100

lapb k

To specify the maximum permissible number of outstanding frames, called the window size, use the lapb k interface configuration command.

lapb k window-size

Syntax Description

window-size Frame count. It can be a value from 1 to the modulo size minus 1 (the maximum is 7 if the modulo size is 8; it is 127 if the modulo size is 128). The default is 7 frames.

Default

7 frames

Command Mode

Interface configuration

Usage Guidelines

If the window size is changed while the protocol is up, the new value will take effect only when the protocol is reset. You will be informed that the new value will not take effect immediately.

When using the LAPB modulo 128 mode (extended mode), the window parameter k should be increased to make use of the ability to send a larger number of frames before acknowledgment is required. This is the basis for its ability to achieve greater throughput on high speed links that have a low error rate.

This configured value should match the value configured in the peer X.25 switch. Nonmatching values will cause repeated LAPB REJ frames.

Example

The following example sets the LAPB window size (the k parameter) to ten frames:

interface serial 0        
lapb modulo 

lapb k 10

lapb modulo

To specify the LAPB basic (modulo 8) or extended (modulo 128) protocol mode, use the lapb modulo interface configuration command.

lapb modulo modulus

Syntax Description

modulus Either 8 or 128. The value 8 specifies LAPB's basic mode; the value 128 specifies LAPB's extended mode. The default is 8.

Default

Modulo 8

Command Mode

Interface configuration

Usage Guidelines

The modulo parameter determines which of LAPB's two modes is to be used. The modulo values derive from the fact that basic mode numbers information frames between 0 and 7, whereas extended mode numbers them between 0 and 127. Basic mode is widely available and is sufficient for most links. Extended mode is an optional LAPB feature that may achieve greater throughput on high-speed links that have a low error rate.

The LAPB operating mode may be set on X.25 links as well as LAPB Links. The X.25 modulo is independent of the LAPB layer modulo. Both ends of a link must use the same LAPB mode.

When using modulo 128 mode, the window parameter k should be increased to make use of the ability to send a larger number of frames before acknowledgment is required. This is the basis for its ability to achieve greater throughput on high-speed links that have a low error rate.

If the modulo value is changed while the protocol is up, the new value will take effect only when the protocol is reset. The operator will be informed that the new value will not take effect immediately.

Example

The following example configures a high-speed X.25 link to use LAPB's extended mode:

interface serial 1        
encapsulation x25
lapb modulo 128
lapb k 40
clock rate 2000000

Related Command

lapb k

lapb n1

To specify the maximum number of bits a frame can hold (the LAPB N1 parameter), use the lapb n1 interface configuration command.

lapb n1 bits

Syntax Description

bits Number of bits from 1088 through 32840; it must be a multiple of eight.

Defaults

N1 defaults to the largest value available for the interface, which is determined from the interface MTU (typically 1500 bytes), plus the required overhead (for example, 7 bytes total for standard modulo 8 X.25). An X.25 encapsulation commonly has a default of 12056 bits (1507 bytes or 1503 bytes for an X.25 packet, or 1500 bytes of user data).

Command Mode

Interface configuration

Usage Guidelines

It is not necessary to set N1 to an exact value to support a particular X.25 data packet size, although both ends of a connection should have the same N1 value. The N1 parameter serves to avoid processing of any huge frames that result from a "jabbering" interface, an unlikely event.

The N1 default value corresponds to the hardware interface buffer size. Any changes to this value must allow for an X.25 data packet and LAPB frame overhead.The software supports an X.25 data packet with a maximum packet size plus 3 or 4 bytes of overhead for modulo 8 or 128 operation, respectively, and LAPB frame overhead of 2 bytes of header for modulo 8 operation plus 2 bytes of CRC.

In addition, the various standards bodies specify that N1 be given in bits rather than bytes. While some equipment can be configured using bytes or will automatically adjust for some of the overhead information present, our devices are configured using the true value of N1.

Table 13-1 specifies the minimum N1 values needed to support a given X.25 data packet. Note that N1 cannot be set to a value less than what is required to support an X.25 data packet size of 128 bytes under modulo 128 operation. This is because all X.25 implementations must be able to support 128byte data packets.

Table 13-1 Minimum LAPB N1 Values

Maximum data in X.25 packet Minimum N1 value for X.25 and LAPB modulo 8 Minimum N1 value for X.25 or LAPB modulo 128 Minimum N1 value for X.25 and LAPB modulo 128

128 1088 1088 1096

256 2104 2112 2120

512 4152 4160 4168

1024 8248 8256 8264

2048 16440 16448 16456

4096 32824 32832 32840

Configuring N1 to be less than 2104 will generate a warning message that X.25 may have problems because some nondata packets can use up to 259 bytes.

The N1 parameter cannot be set to a value larger than the default without first increasing the hardware maximum transmission unit (MTU) size.

The X.25 software will accept default packet sizes and CALLs that specify maximum packet sizes greater than what the LAPB layer will support, but will negotiate the CALLs placed on the interface to the largest value that can be supported. For switched CALLs, the packet size negotiation takes place end-to-end through the Cisco router so the CALL will not have a maximum packet size that exceeds the capability of either of the two interfaces involved.

Example

The following example sets the N1 bits to 16440:

interface serial 0

lapb n1 16440        
mtu 2048

Related Command

A dagger (†) indicates that the command is documented in another chapter.

mtu†

lapb n2

To specify the maximum number of times a data frame can be transmitted (the LAPB N2 parameter), use the lapb n2 interface configuration command.

lapb n2 tries

Syntax Description

tries Transmission count. It can be a value from 1 through 255. The default is 20 transmissions.

Default

20 transmissions

Command Mode

Interface configuration

Example

The following example sets the N2 tries to 50:

interface serial 0

lapb n2 50

lapb protocol

Use the lapb protocol interface configuration command to configure the protocol carried on the LAPB line.

lapb protocol protocol

Syntax Description

protocol Protocol, entered by keyword. It can be one of the following: appletalk, apollo, clns (ISO CLNS), decnet, ip, ipx (Novell IPX), vines, and xns.

Default

Command Mode

Interface configuration

Usage Guidelines

This command is not available when using a multiprotocol LAPB encapsulation.

Example

The following example sets AppleTalk as the only protocol on the LAPB line:

interface serial 1        
encapsulation lapb

lapb protocol appletalk

Related Commands

encapsulation lapb
encapsulation lapb-dce
encapsulation lapb-multi

lapb t1

To set the retransmission timer period (the LAPB T1 parameter), use the lapb t1 interface configuration command.

lapb t1 milliseconds

Syntax Description

milliseconds Time in milliseconds. It can be a value from 1 through 64000. The default is 3000 milliseconds.

Default

3000 milliseconds

Command Mode

Interface configuration

Usage Guidelines

The retransmission timer determines how long a transmitted frame can remain unacknowledged before the LAPB software polls for an acknowledgment. The design of the LAPB protocol specifies that a frame is presumed to be lost if it is not acknowledged within T1; a T1 value that is too small may result in duplicated control information, which can severely disrupt service.

To determine an optimal value for the retransmission timer, use the privileged EXEC command ping to measure the round-trip time of a maximum-sized frame on the link. Multiply this time by a safety factor that takes into account the speed of the link, the link quality, and the distance. A typical safety factor is 1.5. Choosing a larger safety factor can result in slower data transfer if the line is noisy. However, this disadvantage is minor compared to the excessive retransmissions and effective bandwidth reduction caused by a timer setting that is too small.

Example

The following example sets the T1 retransmission timer to 2,000 milliseconds:

interface serial 0

lapb t1 2000

lapb t4

To set the T4 idle timer, after which the router sends out a Poll packet to determine whether the link has suffered an unsignaled failure, use the lapb t4 interface configuration command.

lapb t4 seconds

Syntax Description

seconds Number of seconds between reception of the last frame and the transmission of the outgoing Poll. The default value is 0 seconds, which disables the T4 timer feature.

Defaults

0 seconds, which disables the T4 timer feature.

Command Mode

Interface configuration

Usage Guidelines

Any nonzero T4 duration must be greater than T1, the LAPB retransmission timer period.

Example

The following example will poll the other end of an active link if it has been 10 seconds since the last frame was received; if the far host has failed, the service will be declared down after N2 tries are timed out.

interface serial0        
encapsulation x25
lapb t4 10

Related Commands

lapb n2
lapb t1

show cmns

To display X.25 Level 3 parameters for LAN interfaces (such as Ethernet or Token Ring) and other information pertaining to CMNS traffic activity, use the show cmns EXEC command.

show cmns [type number]

Syntax Description

type (Optional) Interface type.

number (Optional) Interface number.

Command Mode

EXEC

Sample Display

The following is sample output from the show cmns command for an Ethernet interface:

Router# show cmns        
Ethernet1 is administratively down, line protocol is down
  Hardware address is 0000.0c02.5f4c, (bia 0000.0c2.5f4c), state R1

    Modulo 8, idle 0, timer 0, nvc 1
      Window size: input 2, output 2, Packet size: input 128, output 128
      Timer: TH 0
      Channels: Incoming-only none, Two-way 1-4095, Outgoing-only none
      RESTARTs 0/0 CALLs 0+0/0+0/0+0 DIAGs 0/0

Table 13-2 describes significant fields shown in the display.

Table 13-2 Show CMNS Field Descriptions

Field Description

Ethernet1 is down Interface is currently active and inserted into network (up) or inactive and not inserted (down), or disabled (administratively down).

line protocol is {up | down} Indicates whether the software processes that handle the line protocol believes the interface is usable.

Hardware address MAC address for this interface.

bia Burned-in address.

state R1 State of the interface. R1 is normal ready state (this should always be R1).

modulo 8 Modulo value; determines the packet sequence numbering scheme used.

idle 0 Number of minutes the router waits before closing idle virtual circuits.

timer 0 Value of the interface time; should always be zero.

nvc 1 Maximum number of simultaneous virtual circuits permitted to and from a single host for a particular protocol.

Window size: Default window sizes (in packets) for the interface. (CMNS cannot originate or terminate calls.)

input 2 Default input window size is two packets.

output 2 Default output window size is two packets.

Packet size: Default packet sizes for the interface. (CMNS cannot originate or terminate calls).

input 128 Default input maximum packet size is 128 bytes.

output 128 Default output maximum packet size is 128 bytes.

TH 0 X.25 delayed acknowledgment threshold. Should always be zero.

Channels: Incoming-only: none, Two-way: 1-4095,Outgoing-only: none Virtual circuit ranges for this interface per LLC2 connection.

RESTARTs 0/0 Restarts sent/received.

CALLs 0+0/0+0/0+0 Successful calls + failed calls/calls sent + calls failed/calls received + calls failed.

DIAGs 0/0 Diagnostic messages sent+received.

Related Command

A dagger (†) indicates that the command is documented in another chapter.

show interfaces serial†

show interfaces serial

To display information about a serial interface, use the show interfaces serial EXEC command.

show interfaces serial number

Syntax Description

number Interface port number.

Command Mode

EXEC

Sample Displays

The following is a partial sample output from the show interfaces serial command for a serial interface using LAPB encapsulation:

Router# show interfaces serial 1        
LAPB state is SABMSENT, T1 3000, N1 12056, N2 20, k7,Protocol ip

VS 0, VR 0, RCNT 0, Remote VR 0, Retransmissions 2
IFRAMEs 0/0 RNRs 0/0 REJs 0/0 SABMs 3/0 FRMRs 0/0 DISCs 0/0

Table 13-3 shows the fields relevant to all LAPB connections.

Table 13-3 Show Interfaces Serial Fields and Descriptions when LAPB is Enabled

Parameter Description

LAPB state is State of the LAPB protocol.

T1 3000, N1 12056, ... Current parameter settings.

Protocol Protocol encapsulated on a LAPB link; this field is not present on interfaces configured for multiprotocol LAPB or X.25 encapsulations.

VS Modulo 8 frame number of the next outgoing I-frame.

VR Modulo 8 frame number of the next I-frame expected to be received.

RCNT Number of received I-frames that have not yet been acknowledged.

Remote VR Number of the next I-frame the remote expects to receive.

Retransmissions Count of current retransmissions due to expiration of T1.

Window is closed No more frames can be transmitted until some outstanding frames have been acknowledged. This message should be displayed only temporarily.

IFRAMEs Count of Information frames in the form of sent/received.

RNRs Count of Receiver Not Ready frames in the form of sent/received.

REJs Count of Reject frames in the form of sent/received.

SABMs Count of Set Asynchronous Balanced Mode commands in the form of sent/received.

FRMRs Count of Frame Reject frames in the form of sent/received.

DISCs Count of Disconnect commands in the form of sent/received.

The following is a partial sample output from the show interfaces command for a serial X.25 interface:

Router# show interfaces serial 1        
X25 address 000000010100, state R1, modulo 8, idle 0, timer 0, nvc 1
  Window size: input 2, output 2, Packet size: input 128, output 128
  Timers: T20 180, T21 200, T22 180, T23 180, TH 0
  Channels: Incoming-only none, Two-way 1-1024, Outgoing-only none
(configuration on RESTART: modulo 8,
  Window size: input 2 output 2, Packet size: input 128, output 128
  Channels: Incoming-only none, Two-way 5-1024, Outgoing-only none)
  RESTARTs 3/2 CALLs 1000+2/1294+190/0+0/ DIAGs 0/0

The stability of the X.25 protocol requires that some parameters not be changed without a RESTART of the protocol. Any change to these parameters will be held until a RESTART is sent or received. If any of these parameters will change, the configuration on RESTART information will be output as well as the values that are currently in effect.

Table 13-4 describes significant fields shown in the display.

Table 13-4 Show Interfaces X25 Field Descriptions

Field Description

X25 address 000000010100 Address used to originate and accept calls.

state R1 State of the interface. Possible values are:
· R1 is the normal ready state
· R2 is the DTE RESTARTing state
· R3 is the DCE RESTARTing state
If the state is R2 or R3, the interface is awaiting acknowledgment of a Restart packet.

modulo 8 Modulo value; determines the packet sequence numbering scheme used.

idle 0 Number of minutes the router waits before closing idle virtual circuits that it originated or accepted.

timer 0 Value of the interface timer, which is zero unless the interface state is R2 or R3.

nvc 1 Default maximum number of simultaneous virtual circuits permitted to and from a single host for a particular protocol.

Window size: input 2, output 2 Default window sizes (in packets) for the interface. The x25 facility interface configuration command can be used to override these default values for the switched virtual circuits originated by the router.

Packet size: input 128, output 128 Default maximum packet sizes (in bytes) for the interface. The x25 facility interface configuration command can be used to override these default values for the switched virtual circuits originated by the router.

Timers: T20 180, T21 200, T22 180, T23 180 Values of the X.25 timers:
· T10 through T13 for a DCE device
· T20 through T23 for a DTE device

TH0 Packet acknowledgment threshold (in packets). This value determines how many packets are received before sending an explicit acknowledgment; the default value (0) sends an explicit acknowledgment only when the incoming window is full.

Channels: Incoming-only noneTwo-way 5-1024Outgoing-only none Displays the virtual circuit ranges for this interface.

RESTARTs 3/2 Shows RESTART packet statistics for the interface using the format Sent/Received.

CALLs 1000+2/1294+190/0+0 Successful calls sent + failed calls/calls received + calls failed/calls forwarded + calls failed. Calls forwarded are counted as calls sent.

DIAGs 0/0 Diagnostic messages sent+received.

Related Command

show cmns

show llc2

To display active LLC2 connections, use the show llc2 EXEC command.

show llc2c

Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Sample Display

The following is sample output from the show llc2 command:

Router# show llc2        
TokenRing0 DTE=1000.5A59.04F9,400022224444 SAP=04/04, State=NORMAL
V(S)=5, V(R)=5, Last N(R)=5, Local Window=7, Remote Window=127
ack-max=3, n2=8, Next timer in 7768
xid-retry timer 0/60000 ack timer 0/1000
p timer 0/1000 idle timer 7768/10000
rej timer 0/3200 busy timer 0/9600
ack-delay timer 0/3200
CMNS Connections to:

 Address 1000.5A59.04F9 via Ethernet2

 Protocol is up

 Interface type X25-DCE RESTARTS 0/1

 Timers: T10 1 T11 1 T12 1 T13 1

The display includes a CMNS addendum, indicating that LLC2 is running with CMNS. When LLC2 is not running with CMNS, the show llc2 command does not display a CMNS addendum.

Table 13-5 describes significant fields shown in the display.

Table 13-5 Show LLC2 Field Descriptions

Field Description

TokenRing0 Name of interface on which the session is established.

DTE=1000.5A59.04F9, 400022224444 Address of the station to which the router is talking on this session. (The router's address is the MAC address of the interface on which the connection is established, except when Local Acknowledgment or SDLLC is used, in which case the address used by the router is shown as in this example, following the DTE address and separated by a comma.)

SAP=04/04 Other station's and router's (remote/local) Service Access Point for this connection. The SAP is analogous to a "port number" on the router and allows for multiple sessions between the same two stations.

State=
ADM

SETUP

RESET

D_CONN

ERROR

NORMAL

BUSY

REJECT

AWAIT

AWAIT_BUSY
AWAIT_REJ Current state of the LLC2 session which are any of the following:
Asynchronous Disconnect Mode---A connection is not established, and either end can begin one.
Request to begin a connection has been sent to the remote station, and this station is waiting for a response to that request.
A previously open connection has been reset because of some error by this station, and this station is waiting for a response to that reset command.
This station has requested a normal, expected, end of communications with the remote, and is waiting for a response to that disconnect request.
This station has detected an error in communications and has told the other station about it. This station is waiting for a reply to its posting of this error.
Connection between the two sides is fully established, and normal communication is occurring.
Normal communication state exists, except busy conditions on this station make it such that this station cannot receive information frames from the other station at this time.
Out-of-sequence frame has been detected on this station, and this station has requested that the other resend this information
Normal communication exists, but this station has had a timer expire, and is trying to recover from it (usually by resending the frame that started the timer).
A combination of the AWAIT and BUSY states.
A combination of the AWAIT and REJECT states.

V(S)=5 Sequence number of the next information frame this station will send.

V(R)=5 Sequence number of the next information frame this station expects to receive from the other station.

Last N (R)=5 Last sequence number of this station's transmitted frames acknowledged by the remote station.

Local Window=7 Number of frames this station may send before requiring an acknowledgment from the remote station.

Remote Window=127 Number of frames this station can accept from the remote.

ack-max=3, n2=8 Value of these parameters, as given in the previous configuration section.

Next timer in 7768 Number of milliseconds before the next timer, for any reason, goes off.

xid-retry timer 0/60000 .... A series of timer values in the form of next-time/time-between, where "next-time" is the next time, in milliseconds, that the timer will wake, and "time-between" is the time, in milliseconds, between each timer wakeup. A "next-time" of zero indicates that the given timer is not enabled, and will never wake.

CMNS Connections to:

Address 1000.5A59.04F9 via Ethernet2
Protocol is up

Interface type X25-DCE

RESTARTS 0/1
Timers: CMNS addendum when LLC2 is running with the CMNS protocol contains the following:
MAC address of remote station.

Up indicates the LLC2 and X.25 protocols are in a state where incoming and outgoing Call Requests can be made on this LLC2 connection.
One of the following: X25-DCE, X25-DTE, or X25-DXE (either DTE or DCE).
Restarts sent/received on this LLC2 connection.
T10, T11, T12, T13 (or T20, T21, T22, T23 for DTE); these are Request packet timers. These are similar in function to X.25 parameters of the same name.

show x25 map

To display information about configured address maps, use the show x25 map EXEC command.

show x25 map

Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Usage Guidelines

The show x25 map command shows information about the following:

Configured maps (defined by the x25 map command)
Maps implicitly defined by encapsulation PVCs (defined by the x25 pvc command)
Dynamic maps (from the X.25 DDN or BFE operations)
Temporary maps (from unconfigured CMNS endpoints)

Sample Display

The following is sample output from the show x25 map command:

Router# show x25 map        
Serial0: X.121 1311001 <--> ip 131.108.170.1
  PERMANENT, BROADCAST, 2 VCS: 3 4*
Serial0: X.121 1311005 <--> appletalk 128.1
  PERMANENT
Serial1: X.121 1311005 <--> bridge
  PERMANENT, BROADCAST
Serial2: X.121 001003 <--> apollo 1.3,
         appletalk 1.3,
         ip 131.108.1.3,
         decnet 1.3,
         novell 1.0000.0c04.35df,
         vines 00000001:0003, 
         xns 1.0000.0c04.35df, 
         clns
  PERMANENT, NVC 8, 1 VC: 1024

The display shows that four maps have been configured for the router, two for serial interface 0, one for serial interface 1, and one for the serial interface 2 (which maps eight protocols to the host).

Table 13-6 describes fields shown in the display.

Table 13-6 Show X25 Map Field Description

Field Description

Serial0 Interface on which this map is configured.

X.121 1311001 X.121 address of the mapped encapsulation host.

ip 131.108.170.1 Type and address of the higher-level protocol(s) mapped to the remote host. Bridge maps do not have a higher-level address; all bridge datagrams are sent to the mapped X.121 address. CLNS maps refer to a configured neighbor as identified by the X.121 address.

PERMANENT Address-mapping type that has been configured for the interface in this entry. Possible values include the following:
· CONSTRUCTED---Derived using the DDN or BFE address conversion scheme.
· PERMANENT---Map was entered using the x25 map interface configuration command.
· PVC---Map was configured using the x25 pvc interface command.
· TEMPORARY---A temporary map was created for an incoming unconfigured CMNS connection.

BROADCAST If any options are configured for an address mapping, they will be listed; the example shows a maps that is configured to forward datagram broadcasts to the mapped host.

2 VCs: If the map has any active virtual circuits, they are identified.

3 4* Identifies the circuit number of the active virtual circuits. The asterisk (*) marks the virtual circuit last used to send data.
Note that a single protocol virtual circuit can be associated with a multiprotocol map.

show x25 remote-red

To display the one-to-one mapping of the host IP addresses and the remote BFE device's IP addresses, use the show x25 remote-red EXEC command.

show x25 remote-red

Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Sample Display

The following is sample output from the show x25 remote-red command:

Router# show x25 remote-red        
Entry         REMOTE-RED       REMOTE-BLACK     INTERFACE
1             21.0.0.3         21.0.0.7         serial3  
2             21.0.0.10        21.0.0.6         serial1
3             21.0.0.24        21.0.0.8         serial3

Table 13-7 describes significant fields shown in the display.

Table 13-7 Show X25 Remote-Red Display Field Description

Field Description

Entry Address mapping entry.

REMOTE-RED Host IP address.

REMOTE-BLACK IP address of the remote BFE device.

INTERFACE Name of interface through which communication with the remote BFE device will take place.

show x25 route

To display the X.25 routing table, use the show x25 route EXEC command.

show x25 route

Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Sample Display

The following is sample output from the show x25 route command:

Router# show x25 route        
Number           X.121          CUD          Forward To
1                1311001                     Serial0, 0 uses
2                1311002                     131.108.170.10, 0 uses
3                1311003        00           alias Serial0, 2 uses

Table 13-8 describes significant fields shown in the display.

Table 13-8 Show X25 Route Display Field Description

Field Description

Number Number identifying the entry in the X.25 routing table.

X.121 address X.121 address pattern associated with this entry.

CUD Call User Data, if any, that has been configured for this route.

Forward To Router interface or IP address to which the router will forward a CALL destined for the X.121 address pattern in this entry.
This field also includes the number of uses of this route.

Related Command

x25 route

show x25 vc

To display information about active switched virtual circuits (SVCs) and permanent virtual circuits (PVCs), use the show x25 vc EXEC command.

show x25 vc [lcn]

Syntax Description

lcn (Optional) Logical channel number (LCN).

Command Mode

EXEC

Usage Guidelines

To examine a particular virtual circuit, add an LCN argument to the show x25 vc command.

This command displays information about virtual circuits that are used for any of the following:

Encapsulation traffic
Locally switched traffic
Remotely switched traffic
CMNS switched traffic

The connectivity information displayed will vary according to the traffic carried by the virtual circuit. For multiprotocol circuits, the output varies depending on the number and identity of the protocols mapped to the X.121 address and the encapsulation method selected for the circuit.

Sample Displays

This section provides three sample displays and tables that describe the fields in each display.

The following sample display shows a virtual circuit that is being used to encapsulate traffic between the router and a remote host:

Router# show x25 vc 1024        
SVC 1024,  State: D1,  Interface: Serial0
 Started 0:00:31, last input 0:00:31, output 0:00:31
 Connects 170090 <-->
    compressedtcp 131.108.170.90
    ip 131.108.170.90
 multiprotocol CUD PID, standard Tx data PID, Reverse charged
 Window size input: 2, output: 2
 Packet size input: 128, output: 128
 PS: 5  PR: 5  ACK: 4  Remote PR: 5  RCNT: 1  RNR: FALSE
 Window is closed
 Retransmits: 0  Timer (secs): 0  Reassembly (bytes): 0
 Held Fragments/Packets: 0/0
 Bytes 505/505 Packets 5/5 Resets 0/0 RNRs 0/0 REJs 0/0 INTs 0/0

Table 13-9 describes the general fields shown in the output; Table 13-10 describes the fields specific to encapsulation virtual circuits shown in the output.

Table 13-9 Show X25 VC Field Descriptions

Field Description

SVC 1024 Identifies the type (switched or permanent) and the number of the virtual circuit.

State State of the virtual circuit (which is independent of the states of other virtual circuits); D1 is the normal ready state. (See the International Telecommunication Union Telecommunication Standardization Sector (ITU-T)(1) X.25 Recommendation for a description of virtual circuit states.)

Interface Interface or subinterface on which the virtual circuit is established.

Started Time elapsed since the virtual circuit was created.

last input Time of last input.

output Shows time of last output.

Connects...<--> ... Describes the traffic-specific connection information. See Table 13-10, Table 13-11, and Table 13-12 for more information.

Window size Window sizes for the virtual circuit.

Packet size Maximum packet sizes for the virtual circuit.

PS Current send sequence number.

PR Current receive sequence number.

ACK Last acknowledged incoming packet.

Remote PR Last PR number received from the other end of the circuit.

RCNT Count of unacknowledged input packets.

RNR State of the Receiver Not Ready flag; this field is true if the network sends a receiver-not-ready packet.

Window is closed This line appears if the router cannot transmit any more packets until the X.25 layer 3 peer has acknowledged some outstanding packets.

Retransmits Number of times a supervisory packet (RESET or CLEAR) has been retransmitted.

Timer A nonzero time value indicates that a control packet has not been acknowledged yet or that the virtual circuit is being timed for inactivity.

Reassembly Number of bytes received and held for reassembly (packets with the More bit set are reassembled into datagrams for encapsulation virtual circuits; switched X.25 traffic is not reassembled).

Held Fragments/Packets Number of X.25 data fragments to transmit to complete an outgoing datagram, and the number of datagram packets waiting for transmission.

Bytes Total number of bytes sent and received. The Packets, Resets, RNRs, REJs, and INTs fields show the total sent and received packet counts of the indicated types. (RNR is Receiver Not Ready, REJ is Reject, and INT is Interrupt).

(1): The ITU-T carries out the functions of the former Consultative Committee for International Telegraph and Telephone (CCITT).

Table 13-10 describes the connection description fields for virtual circuits carrying encapsulation traffic.

Table 13-10 Show X25 VC Encapsulation Traffic Field Descriptions

Field Description

170090 The X.121 address of the remote host.

ip 131.108.170.90 The higher-level protocol and address values that are mapped to the virtual circuit.

multiprotocol CUD PID Identifies the method used for the protocol identification (PID) in the Call User Data (CUD) field. Since PVCs are not set up using a Call packet, this field is not displayed for encapsulation PVCs. The available methods are as follows:
· cisco---Cisco's traditional method was used to set up a single protocol virtual circuit.
· ietf---The IETF's standard RFC 1356 method was used to set up a single protocol virtual circuit.
· snap---The IETF's SNAP method for IP encapsulation was used.
· multiprotocol---the IETF's multiprotocol encapsulation method was used.

standard Tx data PID Identifies the method used for protocol identification (PID) when sending datagrams. The available methods are as follows:
· no---The virtual circuit is a single-protocol virtual circuit; no PID is used.
· standard---The IETF's standard RFC 1356 method for identifying the protocol is used.
· snap---The IETF's SNAP method for identifying IP datagrams is used.

Reverse charged Some important virtual circuit information might be displayed as needed; a DDN IP precedence encapsulation value, reverse charged virtual circuits, and virtual circuits that allow the D-bit procedure.

The following sample display shows virtual circuits carrying locally switched X.25 traffic:

Router# show x25 vc        
PVC 1,  State: D1,  Interface: Serial2
 Started 0:01:26, last input never, output never
 PVC <--> Serial1 PVC 1 connected
 Window size input: 2, output: 2
 Packet size input: 128, output: 128
 PS: 0  PR: 0  ACK: 0  Remote PR: 0  RCNT: 0  RNR: FALSE
 Retransmits: 0  Timer (secs): 0  Reassembly (bytes): 0
 Held Fragments/Packets: 0/0
 Bytes 0/0 Packets 0/0 Resets 0/0 RNRs 0/0 REJs 0/0 INTs 0/0
 SVC 5,  State: D1,  Interface: Serial2
  Started 0:00:16, last input 0:00:15, output 0:00:15
  Connects 170093 <--> 170090 from Serial1 VC 5
  Window size input: 2, output: 2
  Packet size input: 128, output: 128
  PS: 5  PR: 5  ACK: 4  Remote PR: 5  RCNT: 1  RNR: FALSE
  Retransmits: 0  Timer (secs): 0  Reassembly (bytes): 0
  Held Fragments/Packets: 0/0
  Bytes 505/505 Packets 5/5 Resets 0/0 RNRs 0/0 REJs 0/0 INTs 0/0

Table 13-11 lists the connection description fields for virtual circuits carrying locally switched X.25 traffic.

Table 13-11 Show X25 VC Local Traffic Field Descriptions

Field Description

PVC Flags PVC information.

Serial1 PVC 1 Identifies the other half of a local PVC connection.

connected Identifies the state of the PVC. If the PVC is not connected, the status of the PVC will also be displayed. See Table 13-13 for PVC status messages.

170093 Identifies the Calling (source) Address of the connection. If a Calling Address Extension was encoded in the call facilities, it will also be displayed. If the source host is a CMNS host, its MAC address will also be displayed.

170090 Identifies the Called (destination) Address of the connection. If a Called Address Extension was encoded in the call facilities, it will also be displayed. If the destination host is a CMNS host, its MAC address will also be displayed.

from Serial1 VC 5 Indicates the direction of the call ("from" or "to") and the connecting interface and virtual circuit number.

The following sample display shows virtual circuits carrying remotely switched X.25 traffic.

Router# show x25 vc        
PVC 2,  State: D1,  Interface: Serial2
 Started 0:01:25, last input never, output never
 PVC <--> [131.108.165.92] Serial2/0 PVC 1 connected
 XOT between 131.108.165.91, 1998 and 131.108.165.92, 27801
 Window size input: 2, output: 2
 Packet size input: 128, output: 128
 PS: 0  PR: 0  ACK: 0  Remote PR: 0  RCNT: 0  RNR: FALSE
 Retransmits: 0  Timer (secs): 0  Reassembly (bytes): 0
 Held Fragments/Packets: 0/0
 Bytes 0/0 Packets 0/0 Resets 0/0 RNRs 0/0 REJs 0/0 INTs 0/0
SVC 6,  State: D1,  Interface: Serial2
 Started 0:00:04, last input 0:00:04, output 0:00:04
 Connects 170093 <--> 170090 from
 XOT between 131.108.165.91, 1998 and 131.108.165.92, 27896
 Window size input: 2, output: 2
 Packet size input: 128, output: 128
 PS: 5  PR: 5  ACK: 4  Remote PR: 5  RCNT: 1  RNR: FALSE
 Retransmits: 0  Timer (secs): 0  Reassembly (bytes): 0
 Held Fragments/Packets: 0/0
 Bytes 505/505 Packets 5/5 Resets 0/0 RNRs 0/0 REJs 0/0 INTs 0/0

Table 13-12 lists the connection description fields for virtual circuits carrying remotely switched X.25 traffic.

Table 13-12 Show X25 VC Remote X.25 Traffic Field Descriptions

Field Description

PVC Flags PVC information.

[131.108.165.92] Indicates the IP address of the router remotely connecting the PVC.

Serial 2/0 PVC 1 Identifies the remote interface and PVC number.

connected Identifies the state of the PVC. If the PVC is not connected, the status of the PVC will also be displayed. See Table 13-13 for the PVC status messages.

170093 Identifies the Calling (source) Address of the connection. If a Calling Address Extension was encoded in the call facilities, it will also be displayed.

170090 Identifies the Called (destination) Address of the connection. If a Called Address Extension was encoded in the call facilities, it will also be displayed.

from Indicates the direction of the call ("from" or "to").

XOT between... Identifies the IP addresses and port numbers of the XOT connection.

Table 13-13 lists the PVC states that can be reported. These states are also reported by the debug x25 command in PVC-SETUP packets (for remote PVCs only) as well as in the PVCBAD system error message. Some states apply only to remotely switched PVCs.

Table 13-13 X.25 PVC States

Field Description

waiting to connect The PVC is waiting to be processed for connecting.

dest. disconnected The other end disconnected the PVC.

PVC/TCP connection refused A remote PVC XOT TCP connection was tried and refused.

PVC/TCP routing error A remote PVC XOT TCP connection routing error was reported.

PVC/TCP connect timed out A remote PVC XOT TCP connection attempt timed out.

trying to connect via TCP A remote PVC XOT TCP connection is established and is in the process of connecting.

awaiting PVC-SETUP reply A remote PVC has initiated an XOT TCP connection and is waiting fro a reply to the setup message.

connected The PVC is up.

no such dest. interface The remote destination interface was reported to be in error by the remote router.

dest interface is not up The target interface's X.25 service is down.

non-X.25 dest. interface The target interface isn't configured for X.25.

no such dest. PVC The targeted PVC does not exist.

dest PVC config mismatch The targeted PVC is already connected.

mismatched flow control values The configured flow control values do not match.

can't support flow control values The window sizes or packet sizes of the PVC cannot be supported by one of its two interfaces.

x25 accept-reverse

To configure the router to accept all reverse charge calls, use the x25 accept-reverse interface configuration command. To disable this facility, use the no form of this command.

x25 accept-reverse
no x25 accept-reverse

Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command causes the interface to accept reverse charge calls by default. This behavior also can be configured on a per-peer basis using the x25 map interface configuration command.

Example

The following example sets acceptance of reverse charge calls:

interface serial 0

x25 accept-reverse

Related Command

x25 map

x25 address

To set the X.121 address of a particular network interface, use the x25 address interface configuration command.

x25 address x.121-address

Syntax Description

x.121-address Variable-length X.121 address. The address is assigned by the X.25 network service provider.

Default

DDN and BFE encapsulations have a default interface address generated from the interface IP address; for proper DDN or BFE operation, this generated X.121 address should not be changed. Standard X.25 encapsulations do not have a default.

Command Mode

Interface configuration

Usage Guidelines

When connecting to a PDN, the PDN administration will assign the X.121 address that should be used. Other applications (for example, a private X.25 service), may assign arbitrary X.121 addresses as required by the network and service design. X.25 interfaces that only engage in X.25 switching do not need to assign an X.121 address.

Example

The following example sets the X.121 address for the interface:

interface serial 0        
encapsulation x25

x25 address 00000123005

The address must match that assigned by the X.25 network service provider.

x25 bfe-decision

To specify how a router configured for x25 bfe-emergency decision will participate in emergency mode, use the x25 bfe-decision interface configuration command.

x25 bfe-decision {no | yes | ask}

Syntax Description

no Prevents the router from participating in emergency mode and from sending address translation information to the BFE device.

yes Allows the router to participate in emergency mode and to send address translation information to the BFE when the BFE enters emergency mode. The router obtains this information from the table created by the x25 remote-red command.

ask Configures the router to prompt the console operator to enter the bfe EXEC command.

Default

The router does not participate in emergency mode.

Command Mode

Interface configuration

Example

The following example configures interface Serial 0 to require an EXEC command from the administrator before it participates in emergency mode. The host IP address is 21.0.0.12, and the address of the remote BFE unit is 21.0.0.1. When the BFE enters emergency mode, the router will prompt the administrator for EXEC command bfe enter to direct the router to participate in emergency mode.

interface serial 0        
x25 bfe-emergency decision
x25 remote-red 21.0.0.12 remote-black 21.0.0.1
x25 bfe-decision ask

Related Commands

bfe
x25 bfe-emergency
x25 remote-red

x25 bfe-emergency

To configure the circumstances under which the router participates in emergency mode, use the x25 bfe-emergency interface configuration command.

x25 bfe-emergency {never | always | decision}

Syntax Description

never Prevents the router from sending address translation information to the BFE. If it does not receive address translation information, the BFE cannot open a new connection for which it does not know the address.

always Allows the router to pass address translations to the BFE when it enters emergency mode and an address translation table has been created.

decision Directs the router to wait until it receives a diagnostic packet from the BFE device indicating that the emergency mode window is open. The window is only open when a condition exists that allows the BFE is to enter emergency mode. When the diagnostic packet is received, the router's participation in emergency mode depends on how it is configured using the x25 bfe-decision command.

Default

The router does not send address translation information to the BFE.

Command Mode

Interface configuration

Example

interface serial 0        
x25 bfe-emergency decision
x25 remote-red 21.0.0.12 remote-black 21.0.0.1
x25 bfe-decision ask

Related Commands

bfe
x25 bfe-decision

x25 default

To set a default protocol, use the x25 default interface configuration command. To remove the default protocol specified, use the no form of this command.

x25 default protocol
no x25 default protocol

Syntax Description

protocol Specifies the protocol to assume; may be ip or pad.

Default

No default protocol is set.

Command Mode

Interface configuration

Usage Guidelines

This command specifies the protocol assumed by the router for incoming calls with unknown or missing Call User Data. If you do not use the x25 default interface configuration command, the router clears any incoming calls with unrecognized Call User Data.

Example

The following example establishes IP as the default protocol for X.25 calls:

interface serial 0        
x25 default ip

Related Command

x25 map

x25 facility

To force facilities on a per-call basis for calls originated by the router (switched calls are not affected), use the x25 facility interface configuration command. To disable a facility, use the no form of this command.

x25 facility facility-keyword value
no x25 facility facility-keyword value

Syntax Description

facility-keyword User facility.

value Facility value; see Table 13-14 for a list of supported facilities and their values.

Default

No facility is sent.

Command Mode

Interface configuration

Usage Guidelines

Table 13-14 lists X.25 user facilities.

Table 13-14 X.25 User Facilities

User Facility Description

cug number Specifies a closed user group (CUG) number; CUGs 1 to 99 are allowed. CUGs can be used by a public data network to create a virtual private network within the larger network and to restrict access.

packetsize in-size out-size Proposes input maximum packet size (in-size) and output maximum packet size (out-size) for flow control parameter negotiation. Both values must be one of the following values: 16, 32, 64, 128, 256, 512, 1024, 2048, or 4096.

windowsize in-size out-size Proposes the packet count for input windows (in-size) and output windows (out-size) for flow control parameter negotiation. Both values must be in the range 1 to 127 and must not be greater than or equal to the value set for the x25 modulo command.

reverse Specifies reverses charging on all calls originated by the interface.

throughput in out Sets the requested throughput class negotiation values for input (in) and output (out) throughput across the network. Values for in and out are in bits per second (bps) and range from 75 to 64000 bps.

transit-delay value Specifies a network transit delay for the duration of outgoing calls for networks that support transit delay. The transit delay value can be between 0 and 65534 milliseconds.

rpoa name Specifies the name defined by the x25 rpoa command for a list of transit Recognized Private Operation Agencies (RPOAs) to use in outgoing Call Request packets.

Examples

The following example specifies a transit delay value in an X.25 configuration:

interface serial 0

x25 facility transit-delay 24000

The following example sets an RPOA name and then send the list via the X.25 user facilities:

x25 rpoa green_list 23 35 36

interface serial 0

x25 facility rpoa green_list

Related Command

x25 rpoa

x25 hic

To set the highest incoming-only virtual circuit number, use the x25 hic interface configuration command.

x25 hic circuit-number

Syntax Description

circuit-number Virtual circuit number from 1 through 4095, or 0 if there is no incoming-only virtual circuit range. The default is 0.

Default

Command Mode

Interface configuration

Usage Guidelines

This command is applicable only if you have the X.25 switch configured for an incoming only virtual circuit range. Incoming is from the perspective of the X.25 DTE. If you do not want any outgoing calls from your DTE, configure both ends to disable the two-way range (set ltc and htc to 0) and configure an incoming-only range. Any incoming-only range must come before (that is, must be numerically less than) any two-way range. Any two-way range must come before any outgoing-only range.

Example

The following example sets a valid incoming-only virtual circuit range of 1 to 5:

interface serial 0

x25 lic 1        
x25 hic 5
x25 ltc 6

Related Command

x25 lic

x25 hoc

To set the highest outgoing-only virtual circuit number, use the x25 hoc interface configuration command.

x25 hoc circuit-number

Syntax Description

circuit-number Virtual circuit number from 1 through 4095, or 0 if there is no outgoing-only virtual circuit range. The default is 0.

Default

Command Mode

Interface configuration

Usage Guidelines

This command is applicable only if you have the X.25 switch configured for an outgoing only virtual circuit range. Outgoing is from the perspective of the X.25 DTE. If you do not want any incoming calls on your DTE, disable the two-way range (set the values of x25 ltc and x25 htc to 0) and configure an outgoing-only range. Any outgoing-only range must come after (that is, be numerically greater than) any other range.

Example

The following example sets a valid outgoing-only virtual circuit range of 2000 to 2005:

interface serial 0

x25 loc 2000        
x25 hoc 2005

Related Command

x25 loc

x25 hold-queue

To set the maximum number of packets to hold until a virtual circuit is able to transmit, use the x25 hold-queue interface configuration command. To remove this command from the configuration file and restore the default value, use the no form of this command without an argument.

x25 hold-queue packets
no x25 hold-queue [packets]

Syntax Description

packets Number of packets. A hold queue value of 0 allows an unlimited number of packets in the hold queue. This argument is optional for the no form of this command. The default is 10 packets.

Default

10 packets

Command Mode

Interface configuration

Usage Guidelines

If you set the queue-size to 0 when using the no x25 hold-queue command, there will be no hold queue limit. While this will prevent drops until the router runs out of memory, it is only rarely appropriate. A virtual circuit hold queue value is determined when it is created; changing this parameter will not affect the hold queue limits of the existing virtual circuits.

Example

The following example sets the X.25 hold queue to hold 25 packets:

interface serial 0

x25 hold-queue 25

Related Commands

A dagger (†) indicates that the command is documented in another chapter.

ip mtu †
x25 ips
x25 ops

x25 hold-vc-timer

To start the timer that prevents additional calls to a destination for a given period of time (thus preventing overruns on some X.25 switches caused by Call Request packets), use the x25 hold-vc-timer interface configuration command. To restore the default value for the timer, use the no form of this command

x25 hold-vc-timer minutes
no x25 hold-vc-timer

Syntax Description

minutes Number of minutes to prevent calls from going to a previously failed destination. Incoming calls will still be accepted. The default is 0 minutes.

Default

0 minutes

Command Mode

Interface configuration

Usage Guidelines

Only Call Requests that the router originates will be held down; routed X.25 Call Requests are not affected by this parameter.

Upon receiving a Clear Request for an outstanding Call Request, the X.25 support code immediately tries another Call Request if it has more traffic to send, and this action might cause overrun problems.

The failed virtual circuits can be observed with the show x25 vc command; they are renumbered to the illegal value 4096 and have the nonstandard state X1.

Example

The following example sets this timer to 3 minutes:

interface serial 0

x25 hold-vc-timer 3

x25 htc

To set the highest two-way virtual circuit number, use the x25 htc interface configuration command.

x25 htc circuit-number

Syntax Description

circuit-number Virtual circuit number from 1 through 4095, or 0 if there is no two-way virtual circuit range. The default is 1024 for X.25 network service interfaces; 4095 for CMNS network service interfaces.

Default

1024 for X.25 network service interfaces; 4095 for CMNS network service interfaces.

Command Mode

Interface configuration

Usage Guidelines

This command is applicable if the X.25 switch is configured for a two-way virtual circuit range. Any two-way virtual circuit range must come after (that is, be numerically larger than) any incoming-only range, and must come before any outgoing-only range.

Example

The following example sets a valid two-way virtual circuit range of 5 to 25:

interface serial 0        
x25 ltc 5
x25 htc 25

Related Commands

cmns enable
x25 ltc

x25 idle

To define the period of inactivity after which the router can clear a switched virtual circuit (SVC), use the x25 idle interface configuration command.

x25 idle minutes

Syntax Description

minutes Idle period in minutes. The default is 0, which causes the router to keep the SVC open indefinitely.

Default

0 (causes the router to keep the SVC open indefinitely)

Command Mode

Interface configuration

Usage Guidelines

Both calls originated and terminated by the router are cleared; switched virtual circuits are not cleared. To clear one or all virtual circuits at once, use the privileged EXEC command clear x25-vc.

Example

The following example sets a 5-minute wait period before an idle circuit is cleared:

interface serial 2

x25 idle 5

Related Command

clear x25-vc

x25 ip-precedence

To enable the router to use the IP precedence value when it opens a new virtual circuit, use the x25 ip-precedence interface configuration command. To cause the precedence value to be ignored when opening virtual circuits, use the no form of this command.

x25 ip-precedence
no x25 ip-precedence

Syntax Description

This command has no arguments or keywords.

Default

The routers open one virtual circuit for all types of service.

Command Mode

Interface configuration

Usage Guidelines

This feature is useful only for DDN or BFE encapsulations, because only these methods have an IP precedence facility defined to allow the source and destination devices to both use the virtual circuit for traffic of the given IP priority.

There is a problem associated with this feature in that some hosts send nonstandard data in the IP TOS field, thus causing multiple wasteful virtual circuits to be created.

Four virtual circuits may be opened based on IP precedence to encapsulate routine, priority, immediate, and all higher precedences.

The x25 map nvc limit or the default x25 nvc limit still applies.

Example

The following example allows new IP encapsulation virtual circuits based on the IP precedence:

interface serial 3

x25 ip-precedence

x25 ips

To set the interface default maximum input packet size to match that of the network, use the x25 ips interface configuration command.

x25 ips bytes

Table of Contents

Syntax Description

Command Mode

Example

Related Commands

Syntax Description

Command Mode

Example

Related Command

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Defaults

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Defaults

Command Mode

Usage Guidelines

Example

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Defaults

Command Mode

Usage Guidelines

Example

Related Command

Syntax Description

Default

Command Mode

Example

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Syntax Description

Defaults

Command Mode

Usage Guidelines

Example

Related Commands

Syntax Description

Command Mode

Sample Display

Related Command

Syntax Description

Command Mode

Sample Displays

Related Command

Syntax Description

Command Mode

Sample Display