ATM Switch Router Command Reference, 12.0(13)W5(19) through 12.0(22)W5(25)
C Commands

Table of Contents

C Commands
cablelength
called-address-mask
called-nsap-address
calling-address-mask
calling-nsap-address
cast-type
ces aal1 clock
ces aal1 service
ces circuit
ces dsx1 clock source
ces dsx1 framing
ces dsx1 lbo
ces dsx1 linecode
ces dsx1 loopback
ces dsx1 signalmode robbedbit
ces pvc (Hard PVC)
ces pvc (Soft PVC)
ces pvc passive follow-ifstate
channel-group
clear atm pnni
clear atm signalling statistics
clear atm-vc
clear-cause
clear counters
clear facility-alarm (Catalyst 8540 MSR)
clear host
clear interface
clear ip accounting
clear ip redirect
clear lane client
clear lane le-arp
clear lane server
clear rif-cache
clear sgcp statistics
client-atm-address name
clock source (controller)
clock source (interface) (Catalyst 8510 MSR and LightStream 1010)
clock source (Catalyst 8540 MSR)
collection-modes
connection-category
connection-types
controller
copy
copy flash
copy rcp
copy running-config
copy startup-config
copy tftp

C Commands


The commands shown in this chapter apply to the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. Where an entire command or certain attributes of a command have values specific to a particular switch or switch router, an exception is indicated by the following callouts:

  • Catalyst 8540 MSR
  • Catalyst 8510 MSR and LightStream 1010

  • Note   Commands that are identical to those documented in the Cisco IOS software documentation have been removed from this chapter.


    Note   Commands that no longer function as expected in ATM environments have also been removed from this chapter.

Refer to Appendix D of this command reference for a detailed list of commands that have been removed, changed or replaced.

cablelength

To configure the cable length for a channelized DS-3 (CDS3) Frame Relay port adapter, use the cablelength controller configuration command. To restore the default cable length, use the no form of this command.

cablelength value
no cablelength value

Syntax Description

value

Cable length of 0 to 450 feet.

Defaults

224 feet

Command Modes

Controller configuration

Command History

Release  Modification 

12.0(3c)W5(9)

New command

Usage Guidelines

Although you can specify a cable length from 0 to 450 feet, the hardware only recognizes two ranges: 0 to 224, and 225 to 450.

For example, if you enter 150 feet, the 0 to 224 range is used. If you later change the cable length to 200 feet, there is no change because 200 is within the 0 to 224 range. However, if you change the cable length to 250, the 225 to 450 range is used. The actual number you enter is stored in the configuration file.

Examples

The following example configures the cable length on controller t3 to 450 feet.

Switch(config)# controller t3 4/0/0
Switch(config-controller)# cablelength 450
Switch# show running-config
controller T3 4/0/0
 clock source reference
 cablelength 450

called-address-mask

To configure the address mask for identifying valid bits of the called NSAP address field, use the called-address-mask ATM signalling diagnostics configuration command. To return the address mask to the default, use the no form of this command.

called-address-mask atm-address-mask
no called-address-mask

Syntax Description

atm-address-mask

Denotes the valid bits in the called NSAP address.

Defaults

NULL

Command Modes

ATM signalling diagnostics configuration

Command History

Release  Modification 

11.2(8.0.1)

New command

Usage Guidelines

To match this selection criteria, a failed connect setup must have a called party address value equal to the configured called party address for all bits that are 1 in the value of the mask specified with the command. When the default value is retained, the rejected call matches the filter criteria for any called address in the rejected call.

Examples

The following example shows configuring a called address mask string.

Switch# configure terminal
Switch(config)# controller atm 0/0/0
Switch(config-if)# atm signalling diagnostics 1
Switch(cfg-atmsig-diag)# called-address-mask ff.ff.ff

called-nsap-address

To configure the NSAP-format ATM address for the signalling diagnostics filter entry, use
the called-nsap-address ATM signalling diagnostics configuration command. To remove any configured address, use the no form of this command.

called-nsap-address nsap-address
no called-nsap-address

Syntax Description

nsap-address

A 40-digit hexadecimal NSAP address.

Defaults

NULL

Command Modes

ATM signalling diagnostics configuration

Command History

Release  Modification 

11.2(8.0.1)

New command

Usage Guidelines

NSAP-format ATM end-system addresses have a fixed length of 40 hexadecimal digits. You should configure the address using the following dotted format:

xx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xx

Note   The dots can be omitted.

Examples

The following example shows setting a called NSAP address.

Switch# configure terminal
Switch(config)# controller atm 0/0/0
Switch(config-if)# atm signalling diagnostics 1
Switch(cfg-atmsig-diag)# called-nsap-address 47.111122223333444455556666.777788881111.00

calling-address-mask

To configure the address mask for identifying valid bits of the calling-nsap-address field in the signalling diagnostics filter table entry, use the calling-address-mask ATM signalling diagnostics configuration command. To set to the default value, use the no form of this command.

calling-address-mask atm-address-mask
no calling-nsap-address

Syntax Description

atm-address-mask

Use the address mask to denote the valid bits of the calling address field in the signalling diagnostics filter table entry.

Defaults

NULL

Command Modes

ATM signalling diagnostics configuration

Command History

Release  Modification 

11.2(8.0.1)

New command

Usage Guidelines

To match this selection criteria, a failed connect setup must have a calling party address value equal to the configured calling party address for all bits that are 1 in the value of the mask specified through the command. When the default value is retained, the rejected call matches the filter criteria for any calling address in the rejected call.

Examples

The following example shows a calling address mask.

Switch# configure terminal
Switch(config)# controller atm 0/0/0
Switch(config-if)# atm signalling diagnostics 1
Switch(cfg-atmsig-diag)# calling-address-mask ff.ff.ff

calling-nsap-address

To configure the NSAP-format ATM address for the signalling diagnostics filter entry, use the calling-nsap-address ATM signalling diagnostics configuration command. To remove any configured address, use the no form of this command.

calling-nsap-address nsap-address
no calling-nsap-address

Syntax Description

nsap-address

The 40-digit, hexadecimal NSAP address.

Defaults

NULL

Command Modes

ATM signalling diagnostics configuration

Command History

Release  Modification 

11.2(8.0.1)

New command

Usage Guidelines

NSAP-format ATM end-system addresses have a fixed length of 40 hexadecimal digits. You should configure the address using the following dotted format:

xx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xx

Note   The dots can be omitted.

Examples

The following example shows setting a calling NSAP address.

Switch# configure terminal
Switch(config)# controller atm 0/0/0
Switch(config-if)# atm signalling diagnostics 1
Switch(cfg-atmsig-diag)# calling-nsap-address 47.111122223333444455556666.777788881111.00

cast-type

To filter ATM signalling call failures by connection type (point-to-point or point-to-multipoint), use the cast-type ATM signalling diagnostics configuration command. To disable this feature, use the no form of this command.

cast-type {all | p2p | p2mp}
no cast-type

Syntax Description

all

Set the cast type to point-to-point and point-to-multipoint.

p2p

Point-to-point.

p2mp

Point-to-multipoint.

Defaults

all

Command Modes

ATM signalling diagnostics configuration

Command History

Release  Modification 

11.2(8.0.1)

New command

Examples

The following example shows call failures filtered by point-to-point connection.

Switch# configure terminal
Switch(config)# controller atm 0/0/0
Switch(config-if)# atm signalling diagnostics 1
Switch(cfg-atmsig-diag)# cast-type p2p

ces aal1 clock

To configure the AAL1 timing recovery clock for T1/E1 interfaces, use the ces aal1 clock interface configuration command. To revert to the default setting, use the no form of this command.

ces aal1 clock {adaptive | srts | synchronous}
no ces aal1 clock {adaptive | srts | synchronous}

Syntax Description

adaptive

Adjusts the output clock on a received AAL1 on a first-in, first-out basis. Use in unstructured mode.

srts

Adjusts the output clock on a received AAL1 on a first-in, first-out basis.

synchronous

Configures the timing recovery to synchronous for structured mode.

Defaults

synchronous

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

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 shows setting the AAL1 timing recovery clock to adaptive mode.

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces aal1 clock adaptive

ces aal1 service

To configure the type of ces service, use the ces aal1 service interface configuration command.
To revert to the default setting, use the no form of this command.

ces aal1 service {structured | unstructured}
no ces aal1 service {structured | unstructured}

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

Release  Modification 

11.2(5)

New command

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 shows changing the mode for the ces aal1 service command to structured.

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces aal1 service structured

ces circuit

To configure the CES connection attributes, use the ces circuit interface configuration command.
To revert to the default setting, use the no form of this command.

ces circuit circuit-id [cas] [cdv max-req] [circuit-name name] [partial-fill num] [shutdown |
imeslots num] [on-hook-detect pattern]
no ces circuit circuit-id [cas] [cdv] [circuit-name name] [partial-fill num] [shutdown]
[
timeslots num] [on-hook-detect pattern]

Syntax Description

circuit-id

Selects the circuit identification. For unstructured service, use 0. For T1 structure service, the range is 1 through 24. For E1 structure service,
the range is 1 through 31.

cas

Enables channel-associated signalling for structured service only.
The default is no cas.

cdv max-req

Enables the peak-to-peak cell delay variation requirement. The range for CDV is 1 thorough 65535 milliseconds. The default is 2000 milliseconds.

circuit-name name

Sets the ASCII name for the CES-IWF circuit. The string for the circuit name is 0 through 255. The default is CBRx/x/x:0.

partial-fill num

Enables the partial AAL1 cell fill service for structured service only.
The range is 0 through 47. The default is 47.

shutdown

Marks the CES-IWF circuit administratively down. The default is
no shutdown.

timeslots num

Configures the time slots for the CES-IWF circuit for structured service only. The range is 1 through 24 for T1. The range is 1 through 31 for E1.

on-hook-detect pattern

Configures on-hook detection on the CES circuit.

Defaults

See "Syntax Description."

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

Channel-associated signalling provides information about the time slot (on or off the hook) and is updated once per multiframe.

Examples

The following example shows setting the structured service CDV range to 5000 milliseconds.

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces circuit 3 cdv 5000

ces dsx1 clock source

To configure a transmit clock source to the T1/E1 CES port adapter, use the ces dsx1 clock source interface configuration command. To revert to the default value, use the no form of this command.

ces dsx1 clock source {loop-timed | network-derived}
no ces dsx1 clock source {loop-timed | network-derived}

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 mode

Command History

Release  Modification 

11.2(5)

New command

Examples

The following example shows setting the clock source to loop-timed.

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces dsx1 clock source loop-timed

Related Commands

Command  Description 

ces aal1 clock

Configures the AAL1 timing recovery clock for T1/E1 interfaces.

ces dsx1 framing

To select the frame type for the E1 or T1 data line, use the ces dsx1 framing interface configuration command. To restore the default setting, use the no form of this command.

(For E1) ces dsx1 framing {e1_crc_mfCASlt | e1_crc_mflt | e1_lt | e1_mfCAS_lt}
(For T1) ces dsx1 framing {sf | esf}

To restore the default setting, use the no form of these commands.

(For E1) no ces dsx1 framing {e1_crc_mfCASlt | e1_crc_mflt | e1_lt | e1_mfCAS_lt}
(For T1) no ces dsx1 framing {sf | esf}

Syntax Description

e1_crc_mfCAS_lt

Configures the frame type to e1_crc_mf: CAS enabled.

e1_crc_mf_lt

Configures the frame type to e1_crc_mf: CAS not enabled.

e1_lt

Configures the frame type to e1_lt.

e1_mfCAS_lt

Configures the frame type to e1_mf: CAS enabled.

sf

Configures the frame type to super frame.

esf

Configures the frame type to extended super frame.

Defaults

For E1: el_lt

For T1: esf

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

Use this command in configurations where the switch router communicates with either the T1 or the E1 data line to configure the frame type for your circuit.

Examples

The following example shows setting the E1 data line frame type to e1_mfCAS_lt.

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces dsx1 framing e1_mfCAS_lt

Related Commands

Command  Description 

linecode

Selects the linecode type for the T1 or E1 line.

ces dsx1 lbo

To configure T1 port parameters, use the ces dsx1 lbo interface configuration command. To revert to the default setting, use the no form of this command.

ces dsx1 lbo length
no ces dsx1 lbo length

Syntax Description

length

Specifies the cable length as one of the following:

  • 0-110
  • 110-200
  • 220-330
  • 330-440
  • 440-550
  • 550-660
  • 660_above
  • square_pulse

Defaults

0-110

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

Set the cable length to the desired number of feet on your system.

Examples

The following example shows setting the cable length to 440 feet using the ces dsx1 lbo interface configuration command.

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces dsx1 lbo 440_550

ces dsx1 linecode

To select the linecode type for the T1 or E1 line, use the ces dsx1 linecode interface configuration command. To restore the default setting, use the no form of this command.

(For E1) ces dsx1 linecode {ami | hdb3}
(For T1) ces dsx1 linecode {ami | b8zs}

To restore the default setting, use the no form of these commands.

(For E1) no ces dsx1 linecode {ami | hdb3}
(For T1) no ces dsx1 linecode {ami | b8zs}

Syntax Description

ami

Specifies the AMI as the linecode type. Valid for the T1 or E1 interfaces.

b8zs

Specifies B8Zs as the linecode type. Valid for the T1 interface only.

hdb3

Specifies the HDB3 as the linecode type. Valid for the E1 interface only.

Defaults

For T1: b8zs

For E1: hdb3

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

The T1 service provider determines which linecode type (ami or b8zs) is required for your circuit.
The E1 service provider determines which linecode type (ami or hdb3) is required for your circuit.

Examples

The following example specifies b8zs as the linecode type for the T1 interface.

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces dsx1 linecode b8zs

ces dsx1 loopback

To configure loopback for the T1 or E1 circuit emulation port adapter module, use the
ces dsx1 loopback interface configuration command. To revert to the default setting, use
the no form of this command.

ces dsx1 loopback {line | noloop | payload}
no ces dsx1 loopback {line | noloop | payload}

Syntax Description

line

Sets the received signal to be looped at the line (does not penetrate line).

noloop

Sets the interface to no loop.

payload

Sets the received signal to be looped through the device and returned.

Defaults

noloop

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

This command is useful when testing the circuit emulation port adapter module.

Examples

The following example shows setting the loopback to payload.

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces dsx1 loopback payload

ces dsx1 signalmode robbedbit

To configure the signalmode to robbedbit, use the ces dsx1 signalmode robbedbit interface configuration command. To restore the default setting, use the no form of this command.

ces dsx1 signalmode robbedbit
no ces dsx1 signalmode robbedbit

Syntax Description

This command has no keywords or arguments.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

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 signalling in-band on individual time slots by removing the low bit of each byte for signalling in robbedbit mode. This procedure allows 8 kbps for signalling and leaves 56 kbps for data.

In structured mode, you can send the T1 signalling information across the BISDN network. This means that after you set the port in robbedbit signalling mode, 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 BISDN network and reinserts them at the passive side on the CES-IWF connection.

Examples

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces dsx1 signalmode robbedbit

Related Commands

Command  Description 

ces aal1 service

Used to configure the type of CES service.

ces circuit

Used to configure the CES connection attributes.

ces pvc (Hard PVC)

To configure the destination port for the circuit, use the ces pvc (hard PVC) interface configuration command. To disable this feature, use the no form of this command.

ces pvc circuit-id interface atm card/subcard/port [vpi vpi-number] vci vci-number
no ces pvc circuit-id interface atm card/subcard/port [vpi vpi-number] vci vci-number

Syntax Description

circuit-id

Sets the type of service. For unstructured service, use 0. For T1 structured service, the range is 1 through 24. For E1 structured service, the range is 1 through 31.

card/subcard/port

Card number, subcard number, and port number of the ATM interface.

vpi-number

Virtual path identifier of the destination PVC.

vci-number

Virtual channel identifier of the destination PVC.

Defaults

None.

Command Modes

Interface configuration

Command History

Release  Modification 

12.1(6)

New command

Usage Guidelines

You must configure both sides of the CES circuits because the source (the active side in CES-IWF) 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. See the show ces address command.

Examples

The following example shows how to set a hard PVC on interface ATM 1/0/0.

Switch# configure terminal
Switch(config)# controller cbr 3/0/0
Switch(config-if)# ces pvc 31 interface atm 1/0/0

The following example shows how to set an unstructured CES soft PVC.

Switch(config-if)# ces pvc 0 dest-atm-addr atm 1/0/0 vpi 1 vci 1

The following example shows how to set a structured hard PVC.

Switch(config-if)# ces pvc 24 interface atm 1/0/1 vpi 1 vci 1

Related Commands

Command  Description 

ces pvc (Soft PVC)

Used to establish a soft pvc circuit

show ces address

Used to show all the configured CES-IWF ATM addresses.

ces pvc (Soft PVC)

To configure the destination port for the circuit, use the ces pvc (soft PVC) interface configuration command. To disable this feature, use the no form of this command.

ces pvc circuit-id dest-address atm-address [[vpi vpi-number] vci vci-number] [follow-ifstate] [retry-interval [first retry-interval] [maximum retry-interval]]
no ces pvc circuit-id dest-address atm-address [[vpi vpi-number] vci vci-number] [follow-ifstate] [retry-interval [first retry-interval] [maximum retry-interval]]

Syntax Description

circuit-id

Sets the type of service. For unstructured service, use 0. For T1 structured service, the range is 1 through 24. For E1 structured service, the range is 1 through 31.

dest-address

Creates a soft PVC and is specified as the string 0 through 255.

vpi vpi

Virtual path identifier of the destination PVC.

vci vci

Virtual channel identifier of the destination PVC.

retry-interval

Configures retry interval timers for a soft VC.

first retry-interval

Retry interval for the first retry after the first failed attempt, specified in milliseconds.

If the first retry after the first failed attempt also fails, the subsequent attempts will be made at intervals computed using the first retry-interval as follows:

(2 ** (k-1)) * first retry-interval

Where the value of k is 1 for the first retry after the first failed attempt and will be incremented by 1 for every subsequent attempt.

Range is from 100 to 3600000 milliseconds; the default is 5000 milliseconds.

maximum
retry-interval

The maximum retry interval between any two attempts specified in seconds.

Once the retry interval is computed in the first retry-interval and becomes equal to or greater than the maximum retry-interval configured, the subsequent retries are done at regular intervals of maximum retry-interval seconds until the call is established.

Range is from 1 to 65535 seconds; the default is 60.

follow-ifstate

When it is determined that the parent interface transitions from the down state to up, the soft PVC setup sequence is started. When it is determined that the parent interface transitions from the up state to down, an established soft PVC is released. Any soft PVC setup sequence in progress is terminated.

Defaults

None.

Command Modes

Interface configuration

Command History

Release  Modification 

12.1(6)

New command

Usage Guidelines

You must configure both sides of the CES circuits because the source (the active side in CES-IWF) 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. See the show ces address command.

Examples

The following example shows how to set a soft PVC with the follow-ifstate option enabled.

Switch# configure terminal
Switch(config)# interface cbr 3/1/0
Switch(config-if)#