ATM Services (AXSM) Software Configuration Guide and Command Reference for MGX Switches, Release 4
Introduction

Table Of Contents

Introduction

Command Line Interface

CLI Prompt

CLI Syntax

Command Notation

Command Parameters

Command Entry

AXSM Models

Logical Ports

Common Acronyms

List of Commands by Function


Introduction


On the Cisco MGX 8850 and MGX 8950 switches, the PXM card is the controller card that controls the other cards on the switch. The other cards on the switch are called service modules. AXSM cards are service modules. AXSM stands for ATM Switching Service Module. The AXSM cards covered in this manual are the AXSM/A, AXSM/B, AXSM-E, AXSM-XG, and AXSM-32-T1E1-E cards.

There are also other types of service module cards for the Cisco MGX 8850 and MGX 8950 switches, but they are not covered in this manual.

The PXM cards are not covered in this manual. For information about the PXM cards, refer to the following documents:

Cisco MGX 8830, Cisco MGX 8850 (PXM45 and PXM1E), and Cisco MGX 8950 Command Reference, Release 4

Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Software Configuration Guide, Release 4

This manual provides a software configuration guide that explains how to configure the AXSM cards for production and a command reference, which describes each AXSM command in detail. This manual is divided into three chapters as follows:

"Introduction"

"AXSM Configuration Guide"

Chapter 3, "AXSM Command Reference"

Command Line Interface

Each AXSM card has its own command line interface (CLI), which is similar to the CLIs on the PXMs and the other service modules.

The CLI is the application that allows you to enter the commands that configure the card. You log into the CLI using the appropriate user name and password. For detailed information about user names, passwords, and logging into the CLI, see the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Software Configuration Guide, Release 4 .

Once you have logged into the CLI, you will see a CLI prompt such as the following one:

MGX8850.7.PXM.a > 

To change from the CLI of one card to the CLI of another card, use the change card (cc) command. For example:

MGX8850.7.PXM.a > cc 1

(session redirected)

MGX8850.1.AXSM.a > 

CLI Prompt

The format of the CLI prompt is as follows and as described in Table 1-1:

Name.Slot Number.Card Type.Card State >

For example:

MGX8850.1.AXSM.a > 

Table 1-1 CLI Prompt Descriptions

Format

Name

Slot Number

Card Type

Card State

Example

MGX8850

1

AXSM

a

Description

The name of the switch.

The slot containing the front card.

The type of card, such as PXM, AXSM, AXSME.

a-active
s-standby
i-initialized


CLI Syntax

This section explains the syntax for using commands in the CLI. The following topics are discussed:

Command Notation

Command Parameters

Command Entry

Command Notation

The notations for the CLI syntax are as follows:

Commands appear in bold, for example: addport

Keywords appear in bold, for example: -ds1

Literal strings appear in bold, for example: yes

Variables appear in italics, for example: bay.line

Required parameters appear within arrowheads (< >), for example: <ifNum>

Optional parameters appear within square brackets ([ ]),
for example: [-minvpi minvpi]

A vertical bar ( | ) represents the logical OR function.

Command Parameters

Parameters act as the arguments for the command. Parameters may consist of variables, keywords, and literal strings.

Commands may include parameters that are keyword-driven or position-dependent.

Position-dependent Parameters

You must type position-dependent parameters in the order they appear in the syntax description. For example, to add a logical port, you must enter the required, position-dependent parameters as follows:

addport <ifNum> <bay.line> <guaranteedRate> <maxrate> <sctID> <ifType> [vpi]

Keyword-driven Parameters

For a keyword-driven parameter, the keyword is preceded by a dash and followed by a variable, for example:

[-timeout secs]

Keyword-driven parameters are usually not position-dependent.

In the following example, the command contains both keyword-driven and position-dependent parameters.

The keyword-driven parameters appear first in a specific order. The keyword-driven parameters can be in any order after that.

delcons <ifNum> <vpi> <vci> [-num num. conns to del] [-verbose 1 | 0 ]

Command Entry

You enter a command by pressing the Return key or Enter key after you have typed the name of the command and all of its parameters in the proper order.

If you enter a command with incorrect parameters or with no parameters (when parameters are required), the CLI displays a message with the correct syntax, parameters, and ranges for the command. The message may also suggest what the problem is.

AXSM Models

Individual AXSM cards are identified by the model number. The model number identifies the number of lines on the card and the rate of speed of the lines. For example, the AXSM-1-2488 has one line that runs at 2488 megabits per second.

An AXSM card is a double-height front card that can have one or two bays in the back to accommodate one or two single-height back cards. The software refers to the upper bay as 1 and lower bay as 2.

Table 1-1 lists the different AXSM models with their back card types, number of lines, number of bays, and number of connections.


Note For cards that have been configured for statistics level 3, the maximum number of connections is always 32 K.


Table 1-2 AXSM Model Numbers, Back Cards, Lines, Bays, and Maximum Connections

Front Card
Model Number
and Chassis
Line Type:
Back Cards
Number
of Bays
Maximum
Number of lines per
Back Card
Maximum
Number of Lines per
Front Card
Maximum
Number of
SVCs
Maximum
Number of
SPVCs
Maximum
Number of
Connections

AXSM-1-2488
(MGX8850 only)

OC-48:
SMFSR-1-2488,
SMFLR-1-2488,
SMFXLR-1-2488

1

1

1

128K

64K

128K

AXSM-1-2488/B
(MGX8850 and
MGX8950)

OC-48:
SMFSR-1-2488/B,
SMFLR-1-2488/B,
SMFXLR-1-2488/B

1

1

1

128K

64K

128K

AXSM-2-622-E
(MGX8850 only)

OC-12:
SMFIR-2-622,
SMFLR-2-622

1

2

2

60K

60K

60K

AXSM-4-622
(MGX8850 only)

OC-12:
SMFIR-2-622,
SMFLR-2-622

2

2

4

128K

64K

128K

AXSM-4-622/B
(MGX8850 and
MGX8950)

OC-12:
SMFIR-2-622/B,
SMFLR-2-622/B

2

2

4

128K

64K

128K

AXSM-8-155-E
(MGX8850 only)

OC-3:
SMFIR-8-155-LC,
SMFLR-8-155-LC,
MMF-8-155-MT

2

4

8

128K

60K

60K

AXSM-16-155
(MGX8850 only)

OC-3:
SMFIR-8-155-LC,
SMFLR-8-155-LC,
STM-4-155-EL
MMF-8-155-MT

2

8

16

128K

64K

128K

AXSM-16-155/B
(MGX8850 and MGX8950)

OC-3:
SMFIR-8-155-LC/B,
SMFLR-8-155-LC/B,
MMF-8-155-MT

2

8

16

128K

64K

128K

AXSM-16-T3E3-E
(MGX8850 only)

T3 or E3:
SMB-8-T3,
SMB-8-E3

2

8

16

60K

60K

60K

AXSM-16-T3E3
(MGX8850 only)

T3 or E3:
SMB-8-T3,
SMB-8-E3

2

8

16

128K

64K

128K

AXSM-16-T3E3/B
(MGX8850 and
MGX8950)

T3 or E3:
SMB-8-T3,
SMB-8-E3

2

8

16

128K

64K

128K

AXSM-32-T1E1-E
(MGX8850 only)

MCC-16-E1,
RBBN-16-T1E1

2

16

32

32K

32K

32K

AXSM-1-9953-XG
(MGX8950 only)

OC48/STM-16:
SMFSR-1-9953
SMFIR-1-9953
SMFLR-1-9953
SMFXLR-1-9953

1

1

1

124K

124K

124K

AXSM-4-2488CH-XG
(MGX8950 only)

OC192c/STM-64:
SMF-4-2488-SFP
SMFSR-1-2488-SFP
SMFLR-1-2488-SFP
SMFXLR-1-2488-SFP

1

4

4 lines
and
64 STM channels per front card

124K

124K

124K


In Table 1-2, the number of lines refers to the number of lines on a single back. Therefore, the highest possible number of lines available on the front card is equal to the number of lines on the back multiplied by the number of bays. For example, the AXSM-1-2488 card has one available line and the AXSM-16-155 card has 16 possible lines.

For specifications and illustrations of the AXSM cards, see the applicable hardware installation documentation for the Cisco MGX switch and card. For information on obtaining documentation, see the Obtaining Documentation section in the preface of this document.

Logical Ports

On AXSMs, a logical port is also called a virtual interface and is represented by the ifNum variable. The AXSMS can have the following types of interfaces:

UNI (User-to-Network Interface)

NNI (Network-to-Network Interface)

VNNI (Virtual Network-to-Network Interface)

VUNI (Virtual User-to-Network Interface)

EVUNI (Enhanced Virtual User-to-Network Interface)

EVNNI (Enhanced Virtual Network-to-Network Interface)

On UNI and NNI lines, you can configure only one logical port per line.

On VNNI and VUNI, you can configure multiple ports per line.

On EVNNI and EVUNI you can to specify a range of VPIs for a single interface, and this range of VPIs represents the virtual NNI or virtual UNI trunk.

Multiple VNNIs and EVNNIs can coexist on the same line.

The ranges for the number of logical ports (ifNum) on the AXSMs are as follows:

AXSM: 1-60.

AXSM-E: 1-32.

AXSM-XG: 1-126

Common Acronyms

Some of the most commonly used acronyms in this manual are listed below:

Acronym
Definition

AXSM

ATM Switching Service Module

CLI

Command Line Interface

EVNNI

Enhanced Virtual Network-to-Network Interface

EVUNI

Enhanced Virtual User-to-Network Interface

ILMI

Integrated Local Management Interface

IMA

Inverse Multiplexing over ATM

NNI

Network-to-Network Interface

PNNI

Private Network-Network Interface

PVC

Permanent Virtual Circuit

PXM

Processor Switching Module

SPVC

Soft Permanent Virtual Circuit

SVC

Switch Virtual Circuit

UNI

User-to-Network Interface

VNNI

Virtual Network-to-Network Interface

VUNI

Virtual User-to-Network Interface


List of Commands by Function

The AXSM commands can be divided into categories based on the function that they perform. Table 1-3 lists the commands by these functions. These functional categories are listed in the order in which they are performed.

Session Management Commands

Card Management Commands

Line Management Commands

Port Management Commands

IMA Management Commands

LMI and ILMI Management Commands

Connection Management Commands

Table 1-3 AXSM Command List by Function 

Command
Description
Page

Session Management Commands

bye

Log Out Of Session

3-48

clidbxlevel

CLI Debug Level

3-50

clrscrn

Clear Screen

3-76

cmdhistory

Command History

3-77

exit

Log Out of Session

3-299

help (?)

Help

3-300

history

CLI Session History

3-301

logout

Log Out of Session

3-303

offdiagstat

Off Diagnostics Statistics

3-304

ondiagstat

On Diagnostics Statistics

3-305

timeout

Time Out to End of Session

3-316

who

Who

3-332

whoami

Who Am I

3-333

Card Management Commands

bootchange

Change Boot Firmware on Card

3-47

cc

Change to New Card CLI

3-49

clrcdcnt

Clear Card Count

3-56

cnfcdmode

Configure Card Mode

3-94

cnfcdsct

Configure Card SCT

3-95

cnfcdstat

Configure Card Statistics

3-98

dspcd

Display Card

3-174

dspcdbucketcnt

Display Card Bucket Count

3-178

dspcdcnt

Display Card Count

3-179

dspcdsct

Display Card SCT

3-182

dspcdstatcnf

Display Card Statistics Configuration

3-189

reboot

Reboot Card

3-307

setsctver

Set SCT Version on Card

3-310

Line Management Commands

addapsln

Add APS Line

3-2

addlnloop

Add Line Loopback

3-32

clradjlnalmcnt

Clear Adjacent Line Alarm Count

3-52

clralmcnt

Clear Alarm Count

3-54

clrbecnt

Clear BERT Count

3-55

clrlncnt

Clear Line Count

3-69

clrlntrace

Clear Line Trace

3-69

cnfalm

Configure Alarm

3-80

cnfapsln

Configure APS Line

3-84

cnfatmln

Configure ATM Line

3-88

cnfautolndiag

Configure Auto Line Diagnostics

3-90

cnfbert

Configure BERT

3-91

cnfln

Configure Line

3-113

delapsln

Delete APS Line

3-127

dellnloop

Delete Line Loopback

3-136

dnln

Down Line

3-147

dspadjlnalm

Display Adjacent Alarm

3-151

dspadjlnalmcnt

Display Adjacent Line Alarm Count

3-152

dspalm

Display Alarm

3-154

dspalms

Display Alarms

3-156

dspalmcnt

Display Alarm Count

3-159

dspapsbkplane

Display APS Backplane

3-162

dspapsln

Display APS Line

3-163

dspapslns

Display APS Lines

3-165

dspatmln

Display ATM Line

3-169

dspautolndiag

Display Auto Line Diagnostics

3-170

dspbecnt

Display BERT Count

3-171

dspbert

Display BERT

3-172

dspbertstats

Display BERT Statistics

3-173

dspegrbucketcnt

Display Egress Bucket Count

3-212

dspingbucketcnt

Display PING Bucket Count

3-230

dspln

Display Line

3-245, 3-248

dsplns

Display Lines

3-250, 3-252

dsplnbucketcnt

Display Line Bucket Count

3-254

dsplncnt

Display Line Count

3-256

dsplnload

Display Line Load

3-258

dsplnpmbucketcnt

Display Line Performance Bucket Counters

3-259

insbiterror

Insert Bit Error

3-302

startbert

Start BERT

3-311

stopbert

Stop BERT

3-313

switchapsln

Switch APS Line

3-315

upln

Up Line

3-328

Port Management Commands

addport

Add Port

3-39

clrportcnt

Clear Port Count

3-72

clrportcnts

Clear Port Counters

3-74

delport

Delete Port

3-139

dnallports

Down All Ports

3-141

dnport

Down Port

3-150

dspport

Display Port

3-277

dspports

Display Ports

3-279

dspportbucketcnt

Display Port Bucket Count

3-281

dspportcnt

Display Port Count

3-282

dspportload

Display Port Load

3-284

dspportsct

Display Port SCT

3-285

dspqecnfcnt

Display Queuing Engine Configuration Count

3-292

upallports

Up All Ports

3-321

upport

Up Port

3-330

Resource Partition Management Commands

addpart

Add Partition

3-35

addrscprtn

Add Resource Partition

3-44

cnfpart

Configure Partition

3-117

delpart

Delete Partition

3-138

delrscprtn

Delete Resource Partition

3-140

dspload

Display Load on Partition

3-261

dsppart

Display Partition

3-264

dspparts

Display Partitions

3-266

IMA Management Commands

addimagrp

Add IMA Group

3-24

addimalnk

Add IMA Link

3-26

addimaport

Add IMA Port

3-27

clrimadelay

Clear IMA Delay

3-61

clrimagrpalmcnt

Clear IMA Group Alarm Count

3-62

clrimagrpalmcnts

Clear IMA Group Alarm Counters

3-63

clrimagrpcnt

Clear IMA Group Count

3-64

clrimalnkcnt

Clear IMA Link Count

3-65

clrimalnkcnts

Clear IMA Link Counters

3-66

cnfatmimagrp

Configure ATM IMA Group

3-86

cnfimagrp

Configure IMA Group

3-110

cnfimalnk

Configure IMA Link

3-111

cnfimalnktst

Configure IMA Link Test

3-112

delimagrp

Delete IMA Group

3-133

delimalnk

Delete IMA Link

3-134

dnimagrp

Down IMA Group

3-145

dspatmimagrp

Display ATM IMA Group

3-166

dspimagrp

Display IMA Group

3-220

dspimagrps

Display IMA Group

3-223

dspimagrpalm

Display IMA Group Alarm

3-225

dspimagrpalms

Display IMA Group Alarms

3-227

dspimagrpalmcnt

Display IMA Group Alarm Count

3-229

dspimagrpbucketcnt

Display IMA Group Bucket Count

3-230

dspimagrpcnt

Display IMA Group Count

3-231

dspimalnk

Display IMA Link

3-232

dspimalnks

Display IMA Links

3-234

dspimalnkalm

Display IMA Link Alarm

3-236

dspimalnkalms

Display IMA Link Alarms

3-237

dspimalnkbucketcnt

Display IMA Link Bucket Count

3-238

dspimalnkcnt

Display IMA Link Count

3-239

rstrtimagrp

Restart IMA Group

3-308

startimalnktst

Start IMA Link Test

3-312

stopimalnktst

Stop IMA Link Test

3-314

upimagrp

Up IMA Group

3-326

LMI and ILMI Management Commands

addlmi

Add LMI

3-30

clrilmicnt

Clear ILMI Count

3-60

clrlmistat

Clear LMI Statistics

3-67

cnfilmi

Configure ILMI

3-109

dellmi

Delete LMI

3-135

dnilmi

Down ILMI

3-144

dnlmi

Down ILMI

3-146

dspilmi

Display ILMI

3-217

dspilmis

Display ILMIs

3-219

dspilmicnt

Display ILMI Count

3-218

dsplmi

Display LMI

3-242

dsplmis

Display LMIs

3-243

dsplmistat

Display LMI Statistics

3-244

upilmi

Up ILMI

3-324

uplmi

Up LMI

3-327

Connection Management Commands

addchanloop

Add Channel Loopback

3-6

addcon

Add Connection

3-8

addfdr

Add Feeder Connection

3-23

clrchancnt

Clear Channel Count

3-57

clrchancnts

Clear Channel Counters

3-58

clrfdrstat

Clear Feeder Statistics

3-59

cnfabr

Configure Available Bit Rate

3-78

cnfcon

Configure Connection

3-101

delchanloop

Delete Channel Loopback

3-128

delcon

Delete Connection

3-129

delcons

Delete Connections

3-130

delfdr

Delete Feeder Connection

3-132

dncon

Down Connection

3-142

dncons

Down Connections

3-143

dspchancnt

Display Channel Count

3-190

dspchanloop

Display Channel Loopback

3-193

dspchantests

Display Channel Tests

3-194

dspcon

Display Connection

3-196

dspcons

Display Connections

3-199

dspconalmcnts

Display Configuration Alarm Counts

3-203

dspconalms

Display Configuration Alarm

3-204

dspconhwcnf

Display Connection Hardware Configuration

3-205

dspconload

Display Connection Load

3-210

dspfdr

Display Feeder Connection

3-213

dspfdrs

Display Feeder Connections

3-214

dspfdrstat

Display Feeder Statistics

3-215

rrtcon

Reroute Connection

3-309

tstconseg

Test Configuration Segment

3-317

tstdelay

Test Delay

3-318

upcon

Up Connection

3-323

Channelization (Path) Management Commands

clrpathalmcnt

Clear Path Alarm Count

3-71

cnfatmlayer

Configure ATM Layer

3-87

cnfpath

Configure Path

3-120

cnfpathalm

Configure Path Alarm

3-122

dnpath

Down Path

3-149

dspatmlayer

Display ATM Layer

3-167

dspatmlayercnt

Display ATM Layer Count

3-168

dsppath

Display Path

3-267

dsppaths

Display Paths

3-269

dsppathalm

Display Path Alarm

3-271

dsppathalms

Display Path Alarms

3-273

dsppathalmcnf

Display Path Alarm Configuration

3-274

dsppathalmcnt

Display Path Alarm Count

3-275

uppath

Up Path

3-329

Resource Monitor Management Commands

cnfrmrsrc

Configure Resource Monitor Resource

3-126

dsprmalms

Display Resource Monitor Alarms

3-294

dsprminfo

Display Resource Monitor Information

3-295

dsprmrsrc

Display Resource Monitor Resource

3-296

dsprmrsrcs

Display Resource Monitor Resources

3-298