Table Of Contents

access-list (standard)

access-list (type-code)

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 profile

cablelength

cablelength long

cablelength short

carrier-delay

channel-group (Fast EtherChannel)

clear aim

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 t1

controller t3

copy flash lex

copy tftp lex

crc

crc4

crc bits 5

cut-through

access-list (standard)

To establish MAC address access lists, use the access-list global configuration command. To remove a single access list entry, use the no form of this command.

access-list access-list-number {permit | deny} address mask

no access-list access-list-number

Syntax Description

access-list-number	Integer from 700 to 799 that you select for the list.
permit	Permits the frame.
deny	Denies the frame.
address mask	48-bit MAC addresses written in dotted triplet form. The ones bits in the mask argument are the bits to be ignored in the address value.

Defaults

No MAC address access lists are established.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Related Commands

Command	Description
access-list (type-code-ibm)	Builds type-code access lists.

access-list (type-code)

To build type-code access lists, use the access-list global configuration command. To remove a single access list entry, use the no form of this command.

access-list access-list-number {permit | deny} type-code wild-mask

no access-list access-list-number

Syntax Description

access-list-number	User-selectable number between 200 and 299 that identifies the list.
permit	Permits the frame.
deny	Denies the frame.
type-code	16-bit hexadecimal number written with a leading "0x"; for example, 0x6000. You can specify either an Ethernet type code for Ethernet-encapsulated packets, or a DSAP/SSAP pair for 802.3 or 802.5-encapsulated packets.
wild-mask	16-bit hexadecimal number with ones bits that correspond to bits in the type-code argument that should be ignored when making a comparison. (A mask for a DSAP/SSAP pair should always be at least 0x0101 because these two bits are used for purposes other than identifying the SAP codes.)

Defaults

No type-code access lists are built.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Type-code access lists can have an impact on system performance; therefore, keep the lists as short as possible and use wildcard bit masks whenever possible.

Access lists are evaluated according to the following algorithm:

•If the packet is Ethernet Type II or SNAP, the type-code field is used.

•Other packet type, then the LSAP is used.

If the length/type field is greater than 1500, the packet is treated as an LSAP packet unless the DSAP and SSAP fields are AAAA. If the latter is true, the packet is treated using type-code filtering.

If you have both Ethernet Type II and LSAP packets on your network, you should set up access lists for both.

Use the last item of an access list to specify a default action; for example, permit everything else or deny everything else. If nothing else in the access list matches, the default action is normally to deny access; that is, filter out all other type codes.

Related Commands

Command	Description
access-list (XNS extended)	Defines an extended XNS access list.
access-list (XNS standard)	Defines a standard XNS access list.

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 interface configuration command. 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. Up to 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 communication 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 interface configuration command. 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 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 interface configuration command. 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. The default group-number is 0.

Defaults

No groups exist.

---

Note 0 is a valid group number; aps group 0 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 7.7.7.6 255.255.255.0

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

Router(config-if)# aps group 10

Router(config-if)# aps working 1

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

Router(config-if)# aps group 20

Router(config-if)# aps protect 1 7.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)# interface pos 4/0/0

Router(config-if)# aps group 10

Router(config-if)# aps protect 1 7.7.7.6

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

Router(config-if)# aps group 20

Router(config-if)# aps working 1

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 interface configuration command. 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

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

Router# configure terminal

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

Router(config-if)# aps protect 1 7.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 interface configuration command. 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 interface configuration command. 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 due to 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 7.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 7.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 asp revert interface configuration command. 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 asp 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 7.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 interface configuration command. 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 interface configuration command. 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 (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 POS interface as a working interface, use the aps working interface configuration command. To remove the protect 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 interface configuration command.

---

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 the 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 PLIM, use the atm sonet interface configuration command. 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 where SDH framing is required.

Use the default (STS-12c) in applications where 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 hub configuration command. 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 interface configuration command. 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 EXEC command show interface.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

---

Note The bandwidth command sets an informational parameter only to communicate 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.

IGRP uses the minimum path bandwidth to determine a routing metric. The TCP protocol adjusts initial retransmission parameters based on 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
vines metric	Enables VINES routing on an interface.

bert abort

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

bert abort

Syntax Description

There are no arguments or keywords used with this command.

Defaults

No default behavior or values.

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 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.

There is not a no form of this command.

Examples

The following example shows sample display 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 ....

The following example shows sample display output for 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]

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 profile	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 privileged EXEC command.

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 used when no other number is entered 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 implemented in Cisco IOS Release 12.0 T.

Usage Guidelines

Use the bert controller command to start a bit-error rate test for a particular port on a 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 pseudo-random or repetitive test pattern with an identical locally generated test pattern.

There is not a no form of this command.

Examples

The following example shows sample display output for the bert controller command:

Router# bert controller T1 0 profile 0

Press <Return> to start the BERT [confirm]

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 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 AMI-coded signals, a line code violation is a bi-polar 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 ESF framing is used, a path code violation is a CRC-6 error. Indicates a frame-synchronization bit-error in the D4 and E1-nonCRC 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	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 alarm indication signal 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-nonCRC signals, a second with 2048 line code violations or more. 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 profile	Sets up various bit-error rate testing profiles.

bert profile

To set up various bit-error rate testing profiles, use the bert profile privileged EXEC command. To disable the particular 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 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 controller configuration command. 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.

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

---

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)# controller t3 9/0/0

Router(config-controller)#  cablelength 300

cablelength long

To increase the pulse of a signal at the receiver and decrease the pulse from the transmitter using pulse equalization and line build-out for a T1 cable, use the cablelength long controller configuration or interface configuration command. To return the pulse equalization and line build-out values to their default settings, use the no form of this command.

cablelength long dbgain-value dbloss-value

no cablelength long

Syntax Description

dbgain-value	Number of decibels (dB) by which the receiver signal is increased. Use one of the following values: •gain26 •gain36 The default is 26 dB.
dbloss-value	Number of decibels by which the transmit signal is decreased. Use one of the following values: •0db •-7.5db •-15db •-22.5db The default is 0 dB.

Defaults

Receiver gain of 26 dB and transmitter loss of 0 dB.

Command Modes

Controller configuration for the Cisco AS5200 access server, Cisco AS5800 universal access server, and Cisco MC3810 multiservice access concentrator.

Interface configuration for the Cisco 2600 and Cisco 3600 series routers.

Command History

Release	Modification
11.2	This command was introduced.
11.3	The following choices were added: gain26, gain36, 0db, -7.5db, -15db, -22.5db.
12.0(5)T and 12.0(5)XK	This command was modified to include support as an ATM interface configuration command for the Cisco 2600 and 3600 series routers and a controller configuration command for the Cisco AS5800 universal access server.

Usage Guidelines

Cisco AS5200 Access Server, Cisco AS5800 Universal Access Server, and Cisco MC3810 Multiservice Access Concentrator

Use this command for configuring the controller T1 interface on the Cisco AS5200 access server, on the Cisco AS5800 universal access server, or on the Cisco MC3810 multiservice access concentrator. The cablelength long command is used to configure DS1 links (meaning, to build CSU/DSU links) when the cable length is no longer than 655 feet.