Table Of Contents

Interface Commands

aps authenticate

aps force

aps group

aps lockout

aps manual

aps protect

aps revert

aps timers

aps unidirectional

aps working

atm sonet

auto-polarity

bandwidth (interface)

bert abort

bert controller

bert pattern

bert profile

cablelength

cablelength long

cablelength short

carrier-delay

channel-group (Fast EtherChannel)

clear aim

clear controller

clear controller lex

clear counters

clear hub

clear hub counters

clear interface

clear interface fastethernet

clear interface serial

clear service-module serial

clock rate

clock source

clock source (AS5200)

clock source (controller)

clock source (CT3IP)

clock source (interface)

clock source (MC3810)

cmt connect

cmt disconnect

compress

compress mppc

compress predictor

compress stac caim

controller

controller t3

copy flash lex

copy tftp lex

crc

crc4

crc bits 5

cut-through

Interface Commands

---

This book describes the basic commands that can be used on different types of interfaces. These commands correspond to the interface configuration tasks included in the Cisco IOS configuration guides. Refer to the configuration guide indicated here for configuration guidelines:

For information about this type of interface . . .	Refer to this publication . . .
General interface	"Interface Configuration Overview" chapter in the Cisco IOS Interface Configuration Guide
LAN interface	"Configuring LAN Interfaces" chapter in the Cisco IOS Interface Configuration Guide
Serial interface	"Configuring Serial Interfaces" chapter in the Cisco IOS Interface Configuration Guide
Logical interface	"Configuring Logical Interfaces" chapter in the Cisco IOS Interface Configuration Guide
Cisco Mainframe Channel Connection (CMCC) adapters	"Configuring Cisco Mainframe Channel Connection Adapters" chapter in the Cisco IOS Bridging and IBM Networking Configuration Guide
Dialer interface and virtual-access interface	Cisco IOS Dial Services Configuration Guide and Cisco IOS Dial Technologies Command Reference
ISDN PRI interface	Cisco IOS Dial Technologies Configuration Guide and Cisco IOS Dial Technologies Command Reference

Other interface commands, specific to a particular technology area, are described in the technology specific configuration guides. For example, for hardware technical descriptions, and for information about installing the router or access server interfaces, refer to the hardware installation and maintenance publication for your particular product.

aps authenticate

To enable authentication and specify the string that must be present to accept any packet on the out-of-band (OOB) communications channel on a packet-over-SONET (POS) interface, use the aps authenticate command ininterface configuration mode. To disable authentication, use the no form of this command.

aps authenticate string

no aps authenticate

Syntax Description

string

Text that must be present to accept the packet on a protected or working interface. A maximum of eight alphanumeric characters are accepted.

Defaults

Authentication is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

Use the aps authenticate command to ensure that only valid packets are accepted on the OOB communications channel.

The aps authenticate command must be configured on both the working and protect interfaces.

Examples

The following example enables authentication on POS interface 0 in slot 4:

Router# configure terminal

Router(config)# interface pos 4/0/0

Router(config-if)# aps working 1

Router(config-if)# aps authenticate sanjose

Router(config-if)# exit

Router(config)# exit

Router#

Related Commands

Command	Description
aps protect	Enables a POS interface as a protect interface.
aps working	Configures a POS interface as a working interface.

aps force

To manually switch the specified circuit to a protect interface, unless a request of equal or higher priority is in effect, use the aps force command in interface configuration mode. To cancel the switch, use the no form of this command.

aps force circuit-number

no aps force circuit-number

Syntax Description

circuit-number

Number of the circuit to switch to the protect interface.

Defaults

No circuit is switched.

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

Use the aps force command to manually switch the interface to a protect interface when you are not using the aps revert command. For example, if you need to change the fiber connection, you can manually force the working interface to switch to the protect interface.

In a one-plus-one (1+1) configuration only, you can use the aps force 0 command to force traffic from the protect interface back onto the working interface.

The aps force command has a higher priority than any of the signal failures or the aps manual command.

The aps force command is configured only on protect interfaces.

Examples

The following example forces the circuit on POS interface 0 in slot 3 (a protect interface) back onto a working interface:

Router# configure terminal

Router(config)# interface pos 3/0/0

Router(config-if)# aps protect 10/30/1/1

Router(config-if)# aps force 1

Router(config-if)# exit

Router(config)# exit

Router#

Related Commands

Command	Description
aps manual	Manually switches a circuit to a protect interface.
aps protect	Enables a POS interface as a protect interface.
aps working	Configures a POS interface as a working interface.

aps group

To allow more than one protect and working interface to be supported on a router, use the aps group command in interface configuration mode. To remove a group, use the no form of this command.

aps group group-number

no aps group group-number

Syntax Description

group-number

Number of the group.

Defaults

No groups exist.

---

Note 0 is a valid group number.
The default group-number is 0.
The aps group 0 command does not imply that no groups exist.

---

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

Use the aps group command to specify more than one working and protect interfaces on a router, for example, working channel for group 0 and protect channel for group 1 on one router, and working channel for group 1 and protect channel for group 0 on another router.

The aps group command must be configured on both the protect and working interfaces.

Examples

The following example configures two working/protect interface pairs. Working interface (3/0/0) is configured in group 10 (the protect interface for this working interface is configured on another router), and protect interface (2/0/1) is configured in group 20:

Router# configure terminal

Router(config)# interface ethernet 0/0

Router(config-if)# ip address 10.7.7.6 255.255.255.0

Router(config-if)# exit

Router(config)# interface pos 3/0/0

Router(config-if)# aps group 10

Router(config-if)# aps working 1

Router(config-if)# exit

Router(config)# interface pos 2/0/1

Router(config-if)# aps group 20

Router(config-if)# aps protect 1 10.7.7.7

Router(config-if)# end

On the second router, protect interface (4/0/0) is configured in group 10, and working interface (5/0/0) is configured in group 20 (the protect interface for this working interface is configured on another router):

Router(config)# interface ethernet 0/0

Router(config-if)# ip address 7.7.7.7 255.255.255.0

Router(config-if)# exit

Router(config)# interface pos 4/0/0

Router(config-if)# aps group 10

Router(config-if)# aps protect 1 7.7.7.6

Router(config-if)# exit

Router(config)# interface pos 5/0/0

Router(config-if)# aps group 20

Router(config-if)# aps working 1

Router(config-if)# exit

Router(config)# end

Router#

Related Commands

Command	Description
aps protect	Enables a POS interface as a protect interface.
aps working	Configures a POS interface as a working interface.

aps lockout

To prevent a working interface from switching to a protect interface, use the aps lockout command in interface configuration mode. To remove the lockout, use the no form of this command.

aps lockout circuit-number

no aps lockout circuit-number

Syntax Description

circuit-number

Number of the circuit to lock out.

Defaults

No lockout exists.

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

The aps lockout command is configured only on protect interfaces.

Examples

This example locks out POS interface 3/0/0 (that is, prevents the circuit from switching to a protect interface in the event that the working circuit becomes unavailable):

Router# configure terminal

Router(config)# interface pos 3/0/0

Router(config-if)# aps protect 1 10.7.7.7

Router(config-if)# aps lockout 1

Router(config-if)# end

Router#

Related Commands

Command	Description
aps protect	Enables a POS interface as a protect interface.
aps working	Configures a POS interface as a working interface.

aps manual

To manually switch a circuit to a protect interface, use the aps manual command in interface configuration mode. To cancel the switch, use the no form of this command.

aps manual circuit-number

no aps manual circuit-number

Syntax Description

circuit-number

Number of the circuit to switch to a protect interface.

Defaults

No circuit is switched.

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

Use the aps manual command to manually switch the interface to a protect interface. For example, you can use this feature when you need to perform maintenance on the working channel. If a protection switch is already up, you can also use the aps manual command to revert the communication link back to the working interface before the wait to restore (WTR) time has expired. The WTR time period is set by the aps revert command.

In a one-plus-one (1+1) configuration only, you can use the aps manual 0 command to force traffic from the protect interface back onto the working interface.

The aps manual command is a lower priority than any of the signal failures or the aps force command.

Examples

The following example forces the circuit on POS interface 0 in slot 3 (a working interface) back onto the protect interface:

Router# configure terminal

Router(config)# interface pos 3/0/0

Router(config-if)# aps working 1

Router(config-if)# aps manual 1

Router(config-if)# end

Router#

Related Commands

Command	Description
aps force	Manually switches the specified circuit to a protect interface, unless a request of equal or higher priority is in effect.
aps protect	Enables a POS interface as a protect interface.
aps revert	Enables automatic switchover from the protect interface to the working interface after the working interface becomes available.
aps working	Configures a POS interface as a working interface.

aps protect

To enable a POS interface as a protect interface, use the aps protect command in interface configuration mode. To remove the POS interface as a protect interface, use the no form of this command.

aps protect circuit-number ip-address

no aps protect circuit-number ip-address

Syntax Description

circuit-number	Number of the circuit to enable as a protect interface.
ip-address	IP address of the router that has the working POS interface.

Defaults

No circuit is protected.

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

Use the aps protect command to configure the POS interface used by a working interface if the working interface becomes unavailable because of a router failure, degradation or loss of channel signal, or manual intervention.

---

Caution Configure the working interface before configuring the protect interface to keep the protect interface from becoming the active circuit and disabling the working circuit when it is finally discovered.

---

Examples

The following example configures circuit 1 on POS interface 5/0/0 as a protect interface for the working interface on the router with the IP address of 10.7.7.7. For information on how to configure the working interface, refer to the aps working command.

Router# configure terminal

Router(config)# interface pos 5/0/0

Router(config-if)# aps protect 1 10.7.7.7

Router(config-if)# end

Router#

Related Commands

Command	Description
aps working	Configures a POS interface as a working interface.

aps revert

To enable automatic switchover from the protect interface to the working interface after the working interface becomes available, use the aps revert command in interface configuration mode. To disable automatic switchover, use the no form of this command.

aps revert minutes

no aps revert

Syntax Description

minutes

Number of minutes until the circuit is switched back to the working interface after the working interface is available.

Defaults

Automatic switchover is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

Use the aps revert command to return the circuit to the working interface when it becomes available.

The aps revert command is configured only on protect interfaces.

Examples

The following example enables circuit 1 on POS interface 5/0/0 to revert to the working interface after the working interface has been available for 3 minutes:

Router# configure terminal

Router(config)# interface pos 5/0/0

Router(config-if)# aps protect 1 10.7.7.7

Router(config-if)# aps revert 3

Router(config-if)# end

Router#

Related Commands

Command	Description
aps protect	Enables a POS interface as a protect interface.

aps timers

To change the time between hello packets and the time before the protect interface process declares a working interface router to be down, use the aps timers command in interface configuration mode. To return to the default timers, use the no form of this command.

aps timers seconds1 seconds2

no aps timers

Syntax Description

seconds1	Number of seconds to wait before sending a hello packet (hello timer).
seconds2	Number of seconds to wait to receive a response from a hello packet before the interface is declared down (hold timer).

Defaults

Hello time is 1 second, and hold time is 3 seconds.

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

Use the aps timers command to control the time between an automatic switchover from the protect interface to the working interface after the working interface becomes available.

Normally, the hold time is greater than or equal to three times the hello time.

The aps timers command is configured only on protect interfaces.

Examples

The following example specifies a hello time of 2 seconds and a hold time of 6 seconds on circuit 1 on POS interface 5/0/0:

Router# configure terminal

Router(config)# interface pos 5/0/0

Router(config-if)# aps working 1

Router(config-if)# aps timers 2 6

Router(config-if)# end

Router#

aps unidirectional

To configure a protect interface for unidirectional mode, use the aps unidirectional command in interface configuration mode. To return to the default, bidirectional mode, use the no form of this command.

aps unidirectional

no aps unidirectional

Syntax Description

This command has no arguments or keywords.

Defaults

Bidirectional mode

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

Use the aps unidirectional command when you must interoperate with SONET network equipment, Add Drop Multiplexor(s) (ADMs) that supports unidirectional mode.

---

Note We recommend bidirectional mode when it is supported by the interconnecting SONET equipment. When the protect interface is configured as unidirectional, the working and protect interfaces must cooperate to switch the transmit and receive SONET channel in a bidirectional fashion. This happens automatically when the SONET network equipment is in bidirectional mode.

---

The aps unidirectional command is configured only on protect interfaces.

Examples

The following example configures POS interface 3/0/0 for unidirectional mode:

Router# configure terminal

Router(config)# interface pos 3/0/0

Router(config-if)# aps unidirectional

Router(config-if)# aps protect 1 7.7.7.7

Router(config-if)# end

Router#

aps working

To configure a Packet over SONET (POS) interface as a working interface, use the aps working command in interface configuration mode. To remove the protect option from the POS interface, use the no form of this command.

aps working circuit-number

no aps working circuit-number

Syntax Description

circuit-number

Circuit number associated with this working interface.

Defaults

No circuit is configured as working.

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.

Usage Guidelines

When a working interface becomes unavailable because of a router failure, degradation or loss of channel signal, or manual intervention, the circuit is switched to the protect interface to maintain the connection.

To enable the circuit on the protect interface to switch back to the working interface after the working interface becomes available again, use the aps revert command in interface configuration mode.

---

Caution Configure the working interface before configuring the protect interface to keep the protect interface from becoming the active circuit and disabling the working circuit when it is finally discovered.

---

Examples

The following example configures POS interface 0 in slot 4 as a working interface. For information on how to configure the protect interface, refer to the aps protect command.

Router# configure terminal

Router(config)# interface pos 4/0/0

Router(config-if)# aps working 1

Router(config-if)# end

Router#

Related Commands

Command	Description
aps protect	Enables a POS interface as a protect interface.
aps revert	Enables automatic switchover from the protect interface to the working interface after the working interface becomes available.

atm sonet

To set the mode of operation and thus control the type of the ATM cell used for cell-rate decoupling on the SONET physical layer interface module (PLIM), use the atm sonet command in interface configuration mode. To restore the default Synchronous Transport Signal level 12, concatenated (STS-12c) operation, use the no form of this command.

atm sonet [stm-4]

no atm sonet [stm-4]

Syntax Description

stm-4

(Optional) Synchronous Digital Hierarchy/Synchronous Transport Signal level 4 (SDH/STM-4) operation (ITU-T specification).

Defaults

STS-12c

Command Modes

Interface configuration

Command History

Release	Modification
11.1 CC	This command was introduced.
11.2 GS	The stm-4 keyword was added.

Usage Guidelines

Use STM-4 in applications in which SDH framing is required.

Use the default (STS-12c) in applications in which the ATM switch requires "unassigned cells" for rate adaptation. An unassigned cell contains 32 zeros.

Examples

The following example sets the mode of operation to SONET STM-4 on ATM interface 3/0:

Router(config)# interface atm 3/0

Router(config-if)# atm sonet stm-4

Router(config-if)# end

Router# 

auto-polarity

To enable automatic receiver polarity reversal on a hub port connected to an Ethernet interface of a Cisco 2505 or Cisco 2507 router, use the auto-polarity command in hub configuration mode. To disable this feature, use the no form of this command.

auto-polarity

no auto-polarity

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Hub configuration

Command History

Release	Modification
10.3	This command was introduced.

Usage Guidelines

This command applies to a port on an Ethernet hub only.

Examples

The following example enables automatic receiver polarity reversal on hub 0, ports 1 through 3:

Router(config)# hub ethernet 0 1 3

Router(config-hub)# auto-polarity

Related Commands

Command	Description
hub	Enables and configures a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router.

bandwidth (interface)

To set and communicate the current bandwidth value for an interface to higher-level protocols, use the bandwidth command in interface configuration mode. To restore the default values, use the no form of this command.

bandwidth kilobits

no bandwidth

Syntax Description

kilobits

Intended bandwidth, in kilobits per second. For a full bandwidth DS3, enter the value 44736.

Defaults

Default bandwidth values are set during startup and can be displayed with the show interface EXEC command.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

---

Note The bandwidth command sets an informational parameter to communicateonly the current bandwidth to the higher-level protocols; you cannot adjust the actual bandwidth of an interface with this command.

---

For some media, such as Ethernet, the bandwidth is fixed; for other media, such as serial lines, you can change the actual bandwidth by adjusting hardware. For both classes of media, you can use the bandwidth configuration command to communicate the current bandwidth to the higher-level protocols.

Interior Gateway Routing Protocol (IGRP) uses the minimum path bandwidth to determine a routing metric. The TCP protocol adjusts initial retransmission parameters on the basis of the apparent bandwidth of the outgoing interface.

At higher bandwidths, the value you configure with the bandwidth command is not what is displayed by the show interface command. The value shown is that used in IGRP updates and also used in computing load.

---

Note This is a routing parameter only; it does not affect the physical interface.

---

Examples

The following example sets the full bandwidth for DS3 transmissions:

Router(config)# interface serial 0

Router(config-if)#  bandwidth 44736

Related Commands

Command	Description
show interface	Displays statistics for all interfaces configured on the router.

bert abort

To end a bit error rate testing session, use the bert abort command in privileged EXEC mode.

bert abort

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(2)XD	This command was introduced.
12.0(3)T	This command was integrtaed into Cisco IOS Release 12.0(3) T.

Usage Guidelines

Use the bert abort command to cancel bit error rate testing on each port of the Cisco AS5300 router.

The bit error rate test (BERT) feature enables you to test the quality of the connected PRI links by direct comparison of a pseudorandom or repetitive test pattern with an identical locally generated test pattern.

Examples

This sample display shows output for the bert abort command when no bit error rate test is running:

Router# bert abort

Router#

17:53:33: There is no BERT Test running ....

This sample display shows output from the bert abort command when a bit error rate test is running:

Router# bert abort

Do you really want to abort the current BERT [confirm] Y

17:56:56: %BERT-6-BERT_RESULTS: Controller T1 0 Profile default : The Test was

aborted by User

Related Commands

Command	Description
bert controller	Starts a bit error rate test for a particular port.
bert pattern	Sets up various bit error rate testing profiles.

bert controller

To start a bit error rate test for a particular port, use the bert controller command in privileged EXEC mode.

bert controller [type-controller] {[last-controller] | profile [number | default]}

Syntax Description

type-controller	(Optional) Use either T1 or E1 depending on the type of facility.
last-controller	(Optional) Last controller number. The valid range is 0 to 7.
profile	Sets the profile numbers for the bit error rate test. The default is 0.
number	(Optional) Numbers of the test profiles to use. The valid range is 0 to 15.
default	(Optional) Executes the default bit error rate test (0).

Defaults

The default profile number is 0.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(2)XD	This command was introduced.
12.0(3)T	This command was integrated into Cisco IOS Release 12.0(3)T.

Usage Guidelines

Use the bert controller command to start a bit error rate test for a particular port on a Cisco AS5300 router.

Quality Testing

The bit error rate test (BERT) feature enables you to test the quality of the connected PRI links by direct comparison of a pseudo-random or repetitive test pattern with an identical locally generated test pattern.

E1 Controllers

The E1 controller cannot be set in loopback mode from the AS5300. For the bert controller command to work correctly with the E1 controller, the controller must be configured as a channel-group or CAS and the line must be configured as a remote loop from the switch side of the link.

Examples

This sample display shows output from the bert controller command:

Router# bert controller T1 0 profile 0

Press <Return> to start the BERT [confirm] Y

17:55:34: %BERT-6-BERT_START: Starting BERT on Interface 0 with Profile default

Data in current interval (10 seconds elapsed):

     0 Line Code Violations, 0 Path Code Violations

     0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins

     0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs

Table 3 describes the significant fields shown in the sample display for the bert controller command.

Table 3 bert controller Field Descriptions 

Field	Description
Data in Current Interval	Shows the current accumulation period, which rolls into the 24 hour accumulation every 15 minutes. The accumulation period is from 1 to 900 seconds. The oldest 15 minute period falls off the back of the 24-hour accumulation buffer.
Line Code Violations	For alternate mark inversion (AMI)-coded signals, a line code violation is a bipolar violation (BPV) occurrence. Indicates the occurrence of either a BPV or excessive zeros (EXZ) error event.
Path Code Violations	When super frame (SF) (D4) framing is used, a path code violation is a framing error. When Extended Superframe (ESF) framing is used, a path code violation is a CRC-6 error. Indicates a frame-synchronization bit error in the D4 and E1-non-CRC formats, or a CRC error in the ESF and E1-CRC formats.
Slip Secs	Indicates the replication or deletion of the payload bits of a DS1 frame. A slip may be indicated when there is a difference between the timing of a synchronous receiving terminal and the received signal.
Fr Loss Secs	Seconds during which the framing pattern has been lost. Indicates the number of seconds an Out-of-Frame error is detected.
Line Err Secs	A line error second (LES) is a second in which one or more line code violation (LCV or CV-L) errors are detected.
Degraded Mins	Degraded minute is one in which the estimated error rate exceeds 1-6 but does not exceed 1-3.
Errored Secs	In ESF and E1-CRC links, an errored second is a second in which one of the following are detected: one or more path code violations; one or more Out-of-Frame defects; one or more controlled slip events; a detected alarm indication signal defect. For D4 and E1-noCRC links, the presence of bipolar violations also triggers an errored second.
Bursty Err Secs	Second with fewer than 320 and more than 1 path coding violation error, no severely errored frame defects, and no detected incoming alarm indication signals (AIS) defects. Controlled slips are not included in this parameter.
Severely Err Secs	For ESF signals, a second with one of the following errors: 320 or more path code violation errors; one or more Out-of-Frame defects; a detected AIS defect. For E1-CRC signals, a second with one of the following errors: 832 or more path code violation errors; one or more Out-of-Frame defects. For E1-non-CRC signals, a second with 2048 or more line code violations. For D4 signals, a count of 1-second intervals with framing errors, or an Out-of-Frame defect, or 1544 line code violations.
Unavail Secs	Count for every second in which an unavailable signal state occurs. This term is used by new standards in place of failed seconds (FS).

Related Commands

Command	Description
bert abort	Aborts a bit error rate testing session.
bert pattern	Sets up various bit error rate testing profiles.

bert pattern

To enable a bit error rate (BER) test pattern on a T1 or E1 line, use the bert pattern command in controller configuration mode. To disable a BER test pattern, use the no form of this command.

bert pattern {2^23 | 2^20 | 2^20-QRSS | 2^15 | 2^11 | 1s | 0s | alt-0-1} interval time

no bert pattern {2^23 | 2^20 | 2^20-QRSS | 2^15 | 2^11 | 1s | 0s | alt-0-1} interval time

Syntax Description

{ 2^23 | 2^20-QRSS | 2^15 | 2^11 | 1s | 0s | alt-0-1}

Specifies the length of the repeating BER test pattern. Values are: •2^23—Pseudorandom 0.151 test pattern that is 8,388,607 bits in length. •2^20—Pseudo-andom 0.153 test pattern that is 1,048,575 bits in length. •2^20-QRSS—Pseudorandom quasi-random signal sequence (QRSS) 0.151 test pattern that is 1,048,575 bits in length. •2^15—Pseudorandom 0.151 test pattern that is 32,768 bits in length. •2^11—Pseudorandom test pattern that is 2,048 bits in length. •1s—Repeating pattern of ones (...111...). •0s—Repeating pattern of zeros (...000...). •alt-0-1—Repeating pattern of alternating zeros and ones (...01010...).

interval time

Specifies the duration of the BER test. The interval can be a value from 1 to 1440 minutes.

Defaults

Disabled

Command Modes

Controller configuration

Command History

Release	Modification
11.1CC	The command was introduced.
12.0(5)XE	The command was enhanced as an ATM interface configuration command.
12.0(7)XE1	Support for Cisco 7100 series routers was added.
12.1(5)T	This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines

BER testing is supported on each of the T1 or E1 links and is done only over an unframed T1 or E1 signal, run on only one port at a time.

To view the BER test results, use the show controllers atm EXEC command. The BERT results include the following information:

•Type of test pattern selected

•Status of the test

•Interval selected

•Time remaining on the BER test

•Total bit errors

•Total bits received

When the T1 or E1 line has a BER test running, the line state is DOWN and the status field shows the current/last result of the test.

The bert pattern command is not written to NVRAM. This command is only used to test the T1 or E1 line for a short predefined interval and to avoid accidentally saving the command, which could cause the interface not to come up the next time the router reboots.

Examples

In the following example on a Cisco 7200 series router, a BER test pattern of all zeros is run for 30 minutes on T1 line 0 on the port adapter in slot 9:

interface atm 9/0

	 bert pattern 0s interval 30

Related Commands

Command	Description
show controllers atm slot/port	Displays information about T1/E1 links in Cisco 7100 series routers and Cisco 7200 series routers.
show controllers atm slot/port-adapter/port	Displays information about the T1/E1 links in Cisco 7500 series routers.

bert profile

To set up various bit error rate testing profiles, use the bert profile command in privileged EXEC mode. To disable the particular bit error rate test (BERT) profile indicated by profile number, use the no form of this command.

bert profile number pattern pattern threshold threshold error-injection err_inj duration time

no bert profile number pattern pattern threshold threshold error-injection err_inj duration time

Syntax Description

number	BERT profile number. The valid range is 1 to 15. This is the number assigned to a particular set of parameters. If no such profile of the same number exists in the system, a new profile is created with that number; otherwise, an existing set of parameters with that profile number is overwritten by the new profile.
pattern	Pattern that BERT will generate on the line.
pattern	0s—repetitive pattern, all zeroes 1_in_16—n repetitive pattern, 1 in 16 1s—n repetitive pattern, all ones 211-O.152—n pseudo-random pattern, 211 -1 O.152 215-O.15—n pseudo-random pattern, 215 -1 O.151 220-O.151QRSS—n pseudo-random pattern,      220 -1 O.151 QRSS (This is the default) 220-O.153—n pseudo-random pattern, 220 -1 O.153 3_in_24—n repetitive pattern, 3 in 24
threshold	Test failure (error) threshold that determines if the BERT on this line passed.
threshold	10^-2—bit error rate of 10-2 10^-3—bit error rate of 10-3 10^-4—bit error rate of 10-4 10^-5—bit error rate of 10-5 10^-6—bit error rate of 10-6 (This is the default) 10^-7—bit error rate of 10-7 10^-8—bit error rate of 10-8
error-injection	Error injection rate for bit errors injected into the BERT pattern generated by the chip. The default is none.
err_inj	10^-1—Error injection of 10-1 10^-2—Error injection of 10-2 10^-3—Error injection of 10-3 10^-4—Error injection of 10-4 10^-5—Error injection of 10-5 10^-6—Error injection of 10-6 10^-7—Error injection of 10-7 none—No error injection in the data pattern.
duration	Duration, in minutes, for which BERT is to be executed.
time	Duration of BERT, in minutes. The valid range is 1 to 1440. The default is 10.

Defaults

The default profile created internally by the system has parameters that cannot be changed. This profile has been defined so that you can execute BERT on a line without having to configure a new profile. The default profile is displayed when the running configuration is displayed and is not stored in non-volatile random access memory (NVRAM):

bert profile default pattern 220-0151QRSS threshold 10^-6 error-injection none duration 10

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(2)XD	This command was introduced.
12.0(3)T	This command was implemented in Cisco IOS Release 12.0 T.

Usage Guidelines

Use the bert profile command to set up bit error rate testing profiles for the Cisco AS5300 router.

The bit error rate test (BERT) feature enables you to test the quality of the connected PRI links by direct comparison of a pseudorandom or repetitive test pattern with an identical locally generated test pattern. A BERT profile is a set of parameters related to a BERT test and is stored as part of the configuration in the NVRAM. You can define up to 15 BERT profiles on the system. By setting up the BERT profiles in this way, you do not have to enter the parameters each time you want to run a BERT—just select the number of the BERT profile you want to run.

Examples

The following example shows a configured BERT profile number 1 to have a 0s test pattern, with a 10-2 threshold, no error injection, and a duration of 125 minutes:

Router(config)# bert ?

  profile  Profile Number for this BERT configuration

Router(config)# bert profile ?

  <1-15>  BERT Profile Number

Router(config)# bert profile 1 pattern 0s threshold 10^-2 error-injection none duration 
125

Related Commands

Command	Description
bert abort	Aborts a bit error rate testing session.
bert controller	Starts a bit error rate test for a particular port.

cablelength

To specify the distance of the cable from the routers to the network equipment, use the cablelength command in controller configuration mode. To restore the default cable length, use the no form of this command.

cablelength feet

no cablelength

Syntax Description

feet	Number of feet in the range of 0 to 450. The default values are: •224 feet for Channelized T3 Interface Processor (CT3IP) •49 feet for PA-T3 and PA-2T3 port adapters

Defaults

224 feet for CT3IP interface processor

49 feet for PA-T3 and PA-2T3 port adapters

Command Modes

Controller configuration

Command History

Release	Modification
11.1 CA	This command was introduced.

Usage Guidelines

The default cable length of 224 feet is used by the CT3IP interface processor.

The default cable length of 49 feet is used by the PA-T3 and PA-2T3port adapters.

---

Note Although you can specify a cable length from 0 to 450 feet, the hardware only recognizes two ranges: 0 to 49 and 50 to 450. For example, entering 35 feet uses the 0 to 49 range. If you later change the cable length to 40 feet, there is no change because 40 is within the 0 to 49 range. However, if you change the cable length to 50, the 50 to 450 range is used. The actual number you enter is stored in the configuration file.

---

Examples

The following example sets the cable length for the router to 300 feet:

Router(config)# control