|
|
This chapter explains the function and syntax of the X.25 and LAPB commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Wide-Area Networking Command Reference, Release 12.1.
To configure an incoming access class on virtual terminals, use the access-class (X.25) line configuration command.
access-class access-list-number in
Syntax Description
access-list-number An integer from 1 to 199 that you select for the access list. in Restricts incoming connections between a particular access server and the addresses in the access list.
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 Cisco IOS software to send a special address translation packet that includes an enter emergency mode command to the Blacker Front End (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 Cisco IOS software to the BFE when the BFE is in emergency mode. type Interface type. number Interface number.
Syntax Description
serial number Local serial interface being used for X.25 service. ethernet | fastethernet | tokenring | fddi number mac-address Local CMNS interface (Ethernet, Fast Ethernet, Token Ring, or FDDI interface) and MAC address of the remote device; this information identifies a CMNS service. vc-number (Optional) SVC or PVC number, in the range 1 to 4095. If specified, the SVC is cleared or the PVC is reset. If not specified, the X.25 or CMNS service is restarted. dlci number (Optional) When combined with a serial interface number, it triggers a restart event for an Annex G logical X.25 VC.
The clear x25 command replaces the clear-x25-vc command. For more information, see the description of the clear x25 command earlier in this chapter.
To clear an X.25 over TCP (XOT) switched virtual circuit (SVC) or reset an XOT permanent virtual circuit (PVC), use the clear xot EXEC command.
clear xot remote ip-address port local ip-address port
Syntax Description
remote ip-address port Remote IP address and port number of an XOT connection ID. local ip-address port Local IP address and port number of an XOT connection ID.
To enable the 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 enableSyntax Description
This command has no arguments or keywords.
To exchange datagrams over a serial interface using Link Access Procedure, Balanced (LAPB) encapsulation, use the encapsulation lapb interface configuration command.
encapsulation lapb [dte | dce] [multi | protocol]
Syntax Description
dte (Optional) Specifies operation as a data terminal equipment (DTE) device. This is the default LAPB mode. dce (Optional) Specifies operation as a data communications equipment (DCE) device. 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.
To specify a 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 BFE device. ietf (Optional) Specifies that the interface's datagram encapsulation defaults to use of the Internet Engineering Task Force (IETF) standard method, as defined by RFC 1356.
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 (ms) that a hardware outage can last without the protocol disconnecting the service.
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).
To specify the Link Access Procedure, Balanced (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 basic mode; the value 128 specifies LAPB extended mode.
To specify the maximum number of bits a frame can hold (the Link Access Procedure, Balanced [LAPB] N1 parameter), use the lapb n1 interface configuration command.
lapb n1 bits
Syntax Description
bits Maximum number of bits in multiples of eight. The minimum and maximum range is dynamically set. Use the question mark (?) to view the range.
To specify the maximum number of times a data frame can be sent (the Link Access Procedure, Balanced [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 to 255.
This command is obsolete. It has been replaced by the [protocol | multi] option of the encapsulation lapb command. For more information, see the description of the [protocol | multi] option of the encapsulation lapb command earlier in this chapter.
To set the retransmission timer period (the Link Access Procedure, Balanced [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 to 64000.
To set the T4 idle timer, after which the Cisco IOS software 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 receipt of the last frame and transmission of the outgoing poll.
To enable all packet assembler/disassembler (PAD) commands and connections between PAD devices and access servers, use the service pad global configuration command. Use the no form of this command to disable this service.
service pad [cmns][from-xot][to-xot]
Syntax Description
cmns (Optional) Specifies sending and receiving PAD calls over CMNS. from-xot (Optional) Accepts XOT to PAD connections. to-xot (Optional) Allows outgoing PAD calls over XOT.
To permit incoming X.25 over TCP (XOT) calls to be accepted as a packet assembler/disassembler (PAD) session, use the service pad from-xot global configuration command. To disable this service, use the no form of this command.
service pad from-xotSyntax Description
This command has no arguments or keywords.
To permit outgoing PAD sessions to use routes to an XOT destination, use the service pad to-xot global configuration command. To disable this service, use the no form of this command.
service pad to-xotSyntax Description
This command has no arguments or keywords.
To display X.25 Level 3 parameters for LAN interfaces (such as Ethernet or Token Ring) and other information pertaining to Connection-Mode Network Service (CMNS) traffic activity, use the show cmns EXEC command.
show cmns [type number]
Syntax Description
type (Optional) Interface type. number (Optional) Interface number.
Syntax Description
interface number (Optional) Specific logical X.25 VC interface. dlci number (Optional) Specific DLCI link.
To display information about all or specific (defined by the local or network closed user group (CUG) number) CUGs, use the show x25 cug EXEC command.
show x25 cug {local-cug number | network-cug number}
Syntax Description
local-cug Locally significant CUG identifier. number Local CUG number (0 to 9999). network-cug Network translated CUG identifier. number Network CUG number (0 to 9999).
Syntax Description
name (Optional) Displays the specific hunt group named.
To display information about virtual circuits (VCs) that use an X.25 interface and, optionally, about a specified virtual circuit, use the show x25 interface EXEC command.
show x25 interface [serial number | cmns-interface mac mac-address]
Syntax Description
serial number (Optional) Keyword serial and number of the serial interface used for X.25. cmns-interface mac mac-address (Optional) Local CMNS interface type and number, plus the MAC address of the remote device. CMNS interface types are Ethernet, Token Ring, or FDDI. The interface numbering scheme depends on the router interface hardware.
To display information about configured address maps, use the show x25 map EXEC command.
show x25 mapSyntax Description
This command has no arguments or keywords.
To view details of X.25 profiles on your router, use the show x25 profile command in EXEC mode.
show x25 profile [name]
Syntax Description
name (Optional) Name of X.25 profile.
To display the one-to-one mapping of the host IP addresses and the remote Blacker Front End (BFE) device's IP addresses, use the show x25 remote-red EXEC command.
show x25 remote-redSyntax Description
This command has no arguments or keywords.
To display the X.25 routing table, use the show x25 route EXEC command.
show x25 routeSyntax Description
This command has no arguments or keywords.
To display information pertaining to the X.25 services, use the show x25 services EXEC command.
show x25 servicesSyntax Description
This command has no arguments or keywords.
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).
To display information for all X.25 over TCP (XOT) virtual circuits that match a given criterion, use the show x25 xot EXEC command.
show x25 xot [local ip-address [port port]] [remote ip-address [port port]]
Syntax Description
local ip-address [port port] (Optional) Local IP address and optional port number. remote ip-address [port port] (Optional) Remote IP address and optional port number.
To configure the Cisco IOS software 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-reverseSyntax Description
This command has no arguments or keywords.
Syntax Description
x121-address Variable-length X.121 address. It is assigned by the X.25 network service provider.
To configure an interface alias address that will allow this interface to accept calls with other destination addresses, use the x25 alias interface configuration command.
x25 alias {destination-pattern | x121-address-pattern} [cud cud-pattern]
Syntax Description
destination-pattern Regular expression used to match against the destination address of a received call. x121-address-pattern Alias X.121 address for the interface, allowing it to act as destination host for calls having different destination address. cud cud-pattern
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. This information is obtained from the table created by the x25 remote-red command. ask Configures the Cisco IOS software to prompt you to enter the bfe EXEC command.
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 Blacker Front End (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 to enter emergency mode. When the diagnostic packet is received, the participation in emergency mode depends on how the router is configured with the x25 bfe-decision command.
Syntax Description
protocol Specifies the protocol to assume; may be ip or pad.
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
Syntax Description
option Set of user facilities options. See Table 16 for a list of supported facilities and their values. value Option value. See Table 16 for a list of supported facilities and their values.
Table 16 lists the set of x25 facility command user facilities options.
| User Facilities Option | Description |
|---|---|
cug number | |
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 | |
transit-delay value | Specifies a network transit delay to request for the duration of outgoing calls for networks that support transit delay. The transit delay value can be between 0 and 65534 milliseconds. |
roa name | Specifies the name defined by the x25 roa command for a list of transit Recognized Operation Agencies (ROAs) to use in outgoing Call Request packets. |
To set the highest incoming-only virtual circuit (VC) number, use the x25 hic interface configuration command.
x25 hic circuit-number
Syntax Description
circuit-number VC number from 1 to 4095, or 0 if there is no incoming-only VC range.
To set the highest outgoing-only virtual circuit (VC) number, use the x25 hoc interface configuration command.
x25 hoc circuit-number
Syntax Description
circuit-number VC number from 1 to 4095, or 0 if there is no incoming-only VC range.
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
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.
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
Syntax Description
minutes Number of minutes to prevent calls from trying a previously failed destination. Incoming calls are still accepted.
Syntax Description
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.
To set the highest two-way virtual circuit (VC) number, use the x25 htc interface configuration command.
x25 htc circuit-number
Syntax Description
circuit-number VC number from 1 to 4095, or 0 if there is no two-way VC range.
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.
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.
Syntax Description
This command has no arguments or keywords.
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.
To set the lowest incoming-only virtual circuit (VC) number, use the x25 lic interface configuration command.
x25 lic circuit-number
Syntax Description
circuit-number VC number from 1 to 4095, or 0 if there is no incoming-only VC range.
Syntax Description
This command has no arguments or keywords.
Syntax Description
circuit-number VC number from 1 to 4095, or 0 if there is no outgoing-only VC range.
To set the lowest two-way virtual circuit (VC) number, use the x25 ltc interface configuration command.
x25 ltc circuit-number
Syntax Description
circuit-number VC number from 1 to 4095, or 0 if there is no two-way VC range.
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 protocol(s) and X.121 address argument.
x25 map protocol address [protocol2 address2 [...[protocol9 address9]]] x121-address [option]
Syntax Description
protocol Protocol type, entered by keyword. Supported protocols are entered by keyword, as listed in Table 17. 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 18.
Table 17 lists the protocols supported by X.25.
| Keyword | Protocol |
|---|---|
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 |
Table 18 lists the map options supported by X.25 using the x25 map command.
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
x121-address The X.121 address. broadcast Required keyword for bridging over X.25. option (Optional) Services that can be added to this map (same options as the x25 map command).
The enhanced x25 route command replaces the x25 map cmns command. See the description of the x25 route command for more information.
To map compressed TCP traffic to an X.121 address, use the x25 map compressedtcp interface configuration command. To delete a TCP/IP header compression map for the link, use the no form of this command.
x25 map compressedtcp ip-address [protocol2 address2 [...[protocol9 address9]]]
Syntax Description
ip-address IP address. protocol (Optional) Protocol type, entered by keyword. Supported protocols are entered by keyword, as listed in Table 17. As many as nine protocol and address pairs can be specified in one command line. address (Optional) Protocol address. x121-address X.121 address. option (Optional) The same options as those for the x25 map command; see Table 18 earlier in this chapter.
To configure an X.121 address mapping for packet assembler/disassembler (PAD) access over X.25, use the x25 map pad interface configuration command.
x25 map pad x121-address [option]
Syntax Description
x121-address X.121 address of the interface. option (Optional) Services that can be added to this map---the same options as the x25 map command (see Table 18 earlier in this chapter).
To set the window modulus, use the x25 modulo interface configuration command.
x25 modulo modulus
Syntax Description
modulus Either 8 or 128. The value of the modulo parameter must agree with that of the device on the other end of the X.25 link.
To specify the maximum number of virtual circuits (VCs) that a protocol can have open simultaneously to one host, use the x25 nvc interface configuration command. To increase throughput across networks, you can establish up to eight virtual circuits to a host and protocol.
x25 nvc count
Syntax Description
count Circuit count from 1 to 8. A maximum of eight virtual circuits can be configured for each protocol-host pair. Protocols that do not tolerate out-of-order delivery, such as encapsulated TCP/IP header compression, will use only one virtual circuit despite this value. Permitting more than one VC may help throughput on slow networks.
To set the interface default maximum output packet size to match that of the network, use the x25 ops interface configuration command.
x25 ops bytes
Syntax Description
bytes Byte count that is one of the following: 16, 32, 64, 128, 256, 512, 1024, 2048, or 4096.
To cause the packet assembler/disassembler (PAD) software to accept PAD connections only from statically mapped X.25 hosts, use the x25 pad-access interface configuration command. To disable checking maps on PAD connections, use the no form of this command.
x25 pad-accessSyntax Description
This command has no arguments or keywords.
Syntax Description
name X.25 profile name that you assign. dce Indicates a DCE interface. dte Indicates a DTE interface. dxe Indicates a DXE interface.
To establish an encapsulation permanent virtual circuit (PVC), use the encapsulating version of the x25 pvc interface configuration command. To delete the PVC, use the no form of this command with the appropriate channel number.
x25 pvc circuit protocol address [protocol2 address2 [...[protocol9 address9]]] x121-address
Syntax Description
circuit Virtual-circuit channel number, which must be less than the virtual circuits assigned to the switched virtual circuits (SVCs). protocol Protocol type, entered by keyword. Supported protocols are listed in Table 19. As many as nine protocol and address pairs can be specified in one command line. address Protocol address of the host at the other end of the PVC. x121-address X.121 address. option (Optional) Provides additional functionality or allows X.25 parameters to be specified for the PVC. Can be any of the options listed in Table 20.
Table 19 lists supported protocols.
| Keyword | Protocol |
|---|---|
apollo | Apollo Domain |
appletalk | AppleTalk |
bridge | Bridging1 |
clns | OSI Connectionless Network Service |
compressedtcp | TCP/IP header compression |
decnet | DECnet |
ip | IP |
ipx | Novell IPX |
qllc | SNA encapsulation in X.252 |
vines | Banyan VINES |
xns | XNS |
| 1Bridging traffic is supported only for Cisco's traditional encapsulation method, so a bridge PVC cannot specify other protocols. 2QLLC is not available for multiprotocol encapsulation. |
Table 20 lists supported X.25 PVC options.
| Option | Description |
|---|---|
broadcast | Causes the Cisco IOS software to direct any broadcasts sent through this interface to this PVC. This option also simplifies the configuration of OSPF. |
method {cisco | ietf | snap | multi} | Specifies the encapsulation method. The choices are as follows:
|
packetsize in-size out-size | |
passive | Specifies that transmitted TCP datagrams will be compressed only if they were received compressed. This option is available only for PVCs carrying compressed TCP/IP header traffic. |
windowsize in-size out-size |
To configure a switched permanent virtual circuit (PVC) for a given interface, use the switched version of the x25 pvc interface configuration command.
x25 pvc number1 interface type number pvc number2 [option]
Syntax Description
number1 PVC number that will be used on the local interface (as defined by the primary interface command). interface Required keyword to specify an interface. type Remote interface type. number Remote interface number. pvc Required keyword to specify a switched PVC. number2 PVC number that will be used on the remote interface. option (Optional) Adds certain features to the mapping specified; can be either option listed in Table 21.
Table 21 lists the switched PVC options supported by X.25.
| Option | Description |
|---|---|
packetsize in-size out-size | |
windowsize in-size out-size |
To configure a switched permanent virtual circuit (PVC) to a switched virtual circuit (SVC) for a given interface, use the switched PVC to SVC version of the x25 pvc interface configuration command.
x25 pvc number1 svc x121-address [flow-control-options] [call-control-options]
Syntax Description
number1 Logical channel ID of the PVC. Value must be lower than any range of circuit numbers defined for SVCs. svc Specifies a SVC type. x121-address Destination X.121 address for opening an outbound SVC and source X.121 address for matching an inbound SVC. flow-control-options (Optional) Adds certain features to the mapping specified. It can be any of the options listed in Table 22. call-control-options (Optional) Adds certain features to the mapping specified. It can be any of the options listed in Table 23.
Table 22 lists the flow control options supported by X.25 during PVC to SVC switching.
| Option | Description |
|---|---|
packetsize in-size out-size | Maximum input packet size (in-size) and output packet size (out-size) for both the PVC and SVC. Values may differ but must be one of the following: 16, 32, 64, 128, 256, 512, 1024, 2048, or 4096. |
windowsize in-size out-size | Packet count for input window (in-size) and output window (out-size) for both the PVC and SVC. Both values may differ but must be in the range 1 to 127 and must be less than the value set for the x25 modulo command. |
Table 23 lists the call control options supported by X.25 during PVC to SVC switching.
| Option | Description |
|---|---|
idle minutes | |
no-incoming | Establishes a switched virtual circuit to the specified X.121 address when data is received from the permanent virtual circuit, but does not accept calls from this X.121 address. |
no-outgoing | Accepts an incoming call from the specified X.121 address, but does not attempt to place a call when data is received from the permanent virtual circuit. If data is received from the permanent virtual circuit while no call is connected, the PVC will be reset. |
accept-reverse | Causes the Cisco IOS software to accept incoming reverse-charged calls. If this option is not present, the Cisco IOS software clears reverse-charged calls unless the interface accepts all reverse-charged calls. |
Syntax Description
number1 PVC number of the connecting device. xot Indicates two PVCs will be connected across a TCP/IP LAN using XOT. address IP address of the device to which you are connecting. interface serial Indicates the interface is serial. string Serial interface specification that accepts either a number or a string in model 7000 format (number/number) to denote the serial interface. pvc Indicates a PVC. number2 Remote PVC number on the target interface. option (Optional) Adds certain features for the connection; can be either option listed in Table 24.
Table 24 lists the PVC tunnel options supported by X.25.
| Option | Description |
|---|---|
packetsize in-size out-size | |
windowsize in-size out-size |
To set up the table that lists the Blacker Front End (BFE) nodes (host or gateways) to which the router will send packets, use the x25 remote-red interface configuration command.
x25 remote-red host-ip-address remote-black blacker-ip-address
Syntax Description
host-ip-address IP address of the host or router that the packets are being sent to. remote-black Delimits the addresses for the table being built. blacker-ip-address IP address of the remote BFE device in front of the host to which the packet is being sent.
To activate a secondary route while also retrying a failed primary route, use the x25 retry interface configuration command in conjunction with the ip route or backup interface commands. To discontinue implementing secondary X.25 routes and retrying of primary X.25 routes, use the no form of this command.
x25 retry interval seconds attempts count
Syntax Description
interval Keyword defining interval between attempts. seconds Number of seconds between attempts. attempts Keyword defining number of attempts. count Number of attempts to reestablish the closed link before discontinuing.
To specify a sequence of packet network carriers, use the x25 roa global configuration command. To remove the specified name, use the no form of this command.
x25 roa name number
Syntax Description
name Recognized Operating Agency (ROA, formerly called a Recognized Private Operating Agency, or RPOA), which must be unique with respect to all other ROA names. It is used in the x25 facility and x25 map interface configuration commands. number A sequence of 1 or more numbers used to describe an ROA; up to 10 numbers are accepted.
To create an entry in the X.25 routing table (to be consulted for forwarding incoming calls and for placing outgoing packet assembler/disassembler (PAD) or protocol translation calls), use the appropriate form of the x25 route global configuration command. To remove an entry from the table, use the no form of the command.
x25 route [#position] [selection-options] [modification-options] disposition-options [xot-keepalive-options]
Syntax Description
#position (Optional) A pound sign (#) followed by a number designates the position in the routing table at which to insert the new entry. If no value for the position argument is given, the entry is appended to the end of the routing table. selection-options (Optional) The selection options identify when the subsequent modification and disposition options apply to an X.25 call; any or all variables may be specified for a route. For selection keyword and argument options, see Table 25. For selection and modification pattern and character matching and replacement see Table 27, Table 28, and Table 29. Although each individual selection criterion is optional, at least one selection or modification option must be specified in the x25 route command. modification-options (Optional) The modification options modify the source or destination addresses of the selected calls. The standard regular expression substitution rules are used, where a match pattern and rewrite string direct the construction of a new string. For modification keyword and argument options, see Table 26. For selection and modification pattern and character matching and replacement see Table 27, Table 28, and Table 29. Although each individual modification is optional, at least one selection or modification option must be specified in the x25 route command. disposition-options Specifies the disposition of a call matching the specified selection pattern. For disposition keyword and argument options, see Table 30 in the "Usage Guidelines" section. xot-keepalive-options (Optional) The XOT-keepalive options specify an X.25 over TCP (XOT) keepalive period and number of XOT-keepalive retries. XOT relies on TCP to detect when the underlying connection is dead. TCP detects a dead connection when sent data goes unacknowledged for a given number of attempts over a period of time. For XOT-keepalive keyword and argument options, see Table 31 .
Table 25 lists the selection options for the x25 route command. At least one selection or modification option must be specified.
| Selection Option | Description | ||
|---|---|---|---|
destination-pattern | (Optional) Destination address pattern, which is a regular expression that can represent either one X.121 address (such as ^1111000$) or any address in a group of X.121 addresses (such as ^1111.*). | ||
source source-pattern | (Optional) Source address pattern, which is a regular expression that can represent either one X.121 source address (such as ^2222000$) or any address in a group of X.121 addresses (such as ^2222.*). | ||
dest-ext nsap-destination-pattern | (Optional) NSAP destination address pattern, which is a regular expression that can represent either an NSAP destination address (such as ^11.1111.0000$) or an NSAP prefix (such as ^11.1111.*).
| ||
cud user-data-pattern | |||
input interface interface number | (Optional) Specifies interface number on which the call will be received. | ||
hunt-group name | Routes the selected call to the X.25 hunt group. The chosen router may vary depending on the hunt group configuration. |
Table 26 lists the modification options for the x25 route command. At least one selection or modification option must be specified.
| Modification Option | Description |
|---|---|
substitute-source rewrite-source | (Optional) Calling X.121 address rewrite pattern. The source address, source-pattern, and this rewrite-source pattern are used to form a new source address. If no source-pattern is specified, any destination-pattern match pattern is used. If neither match pattern is specified, a default match pattern of .* is used. See Table 27 and Table 28 for summaries of pattern and character matching, respectively. See Table 29 for a summary of pattern rewrite elements. |
substitute-dest rewrite-dest | (Optional) Called X.121 address rewrite pattern. The destination address, destination-pattern, and this rewrite-dest pattern are used to form a new destination address. If no destination-pattern is specified, a default match pattern of .* is used. See Table 27 and Table 28 for summaries of pattern and character matching, respectively. See Table 29 for a summary of pattern rewrite elements. |
See Table 27, Table 28, and Table 29, respectively, for summaries of pattern matching, character matching, and pattern replacement elements.
| Pattern | Description |
|---|---|
* | Matches 0 or more occurrences of the preceding character. |
+ | Matches 1 or more occurrences of the preceding character. |
? | Matches 0 or 1 occurrences of the preceding character.1 |
| 1Precede the question mark with Ctrl-V to prevent the question mark from being interpreted as a help command. |
| Character | Description |
|---|---|
^ | Matches the beginning of the input string. |
$ | Matches the end of the input string. |
\char | Matches the single character char specified. |
. | Matches any single character. |
| Pattern | Description |
|---|---|
\0 | The pattern is replaced by the entire original address. |
\1...9 | The pattern is replaced by strings that match the first through ninth parenthetical part of the X.121 address. |
Table 30 lists the disposition options for the x25 route command. You must select one of these options.
| Disposition Option | Description |
|---|---|
continue | (Optional) Combines sequential route table lookups, holding onto any "selections" and "modifications" specified on the x25 route statement. |
interface interface number | Routes the selected call to the specified X.25 serial interface. |
interface interface number dlci number | (Optional) Routes the X.25 call to the specified Annex G link. You must include the interface number and enter the data link connection identifier (DLCI) number. You only need to do this if you want the router to accept switched calls, as well as originate them. |
interface cmns-interface mac mac-address | Routes the selected call out the specified broadcast interface via CMNS to the LAN destination station. The broadcast interface type can be Ethernet, Token Ring, or Fiber Distributed Data Interface (FDDI). The interface numbering scheme depends on the router interface hardware. |
xot ip-address [ip2-address [...[ip6-address]]] [xot-source interface] | Routes the selected call to the XOT host at the specified IP address. Subsequent IP addresses are tried, in sequence, only if XOT is unable to establish a TCP connection with a prior address. |
xot dns pattern | Used with DNS-based X.25 routing, this option consults the DNS to get up to six destination IP addresses using whatever lookup pattern you choose (see Table 29). |
hunt-group name | Routes the selected call to the X.25 hunt group. The chosen route may vary depending on the hunt group configuration. |
clear | Terminates the call. |
Table 31 lists and describes the xot-keepalive options for the x25 route command.
| XOT-Keepalive Option | Description |
|---|---|
xot-keepalive-period seconds | Number of seconds between keepalives for XOT connections. The default is 60 seconds. |
xot-keepalive-tries count | Number of times TCP keepalives should be sent before dropping the connection. The default value is 4 times. |
To enable X.25 switching or tunneling, use the x25 routing global configuration command. To disable the forwarding of X.25 calls, use the no form of this command.
x25 routing [acknowledge local | acknowledge end-to-end] [tcp-use-if-defs]
Syntax Description
acknowledge local (Optional) Sets local acknowledgment on the router. acknowledge end-to-end (Optional) Sets end-to-end acknowledgment. (Default acknowledge setting.) tcp-use-if-defs (Optional) Accepts calls received over TCP.
To enable and control standard closed user group (CUG) behavior on an X.25 DCE interface, use the x25 subscribe cug-service interface configuration command. To disable standard CUG behavior on an X.25 DCE interface, use the no form of this command.
x25 subscribe cug-service [incoming-access | outgoing-access]
Syntax Description
incoming-access (Optional) Allows incoming access from the open network to the DTE device. outgoing-access (Optional) Allows outgoing access from the DTE device to the open network.
To control flow control parameter negotiation facilities in call setup packets, use the x25 subscribe flow-control interface configuration command. To have flow control parameter negotiation facilities included in call setup (outgoing) packets only when their values differ from the default values, use the no form of this command.
x25 subscribe flow-control {always | never}
Syntax Description
always Flow control parameter negotiation facilities are enabled and the flow control parameters are always included with call setup packets and are optional on inbound packets. never Flow control parameter negotiation facilities are disabled and the flow control parameters are never included with call setup packets, and are not permitted on inbound packets. Negotiation of flow control parameters is disabled.
To configure a data circuit-terminating equipment (DCE) X.25 interface for a specific closed user group (CUG) subscription, use the x25 subscribe local-cug interface configuration command. To disable the interface for a specific CUG subscription, use the no form of this command.
x25 subscribe local-cug number network-cug number [no-incoming | no-outgoing | preferential]
Syntax Description
number Specific local CUG number (0 to 9999). network-cug Network translated CUG identifier. number Specific network CUG number (0 to 9999). no-incoming no-outgoing (Optional) Calls from DTE are barred within the specified CUG, unless x25 subscribe cug-service outgoing-access is configured. preferential
To set permitted and target ranges for packet size during flow control negotiation, use the x25 subscribe packetsize interface configuration command. To revert to the default packet size ranges, use the no form of this command.
x25 subscribe packetsize {permit pmin pmax | target pmin pmax}
Syntax Description
permit Permitted packet-size range identifier. pmin Minimum setting for packet size range (16 to 4096 by a power of 2). pmax Maximum setting for packet size range (16 to 4096 by a power of 2). target Target packet-size range identifier.
To set permitted and target ranges for window size during flow control negotiation, use the x25 subscribe windowsize interface configuration command. To revert to the default window size ranges, use the no form of this command.
x25 subscribe windowsize {permit wmin wmax | target wmin wmax}
Syntax Description
permit Permitted window size range identifier. wmin Minimum setting for window size range (1 to 127). wmax Maximum setting for window size range (1 to 127). target Target window-size range identifier.
Syntax Description
This command has no arguments or keywords.
Syntax Description
This command has no arguments or keywords.
To set the value of the Restart Indication retransmission timer (T10) on DCE devices, use the x25 t10 interface configuration command .
x25 t10 seconds
Syntax Description
seconds Time in seconds.
To set the value of the Incoming Call timer (T11) on DCE devices, use the x25 t11 interface configuration command.
x25 t11 seconds
Syntax Description
seconds Time in seconds.
To set the value of the Reset Indication retransmission timer (T12) on DCE devices, use the x25 t12 interface configuration command.
x25 t12 seconds
Syntax Description
seconds Time in seconds.
To set the value of the Clear Indication retransmission timer (T13) on DCE devices, use the x25 t13 interface configuration command.
x25 t13 seconds
Syntax Description
seconds Time in seconds.
To set the value of the Restart Request retransmission timer (T20) on DTE devices, use the x25 t20 interface configuration command.
x25 t20 seconds
Syntax Description
seconds Time in seconds.
To set the value of the Call Request timer (T21) on DTE devices, use the x25 t21 interface configuration command.
x25 t21 seconds
Syntax Description
seconds Time in seconds.
To set the value of the Reset Request retransmission timer (T22) on DTE devices, use the x25 t22 interface configuration command.
x25 t22 seconds
Syntax Description
seconds Time in seconds.
To set the value of the Clear Request retransmission timer (T23) on DTE devices, use the x25 t23 interface configuration command.
x25 t23 seconds
Syntax Description
seconds Time in seconds.
To set the data packet acknowledgment threshold, use the x25 threshold interface configuration command.
x25 threshold delay-count |
Note This command replaces the longstanding x25 th command. |
Syntax Description
delay-count Value between 0 and the input window size. A value of 1 sends one Receiver Ready acknowledgment per packet.
To override the X.121 addresses of outgoing calls forwarded over a specific interface, use the x25 use-source-address interface configuration command. Use the no form of this command to prevent updating the source addresses of outgoing calls.
x25 use-source-addressSyntax Description
This command has no arguments or keywords.
To change the default incoming window size to match that of the network, use the x25 win interface configuration command.
x25 win packets
Syntax Description
packets Packet count that can range from 1 to one less than the window modulus.
To change the default outgoing window size to match that of the network, use the x25 wout interface configuration command.
x25 wout packets
Syntax Description
packets Packet count that can range from 1 to one less than the window modulus.
To limit access to the access server from certain X.25 hosts, use the x29 access-list global configuration command. To delete an entire access list, use the no form of this command.
x29 access-list access-list-number {deny | permit} x121-address
Syntax Description
access-list-number Number of the access list. It can be a value between 1 and 199. deny Denies access and clears call requests immediately. permit Permits access to the protocol translator. x121-address If applied as an inbound access class, specifies the X.121 address that can or cannot have access (with or without regular expression pattern-matching characters). The X.121 address is the source address of the incoming packet. If applied as an outbound access class, then the address specifies a destination to where connections are allowed.
To create a packet assembler/disassembler (PAD) profile script for use by the translate command, use the x29 profile global configuration command.
x29 profile {default | name} parameter:value [parameter:value]
Syntax Description
default Specifies default profile script. name Name of the PAD profile script. parameter:value X.3 PAD parameter number and value separated by a colon. You can specify multiple parameter-value pairs on the same line.
Posted: Wed Jul 26 17:20:21 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.