Command Reference
S Commands for the ATM Switch
Download this chapter
S Commands for the ATM SwitchS Commands for the ATM Switch
give_us_feedback

Table of Contents

S Commands
 scheduler allocate
 scope
 scope map
 scope mode
 scrambling
 service-category
 shutdown (controller)
 shutdown (interface)
 slip
 snmp-server chassis-id
 snmp-server enable traps
 snmp trap link-status
 sonet
 sonet tx-ais on-rx-defect
 statistics
 status
 summary-address

S Commands

Note      Commands that are identical to those documented in the Cisco IOS software documentation have been removed from this chapter. Refer to Appendix D, "Removed and Changed Commands," of this command reference for a list of removed commands.

scheduler allocate

To guarantee CPU time for processes, use the scheduler allocate global configuration command. To restore the default guaranteed CPU time, use the no form of this command.

scheduler allocate interrupt-time process-time
no scheduler-allocate
Syntax Description

interrupt-time

Integer (in microseconds) that limits the maximum number of microseconds to spend on fast switching within any one network interrupt context. The range is 500 to 6000 microseconds. The default is 4000 microseconds.

process-time

Integer (in microseconds) that guarantees the minimum number of microseconds to spend at the process level when network interrupts are disabled. The range is 500 to 60000. The default is 200 microseconds.

Default

Approximately five percent of the CPU is available for process tasks.

Command Mode

Global configuration

Usage Guidelines

The normal operation of the network server allows the switching operations to use as much of the central processor as is required. If the network is running unusually heavy loads that do not allow the processor the time to handle the routing protocols, give priority to the system process scheduler. Use the scheduler allocate command to guarantee processor time.

Example

The following example makes 20 percent of the CPU available for process tasks.

Switch(config)# scheduler allocate 2000 500

scope

To filter ATM signalling call failures that occur within the switch and on other switches, use the scope ATM signalling diagnostics configuration command. To disable this feature, use the no form of this command.

scope {all | external | internal}
no scope
Syntax Description

all

Filter call failures that occur within the switch or on other external switches.

external

Filter call failures that occur on other external switches.

internal

Filter call failures that occur within the switch.

Default

all

Command Mode

ATM signalling diagnostics configuration

Example

In the following example, call failures are filtered by failures that occur within the switch.

Switch(cfg-atmsig-diag)# scope internal

scope map

To specify the mapping from a range of organizational scope values (used at UNI interfaces) to a PNNI scope value (such as in terms of PNNI routing level indicators), use the scope map PNNI node-level subcommand. To set to default a range of organizational scope values, use the no form of this command.

scope map low-org-scope [high-org-scope] level level-indicator
no scope map low-org-scope [high-org-scope]
Syntax Description

low-org-scope

Specifies the low end of the range of organizational scope values. The valid range of organizational scope values is from local (1) to global (15).

high-org-scope

Specifies the high end of the range of organizational scope values. The valid range of organizational scope values is from local (1) to global (15). If no value is specified, then the range includes only one entry (for example, high-org-scope equals low-org-scope).

level-indicator

Specifies the PNNI scope value to which the range of organizational scope values is mapped. The range is from 0 to 104.

Default

The default values specified in the ATM Forum PNNI 1.0 Specifications are shown in Table 18-1.

Table 18-1   Organizational Scope-to-Default Level Mappings

org-scope Range ATM Forum Default Level

1-3

96

4-5

80

6-7

72

8-10

64

11-12

48

13-14

32

15 global

0
Command Mode

PNNI node configuration

Usage Guidelines

The scope map command is used to change the values of specific entries. This command is only accepted when the scope mode is set to manual.

When the organizational scope of a registered address maps to a PNNI level that is lower in the PNNI hierarchy (larger PNNI routing level) than the level of this node, the registered address is not advertised. Similarly, when the connection scope of a setup attempt maps to a PNNI level that is lower in the PNNI hierarchy than the level of this node, then only destinations directly attached to this switch are considered acceptable.

Note      Modifying the node level without altering the scope map table can result in some advertisements being suppressed.

The ATM switch provides an option to automatically adjust the level changes. In automatic mode, the default scope map table is tied to the level of the node when it is generated.

Note that the default organizational scope of an individual address is global (15), and the default organizational scope of a group address is local (1).

Example

The following example shows setting the scope mode to manual and setting the scope map entries for organizational scope values 1 through 5 to PNNI level 96, using the scope map PNNI node-level subcommand.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# node 1
Switch(config-pnni-node)# scope mode manual
Switch(config-pnni-node)# scope map 1 5 level 96
Related Commands

scope mode
show atm pnni scope

scope mode

To specify the configuration mode of the mapping from organizational scope values (used at UNI interfaces) to PNNI scope (such as in terms of PNNI routing level indicators), use the scope mode node-level subcommand.

scope mode {automatic | manual}
Syntax Description

automatic

Generates a default scope mapping table automatically which is tied to the PNNI level of the node. In this mode, no modifications of the scope mapping table entries are allowed.

manual

Allows for manual configuration of the scope mapping table using the scope map command.

Default

The default scope mappings for automatic are shown in Table 18-2.

Table 18-2   Default Scope Mappings for Automatic Mode

Organizational Scope Range ATM Forum Default Level Automatic Mode Level

1-3

96

min(l,96)

4-5

80

min(l,80)

6-7

72

min(l,72)

8-10

64

min(l,64)

11-12

48

min(l,48)

13-14

32

min(l,32)

15(global)

0

0
Command Mode

PNNI node configuration

Usage Guidelines

Use this command to modify the way in which the default scope mapping table is computed.

Using the automatic mode ensures that all organizational scope values cover an area at least as wide as this node's peer group, even when the node is at a level higher than 96. As a result, all addresses including those of local scope are advertised across this node's peer group.

For each organizational scope value, the corresponding PNNI level is the minimum of the ATM Forum PNNI 1.0 default value and the level l of this node.

Note that the scope mapping table is overwritten whenever the scope-mode is changed from manual to automatic (for example, all scope map commands for this node are removed).

Example

The following example shows setting the scope mode to manual using the scope mode PNNI node-level subcommand.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# node 1
Switch(config-pnni-node)# scope mode manual
Related Commands

scope map
show atm pnni scope

scrambling

To allow scrambling to be enabled or disabled from the current port, use the scrambling interface configuration command. To disable scrambling, use the no form of this command.

scrambling scramblingmode
no scrambling scramblingmode


scramblingmode

Specify either sts-stream or cell-payload.

Syntax Description

Default

In SONET interfaces, both modes are enabled. In DS3 interfaces, the mode is disabled.

Command Mode

Interface configuration

Usage Guidelines

The sts-stream scrambling is applicable only to SONET interfaces.

Example

The following example shows how to disable sts-stream and cell-payload scrambling on the physical device associated with ATM 3/0/0.

Switch# interface atm 3/0/0
Switch# no scrambling cell-payload
Switch# no scrambling sts-stream

service-category

To filter ATM signalling call failures by service category, use the service-category ATM signalling diagnostics configuration command. To return the service category to the default, use the no form of this command.

service-category {abr | all | cbr | nrt-vbr | rt-vbr | ubr}
no service-category
Syntax Description

abr

Set the service category to ABR.

all

Set the service category to ABR, CBR, NRT-VBR, RT-VBR, and UBR.

cbr

Set the service category to CBR.

nrt-vbr

Set the service category to NRT-VBR.

rt-vbr

Set the service category to RT-VBR.

ubr

Set the service category to UBR.

Default

all

Command Mode

ATM signalling diagnostics configuration

Example

In the following example, call failures for the ABR and UBR service categories are filtered.

Switch(cfg-atmsig-diag)# service-category abr ubr
Switch(cfg-atmsig-diag)#

shutdown (controller)

To disable an interface, use the shutdown controller configuration command. To restart a disabled interface, use the no form of this command.

shutdown
no shutdown
Syntax Description

This command has no arguments or keywords.

Default

Enabled

Command Mode

Controller configuration

Usage Guidelines

The shutdown command disables transmission of data on the specified E1 interface. When the E1 interfaces are shut down, an Alarm Indication Signal (AIS) is transmitted to the far end.

This command also marks the controller as unavailable. To check whether a controller is disabled, use the EXEC command show controller. A controller that has been shut down is shown as administratively down in the screen display.

Examples

The following example turns off E1 interface 11/0/0.

Switch(config)# controller e1 11/0/0
Switch(config-controlle)# shutdown

The following example turns the interface on.

Switch# controller e1 11/0/0
Switch(config-controlle)# no shutdown
Related Command

show controllers

shutdown (interface)

To disable an interface, use the shutdown interface configuration command. To restart a disabled interface, use the no form of this command.

shutdown
no shutdown
Syntax Description

This command has no arguments or keywords.

Default

Enabled

Command Mode

Interface configuration

Usage Guidelines

The shutdown command disables all functions on the specified interface. When the ATM interfaces shut down, a loss of signal is transmitted to the far end.

This command also marks the interface as unavailable. To check whether an interface is disabled, use the EXEC command show interface. An interface that has been shut down is shown as administratively down in the display from this command.

Examples

The following example turns off Ethernet interface 0.

Switch# interface ethernet 0
Switch(config-if)# shutdown

The following example turns on the interface.

Switch# interface ethernet 0
Switch(config-if)# no shutdown
Related Command

show interface

slip

Use the slip EXEC command to attach or detach a SLIP interface.

slip
Syntax Description

This command has no keywords or arguments.

Command Mode

EXEC

snmp-server chassis-id

Note      This command or some of its parameters might not function as expected.

snmp-server enable traps

To enable the router to send SNMP traps, use the snmp-server enable traps global configuration command. To disable SNMP and stop sending traps, use the no form of this command.

snmp-server enable traps [trap-type] [trap-option]
no snmp-server enable traps [trap-type] [trap-option]
Syntax Description

trap-type

Type of trap to enable. If no type is specified, all traps are sent (including envmon and repeater). Trap-type can have one of the following values:

  • atm-accounting—Enable SNMP ATM accounting traps.
  • chassis-change—Enable SNMP chassis change trap.
  • chassis-fail—Enable SNMP chassis fail trap.
  • config—Enable SNMP configuration traps.
  • entity—Enable SNMP entity traps.
  • snmp—Enable SNMP traps.
  • syslog—Enable SNMP syslog traps.

trap-option

Enables authentication.

When the snmp keyword is used for trap-type, you can specify the authentication option to enable SNMP Authentication Failure traps. (The snmp-sever enable traps snmp authentication command replaces the snmp-server trap-authentication command.) If no option is specified, all SNMP traps are enabled.

Defaults

No traps are enabled.

If you enter this command with no keywords, the default is to enable all trap types.

Command Mode

Global configuration

Usage Guidelines

Use the snmp-server enable command to specify which SNMP traps the switch sends, and use the snmp-server host command to specify which host or hosts receive SNMP traps.

You must issue a separate snmp-server enable command for each trap type, including envmon and repeater.

snmp trap link-status

To enable SNMP link trap generation, use the snmp trap link-status interface configuration command. To disable SNMP link traps, use the no form of this command.

snmp trap link-status
no snmp trap link-status
Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Example

The following example enables snmp trap link status on serial interface 11/0/0:1.

Switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# snmp trap link-status
Related Commands

show snmp
snmp enable traps frame-relay

sonet

To set the mode of operation and thus control type of ATM cell used for cell-rate decoupling on the SONET, use the sonet interface configuration command. To restore the default sts3c operation to OC-3 and OC-12 interfaces, use the no form of this command.

sonet [stm-1 | sts-3c]
sonet [stm4 | sts-12c]
no sonet stm-1
Syntax Description

stm-1

SDH/STM-1 operation (ITU-T specification).1

stm-4

SDH/STM-4 operation (ITU-T specification).
1The ITU-T carries out the functions of the former Consultative Committee for International Telegraph and Telephone (CCITT).

Default

The default for OC-3 is sts3c.

The default for OC-12 is sts12c.

Command Mode

Interface configuration

Usage Guidelines

This command applies to all ports except the CPU. Use stm-1 in applications where the ATM switch requires idle cells for rate adaptation. An idle cell contains 31 zeros followed by a 1.

Use the default (sts3c) in applications where the ATM switch requires unassigned cells for rate adaptation. An unassigned cell contains 32 zeros.

Example

The following example specifies ATM SONET STM-1.

Switch(config-if)# atm sonet stm-1
Related Commands

show controllers
show running-config
write terminal

sonet tx-ais on-rx-defect

Use the sonet tx-ais on-rx-defect command to enable a SONET interface to send an alarm indication signal (AIS) if it detects the receive port has failed. To disable, use the no form of this command.

sonet tx-ais on-rx-defect
no sonet tx-ais on-rx-defect
Syntax Description

None

 

Default

Disabled

Command Mode

Interface Configuration

Usage Guidelines

The sonet tx-ais on-rx-defect command should not be enabled on both ATM switch interfaces connected to the same physical line. Even if no alarm exist, both interfaces will see the AISs and never come up.

Example

The following example enables AIS on an ATM interface.

Switch(config)# interface atm 3/0/0
Switch(config-if)# sonet tx-ais on-rx-defect
Related Command

show controllers

statistics

To turn on the PNNI statistics feature, use the statistics ATM router PNNI configuration command. To disable this feature, use the no form of this command.

statistics [call]
no statistics [call]
Syntax Description

call

Specifies statistics related to route computation for call and party setups.

Default

Disabled

Command Mode

ATM router PNNI configuration

Usage Guidelines

For more information, refer to the Catalyst 8510 and LightStream 1010 ATM Switch Software Configuration Guide.

Example

The following script shows how to access the statistics ATM router PNNI configuration command.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# statistics call
Related Command

show atm pnni statistics call

status

To configure the status of this filter table entry, use the status ATM signalling diagnostics configuration command. To disable this feature, use the no form of this command.

status [active | inactive | delete]
no status [active | inactive | delete]
Syntax Description

active

Sets status to active to begin filtering failed connections.

inactive

Sets status to inactive to stop filtering failed connections.

delete

Sets status to delete if the signalling diagnostics filter table entry needs to be deleted.

Default

Inactive

Command Mode

ATM signalling diagnostics configuration

Example

The following script shows how to access the status command.

Switch(config)# status active

summary-address

To configure summary address prefixes on a PNNI node, use the summary-address node-level subcommand. To remove configured summary address prefixes, use the no form of this command.

summary-address address-prefix [internal | exterior] [suppress]
no summary-address address-prefix [internal | exterior]
Syntax Description

address-prefix

Specifies the summary address prefix. The maximum length of the address prefix is 19 bytes. Each character in the prefix is 4-bits long. The length of the prefix must fall on a nibble boundary. In other words, the length of the prefix must be a multiple of 4 bits.

internal

Local knowledge of reachability, including end-system addresses registered via ILMI address registration.

exterior

Knowledge of reachability through remote networks or derived from other protocol exchanges outside the PNNI routing domain.

suppress

Indicates that neither the summary address nor any addresses for which the summary address is the longest matching prefix are advertised.

Default

Default summary addresses are controlled by the auto-summary command.

The default summary address type is internal.

Command Mode

PNNI node configuration

Usage Guidelines

Summary addresses can be used to decrease the amount of information advertised by this PNNI node. Summary addresses should only be configured when all end system addresses matching the summary address are reachable from this switch (for example, not reachable through PNNI interfaces to other switches).

Summary addresses of type internal only summarize internal addresses reachable from this switch (such as ILMI-registered addresses and internal static routes). Summary addresses of type exterior only summarize exterior addresses reachable from this switch (for example, exterior static routes on IISP or Public UNI interfaces).

Suppressed summary addresses can be used to prevent other PNNI nodes from learning of this switch's connectivity to certain addresses (for example, for back doors).

For more information, refer to the Catalyst 8510 and LightStream 1010 ATM Switch Software Configuration Guide.

Example

The following script shows how to access the summary-address node-level subcommand.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# node 1
Switch(config-pnni-node)# summary-address 48.91...
Related Commands

atm route
auto-summary
show atm route