-
Cisco IOS Release 12.0 Wide-Area Networking Command Reference
-
About the Cisco IOS Software Documentation
-
ATM Commands (abr through atm sonet stm-1)
-
ATM Commands (atm txbuff through network-clock-select)
-
ATM Commands (oam-pvc through show atm traffic)
-
ATM Commands (show atm vc through vc-class atm)
-
Frame Relay Commands
-
SMDS Commands
-
X.25 and LAPB Commands
-
X.25 Facility Handling
-
Table Of Contents
atm txbuff
To set the maximum number of transmit buffers for simultaneous packet fragmentation, use the atm txbuff interface configuration command. The no form of this command restores the default value.
atm txbuff number
no atm txbuff
Syntax Description
number
Maximum number of packet fragmentations that the AIP can perform simultaneously, between 0 and 512.
Defaults
256
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported on the AIP for Cisco 7500 series routers. This command is not supported on the ATM port adapter for Cisco 7200 and 7500 series routers, nor is it supported on Cisco 4500 and Cisco 4700 routers.
Examples
The following example configures the AIP to perform up to 300 packet fragmentations simultaneously:
atm txbuff 300atm uni-version
To specify the User-Network Interface (UNI) version (3.0 or 3.1) the router should use when ILMI link autodetermination is unsuccessful or ILMI is disabled, use the atm uni-version interface configuration command. To restore the default value to 3.0, use the no form of this command.
atm uni-version version-number
no atm uni-version version-number
Syntax Description
Defaults
Version 3.0
Command Modes
Interface configuration
Command History
Usage Guidelines
Normally, when the ILMI link autodetermination is enabled on the interface and is successful, the router accepts the UNI version returned by ILMI. If the ILMI link autodetermination is unsuccessful or ILMI is disabled, the UNI version defaults to 3.0. You can override the default UNI version by using this command to enable UNI 3.1 signaling support. The no form of the command sets the UNI version to one returned by ILMI if ILMI is enabled and the link autodetermination process is successful. Otherwise, the UNI version reverts to 3.0.
Examples
The following example specifies UNI version 3.1 signaling port on the ATM interface 2/0:
interface atm 2/0atm uni-version 3.1atm vc-per-vp
To set the maximum number of VCIs to support per VPI, use the atm vc-per-vp interface configuration command. The no form of this command restores the default value.
atm vc-per-vp number
no atm vc-per-vp
Syntax Description
Defaults
1024
Command Modes
Interface configuration
Command History
Usage Guidelines
This command controls the memory allocation in the AIP, ATM port adapter, or NPM to deal with the VCI table.
An invalid VCI causes a warning message to be displayed.
Examples
The following example sets the maximum number of VCIs per VPI to 512:
atm vc-per-vp 512Related Commands
atm vp-filter
To set the AIP filter register, use the atm vp-filter interface configuration command. The no form of this command restores the default value.
atm vp-filter hexvalue
no atm vp-filter
Syntax Description
Defaults
0x7B
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported on Cisco 7500 series routers, but not on Cisco 4500 and Cisco 4700 routers. This command is not supported on ATM port adapters.
This command allows you to specify a VPI or range of VPIs to be used for AAL3/4 processing. All other VPIs map to AAL5 processing. If only AAL5 processing is required, you can either let the virtual path filter default or set it to an arbitrary VPI so that AAL5 processing is performed on all VPIs.
This command configures the hexadecimal value used in the virtual path filter register in the reassembly operation. The virtual path filter comprises 16 bits. The virtual path filter register uses the most significant bits (bits 15 through 8, the left half of the filter) as mask bits, and uses bits 7 through 0 (the right half of the filter) as compare bits.
When a cell is received, the right half of the filter is exclusively NORed with the binary value of the incoming VPI. The result is then ORed with the left half of the filter (the mask). If the result is all 1s, then reassembly is done using the VCI/MID table (AAL3/4 processing). Otherwise, reassembly is done using the VPI-VCI pair table (AAL5 processing).
Examples
In the following example, all incoming cells are reassembled using AAL3/4 processing:
atm vp-filter ff00In the following example, all incoming cells with the virtual path equal to 0 are reassembled using AAL3/4 processing; all other cells are reassembled using AAL5 processing:
atm vp-filter 0In the following example, all incoming cells with the most significant bit of the virtual path set are reassembled using AAL3/4 processing; all other cells are reassembled using AAL5 processing:
atm vp-filter 7f80broadcast
To configure broadcast packet duplication and transmission for an ATM PVC, SVC, or VC class, use the broadcast command in the appropriate command mode. Use the no form of this command to disable transmission of broadcast packets for your ATM PVC, SVC, or VC class. Use the default form of this command to restore the default behavior according to the description in the "Usage Guidelines" section below.
broadcast
no broadcast
default broadcast
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled. For classical IP SVCs, broadcast is enabled.
Command Modes
Interface-ATM-VC configuration (for ATM PVCs and SVCs). VC-class configuration (for a VC class)
Command History
Usage Guidelines
If broadcasting and multipoint signaling is enabled on an SVC, a multipoint SVC will be created to handle the SVC.
Note
If you use the protocol command to configure broadcasting for an ATM PVC, SVC, or VC class, this configuration takes precedence over any previous configuration using the broadcast command.
If the broadcast command is not explicitly configured on an ATM PVC or SVC, the VC inherits the following default configuration (listed in order of next highest precedence):
•
•
•
•
Examples
The following command enables the transmission of broadcast packets on an ATM PVC named router5:
pvc router 5 1/32broadcastRelated Commands
ces aal1 clock
To configure the AAL1 timing recovery clock for the CBR interface, use the ces aal1 clock interface configuration command. To return the clock to the default, use the no form of this command.
ces aal1 clock {adaptive | srts | synchronous}
no ces aal1 clock
Syntax Description
Defaults
synchronous
Command Modes
Interface configuration
Command History
Usage Guidelines
The clock mode must be synchronous for structured mode. In unstructured mode, use adaptive when a network-derived clock is not available.
Use srts when a network-derived clock is available but devices attached to the CES port use a different clock reference. The srts keyword samples the incoming clock, subtracts from the network clock, and sends the remainder in an AAL1 header. The clock is reconstructed during output by adding the residual to the network reference.
Use synchronous for all other modes.
Examples
The following command sets the AAL1 timing recovery clock to adaptive mode:
interface cbr 4/0ces aal1 clock adaptiveRelated Commands
ces aal1 service
To configure the type of circuit emulation service used on the CBR interface, use the ces aal1 service interface configuration command. To return the type of service to unstructured, use the no form of the command.
ces aal1 service {structured | unstructured}
no ces aal1 service
Syntax Description
structured
Sets the type of service to structured (cross-connect).
unstructured
Sets the type of service to unstructured (clear-channel).
Defaults
unstructured
Command Modes
Interface configuration
Command History
Usage Guidelines
The structured keyword means that each time slot is an independent entity grouped into circuits, where each circuit has an independent PVC.
The unstructured keyword reduces the incoming serial data on the receiving end of the ATM network. The keyword also sets the service to single circuit, single PVC, where all time slots are carried.
Examples
The following example changes the mode for the ces aal1 service command to structured.
interface cbr 4/0ces aal1 service structuredRelated Commands
ces circuit
To configure the connection attributes for the CBR interface, use the ces circuit interface configuration command. To return the connection attributes to the default or to enable the circuit, use the no form of this command.
ces circuit circuit-number [cas] [cdv range] [circuit-name name] [on-hook-detection hex-number] [partial-fill range] [shutdown] [timeslots range]
no ces circuit circuit-number [cas] [cdv range] [circuit-name name] [on-hook-detection hex-number] [partial-fill range] [shutdown] [timeslots range]
Syntax Description
Defaults
No circuit is configured.
Command Modes
Interface configuration
Command History
Usage Guidelines
For unstructured service, the circuit number is 0. For T1 structured service, the circuit number is 1 through 24. For E1 structured service, the time slots are 1 through 31.
Channel-associated signaling (CAS) provides information about the time slot (on or off the hook) and is updated once per multiframe.
With both the CAS and on-hook detection features enabled, these features work together to enable an ingress node in an ATM network to monitor on-hook and off-hook conditions for a specified 1 x 64 structured CES circuit. As implied by the notation "1 x 64," the on-hook detection (or bandwidth-release) feature is supported only in a structured CES circuit that involves a single time slot at each end of the connection.
The time slot configured for the structured CES circuit at the ingress node (time slot 2) can be different from the DS0 time slot configured at the egress node (time slot 4). Only one such time slot can be configured at each end of the circuit when the on-hook detection feature is used.
When you invoke the on-hook feature, the ingress ATM-CES port adapter monitors the ABCD bits in the incoming CBR bit stream to detect on-hook and off-hook conditions in the circuit. In an "off-hook" condition, all the bandwidth provisioned for the specified CES circuit is used for transporting ATM AAL1 cells across the network from the ingress node to the egress node.
In an on-hook condition, the network periodically sends dummy ATM cells from the ingress node to the egress node to maintain the connection. However, these dummy cells consume only a fraction of the circuit's reserved bandwidth, leaving the rest of the bandwidth available for use by other network traffic. This bandwidth-release feature enables the network to make more efficient use of its resources.
When the CAS feature is enabled for a CES circuit, the bandwidth of the DS0 channel is limited to 56 kbps for user data, because CAS functions consume 8 kbps of channel bandwidth for transporting the ABCD signaling bits. These signaling bits are passed transparently from the ingress node to the egress node as part of the ATM AAL1 cell stream.
In summary, when the optional CAS and on-hook detection features are enabled, the following conditions apply:
•
•
•
•
Examples
The following example sets the structured service CDV range to 5000 milliseconds and enables the interface.
interface cbr 4/0ces circuit 3 cdv 5000ces circuit 3 no shutdownRelated Commands
ces dsx1 clock source
To configure a transmit clock source for the CBR interface, use the ces dsx1 clock source interface configuration command. To return the clock source to the default, use the no form of this command.
ces dsx1 clock source {loop-timed | network-derived}
no ces dsx1 clock source
Syntax Description
loop-timed
Configures the transmit clock to loop (RX-clock to TX-clock).
network-derived
Configures the transmit clock to be derived from the network.
Defaults
network-derived
Command Modes
Interface configuration
Command History
Examples
The following example sets the clock source to loop-timed.
interface cbr 4/0ces dsx1 clock source loop-timedRelated Commands
ces dsx1 framing
To select the frame type for the data line on the CBR interface, use the ces dsx1 framing interface configuration command. To return the frame type to the default, use the no form of this command.
T1
ces dsx1 framing {esf | sf}
no ces dsx1 framing
E1
ces dsx1 framing {e1_crc_mfCASlt | e1_crc_mf_lt | e1_lt | e1_mfCAS_lt}
no ces dsx1 framing
Syntax Description
Defaults
esf (for T1) or e1_lt (for E1)
Command Modes
Interface configuration
Command History
Usage Guidelines
Use this command in configurations where the router communicates with the data line. The service provider determines which framing type is required for your circuit.
Examples
The following example sets the data line type to super frame.
interface cbr 4/0ces dsx1 framing sfRelated Commands
ces dsx1 lbo
To configure cable length for the CBR interface, use the ces dsx1 lbo interface configuration command. To return the cable length to the default, use the no form of this command.
ces dsx1 lbo length
no ces dsx1 lbo
Syntax Description
length
Sets the cable length. Values are (in feet): 0_110, 110_200, 220_330, 330_440, 440_550, 550_660, 660_above, and square_pulse.
Defaults
0_110 feet
Command Modes
Interface configuration
Command History
Usage Guidelines
Set the cable length to the desired number of feet on your system.
Examples
The following example sets the cable length to 440 feet:
interface cbr 4/0ces dsx1 lbo 440_550Related Commands
ces dsx1 linecode
To select the linecode type for the CBR interface, use the ces dsx1 linecode interface configuration command. To return the linecode to the default, use the no form of this command.
T1
ces dsx1 linecode {ami | b8zs}
no ces dsx1 linecode
E1
ces dsx1 linecode {ami | hdb3}
no ces dsx1 linecode
Syntax Description
Defaults
b8zs (for T1) or hdb3 (for E1)
Command Modes
Interface configuration
Command History
Usage Guidelines
Use this command in configurations where the switch communicates with the data line. The service provider determines which linecode type is required for your circuit.
Examples
The following example specifies B8ZS as the linecode type:
interface cbr 4/0ces dsx1 linecode b8zsRelated Commands
ces dsx1 loopback
To enable a loopback for the CBR interface, use the ces dsx1 loopback interface configuration command. To disable the loopback, use the no form of this command.
ces dsx1 loopback {line | noloop | payload}
no ces dsx1 loopback {line | noloop | payload}
Syntax Description
Defaults
No loopback
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is useful when testing the circuit emulation port adapter module.
Examples
The following example sets a payload loopback:
interface cbr 4/0ces dsx1 loopback payloadRelated Commands
ces dsx1 signalmode robbedbit
To enable the signal mode as robbed bit on a CBR interface, use the ces dsx1 signalmode robbedbit interface configuration command. To return the signal mode to the default, use the no form of this command.
ces dsx1 signalmode robbedbit
no ces dsx1 signalmode robbedbit
Syntax Description
This command has no arguments or keywords.
Defaults
No signal mode is enabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
A T1 frame consists of 24 time slots (DS0) that send at a rate of 64 kbps. T1 defines the ability to send signaling in-band on individual time slots by removing the low bit of each byte for signaling in robbedbit mode. This procedure allows 8 kbps for signaling and leaves 56 kbps for data.
In structured mode, you can send the T1 signaling information across the network. This means that after you enable robbedbit signaling mode on the port, and enable CAS on individual circuits that need this type of service, you are robbing bits from the DS0. The system then puts the bits in the specified format to be sent across the network and reinserts them at the passive side on the CES-IWF connection.
Examples
The following example enables channel associated signaling and robbed bit signaling:
interface cbr 4/0ces circuit 1 casces dsx1 signalmode robbedbitRelated Commands
ces pvc
To configure the destination port for the circuit on the CBR interface, use the ces pvc interface configuration command. To remove the destination port on the circuit, use the no form of this command.
ces pvc circuit-number interface atm slot/port vpi number vci number
no ces pvc circuit-number interface atm slot/port vpi number vci number
Syntax Description
Defaults
No destination port is configured.
Command Modes
Interface configuration
Command History
Usage Guidelines
Use the interface option to create a hard PVC. Use the dest-atm-addr option to create a soft PVC. Soft PVCs are not supported on Cisco 7200 series routers.
You must configure both sides of the CES circuits because at the source (the active side in CES-IWF), the time slots are not recognized at the destination (the passive side).
Each CES circuit has an ATM address. When configuring the source PVC, you need the destination ATM address.
Examples
The following example shows setting a hard PVC. In this example, the destination of ATM port 0 in slot 1 is assigned to circuit 31 on CBR port 0 in slot 4.
interface cbr 4/0ces pvc 31 interface atm 1/0 vpi 0 vci 512Related Commands
class
To assign a VC class to an ATM main interface, subinterface, PVC, or SVC, use the class command in the appropriate command mode. Use the no form of this command to remove a VC class.
class vc-class-name
no class vc-class-name
Syntax Description
Defaults
No VC class is assigned.
Command Modes
Interface configuration (for ATM main and subinterfaces). Interface-ATM-VC configuration (for ATM PVCs and SVCs)
Command History
Usage Guidelines
Use this command to assign a previously defined set of parameters to an ATM main interface, subinterface, PVC, or SVC. This set of parameters is defined in a VC class.
Examples
The following example assigns a VC class named atm-ubr to a PVC named router5. This VC class may contain UBR settings that were configured using the ubr command.
pvc router5 1/32class atm-ubrThe following example assigns a VC class named atm-svc-parameters to an SVC named lion. This VC class may contain ATM SVC default parameters.
svc lion 47.0091.81.000000.0040.0B0A.2501.ABC1.3333.3333.05class atm-svc-parametersclear atm arp
To clear Address Resolution Protocol (ARP) entries for an ATM interface that is configured as an ARP server, use the clear atm arp command in EXEC mode.
clear atm arp atm-interface {ip-address | *}
Syntax Description
atm-interface
ATM interface number (for example, 3/0).
ip-address
Clears the ARP entry for the specified IP address.
*
Clears all ARP entries on the interface.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command to clear ARP entries for an ATM interface. Use the asterisk (*) to delete all of the ARP entries for the interface, or specify the IP address of a particular entry to be deleted.
If an ARP entry for an existing virtual circuit (VC) is deleted, the ARP server will immediately try to get another entry for that VC.
Examples
The following example shows how to delete the ARP entry for 172.20.173.28:
Router# clear atm arp 3/0 172.20.173.28dxi map
To map a protocol address to a given VPI and VCI, use the dxi map interface configuration command. Use the no form of this command to remove the mapping for that protocol and protocol address.
dxi map protocol protocol-address vpi vci [broadcast]
no dxi map protocol protocol-address
Syntax Description
Defaults
No map definition is established.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is used in configurations where the router is intended to communicate with an ATM network through an ATM data service unit (ADSU). Given the circuit identifier parameters (VPI and VCI) for the ATM permanent virtual circuit (PVC), the router computes and uses the DXI frame address (DFA) that is used for communication between the router and the ADSU.
The dxi map command can be used only on a serial interface or HSSI configured for ATM-DXI encapsulation.
Examples
The following example converts all IP packets intended for the host with IP address 172.21.170.49 into ATM cells identified with a VPI of 2 (binary 0000 0010) and a VCI of 46 (binary 0000 0000 0010 1110) by the ADSU:
interface serial 0dxi map ip 172.21.170.49 2 46 broadcastUsing the mapping defined in Annex A of the ATM DXI Specification, the router uses the VPI and VCI information in this example to compute a DFA of 558 (binary 1000101110). The ADSU will use the DFA of the incoming frame to extract the VPI and VCI information when formulating ATM cells.
Related Commands
Configures multiprotocol or single protocol ATM-DXI encapsulation.
Enables ATM-DXI encapsulation.
dxi pvc
To configure multiprotocol or single protocol ATM-DXI encapsulation, use the dxi pvc interface configuration command. The no form of this command disables multiprotocol ATM-DXI encapsulation.
dxi pvc vpi vci [snap | nlpid | mux]
no dxi pvc vpi vci [snap | nlpid | mux]
Syntax Description
Defaults
LLC/SNAP encapsulation.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command can be used only on a serial interface or HSSI that is configured with ATM-DXI encapsulation.
Select the nlpid option if software earlier than Cisco IOS Release 10.3 was loaded on this router, and the router was configured for the default encapsulation, which was nlpid before Release 10.3.
Examples
The following example configures ATM-DXI MUX encapsulation on serial interface 1. The PVC identified by a VPI of 10 and a VCI of 10 can carry a single protocol. Then the protocol to be carried on this PVC is defined by the dxi map command.
interface serial 1dxi pvc 10 10 muxdxi map ip 172.21.176.45 10 10 broadcastThe following example configures ATM-DXI NLPID encapsulation on serial interface 1. The PVC identified by a VPI of 11 and a VCI of 12 can carry multiprotocol traffic that is encapsulated with a header described in RFC 1294/1490.
interface serial 1dxi pvc 11 12 nlpidRelated Commands
Maps a protocol address to a given VPI and VCI.
Enables ATM-DXI encapsulation.
show dxi pvc
Displays the PVC statistics for a serial interface.
encapsulation aal5
To configure the ATM adaptation layer (AAL) and encapsulation type for an ATM PVC, SVC, or VC class, use the encapsulation aal5 command in the appropriate command mode. Use the no form of this command to remove an encapsulation from a PVC, SVC, or VC class.
encapsulation aal5 encap [virtual-template number]
no encapsulation aal5 encap [virtual-template number]
Note
Syntax Description
