- Cisco IOS Wide-Area Networking Command Reference, Release 12.2
Table Of Contents
x25 bfe-decision
This command is no longer supported.
x25 bfe-emergency
This command is no longer supported.
x25 default
To set a default protocol that Cisco IOS software will assume applies to incoming calls with unknown or missing protocol identifier in the call user data (CUD), 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
Defaults
No default protocol is specified.
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
This command specifies the protocol assumed by the Cisco IOS software for incoming calls with unknown or missing protocol identifier in the call user data (CUD). If you do not use the x25 default interface configuration command, the software clears any incoming calls with unrecognized CUD.
Examples
The following example establishes IP as the default protocol for X.25 calls:
interface serial 0x25 default ipRelated Commands
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 option value
no x25 facility option value
Syntax Description
option
Set of user facilities options. See Table 55 for a list of supported facilities and their values.
value
Option value. See Table 55 for a list of supported facilities and their values.
Defaults
No facility is sent.
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
Table 55 lists the set of x25 facility command user facilities options.
Examples
The following example specifies a transit delay value in an X.25 configuration:
interface serial 0x25 facility transit-delay 24000The following example sets an ROA name and then sends the list via the X.25 user facilities:
x25 roa green_list 23 35 36interface serial 0x25 facility roa green_listRelated Commands
x25 fail-over
To configure a secondary interface and set the number of seconds for which a primary interface must be up before the secondary interface resets, use the x25 fail-over command in the appropriate configuration mode. To prevent the secondary interface from resetting, use the no form of this command.
x25 fail-over seconds interface type number [dlci | mac-address]
no x25 fail-over seconds interface type number [dlci | mac-address]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
The x25 fail-over command can be configured on a primary X.25 interface or an X.25 profile only.
Examples
In the following example, X.25 failover is configured on a network that is also configured for Annex G. If data-link connection identifier (DLCI) 13 or DLCI 14 on serial interface 1/0 goes down, dialer interface 1 will serve as the secondary interface. After DLCI 13 or 14 comes back up and remains up for 20 seconds, dialer interface 1 will reset, sending all calls back to the primary interface.
interface serial1/0encapsulation frame-relayframe-relay interface-dlci 13x25-profile frame1exitframe-relay interface-dlci 14x25-profile frame1 dteexit!interface dialer1encapsulation x25exitx25 route ^1234 interface serial1/0 dlci 13x25 route ^1234 interface serial1/0 dlci 14x25 route ^1234 interface dialer1!x25 profile frame1x25 fail-over 20 interface dialer1exit!Related Commands
Displays information about X.25 links.
Configures an X.25 profile without specifying any hardware-specific information.
x25 hic
To set the highest incoming-only virtual circuit (VC) number, use the x25 hic interface configuration command.
x25 hic circuit-number
Syntax Description
Defaults
0
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
This command is applicable only if you have the X.25 switch configured for an incoming-only VC range. Incoming is from the perspective of the X.25 data terminal equipment (DTE). If you do not want any outgoing calls from your DTE, configure both ends to disable the two-way range (set the values of x25 ltc and x25 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.
Examples
The following example sets a valid incoming-only VC range of 1 to 5:
interface serial 0x25 lic 1x25 hic 5Related Commands
x25 hoc
To set the highest outgoing-only virtual circuit (VC) number, use the x25 hoc interface configuration command.
x25 hoc circuit-number
Syntax Description
Defaults
0
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is applicable only if you have the X.25 switch configured for an outgoing-only VC range. Outgoing is from the perspective of the X.25 data terminal equipment (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.
Examples
The following example sets a valid outgoing-only VC range of 2000 to 2005:
interface serial 0x25 loc 2000x25 hoc 2005Related Commands
x25 hold-queue
To set the maximum number of packets to hold until a virtual circuit (VC) is able to send, 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.
Defaults
10 packets
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
If you set the queue-size argument to 0 when using the no x25 hold-queue command, there will be no hold queue limit. While this setting will prevent drops until the router runs out of memory, it is only rarely appropriate. A VC hold queue value is determined when it is created; changing this parameter will not affect the hold queue limits of the existing virtual circuits.
Examples
The following example sets the X.25 hold queue to hold 25 packets:
interface serial 0x25 hold-queue 25Related Commands
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 that calls to a previously failed destination will be prevented. Incoming calls are still accepted.
Defaults
0 minutes
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
Only Call Requests that the router originates are 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.
Examples
The following example sets this timer to 3 minutes:
interface serial 0x25 hold-vc-timer 3x25 host
To define a static host name-to-address mapping, use the x25 host global configuration command. To remove the host name, use the no form of the command.
x25 host name x121-address [cud call-user-data]
no x25 host name
Syntax Description
name
Host name.
x121-address
The X.121 address.
cud call-user-data
(Optional) Sets the Call User Data (CUD) field in the X.25 Call Request packet.
Defaults
No static host name-to-address mapping is defined.
Command Modes
Global configuration
Command History
Usage Guidelines
This command permits you to map an X.121 address to an easily recognizable name. You can later use this host name instead of the X.121 address when you issue the translate command for X.25.
Examples
The following example specifies a static address mapping:
x25 host Willard 4085551212The following example removes a static address mapping:
no x25 host WillardThe following example specifies static address mapping from the X.121 address 12345678 to the host name "ocean". It then uses the name "ocean" in the translate command in place of the X.121 address when translating from the X.25 host to the PPP host with address 10.0.0.2.
x25 host ocean 12345678translate x25 ocean ppp 10.0.0.2 routingRelated Commands
x25 htc
To set the highest two-way virtual circuit (VC) number, use the x25 htc interface configuration command.
x25 htc circuit-number
Syntax Description
Defaults
1024 for X.25 network service interfaces; 4095 for CMNS network service interfaces.
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
This command is applicable if the X.25 switch is configured for a two-way VC range. Any two-way VC range must come after (that is, be numerically larger than) any incoming-only range, and must come before any outgoing-only range.
Examples
The following example sets a valid two-way VC range of 5 to 25:
interface serial 0x25 ltc 5x25 htc 25Related Commands
x25 hunt-group
To create and maintain a hunt group, use the x25 hunt-group global configuration command. To delete this hunt group, use the no form of this command.
x25 hunt-group name {rotary | vc-count}
no x25 hunt-group name
Syntax Description
name
Name you assign to the particular hunt group.
rotary
Each call steps to the next interface.
vc-count
Each call is placed on the interface with most available logical channels.
Command Modes
Global configuration
Command History
Usage Guidelines
Only one load-balancing distribution method can be selected for a hunt group, although one interface can participate in one or more hunt groups.
The rotary distribution method sends every call to the next available interface regardless of line speed and the number of available VCs on that interface.
The vc-count distribution method sends calls to the interface with the largest number of available logical channels. This method ensures a good load balance when you have lines of equal speed. If the line speeds are unequal, the vc-count method will favor the line with the higher speed. In cases where interfaces have the same line speed, the call is sent to the interface that is defined earliest in the hunt group.
To distribute calls equally among interfaces regardless of line speed, configure each interface with the same number of VCs.
With the vc-count distribution method, if a hunt group does not contain an operational interface, the call will be forwared to the next route if one was specified. If a session is terminated on an interface within the hunt group, that interface now has more available VCs and it will be chosen next.
Examples
X.25 Load Balancing Using VC-Count Distribution Method Example
In the following example, the vc-count distribution method is used on a hunt group that contains two serial interfaces that have different numbers of VCs. Assuming no sessions are being terminated at this time, the first 450 calls will be sent to Serial1, and subsequent calls will alternate between Serial0 and Serial1 until the interfaces are full.
interface serial0description 56k link supporting 50 virtual circuitsx25 htc 50!interface serial1description T1 line supporting 500 virtual circuitsx25 htc 500!x25 hunt-group hg-vc vc-countinterface serial0interface serial1!Hunt Group Configuration Example
The following example shows the creation of hunt group "HG1" with serial interfaces 1 and 2 and two specific XOT target IP addresses (172.17.125.54 and 172.17.125.34). Hunt group "HG1" is configured to use rotary distribution method. The example also shows the creation of hunt group "HG2" with serial interfaces 0 and 3. Hunt group "HG2" will use vc-count distribution method.
x25 hunt-group HG1 rotaryinterface serial 1interface serial 2xot 172.17.125.54xot 172.17.125.34exitx25 hunt-group HG2 vc-countinterface serial 0interface serial 3Related Commands
Displays X.25 hunt groups, detailed interface statistics, and distribution methods.
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
Defaults
0 (the SVC is kept open indefinitely)
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
Calls originated and terminated by the router are cleared; packet assembler/disassembler (PAD) and switched virtual circuits are not affected. To clear one or all virtual circuits at once, use the clear x25 privileged EXEC command.
Examples
The following example sets a 5-minute wait period before an idle circuit is cleared:
interface serial 2x25 idle 5Related Commands
x25 ip-precedence
To enable the Cisco IOS software to use the IP precedence value when it opens a new virtual circuit (VC), use the x25 ip-precedence interface configuration command. To cause the Cisco IOS software to ignore the precedence value when opening VCs, use the no form of this command.
x25 ip-precedence
no x25 ip-precedence
Syntax Description
This command has no arguments or keywords.
Defaults
The router opens one VC for all types of service.
Command Modes
Interface configuration
Command History
Usage Guidelines
This feature is useful only for Defense Data Network (DDN) or Blacker Front End (BFE) encapsulations because only these methods have an IP precedence facility defined to allow the source and destination devices to both use the VC for traffic of the given IP priority.
Verify that your host does not send nonstandard data in the IP type of service (TOS) field because it can cause multiple wasteful virtual circuits to be created.
Four VCs 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.
Examples
The following example allows new IP encapsulation VCs based on the IP precedence:
interface serial 3x25 ip-precedencex25 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
Syntax Description
bytes
Byte count. It can be one of the following values: 16, 32, 64, 128, 256, 512, 1024, 2048, or 4096.
Defaults
128 bytes
Command Modes
Interface configuration
Command History
Usage Guidelines
X.25 network connections have a default maximum input packet size set by the network administrator. Larger packet sizes require less overhead processing. To send a packet larger than the X.25 packet size over an X.25 virtual circuit, the Cisco IOS software must break the packet into two or more X.25 packets with the more data bit (M-bit) set. The receiving device collects all packets with the M-bit set and reassembles the original packet.
Note
Set the x25 ips and x25 ops commands to the same value unless your network supports asymmetric input and output packet sizes.
Examples
The following example sets the default maximum packet sizes to 512:
interface serial 1x25 ips 512x25 ops 512Related Commands
x25 lic
To set the lowest incoming-only virtual circuit (VC) number, use the x25 lic interface configuration command.
x25 lic circuit-number
Syntax Description
Defaults
0
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
This command is applicable only if you have the X.25 switch configured for an incoming-only VC range. Incoming is from the perspective of the X.25 DTE device. If you do not want any outgoing calls on your DTE device, disable the two-way range (set the values of x25 ltc and x25 htc to 0).
The following example sets a valid incoming-only VC range of 1 to 5, and sets the lowest two-way VC number:
interface serial 0x25 lic 1x25 hic 5x25 ltc 6Related Commands
x25 linkrestart
To force X.25 Level 3 (packet level) to restart when Level 2 (Link Access Procedure, Balanced [LAPB], the link level) resets, use the x25 linkrestart interface configuration command. To disable this function, use the no form of this command.
x25 linkrestart
no x25 linkrestart
Syntax Description
This command has no arguments or keywords.
Defaults
Forcing packet-level restarts is the default and is necessary for networks that expect this behavior.
Command Modes
Interface configuration
X.25 profile configuration
Command History
Examples
The following example disables the link-level restart:
interface serial 3no x25 linkrestartx25 loc
To set the lowest outgoing-only virtual circuit (VC) number, use the x25 loc interface configuration command.
x25 loc circuit-number
Syntax Description
Defaults
0
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
This command is applicable only if you have the X.25 switch configured for an outgoing-only VC range. Outgoing is from the perspective of the X.25 DTE device. If you do not want any incoming calls from your DTE device, configure the values of x25 loc and x25 hoc and set the values of x25 ltc and x25 htc to 0.
Examples
The following example sets a valid outgoing-only virtual circuit range of 2000 to 2005:
interface serial 0x25 loc 2000x25 hoc 2005Related Commands
x25 ltc
To set the lowest two-way virtual circuit (VC) number, use the x25 ltc interface configuration command.
x25 ltc circuit-number
Syntax Description
Defaults
1
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
This command is applicable if you have the X.25 switch 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.
Examples
The following example sets a valid two-way virtual circuit range of 5 to 25:
interface serial 0x25 ltc 5x25 htc 25Related Commands
x25 map
To set up the LAN protocols-to-remote host mapping, use the x25 map interface configuration command. To retract a prior mapping, use the no form of this command with the appropriate network protocols and X.121 address argument.
x25 map protocol address [protocol2 address2 [...[protocol9 address9]]] x121-address [option]
no x25 map protocol address x121-address
Syntax Description
protocol
Protocol type, entered by keyword. Supported protocols are entered by keyword, as listed in Table 56. As many as nine protocol and address pairs can be specified in one command line.
address
Protocol address.
x121-address
X.121 address of the remote host.
option
(Optional) Additional functionality that can be specified for originated calls. Can be any of the options listed in Table 57.
Defaults
No LAN protocol-to-remote host mapping is set up.
Command Modes
Interface configuration
X.25 profile configuration
Command History
Usage Guidelines
Because no defined protocol can dynamically determine LAN protocol-to-remote host mappings, you must enter all the information for each host with which the router may exchange X.25 encapsulation traffic.
Two methods are available to encapsulate traffic: Cisco's long-available encapsulation method and the Internet Engineering Task Force (IETF) standard method (defined in RFC 1356); the latter allows hosts to exchange several protocols over a single virtual circuit. Cisco's encapsulation method is the default (for backward compatibility) unless the interface configuration command specifies the ietf keyword.
When you configure multiprotocol maps, you can specify a maximum of nine protocol and address pairs in an x25 map command. However, you can specify a protocol only once. For example, you can specify the IP protocol and an IP address, but you cannot specify another IP address. If the compressedtcp and ip keywords are both specified, the same IP address must be used.
Bridging is supported only if you are using Cisco's traditional encapsulation method. For correct operation, bridging maps must specify the broadcast option.
Since most datagram routing protocols rely on broadcasts or multicasts to send routing information to their neighbors, the broadcast keyword is needed to run such routing protocols over X.25.
Encapsulation maps might also specify that traffic between the two hosts should be compressed, thus increasing the effective bandwidth between them at the expense of memory and computation time. Because each compression virtual circuit requires memory and computation resources, compression must be used with care and monitored to maintain acceptable resource usage and overall performance.
Open Shortest Path First (OSPF) Protocol treats a nonbroadcast, multiaccess network such as X.25 in much the same way as it treats a broadcast network by requiring the selection of a designated router. In previous releases, this required manual assignment in the OSPF configuration using the neighbor router configuration command. When the x25 map command is included in the configuration with the broadcast, and the ip ospf network command (with the broadcast keyword) is configured, there is no need to configure any neighbors manually. OSPF will now run over the X.25 network as a broadcast network. (Refer to the ip ospf network interface configuration command for more detail.)
Note
You can modify the options of an x25 map command by restating the complete set of protocols and addresses specified for the map, followed by the desired options. To delete a map command, you must also specify the complete set of protocols and addresses; the options can be omitted when deleting a map.
Once defined, a map's protocols and addresses cannot be changed. This requirement exists because the Cisco IOS software cannot determine whether you want to add to, delete from, or modify an existing map's protocol and address specification, or simply mistyped the command. To change a map's protocol and address specification, you must delete it and create a new map.
A given protocol-address pair cannot be used in more than one map on the same interface.
Table 56 lists the protocols supported by X.25.
Table 56 Protocols Supported by X.25
apollo
Apollo Domain
appletalk
AppleTalk
bridge
Bridging1
clns
ISO Connectionless Network Service
compressedtcp
TCP/IP header compression
decnet
DECnet
ip
IP
ipx
Novell IPX
pad
PAD links2
qllc
System Network Architecture (SNA) encapsulation in X.253
vines
Banyan VINES
xns
XNS
1 Bridging traffic is supported only for Cisco's traditional encapsulation method, so a bridge map cannot specify other protocols.
2 Packet assembler/disassembler (PAD) maps are used to configure session and protocol translation access, therefore, this protocol is not available for multiprotocol encapsulation.
3 Qualified Logical Link Control (QLLC) is not available for multiprotocol encapsulation.
Note
Table 57 lists the map options supported by X.25 using the x25 map command.
Examples
The following example maps IP address 172.20.2.5 to X.121 address 000000010300. The broadcast keyword directs any broadcasts sent through this interface to the specified X.121 address.
interface serial 0x25 map ip 171.20.2.5 000000010300 broadcastThe following example specifies an ROA name to be used for originating connections:
x25 roa green_list 23 35 36interface serial 0x25 map ip 172.20.170.26 10 roa green_listThe following example specifies an NUID facility to send on calls originated for the address map:
interface serial 0x25 map ip 172.20.174.32 2 nudata "Network User ID 35"Strings can be quoted, but quotation marks are not required unless embedded blanks are present.
Related Commands
x25 map bridge
To configure an Internet-to-X.121 address mapping for bridging of packets in X.25 frames, use the x25 map bridge interface configuration command. Use the no form of this command to disable the Internet-to-X.121 address mapping.
x25 map bridge x121-address broadcast [option]
Syntax Description
