Table Of Contents
CESM and MPSM Command Reference
?
addcdrscprtn
addchan
addchanloop
addcon
addconCDVT
addln
addlnloop
addport
addrscprtn
addspvc
chkflash
clear
clralm
clralmcnt
clralmcnts
clralms
clrbertstats
clrcderrs
clrchancnt
clrchancnts
clrdiagresults
clrds1stats
clrmsgcnt
clrsarcnt
clrsarcnts
clrscrn
clrslftst
clrtaskinfo
cls
cnfbert
cnfcdparms
cnfcdprtntype
cnfcdrscprtn
cnfchan
cnfcon
cnfdiagtest
cnfln
cnflnloop
cnfportrscprtn
cnfprfparam
cnfrscprtn
cnfslftst
cnfswparms
core
delbert
delcdrscprtn
delchan
delchanloop
delchans
delcon
delln
dellnloop
delport
delports
delrscprtn
dncon
dspalm
dspalmcnf
dspalmcnt
dspalms
dspbert
dspbertstats
dspcd
dspcderrs
dspcdparms
dspcdprtntype
dspcdrscprtn
dspchan
dspchancnt
dspchans
dspcon
dspcons
dspdiagresults
dspdiagtests
dspds1stats
dspfeature
dsplcn
dspliccd
dspln
dsplns
dspmsgcnt
dspport
dspportrscprtn
dspports
dspprfhist
dsprscprtn
dspsarcnt
dspsarcnts
dspslftst
dspslftsttbl
dspstatparms
dsptaskinfo
dsptotals
Help
i
insbiterror
memShow
movelic
myid
pausediag
resumediag
rrtcon
rundiagtest
runslftstno
setcmdc
setpagemode
startbert
stopbert
tstchan
tstcon
tstdelay
upcon
version
xclrchancnt
xcnfalm
xcnfalmcnt
xcnfcdprtntype
xcnfcdrscprtn
xcnfchan
xcnfcon
xcnfln
xcnfport
xcnfrscprtn
xdspchan
xdspchancnt
xdspchans
xdspln
xdsplns
xdspport
xdspports
CESM and MPSM Command Reference
The preferred tool to configure, monitor, and control a Cisco MGX switch is the Cisco WAN Manager (CWM) application. The command-line interface (CLI) also provides access to the Cisco MGX switches and is highly applicable during initial installation, troubleshooting, and any situation in which low-level control is useful.
This chapter documents the CLI commands that are supported on the Circuit Emulation Service Module (CESM) and the Multi Protocol Service Module (MPSM) cards that are supported by the PXM1, PXM1E, and the PXM45 processor cards in Cisco MGX 8230, Cisco MGX 8250, Cisco MGX 8850 (PXM1), Cisco MGX 8850 (PXM1E/PXM45), and Cisco MGX 8830 (PXM1E/PXM45) switches.
Note 
In this documentation release not all of the Circuit Emulation service module commands supported on Cisco MGX PXM1-based systems have been documented. Only those PXM1 commands supported on the MPSM-8T1-CES, MPSM-8E1-CES, CESM-8T1/B, CESM-8T1, and CESM-8E1 service modules have been documented and verified. For PXM1 documentation of the CLI commands supported on the CESM-T3E3 service module, refer to the Cisco MGX 8800 Series Switch Command Reference, Release 1.1.3, the Cisco MGX 8250 Multiservice Gateway Command Reference, Release 1.1.3, and the Cisco MGX 8230 Multiservice Gateway Command Reference, Release 1.1.3.
Note For information on which PXM processor cards support each type of service module, see Table 1-3 in "Introduction."
The commands in the tables that follow (Table 6-1 to Table 6-6) are divided by major functional group. Each table shows the complete name of the command and the cards for which the command is valid. These tables do not make a distinction between which PXM processor card supports a particular command.
For information on which of the PXM processor cards a command is supported on, consult the individual pages describing each command. On the individual pages describing each command the following conventions are used in describing which PXM processor card a command is supported on:
•If no distinction is called out between the different PXM processor cards a command may be supported on, then the command is supported on all three of the current PXM processor cards (PXM1, PXM1E, and PXM45).
•If a command is valid only on an individual PXM processor card, then this distinction will be called out and identified.
Examples of usage for the more common commands appear in the configuration chapters of this manual.
The privilege levels of the CESM and MPSM commands can be found on the individual pages describing each command, or they can be found at the CLI by using the help or the ? command. Only those commands available at the user's login privilege level and below will be seen on the CLI and available for use by the user.
For information about navigating the command-line interface, refer to the Cisco MGX 8800/8900 Series Configuration Guide, Release 5.2, and the Cisco MGX 8850 Edge Concentrator Installation and Configuration, Release 1.1.3 documentation.
Tip If you are viewing this material in a book- or chapter-length PDF file, you can click on any command in the following tables to link to the description for that command. You can also click on commands listed in the "Related Commands" sections to link to command descriptions.
?
Help—MPSM-8T1-CES, MPSM-8E1-CES, CESM-8T1/B, CESM-8T1, CESM-8E1
Use the ? command to display a list of the commands supported on the CESM and MPSM card.
Syntax
?
Syntax Description
None
Related Commands
Help
Attributes
Log: No
|
State: Any
|
Privilege: Any User
|
Example
Command list for the current card.
Command Logging State Priority
-------------------- ------- ------ -------------------------
addcon Yes Active Group 2
addconCDVT Yes Active Group 2
addlnloop Yes Active Service Group (-1)
addport Yes Active Group 1
addrscprtn No Any Strata Group (-2)
addspvc Yes Active Group 2
chkflash No Any Strata Group (-2)
clralmcnts No Any Group 5
clrcderrs No Any Super Group (0)
clrchancnt No Any Group 5
clrchancnts No Any Group 3
clrds1stats No Any Group 5
Type <CR> to continue, Q<CR> to stop:
addcdrscprtn
Add Card Resource Partition (PXM1 only)—MPSM-8T1-CES, MPSM-8E1-CES, CESM-8T1/B, CESM-8T1, CESM-8E1
Use the addcdrscprtn command to add a card-level resource partition to the current CESM or MPSM card.
Syntax
addcdrscprtn <controller> <numOfLcnAvail>
Syntax Description
controller
|
Controller type for the resource partition.
•1 = PAR (PVC)
•2 = PNNI (SPVC)
•3 = TAG (MPLS)
|
numOfLcnAvail
|
Number of LCNs (connections) available for the resource partition. Range by card type:
•CESM-8T1/B, CESM-8T1, MPSM-8T1-CES range: 1-192
•CESM-8E1, MPSM-8E1-CES range: 1-248
|
Related Commands
cnfcdrscprtn, delcdrscprtn, dspcdrscprtn, xcnfcdrscprtn
Attributes: MPSM-8T1-CES, MPSM-8E1-CES
Log: Yes
|
State: Active
|
Privilege: Group 1
|
Attributes: CESM-8T1/B, CESM-8T1, CESM-8E1
Log: No
|
State: Any
|
Privilege: Any User
|
Example
Add to the current MPSM card a resource partition that uses a TAG (MPLS) controller with 100 LCNs (connections) available.
M8250_SJ.1.22.MPSM8T1.CES.a > addcdrscprtn 3 100
M8250_SJ.1.22.MPSM8T1.CES.a >
addchan
Add Channel (PXM1 only)—MPSM-8T1-CES, MPSM-8E1-CES, CESM-8T1/B, CESM-8T1, CESM-8E1
Use the addchan command to add a Permanent Virtual Connection (PVC) to a port on the current CESM or MPSM card.
Note This command is not supported in Cisco MGX Release 1.3.
Syntax
addchan <chan_num> <port_num> <sig_type> <partial_fill> <cond_data> <cond_signalling>
[<mastership>] [<locnsap>] [<rmtvpi>] [<rmtvci>] [<rmtnsap>]
Syntax Description
chan
|
Enter the channel number of the connection you want to add. The dspchans command reports shows the channel number for each configured connection. On the PXM1 platform, the channel number is found in the ChNum column.
•On PXM1 platforms:
–T1 Channel Range = 32-223
–E1 Channel Range = 32-279
|
port_num
|
Enter the port number to which you will add the connection. To display a list of configured ports, enter the dspports command. The port number is found in the Port column in the format Slot.Line.Port. The port number range varies with the card type:
•CESM-8T1/B, CESM-8T1, MPSM-8T1-CES range: 1-192
•CESM-8E1, MPSM-8E1-CES range: 1-248
|
sig_type
|
Channel associated signalling (CAS) value.
•Basic = 1
•E1 CAS = 2
•DS1 superframe CAS = 3
•DS1 extended superframe CAS = 4
•Conditioned E1 CAS = 6
•1x64 Basic without AAL1 Pointer = 7
•DS1 SF CAS MF (available with multiframe option enabled) = 8 (Supported only on CESM-8T1/B)
•DS1 ESF CAS MF (available with multiframe option enabled) = 9 (Supported only on CESM-8T1/B)
Note The channels on a particular line can be either all MF (SF MF or ESF MF) or all non-MF (SF or ESF). The first connection type added on a particular line (MF/non-MF) decides the sync. mode. The second connection must have the same cesCAS type, and so on.
|
partial_fill
|
Partial fill for ATM cells. This option determines how many bytes must be assembled before an ATM cell is sent across the network. Partially filled cells take less time to assemble and reduce transmission delay. However, partially filled cells consume more ATM network bandwidth. You can select the number of bytes for ATM cells as follows:
•Fully filled (48 bytes) = 0
•Structured T1 range = 25 to 47.
•Structured E1 range = 20 to 47.
•Unstructured T1/E1 range = 33 to 47.
Note For structured connections other than Basic and 1x64 Basic without AAL1 Pointer, the partial fill value should be greater than the number of DS0s assigned to port + 1.
|
cond_data
|
Conditional data is the bit pattern that is used in the data timeslots when there is an underflow or when there is a loss of signal (LOS). For a voice connection, the larger the ConditionalData value, the louder the hiss heard during LOS. The data pattern is configured as a base-10 number to represent an 8-bit binary code.
•UDT = 255
•SDT range = 0 to 255
|
cond_signalling
|
Conditional signalling is the signalling bits that are sent on the line when there is an underflow and also toward the network when forming dummy cells. Conditional signalling is a string of bits that you specify with a base-10 number in the range 0-15, where, for example, 15=1111, and 0=0000. These bits represent the four binary signalling bits (A, B, C, and D) to the line or network when an underflow occurs.
|
mastership
|
Mastership role of connection. Select from the following options:
•1 = Master
•2 = Slave (default)
•3 = Unknown (MPSM-8T1/E1-CES on PXM1 only)
|
locnsap
|
Local NSAP address. The local NSAP is a 20 byte hex number.
|
rmtvpi
|
Remote virtual path identifier (VPI).
•MPSM-8T1-CES, MPSM-8E1-CES range: 1-4095
•CESM-8T1/B, CESM-8T1, CESM-8E1 range: 1-65535
|
rmtvci
|
Remote virtual channel identifier (VCI) value. Range is 1-65535
|
rmtnsap
|
Remote NSAP address. The local NSAP is a 20 byte hex number.
|
Related Commands
addcon, addconCDVT, cnfchan, delchan, dspchan, dspchans, xcnfchan
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 1
|
addchanloop
Add a Channel Loopback—MPSM-8T1-CES, MPSM-8E1-CES
Use the addchanloop command to configure a channel loopback to the current MPSM card. This command causes the channel to loop at the segmentation and reassembly (SAR) stage. For additional information on loopbacks that the MPSM card supports, see Chapter 5, "Managing CESM and MPSM Cards."
Tip To view the loopback status of a connection, use the dspcon command and look for the line labeled ChanLocalRemoteLpbkState.
Syntax
addchanloop <chan number>
Syntax Description
chan number
|
Enter the channel number as it appears in the output of the dspcons and dspchans commands.
•On PXM1E, PXM45 platforms:
–T1 Channel Range = 35-226
–E1 Channel Range = 35-282
•On PXM1 platforms:
–T1 Channel Range = 32-223
–E1 Channel Range = 32-279
Tip On PXM1E and PXM45 platforms, the channel number is found in the LCN column in the output of the dspcons and dspchans commands. On the PXM1 platform, the channel number is found in the ChNum column in the output of the dspcons and dspchans commands.
|
Related Commands
delchanloop, dspchans, dspcons, tstchan, tstcon, tstdelay, xcnfchan, xcnfcon
Attributes
Log: Yes
|
State: Active
|
Privilege: Group 1
|
Example
Add a channel loopback to channel number 35 on the current MPSM card.
M8850_SF.1.28.MPSM8T1.CES.a > addchanloop 35
M8850_SF.1.28.MPSM8T1.CES.a >
addcon
Add Connection—MPSM-8T1-CES, MPSM-8E1-CES, CESM-8T1/B, CESM-8T1, CESM-8E1
Use the addcon command to configure a Soft Permanent Virtual Circuit (SPVC) or a Permanent Virtual Circuit (PVC) on a port on the current CESM or MPSM card. SPVCs are supported on the PXM1E/PXM45 platform, and PVCs are supported on the PXM1 platform.
When you add a connection, the software checks the configuration at the remote end to be sure the remote connection configuration is compatible. If the local and remote configuration parameters are not compatible, the connection is not added.
Syntax: MPSM-8T1-CES, MPSM-8E1-CES, CESM-8T1/B, CESM-8T1, CESM-8E1 on PXM1E, PXM45
addcon <port_num> [-master <MasterShip>] [-rmc <RemoteConnId>] [-pf <PartialFill>]
[-condat <ConditionalData>] [-condsig <ConditionalSigCode>] [-cdv <CDVT>]
[-cas <SignallingType>] [-clip <CellLossIntegPeriod>] [-maxbuf <MaximumBufferSize>]
[-clkmode <ClockMode>] [-contp <ControllerType>] [-rtngprio <RoutingPriority>]
[-prefrte <PreferredRouteID>] [-directrte <DirectedRoute>] [-maxcost <MaxCost>]
[-type <RestrictedType>] [-cos <connServiceType>]
Note•If the addcon command fails on the PXM1E or PXM45 platform and displays the "Failed to update disk" message, it could be that the PNNI controller has not been added on the PXM1E or PXM45 card. For information on adding the PNNI controller, refer to the Cisco MGX 8800/8900 Series Configuration Guide, Release 5.2.
•If the addcon command fails on the PXM1E or PXM45 platform and displays the "InvalidTrafficParm: check conformance or local/remote param mismatch" message, it could be that the local connection parameters on the slave/master endpoint do not match the remote connection parameters on the master/slave endpoint. To successfully add a connection both the local and remote connection parameters must match.
Syntax: MPSM-8T1-CES, MPSM-8E1-CES, CESM-8T1/B, CESM-8T1, CESM-8E1 on PXM1
addcon <port_num> <sig_type> <partial_fill> <cond_data> <cond_signalling>
[<controller_type> [<mastership> [<remoteConnID>]]]
Syntax Description
port_num
|
Enter the port number to which you will add the connection. To display a list of configured ports, enter the dspports command. The port number is found in the Port column in the format Slot.Line.Port. The port number range varies with the card type:
•CESM-8T1/B, CESM-8T1, MPSM-8T1-CES range: 1-192
•CESM-8E1, MPSM-8E1-CES range: 1-248
|
-master,
mastership
|
Mastership role of connection. Select from the following options:
•1 = Master
•2 = Slave (default)
•3 = Unknown (MPSM-8T1/E1-CES on PXM1 only)
|
-rmc,
remoteConnID
|
Remote connection ID. This option is used when defining the master end of a connection. After issuing the addcon command to create the slave side of a double-ended connection, use the generated slave connection ID with this option.
•On PXM1E, PXM45 platforms the format is:
–RemoteNsapAddress.VPI.VCI.
•On PXM1 platforms the format can be one of the following:
–NodeName.SlotNo.PortNo.0.0 for CES end point
–NodeName.SlotNo.PortNo.VPI.VCI for ATM end point (Use a value of 0 when SlotNo = PXM)
Tip You can view the address components for a slave or master connection using the dspcon or dspchan command.
|
-pf,
partial_fill
|
Partial fill for ATM cells. This option determines how many bytes must be assembled before an ATM cell is sent across the network. Partially filled cells take less time to assemble and reduce transmission delay. However, partially filled cells consume more ATM network bandwidth. You can select the number of bytes for ATM cells as follows:
•Fully filled (48 bytes) = 0
•Structured T1 range = 25 to 47.
•Structured E1 range = 20 to 47.
•Unstructured T1/E1 range = 33 to 47.
Note For structured connections other than Basic and 1x64 Basic without AAL1 Pointer, the partial fill value should be greater than the number of DS0s assigned to port + 1.
|
-condat,
cond_data
|
Conditional data is the bit pattern that is used in the data timeslots when there is an underflow or when there is a loss of signal (LOS). For a voice connection, the larger the ConditionalData value, the louder the hiss heard during LOS. The data pattern is configured as a base-10 number to represent an 8-bit binary code.
•UDT = 255
•SDT range = 0 to 255
|
-condsig,
cond_signalling
|
Conditional signalling is the signalling bits that are sent on the line when there is an underflow and also toward the network when forming dummy cells. Conditional signalling is a string of bits that you specify with a base-10 number in the range 0-15, where, for example, 15=1111, and 0=0000. These bits represent the four binary signalling bits (A, B, C, and D) to the line or network when an underflow occurs.
|
-cdv
|
The Cell Delay Variation Time (CDVT) determines the amount of delay variation in the network that can be accommodated by the egress buffer. The CDVT value is how much the egress buffer is filled before sending cells to the attached CPE. This parameter allows you to configure the maximum cell arrival jitter that the reassembly process will tolerate in the cell stream without producing errors on the CBR service interface. Enter the CDVT in increments of 125 microseconds:
•T1 range = 125-24000 microseconds
•E1 range = 125-26000 microseconds
|
-cas,
sig_type
|
Channel associated signalling (CAS) value.
•Basic = 1
•E1 CAS = 2
•DS1 superframe CAS = 3
•DS1 extended superframe CAS = 4
•CCS = 5 (PXM1E, PXM45 only)
•Conditioned E1 CAS = 6
•1x64 Basic without AAL1 Pointer = 7
•DS1 SF CAS MF (available with multiframe option enabled) = 8 (Supported only on CESM-8T1/B)
•DS1 ESF CAS MF (available with multiframe option enabled) = 9 (Supported only on CESM-8T1/B)
Note The channels on a particular line can be either all MF (SF MF or ESF MF) or all non-MF (SF or ESF). The first connection type added on a particular line (MF/non-MF) decides the sync. mode. The second connection must have the same cesCAS type, and so on.
|
-clip
|
The Cell loss integration period (CLIP) is the amount of time the egress buffer can be under run before an alarm is declared. Range: 1000 to 65535 milliseconds.
|
-maxbuf
|
Maximum egress buffer size in bytes. Buffers are used to mitigate variations in the cell delay. The size can be automatically computed, or you can enter a specific size in bytes. The ranges are as follows:
•Autocompute = 0
•Minimum value = the greater of {(CDVT in frames*2)*N or (CDVT + frames in 2 cells) * N}
•T1/E1 UDT maximum value = 16224
•T1 SDT maximum value = 384*N
•E1 SDT maximum value = 417*N
N = Number of 64 Kbps time slots (SDT) = 32 (T1/E1 UDT)
|
-clkmode
|
Clock mode.
•Synchronous = 1
•SRTS (asynchronous) = 2
•Adaptive (asynchronous) = 3
|
-contp,
controller_type
|
The Virtual Switch Interface (VSI) controller type that manages the connection.
•On PXM1E, PXM45 platforms:
–1 = PAR
–2 = PNNI (default)
–3 = MPLS
•On PXM1 platforms:
–1 = PAR (PVC) (Default)
–2 = PNNI (SPVC)
|
-rtngprio
|
Routing priority for this connection. This parameter defines the rerouting derouting priority of the connection. Range is 1 to 15. Default setting is 8.
|
