Table Of Contents
MGX 8230 Command Line Interface
Introduction
List of Commands
?
abort
acqdsx3bert
addapsln
addaimgrp
addcdrscprtn
addchan
addchanloop
addcon
addendpt
addimagrp
addlink
addlmiloop
addln
addlnloop
addlns2aimgrp
addport
addred
addrscprtn
addserialif
addtrapmgr
addtrk
adduser
agetrapmgr
aimhelp
arpAdd
arpDelete
arpFlush
arpShow
bootChange
bye
cc
cd
clraimgrpcnt
clraimlncnt
clrallcnf
clralm
clralmcnt
clralmcnts
clralms
clratmlncnt
clratmlncnts
clrbertcntrs
clrcderrs
clrchancnt
clrchancnts
clrconcnt
clrconcnts
clrerr
clrifcnt
clrifcnts
clrimagrpcnt
clrimalncnt
clrlmistats
clrlog
clrmsgcnt
clrportcnt
clrportcnts
clrsarcnt
clrsarcnts
clrscrn
clrslftst
clrsmcnf
clrsrmcnf
cmdhistory
cnfaimgrp
cnfapsln
cnfatmln
cnfbctype
cnfbert
cnfcbclk
cnfcdprtntype
cnfcdrscprtn
cnfchan
cnfchancacoff
cnfchanegressq
cnfchaneir
cnfchanfst
cnfchaningressq
cnfchanmap
cnfchanpol
cnfchanq
cnfchansrvrate
cnfclksrc
cnfcon
cnfdate
cnfdsx3bert
cnfegrservtype
cnfenetgw
cnfextclk
cnffst
cnfif
cnfifastrk
cnfifip
cnfilmi
cnfimagrp
cnfln
cnflnsubrate
cnfname
cnfoamlpbk
cnfpasswd
cnfplpp
cnfport
cnfportcllm
cnfportq
cnfportrscprtn
cnfprfparam
cnfrscprtn
cnfserialif
cnfslftst
cnfsnmp
cnfsrmclksrc
cnfstatsmgr
cnfswfunc
cnftime
cnftmzn
cnftmzngmt
cnftrafficgen
cnftrapip
cnftrk
cnfupcabr
cnfupccbr
cnfupcubr
cnfupcvbr
cnfvismip
commit
copy
copychans
copyports
cp
cth
cvsi
dcct
dcondb
del
delaimgrp
delapsln
delbert
delcdrscprtn
delchan
delchanloop
delchans
delcon
deldsx3bert
delifip
dellink
dellmiloop
delln
dellnloop
dellnsfmaimgrp
delport
delports
delred
delrscprtn
delslotlink
deltrapmgr
deltree
deluser
dir
dlmi
dncon
dnif
dnilmi
dnport
downloadflash
dspaimgrp
dspaimgrpcnt
dspaimgrps
dspaimlncnt
dspalm
dspalmcnf
dspalmcnt
dspalms
dspapscfg
dspapsln
dspatmlncnf
dspatmlncnt
dspbctype
dspbert
dspcbclk
dspcd
dspcderrs
dspcdprtntype
dspcdrscprtn
dspcds
dspchan
dspchancnt
dspchanmap
dspchans
dspchstats
dspclkinfo
dspclksrc
dspcon
dspconcnt
dspcons
dspcurclk
dspdsx3bert
dspegrq
dspegrqs
dspegrservtype
dspenetgw
dsperr
dspfeature
dspfst
dspfw
dspfwrevs
dsphotstandby
dspif
dspifcnt
dspifip
dspifrsc
dspifs
dspilmi
dspilmicnt
dspilmis
dspimagrp
dspimagrpcnt
dspimagrps
dspimainfo
dspimalncnt
dsplink
dsplmiloop
dsplmistats
dspln
dsplnrsc
dsplns
dsploads
dsplog
dsplogs
dspmaptbl
dspmsgcnt
dspname
dspnwip
dspoamlpbk
dsponoff
dspparifs
dsppasswd
dspplpp
dspport
dspportcnt
dspportq
dspportqs
dspportrscprtn
dspports
dspportstats
dspprf
dspprfhist
dspred
dsprscprtn
dsprscprtns
dspsarchans
dspsarcnt
dspsarcnts
dspserialif
dspservrate
dspshelfalm
dspslftst
dspslftsttbl
dspslotlink
dspsmcnf
dspsnmp
dspsrmclksrc
dspstatparms
dspswfunc
dspsysparm
dsptotals
dsptrafficgen
dsptrapip
dsptrapmgr
dsptrkcnf
dsptrkload
dsptrks
dspunit391
dspupgrade
dspusers
dspver
dspvismip
dth
dvsi
exit
formatdisk
help
history
ifShow
install
logout
ls
memShow
mkdir
modbert
moddsx3bert
mv
myid
newrev
pagemode
passwd
ping
printrev
pwd
remove
rename
resetcd
resetsys
restoreallcnf
rnmnd
routeShow
routestatShow
rstupgrade
runslftstno
saveallcnf
sesntimeout
shutdisk
softswitch
startdsx3bert
switchapsln
switchback
switchcc
syncdisk
timeout
tstcon
tstconseg
tstdelay
uncnfifastrk
upcon
upif
upport
users
version
who
whoami
xaddcon
xclrchancnt
xclrportcnt
xcnfalm
xcnfalmcnt
xcnfbert
xcnfdsx3bert
xcnfif
xcnfifip
xcnfilmi
xcnfln
xcnfport
xcnfportq
xcnfred
xcnfrscprtn
xcnfsrmlink
xcnftrapmgr
xdelcon
xdnport
xdspchan
xdspchancnt
xdspchans
xdspcon
xdspcons
xdspdsx3bert
xdspilmi
xdspln
xdsplns
xdspport
xdspportcnt
xdspportq
xdspportqs
xdspports
xdspred
xdspshelf
xdspsrmlink
xdsptrapmgr
xdspusers
xupport
MGX 8230 Command Line Interface
Introduction
The preferred tools for configuring, monitoring, and controlling an MGX 8230 multiservice gateway are the CiscoView and Cisco WAN Manager (CWM) applications for equipment management and connection management, respectively. (The Cisco WAN Manager application is the former Cisco StrataView Plus application with the equipment management removed.) The command line interface (CLI) also provides access to an MGX 8230 and is highly applicable during initial installation, troubleshooting, and any situation where low-level control is useful.
The MGX 8230 commands in the tables that follow are divided by major functional group. Each table shows the complete name of the command and the cards for which the command is valid. For further reference, check the Cisco MGX 8230 Multiservice Gateway Installation and Configuration reference document. This document provides conceptual information about how the Cisco MGX 8230 multiservice gateway can best implement network services in your network configuration.
The command line prompt shows the name of the MGX 8230, the number of the multiservice gateway (which is always "1"), the slot number and type of the current card, and whether the card is in the active ("a") or standby state ("s"). The following is an example of the command line prompt:
In this case, the current card is an active AUSM in slot 6, and the name of the node is "excel."
The command notation and argument parameters follow standard programming convention: a space separates the command and each parameter; variables have an italicized typeface; required arguments appear within "<>" marks; optional parameters appear within square brackets ("[ ]"); and a vertical bar (|) represents the logical OR function.
Note 
You must type all command arguments then press Return or Enter rather than enter one parameter at a time.
When you enter a command without parameters, a usage message appears. This message shows syntax and ranges for the applicable command parameters.
List of Commands
The list of commands for the common equipment cards PXM and SRM appear in Table 1-1. These commands are available when you log into the PXM. The node connectivity commands appear in Table 1-2. Applicable service module commands become available when you switch to a card by executing the cc command. The list of service module commands appear in Table 1-3. Many commands apply to both the common equipment cards and the service modules.
Table 1-1 PXM Commands
Command
|
Description
|
PXM Shelf Group
|
addtrapmgr
|
Add Trap Manager
|
agetrapmgr
|
Age Trap Manager
|
clrcderrs
|
Clear Card Errors in BRAM
|
clrmsgcnt
|
Clear Control Message Counter
|
cnfclksrc
|
Configure Network Clock Source
|
cnfstatsmgr
|
Configure Statistics Manager
|
cnftrapmgr
|
Configure/Add/Delete Trap Managers
|
deltrapmgr
|
Delete Trap Manager
|
dspcd
|
Display Card
|
dspcderrs
|
Display Card Errors in BRAM
|
dspcds
|
Display Cards
|
dspclksrc
|
Display Clock Sources
|
dspfwrevs
|
Display Firmware Revisions
|
dspmsgcnt
|
Display Control Message Counter
|
dspsarcnts
|
Display SAR Counters
|
dspsmcnf
|
Display Service Module Configuration
|
dspstatparms
|
Display Statistics Alarms
|
dsptrapmgr
|
Display Trap Manager
|
dsptrapmgrs
|
Display Trap Managers
|
resetcd
|
Reset Card
|
switchcc
|
Switch Core Cards
|
version
|
Version (displays version data for a card)
|
xcnftrapmgr
|
Configure Trap Manager
|
xdsptrapmgr
|
Display Trap Manager
|
PXM User Group
|
adduser
|
Add User
|
cc
|
Change Card
|
clrscrn
|
Clear Terminal Screen
|
clrlog
|
Clear Event/Message Log
|
cnfpwd
|
Configure Password
|
deluser
|
Delete User
|
dsplog
|
Display Event/Message Log
|
dspusers
|
Display Users
|
Help
|
Help (list of commands per card)
|
users
|
Users
|
PXM Node Group
|
cnfname
|
Configure Shelf Name
|
cnfdate
|
Configure Date
|
cnftime
|
Configure Time
|
cnftmzn
|
Configure Time Zone
|
cnftmzngmt
|
Configure Time Zone to GMT
|
cnfifip
|
Configure Interface IP Address
|
delifip
|
Delete Interface IP Address
|
dspifip
|
Display LAN interface IP
|
PXM Redundancy Group
|
addred
|
Add Redundancy
|
delred
|
Delete Redundancy
|
dspfeature
|
Display Feature
|
dspred
|
Display Redundancy
|
softswitch
|
Soft Switch
|
switchback
|
Switch Back
|
PXM Broadband Interface Group
|
addrscprtn
|
Add Resource Partition
|
clratmlncnt
|
Clear an ATM Line's Counters
|
clratmlncnts
|
Clear All ATM Line Counters
|
clrifcnt
|
Clear Counters for a Broadband Interface
|
clrifcnts
|
Clear All Counters for a Broadband Interface
|
cnfatmln
|
Configure ATM Line
|
cnfcdrscprtn
|
Configure Card Resource Partition
|
cnfif
|
Configure a Broadband Interface
|
cnfrscprtn
|
Configure Resource Partition
|
cnfsvclcn
|
Configure SVC LCNs
|
cnfsvcrange
|
Configure SVC Range
|
dnif
|
Disable the Broadband Interface
|
dspatmlncnf
|
Display ATM Line Configuration
|
dspcdrscprt
|
Display Card Resource Partition
|
dspcdrsctype
|
Display Card Resource Type
|
dspif
|
Display Interface
|
dspifcnt
|
Display Interface Count
|
dspifrsc
|
Display Interface Resource
|
dspifs
|
Display Interfaces
|
dsplnrsc
|
Display Line Resource
|
dsprscprtns
|
Display All Resource Partitions
|
dspsvcrange
|
Display SVC Range
|
upif
|
Add Broadband Interface on PXM
|
PXM Alarm Group
|
clralm
|
Clear Line Alarms
|
clralmcnt
|
Clear Alarm Counters/Statistics
|
dspalm
|
Display Alarms for a Line
|
dspalms
|
Display All Alarms on Card
|
dspalmcnf
|
Display Alarm Threshold Configuration
|
dspalmcnt
|
Display Alarm Counters/Statistics (line)
|
dspshelfalm
|
Display Shelf Alarms
|
PXM Line Group
|
addapsln
|
Add APS on a Line
|
addln
|
Add Line
|
delln
|
Delete Line
|
dspln
|
Display Line Configuration
|
dsplns
|
Display All Lines on Card
|
dspsrmlns
|
Display All Lines on Card
|
PXM Channel Group
|
clrsarcnt
|
Clear SAR Counters
|
dspsarcnt
|
Display SAR Counters
|
dspservrate
|
Display Service Rate
|
SRM-3T3 Group
|
addlink
|
Add SRM-3T3 T3 Link to T1 Slot and Line
|
clrsrmcnf
|
Clear SRM-3T3 Configuration
|
cnfsrmclksrc
|
Configure SRM-3T3 Clock Source
|
dellink
|
Delete SRM-3T3 T3 Link from T1 Slot and Line
|
delslotlnk
|
Delete Link from T1 Slot
|
dsplink
|
Display SRM-3T3 T3 Link to a T1 Slot and Line
|
dspslotlnk
|
Display Link in T1 Slot
|
dspsrmclksrc
|
Display SRM-3T3 Clock Source
|
PXM Self-Test Group
|
clrslftst
|
Clear Self-Test
|
dspslftsttble
|
Display Self-Test Table
|
PXM BERT Group
|
cnfbert
|
Configure BERT Session Parameters
|
delbert
|
Stop Current BERT Session
|
dspbert
|
Display Results of BERT Session
|
modbert
|
Inject Bit Errors into Current BERT Session
|
xcnfbert
|
Configure BERT Session Parameters
|
Table 1-2 Node Connectivity Commands
Command
|
Description
|
addtrk
|
Add Trunk
|
clrerr
|
Clear Error Log
|
cnfclksrc
|
Configure Clock Source
|
cnfcmparm
|
Configure Connection Manager Parameters
|
cnfifastrk
|
Configure Interface as Trunk
|
cnfname
|
Configure Node Name
|
cnfnwip
|
Configure Network IP Address
|
cnfswfunc
|
Configure Software Function
|
cnfsysparm
|
Configure System Parameters
|
cnftrk
|
Configure Trunk
|
deltrk
|
Delete Trunk
|
dncon
|
Down Connection
|
dspcmparm
|
Display Connection Manager Parameters
|
dspcon
|
Display a Connection
|
dspcons
|
Display Connections
|
dsperr
|
Display Error Log
|
dspload
|
Display Load
|
dspmnup
|
Display Mandatory Update Parameters
|
dspname
|
Display Nodename
|
dspnw
|
Display Network
|
dspnwcons
|
Display Network Connections
|
dspnwip
|
Display Network IP Address
|
dspswfunc
|
Display Software Functions
|
dspsysparm
|
Display System Parameters
|
dsptrkcnf
|
Display Trunk Configuration
|
dsptrkcons
|
Display Trunk Connections
|
dsptrkload
|
Display Trunk Load
|
dsptrkmcons
|
Display Trunk Management Connections
|
dsptrks
|
Display Trunks
|
uncnfifastrk
|
Unconfigure Interface Trunk
|
upcon
|
Up Connection
|
Table 1-3 Service Module (SM) Commands
Command
|
Description
|
FRSM
|
AUSM
|
CESM
|
CESM-T3E3
|
SM Shelf Group
|
clrcderrs
|
Clear Card Errors in BRAM
|
X
|
X
|
|
|
clrmsgcnt
|
Clear Control Message Counter
|
X
|
X
|
X
|
|
clrsmcnf
|
Clear Service Module Configuration
|
X
|
X
|
X
|
|
cnfcdrscprtn
|
Configure Card Resource Partition
|
X
|
X
|
|
|
cnfclksrc
|
Configure Network Clock Source
|
|
X
|
|
|
cnffst
|
Configure ForeSight
|
X
|
X
|
|
|
cnfsvcrange
|
Configure SVC Range
|
X
|
X
|
|
|
dspcd
|
Display Card
|
X
|
X
|
X
|
X
|
dspcderrs
|
Display Card Errors in BRAM
|
X
|
X
|
|
|
dspcdrscprtn
|
Display Card Resource Partition
|
X
|
X
|
|
|
dspclksrc
|
Display Clock Sources
|
|
X
|
|
|
dspmsgcnt
|
Display Control Message Counter
|
X
|
X
|
X
|
X
|
dspsmcnf
|
Display Service Module Configuration
|
|
|
|
X
|
dspstatparms
|
Display Statistics Parameters
|
X
|
|
|
|
dsptotals
|
Display Totals
|
X
|
|
|
X
|
resetcd
|
Reset Card
|
|
|
|
|
version
|
Version (displays card version data)
|
X
|
X
|
X
|
X
|
SM User Group
|
cc
|
Change Card
|
X
|
X
|
X
|
X
|
clrscrn
|
Clear Terminal Screen
|
X
|
X
|
X
|
X
|
dspmaptbl
|
Display Map Table
|
X
|
X
|
|
X
|
Help
|
Help (list of commands per card)
|
X
|
X
|
X
|
X
|
Alarm Group
|
clralm
|
Clear Line Alarms
|
X
|
X
|
X
|
X
|
clralmcnt
|
Clear Alarm Counters/Statistics
|
X
|
X
|
X
|
X
|
clralms
|
Clear All Alarms on the Card
|
X
|
X
|
X
|
X
|
dspalm
|
Display Alarms for a Line
|
X
|
X
|
X
|
X
|
dspalmcnf
|
Display Alarm Threshold Configuration
|
X
|
X
|
X
|
X
|
dspalmcnt
|
Display Alarm Counters/Statistics (line)
|
X
|
X
|
X
|
X
|
dspalms
|
Display All Alarms on Card
|
X
|
X
|
X
|
X
|
SM Line Group
|
addln
|
Add Line
|
X
|
X
|
X
|
X
|
addlnloop
|
Add Line Loop
|
|
X
|
X
|
X
|
cnfds3ln
|
Configure DS3 Line
|
X
|
|
|
|
cnfln
|
Configure Line
|
X
|
X
|
X
|
X
|
cnfplpp
|
Configure PLPP Parameters
|
|
X
|
|
|
delln
|
Delete Line
|
X
|
X
|
X
|
X
|
dellnloop
|
Delete Line Loop
|
|
X
|
X
|
X
|
dspds3ln
|
Display a DS3 Line
|
|
|
|
|
dspds3lns
|
Display DS3 Lines
|
|
|
|
|
dspln
|
Display Line Configuration
|
X
|
X
|
X
|
X
|
dsplns
|
Display All Lines on Card
|
X
|
X
|
X
|
X
|
Port Group
|
addport
|
Add Port
|
X
|
|
|
X
|
clrportcnt
|
Clear Port Counters
|
X
|
X
|
|
|
clrportcnts
|
Clear All Port Counters
|
X
|
X
|
|
|
cnfegrq
|
Configure Egress Queue
|
X
|
|
|
|
cnfilmi
|
Configure ILMI
|
|
X
|
|
|
cnfport
|
Configure FR Port(s)
|
X
|
X
|
|
|
cnfportcllm
|
Configure Port CLLM Parameters
|
X
|
|
|
X
|
cnfportq
|
Configure AUSM Port Queue
|
|
X
|
|
|
copyports
|
Copy Port Configuration
|
X
|
X
|
|
|
delport
|
Delete FRSM or AUSM Port
|
X
|
|
|
|
delports
|
Delete Port Configurations
|
X
|
X
|
|
X
|
dnport
|
Down Port
|
|
X
|
|
X
|
dspegrq
|
Display Egress Queue
|
|
|
|
|
dspegrqs
|
Display Egress Queues
|
|
|
|
|
dspilmi
|
Display ILMI
|
|
X
|
|
|
dspilmicnt
|
Display ILMI Counters
|
|
X
|
|
|
dspport
|
Display Port Configuration
|
X
|
X
|
|
|
dspportcnt
|
Display FR Port Counters
|
X
|
X
|
|
|
dspportq
|
Display Port Queue
|
|
X
|
|
|
dspportqs
|
Display Port Queues
|
|
X
|
|
|
dspports
|
Display All Ports
|
X
|
X
|
|
|
dspportstats
|
Display Port Statistics
|
X
|
|
|
|
upport
|
Up Port
|
|
X
|
|
|
SM Channel Group
|
addchan
|
Add Channel
|
X
|
|
X
|
X
|
addchanloop
|
Add a Channel Loopback
|
X
|
X
|
X
|
|
clrchancnt
|
Clear Channel Counter for FRSM or AUSM Channels
|
X
|
X
|
X
|
X
|
clrsarcnts
|
Clear SAR Counters
|
X
|
X
|
X
|
|
cnfchancaoff
|
Configure Channel Admission Control Off
|
X
|
|
|
|
clrchancnts
|
Clear Channel Counter for All FR Channels
|
X
|
X
|
X
|
|
cnfchanegressq
|
Configure Channel Egress Queue
|
X
|
|
|
|
cnfchanfst
|
Configure Channel ForeSight
|
X
|
X
|
|
|
cnfchaningressq
|
Configure Channel Ingress Queue
|
|
|
|
X
|
cnfchanmap
|
Configure Channel Map
|
X
|
X
|
X
|
|
cnfchanpol
|
Configure Channel Policing
|
X
|
|
|
|
cnfchanq
|
Configure Channel Queue
|
|
X
|
|
X
|
copychans
|
Copy Channel Configurations
|
X
|
X
|
|
X
|
delchan
|
Delete Channel(s)
|
X
|
|
X
|
X
|
delchanloop
|
Delete a Channel Loopback
|
X
|
X
|
X
|
|
delchans
|
Delete Channels
|
X
|
X
|
|
X
|
dspchan
|
Display Channel Configuration
|
X
|
|
X
|
X
|
dspchancnt
|
Display Channel Counters
|
X
|
X
|
X
|
X
|
dspchans
|
Display All Channels
|
X
|
|
X
|
|
dspchstats
|
Display Channel Statistics
|
X
|
|
|
|
dspsarcnt
|
Display SAR Counters
|
X
|
X
|
X
|
|
SM Connection Group
|
addcon
|
Add Connection
|
|
X
|
|
|
cnfupcabr
|
Configure UPC for ABR
|
|
X
|
|
|
cnfupccbr
|
Configure UPC for CBR
|
|
X
|
|
|
cnfupcubr
|
Configure UPC for UBR
|
|
X
|
|
|
cnfupcvbr
|
Configure UPC for VBR
|
|
X
|
|
|
delcon
|
Delete Connection
|
|
X
|
|
|
dspcon
|
Display a Connection
|
|
X
|
|
|
dspcons
|
Display Connections
|
|
X
|
|
|
dsploads
|
Display Loads
|
|
X
|
|
|
tstcon
|
Test Connection
|
X
|
X
|
X
|
X
|
tstconseg
|
Test Connection Segment
|
|
X
|
|
|
SM Self-Test Group
|
clrslftst
|
Clear Self-Test
|
X
|
X
|
X
|
X
|
dspslftsttble
|
Display Self-Test Table
|
X
|
X
|
X
|
X
|
SM BERT Group
|
acqdsx3bert
|
Acquire BERT
|
X
|
|
X
|
|
clrbertcntrs
|
Remove BERT Counters
|
X
|
|
X
|
|
cnfdsx3bert
|
Configure BERT Parameters
|
X
|
|
X
|
|
deldsx3bert
|
Stop BERT Test Session
|
X
|
|
X
|
|
dspdsx3bert
|
Display BERT Results
|
X
|
|
X
|
|
moddsx3bert
|
Inject Bit Errors into BERT Session
|
X
|
|
X
|
|
startdsx3bert
|
Begin BERT Session
|
X
|
|
X
|
|
xcnfdsx3bert
|
Configure BERT Parameters
|
X
|
|
X
|
|
xdspdsx3bert
|
Display BERT Results
|
X
|
|
X
|
|
IMA Group
|
addimagrp
|
Set Up New IMA Group
|
|
X
|
|
|
addlns2imagrp
|
Add Lines to IMA Group
|
|
X
|
|
|
clrimagrpcnt
|
Delete IMA Group Counters
|
|
X
|
|
|
clrimalncnt
|
Delete Line Counters of IMA Group
|
|
X
|
|
|
clrimatst
|
Stop IMA Group Test
|
|
X
|
|
|
cnfimaalmparm
|
Configure IMA Group Alarm Parameters for IMA Group
|
|
X
|
|
|
cnfimagrp
|
Configure IMA Group
|
|
X
|
|
|
cnfimatst
|
Configure Testing for IMA Group
|
|
X
|
|
|
delimagrp
|
Remove IMA Group
|
|
X
|
|
|
delnsfmimagrp
|
Remove Lines from IMA Group
|
|
X
|
|
|
dspimaalmparm
|
Display IMA Alarm Parameters
|
|
X
|
|
|
dspimagrp
|
Display IMA Group Configuration
|
|
X
|
|
|
dspimagrpcnt
|
Display Current IMA Group Counters
|
|
X
|
|
|
dspimagrps
|
Display All IMA Groups
|
|
X
|
|
|
dspimaln
|
Display IMA Group Line
|
|
X
|
|
|
dspimalncnt
|
Display Line Counters of IMA Group
|
|
X
|
|
|
dspimatst
|
Display IMA Group Test Parameters
|
|
X
|
|
|
?
Help
Use the ? command to view all commands associated with the current card, and to view a list of commands associated with a truncated command entry.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM
Syntax
? [command]
Syntax Description
command
|
Full or partial name of the command.
|
Related Commands
help
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Examples
This section contains the following examples:
•View all commands associated with a partial command entry string
•View all commands associated with the current card
Example 1-1 View all commands associated with a partial command entry string
raviraj.1.1.PXM.a > ? con
Example 1-2 View all commands associated with the current card
System response for the ? command is identical to that when executing the help command. See the examples in the help section beginning on page 465.
abort
Abort
Use the abort command to stop the upgrade process and return to the previous firmware version.
•Using abort after a newrev returns the PXM to the original firmware image.
•Using abort after install resets the PXM(s) to their original states.
See Figure 1-1 to see the relationship of the abort command compared with other firmware commands.
Figure 1-1 Firmware-Related Commands
Card(s) on Which This Command Executes
PXM
Syntax
abort <version>
Syntax Description
version
|
Original firmware version.
|
A system response does not occur unless an error is detected.
Related Commands
dspupgrade, rstupgrade, newrev, dspfwrevs, printrev, commit, copy, install
Attributes
Log: No
|
State: Active
|
Privilege: Any
|
Example 1-3 Abort loading firmware 1.1.10
NODENAME.1.1.PXM.a > abort 1.1.10
this may take a while ...
abort command completed ok
This card will be reset, the other will become active.
Example 1-4 Display errors loading firmware (multiple cases)
NODENAME.1.2.PXM.a > abort 1.1.11
cannot be in 'upgrade idle', must be in 'upgrade' or 'upgrade
ERR: command "abort" failed
NODENAME.1.1.PXM.a > abort 1.1.11
1.1.11 is not the old version 1.1.10aa
ERR: command "abort" failed
acqdsx3bert
Acquire DS3 BERT
Use the acqdsx3bert command to find out if a bit error rate test (BERT) session already exists on the selected MGX 8230 bay.
Card(s) on Which This Command Executes
FRSM 2CT3, CESMT3
Syntax
acqdsx3bert
Related Commands
cnfdsx3bert, dspdsx3bert, moddsx3bert, startdsx3bert, xcnfdsx3bert, xdspdsx3bert
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-5 Acquire current BERT session
NODENAME1.1.4.FRSM2CT3.a > acqdsx3bert
NODENAME1.1.4.FRSM2CT3.a >
addapsln
Add APS to a Line
Use the addapsln command to set Automatic Protection Switching (APS) on a specified line for the current PXM.
APS is a SONET switching mechanism that routes traffic from working lines to protect them in case of a line card failure or fiber cut.
To set APS parameters, use the cnfapsln command following the addapsln command.
Card(s) on Which This Command Executes
PXM
Syntax
addapsln <workline> <workslot> <protectline> <protectslot> <archmode>
Syntax Description
workline
|
OC-3 or OC-12 line number on which to set APS.
•OC-3 range = 1-4
•OC-12 = 1
|
workslot
|
Slot number of the PXM, either 1 or 2.
|
protectline
|
Protection line number.
•OC-3 range = 1-4
•OC-12 = 1
|
protectslot
|
Protection slot number, either 1 or 2.
|
archmode
|
APS architect mode to be used on the working/protection line pairs:
•1 = 1+1 one back card
•2 = 1+1 two back cards
•3 = 1:1 one back card
•4 = 1+1 Annex B
|
Related Commands
cnfapsln, delapsln, dspapsln, switchapsln
Attributes
Log: Yes
|
State: Active
|
Privilege: SuperUser
|
Example 1-6 Add APS Protection line 1 on slot 2 to APS Working line1 on slot 1. Set the APS architect mode on the working/protection line pair to 1+1.
spirit4.1.2.PXM.a > addapsln 1 2 1 1 2
addaimgrp
Add IMA Group
Use the addaimgrp command to set an AIMUX group on the current AUSM.
Card(s) on Which This Command Executes
AUSM
Syntax
addaimgrp <group_num> <port_type> <list_of_links> <minNumLinks>
Syntax Description
group_num
|
AIMUX group number, in the range 1-8.
|
port_type
|
UNI or NNI port type.
•1 = UNI
•2 = NNI
|
list_of_links
|
List of physical lines, in the range 1-8, to be included in "aimux_grp." Type a period (.) between each line in the string to delineate each member of the AIMUX group.
|
minNumLinks
|
Minimum number of links for the group formation, in the range 1-8.
|
Related Commands
delaimgrp, cnfaimgrp, dspaimgrp, dspaimgrps
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 1
|
Example 1-7 Add IMA group 2 as UNI with lines 3, 4, and 5
spirit4.1.3.AUSM.a > addaimgrp 2 3.4.5
A system response does not occur unless an error is detected. Possible errors include:
•Parameters are illegal or invalid.
•IMA group already exists.
•A line is not enabled.
•All lines are not in local mode.
addcdrscprtn
Add Card Resource Partition
Use the addcdrscprtn command to set card-level resource partitions.
Note This command applies only if the card partition type is controllerBased.
The resource you can partition at the card level is the number of connections available to a network controller.
With card-level partitioning:
•The number of connections available at each port is the same.
•You can specify the number of connections available to each controller or let them compete for connections at each port.
Table 1-4 describes the effects of each of three usages of addcdrscprtn.
Table 1-4 Degrees of Card-Level Resource Partitioning
Command
|
Description
|
addcdrscprtn off
|
Card-level partitioning is inactive. You must partition resources at the port level. (See also cnfcdrscprtn.)
|
addcdrscprtn on
|
Default.
Card-level partitioning is on, but no allocation for a specific controller is specified. The maximum number of connections on a port is available to each controller. Each controller therefore competes for the connections.
|
addcdrscprtn on <x> <y> <z>
|
Same as addcdrscprtn, except x, y, and z represent the number of connections per port available to the PAR, PNNI, and Tag controllers, respectively.
|
In addition to the definitions in Table 1-4, note the following characteristics of this command:
•If you specify that card-level partitioning is off (addcdrscprtn off), port-level partitioning is mandatory (cnfportrscprtn).
•If you do not execute addcdrscprtn, the default state of addcdrscprtn on is in effect.
•If you specify card-level partitioning (addcdrscprtn on x y z), port-level partitioning (cnfportrscprtn) is an option you can use to further modify the partitioning on a port.
Card(s) on Which This Command Executes
PXM, FRSM, CESM
Syntax: PXM
addcdrscprtn <ctrlr_num> <num_lcns>
Syntax Description
ctrlr_num
|
Controller type.
•1 = PAR
•2 = PNNI
•3 = TAG
|
num_lcns
|
Number of available global logical connection numbers (GLCNs), in the range 0-32767.
|
Syntax: FRSM
addcdrscprtn <controller> <numOfLcnAvail>
Syntax Description
controller
|
Controller type.
•1 = PAR/PVC
•2 = PNNI/SPVC
•3 = TAG
|
numOfLcnAvail
|
Maximum number of LCNs, in the range appropriate for the card.
•2CT3 range = 1-4000
•2T3 range = 1-2000
•2E3 range = 1-2000
•HS2 range = 1-2000
|
Syntax: CESM
addcdrscprtn <controller> <numOfLcnAvail>
Syntax Description
controller
|
Controller type.
•1 = PAR/PVC
•2 = PNNI/SPVC
•3 = TAG
|
numOfLcnAvail
|
Maximum number of LCNs, in the range 0-248.
|
Related Commands
cnfcdrscprtn, dspcdrscprtn, delcdrscprtn
Attributes
Log: Yes
|
State: Any (Active for PXM)
|
Privilege: Any
|
Example 1-8 On current PXM, change card-level partitioning to give 10000 GLCNs to PAR and 10000 GLCNs to Tag. Note that the value for PNNI currently is 0.
spirit4.1.2.PXM.a > addcdrscprtn 10000 0 10000
addchan
Add Channel
Use the addchan command to configure channels on the current PXM, FRSM, AUSM, or CESM. The syntax for using addchan on an AUSM differs from that used on all other cards. See Syntax: AUSM for guidelines.
Card(s) on Which This Command Executes
PXM, FRSM (8T1/E1, HS1/B, VHS), AUSM, CESM
Syntax: PXM
addchan <LCN> <if_num> <conn_type> <vpi> <vci> <serv_type> <y_vpi> <y_vci> <y_nsap> <chan_master>
Syntax Description
LCN
|
Logical connection number, in the range 16-4111.
|
if_num
|
Number of the logical interface port that receives connection traffic, in the range 1-32.
|
conn_type
|
Virtual path connection (VPC) or virtual channel connection (VCC).
•1 = VPC
•2 = VCC
|
vpi
|
Virtual path identifier (VPI) value, in the range 0-4095.
|
vci
|
Virtual channel identifier (VCI) value, in the range 0-65535.
|
serv_type
|
Service type.
•1 = CBR (constant bit rate)
•2 = VBR (variable bit rate)
•3 = ABR (available bit rate)
•4 = UBR (unspecified bit rate)
•5 = VBR-RT (variable bit rate—real-time class)
|
y_vpi
|
Remote VPI value, in the range 0-4095.
|
y_vci
|
Remote VCI value, in the range 0-65535.
|
y_nsap
|
Remote Network Service Access Point (NSAP) value, in the format node.slot.port. An NSAP is the point at which OSI Network Service is made available to a transport layer (Layer 4) entity.
|
chan_master
|
Status of local endpoint, either master or slave.
•1 = master
•2 = slave
|
Syntax: FRSM-8T1/E1
addchan <chan> <port> <dlci> <cir> <chan_type> [CAC] <mastership> <locnsap> <rmtvpi> <rmtvci> <rmtnsap>
Syntax Description
chan
|
Channel number, in the range 16-1015.
|
port
|
Port number for T1 or E1.
•T1 range = 1-192
•E1 range = 1-248
|
dlci
|
Data-link connection identifier (DLCI) value, in the range 0-1023.
|
cir
|
Committed information rate (CIR) value for T1 bps or E1 bps.
•T1 range = 0-1536000
•E1 range = 0-204800
|
chan_type
|
Channel type.
•1 = NIW
•2 = SIW-transparent
•3 = SIW-translation
•4 = FUNI
•5 = frame forwarding
|
CAC
|
Connection admission control (CAC), either enabled or disabled.
•1 = enable
•2 = disable (default)
|
mastership
|
Status of current end, either master or slave.
•1 = master
•2 = slave
|
locnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node name, slot, and port in NSAP format.
|
rmtvpi
|
Remote virtual path identifier (VPI) value, in the range 1-65535.
|
rmtvci
|
Remote virtual channel identifier (VCI) value, in the range 1-65535.
|
rmtnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port in NSAP format.
|
Syntax: FRSM-HS1/B
addchan <chan_num> <port_num> <dlci_num> <cir> <chan_type> [CAC] <mastership> <locnsap> <rmtvpi> <rmtvci> <rmtnsap>
Syntax Description
chan_num
|
Channel number, in the range 16-1015.
|
port_num
|
Port number, in the range appropriate for the interface.
•X.21 range = 1-4
•HSSI range = 1-2
|
dlci_num
|
Data-link connection identifier (DLCI) value, in the range 0-1023.
|
cir
|
Committed information rate (CIR) value, in the range appropriate for the interface.
•X.21 range = 0-10000000 bps
•HSSI range = 0-20000000 bps
|
chan_type
|
Channel type.
•1 = NIW
•2 = SIW-transparent
•3 = SIW-translation
•4 = FUNI
•5 = frame forwarding
|
CAC
|
Connection admission control (CAC), either enabled or disabled.
•1 = enable
•2 = disable (default)
|
mastership
|
Status of current end, either master or slave.
•1 = master
•2 = slave
|
locnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node name, slot, and port in NSAP format.
|
rmtvpi
|
Remote virtual path identifier (VPI) value, in the range 1-65535.
|
rmtvci
|
Remote virtual channel identifier (VCI) value, in the range 1-65535.
|
rmtnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port in NSAP format.
|
Possible errors include:
•Parameters are illegal or invalid.
•The channel already exists.
•The port might not be up.
Syntax: FRSM-VHS
addchan <chan> <port> <dlci> <cir> <chan_type> <serv_type> [CAC_enable] <mastership> <locnsap> <rmtvpi> <rmtvci> <rmtnsap>
Syntax Description
chan
|
Channel number, in the range 16-4015.
|
port
|
Port number, in the range 1-256.
|
dlci
|
Data-link connection identifier (DLCI) value, in the range 0-1023.
|
cir
|
Committed information rate (CIR) value for T1 bps or E1 bps.
•T1 range = 0-1536000
•E1 range = 0-2048000
|
chan_type
|
Channel type.
•1 = NIW
•2 = SIW-transparent
•3 = SIW-translation
•4 = FUNI
•5 = frame forwarding
|
serv_type
|
Service type.
•1 = CBR (constant bit rate)
•2 = VBR (variable bit rate)
•3 = ABR (available bit rate)
•4 = UBR (unspecified bit rate)
|
CAC_enable
|
Connection admission control (CAC), either enabled or disabled.
•1 = enable
•2 = disable (default)
|
mastership
|
Status of current end, either master or slave.
•1 = master
•2 = slave
|
locnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node name, slot, and port in NSAP format.
|
rmtvpi
|
Remote virtual path identifier (VPI) value, in the range 1-65535.
|
rmtvci
|
Remote virtual channel identifier (VCI) value, in the range 1-65535.
|
rmtnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port in NSAP format.
|
Syntax: AUSM
addchan <channel number> <connection type> <port number> <vpi> <vci> <service type> <mastership> <locnsap> <rmtvpi> <rmtvci> <rmtnsap>
Syntax Description
channel number
|
Channel number, in the range 16-1015.
|
connection type
|
Connection type, either virtual path connection (VPC) or virtual channel connection (VCC).
•1 = VPC
•2 = VCC
|
port number
|
Port number, in the range 1-8.
|
vpi
|
Virtual path identifier (VPI) value, in the range 0-255.
|
vci
|
Virtual channel identifier (VCI) value, in the range 0-65535.
|
service type
|
Service type.
•1 = CBR (constant bit rate)
•2 = VBR (variable bit rate)
•3 = ABR (available bit rate)
•4 = UBR (unspecified bit rate)
|
mastership
|
Status of current end, either master or slave.
•1 = master
•2 = slave
•3 = unknown
|
locnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node name, slot, and port in NSAP format.
|
rmtvpi
|
Remote VPI value, in the range 1-255.
|
rmtvci
|
Remote VCI value, in the range 1-65535. This setting should be identical to that for the logical port number of the remote endpoint.
|
rmtnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port in NSAP format.
|
Example 1-9 Add a VCC connection to channel 16 on port 1 with vpi=1, vci=1, ABR service type, and an egress queue number of 1
spirit4.1.18.AUSM.a > addchan 16 2 1 1 1 3 1
spirit4.1.18.AUSM.a >
Syntax: CESM-8T1E1
addchan <chan_num> <port_num> <sig_type> <partial_fill> <cond_data> <cond_signal> [mastership | locnsap | rmtvpi | rmtvci | rmtnsap]
Syntax Description
chan_num
|
Channel number, in the range 32-279.
|
port_num
|
Port number for T1 or E1.
•T1 range = 1-192
•E1 range = 1-248
|
sig_type
|
Type of signalling to be used. All channels on a line should have the same value.
•1 = basic
•2 = E1 CAS
•3 = DS1 superframe CAS
•4 = DS1 extended superframe CAS
•6 = conditioned E1 CAS
•7 = 1x64 basic without AAL1 pointer
|
partial_fill
|
Number of bytes to partially fill a cell for different lines.
•0 = a fully filled cell (default)
•20-47 = cells for structured E1
•25-47 = for structured T1
•33-47 = for unstructured T1 or E1
|
cond_data
|
Data-conditioning, either UDT or SDT.
•UDT = 255
•SDT range = 0-255
|
cond_signal
|
Condition signal, in the range 0-15.
|
mastership
|
Status of current end, either master or slave.
•1 = master
•2 = slave (default)
|
locnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node name, slot, and port in NSAP format.
|
rmtvpi
|
Remote virtual path identifier (VPI) value, in the range 1-65535.
|
rmtvci
|
Remote virtual channel identifier (VCI) value, in the range 1-65535.
This setting should be identical to that for the logical port number of the remote endpoint.
|
rmtnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port in NSAP format.
|
Possible errors include:
•Parameters are illegal or invalid.
•The channel already exists.
•The port might not be up.
Syntax: CESM-T3E3
addchan <chan_num> <port_num> <cond_sig> <mastership> <locnsap> <rmtvpi> <rmtvci> <rmtnsap>
Syntax Description
chan
|
Channel number. Enter the value 32.
|
port
|
Port number. Enter the value 1.
|
cond_sig
|
Condition signal number, in the range 0-15.
|
mastership
|
Status of the current end, either master or slave.
•1 = master
•2 = slave
|
locnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node name, slot, and port in NSAP format.
|
rmtvpi
|
Remote virtual path identifier (VPI) value, in the range 1-65535.
|
rmtvci
|
Remote virtual channel identifier (VCI) value, in the range 1-65535.
This setting should be identical to that for the logical port number of the remote endpoint.
|
rmtnsap
|
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port in NSAP format.
|
A system response does not occur unless an error is detected. Possible errors include:
•Parameters are illegal or invalid.
•The channel already exists.
•The port might not be up.
Related Commands
delchan, dspchan, dspchans
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 2
|
addchanloop
Add a Channel Loopback
Use the addchanloop command to configure a channel loopback to the current FRSM or AUSM card. This command causes the channel to loop at the segmentation and reassembly (SAR) stage.
Card(s) on Which This Command Executes
FRSM, AUSM
Syntax: FRSM
addchanloop <chan_num>
Syntax Description
chan_num
|
Channel number to be used for the loopback on the current card.
•8T1/E1 range = 16-1015
•HS1/B range = 16-1015
•T3/E3/HS2 range = 16-2015
•2CT3 range = 16-4015
|
Syntax for AUSM-8T1E1
addchanloop <port.VPI.VCI | ChanNum>
Syntax Description
port.VPI.VCI
|
Port range = 1-N, as appropriate for the physical installation.
Virtual path identifier (VPI) range = 1-4095.
Virtual channel identifier (VCI) range = 1-65535.
|
ChanNum
|
Channel number, in the range 16-1015.
|
Related Commands
delchanloop, tstcon, tstdelay
Attributes
Log: No
|
State: Active
|
Privilege: Group 4
|
Example 1-10 Add channel loopback onto channel number 21
s1.1.12.AUSMB8.a > addchanloop 21
Example 1-11 Add channel loopback onto port 2, VPI 1, VCI 1
s1.1.12.AUSMB8.a > addchanloop 2.1.1
addcon
Add Connection
Use the addcon command to configure connectivity to the current card. The addcon command is preferable to addchan for adding a connection because addcon does not require the NSAP addresses.
Command execution includes a specification of the endpoint as either the master or the slave. Execute addcon first at the slave end, then the master end. Note the syntax for the master end includes a parameter SlaveConID. Rather than a single number, SlaveConID is the node name, slot number, port number, and connection identifier (if applicable) of the slave end.
Note To set up a three-segment connection across a network, specify the PXM as slot 0.
Card(s) on Which This Command Executes
PXM, FRSM, CESM, AUSM
Syntax: PXM
addcon <port_no> <conn_type> <local_VPI> <local_VCI> <service> [CAC] [mastership] [remoteConnId]
Syntax Description
port_no
|
Port number, in the range 1-32.
|
conn_type
|
Virtual path connection (VPC) or virtual channel connection (VCC).
•1 = VPC
•2 = VCC
|
local_VPI
|
Local virtual path identifier (VPI), in the range 0-4095.
|
local_VCI
|
Local virtual channel identifier (VCI), in the range 0-65535.
|
service
|
Type of service.
•1 = CBR (constant bit rate)
•2 = VBR (variable bit rate)
•3 = ABR (available bit rate)
•4 = UBR (unspecified bit rate)
|
CAC
|
Connection admission control (CAC).
•1 = enable
•2 = disable (default)
|
mastership
|
Status of the current end, either master or slave.
•1 = master (You must also set remoteConnId for the master.)
•2 = slave (default)
|
remoteConnId
|
Remote connection identifier, in the format NodeName.SlotNo.PortNo.VPI.VCI.
|
Syntax: FRSM-8T1/8E1
addcon <port number> <DLCI> <CIR> <channel type> [Adm_cntrl] <controller_type> [mastership] <RemoteEndConID>
Syntax Description
port number
|
Port number for T1 or E1.
•T1 range = 1-192
•E1 range = 1-248
|
DLCI
|
Data-link connection identifier (DLCI) value in the range 0-1023.
|
CIR
|
Committed information rate (CIR) value for T1 bps or E1 bps.
•T1 range = 0-1536000
•E1 range = 0-2048000
|
channel type
|
Type of connection to be used on the channel.
•1 = NIW (network interworking)
•2 = SIW-transparent (service interworking without any SDU translation)
•3 = SIW-translation (service interworking with SDU translation)
•4 = FUNI (Frame Relay UNI)
•5 = frame forwarding
|
Adm_cntrl
|
Connection admission control (CAC), either enabled or disabled.
•1 = enable CAC
•2 = disable CAC (default)
|
controller_type
|
Signalling controller type, either PVC or SPVC.
•1 = PVC (PAR) (default)
•2 = SPVC (PNNI)
|
mastership
|
Status of the connection, either master or slave.
•1 = master
•2 = slave (default)
|
RemoteEndConID
|
Node name, slot number, port number, and DLCI.
or
Node name, slot number, port number, Controller ID, and DLCI for a Frame Relay endpoint. Use one of the following values to set controller type:
•1 = PAR
•2 = PNNI
•3 = TAG
or
Node name, slot number, port number, and VPI.VCI for an ATM endpoint.
|
A system response does not occur unless an error is detected. Possible errors include:
•Parameters are illegal or invalid.
•The channel already exists.
•The port might not be up.
Syntax: FRSM-2CT3
addcon <port number> <DLCI> <CIR> <channel type> <egress service type> [Adm_cntrl] <controller_type> <mastership> <RemoteEndConID>
Syntax Description
port number
|
Port number in the range 1-256.
|
DLCI
|
Data-link connection identifier (DLCI) value, in the range 0-1023.
|
CIR
|
Committed information rate (CIR) bps value, in the range 0-1536000.
|
channel type
|
Type of connection on this channel.
•1 = NIW (network interworking)
•2 = SIW-transparent (service interworking without any SDU translation)
•3 = SIW-translation (service interworking with SDU translation)
•4 = FUNI (Frame Relay UNI)
•5 = frame forwarding
|
egress service type
|
Type of egress service provided on this channel.
•1 = highpriorityQ (typically committed bit rate connections)
•2 = rtVBRQ (real-time variable bit rate connections)
•3 = nrtVBRQ (non-real-time variable bit rate connections)
•4 = aBRQ (available bit rate connections)
•5 = uBRQ (unspecified bit rate connections)
|
Adm_cntrl
|
Connection admission control (CAC), either enabled or disabled.
•1 = enable CAC
•2 = disable CAC (default)
|
controller_type
|
Signalling controller type, either PVC or SPVC.
•1 = PVC (PAR) (default)
•2 = SPVC (PNNI)
|
mastership
|
Status of connection, either master or slave.
•1 = master
•2 = slave (default)
|
RemoteEndConID
|
Node name, slot number, port number, and DLCI.
or
Node name, slot number, port number, Controller ID, and DLCI for a Frame Relay endpoint. Use one of the following values to set controller type:
•1 = PAR
•2 = PNNI
•3 = TAG
or
Node name, slot number, port number, and VPI.VCI for an ATM endpoint.
|
Syntax: FRSM-2T3/2E3
addcon <port number> <DLCI> <CIR> <channel type> <egress service type> [Adm_cntrl] <controller_type> <mastership> <RemoteEndConID>
Syntax Description
port number
|
Port number in the range 1-2.
|
DLCI
|
Data-link connection identifier (DLCI) value in the range 0-1023.
|
CIR
|
Committed information rate (CIR) bps value for 2T3 or 2E3.
•2T3 range = 0-44210000
•2E3 range = 0-34010000
|
channel type
|
Type of connection on this channel.
•1 = NIW (network interworking)
•2 = SIW-transparent (service interworking without any SDU translation)
•3 = SIW-translation (service interworking with SDU translation)
•4 = FUNI (Frame Relay UNI)
•5 = frame forwarding
|
egress service type
|
Type of egress service provided on this channel.
•1 = highpriorityQ (typically committed bit rate connections)
•2 = rtVBRQ (real-time variable bit rate connections)
•3 = nrtVBRQ (non-real-time variable bit rate connections)
•4 = aBRQ (available bit rate connections)
•5 = uBRQ (unspecified bit rate connections)
|
Adm_cntrl
|
Connection admission control (CAC), either enabled or disabled.
•1 = enable CAC
•2 = disable CAC (default)
|
controller_type
|
Signalling controller type, either PVC or SPVC.
•1 = PVC (PAR) (default)
•2 = SPVC (PNNI)
|
mastership
|
Status of connection, either master or slave.
•1 = master
•2 = slave (default)
|
RemoteEndConID
|
Node name, slot number, port number, and DLCI.
or
Node name, slot number, port number, Controller ID, and DLCI for a Frame Relay endpoint. Use one of the following values to set controller type:
•0 = PAR
•1 = PNNI
•2 = TAG
or
Node name, slot number, port number, and VPI.VCI for an ATM endpoint.
|
Syntax: FRSM-HS2
addcon <port number> <DLCI> <CIR> <channel type> <egress service type> [Adm_cntrl] <controller_type> <mastership> <RemoteEndConID>
Syntax Description
port number
|
Port number, in the range 1-2.
|
DLCI
|
Data-link channel identifier (DLCI) value, in the range 0-1023.
|
CIR
|
Committed information rate (CIR) bps value, in the range 0-51840000.
|
channel type
|
Type of connection on this channel.
•1 = NIW (network interworking)
•2 = SIW-transparent (service interworking without any SDU translation)
•3 = SIW-translation (service interworking with SDU translation)
•4 = FUNI (Frame Relay UNI)
•5 = frame forwarding
|
egress service type
|
Type of egress service provided on this channel.
•1 = highpriorityQ (typically committed bit rate connections)
•2 = rtVBRQ (real-time variable bit rate connections)
•3 = nrtVBRQ (non-real-time variable bit rate connections)
•4 = aBRQ (available bit rate connections)
•5 = uBRQ (unspecified bit rate connections)
|
Adm_cntrl
|
Connection admission control (CAC), either enabled or disabled.
•1 = enable CAC
•2 = disable CAC (default)
|
controller_type
|
Signalling controller type, either PVC or SPVC.
•1 = PVC (PAR) (default)
•2 = SPVC (PNNI)
|
mastership
|
Status of the connection, either master or slave.
1 = master
2 = slave (default)
|
RemoteEndConID
|
Node name, slot number, port number, and DLCI.
or
Node name, slot number, port number, Controller ID, and DLCI for a Frame Relay endpoint. Use one of the following values to set controller type:
•0 = PAR
•1 = PNNI
•2 = TAG
or
Node name, slot number, port number, and VPI.VCI for an ATM endpoint.
|
Syntax: AUSM
addcon slave | master <port number> <vpi> <vci> <Conn type> <Service Type>
Syntax Description
slave | master
|
Associates the AUSM port with either master or slave status.
|
port number
|
Port number, in the range 1-8.
|
vpi
|
Virtual path identifier (VPI) value, in the range 0-255.
|
vci
|
Virtual channel identifier (VCI) value, in the range 0-65535.
|
Conn type
|
Type of connection.
•0 = VCC connection
•non-zero = Local connection
VP ID of the VPC—1 to 20 (UNI)/100 (STI)/340 (NNI)
|
Service Type
|
Service type.
•1 = CBR (constant bit rate)
•2 = VBR (variable bit rate)
•3 = ABR (available bit rate)
•4 = UBR (unspecified bit rate)
|
SlaveConID
|
Used only for master configuration:
Node name, slot number, port number, VCI, and VPI of the slave end.
|
Example 1-12 Add a VCC connection to channel 16 on port 2 with vpi=1, vci=1, ABR service type, and an egress queue number of 1
spirit4.1.12.AUSM.a > addcon 16 2 1 1 1 3 1
spirit4.1.12.AUSM.a >
A system response does not occur unless an error is detected. Possible errors include:
•Parameters are illegal or invalid.
•The channel already exists.
•The port might not be up.
Syntax: CESM 8T1/E1
addcon <port_num> <sig_type> <partial_fill> <cond_data> <cond_signalling> [controller_type] [mastership] [RemoteEndConID]
Syntax Description
port_num
|
Port number for T1 or E1 interface.
•1-192 = T1 range
•1-248 = E1 range
|
sig_type
|
Channel associated signalling (CAS) value.
•1 = basic
•2 = E1 CAS
•3 = DS1 superframe CAS
•4 = DS1 extended superframe CAS
•6 = conditioned E1 CAS
•7- 1x64 basic without AAL1 pointer
|
partial_fill
|
Number of bytes to set cell fills, as associated with line types.
•Partial fill, in the range 0-47. Enter the value either 0 or 47 to set this parameter for fully filled cells.
•Structured T1, in the range 25-47.
•Structure E1, in the range 20-47.
•Unstructured T1/E1, in the range 33-47.
|
cond_data
|
Conditional data UDT or SDT.
•255 = UDT
•0-255 = SDT range
Conditional data is sent on the line when there is an underflow and also toward the network when forming dummy cells.
|
cond_signalling
|
Conditional signalling, in the range 0-15.
Conditional signalling is sent on the line when there is an underflow and also toward the network when forming dummy cells.
|
controller_type
|
Signalling controller type, either PVC or SPVC.
•1 = PVC (PAR) (default)
•2 = SPVC (PNNI)
|
mastership
|
Status of current end, either master or slave.
•1 = master
•2 = slave (default)
|
RemoteEndConID
|
Node name, slot number, port number, and DLCI.
or
Node name, slot number, port number, Controller ID, and DLCI for a Frame Relay endpoint. Use one of the following values to set controller type:
•0 = PAR
•1 = PNNI
•2 = TAG
or
The node name, slot number, port number, and VPI.VCI for an ATM endpoint.
Note Note: the slot number should be set to 0 (zero) to point to the active PXM.
|
A system response does not occur unless an error is detected. Possible errors include:
•Parameters are illegal or invalid.
•The channel already exists.
•The port might not be up.
Related Commands
delcon, dspcons, dspcon
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 2
|
addendpt
Add End Point
Use the addendpt command to set the endpoints on the VISM card. An endpoint is a logical port that consists of one or more DS0s. It resembles the logical port on the channelized FRSM or CESM card. The ds1_num and the ds0_list are used to create the endpoint ID. The SU requires the endpoint ID to send the Create Connection (CRCX) command of the SGCP protocol to the VISM.
Card(s) on Which This Command Executes
VISM
Syntax
addendpt <endpoint_num> <ds1_num> <ds0_list>
Syntax Description
endpoint_num
|
Number of the endpoint, in the range 1-240.
|
ds1_num
|
Number of the physical line associated with this endpoint, in the range 1-8.
|
ds0_list
|
The list of DS0s at this endpoint. Set the list number as appropriate for T1, E1, or VISM.
•E1 range = 1- 31
•T1 range = 1-24
•VISM: DS0s can be noncontiguous
You must separate individual DS0s by a period (.). For the current release of the VISM, only 1 DS0 can exist on an endpoint. For multiple DS0s, you can specify a range of DS0s with a dash (-). For example, 1.3-5 means DS0s 1, 3, 4, and 5.
|
Related Commands
None
Attributes
Log: Yes
|
State: Active
|
Privilege: Any
|
Example 1-13 Add endpoint number 1 to physical line 1. This endpoint uses DS0 1.
spirit4.1.28.VISM.a > addendpt 1 1 1
A system response does not occur unless an error is detected.
addimagrp
Add IMA Group
Use the addimagrp command to configure an IMA group for the current AUSM.
Card(s) on Which This Command Executes
AUSM
Syntax
addimagrp <group_num> <port_type> <list_of_links><minNumLinks>
Syntax Description
group_num
|
Number of the IMA group to be configured, in the range 1-8.
|
port_type
|
Port type, either UNI or NNI.
•1 = UNI
•2 = NN1
|
list_of_links
|
List of links to be included in group_num. Delineate each item in the list
with a (.).
|
minNumLinks
|
Minimum number of links for the group formation, in the range 1-8.
|
Related Commands
dspimagrp, dspimagrpcnt, dspimagrps, dspimainfo, dspimalncnt
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 2
|
Example 1-14 Add IMA group 2 as UNI with lines 3, 4, and 5
spirit4.1.12.AUSM.a > addimagrp 2 1 3.4.5
spirit4.1.12.AUSM.a >
A system response does not occur unless an error is detected. Possible errors include:
•Parameters are invalid or illegal.
•IMA group already exists.
•One of the lines is not enabled.
•All lines are not in local mode.
addlink
Add Link
Use the addlink command to configure a link between a T1 line within a T3 line on an SRM-3T3 card and a slot and line number on a T1 service module.
Card(s) on Which This Command Executes
PXM
Syntax
addlink <T3LineNum> <T1Slot> <Numberof T1s> <TargetSlotNum> <TargetSlotLineNum>
Syntax Description
T3LineNum
|
Line number in the format slot.line.
•slot = 7 or 14
•line range = 1-3
|
T1Slot
|
T1 slot number, in the range 1-28.
|
Number of T1s
|
Number of T1s, in the range 1-8.
|
Target Slot number
|
T1 service module slot number to be linked to the T1 line, in the ranges:
•3-6
•10-13
|
TargetSlotLineNum
|
T1 line number in the slot to be linked, in the range 1-8.
|
Related Commands
dsplink, dellink
Attributes
Log: No
|
State: Active
|
Privilege: Any
|
Example 1-15 Add a link between the T1 line 1 within T3 line 2 on the SRM-3T3 card in slot 7 and T1 line number 5 on the T1 service module in slot 3
spirit4.1.2.PXM.a > addlink 7.2 1 3 5
addlmiloop
Add Loopback Line
Use the addlmiloop command to stop sending LMI connection status messages to the BPX feeder trunk. This command should be used in conjunction with addfdrlp on the BPX (see Figure 1-2). This command can be used only if a feeder trunk exists.
After you have executed the addlmiloop command on the MGX 8230 switch and the addfdrlp command on the BPX series switch, use the dsplmistats command on the BPX switch. The dsplmistats command shows the LMI messages exchanged between the BPX series switch and the MGX 8230 switch. The LMI messages will not show an increase after LMI looping is implemented.
Figure 1-2 Status Messages Halted between an MGX 8230 and a BPX
Card(s) on Which This Command Executes
PXM
Syntax
addlmiloop <slot.port>
Syntax Description
slot.port
|
•Slot number, in the range 1-32
•Port number, in the range 1-256
|
Related Commands
dellmiloop, dsplmiloop
Attributes
Log: No
|
State: Active
|
Privilege: Group 1
|
Example 1-16 Add an LMI loopback line numbered 1 to the current card (PXM in slot 1)
spirit4.1.1.PXM.a > addlmiloop 1
spirit4.1.1.PXM.a >
Example 1-17 Add a feeder loop on the BPX
spirit4.1.1.PXM.a > addfdrlp 5.5
Example 1-18 Display LMI loop
spirit4.1.1.PXM.a > dsplmiloop
Example 1-19 Display LMI statistics for the BPX; number of LMI messages in the statistics does not increase
VPI.VCI: 3.31 Lmi enabled Lmi polling enabled
Invalid Pdu Rx: 0 Status Polling Timer (T396) : 10
Invalid Pdu Len Rx: 14 Status Enquiry Timer (T393) : 10
Unknown Pdu Type Rx: 0 Max Status Enquiry Retry (N394): 5
Unknown IE Type Rx: 4 Update Status Timer (T394) : 10
Bad Transaction Rx: 0 Max Update Status Retry (N395) : 5
Status Rx: 46504 Spc Polling Timer : 2
Status Enq Tx: 46546 Spc Retry Timer : 0
Status Enq Rx: 92014 Spc Retry Counter : 1
Status Tx: 92014 Node Status Retry Timer : 0
Status Ack Rx: 185 Node Status Retry Counter : 0
Update Status Tx: 297 Node Status Polling Timer : 8
VPI.VCI: 3.31 Lmi enabled Lmi polling enabled
Invalid Pdu Rx: 0 Status Polling Timer (T396) : 10
Invalid Pdu Len Rx: 14 Status Enquiry Timer (T393) : 10
Unknown Pdu Type Rx: 0 Max Status Enquiry Retry (N394): 5
Unknown IE Type Rx: 4 Update Status Timer (T394) : 10
Bad Transaction Rx: 0 Max Update Status Retry (N395) : 5
Status Rx: 46511 Spc Polling Timer : 0
Status Enq Tx: 46553 Spc Retry Timer : 0
Status Enq Rx: 92028 Spc Retry Counter : 1
Status Tx: 92028 Node Status Retry Timer : 0
Status Ack Rx: 185 Node Status Retry Counter : 0
Update Status Tx: 297 Node Status Polling Timer : 9
addln
Add Line
Use the addln command to activate an OC-12, OC-3, T3, or E3 line on the current card.
Card(s) on Which This Command Executes
PXM, FRSM-series, AUSM, SRM-3T3, CESM-series
Syntax: PXM
addln -ds3 <LineNum> | -e3 <LineNum> | -sonet <LineNum>
Syntax Description
-ds3
|
Command delineator that precedes the T3 LineNum entry.
|
LineNum
|
DS3 line number in the format slot.line.
•slot = 1 or 2
•line = value in the range 1-N, as appropriate for the physical installation
|
-e3
|
Command delineator that precedes the E3 LineNum entry.
|
LineNum
|
E3 line number format slot.line.
•slot = 1 or 2
•line = value in the range 1-N, as appropriate for the physical installation
|
-sonet
|
Command delineator that precedes the SONET LineNum entry.
|
LineNum
|
OC-3 or OC-12 line number in the format slot.line.
•slot = 1 or 2
•line = value in the range 1-N, as appropriate for the physical installation
•Set line number value at 7 if the line type is SONET
|
Note You can activate only one PXM line on the feeder implementation of an MGX 8230 node. With an OC-12 trunk, the only active port with any MGX 8230 implementation is port 1.
Syntax: FRSM, AUSM, SRM, CESM
addln <line_num>
Syntax Description
line_num
|
Line number, in the range appropriate for the card.
•FRSM
–8T1 range = 1-8
–HS1/B range = 1-4
•AUSM
–8T1/8E1 range = 1-8
–IMATM-T3T1/E3E1 range = 1-8
•CESM, enter a value in the range 1-8
|
Related Commands
cnfln, delln, dspln
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 1 (Any on PXM)
|
Example 1-20 Add a line numbered 1 to current card (the PXM in slot 2)
spirit4.1.2.PXM.a > addln 1
spirit4.1.2.PXM.a >
A message does not appear unless an error occurs. Possible errors include:
•Parameters are illegal or invalid.
•Line already exists.
addlnloop
Add Line Loop
Use the addlnloop command to set a specified line in loopback state on the current card.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM
Syntax: PXM
addlnloop -ds3 <LineNum> | -e3 <LineNum> | -sonet <LineNum>
Syntax Description
-ds3
|
Command delineator that precedes the T3 LineNum entry.
|
LineNum
|
DS3 line number in the format slot.line.
•slot = 1 or 2
•line = 1-N, as appropriate for the physical installation
|
-e3
|
Command delineator that precedes the E3 LineNum entry.
|
LineNum
|
E3 line number format slot.line.
•slot = 1 or 2
•line = 1-N, as appropriate for the physical installation
|
-sonet
|
Command delineator that precedes the SONET LineNum entry.
|
LineNum
|
OC-3 or OC-12 line number in the format slot.line.
•slot = 1 or 2
•line = value in the range 1-N, as appropriate for the physical installation
|
Syntax: FRSM, AUSM, CESM
addlnloop <line_num>
Syntax Description
line_num
|
Line number to be set in loopback state, in the range appropriate for the card.
•FRSM
–8T1 range = 1-8
–HS1/B range = 1-4
•AUSM
–8T1/8E1 range = 1-8
–IMATM-T3T1/E3E1 range = 1-8
•CESM, enter a value in the range 1-8
|
Related Commands
dellnloop
Attributes
Log: Yes
|
State: Active
|
Privilege: Service (Any on PXM)
|
addlns2aimgrp
Add Lines to an AIM Group
Use the addlns2aimgrp command to add lines to an existing AIMUX group.
Card(s) on Which This Command Executes
AUSM
Syntax
addlns2aimgrp <grp_num> <list_of_lines>
Syntax Description
grp_num
|
Number of the AIMUX group on which lines are to be added, in the range 1-8.
|
list_of_lines
|
List of links to be associated with this AIMUX group. Use dotted format to delineate each line in your entry string.
|
Related Commands
dellnsfmaimgrp
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 2
|
Example 1-21 Add lines 1 and 2 to IMA group 2
spirit4.1.12.AUSM.a > addlns2aimgrp 2 1.
A message does not appear unless an error occurs. Possible errors include:
•IMA group is not enabled.
•Line is not enabled.
•Line is part of a different IMA group.
•Tolerable differential delay is exceeded.
addport
Add Port
Use the addport command to add a service port to the shelf's configuration.
Card(s) on Which This Command Executes
PXM, FRSM, CESM
Syntax: PXM OC-3
addport <port_number> <line_number> <percent_bandwidth> <min_vpi> <max_vpi>
Syntax Description
port_number
|
OC-3 port number to be added, in the range 1-32.
|
line_number
|
OC-3 line number. Enter the value 4.
|
percent_bandwidth
|
Percentage of bandwidth to be allocated to the port, in the range 1-100.
|
min_vpi
|
Virtual path identifier (VPI) value, in the range 0-4095.
|
max_vpi
|
VPI value, in the range 0-4095.
|
Syntax: PXM OC-12 back cards
addport <port_number> <line_number> <percent_bandwidth> <min_vpi> <max_vpi>
Syntax Description
port_number
|
OC-12 port number to be added, in the range 1-32.
|
line_number
|
OC-12 line number. Enter the value 1.
|
percent_bandwidth
|
Percentage of bandwidth to be allocated to the port, in the range 1-100.
|
min_vpi
|
Virtual path identifier (VPI) value, in the range 0-4095.
|
max_vpi
|
VPI value, in the range 0-4095.
|
Syntax: PXM T3/E3 back cards
addport <port_number> <line_number> <percent_bandwidth> <min_VPI> <max_VPI>
Syntax Description
port_number
|
Port number, in the range 1-32.
|
line_number
|
T3/E3 line number. Enter the value 2.
|
percent_bandwidth
|
Percentage of bandwidth to be allocated to the port, in the range 1-100.
|
min_VPI
|
Virtual path identifier (VPI) value, in the range 0-4095.
|
max_VPI
|
VPI value, in the range 0-4095.
|
Syntax: FRSM-8T1E1 cards
addport <port_num> <line_num> <ds0_speed> <begin_slot> <num_slot> <port_type>
Syntax Description
port_num
|
Port number of either the FRSM-8T1 or the FRSM-8E1.
•FRSM-8T1 range = 1-192
•FRSM-8E1 range = 1-248
|
line_num
|
FRSM-8T1E1 line number, in the range 1-8.
|
ds0_speed
|
Bit rate as either 56 Kbps or 64 Kbps for the DS0.
•1 = 56 Kbps
•2 = 64 Kbps
|
begin_slot
|
Number of the beginning timeslot in the T1 or E1 frame.
|
num_slot
|
Number of consecutive timeslots in the T1 or E1 frame.
|
port_type
|
Type of service as Frame Relay, FUNI, or frame forwarding.
•1 = Frame Relay
•2 = FUNI
•3 = frame forwarding
|
Syntax: FRSM-2T3E3 cards
addport <port_num> <line_num> <ds0_speed> <begin_slot> <num_slot> <port_type>
Syntax Description
port_num
|
Port number on the FRSM-2T3 or FRSM-2E3, in the range 1-2.
|
line_num
|
FRSM-2T3E3 line number in the range 1-2.
|
ds0_speed
|
Bit rate as either 56 Kbps or 64 Kbps for the DS0.
•1 = 56 Kbps
•2 = 64 Kbps
|
begin_slot
|
Number of the beginning timeslot in the T1 or E1 frame.
|
num_slot
|
Number of consecutive timeslots in the T1 or E1 frame.
|
port_type
|
Type of service as Frame Relay, FUNI, or frame forwarding.
•1 = Frame Relay
•2 = FUNI
•3= frame forwarding
|
Syntax: FRSM-2CT3
addport <port_num> <line_num> <ds0_speed> <begin_slot> <num_slot> <port_type>
Syntax Description
port_num
|
Port number on the FRSM-2CT3, in the range 1-256.
|
line_num
|
FRSM-2CT3 line number in the range 1-56.
|
ds0_speed
|
Bit rate as either 56 Kbps or 64 Kbps for the DS0.
•1 = 56 Kbps
•2 = 64 Kbps
|
begin_slot
|
Number of the beginning timeslot in the T1 or E1 frame.
|
num_slot
|
Number of consecutive timeslots in the T1 or E1 frame.
|
port_type
|
Type of service as Frame Relay, FUNI, or frame forwarding.
•1 = Frame Relay
•2 = FUNI
•3 = frame forwarding
|
Syntax: FRSM-HS1/B
addport <port_num> <port_type>
Syntax Description
port_num
|
Port number, in the range appropriate for the interface type.
•X.21 range = 1-4
•HSSI range = 1-2
|
port_type
|
Type of service as Frame Relay, FUNI, or frame forwarding.
•1 = Frame Relay
•2 = FUNI
•3 = frame forwarding
|
Syntax: FRSM-HS2
addport <port_num> <line_num> <ds0_speed> <begin_slot> <num_slot> <port_type>
Syntax Description
port_num
|
Port number on the FRSM-HS2, in the range 1-2.
|
line_num
|
FRSM-HS2 line number, in the range 1-2.
|
ds0_speed
|
Bit rate as either 56 Kbps or 64 Kbps for the DS0.
•1 = 56 Kbps
•2 = 64 Kbps
|
begin_slot
|
Number of the beginning timeslot in the T1 or E1 frame.
|
num_slot
|
Number of consecutive timeslots in the T1 or E1 frame.
|
port_type
|
Type of service as Frame Relay, FUNI, or frame forwarding.
•1 = Frame Relay
•2 = FUNI
•3 = frame forwarding
|
Syntax: CESM-8T1E1 cards
addport <port_num> <line_num> <begin_slot> <num_slot> <port_type>
Syntax Description
port_num
|
Port number on the CESM-8T1 or CESM-8E1 card.
•CESM-8T1 range = 1-192
•CESM-8E1 range = 1-248
|
line_num
|
CESM-8T1E1 line number, in the range 1-8.
|
begin_slot
|
Number of the beginning timeslot in the T1 or E1 frame.
|
num_slot
|
Number of consecutive timeslots in the T1 or E1 frame.
|
port_type
|
Type of service as either structured, unstructured, or framing on VC disconnect.
•1 = structured
•2 = unstructured
•3 = framing on VC disconnect
|
Syntax: CESM-T3E3 cards
addport <port_num> <line_num>
Syntax Description
port_num
|
Port number. Enter the value 1.
|
line_num
|
Line number. Enter the value 1.
|
Related Commands
cnfport, delport, dspport, dspports
Attributes
Log: Yes
|
State: Active
|
Privilege: 1 (Any on PXM)
|
Example 1-22 Add port 1 on line 1 with DS0 timeslots 1 through 24 assigned as structured
node501.1.11.CESM.a > addport 1 1 1 24 1
addred
Add Redundancy
Use the addred command to link two MGX 8230 slots (a primary slot and a secondary slot) so that the switch treats the cards in these slots as a redundant pair of cards.
Redundancy can be 1:1 or 1:N. If the redundancy is 1:N, you must link one secondary slot to N primary slots through multiple executions of this command.
Card(s) on Which This Command Executes
PXM
Syntax
addred <redPrimarySlotNum> <redSecondarySlotNum> <redType>
Syntax Description
redPrimarySlotNum
|
Slot number that contains the primary card of the card pair, in the ranges 4-6 or 11-13.
|
redSecondarySlotNum
|
Slot number that contains the secondary card of the card pair, in the ranges 4-6 or 11-13.
|
redType
|
Type of redundancy to be deployed on the PXM.
1 = 1:1
2 = 1:N
|
Related Commands
dspred, delred
Attributes
Log: No
|
State: Active
|
Privilege: Any
|
Example 1-23 Add 1:1 redundancy between card in slot 4 and card in slot 11
node501.1.1.PXM.a > addred 11 4 1
A system response does not occur unless a system error is detected.
addrscprtn
Add Resource Partition
Use the addrscprtn command to configure resource partitions for the current PXM.
A resource partition on a PXM consists of a percentage of bandwidth, a VPI/VCI range, and the number of global logical connection numbers (GLCNs) available to a network control application. The network control applications are Portable AutoRoute (PAR) and Tag switching.
Note On a virtual trunk, the min_vpi and max_vpi should be the same. Only a routing node can support virtual trunking.
Card(s) on Which This Command Executes
PXM
Syntax
addrscprtn <if_num> <ctrlr_num> <ingr_pct_bw> <egr_pct_bw> <min_vpi> <max_vpi> <min_vci> <max_vci> <max_chans>
Syntax Description
if_num
|
Logical interface number, in the range 1- 32.
|
ctrlr_num
|
Type of network control application to be used on the logical interface.
•1 = PAR
•2 = PNNI
•3 = TAG
|
ingr_pct_bw
|
Percentage of ingress bandwidth to be allocated on the interface, in the range 0-100.
|
egr_pct_bw
|
Percentage of egress bandwidth to be allocated on the interface, in the range 0-100.
|
min_vpi
|
Minimum virtual path identifier (VPI) value, in the range 0-4095.
|
max_vpi
|
Maximum VPI value, in the range 0-4095.
|
min_vci
|
Minimum virtual channel identifier (VCI) value, in the range 0-65535.
|
max_vci
|
Maximum VCI value, in the range 0-65535.
|
max_chans
|
Maximum global logical connection numbers (GLCNs), in the range 0-32767.
|
Related Commands
cnfrscprtn, delrscprtn, dspifrsc, dspifs, dsprscprtns, dsprscprtn, dsplnrsc
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
addserialif
Add Serial Interface
Use the addserialif command to add a serial interface.
Card(s) on Which This Command Executes
PXM
Syntax
addserialif <serial_port_num>
Syntax Description
serial_port_num
|
Serial port number.
•1 = console
•2 = slip
|
Related Commands
cnfserialif, dspserialif
Attributes
Log: Yes
|
State: Active
|
Privilege: Any
|
Example 1-24 Configure speed on SLIP for 19200 bps
NODENAME.1.1.PXM.a > addserialif 1
addtrapmgr
Add Trap Manager
Use the addtrapmgr command to set up an SNMP trap manager for use with stand-alone applications. A trap manager registered (added) and reregistered through the SNMP interface by Cisco WAN Manager is deregistered (deleted) after 30 minutes if it is not reregistered. Trap managers that are added using the addtrapmgr command do not age, and are not deleted after 30 minutes.
Card(s) on Which This Command Executes
PXM
Syntax
addtrapmgr <ip_addr> <portnum>
Syntax Description
ip_addr
|
A 32-bit IP address in dotted decimal format. This setting is the IP address assigned to the port on the trap manager.
|
portnum
|
Port number on the trap manager workstation to be used to receive traps.
Default = 162.
|
Related Commands
deltrapmgr, dsptrapmgr, xcnftrapmgr
Attributes
Log: Yes
|
State: Active
|
Privilege: Any
|
Example 1-25 Add a trap manager with the IP address of 161.10.144.56 to port 162
node501.1.1.PXM.a > addtrapmgr 161.10.144.56 162
addtrk
Add Trunk
Use the addtrk command to activate a specified trunk on the current PXM.
The addtrk command applies only to routing node implementation. Execute addtrk after you have configured the broadband interface as a trunk by using cnfifastrk.
Note Traffic class and max vpc conids should match before executing the addtrk command.
Card(s) on Which This Command Executes
PXM
Syntax
addtrk <slot.port>
Syntax Description
slot.port
|
Port identifier of the trunk to activate, using the format slot.port.
•slot ranges = 4-6 or 11-13
•port range = 1-N, as appropriate for the physical installation
|
Related Commands
cnftrk, dsptrkcnf, dsptrkload, dsptrks
Attributes
Log: No
|
State: Active
|
Privilege: Group 1
|
Example 1-26 Activate trunk on port 4 in the card in slot 1
node501.1.1.PXM.a > addtrk 1.4
adduser
Add User
Use the adduser command to configure a user name and associated access level on the PXM.
Card(s) on Which This Command Executes
PXM
Syntax
adduser <user_ ID> <accessLevel>
Syntax Description
user_ID
|
Name to be used as the login at the PXM.
•The name can consist of up to 12 characters composed of alpha and numeric characters, special characters "_" and "-".
•The name must begin with an alpha character and cannot contain spaces. The name is case-sensitive.
|
accessLevel
|
System privilege level to be allocated for the user ID.
•GROUP1 (highest level)
•GROUP2
•GROUP3
•GROUP4
•GROUP5
•ANYUSER (lowest level)
The new user that you configure cannot have an access level that is higher than that defined for the current login ID.
|
Related Commands
dspusers, deluser
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 1
|
Example 1-27 Add a user named fin with privilege level ANYUSER
spirit.1.1.PXM.a > adduser fin ANYUSER
agetrapmgr
Age Trap Manager
Use the agetrapmgr command to activate or deactivate aging on trap managers.
Card(s) on Which This Command Executes
PXM
Syntax
agetrapmgr <ip_addr> <aging>
Syntax Description
ip_addr
|
IP address in dotted decimal format.
Use ip_addr 0.0.0.1 for all managers.
|
aging
|
Aging of either individual trap managers or all trap managers.
•1 = enable (default)
•2 = disable
If enabled, the trap manager is deleted from the table after a period of
30 minutes.
|
Related Commands
dsptrapmgr
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
aimhelp
AIM Help
Use the aimhelp command to display the Help screen for the AUSM service module.
Card(s) on Which This Command Executes
AUSM
Syntax
aimhelp
Related Commands
help
Attributes
Log: No
|
State: Any
|
Privilege: 1-6
|
Example 1-28 Display Help screen for AUSM service module
raviraj.1.4.AUSM8.a > aimhelp
addcon : Add a Connection
addimagrp : Add an IMA group
addlnloop : Configure a line in local loopback
addlns2imagrp : Add lines to an existing IMA group
clralmcnt : Clear DS1 alarm count
clralmcnts : Clear alarm count for all DS1 lines
clralm : Clear the DS1 line alarms
clrchancnt : Clear Channel Counters
clrchancnts : Clear Channel Counters for all channels
clralms : Clear DS1 alarms on all lines
clrimagrpcnt : Clear IMA group Counters
clrimalncnt : Clear IMA counters on a particular line
clrportcnt : Clear Port Counters
clrportcnts : Clear Port Counters for all ports
clrsarcnt : Clear SAR channel counters
clrsarcnts : Clear SAR counters for all channels
clrslftst : Clear self test results
clrimatst : clear IMA test procedure
Type <CR> to continue, Q<CR> to stop:
cnfchanfst : Configure the channel foresight parameters
cnfchanq : Configure the channel queue parameters
cnffst : Configure foresight params of a card
cnfportq : Configure Egress queue parameters
cnfimagrp : Configure an IMA group
cnfilmi : Configure ILMI parameters of a port
cnfln : Configure DS1/E1 line
cnflnloop : Configure DS1/E1 line
cnfplpp : Configure DS1/E1 line
cnfslftst : Configure self test parameters
cnfsvcrange : Partition Resource between PVCs & SVCs
cnfupccbr : Configure UPC parameters of CBR connection
cnfupcvbr : Configure UPC parameters of VBR connection
cnfupcabr : Configure UPC parameters of ABR connection
cnfupcubr : Configure UPC parameters of UBR connection
cnfimatst : Enable the IMA test procedure
cnfimaalmparm : COnfigure the IMA alaram Integration UP and DOWN times
copychans : Copy a template connection
delimagrp : Delete an IMA group
Type <CR> to continue, Q<CR> to stop:
delcon : Delete a connection
dellnloop : Remove a DS1 line from local loopback
dellnsfmimagrp : Delete lines from an existing IMA group
dnport : Down an ATM port
dspalm : Display DS1 alarms on a line
dspalmcnf : Display DS1 alarm configuration
dspalmcnt : Display alarm count for DS1 line
dspalms : Display DS1 alarms on all lines
dspcd : Display card information
dspchancnt : Display channel counters
dspcon : Display connection configuration
dspcons : Display all the configured connections
dspfeature : Display the features
dspfst : Display the card Foresight params
dspilmi : Display ILMI parms of a port
dspilmicnt : Display ILMI counters of a port
dspimagrp : Display all parms configured for an IMA group
dspimagrpcnt : Display IMA group Counters
Type <CR> to continue, Q<CR> to stop:
dspimagrps : Display the configured IMA groups
dspimalncnt : Display IMA counters on a particular line
dspimatst : Display IMA test status
dspimaln : Display IMA link status
dspimaalmparm : Display IMA alaram integration times
dsplns : Display all DS1 lines
dsploads : Display the total bandwidth used up in each port
dspplpp : Display the PLPP configuration of each line
dspport : Display the configured ATM/IMA port
dspportcnt : Display Port Counters
dspportq : Display the egress queue configuration
dspportqs : Display configuration of all egress queues
dspports : Display the configured ATM/IMA ports
dspsarcnt : Display the SAR counters of a connection
dspsarcnts : Display the SAR counters of all connections
dspslftst : Display self test configuration
dspslftsttbl : Display the self test results
dspsttatparms : Display the statistics params configured
Type <CR> to continue, Q<CR> to stop:
dspsvcrange : Display the resource partition between PVCs & SVCs
dsptotals : Display the total connections configured per port
runslftstno : Run a particular self test
tstcon : Test the connection towards the N/W side
tstconseg : Test the connection towards the CPE side
tstconsti : Test the connection towards the N/W side using STI supervis
tstdelay : Measure the delay towards the N/W side
tstdelaysti : Measure the delay towards the N/W side using STI supervisor
xcnfalm : Configure alms of a DS1 line
xcnfln : Configure a DS1 line
xcnfln : Configure a DS1 line
arpAdd
Add Address Resolution Protocol Entry
Use the arpAdd command to add an Address Resolution Protocol (ARP) entry to the ARP table. This Internet protocol is used to map an IP address to a MAC address, and the ARP table contains these translations.
Card(s) on Which This Command Executes
PXM
Syntax
arpAdd <ip_address> <mac_address>
Syntax Description
ip_address
|
IP address in dotted decimal format.
|
mac_address
|
Standardized data link layer address, six bytes long. Also known as a hardware address, MAC-layer address, and physical address.
|
Related Commands
arpShow, arpDelete, arpFlush
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-29 Add an ARP entry on current PXM, then show ARP entry
NODENAME.1.1.PXM.a > arpAdd 172.29.36.102 0:e0:4f:5c:6c:5a
NODENAME.1.1.PXM.a > arpShow
172.29.36.28 at 8:0:20:a6:80:3b
190.29.36.255 at 0:e0:4f:5c:6c:20
172.29.36.102 at 0:e0:4f:5c:6c:5a
171.71.54.104 at 0:e0:4f:5c:6c:20
arpDelete
Delete Address Resolution Protocol Entry
Use the arpDelete command to delete an entry in the Address Resolution Protocol (ARP) table. The ARP protocol is used to map an IP address to a MAC address, and the ARP table contains these translations.
Card(s) on Which This Command Executes
PXM
Syntax
arpDelete <ip_addr>
Syntax Description
ip_addr
|
IP address in dotted decimal format.
|
Related Commands
arpAdd, arpShow, arpFlush
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-30 Delete ARP entry for IP address 172.29.36.102
NODENAME.1.1.PXM.a> arpDelete 172.29.36.102
172.29.36.102 (172.29.36.102) deleted
arpFlush
Flush Address Resolution Protocol Table
Use the arpFlush command to remove nonpermanent entries from the ARP table. The ARP protocol is used to map an IP address to a MAC address, and the ARP table contains these translations.
Card(s) on Which This Command Executes
PXM
Syntax
arpFlush
Related Commands
arpAdd, arpDelete, arpShow
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-31 Flush ARP table, then show ARP table
NODENAME.1.1.PXM.a > arpFlush
NODENAME.1.1.PXM.a > arpShow
171.71.54.104 at 0:e0:4f:5c:6c:20
arpShow
Show Address Resolution Protocol Table
Use the arpShow command to display the Address Resolution Protocol (ARP) table. The ARP table contains IP address-to-MAC address translations mapped by the ARP protocol.
Card(s) on Which This Command Executes
PXM
Syntax
arpShow
Related Commands
arpAdd, arpDelete, arpFlush
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-32 Show ARP table on current PXM
NODENAME.1.1.PXM.a > arpShow
190.29.36.255 at 0:e0:4f:5c:6c:20
172.29.36.28 at 8:0:20:a6:80:3b
171.71.54.104 at 0:e0:4f:5c:6c:20
bootChange
Boot Change
Use the bootChange command to change to the boot IP address and gateway address of a PXM card. The IP address you define will be used only when the PXM is in boot state. Use the cnfifip command to assign IP addresses for the PXM and the shelf. Note that the bootChange values are sent and automatically updated on the standby card, and bootlines are synchronized.
The PXM tries to correct bad entries when it boots up. This information is copied to the standby card. If the bootChange IP address is different from the shelf IP address, then it will bring the Ethernet interface up on the standby with the bootChange IP address.
The shellconn version of this command updates only the local bootline values.
Note that several parameters are necessary for the network to function; specifically:
•Ethernet interface
•IP address and subnetmask
•Default Ethernet gateway
Note If the firmware fails to reach the CLI prompt or comes up in backup boot, the Ethernet interface could be down, a problem created by an identical shelf IP address and boot change address. In such a case, the bootChange command could be used from the shell to set another IP address and then usrEnetEnable should be called to activate that address.
If the CLI prompt is not there or if the switch is not enabled and in backup boot, you can use the usrEnetEnable command to bring up the Ethernet interface.
Card(s) on Which This Command Executes
PXM
Syntax
bootChange
Related Commands
cnfifip
Attributes
Log: Yes
|
State: Active
|
Privilege: Service
|
Example 1-33 Execute bootChange on current PXM
raviraj.1.1.PXM.a > bootChange
'.' = clear field; '-' = go to previous field; ^D = quit
inet on ethernet (e) : 172.29.37.41 : ffffff00
gateway inet (g) : 172.29.37.1
ftp password (pw) (blank = use rsh):
bye
Bye
Use the bye command to exit the current CLI shell.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, VISM
Syntax
bye
Related Commands
logout
Attributes
Log: Yes
|
State: Any
|
Privilege: Any
|
Example 1-34 Exit current CLI shell
cc
Change Card
Use the cc command to navigate from card to card on the shelf.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM, VISM
Syntax
cc <slotNumber>
Syntax Description
slotNumber
|
Number of the card slot, in the range 1-14.
|
Related Commands
None
Attributes
Log: Yes
|
State: Any
|
Privilege: Any
|
Example 1-35 Switch from AUSM in slot 4 to PXM in slot 2
A system message does not occur unless an error is detected or the card slot is empty.
cd
Change Directory
Use the cd command to change the current directory on the PXM hard disk.
Card(s) on Which This Command Executes
PXM
Syntax
cd <directory_name>
Syntax Description
directory_name
|
Name of the target directory.
|
Related Commands
ls, pwd, rename, deltree, copy
Attributes
Log: Yes
|
State: Any
|
Privilege: Group 3
|
Example 1-36 Change directory to FW
raviraj.1.1.PXM.a > cd FW
Verify the current directory by using the pwd command.
Example 1-37 Return to Root directory
raviraj.1.1.PXM.a > cd ..
clraimgrpcnt
Clear AIM Group Counters
Use the clraimgrpcnt command to clear all the AIMUX-related counters for all lines in the specified AIMUX group.
Card(s) on Which This Command Executes
AUSM
Syntax
clraimgrpcnt <imagroup>
Syntax Description
imagroup
|
Number of the AIMUX group number on which you want to clear the AIMUX counters, in the range 1-8.
|
Related Commands
None
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 1
|
Example 1-38 Clear all AIM group counters in AIM group 8
node1.1.4.AUSM8.a > clraimgrpcnt 8
clraimlncnt
Clear AIM (or Clear IMA) Line Counters
Use the clraimlncnt command to clear all the AIMUX line counters for the specified IMA group.
Card(s) on Which This Command Executes
AUSM
Syntax
clraimlncnt (or clrimalncnt) <imagroup> <linenum>
Syntax Description
imagroup
|
Number of the AIMUX group on which you want to clear the line counters associated with an IMA group, in the range 1-8.
|
linenum
|
Line number, in the range 1-8.
|
Related Commands
dspaimlncnt, clrimalncnt
Attributes
Log: No
|
State: Active
|
Privilege: Group 1
|
Example 1-39 Clear all AIM line counters in AIM group 8
node1.1.4.AUSM8.a > clraimlncnt 8
clrallcnf
Clear All Configurations
Use the clrallcnf command to clear all configuration elements for all the cards in the node. The system queries for confirmation before executing the clrallcnf command.
Caution This command clears all configuration files on the PXM.
Card(s) on Which This Command Executes
PXM
Syntax
clrallcnf
Related Commands
None
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 3
|
Example 1-40 Clear configuration confirmation query
node1.1.1.PXM.a > clrallcnf
All SM's config will be deleted, and
Do you want to proceed (Yes/No)? No
clralm
Clear Alarm
Use the clralm command to clear alarms on a specified line on the current card. Alarms occurring after this command executes are not affected. If alarms on a line are cleared with this command, the results may be observable through the dspalm command.
This command can clear alarms caused by the collection of statistical data only. Alarms caused by network failure cannot be cleared. For example, an alarm caused by a collection of bipolar errors can be cleared, but an alarm caused by a card failure cannot.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM
Syntax: PXM
clralm -ds3 <LineNum> | -e3 <LineNum> | -sonet <LineNum> | -plcp <PLCPNUM>
Syntax Description
-ds3
|
Command delineator that precedes the T3 LineNum entry.
|
LineNum
|
DS3 line number in the format slot.line.
•slot = 1, 2, 7, 14
•line range = 1-N, as appropriate for the physical installation
|
-e3
|
Command delineator that precedes the E3 LineNum entry.
|
LineNum
|
E3 line number in the format slot.line.
•slot = 1, 2, 7, 14
•line range = 1-N, as appropriate for the physical installation
|
-sonet
|
Command delineator that precedes the SONET LineNum entry.
|
LineNum
|
SONET line number in the format slot.line.
•slot = 1 or 2
•line range = 1-N, as appropriate for the physical installation
|
-plcp
|
Command delineator that precedes the PLCPNUM entry.
|
PLCPNUM
|
Physical Layer Protocol Processor (PLCP) number in the format slot.line.
•slot = 1, 2, 7, 14
•line range = 1-N, as appropriate for the physical installation
|
Syntax: FRSM, AUSM, CESM
clralm -ds1 <LineNum>
Syntax Description
-ds1
|
Command delineator that precedes the LineNum entry.
|
LineNum
|
Line number appropriate for the card:
•FRSM
–8T1: for DS1, enter a value in the range 1-8
–HS1/B: for X.21 enter a value in the range 1-4
•AUSM, enter a value in the range 1-8
•CESM: for CESM_8P enter a value in the range 1-8
|
Syntax: SRM-3T3
clralm -srmds3 <LineNum>
Syntax Description
-srmds3
|
Command delineator that precedes the LineNum entry.
|
LineNum
|
Line number = 1-N, where N=3
|
Syntax: FRSM-HS1
clralm -hs1 <LineNum>
Syntax Description
-hs1
|
Command delineator that precedes the LineNum entry.
|
LineNum
|
Line number = 1-N, where N=4
|
Related Commands
clralms, dspalm, dspalms
Attributes
Log: No
|
State: Any
|
Privilege: Group 5
|
Example 1-41 Clear all alarms caused by the collection of statistical data for line 1 on current card
node1.1.4.AUSM8.a > clralm -ds1 1
clralmcnt
Clear Alarm Counters
Use the clralmcnt command to clear all the alarm counters and statistics on the specified line on the current card. All counters are reset to 0. The terminal does not display a response unless an error exists in the syntax.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM
Syntax: PXM
clralmcnt -ds3 <LineNum> | -e3 <LineNum> | -sonet <LineNum> | -plcp <PLCPNUM>
Syntax Description
-ds3
|
Command delineator that precedes the T3 LineNum entry.
|
LineNum
|
DS3 line number in the format slot.line.
•slot = 1, 2, 7, 14
•line range = 1-N, as appropriate for the physical installation
|
-e3
|
Command delineator that precedes the E3 LineNum entry.
|
LineNum
|
E3 line number in the format slot.line.
•slot = 1, 2, 7, 14
•line range = 1-N, as appropriate for the physical installation
|
-sonet
|
Command delineator that precedes the SONET LineNum entry.
|
LineNum
|
SONET line number in the format slot.line.
•slot = 1 or 2
•line range = 1-N, as appropriate for the physical installation
|
-plcp
|
Command delineator that precedes the PLCPNUM entry.
|
PLCPNUM
|
Physical Layer Protocol Processor (PLCP) number in the format slot.line.
•slot = 1, 2, 7, 14
•line range = 1-N, as appropriate for the physical installation
|
Syntax: FRSM, AUSM, CESM
clralmcnt -ds1 <LineNum>
Syntax Description
-ds1
|
Command delineator that precedes the LineNum entry.
|
LineNum
|
Line number, in the range appropriate for the card.
•FRSM range = 1-8
•AUSM range = 1-8
•CESM range = 1-8
|
Related Commands
dspalmcnt, clralmcnts
Attributes
Log: No
|
State: Any
|
Privilege: Any (5 on PXM)
|
Example 1-42 Clear all alarm counters and statistics collected for line 1 on current card
node1.1.4.AUSM8.a > clralmcnt -ds1 1
clralmcnts
Clear All Alarm Counters/Statistics on Current Card
Use the clralmcnts command to clear all the alarm counters and statistics on the current card. All counters are reset to 0. The terminal does not display a response unless an error exists in the syntax.
Card(s) on Which This Command Executes
FRSM, AUSM, CESM
Syntax
clralmcnts
Related Commands
dspalmcnt, clratmlncnt
Attributes
Log: No
|
State: Any
|
Privilege: 1-5
|
Example 1-43 Clear all alarm counters and statistics collected for current card
node1.1.4.AUSM8.a > clralmcnts
clralms
Clear Alarms on Card
The clralms command clears alarms on the current card. Alarms occurring after this command executes are not affected.
This command can clear alarms caused by the collection of statistical data only. Alarms caused by network failure cannot be cleared. For example, an alarm caused by a collection of bipolar errors can be cleared, but an alarm caused by a card failure cannot be cleared.
Card(s) on Which This Command Executes
FRSM, AUSM, CESM
Syntax
clralms -ds1 <LineNum>
Syntax Description
-ds1
|
Command delineator that precedes the LineNum entry.
|
LineNum
|
Line number on which to clear alarms, in the range 1-N, as appropriate for the physical installation.
|
Related Commands
clralm, dspalm, dspalms
Attributes
Log: No
|
State: Any
|
Privilege: 1-5
|
Example 1-44 Clear all alarms triggered by the collection of statistics for line 1 on current card
node1.1.4.AUSM8.a > clralms -ds1 1
clratmlncnt
Clear All ATM Line Counters on Specified Line Number
Use the clratmlncnt command to clear the ATM event counters for the specified line on the PXM.
Card(s) on Which This Command Executes
PXM
Syntax
clratmlncnt <line_num>
Syntax Description
line_num
|
Line number on which to clear the ATM event counters, in the range 1-4.
|
Related Commands
clratmlncnts
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-45 Clear all ATM event counters for line 1 on the PXM
node1.1.1.PXM.a > clratmlncnt 1
clratmlncnts
Clear All ATM Line Counters on All Lines
Use the clratmlncnts command to remove all ATM counters on all the lines on the current card.
Card(s) on Which This Command Executes
PXM
Syntax
clratmlncnts
Related Commands
clratmlncnt
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-46 Clear all ATM event counters on the PXM
node1.1.1.PXM.a > clratmlncnts
clrbertcntrs
Clear BERT Counters
Use the clrbertcntrs command to remove all counters associated with bit error rate testing (BERT).
Card(s) on Which This Command Executes
FRSM 2CT3, CESMT3
Syntax
clrbertcntrs
Related Commands
acqdsx3bert, cnfdsx3bert, deldsx3bert, dspdsx3bert, startdsx3bert, xcnfdsx3bert, xdspdsx3bert
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-47 Clear all BERT counters on the current FRSM
raviraj.1.13.VHS2CT3.a > clrbertcntrs
clrcderrs
Clear Hardware/Reset Errors in BRAM
Use the clrcderrs command to clear all card-related errors on an MGX 8230 card. Refer to the dspcderrs description to see an example of the errors that this command clears, or execute the dspcderrs command before and after executing the clrcderrs command.
Card(s) on Which This Command Executes
FRSM, AUSM
Syntax
clrcderrs
Related Commands
dspcderrs
Attributes
Log: No
|
State: Any
|
Privilege: SuperUser
|
Example 1-48 Clear all card-related errors on the FRSM in slot 4
node1.1.4.FRSM.a > clrcderrs
A system response does not occur unless an error is detected.
clrchancnt
Clear Channel Counters on Specified Channel
Use the clrchancnt command to clear the channel counters for the specified channel on the current card. Counting resumes after the command executes.
The Frame Relay counters for each channel are:
•Received frames: bytes, DE, discarded, FECN, BECN
•Received frames tagged FECN, BECN, DE
•Received frames discarded for shelf alarms, exceeded queue depth, exceeded DE threshold
•Received bytes: DE, discarded
•Transmitted bytes: DE, discarded
•Transmitted bytes discarded for exceeded queue depth
•Transmitted bytes during LMI logical port alarm
•Transmitted frames tagged FECN, BECN
•Transmitted frames: bytes, BECN, FECN, DE
•Transmitted frames during LMI logical port alarm
•Transmitted frames discarded for exceeded queue depth, exceeded DE threshold, CRC error, physical layer fail, source abort, reassembly failure
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM
Syntax: PXM
clrchancnt -cnt <chan_num> -cc <clrButton>
Syntax Description
-cnt
|
Command delineator that precedes the PXM chanNum entry.
|
chanNum
|
PXM channel number, in the range 16-4111.
|
-cc
|
Command delineator that precedes the clrButton entry.
|
clrButton
|
The underline MIB object to clear or retain the counters.
•1 = no action
•2 = clear counts (default)
|
Syntax: FRSM, CESM
clrchancnt <chan_num>
Syntax Description
chan_num
|
Channel number, in the range appropriate for the card.
•FRSM range = 16-1015
•CESM range = 32-279
|
Syntax: AUSM
clrchancnt <Port.VPI.VCI | Chan_num>
Syntax Description
Port.VPI.VCI
|
Connection number, in the format port.VPI.VCI.
|
Chan_num
|
Channel number, in the range 16-1015.
|
Related Commands
dspchan, clrchancnts, dspchancnt
Attributes
Log: Yes
|
State: Any
|
Privilege: Any
|
Example 1-49 Clear all channel counters for channel 16 on the FRSM in slot 4
node1.1.4.FRSM.a > clrchancnt 16
clrchancnts
Clear All Channel Counters on Card
Use the clrchancnts command to clear all channel counters for all channels on the current service card. The counters resume accruing after the command executes. To view a list of the Frame Relay counters, refer to the description of clrchancnt.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM
Syntax
clrchancnts
Related Commands
dspchan, clrchancnt, dspchancnt
Attributes
Log: Yes
|
State: Any
|
Privilege: Group 3 (Any on PXM)
|
Example 1-50 Clear all channel counters for all channels on the FRSM in slot 4
node1.1.4.FRSM.a > clrchancnts
clrconcnt
Clear Connection Counters for Specified Connection Identifier
Use the clrconcnt command to clear the counters for the specified connection identifier on the current PXM card. Counting resumes after the command executes.
Card(s) on Which This Command Executes
PXM
Syntax
clrconcnt <conn_ID>
Syntax Description
conn_ID
|
Connection ID, in the format PortNum.VPI.VCI
•PortNum = 1-N, as appropriate for the physical installation
•VPI = virtual path identifier in the range for either UNI or NNI
–UNI range = 0-255 (typically applied to lines that connect a standalone node to a workstation)
–NNI range = 0-4095
•VCI = virtual channel identifier in the range 0-65535
|
Related Commands
dspcon, clrconcnts, dspconcnt
Attributes
Log: Yes
|
State: Any
|
Privilege: Any
|
Example 1-51 Clear all counters for connection on port 1 with a VPI of 2 and a VCI of 2
node4.1.2.PXM.a > clrconcnt 1.2.2
clrconcnts
Clear Connection Counters for All Connections on Card
Use the clrconcnts command to clear the counters for all the connections on the current PXM card. Counting resumes after the command executes.
Card(s) on Which This Command Executes
PXM
Syntax
clrconcnts
Related Commands
dspcon, clrconcnt, dspconcnt
Attributes
Log: Yes
|
State: Any
|
Privilege: Any
|
Example 1-52 Clear all counters for all connections on the PXM card
node4.1.2.PXM.a > clrconcnts
clrerr
Clear Error Log Counters for All Connections on Card
Use the clrerr command to remove specified or all error log files. This command queries for confirmation prior to clearing the error log files from the system.
Card(s) on Which This Command Executes
PXM
Syntax:
clrerr [-en <error slot>]
Syntax Description
-en
|
Command delineator that precedes the error slot entry.
|
error slot
|
Number of the log file to clear, which is identical to the slot number of the card.
|
Related Commands
dsperr
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-53 Show clrerr confirmation query
Do you want to proceed (Yes/No)? No
clrifcnt
Clear Interface Counters for Specified Interface
Use the clrifcnt command to clear the counters for a specified broadband interface.
Card(s) on Which This Command Executes
PXM
Syntax
clrifcnt <if_num>
Syntax Description
if_num
|
Interface number, in the range 1-32.
|
Related Commands
clrifcnts
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-54 Clear counters for the specified broadband interface (1)
wilco.1.1.PXM.a > clrifcnt 1
clrifcnts
Clear All Interface Counters
Use the clrifcnts command to clear the counters for all the broadband interfaces.
Card(s) on Which This Command Executes
PXM
Syntax
clrifcnts
Related Commands
clrifcnt
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-55 Clear counters for all broadband interfaces on the PXM card
wilco.1.1.PXM.a > clrifcnts
clrimagrpcnt
Clear Inverse Multiplexing ATM Group Counters
Use the clrimagrpcnt command to clear Inverse Multiplexing ATM (IMA) group counters on the current AUSM card for a specified IMA group.
Card(s) on Which This Command Executes
AUSM
Syntax
clrimagrpcnt (or clraimgrpcnt) <imagroup>
Syntax Description
imagroup
|
IMA group number, in the range 1-8.
|
Related Commands
dspimagrp, dspimagrpcnt, dspimagrps, dspimainfo, dspimalncnt
Attributes
Log: No
|
State: Active
|
Privilege: Group 1
|
Example 1-56 Clear all inverse multiplexing ATM group counters for IMA group 1 on the AUSM card in slot 11
flyers01.1.11.AUSM.a > clrimagrpcnt 1
clrimalncnt
Clear AIM (or Clear IMA) Line Counters
Use the clrimalncnt command to clear all AIMUX line counters for a specified line in an IMA trunk.
Card(s) on Which This Command Executes
AUSM
Syntax
clrimalncnt (or clraimlncnt) <imagroup> <linenum>
Syntax Description
imagroup
|
AIMUX group number, in the range 1-8.
|
linenum
|
Line number, in the range 1-8.
|
Related Commands
dspimalncnt, clraimlncnt
Attributes
Log: No
|
State: Active
|
Privilege: Group 1
|
Example 1-57 Clear all inverse multiplexing ATM line counters for IMA group 1 on the AUSM card in slot 11
flyers01.1.11.AUSM.a > clrimalncnt 1
clrlmistats
Clear All LMI Statistics
Use the clrlmistats command to clear the local management interface (LMI)-related statistics
on the PXM.
Card(s) on Which This Command Executes
PXM
Syntax
clrlmistats
Related Commands
dsplmistats
Attributes
Log: No
|
State: Any
|
Privilege: Any
|
Example 1-58 Clear LMI statistics on the PXM card
penguin.1.1.PXM.a > clrlmistats
Enabled : 1 Port Status : 1
WaitStatus : 0 WaitStAck : 0
Retry Timer : 0 Retry Count : 1
Poll Timer : 6 Trans Num : 86
Status Rx : 0 Status Tx : 0
UpdtStatus Rx : 0 UpdtStatus Tx : 0
Status Enq Rx : 0 Status Enq Tx : 0
Status Ack Rx : 0 Status Ack Tx : 0
NodeStatus Rx : 0 NodeStatus Tx : 0
NodeStaAck Rx : 0 NodeStaAck Tx : 0
Bad PDU Rx : 0 Bad PDU Len Rx : 0
Unknown PDU Rx : 0 Invalid I.E. Rx: 0
clrlog
Clear Log
Use the clrlog command to clear specified or all event log files. The log resumes accumulating event log messages after the command executes. This command queries for confirmation prior to removing all event log files.
Card(s) on Which This Command Executes
PXM
Syntax
clrlog [-log <log slot>]
Syntax Description
-log
|
Command delineator that precedes the log slot entry.
|
log slot
|
Number of the file that you want to clear from the event log file.
|
Related Commands
dsplog
Attributes
Log: Yes
|
State: Any
|
Privilege: Group 1
|
Example 1-59 Clear all event log files on the PXM card
Do you want to proceed (Yes/No)? Yes
clrmsgcnt
Clear Control Message Counters
Use the clrmsgcnt command to clear the control message counters. The control message counters are for the total numbers of:
•Control frames transmitted to SAR from RISC maintained by RISC
•Control frames received from SAR to RISC maintained by RISC
•Control frames transmitted to RISC from SAR maintained by SAR (should be equal to riscRcvCtrlMsg)
•Control frames received to SAR from RISC maintained by SAR (should be equal to riscXmtCtrlMsg)
•Control (management) cells discarded due to illegal length error
•Control (management) cells discarded due to illegal CRC error
•Discarded control messages due to unknown channel error
This message also clears the control cell header received on the last unknown channel.
Card(s) on Which This Command Executes
FRSM, AUSM, CESM
Syntax
clrmsgcnt
Related Commands
dspmsgcnt
Attributes
Log: No
|
State: Any
|
Privilege: Group 5
|
Example 1-60 Clear all control message counters on the AUSM card in slot 11
flyers01.1.11.AUSM.a > clrmsgcnt 1
clrportcnt
Clear Port Counters
Use the clrportcnt command to clear counter values on a specified port associated with the current PXM, FRSM, or AUSM.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM
Syntax
clrportcnt <port_ number>
Syntax Description
port_ number
|
Port number, as appropriate for the current card.
•PXM range = 1-32
•AUSM range = 1-8
•FRSM
–T1 = 1-192
–E1 = 1-248
–HS2 = 1-2
–X.21 range = 1-4
–HSSI range = 1-2
|
Related Commands
clrportcnts, dspportcnt
Attributes
Log: No
|
State: Any
|
Privilege: 1-5 (Any on PXM)
|
Example 1-61 Clear port counters on port 1 on the AUSM card in slot 11
flyers01.1.11.AUSM.a > clrportcnt 1
clrportcnts
Clear Port Counters
Use the clrportcnts command to clear all port counters on the current PXM, FRSM, or AUSM.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM
Syntax
clrportcnts
Related Commands
clrportcnt, dspportcnt
Attributes
Log: No
|
State: Any
|
Privilege: 1-5
|
Example 1-62 Clear all port counters on all ports on the AUSM card in slot 11
flyers01.1.11.AUSM.a > clrportcnts
clrsarcnt
Clear SAR Counters
On an FRSM or CESM, use the clrsarcnt command to clear the segmentation and reassembly (SAR) counters for the particular channel in the argument. On an AUSM, use the clrsarcnt command to clear the SAR counters for the particular port.VPI.VCI connection.
The SAR counters are:
•Number of cells transmitted on this channel
•Number of CLP cells that were transmitted on this channel
•Number of AIS cells that were transmitted on this channel
•Number of FERF cells that were transmitted on this channel
•Number of BCM cells that were transmitted on this channel
•Number of End2End loop cells that were transmitted on this channel
•Number of segment loop cells that were transmitted on this channel
•Number of cells discarded due to shelf alarm on this channel
•Number of cells that were received on this channel
•Number of CLP cells that were received on this channel
•Number of AIS cells that were received on this channel
<
