Table Of Contents

Introduction

Changes to this Document Since Release 5.1

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, MGX 8950, and MGX 8880 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, MGX 8950, and MGX 8880 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 8800/8900 Series Configuration Guide, Release 5.2

•Cisco MGX 8800/8900 Series Command Reference, Release 5.2

•Cisco PNNI Network Planning Guide for MGX and SES Products

•Release Notes for Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Switches, Release 5.2.00

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"

•"Preparing AXSM Lines for Communication"

•Chapter 3, "Provisioning ATM Services"

•Chapter 4, "AXSM Card Management"

•Chapter 5, "AXSM Command Reference"

Changes to this Document Since Release 5.1

Table 1-1 summarizes the changes made to this document since Release 5.1.

Table 1-1 Changes to This Guide Since Release 5.0 

Section and Link	Status	Description
AXSM Models	Updated	Added AXSM-8-622-XG.
Channelizing SONET, SDH, and DS3 (T3) Lines into Paths	Updated	Improved channelization procedures.
Managing CLI Sessions, page 4-1	Updated	Updated command list.

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 8800/8900 Series Configuration Guide, Release 5.2.

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-2:

Name.Slot Number.Card Type.Card State >

For example:

MGX8850.1.AXSM.a > 

Table 1-2 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: -ds3

•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-3 lists the different AXSM models with their back card types, number of lines, number of bays, and number of connections.

Table 1-3 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	60K	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	128K	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
AXSM-8-622-XG	OC12/STM-4: SFP-4-622 SMFIR-622-SFP SMFLR-622-SFP SMFXLR-1-622-SFP	2	4	8	124K	124K	124K
AXSM-16-155-XG	SFP-8-155 SMFIR-1-155-SFP SMFLR-1-155-SFP MMF-1-155-SFP MCC-8-155	2	8	16	124K	124K	124K

In Table 1-3, 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-4 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

•Resource Partition Management Commands

•IMA Management Commands

•LMI and ILMI Management Commands

•Connection Management Commands

•Channelization (Path) Management Commands

•Resource Monitor Management Commands

Table 1-4 AXSM Command List by Function 

Command	Description	Page
Session Management Commands
bye	Log out of session	5-49
clidbxlevel	CLI debug level	5-52
clrscrn	Clear screen	5-91
cmdhistory	Command history	5-92
cnfcli	Configure CLI	5-121
core	Core memory dump	5-164
dspDevErr	Display device errors	5-271
dspDevErrHist	Display device error history	5-273
dspfile	Display file	5-280
dspframerdiagstat	Display Frame Receive Diagnostics Statistics	5-281
dspmempart	Display memory partition	5-336
dspmsgq	Display message queue	5-339
dspmsgqs	Display message queues	5-341
dspsem	Display semaphore	5-397
dspsems	Display all semaphores	5-399
dsptask	Display task info	5-404
dsptasks	Display task list	5-406
dspudpdiagcstat	Display user datagram protocol (UDP) diagnostic connection statistics (for the specified port)	5-410
dspudpdiagstat	Display user datagram protocol (UDP) diagnostic statistics	5-411
dumptrace	Dump trace	5-420
exit	Log out of session	5-421
help (?)	Help	5-422
history	CLI session history	5-423
logout	Log out of session	5-425
memShow	Show memory map	5-426
offdiagcstat	Off diagnostic connection statistics	5-427
offdiagstat	Off diagnostics statistics	5-428
ondiagcstat	Off diagnostic connection statistics	5-429
ondiagstat	On diagnostics statistics	5-430
ping	Ping	5-431
sesntimeout	Session timeout	5-435
sesnwatchdog	Session watchdog	5-436
seteng	Set Engineering mode	5-437
sfmDBShow	Show statistics file manager	5-439
shellConn	Enter shellCon mode	5-441
showsyserr	Set system error function on or off	5-442
smclrscrn	Service module clear screen	5-443
syserr	Show system errors	5-449
timeout	Time out to end of session	5-450
trace	Show current status of trace	5-451
users	Show user session info	5-467
who	See details about "who" a user is	5-468
whoami	Display user details about currently logged in user	5-469
Card Management Commands
bootchange	Change boot firmware on card	5-48
cc	Change to new card CLI	5-50
ccc	Change to new card CLI and display the priority of the current session.	5-51
clrbucketcstat	Clear buscket statistics	5-58
clrcdcnt	Clear card count	5-59
clrsarcnt	Clear segmentation and reassembly (SAR) counters	5-89
cnfcdmode	Configure card mode	5-111
cnfcdsct	Configure card SCT	5-112
cnfcdstat	Configure card statistics	5-115
cnfcellfilter	Configure the cell filter	5-118
cnfchandbg	Configure channelized debugging	5-119
dspbucketcstat	Display bucket connection statistics	5-223
dspcd	Display card	5-224
dspcdbucketcnt	Display card bucket count	5-227
dspcdcnt	Display card count	5-228
dspcdsct	Display card SCT	5-232
dspcdstatcnf	Display card statistics configuration	5-239
dsphotstandby	Display hot standby	5-282
dspsarcnt	Display SAR counters	5-390
dspsct	Display service class templates	5-392
dsptotals	Display line, port. and channel totals	5-409
dspversion	Display version	5-413
reboot	Reboot crd	5-432
setsctver	Set SCT version on card	5-438
Line Management Commands
addapsln	Add APS line	5-2
addlnloop	Add line loopback	5-33
clradjlnalmcnt	Clear adjacent line alarm count	5-54
clralmcnt	Clear alarm count	5-56
clrbecnt	Clear BERT count	5-57
clrlncnt	Clear line count	5-78
clrlntrace	Clear line trace	5-79
cnfalm	Configure alarm	5-96
cnfapsln	Configure APS line	5-100
cnfatlaslndiagstat	Configure Atlas line diagnostics	5-102
cnfatmln	Configure ATM line	5-105
cnfautolndiag	Configure auto line diagnostics	5-107
cnfbert	Configure BERT	5-108
cnfln	Configure line	5-137
cnflnalm	Configure line alarm	5-141
delapsln	Delete APS line	5-169
dellnloop	Delete line loopback	5-177
dnln	Down line	5-190
dspadjlnalm	Display adjacent alarm	5-194
dspadjlnalmcnt	Display adjacent line alarm count	5-195
dspalm	Display alarm	5-197
dspalms	Display alarms	5-202
dspalmcnt	Display alarm count	5-199
dspapsbkplane	Display APS backplane	5-205
dspapsln	Display APS line	5-206
dspapslns	Display APS lines	5-208
dspatlasdiagstatcnf	Display Atlas diagnostics statistics configuration	5-212
dspatlaslndiagstat	Display Atlas line diagnostics statistics	5-213
dspatmln	Display ATM line	5-218
dspautolndiag	Display auto line diagnostics	5-219
dspbecnt	Display BERT count	5-220
dspbert	Display BERT	5-221
dspbertstats	Display BERT statistics	5-222
dspegrbucketcnt	Display egress bucket count	5-275
dspingbucketcnt	Display PING bucket count	5-308
dspln	Display line	5-313
dsplnalm	Display the line and statistical alarm state	5-317
dsplnalmcnf	Display line alarm configuration	5-318
dsplnalmcnt	Display line alarm counters	5-319
dsplnalms	Display line alarms for all lines	5-321
dsplns	Display lines	5-329
dsplnbucketcnt	Display line bucket count	5-322
dsplncnt	Display line count	5-324
dsplnload	Display line load	5-326
dsplnpmbucketcnt	Display line performance bucket counters	5-327
insbiterror	Insert bit error	5-424
startbert	Start BERT	5-444
stopbert	Stop BERT	5-446
switchapsln	Switch APS line	5-448
upln	Up line	5-464
Port Management Commands
addport	Add port	5-40
clrportcnt	Clear port count	5-81
clrportcnts	Clear port counters	5-83
clrportdbgcnt	Clear port debug counters	5-85
cnfcosbdbg	Configure class of service debugging counters	5-130
cnfport	Configure port	5-151
cnfportdbg	Configure port debugging	5-153
cnfportdbgcnt	Configure port debug counters	5-154
delport	Delete port	5-180
dnallports	Down all ports	5-182
dnport	Down port	5-193
dspatlasdiagcnfcstat	Display Atlas diagnostics configuration statistics	5-209
dspatlasdiagcstat	Display Atlas diagnostics connection statistics	5-211
dspcosbdbgcnf	Display COSB (class of service buffer) debugging configuration	5-266
dspcosbdbgcnt	Display COSB (class of service buffer) debugging counters	5-267
dspport	Display port	5-354
dspports	Display ports	5-356
dspportbucketcnt	Display port bucket count	5-357
dspportcnt	Display port count	5-358
dspportdbgcnf	Display port debug configuration	5-358
dspportdbgcnt	Display all port debugging counters	5-358
dspportload	Display port load	5-363
dspportsct	Display port SCT	5-364
dspqecnfcnt	Display queuing engine configuration count	5-380
dspspvcif	Display SPVC address information (specific interface)	5-402
dspspvcifs	Display SPVC address information (all interfaces)	5-403
upallports	Up all ports	5-457
upport	Up port	5-466
Resource Partition Management Commands
addpart	Add partition	5-36
addrscprtn	Add resource partition	5-45
cnfrscprtn	Configure resource partition	5-158
cnfpart	Configure partition	5-144
delpart	Delete partition	5-179
delrscprtn	Delete resource partition	5-181
dspload	Display load on partition	5-333
dsppart	Display partition	5-342
dspparts	Display partitions	5-344
dsprscprtn	Display resource partition	5-387
dsprscprtns	Display all resource partitions	5-389
IMA Management Commands
addimagrp	Add IMA group	5-25
addimalnk	Add IMA link	5-27
addimaport	Add IMA port	5-28
clrimadelay	Clear IMA delay	5-69
clrimagrpalmcnt	Clear IMA group alarm count	5-70
clrimagrpalmcnts	Clear IMA group alarm counters	5-71
clrimagrpcnt	Clear IMA group count	5-72
clrimalnkcnt	Clear IMA link count	5-73
clrimalnkcnts	Clear IMA link counters	5-74
cnfatmimagrp	Configure ATM IMA group	5-103
cnfimagrp	Configure IMA group	5-132
cnfimalnk	Configure IMA link	5-134
cnfimalnktst	Configure IMA link test	5-135
delimagrp	Delete IMA group	5-174
delimalnk	Delete IMA link	5-175
dnimagrp	Down IMA group	5-188
dspatmimagrp	Display ATM IMA group	5-215
dspimagrp	Display IMA group	5-287
dspimagrps	Display IMA group	5-290
dspimagrpalm	Display IMA group alarm	5-292
dspimagrpalms	Display IMA group alarms	5-294
dspimagrpalmcnt	Display IMA group alarm count	5-296
dspimagrpbucketcnt	Display IMA group bucket count	5-297
dspimagrpcnt	Display IMA group count	5-298
dspimalnk	Display IMA link	5-299
dspimalnks	Display IMA links	5-301
dspimalnkalm	Display IMA link alarm	5-303
dspimalnkalms	Display IMA link alarms	5-304
dspimalnkbucketcnt	Display IMA link bucket count	5-305
dspimalnkcnt	Display IMA link count	5-306
rstrtimagrp	Restart IMA group	5-433
startimalnktst	Start IMA link test	5-445
stopimalnktst	Stop IMA link test	5-447
upimagrp	Up IMA group	5-462
LMI and ILMI Management Commands
addlmi	Add LMI	5-31
clrilmicnt	Clear ILMI count	5-68
clrlmistat	Clear LMI statistics	5-75
clrlmitrace	Clear LMI trace	5-77
cnfilmi	Configure ILMI	5-131
cnflmitrace	Configure LMI trace	5-136
dellmi	Delete LMI	5-176
dnilmi	Down ILMI	5-185
dnlmi	Down ILMI	5-189
dspilmi	Display ILMI	5-283
dspilmis	Display ILMIs	5-286
dspilmicnt	Display ILMI count	5-285
dsplmi	Display LMI	5-309
dsplmis	Display LMIs	5-310
dsplmistat	Display LMI statistics	5-311
dsplmitrace	Display LMI trace	5-312
upilmi	Up ILMI	5-461
uplmi	Up LMI	5-463
Connection Management Commands
addchanloop	Add channel loopback	5-6
addcon	Add connection	5-8
addfdr	Add feeder connection	5-24
clrchancnt	Clear channel count	5-60
clrchancnts	Clear channel counters	5-61
clrchandbg	Clear channelized debugging	5-62
clrchandbgcnt	Clear all channelized debugging counters	5-63
clrcosbdbgcnt	Clear COSB (class of service buffer) debugging counters	5-64
clrfdrstat	Clear feeder statistics	5-67
cnfabr	Configure available bit rate	5-93
cnfcon	Configure connection	5-123
copychans	Copy one or more channels from a single connection	5-160
copycons	Copy one or more connection endpoints from a single endpoint	5-162
delallcon	Delete all connections	5-168
delchanloop	Delete channel loopback	5-170
delcon	Delete connection	5-171
delcons	Delete connections	5-172
delfdr	Delete feeder connection	5-173
dncon	Down connection	5-183
dncons	Down connections	5-184
dspchancnt	Display channel count	5-240
dspchandbgcnf	Display channelized