|
|
This chapter describes the function and displays the syntax for X.25 and Link Access Procedure, Balanced (LAPB) commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Wide-Area Networking Command Reference.
To configure an incoming access class on virtual terminals, use the access-class line configuration command.
access-class access-list-number in| access-list-number | An integer between 1 and 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| 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. |
Use the clear x25 privileged EXEC command to restart an X.25 or CMNS service, to clear an SVC, or to reset a PVC.
clear x25 {serial number | cmns-interface mac-address} [vc-number]| serial number | Local serial interface being used for X.25 service. |
| cmns-interface mac-address | Local CMNS interface (an 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. |
This command is replaced by the clear x25 command.
To clear an XOT SVC or reset an XOT PVC, use the clear xot EXEC command.
clear xot remote ip-address port local ip-address port| 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 enableTo exchange datagrams over a serial interface using LAPB encapsulation, use the encapsulation lapb interface configuration command.
encapsulation lapb [dte | dce] [multi | protocol]| 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]| 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| milliseconds | Number of milliseconds a hardware outage can last without having the protocol disconnect the service. The default is 0 ms, which disables this feature. |
To specify the maximum permissible number of outstanding frames, called the window size, use the lapb k interface configuration command.
lapb k window-size| 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. |
To specify the LAPB basic (modulo 8) or extended (modulo 128) protocol mode, use the lapb modulo interface configuration command.
lapb modulo modulus| 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. |
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| 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 transmitted (the LAPB N2 parameter), use the lapb n2 interface configuration command.
lapb n2 tries| tries | Transmission count. It can be a value from 1 to 255. The default is 20 transmissions. |
This command is obsolete. It has been replaced by the [protocol | multi] option of the encapsulation lapb command.
To set the retransmission timer period (the LAPB T1 parameter), use the lapb t1 interface configuration command.
lapb t1 milliseconds| milliseconds | Time in milliseconds. It can be a value from 1 to 64000. The default is 3000 ms. |
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| 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. |
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]| cmns | (Optional) Specifies sending and receiving of PAD calls over CMNS. |
To permit incoming XOT Calls to be accepted as a PAD session, use the service pad from-xot global configuration command. Use the no form of this command to disable this service.
service pad from-xotTo permit outgoing PAD sessions to use routes to an XOT destination, use the service pad to-xot global configuration command. Use the no form of this command to disable this service.
service pad to-xotTo 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]| type | (Optional) Interface type. |
| number | (Optional) Interface number. |
To display information about a serial interface, use the show interfaces serial EXEC command.
show interfaces serial number| number | Interface port number. |
To display active Logical Link Control, type 2 (LLC2) connections, use the show llc2 EXEC command.
show llc2cTo display information about 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]| 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 mapTo 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-redTo display the X.25 routing table, use the show x25 route EXEC command.
show x25 routeTo display information pertaining to the X.25 services, use the show x25 services EXEC command.
show x25 servicesTo display information about active switched virtual circuits (SVCs) and permanent virtual circuits (PVCs), use the show x25 vc EXEC command.
show x25 vc [lcn]| lcn | (Optional) Logical channel number (LCN). |
To display information for all 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]]| local ip-address [port port] | Local IP address and optional port number. |
| remote ip-address [port port] | 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-reverseTo set the X.121 address of a particular network interface, use the x25 address interface configuration command.
x25 address x121-address| x121-address | Variable-length X.121 address. The address 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 [cud cud-pattern]| destination-pattern | Regular expression used to match against the destination address of a received call. |
| cud cud-pattern | (Optional) Call user data (CUD) pattern, a regular expression of ASCII text. The CUD field might be present in a call packet. The first few bytes (commonly 4 bytes long) identify a protocol; the specified pattern is applied to any user data after the protocol identification. |
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}| 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}| 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. |
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| 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 facility-keyword value| facility-keyword | User facility. |
| value | Facility value. |
To set the highest incoming-only virtual circuit number, use the x25 hic interface configuration command.
x25 hic circuit-number| circuit-number | Virtual circuit number from 1 to 4095, or 0 if there is no incoming-only virtual circuit range. The default is 0. |
To set the highest outgoing-only virtual circuit number, use the x25 hoc interface configuration command.
x25 hoc circuit-number| circuit-number | Virtual circuit number from 1 to 4095, or 0 if there is no outgoing-only virtual circuit range. The default is 0. |
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| 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. |
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| minutes | Number of minutes to prevent calls from going to a previously failed destination. Incoming calls are still accepted. The default is 0 minutes. |
To define a static host name-to-address mapping, use the x25 host global configuration command. Use the no form of the command to remove the host name.
x25 host name x121-address [cud call-user-data]| 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. |
To set the highest two-way virtual circuit number, use the x25 htc interface configuration command.
x25 htc circuit-number| circuit-number | Virtual circuit number from 1 to 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. |
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| minutes | Idle period in minutes. The default is 0, which causes the router to keep the SVC open indefinitely. |
To enable the Cisco IOS software to use the IP precedence value when it opens a new virtual circuit, use the x25 ip-precedence interface configuration command. To cause the Cisco IOS software to ignore the precedence value when opening virtual circuits, use the no form of this command.
x25 ip-precedenceTo set the interface default maximum input packet size to match that of the network, use the x25 ips interface configuration command.
x25 ips bytes| bytes | Byte count. It can be one of the following values: 16, 32, 64, 128, 256, 512, 1024, 2048, or 4096. The default is 128 bytes. |
To set the lowest incoming-only virtual circuit number, use the x25 lic interface configuration command.
x25 lic circuit-number| circuit-number | Virtual circuit number from 1 to 4095, or 0 if there is no incoming-only virtual circuit range. |
To force X.25 Level 3 (packet level) to restart when Level 2 (LAPB, the link level) resets, use the x25 linkrestart interface configuration command. To disable this function, use the no form of this command.
x25 linkrestartTo set the lowest outgoing-only virtual circuit number, use the x25 loc interface configuration command.
x25 loc circuit-number| circuit-number | Virtual circuit number from 1 to 4095, or 0 if there is no outgoing-only virtual circuit range. The default is 0. |
To set the lowest two-way virtual circuit number, use the x25 ltc interface configuration command.
x25 ltc circuit-number| circuit-number | Virtual circuit number from 1 to 4095, or 0 if there is no two-way virtual circuit range. The default is 1. |
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]| protocol | Protocol type, entered by keyword. 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. |
To configure an Internet-to-X.121 address mapping for bridging over X.25, use the x25 map bridge interface configuration command.
x25 map bridge x121-address broadcast [option]| x121-address | The X.121 address. |
| broadcast | Required keyword for bridging over X.25. |
| option | (Optional) Services that can be added to this map; the same options as the x25 map command. |
The enhanced x25 route command replaces the x25 map cmns command. Refer to 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]]]| ip-address | IP address. |
| protocol | (Optional) Protocol type, entered by keyword. Supported protocols are entered by keyword. 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. |
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]| 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. |
To set the window modulus, use the x25 modulo interface configuration command.
x25 modulo modulus| 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. The default is 8. |
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| 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. The default is 1. 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| bytes | Byte count that is one of the following: 16, 32, 64, 128, 256, 512, 1024, 2048, or 4096. The default is 128 bytes. |
Use the x25 pad-access interface configuration command to cause the packet assembler/disassembler (PAD) software to accept PAD connections only from statically mapped X.25 hosts. To disable checking maps on PAD connections, use the no form of this command.
x25 pad-accessTo 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| 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. 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. |
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]| 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. |
To configure a switched PVC to SVC circuit for a given interface, use the switched version of the x25 pvc interface configuration command.
x25 pvc number1 svc x121-address [flow-control-options] [call-control-options]| number1 | Logical channel ID of the PVC. Value must be lower than any range of circuit numbers defined for SVCs. |
| svc | Specifies a switched virtual circuit type. |
| x121-address | Destination X.121 address for opening an outbound switched virtual circuit and source X.121 address for matching an inbound switched virtual circuit. |
| flow-control-options | (Optional) Adds certain features to the mapping specified. |
| call-control-options | (Optional) Adds certain features to the mapping specified. |
To connect two permanent virtual circuits (PVCs) across a TCP/IP LAN, use the XOT service form of the x25 pvc interface configuration command.
x25 pvc number1 xot address interface serial string pvc number2 [option]| 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. |
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| 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 create an entry in the X.25 routing table (to be consulted for forwarding incoming calls and for placing outgoing PAD or protocol translation calls), use an 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] [modification]} disposition [xot-keepalive]| #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 position value is given, the entry is appended to the end of the routing table. |
| selection | (Optional) The selection options identify when the subsequent modification and disposition elements apply to an X.25 call; any or all variables may be specified for a route.
Although each individual selection criterion is optional, at least one selection or modification element must be specified in the x25 route command. |
| modification | (Optional) Modifies 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.
Although each individual modification is optional, at least one selection or modification element must be specified in the x25 route command. |
| disposition | Specifies the disposition of a call matching the specified selection pattern. |
| xot-keepalive | (Optional) Specifies an 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 transmitted data goes unacknowledged for a given number of attempts over a period of time. |
To enable X.25 switching or tunneling, use the x25 routing global configuration command. To disable the forwarding of X.25 calls, used the no form of this command.
x25 routing [use-tcp-if-defs]| use-tcp-if-defs | (Optional) May be used to modify the acceptance of calls received over TCP. |
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| 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 omit the destination address in outgoing calls, use the x25 suppress-called-address interface configuration command. To reset this command to the default state, use the no form of this command.
x25 suppress-called-addressTo omit the source address in outgoing calls, use the x25 suppress-calling-address interface configuration command. To reset this command to the default state, use the no form of this command.
x25 suppress-calling-addressUse the x25 t10 interface configuration command to set the value of the Restart Indication retransmission timer (T10) on DCE devices.
x25 t10 seconds| seconds | Time in seconds. The default is 60 seconds. |
To set the value of the Incoming Call timer (T11) on DCE devices, use the x25 t11 interface configuration command.
x25 t11 seconds| seconds | Time in seconds. The default is 180 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| seconds | Time in seconds. The default is 60 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| seconds | Time in seconds. The default is 60 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| seconds | Time in seconds. The default is 180 seconds. |
To set the value of the Call Request timer (T21) on DTE devices, use the x25 t21 interface configuration command.
x25 t21 seconds| seconds | Time in seconds. The default is 200 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| seconds | Time in seconds. The default is 180 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| seconds | Time in seconds. The default is 180 seconds. |
To set the data packet acknowledgment threshold, use the x25 threshold interface configuration command.
x25 threshold delay-count| delay-count | Value between zero and the input window size. A value of 1 sends one Receiver Ready acknowledgment per packet. The default is 0, which disables the acknowledgment threshold. |
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-addressTo change the default incoming window size to match that of the network, use the x25 win interface configuration command.
x25 win packets| 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| 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| 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 PAD profile script for use by the translate command, use the x29 profile global configuration command.
x29 profile {default | name} parameter:value [parameter:value]| 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. |
|
|