These commands are all simple to use and have no command parameters except the virtual terminal command (vt), in which you must specify the node name, and the help commands, in which you must enter a command character string.

Command	Description	Type	Page
.	Display command history	BPX, IGX	3-1
help or ?	Help	BPX, IGX	4-407
bye	End user session	BPX, IGX	3-95
clrscrn	Clear screen	BPX, IGX	3-115
prtscrn	Print screen	BPX, IGX	4-428
redscrn	Redraw screen	BPX, IGX	4-433
vt	Make a virtual terminal connection	BPX, IGX	4-485

Setting Up Nodes

This group of commands are used to set up an IGX or BPX node. (You must set up each node before you build the network.) This group also contains commands to:

Configure a node name and time zone.
Add and remove a network node.
Add and remove an interface shelf in a tiered network.
View a node's configuration.
Specify Y-cable redundancy for cards in the node.
Start a window session to an external device or specify an interface to an attached terminal.
Sending A-bit Notification on ILMI/LMI Using Configurable Timer

Command	Description	Type	Page
addad	Add access device	BPX, IGX	3-3
addalmslot	Add an alarm slot	BPX, IGX	3-4
addcdred	Add card redundancy for SONET APS 1+1 across two BXM cards	BPX	3-7
addshelf	Add a trunk between an IGX or BPX core switch shelf and an interface shelf	BPX, IGX, MGX, SES	3-77
addyred	Add Y-cable redundancy	BPX, IGX	3-89
cnfasm	Configure ASM card	BPX, IGX	3-135
cnfdate	Configure date	BPX, IGX	3-224
cnffunc	Configure system function	BPX, IGX	3-254
cnfname	Configure node name	BPX, IGX	3-302
cnfprt	Configure printing functions	BPX, IGX	3-379
cnfterm	Configure terminal port	BPX, IGX	3-449
cnftime	Configure time	BPX, IGX	3-453
cnftmzn	Configure time zone	BPX, IGX	3-456
delalmslot	Delete alarm slot	IGX	4-5
delshelf	Delete a trunk between a IGX/BPX core switch shelf and interface shelf	BPX, IGX	4-22
delyred	Delete Y-cable redundancy	BPX, IGX	4-29
dspasm	Display ASM card configuration	BPX	4-52
dspcd	Display card	BPX, IGX	4-76
dspcds	Display cards	BPX, IGX	4-83
dsplancnf	Display LAN configuration	BPX, IGX	4-184
dspctrlrs	Display all PNNI VSI controllers on a BPX node	BPX, IGX	4-158
dsplmistats	Display LMI Statistics	BPX, IGX/AF	4-188
dspnds	Display nodes	BPX, IGX	4-220
dspnode	Display summary information about interface shelves	BPX, IGX/AF	4-223
dsptermcnf	Display terminal configuration	BPX, IGX	4-351
dsptermfunc	Display terminal port configuration	BPX, IGX	4-352
dspprtcnf	Display print configuration	BPX, IGX	4-279
dsppwr	Display power	BPX, IGX	4-281
dspcdred	Display Y-cable redundancy (displays card redundancy for SONET Automatic Protection Switching). Alias for dspyred	BPX, IGX	4-81
dspyred	Display Y-cable redundancy	BPX, IGX	4-403
prtcdred	Print card redundancy Alias for prtyred.	BPX, IGX	4-432
prtyred	Print Y-cable redundancy	BPX, IGX	4-432
upcd	Up card	BPX, IGX	4-471
window	Window to external device	BPX, IGX	4-487

Setting Up Lines

A circuit line is the physical line that carries data, voice, Frame Relay, or ATM traffic between an IGX or BPX node and customer premises equipment (CPE). Each piece of customer premises equipment is attached to a node through a circuit line. After a card has been "upped" with the upcd command, a circuit line on that card can be "upped" and configured.

Line commands are the same as circuit line commands. However, the cnfcln command is no longer used; use cnfln instead. The switch software prompts for the parameters appropriate for the card type it detects.

Command	Description	Type	Page
cnfcassw	Configure CAS switching	IGX	3-149
cnfln	Configure line (alias for cnfcln)	BPX, IGX	3-268
cnfphylnstats	Configure physical line statistics	BPX, IGX, SU	3-372
cnfport	Configure a port	BPX, IGX	3-337
cnfrsrc	Configure resources	BPX, IGX	3-393
dnln	Down line (alias for dncln)	BPX, IGX	4-36
dspphylnstatcnf	Display physical line statistics configuration	BPX, IGX, SU	4-240
dspphylnstathist	Displays the physical line statistics history	BPX, IGX, SU	4-244
dsplncnf	Display line configuration (alias for dspclncnf)	BPX, IGX	4-194
dsplns	Display lines (alias for dspclns)	BPX, IGX	4-200
dspport	Displays information about a specific port.	BPX, IGX	4-246
dsptsmap	Display time slot map	BPX, IGX	4-391
prtlns	Print circuit lines (alias for prtclns)	BPX, IGX	4-424
upln	Up line (alias for upcln)	BPX, IGX	4-477

Setting Up Trunks

After you have configured the nodes, you must activate the trunks. Trunks are intra-node communication links in a network. A trunk can connect any combination of IGX or BPX nodes.

Before executing the commands in this section, you must have finished setting up the nodes. Also, the front and back cards that support the proposed line type and communication technology must reside in the slot intended for the trunk.

In this release, the Ports and Trunks feature, which is supported on the BPX and IGX, allows you to configure port, routing trunk and feeder trunk interfaces simultaneously on a slot containing a BXM or UXM card. For example, you can up port 1 on a BXM slot as a trunk interface while also upping port 2 as a line interface. For BXM and UXM cards, you do not need to upgrade the firmware.

You cannot use a virtual trunk as an interface shelf (feeder) trunk; similarly, you cannot configure an interface shelf trunk to act as a virtual trunk, nor can you terminate interface shelf (feeder) connections on a virtual trunk.

Command	Description	Type	Page
addapsln	Add SONET APS line redundancy to a BXM OC-3 or OC-12 card	BPX	3-5
addtrk	Add trunk	BPX, IGX	3-85
addtrkred	Add trunk redundancy	BPX, IGX	3-87
cnfapsln	Configure APS parameters on a working line of redundant pair	BPX	3-132
cnfrsrc	Configure resources	BPX, IGX	3-393
cnftrk	Configure trunk	BPX, IGX	3-458
cnftrkalm	Configure trunk alarm	BPX, IGX	3-477
cnftrkict	Configure trunk interface control template	IGX	3-481
cpytrkict	Copy trunk interface control template	IGX	3-521
delapsln	Delete SONET APS line from a BXM OC-3 or OC-12 card	BPX	4-50
deltrk	Delete trunk	BPX, IGX	4-24
deltrkred	Delete trunk redundancy	IGX	4-26
dntrk	Down trunk	BPX, IGX	4-39
dspapsln	Display currently configured APS lines and their status	BPX	4-50
dspcntrstats	Display counter statistics for a given statistics object	BPX, IGX	4-129
dspnw	Display network	BPX, IGX	4-225
dspphyslns	Display lines in an IMA trunk	IGX	4-237
dspphyslnstathist	Display statistics gathered for lines in an IMA trunk	IGX	4-353
dsptrkbob	Display trunk breakout box	IGX	4-353
dsptrkcnf	Display trunk configuration	BPX, IGX	4-354
dsptrkict	Display trunk interface control template	IGX	4-364
dsptrkred	Display trunk redundancy	BPX, IGX	4-366
dsptrks	Display trunks	BPX, IGX	4-367
dsptrkstats	Display trunk statistics	BPX, IGX	4-376
prtnw	Print network	BPX, IGX	4-413
prttrkict	Print trunk interface control template	IGX	4-430
prttrks	Print trunks	BPX, IGX	4-431
printapsln	Print the APS line redundancy switching interface	BPX	4-451
switchapsln	Control the APS line redundancy switching interface	BPX	4-451
uptrk	Up trunk	BPX, IGX	4-480

Voice Connections

The voice commands apply to setting up, configuring, and statistical reporting for voice connections (including FAX). You use these commands to add a voice connection, configure card redundancy, and optimize the use of voice activity detection (VAD).

Voice connections exist as ports on circuit lines supported by a Channelized Voice Module (CVM) or Universal Voice Module (UVM) in an IGX node. The back card for the CDP or CVM is either a BC-T1, BC-E1, or BC-J1. For the UVM, the back card is either a BC-UVI-2T1EC, a BC-UVI-2J1EC, or BC-UVI-2E1EC.

Command	Description	Type	Page
addcon	Add channel voice connection	IGX	3-100
cnfchadv	Configure channel adaptive voice	IGX	3-179
cnfchdl	Configure channel dial type	IGX	3-181
cnfchec	Configure channel echo canceller	IGX	3-183
cnfchfax	Configure fax modem detection for channels (UVM)	IGX	3-186
cnfchgn	Configure channel gain insertion	IGX	3-187
cnfcond	Configure conditioning template	IGX	3-218
cnfdch	Configure data connection to have idle code suppression enabled/disabled	IGX	3-284
cnflnpass	Configure line pass	IGX	3-284
cnfrcvsig	Configure receive signaling	IGX	3-389
cnfvchtp	Configure voice channel interface type	IGX	3-511
cnfxmtsig	Configure transmit signaling	IGX	3-517
delcon	Delete connection	BPX, IGX	4-8
dspchcnf	Display channel configuration	IGX	4-89
dspchdlcnf	Display channel dial type configuration	IGX	4-92
dspchec	Display channel echo canceller	IGX	4-94
dspcon	Display connection	IGX	4-132
dspcond	Display conditioning template	IGX	4-147
dspcons	Display connections	BPX, IGX	4-148
dspconst	Display connection state	IGX	4-156
dspsigqual	Display signal qualifiers	IGX	4-302
dspsvcst	Display voice SVC statistics	IGX	4-347
prtchcnf	Print channel configuration	IGX	4-415
prtchdlcnf	Print channel dial type configuration	IGX	4-416
prtcons	Print connections	IGX	4-418

Universal Router Module

The Universal Router Module (URM) provides IOS-based voice support and basic routing functions on the IGX 8400. The URM is functionally equivalent to a UXM card with one ATM port and an IOS router.

Management of the URM is different from other IGX cards. The IGX CLI is used to manage the embedded UXM and internal ATM port. The IOS CLI and IOS management applications are used to manage the embedded router.

The IGX CLI is enhanced to provide features that facilitate serviceability and monitoring of the URM embedded IOS-based router.

Command	Description	Type	Page
cnfrtrparm	SuperUser. Configures certain router parameters on a specific router slot. Parameters include common action, router reset, and write to bootflash.	IGX	3-426
cnfrtr	Configures certain router parameters on a specific router slot. Parameters include IOS configuration file source and serial port function.	IGX	3-422
dsprtr	Reports the router configuration on a specific router slot.	IGX	4-303
dsprtrslot	Reports router operational information on a specific router slot. Operational information includes: card type, VIC type, IOS software image name, router operational state, and router alarm status.	IGX	4-304
dsprtrslots	Reports router operational information for all router slots in the IGX. Operational information includes: card type, VIC type, and router alarm status.	IGX	4-307
dspalms	Reports router IOS status alarms for all router slots in the IGX.	IGX	4-46
rstrtr	Resets the router on a specified router slot.	IGX	4-440

Data Connections

These commands apply to setting up, configuring, and statistical reporting on data connections:

Setting up a circuit line and a data connection
Configuring data channel redundancy
Using interface control templates
Enabling DFM and data channel utilization
Enabling Embedded EIA operation
Setting up DDS trunks
Configuring idle code suppression on a per-connection basis

Command	Description	Type	Page
addcon	Add a data channel connection	IGX	3-7
cnfchdfm	Configure Data Frame Multiplexing (DFM)	IGX	3-180
cnfcheia	Configure EIA	IGX	3-185
cnfcldir	Configure control lead direction	IGX	3-199
cnfdchtp	Configure data channel interface type	IGX	3-226
cnfdch	Configure data connection to have ICS (Idle Code Suppression)	IGX	3-226
cnfdclk	Configure data clock	IGX	3-233
cnfict	Configure interface control template	IGX	3-258
cpyict	Copy interface control template	IGX	3-520
delcon	Delete connection	BPX, IGX	4-9
dspchcnf	Display channel configuration	IGX	4-89
dspcons	Display connections	BPX, IGX	4-148
dspict	Display interface control template	IGX	4-180
prtchcnf	Print channel configuration	IGX	4-416
prtcons	Print connections	IGX	4-418
prtict	Print interface control template	IGX	4-420

Frame Relay Connections

The Frame Relay commands let you add, configure, delete, and specify statistical reporting for Frame Relay connections:

Set up a Frame Relay connection
Use Frame Relay classes
Use interface control templates
Configure channel utilization
Set channel priorities
Display statistics

In an IGX node, the Frame Relay commands in this chapter operate on an FRM or UFM card set. For the Frame Relay commands that operate on an FRSM in an MGX 8220 shelf, refer to the Cisco MGX 8220 Command Reference. For the Frame Relay commands that operate on the FastPADs and supporting service cards, refer to the FastPAD manuals.

For a greater number of low-speed connections, the Port Concentrator Shelf (PCS) is available. In an IGX node, the PCS is an external device that requires an FRM-2/FRI-2 card set. The system recognizes an FRM-2 or FRC-2 and accepts commands for the PCS.

A connection is the same as a PVC (permanent virtual circuit).

Command	Name	Type	Page
addcon	Add Frame Relay connection	BPX, IGX	3-100
addport	Add Frame Relay port T1/E1. (The command addfrport is an older alias)	IGX	3-68
clrchstats	Clear Frame Relay channel statistics	IGX	3-98
clrfrcportstats	Clear FRC/FRM Port Concentrator link statistics	BPX, IGX	3-103
cnfchpri	Configure Frame Relay channel priority	IGX	3-188
cnffrcls	Configure Frame Relay class	IGX	3-245
cnffrcon	Configure Frame Relay connection	IGX	3-248
cnffrcport	Configure Frame Relay port on a Port Concentrator Shelf	IGX	3-250
cnfict	Configure interface control template	IGX	3-262
cnfmode	Configure mode	IGX	3-297
cpyict	Copy interface control template	IGX	3-520
delcon	Delete connection	BPX, IGX	4-10
delfrport	Delete Frame Relay port using T1 or E1 Lines	IGX	4-14
dnfrport	Down Frame Relay port. An alias for dnport.	BPX, IGX	4-36
dspchcnf	Display channel configuration	IGX	4-91
dspchstats	Display channel statistics	BPX, IGX	4-100
dspcon	Display connection	IGX	4-136
dspcons	Display connections	BPX, IGX	4-148
dspfrcls	Display Frame Relay class	IGX	4-168
dspfrport	Display Frame Relay port. An alias for dspport	BPX, IGX	4-171
dspict	Display interface control template	IGX	4-237
dspmode	Display mode	IGX	4-217
dspmodes	Display modes	BPX, IGX	4-219
dsppcs	Display Port Concentrator Shelf	IGX	4-231
dspportids	Display port IDs	BPX, IGX	4-253
dspportstats	Display port statistics	BPX, IGX	4-264
prtchcnf	Print channel configuration	IGX	4-415
prtcons	Print connections	IGX	4-420
prtict	Print interface control template	IGX	4-421
upfrport	Up Frame Relay port. An alias for upport	BPX, IGX	4-474

ATM Connections

These commands let you activate and configure ATM connections, as well as statistical reporting for these connections, at an ATM UNI in a BPX or IGX node. You can add ATM connections to an ASI or BXM in a BPX node, and to a UXM or URM in an IGX node. For details on ATM commands and other support on an MGX 8220 shelf, refer to the MGX 8220 documentation. For details on ATM commands on an MGX 8550 shelf, refer to the MGX 8550 documentation.

Command	Description	Type	Page
addcon	Add ATM connection	BPX, IGX	3-100
addport	Add ATM or Frame Relay port	BPX, IGX	3-68
clrchstats	Clear channel statistics	BPX, IGX	3-98
cnfatmcls	Configure ATM class template	BPX, IGX	3-137
cnfcls	Configure class template	BPX, IGX	3-206
cnfcon	Configure connection	BPX, IGX	3-248
cnfport	Configure ATM or Frame Relay port. (Use instead of older cnffrport alias)	BPX, IGX	3-252
cnfportq	Configure port queue parameters	BPX, IGX	3-369
cnfrtr	Configure Universal Router Module embedded router	IGX	3-422
delcon	Delete connection	BPX, IGX	4-10
delport	Delete ATM port	BPX, IGX	4-20
dnport	Down port	BPX, IGX	4-37
dspportq	Display ARM port Qbin information	BPX, IGX	4-254
dspatmcls	Display ATM connection class	BPX, IGX	4-53
dspchstats	Display all embedded statistics for a channel	BPX, IGX	4-100
dspcls	Display connection class	BPX, IGX	4-124
dspcntrstats	Display counter status statistics	BPX, IGX	4-129
dspcon	Display ATM connections	BPX, IGX	4-138
dspconcnf	Display connection configuration	BPX	4-145
dspcons	Display connections	BPX, IGX	4-148
dsplmistats	Display Annex G LMI statistics	BPX, IGX/AF	4-189
dspnebdisc	Display Neighbor Discovery	BPX, IGX	4-171
dspport	Display port	BPX, IGX	4-246
dspportq	Display Automatic Routing Management port queue	BPX, IGX	4-254
dspports	Display all ports that exist on the node	BPX, IGX	4-237
dspportstats	Display Frame Relay port statistics	BPX, IGX	4-237
dspqbinstats	Display Qbin summary statistics	BPX, IGX	4-288
dsprtcache	Display cost-based route cache	BPX, IGX	4-302
dsprtr	Display Universal Router Module embedded router configuration	IGX	4-303
dsprtrslot	Display operational information for a specified Universal Router Module embedded router	IGX	4-304
dsprtrslots	Display summary of operational information for all Universal Router Module embedded routers	IGX	4-307
rstrtr	Reset Universal Router Module embedded router	IGX	4-440
upport	Up port	BPX, IGX	4-478

Optimizing Traffic Routing and Bandwidth

To achieve peak network performance, the routing of traffic and the use of available bandwidth is configurable. The information used in configuring traffic routing and bandwidth is gathered from historical network trends. These commands are used to complete those tasks required to optimize the network: specifying channel utilization, specifying the class of service (including the use of the priority bumping feature), and managing bandwidth.

Command	Description	Type	Page
cnfbmpparm	Configure priority bumping	BPX, IGX	3-139
cnfchutl	Configure channel utilization	IGX	3-100
cnfcmb	Configure combined timeout parameters	IGX	3-208
cnfcon	Configure a connection	BPX, IGX	3-216
cnfcos	Configure class of service	IGX	3-201
cnfpref	Configure preferred route for connections	BPX, IGX	4-119
cnfrtcost	Configure cost based routing	BPX, IGX	3-420
dncon	Down connections	IGX	4-160
dspbmpparm	Display priority bumping parameters	BPX, IGX	4-55
dspload	Display connection loading	BPX, IGX	4-55
dspospace	Display open space for routes	BPX, IGX	4-230
dsprts	Display connection routing	BPX, IGX	4-303
dsptrkutl	Display trunk utilization	BPX, IGX	4-386
prtrts	Print connection routes	BPX, IGX	4-427
upcon	Up connections	IGX	4-472

Synchronizing Network Clocks

These commands are used to synchronize a network.

The designation of the clock source depends on the stratum (or stability) of the clock source. Each node in the network synchronizes to the nearest (fewest number of hops) primary clock source. If no primary source is available, the nearest secondary clock source is used, and so on. If no other source is available, the network synchronizes to the internal oscillator of one of the nodes in the network.

Command	Description	Type	Page
clrclkalm	Clears an alarm associated with a clock source. The cause of an alarm usually clock source that fails or is outside of the frequency limits. You must clear a clock alarm before the corresponding clock source is usable.	BPX, IGX	3-100
cnfclksrc	Configure network clock source. Specifies a primary, secondary, or tertiary clock source in a network	BPX, IGX	3-201
dspclksrcs	Displays all the currently defined network clock sources.	BPX, IGX	4-119
dspcurclk	Displays the clock source that the network is currently using.	BPX, IGX	4-160

Managing Jobs

A job is a user-specified string of commands. A job can automatically execute on a prearranged schedule or upon an event trigger. Use these commands to:

Create a job
Run a job
Stop a job
Display one or more jobs
Edit a job
Delete a job
Create a job trigger

The system assigns a number to a new job. This job number identifies the job and is a required parameter for most job control commands. When you create a new job, the current privilege level is automatically saved as the privilege level of the job. Only commands that are available at your privilege level can be in your job specification. For example, a user whose highest privilege level is 3 cannot include the addtrk command in a job because addtrk requires a level 1 privilege. This privilege requirement also applies to other job functions, such as running, editing, or stopping a job.

Not all Cisco WAN Switching commands can execute as a part of a job. For this reason, the Attributes section of each command description in this manual states whether the command can function in a job.

Command	Description	Type	Page
addjob	Add a job	BPX, IGX	3-52
addjobtrig	Add a job trigger	BPX, IGX	3-55
deljob	Delete a job	BPX, IGX	4-16
deljobtrig	Delete job trigger	BPX, IGX	4-160
dspjob	Display a job	BPX, IGX	4-182
dspjobs	Display jobs	BPX, IGX	4-183
editjob	Edit a job	BPX, IGX	4-404
prtjob	Print a job	BPX, IGX	4-404
prtjobs	Print jobs	BPX, IGX	4-422
runjob	Run a job	BPX, IGX	4-444
stopjob	Stop a job	BPX, IGX	4-448

Managing the Network

These commands are used for network administration: signing on and off, creating a password, setting the network date and time, and adding a user.

Command	Description	Type	Page
adduser	Add user(s)	BPX, IGX	3-100
cnfpwd	Configure password	BPX, IGX	4-160
cnffwswinit	Configure Cisco WAN Manager node IP address for the firmware and software initiator	BPX, IGX	3-257
cnfsnmp	Configure SNMP parameters	BPX, IGX	4-182
cnfstatmast	Configure statistics master SV+ address	BPX, IGX	4-183
cnfsysparm	Configure system parameters	BPX, IGX	3-443
deluser	Delete user	BPX, IGX	4-28
dsplanip	Display LAN IP address of all nodes in network	IGX	4-186
dspnwip	Display network IP interface	BPX, IGX	4-229
dsppwd	Display password	BPX, IGX	4-280
dspsnmp	Display SNMP parameters	BPX, IGX	4-339
dspsnmpstats	Display SNMP statistics	BPX, IGX	4-340
dspsv3	Display WAN manager Layer 3 link control blocks	BPX, IGX	4-342
dsptsmap	Display the channel-to-timeslot mapping usage	BPX, IGX	4-391
dspusers	Display users	BPX, IGX	4-392
dspusertask	Display user task	BPX, IGX	4-393
dspusertasks	Display all user tasks	BPX, IGX	4-395

Statistics

Command	Full Name	Type	Page
clrchstats	Clear channel statistics	IGX	3-98
cnflnstats	Configure line statistics collection	BPX, IGX, SU	3-3
cnfphyslnstats	Configure physical line statistics collection (OC-3)	IGX, SU	3-372
cnfportstats	Configure port statistics collection	BPX, IGX, SU	3-372
cnfrobparm	Configure robust alarms parameters	BPX, IGX, SU	3-391
cnfrtrparm	Configure universal router module (URM) embedded router parameters	IGX, URM, SU	3-426
cnfslotstats	Configure slot statistics collection	BPX, SU	3-430
cnfstatparms	Configure statistics parameters	BPX, IGX, SU	3-434
cnftrkstats	Configure trunk statistics collection	BPX, IGX, SU	3-494
dspchstatcnf	Display statistics enabled for a channel	IGX, SU	4-96
dspchstathist	Display statistics data for a channel	IGX, SU	4-98
dspclnstatcnf	Display statistics enabled for a circuit line (Note older alias: dsplnstatcnf)	BPX, IGX, SU	4-122
dspclnstathist	Display statistics history for a circuit line	BPX, IGX, SU	4-123
dsplnstathist	Display statistics data for a line	BPX, IGX, SU	4-203
dspphyslnstatcnf	Display statistics enabled for a physical line on a UXM. The alias dsplnstatcnf is used for IGX only.	BPX, IGX, SU	4-240
dspphyslnstathist	Display statistics history for a physical line on a UXM	IGX, SU	4-244
dspphyslnstats	Display physical line statistics. The alias dsplnstats is for the IGX only.	BPX, IGX, SU	4-237
dspportstatcnf	Display statistics enabled for an FR port	IGX, SU	4-258
dspportstathist	Display statistics history for an FR port	IGX, SU	4-259
dsprobst	Display robust statistics	BPX, IGX, SU	4-295
dsprrst	Display reroute statistics	BPX, IGX, SU	4-296
dspslotstatcnf	Display statistics enabled for a slot	BPX, IGX, SU	4-336
dspslotstathist	Display statistics history for a slot	BPX, IGX, SU	4-338
dspstatmem	Display statistics memory use	BPX, IGX, SU	4-341
dsptrkcons	Display trunk connection counts	BPX, IGX, SU	4-359
dsptrkmcons	Display trunk connection counts by master node	BPX, IGX, SU	4-365
dsptrkstatcnf	Display statistics enabled for a trunk	BPX, IGX, SU	4-371
dsptrkstathist	Display statistics history for a trunk	BPX, IGX, SU	4-373
rststats	Reset statistics collection time	BPX, IGX, SU	4-442
tststats	Test statistics	BPX, IGX, SU	4-470

Troubleshooting

Command	Full Name	Type	Page
addalmslot	Add alarm slot	BPX, IGX	3-4
addextlp	Add external loopback	IGX	3-50
addloclp	Add local loopback to connections on a port	BPX, IGX	3-61
addlocrmtlp	Add local-remote loopback in a tiered network	BPX, IGX	3-66
addrmtlp	Add remote loopback to connections	BPX, IGX	3-72
clrchstats	Clear channel statistics	BPX, IGX	3-99
clrclkalm	Clear clock alarm	BPX, IGX	3-100
clrclnalm	Clear circuit line alarm, an alias for clrlnalm.	IGX	3-106
clrclnerrs	Clear circuit line errors	IGX	3-106
clreventq	Clear the events queues from the fail handler	IGX	3-102
clrlnalm	Clear circuit line alarm	IGX	3-106
clrlnerrs	Clear line errors	IGX	3-106
clrlog	Clear log	IGX	3-107
clrmsgalm	Clear message alarm	BPX, IGX	3-108
clrphyslnalm	Clear physical line alarms	IGX	3-109
clrphyslnerrs	Clear physical line errors	IGX	3-112
clrportstats	Clear port statistics	IGX	3-113
clrslotalms	Clear slot alarms	BPX	3-116
clrsloterrs	Clear slot errors	BPX, IGX	3-117
clrtrkalm	Clear trunk alarm	BPX, IGX	3-118
clrtrkerrs	Clear trunk errors	BPX, IGX	3-122
clrtrkstats	Clear trunk statistics	BPX, IGX	3-123
cnfbus	Configure active bus	IGX	3-145
cnfleadmon	Monitor LDM/HDM data port control leads	IGX	3-266
cnflnalm	Configure line alarm	IGX	3-282
cnfslotalm	Configure slot alarm parameters	BPX	3-337
cnftrkalm	Configure trunk alarm	BPX, IGX	3-480
dellp	Delete loopbacks from a connection or port	BPX, IGX	4-18
dncd	Down card	BPX, IGX	4-32
dspalms	Display alarms	BPX, IGX	4-46
dspbob	Display Breakout Box	BPX, IGX	4-60
dspbusbw	Display cell bus allocated bandwidth	IGX/UXM	4-63
dspbuses	Display bus status	BPX, IGX	4-67
dspclnerrs	Display circuit line errors	IGX	4-120
dspeventq	Display the event queue names and the data in each.	BPX, IGX	4-165
dspfrcbob	Display FRC-2/FRM-2 breakout box	IGX	4-166
dsplog	Display event log	BPX, IGX	4-208
dsplnalmcnf	Display line alarm configuration	IGX	4-192
dsplnerrs	Display line errors	IGX	4-198
dsppwr	Display power supply status	BPX, IGX	4-281
dspslotalms	Display slot alarms	BPX	4-333
dspsloterrs	Display slot errors	BPX	4-334
dspslotstatcnf	Display slot statistics configuration	BPX	4-337
dspsv3	Display Cisco WAN Manager L3 (layer 3) Link Control Blocks	BPX, IGX	4-342
dsptrkerrs	Display individual or all trunk errors	BPX, IGX	4-360
prtclnerrs	Print circuit line errors	IGX	4-417
prtlnerrs	Print line errors	BPX, IGX	4-423
prtlog	Print log	BPX, IGX	4-425
prttrkerrs	Print trunk errors	BPX, IGX	4-429
resetcd	Reset card	BPX, IGX	4-435
resetpc	Reset Port Concentrator	BPX, IGX	4-437
switchcc	Switch controller card	BPX, IGX	4-453
tstcon	Test connection	BPX, IGX	4-460
tstconseg	Test connection segment	BPX, IGX	4-463
tstdelay	Test Frame Relay connection delay	BPX, IGX	4-465
tstpcs	Test Port Concentrator Shelf	IGX	4-467
tstport	Test port	IGX	4-468

Error Information

Command	Description	Type	Page
dspcds	Displays front and back cards in the node, with type, revision, and status	BPX, IGX	4-83
dsplns	Displays status and configuration of circuit lines.	BPX, IGX	4-200
dspcons	Displays a summary of connections.	BPX, IGX	4-148
dsplog	Displays events affecting the node.	BPX, IGX	4-208
dspnds	Displays name, type, and alarm status of nodes within the local network.	BPX, IGX	4-220
dspnw	Displays the network topology in tabular form, including alarm status of each node in the network.	BPX, IGX	4-225
dsptrks	Displays basic information for all trunks.	BPX, IGX	4-367
dsppwr	Displays power supply status and internal temperature.	BPX, IGX	4-281
dsprtrslot	Displays operational information and alarm status for a specified URM embedded router.	IGX	4-304
dsprtrslots	Displays operational information and alarm status for all URM embedded routers in a node.	IGX	4-307

Access Device Commands on a Node

These commands apply specifically to the trunk between the FTC or FTM card set in an IGX node and Cisco access devices (such as the Cisco 3801).

[The commands you enter at the terminal attached to the access device itself are IOS commands. Refer to the documentation for the access device for descriptions of the IOS commands.]

When you use other common commands such as addcon, dspcon, cnfchutl, use the following syntax to, for example, specify the access device when adding a connection:

addcon slot.port.connection_ID,

where slot.port.connection_ID is the slot and port number of the FTC or FTM and connection_ID is the connection identifier.

Command	Full Name	Type	Page
addad	Add access device	BPX, IGX	3-3
addcon	Add data channel connection	IGX	3-21
cnfadcmtmr	Configure access device congestion management timer	BPX, IGX	3-126
cnfadcon	Configure access device connection (bandwidth) parameters	BPX, IGX	3-128
delad	Delete access device	BPX, IGX	4-4
dspads	Display (all) access devices	BPX, IGX	4-45
dspcon	Display a connection	IGX	4-132
dspcons	Display connections	BPX, IGX	4-148
resetad	Reset access device	BPX, IGX	4-434
restartad	Restart access device protocol handshake	BPX, IGX	4-438

VSI Commands

Virtual Switch Interface (VSI) is a common control interface for Cisco switches such as the MGX 8850, the BPX 8650 and the IGX 8400. It provides a resource management scheme that allocates the switch resources needed for setting up connections, such as system bandwidth and channel space, to a number of external connection-management entities (controllers) which manage calls or connections with PNNI or MPLS or other protocols.

The switch resources are partitioned between Automatic Routing Management and the MPLS or PNNI Controllers.

While BPX supports both SES PNNI and MPLS controllers, IGX supports only MPLS controllers.

VSI on the BPX and IGX supports the following functionality:

multiple VSI partitions
Service Class templates
virtual trunk support for VSI
Cisco WAN Manager support for VSI

VSI is supported on:

UXM cards on the IGX
BXM cards on the BPX

For more overview information and specific information on how to configure a BPX 8650 switch, refer to the Cisco BPX Series Installation and Configuration Guide. For information about configuring a router for MPLS operation, refer to the MPLS Software Configuration Guide. For information on the IGX 8400 switch, see the IGX Installation and Configuration Guide.

Summary of IGX VSI Commands

Mnemonic	Description	Page
addctrlr	Attach a VSI controller to the IGX node.	3-45
addyred	Enables card redundancy for IGX cards.	3-93
compactrsrc	Compact the Automatic Routing Management CBAs on a particular slot.	3-519
cnfctrlr	Reconfigure the VPI and start_VCI of the control channels for an MPLS Controller.	3-222
cnfqbin	Configure Qbin parameters on a selected port, physical or virtual trunk.	3-222
cnfrsrc	Configure resources, for example, for Automatic Routing Management PVCs and MPLS (Multiprotocol Label Switching) Controller (LSC).	3-400
cnfvsiif	Assign a different Service Class Template to an interface.	3-514
delctrlr	Delete an MPLS controller from an IGX node.	4-11
dspcbause	Query the specified slot and display information about the CBA block usage.	4-74
dspchuse	Display a summary of channel usage in a given slot.	4-116
dspctrlrs	Display the MPLS controllers attached to an IGX node.	4-159
dspqbin	Display Qbin parameters on the specified port, physical or virtual trunk.	4-283
dspqbinstats	Display Qbin summary statistics	4-288
dspqbint	Display the default Qbin parameters for a VSI Qbin in a Qbin template.	4-291
dsprsrc	Display the resource partitioning for a port or trunk.	4-299
dspsct	Display a list of nine Service Class Templates and the Class of Service.	4-311
dspvsiif	Display Service Class Template assigned to an interface.	4-397
dspvsipartinfo	Display VSI resource information for a partition.	4-400
dspyred	Display information for Y-cable pairings	4-404

Summary of BPX VSI Commands

Mnemonic	Description	Page
addctrlr	Attach a PNNI VSI controller to a BPX node through an AAL5 interface shelf. For controllers that require Annex G capabilities in the controller interface.	3-47
addshelf	Add a trunk between the hub node and interface shelf, VSI-MPLS controller or an SES PNNI controller.	3-85
addyred	Enables card redundancy for BPX cards.	3-93
cnfqbin	Configure Qbin parameters on a selected port, physical or virtual trunk.	3-385
cnfrsrc	Configure resources, for example, for Automatic Routing Management PVCs and MPLS controller (LSC).	3-408
cnfvsiif	Configure VSI or a different template to an interface.	3-515
cnfvsipart	Configure VSI partition characteristics for VSI.	3-515
delctrlr	Delete a controller, such as a PNNI ESP (Extended Services Processor) 4.0 controller, from a BPX node.	4-12
delshelf	Delete a trunk between a hub node and access shelf.	4-23
dspchuse	Display a summary of channel distribution in a given slot.	4-119
dspctrlrs	Display the VSI controllers attached to a BPX node.	4-159
dspqbin	Display Qbin parameters.	4-285
dspqbinstats	Display Qbin summary statistics.	4-291
dspqbint	Display Qbin template.	4-291
dsprsrc	Display the resource partitioning for a port or trunk.	4-301
dspsct	Display Service Class Templates and the Class of Service.	4-311
dspvsiif	Display VSI.	4-397
dspvsipartcnf	Display information about VSI ILMI functionality.	4-399
dspvsipartinfo	Display VSI resource information for a partition.	4-401
dspyred	Display information for Y-cable pairings	4-404

SuperUser Commands

The Cisco WAN switch software SuperUser commands require user privilege level 0 (zero). SuperUser commands (privilege level 0) require a different login and password than commands with privilege levels 1-6. Because the privilege level for all SuperUser commands is 0, the privilege level does not appear in the command definition.

Once you log into a node as SuperUser (user privilege level 0), you will have access to all the SuperUser commands throughout the entire session until you log off that node.

Caution These commands are intended to be restricted to Cisco personnel and other qualified users, such as system administrators. Do not distribute this information to casual users because improper use of SuperUser commands could lead to system malfunction or complete failure.

To access these commands, type in SuperUser at the login prompt. Enter the SuperUser password and the password prompt. To exit a command at any point, press the Delete key.

The definitions of potentially dangerous SuperUser commands contain an advisory for you to call the Cisco Technical Assistance Center (TAC) before you proceed. The number in the United States is 800-553-2447. For international access, use 1-408-526-4000.

This section briefly describes the statistics command line interface (CLI) definitions that are provided for various statistics commands (for example, cnfchstats, cnflnstats, cnfportstats, and so on.) Each statistics command displays field names on the CLI.

The descriptions provided in the various statistics description tables may vary from the actual definitions of the field name as it appears on the switch software command line interface statistics screens.

Only BXM card statistics descriptions are provided; however, note that many of the UXM card statistics are similar or identical to those used for the BXM card. This means that in many cases, the description may also apply to the UXM card.

The statistics descriptions provided in the various tables may not always map directly to the CLI field names, but in many cases, they provide a description of the statistic that is sent from the card firmware to the switch software CLI (through CommBus messages from the firmware to switch software).

Note The BXM CommBus interface is similar in many places to the CommBus interface for previously-released cards (ASI and BNI cards). Note that there are small differences in the CommBus definition for other cards. In some cases the object ID for the BXM card statistic differs from its ASI or BNI counterpart.

Several tables contain CommBus messages, along with descriptions of how each message is used by the switch software. Note that in many cases, the CommBus message description provides a description of the statistics field name on the CLI screen display, on dspchstats, dspchstathist, and so on.

Explanation of table columns:

ID—Indicates the object ID number.
Object Name—Provides a description of the object.
Range/Values—Indicates the legal values that the object can take.
Default—Indicates the default value used by the firmware if this object is not sent. Special defaults:
- R—Indicates that there is no default and the object must be supplied each time.
- RI—Indicates that the object is required only at initial setup time.
- NA—Not Applicable; Indicates that the object is "get-only" so a default value does not apply in this case.
- NC—No Change.
- LR—Line Rate (E3, DS3, OC-3, OC-12).
Description—Indicates the use of the object.

Functional Description of Channel Statistics

This operation provides a way for the software to collect channel statistics. The number of channel statistics that can be collected is limited and configurable by software. Note that all of these statistics are not available on the Monarch firmware at one time. For the statistics that are not configured, a value of zero will be returned during the "get" operation.

In the description column of the screen display, the numbers in brackets indicate how many stats-per-connection need to be configured on the card for the specific statistic to be available over the CommBus interface. [ALL] indicates the statistic is available regardless of the number of configured stats-per-connection. If the number inside the [ ]s is preceded by "A:", that means that the statistic is available when primary statistics are requested for the connection. If the number inside the [ ]s is preceded by "B:", that means the statistic is available when secondary statistics are requested for the connection.

Command	Description	Type	Page
burnfwrev	Burn firmware image into a specific card's memory.	BPX, IGX, SU	3-93
clrcderrs	Clear detailed card errors log	BPX, IGX, SU	3-96
clrcnf	Clear configuration memory of the current node	BPX, IGX, SU	3-101
cnfabrparm	Configure parameters for ABR queue on all ports of UXM card	IGX, SU	3-125
cnfadcom	Configure Access Device Communications Parameters	IGX, SU	3-128
cnfbusbw	Configure UXM card bus bandwidth parameters	IGX, SU	3-147
cnfcdparm	Configure channel statistics level on BXM or UXM cards	BPX, IGX, SU	3-151
cnfcdpparm	Configure CVM card parameters	BPX, IGX, SU	3-151
cnfcftst	Configure communications fail test pattern	BPX, IGX, SU	3-176
cnfchstats	Configure channel statistics collection	BPX, IGX, SU	3-178
cnfchts	Configure channel timestamp, a pre-aging parameter	BPX, IGX, SU	3-190
cnfcmparm	Configure connection management parameters	BPX, IGX, SU	3-194
cnfdiagparm	Configure diagnostic test parameters	BPX, IGX, SU	3-210
cnfdlparm	Configure software and firmware download parameters. Primarily a debug command.	BPX, IGX, SU	3-237
cnfecparm	Configure CDP or CVM echo canceller parameters for a specified voice circuit line.	IGX, SU	3-239
cnffstparm	Configure Frame Relay Optimized Bandwidth Management node parameters	BPX, IGX, SU	3-243
cnflan	Configure Ethernet LAN between node and Cisco WAN Manager terminal.	BPX, IGX, SU	3-252
cnflnparm	Configure ATM line parameters	IGX UXM, SU	3-264
cnflnsigparm	Configure line signaling parameters for voice cards	IGX, SU	3-283
cnflnstats	Configure line statistics collection. Primarily a debug tool.	BPX, IGX, SU	3-286
cnfmxbutil	Configure Muxbus utilization	IGX, SU	3-289
cnfnodeparm	Configure miscellaneous node parameters	BPX, IGX, SU	3-303
cnfnwip	Configure network IP address and subnet mask for the node	BPX, IGX, SU	3-327
cnfphyslnstats	Configure physical line statistics collection on UXM	IGX UXM, SU	3-372
cnfportstats	Configure FR port statistics collection. Primarily a debug command.	IGX, SU	3-372
cnfrobparm	Configure Robust Alarms parameters (a protocol for node-to-network management systems)	BPX, IGX, SU	3-391
cnfrtrparm	Configure Universal Router Module (URM) embedded router parameters	IGX URM, SU	3-426
cnfslotstats	Configure slot statistics collection for troubleshooting	BPX, SU	3-430
cnfstatparms	Configure port statistics parameters	BPX, IGX, SU	3-434
cnftcpparm	Configure TCP parameters. Specifies the number of times the BCC checks the IP addresses for attention requests.	BPX, IGX, SU	3-448
cnftermfunc	Configure terminal port parameters	BPX, IGX, SU	3-451
cnftlparm	Configure trunk-based loading parameters	BPX, IGX, SU	3-454
cnftrkparm	Configure trunk parameters to optimize traffic mixes	BPX, IGX, SU	3-483
cnftrkstats	Configure collection of Qbin statistics on specified trunk	BPX, IGX, SU	3-494
cnftstparm	Configure card self-test parameters	BPX, IGX, SU	3-504
cnfuiparm	Configure control terminal user interface parameters	BPX, IGX, SU	3-504
cnfuvmchparm	Configure UVM channel parameters	IGX, SU	3-506
cnfvchparm	Configure CVM or CVM voice channel parameters	IGX, SU	3-508
dchst	Display CDP or CVM channel status	IGX, SU	4-2
diagbus	Diagnose failed MuxBus or cell bus	IGX, SU	4-31
dspabortlog	Display abort log	BPX, IGX, SU	4-43
drtop	Display Route Op Table. Displays network statistics for connection rerouting resulting from failed trunks.	BPX, IGX, SU	4-42
dspasich	Display ASI channel routing entry	BPX, SU	4-51
dspbuses	Display available MuxBux or cell bus bandwidth	BPX, IGX, SU	4-65
dspcderrs	Display card failure information from diagnostics at local node	BPX, IGX, SU	4-80
dspcftst	Display communications fail test pattern	BPX, IGX, SU	4-86
dspchan	Display voice channel configuration	IGX, SU	4-87
dspchstatcnf	Display statistics enabled for a channel to help debug statistics	IGX, SU	4-96
dspchstathist	Display history of statistics enabled for a channel	IGX, SU	4-98
dspclnstatcnf	Display statistics enabled for a circuit line by cnflnstats	IGX, SU	4-122
dspclnstathist	Display statistics history for a circuit line	BPX, IGX, SU	4-123
dspcnf	Display configuration save and restore status	BPX, IGX, SU	4-128
dspdnld	Display status of a download to a node	BPX, IGX, SU	4-161
dspdutl	Display percentage of data channel utilization	IGX, SU	4-162
dspecparm	Display CDP echo canceller parameters	IGX, SU	4-163
dspfwrev	Display status of card firmware revision image loaded in controller card's RAM	BPX, IGX, SU	4-171
dsplnstatcnf	Display statistics enabled for a line. This command is an IGX-only alias for the preferred command dspphyslnstatcnf.	IGX, SU	4-203
dsplnstathist	Display statistics data for a line	BPX, IGX, SU	4-203
dspphyslnstatcnf	Display statistics enabled for a physical line on a UXM by the cnfphyslnstats command	IGX, SU	4-240
dspphyslnstathist	Display statistics history for a physical line on a UXM	IGX, SU	4-244
dspportstatcnf	Display statistics enabled for an FR port	IGX, SU	4-258
dspportstathist	Display statistics history for an FR port	IGX, SU	4-259
dsprevs	Display system configuration and status of primary and secondary revisions running all nodes	BPX, IGX, SU	4-293
dsprobst	Display statistics associated with Robust Alarms	BPX, IGX, SU	4-295
dsprrst	Display statistics on reroutes resulting from failed trunks	BPX, IGX, SU	4-296
dspsig	Display current signaling rate from specified voice channel	IGX, SU	4-328
dspslot	Display system information associated with a slot	BPX, IGX, SU	4-330
dspslotstatcnf	Display statistics enabled for a BXM card	BPX, IGX, SU	4-336
dspslotstathist	Display statistics history for a BXM card	BPX, IGX, SU	4-338
dspstatmem	Display memory usage for statistics collection	BPX, IGX, SU	4-341
dsptcpparm	Display TCP bandwidth throttle parameter	BPX, IGX, SU	4-350
dspswlog	Display software errors log	BPX, IGX, SU	4-348
dsptrkcons	Display number of connections routed over specific trunk	BPX, IGX, SU	4-359
dsptrkmcons	Display number of connections routed over specific trunk (BNI) by master node	BPX, IGX, SU	4-365
dsptrkstatcnf	Display statistics enabled for a physical or virtual trunk	BPX, IGX, SU	4-371
dsptrkstathist	Display statistics history for a physical or virtual trunk	BPX, IGX, SU	4-373
dsputl	Display utilization for voice and data connections	IGX, SU	4-396
getfwrev	Get firmware revision image	BPX, IGX, SU	4-406
killuser	Log out a user	BPX, IGX, SU	4-410
loadcnf	Load configuration image from WAN Manager	BPX, IGX, SU	4-411
loadrev	Load secondary software revision from WAN Manager	BPX, IGX, SU	4-412
prtcderrs	Print card error information	BPX, IGX, SU	4-414
rrtcon	Manually reroute connection	BPX, IGX, SU	4-439
rststats	Reset statistics collection time for the tststats command	BPX, IGX, SU	4-442
runcnf	Restores network configuration image to one or all nodes	BPX, IGX, SU	4-443
runrev	Run a specific revision of system software at a node	BPX, IGX, SU	4-445
savecnf	Save system configuration image on WAN Manager workstation disk	IGX, SU	4-446
tststats	Display a summary of test statistics resulting from use of tstcon	BPX, IGX, SU	4-470
upgdlogcd	For BXM to BXM-E card, manually upgrade the logical card database	BPX, SU	4-474
upggrp	Create groups of nodes for upgrade purposes	BPX, IGX, SU	4-474

Command Aliases

These commands are functionally identical. The first command name is an alias; see the command definition for the second, preferred name:

addcdred—same functionality as addyred
addfrport—same functionality as addport
cnfclnstats—same functionality as cnflnstats
cnffrport—same functionality as cnfport
delcdred—same functionality as delyred
delfrport—same functionality as delport
dnfrport—same functionality as dnport
dspcdred—same functionality was dspyred
dspfrport—same functionality as dspport
dsplnstatcnf—same functionality as dspphyslnstatcnf
dsplnstats—same functionality as dspphyslnstats
prtcdred—same functionality as prtyred
switchcdred—same functionality as switchyred
upfrport—same functionality as upport

Table of Contents