Cisco MGX 8800 Series Switch Command Reference, Release 1.1.31
MGX 8800 Command Line Interface
Downloads: This chapterpdf (PDF - 4.19MB) The complete bookPDF (PDF - 4.96MB) | Feedback

MGX 8800 Command Line Interface

Table Of Contents

MGX 8800 Command Line Interface

Introduction

List of Commands

?

abort

acqdsx3bert

addapsln

addaimgrp

addcdrscprtn

addchan

addchanloop

addcon

Service Types

ForeSight and standard ABR Coexistence Guidelines

Foresight and ABR comparison

Guidelines

Example

Performance Parameters for Foresight and Standard ABR

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

cnfchanabrparams

cnfchanabrrates

cnfchaneir

cnfchancacoff

cnfchanegressq

cnfchanfst

cnfchaningressq

cnfchanmap

cnfchanpol

cnfchanq

cnfchansrvrate

cnfchanstdabr

cnfclklevel

cnfclksrc

cnfcon

cnfconabrrates

cnfconabrparams

cnfconstdabr

cnfdate

cnfdsx3bert

cnfegrservtype

cnfextclk

cnfenetgw

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

cnfupcrtvbr

cnfupcubr

cnfupcvbr

cnfvismip

commit

copy

cp

cth

copychans

copyports

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

dnif

dnilmi

downloadflash

dnport

dspaimgrp

dspaimgrpcnt

dspaimgrps

dspaimlncnt

dspalm

dspalmcnf

dspalmcnt

dspalms

dspapscfg

dspapsln

dspatmlncnf

dspatmlncnt

dspbctype

dspbert

dspcbclk

dspcd

dspcderrs

dspcdprtntype

dspcdrscprtn

dspcds

dspchan

dspchancnt

dspchanmap

dspchans

dspchanstdabr

dspchstats

dspclkinfo

dspclksrc

dspcon

dspconcnt

dspcons

dspconstdabr

dspcurclk

dspdisk

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

dspportutil

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

uupif

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 8800 Command Line Interface


Introduction

The preferred tools for configuring, monitoring, and controlling an MGX 8800 series switch are the CiscoView and Cisco WAN Manager 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 8800 series switch and is highly applicable during initial installation, troubleshooting, and any situation where low-level control is useful.

The MGX 8800 series 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 Installation and Configuration document for your specific switch type. The Installation and Configuration document provides conceptual information about how the Cisco MGX 8800 series switches can best implement network services in your network configuration. Examples of usage for the more common commands appear in the configuration chapters of this manual.

The command line prompt shows the name of the switch, the number of the switch (which is always "1"), the slot number and type for 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:

excel.1.6.AUSM.a >

In this case, the current card is an active AUSM in slot 6, and the name of the node is "excel."

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 Portable AutoRoute (PAR) commands appear in Table 1-1. 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.

The command line prompt shows the name of the switch, the number of the switch (which is always "1"), the slot number and type for 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:

excel.1.6.AUSM.a >

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 with no 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 Portable AutoRoute (PAR) commands appear in Table 1-1. 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

dspportutil

Display Trunk Utilization

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

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


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 State

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.7.PXM.a > ? con

    Available commands
    ------------------
    addcon
    clrconcnt
    clrconcnts
    cnfcon
    dcondb
    delcon
    dspcon
    dspconcnt
    dspcons
    shellConn
    tstcon
    tstconseg

raviraj.1.7.PXM.a >  

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 501.

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.7.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 Errors loading firmware (multiple cases)

NODENAME.1.8.PXM.a > abort 1.1.11
cannot be in 'upgrade idle', must be in 'upgrade' or 'upgrade
install'
ERR: command "abort" failed

NODENAME.1.7.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 BERT session already exists on the selected MGX 8800 switch 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: Active

Privilege: Any


Example 1-5 Acquire current BERT session

NODENAME1.1.21.CESMT3.a > acqdsx3bert
dspdsx3BertCntrs :
BCRunning : 00
BCStorage : 0
BECRunning : 00
BECStorage : 0

DSX3 BERT in Sync

NODENAME1.1.21.CESMT3.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 = enter the value 1

workslot

Slot number of the PXM. Enter the value 7 or 8.

protectline

Protection line number.

OC-3 range = 1-4

OC-12 = enter the value 1

protectslot

Protection slot number: Enter the value 7 or 8.

archmode

Value to set 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 8 to APS Working line1 on slot 7. Set the APS architect mode on the working/protection line pair to 1+1.

spirit4.1.8.PXM.a > addapsln 1 7 1 8 2
spirit4.1.8.PXM.a > 

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

Value to set 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: 1-2


Example 1-7 Add IMA group 2 as UNI with lines 3, 4, and 5

spirit4.1.18.PXM.a > addaimgrp 2 3.4.5 
spirit4.1.18.PXM.a > 

A system response does not occur unless an error is detected.

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 such as PAR.

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 Effects of Using addcdrscprtn

Command
Description
addcdrscprtn off

Card-level partitioning is inactive. You must partition resources at the port level. (See also cnfportrscprtn.)

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, VISM

Syntax: PXM

addcdrscprtn <ctrlr_num> <num_glcns>

Syntax Description

ctrlr_num

Value to set controller type.

1 = PAR

2 = PNNI

3 = TAG

num_glcns

Number of available global logical connection numbers (GLCNs), in the range 0-32767.


Syntax: FRSM

addcdrscprtn <controller> <numOfLcnAvail>

Syntax Description

controller

Value to set 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

Value to set 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 State (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.8.PXM.a > addcdrscprtn 10000 0 10000
spirit4.1.8.PXM.a > 

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

Value to set 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

Value to set 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

Value to set status of local endpoint as 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

Value to set channel type.

1 = NIW

2 = SIW-transparent

3 = SIW-translation

4 = FUNI

5 = frame forwarding

CAC

Value to enable or disable Connection Admission Control (CAC).

1 = enable

2 = disable (default)

mastership

Value to set status of current end as 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

Value to set channel type.

1 = NIW

2 = SIW-transparent

3 = SIW-translation

4 = FUNI

5 = frame forwarding

CAC

Value to enable or disable CAC (Connection Admission Control).

1 = enable

2 = disable (default)

mastership

Value to set current end as 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-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

Value to set channel type.

1 = NIW

2 = SIW-transparent

3 = SIW-translation

4 = FUNI

5 = frame forwarding

serv_type

Value to set service type.

1 = CBR (Constant Bit Rate)

2 = VBR (Variable Bit Rate)

3 = ABR (Available Bit Rate)

4 = UBR (Unspecified Bit Rate)

CAC_enable

Value to enable or disable Connection Admission Control (CAC).

1 = enable

2 = disable (default)

mastership

Value to set current end as 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

Value to set connection type as 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

Value to set service type.

1 = CBR (Constant Bit Rate)

2 = VBR (Variable Bit Rate)

3 = ABR (Available Bit Rate)

4 = UBR (Unspecified Bit Rate)

mastership

Value to set status of current end as 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 VPI value, in the range 1-65535.

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

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

Value to set 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

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

Value to set data-conditioning for either UDT or SDT.

UDT = 255

SDT range = 0-255

cond_signal

Condition signal, in the range 0-15.

mastership

Value to set status of current end as 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.


Syntax: CESM-T3E3

addchan <chan_num> <port_num> <cond_sig> <mastership> <locnsap> <rmtvpi> <rmtvci> <rmtnsap>

Syntax Description

chan_num

Channel number. Enter the value 32.

port_num

Port number. Enter the value 1.

cond_sig

Condition signal number, in the range 0-15.

mastership

Value to set status of the current end as 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.


Related Commands

delchan, dspchan, dspchans

Attributes

Log: Yes

State: Active

Privilege: 1-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.

FRSM

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

State: Active

Privilege: 1-4


Example 1-10 Add channel loopback onto channel number 21

s1.1.12.AUSMB8.a > addchanloop 21

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.

Service Types

In software Release 1.1.31, the service type options are expanded on the AUSM 8T1/E1, to include Standard ABR and real-time VBR connections, and fo FRSM 8T1/E, all service types were added. Service types that are available via these modules are shown inTable 1-5.

Table 1-5 Service Types Configurable from the AUSM 8T1/E1 and FRSM 8T1/E1

AUSM 8T1/E1 Service Type
FRSM 8T1/E1 Service Type

Constant Bit Rate (CBR)

high priority

Variable Bit Rate (VBR)

real-time Variable Bit Rate (rt-VBR)

Standard ABR

non-real-time Variable Bit Rate (VBR)

Unspecified Bit Rate (UBR)

fst ABR (ForeSight)

real-time Variable Bit Rate (rt-VBR)

Unspecified Bit Rate (UBR)

ForeSight ABR

Standard ABR


ATM service categories support applications with distinct tolerances for delay, jitter, and cell loss, which in turn require control of bandwidth or throughput values. The ATM Forum has defined a family of service categories.

CBR and rt-VBR service types address the needs of applications that use precisely defined requirements for throughputs and delays. Applications that benefit from using these service categories include circuit emulation or entertainment-quality video.

VBR is treated in the software as non-real-time (nrt) VBR. This service type is intended for applications that have bursty traffic characteristics and do no have tight constraints on delay and delay variations. VBR service may support statistical multiplexing of connections.

UBR service type (the first service type developed for data) is intended for applications that have minimal service requirements, such as file transfers. UBR has no fairness of access mechanism—therefore, there is no way to specify higher priority connections.

ForeSight ABR (AUSM T1/E1) and fst ABR (FRSM T1/E1) are the Cisco-proprietary implementations of ABR. You can have both ForeSight ABR and Standard ABR connections on the same card. However, to migrate from ForeSight ABR connections to Standard ABR connections, you must physically delete the ForeSight ABR connection, then add the connection as Standard ABR using the addcon command.

Standard ABR service type, based on TM 4.0, is useful for many applications. However, the main focus for development of Standard ABR is the economical support of data traffic. Data is segmented into ATM cells. The loss of any of the cells triggers the retransmission of the entire packet by a higher protocol layer. ABR service includes sharply defined objectives for cell loss, based on configured cell-loss ranges and feedback from the network to the traffic source. The ABR service guarantees a particular cell-loss ratio for all traffic offered in proper response to network feedback from Resource Management (RM) cells.

Depending on the values of Nrm, Trm, and Mrm (always 2), every Nrmth cell is an RM cell or every cell aftrer Trm (msecs) is an RM cell. Mrm comes into play at very low data rates. These RM cells travel to the destination and back, testing for congestion in the path. If a switch or destination is congested, it will mark a bit in the RM cell. The sender of the original packet receives the RM cell, interprets that there is congestion occurring somewhere, and slows down packets/cells to prevent cell loss. Once RM cells round-trip and return to the sender unmarked (without congestion notification) the sender increases traffic until, once again, marked RM cells are returned, signalling network congestion. Please refer to ATM Forum's TM 4.0 for details on Source, Destination, and Switch behaviors.

There are two implementations of Standard ABR:

Terminating Standard ABR—This form of Standard ABR creates one rate-based end-to-end feedback loop. Each of these connections acts as a Source as well as a destination in the forward and reverse data paths respectively, thereby terminating the feedbacki control loop. This implementation is available on both the FRSM-8T1/E1 and the AUSM-8T1/E1 service modules.

Transparent ABR—Switch without Virtual Source/Virtual Destination behavior ABR. (default). This form of Standard ABR represents the Switch behavior as describe in ATM Forum's TM 4.0. Connections update the congestion information ("Congestion Indication" (CI) and "No Increase Indication" (NI) bits) in the RM cells in order to provide feedback to the source. This implementation is availalble only on the AUSM-8T1/E1 service module. Note that VS.VD for Transparent/Switch behavior is not supprted.

Please refer to Figure 1-2 for an illustration of this process.1

Figure 1-2 ABR Source, Destination, and Switch Behavior

To configure Standard ABR on the FRSM-8T1/E1:

1. Add a connection with the addcon command, specifying the service type as "9." Note that possible errors may be:

Illegal/Invalid parameters.

Channel already exists.

Port may not be up.

The default values for Mrm and Crm are 2 and TBE/NRM respectively, though these parameters cannot be seen using any command. These values remain constant through the life of the connection.

2. Once the Standard ABR connection has been added using the command addcon, see the default values using the dspchanstdabr command. Note the following information about the default values:

The Standard ABR connection is of the type Terminating, not Transparent.

The Minimum Cell Rate (MCR) and Peak Cell Rate (PCR) of the Standard ABR connection are inclusive of the RM cell bandwidth overhead. In other words, RM cells are sent in-band with the data cells belonging to a connection, and the overhead bandwidth (consumed by RM cells) must be taken into account while provisioning the bandwidth for the connection. For example, for a Standard ABR connection with an Nrm of 64, Trm of 200, assuming that the Nrm limit is hit before the Trm limit, the % overhead will be approximately 2% (1/64) for FRM cells + 2% for BRM cells = 4 %. Thus, the % bandwidth for data cells of the connection will be 96%.

3. The default ABR parameters can be either left as default or changed using the command cnfchanstdabr.

4. You can use the command cnfchanabrparams to configure all the parameters of the Standard ABR connection except the rate parameters.

5. You can use the command cnfchanabrrates to configure the rate parameters of the Standard ABR channel.

To configure Standard ABR on the AUSM 8T1/E1:

1. Add a channel with the addcon command, specifying the service type as "3." Note that possible errors may be:

Illegal/Invalid parameters.

Channel already exists.

Port may not be up.

2. Once the Standard ABR connection has been added using the command addcon, see the default values using the dspconstdabr command (see Example 1-12). Note the following information about the default values:

The default values for Mrm and Crm are 2 and TBE/FRTT respectively, though these parameters cannot be seen using any command. These values remain constant through the life of the connection.

The standard ABR connection is a As noted above, a Standard ABR connection, when first added defaults to a Transparent ABR connection (Switch behavior without VS/VD or ABR.1).

The Minimum Cell Rate (MCR) and Peak Cell Rate (PCR) of the standard ABR connection are inclusive of the RM cell bandwidth overhead. In other words, RM cells are sent in-band with the data cells belonging to a connection, and the overhead bandwidth (consumed by RM cells) must be taken into account while provisioning the bandwidth for the connection. For example, for a standard ABR connection with an Nrm of 64, Trm of 200, assuming that the Nrm limit is hit before the Trm limit, the % overhead will be approximately 2% (1/64) for FRM cells + 2% for BRM cells = 4 %. Thus, the % bandwidth for data cells of the connection will be 96%.

Use the parameter Type of ABR Service. The Standard ABR implementation in AUSM-8 does not support Virtual Source/Virtual Destination (VS/VD) behavior.

3. The default ABR parameters can be either left as default or changed using the command cnfconstdabr. To toggle between Terminating Standard ABR behavior and Transparent (Switch) behavior, set the parameter "Type of ABR Service" to either "2" for Terminating Standard ABR or "1" for Transparent ABR.)

4. You can use the command cnfconabrparams to configure all the parameters of the Standard ABR connection except the rate parameters. It can even be used to toggle between Terminate and Transparent ABR. For more information about this command, refer to cnfconabrrates on page 169.

5. You can use the command cnfconabrrates to configure the rate parameters of the Standard ABR channel. The ability to configure the rate parameters of the channel are especially useful for a Transparent (switch behaving) ABR connection where the other parameters are not of much significance.

Upgrading to Standard ABR—AUSM-8T1/E1

1. Standard ABR and ForeSight ABR or fst ABR are connection-level features and require "Rate Control Feature" to be enabled on the card if the "Type of ABR Service" under cnfrconstdabr is set to "2" for Terminating Standard ABR.

2. Both Standard ABR and ForeSight ABR or fst ABR connections can co-exist on a card.

3. This implementation of Standard ABR does not support Virtual Source/Virtual Destination behavior or Explicit Rate (ER) marking of RM cells. Instead, binary feedback mechanisms are used. Any network element can provide its congestion status using the field "congestion Indication" (CI) and "No Increase Indication" (NI) in the RM cell, as long as it does not reset the existing Boolean value in these fields. Please note that though ER marking of RM cells is not supported by the destination or switch (in AUSM 8T1/E1), the source implemented inAUSM 8T1/E1will act on the ER feedback given by intermediate nodes.

4. After upgrading to software Release 1.1.31, any existing ABR.1 connection (Transparent ABR connection) will be serviced according to the new Standard ABR MIB elements. Prior to 1.1.31, ForeSight elements are being used to service ABR.1 connections.

5. To migrate from ForeSight ABR or fst ABR connections to Standard ABR connections, you must delete the ForeSight ABR or fst ABR connection, then add the connection as Standard ABR using the addcon command.

Upgrading to Standard ABR—FRSM-8T1/E1

1. To facilitate graceful upgrades from the current versions to the new versions of software, the object chanServType will be set to (0) (channel service type is displayed as a null string) and other configuration parameters remain unchanged. For the old model type of connections, Foresight connections, no direct migration exists to standard ABR connections. To migrate Foresight connections, you must reprovision.


Note To set up a three-segment connection across a network, specify the PXM as slot 0.


ForeSight and standard ABR Coexistence Guidelines

In this release, Cisco has introduced the ability to support ABR TM4.0 as well as Foresight congestion control on the FRSM and AUSM modules. This section describes the major differences between the TM 4.0 compliant standard ABR and ForeSight. It also provides guidelines for the coexistence of ForeSight connections with standard ABR connections on the same network, with a worked example of how to configure the two different connection types to have similar characteristics

Foresight and ABR comparison

Foresight is similar to the rate-based ABR control system in TM 4.0, in that they both use Rate up and Rate down messages sent to the source of the connection to control the rate a connection runs at, based on congestion within the switches along that connection path. Both systems use Resource Management (RM) cells to pass these messages. The differences between the two systems that need to be considered are:

1. RM Cell generation

ForeSight is a destination driven congestion notification mechanism. This means the destination switch is responsible for generating the RM cells, which defaults to every 100 ms. This means that any rate modifications at the source end happen approximately every 100 ms, and the time delay between the actual congestion at the destination and the source receiving information about the time delay could be 100ms.

In standard ABR, a source generates FRM cells every (nRM) cell intervals, where "n" is configurable. These are used to pass congestion information along to the destination switch, which then uses this information to generate BRM (Backward RM cells) back to the source.

A further consideration is that the actual user data flow will be lower for an equivalent rate due to the additional RM cells. Therefore, the more traffic being generated on a connection at any one time, the faster the feedback will be to the source.

There is also a TRM parameter which states that, if no RM cells have been generated after this time has passed, then one will automatically be sent.

Depending upon the speed at which it is running, an ABR connection may react faster or slower to congestion than the equivalent Foresight connection. For example, if an ABR connection runs at 100 cells per second, and nRM is 32, then approximately three RM cells will be generated per second, or once every 300 msecs. If it runs at 1000 cps then an RM cell would be generated approximately every 30 msecs. In both cases, the equivalent Foresight connection would generate an RM cell every 100 msec)

2. Reaction to feedback messages—Rate Up

In ForeSight, in response to a Rate Up cell from the destination, the source increases its rate by a percentage of the MIR for that connection. If we call this percentage the rate increase percentage (RIP), then RIP is configurable at the card level and by default it is 10%. In the case where MIR is low, the ForeSight rate increase will be slow as it has to increase as a percentage of MIR (rather than CIR).

On a standard ABR connection, in the event of available bandwidth (no congestion), the source increases its rate by a factor of (RIF*PCR). This means the rate increase step sizes are much bigger than for ForeSight for larger values of RIF (RIF has a range of 1/2, 1/4,....,1/32768). If RIF is not configured properly then standard ABR will ramp up its rate much faster and to a higher value. This is aided by the fact that the step sizes are bigger and the step frequency is higher in comparison with ForeSight.

3. Reaction to feedback messages—Rate Down

In ForeSight on receiving a Rate Down cell from the remote end, the source reduces its current rate (actual cell rate) by 13%. We will call this the rate decrease percentage (RDP). RDP is configurable at the card level.

In standard ABR, rate decrease is by an amount (RDF*ACR). Currently, the default value of RDF is 1/16 (i.e 6.25%). This means when this connection co-exists with ForeSight connections, in the event of congestion ForeSight connection reduces its rate by 13% whereas standard ABR connection reduces its rate by only 6.25%. Therefore, in the case of co-existence and approximating the same behaviour across the two connection types, RDF should be changed to 1/8, so that both connections ramp down by the same amount, or 13%.

4. Fast-Down

In ForeSight, if the destination egress port drops any data due to congestion, then the destination sends a Fast Rate Down cell. Also, if a frame cannot be reassembled at the egress due to a lost cell somewhere in the network, a Fast-down is generated. On reception of Fast Rate Down the source reduces its current rate by 50% (this is again a card level configurable parameter).

Standard ABR does not distinguish between drops and the ECN/EFCI threshold being exceeded.

This means that, in case of drops in the egress port queue, a standard ABR connection rate reduces by only (RDF*ACR) but the ForeSight connection rate reduces by (ACR*0.5). Therefore, in the case of co-existence, if we need to approximate the same behavior across the two connection types then Fast down could effectively be disabled by configuring the reaction to be 13 % rate down instead of 50%.

Guidelines

Both Foresight and Standard ABR systems work together within the network, but as the above description suggests, if the differences between the two systems are not taken into consideration, then a Foresight connection and an ABR connection with the same configuration parameters will not behave the same way within the network.

ABR and Foresight provide a mechanism for distributing excess bandwidth between connections over and above the minimum rate, therefore if these guidelines are not taken into consideration, the allocation of this excess bandwidth may be biased towards connections running one of these algorithms over connections running the other.

If this is a requirement, the following guidelines in Table 1-6 may be useful, assuming ForeSight is set to defaults except for Fast_Rate_down (which is set for 13%).

Table 1-6 Guidelines for Foresight and Std. ABR Cooexistence 

Parameter Value
Setting

Inrate Cell Count (NRM)

rm needs to be set at a value whereby the approximate RM cell generation is 100 milliseconds, to match that of Foresight. This is a calculation based on the expected average, or sustained, cell rate of the connection. However, if the (potential) fast-down messages from Foresight are left to equate to 50% rate down, then an estimate of how often this may occur needs to be made and factored into the equation. If the connection receives fast-down messages then this would make the Foresight connection react faster than the equivalent ABR connection to congestion. To compensate for this, Nrm needs to be set at a value of less than 100 msecs, a suggested value to aim for is between 60-70 secs (this would be approximate as n is configurable in steps of 2**n). This would mean that, in the event of congestion, the ABR connection would start to react faster.

Rate Increase Factor (RIF)

A factor of PCR in ABR and MCR in Foresight. The default RIF for Foresight is MCR*.10. Therefore, RIF should be configured so that (PCR*RIF) approximates MCR*0.1. If Fast-Down is still effectively enabled, then PCR*RIF should approximate MCR*0.62 to compensate.

Rate Decrease Factor (RDF)

RDF should be 1/8. This approximates to 13% that Foresight uses.


Example

Assume a network is currently running Foresight with default parameters, and supports the following four connection type, where CIR = MIR, PIR = port speed and QIR = PIR:

·T1 Port Speed = 64K CIR

Example: CIR = MIR = 64K

PIR = QIR = port speed = 1544

Fastdown = 13%

The following calculation used to convert between Frame based parameters (CIR, PIR etc) and their equivalent cell-based parameters is FR_param *3/800. This allows for cell overheads based on frame sizes of 100 octets.)

CIR = MIR = (64000*3/800) = 240 cps

PIR = QIR = (1544 *3/800) = 5790 cps

Table 1-7 Guidelines for Foresight and ABR Settings

Foresight
ABR

Rate-up equals (240*.1) = 24 cps

RIF equals "x" where (1590/x) = 24 cps

"x"needs to be approximately 200

RIF equals 256 (nearest factor of 2)

RDF equals 13%

RDF = 1/8

Nrm equals 100 msecs

RM cells are generated in the range 6 (5790 cps approx equal to 32 cells per 6 msecs) and 133 msecs (240 cps approx equal to 32 cells every 133 msecs) depending on ACR.


Performance Parameters for Foresight and Standard ABR

AUSM-8 Performance

Following performance is measured for E1 card. The "% of throughput" is % bandwidth of total line bandwidth.

Table 1-8 Foresight Connections

No. of Connections
Throughput
% of Throughput

8

36000 cps/card, (15.9 Mbps),

99%

512

29268 cps/card, (12.66 Mbps),

82.8%

1000

28277 cps/card, (11.9 Mbps),

78%


Table 1-9 Source/Destination Behaviour Standard ABR Connections. Connection Configuration Setting: Nrm = 64, Trm = 100 ms

No. of Connections
Throughput
% of Throughput

8

36000 cps/card, (15.5 Mbps),

96.86% (Limited by Nrm)

1000

20214 cps/card, (8.9 Mbps),

55.55% (Limited by Trm)


Table 1-10 Switch Behaviour Standard ABR Connections. Connection Configuration Setting:
Nrm = 64, Trm = 100 ms

No. of Connections
Throughput
% of Throughput

Full bandwidth supported.


Table 1-11 Source/Destination Behaviour Standard ABR Connections. Connection Configuration Setting: Nrm = 64, Trm = 100 ms

No. of Connections
Throughput
% of Throughput

8

36000 cps/card, (15.5 Mbps),

96.86% (Limited by Nrm)

1000

20214 cps/card, (8.9 Mbps),

55.55% (Limited by Trm)


FRSM-8 Performance

Table 1-12 FRSM-8 Performance: Connection Configuration Setting: Nrm = 64, TRM = 100 ms, Frame size = 100 bytes

No. of Connections
Throughput

64

12.6 Mbps

1000

7.1 Mbps),


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

Value to set 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

Value to set type of service.

1 = CBR (Constant Bit Rate)

2 = VBR (Variable Bit Rate)

3 = ABR (Available Bit Rate)

4 = UBR (Unspecified Bit Rate)

CAC

Enable or disable connection admission control. Before a connection is added, a connection admission test can be done to check if the port can accommodate the new connection without affecting the promised bandwidth for already existing connections. CAC for Standard ABR connections is done based on the connection's MCR.

1 = enable

2 = disable (default)

mastership

Value to set 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: AUSM-8T1/8E1

addcon <port number> <Channel VPI> <Channel VCI> <Connection Type> <Service Type> [Controller Type] [Mastership] [Remote End Connection Id]

Syntax Description

port number

Port number for T1 or E1, values ranging from 1-8.

Channel VPI

Virtual Path Identifier value in the range 0-255. The VPI, together with the VCI, is used to identify the next destination of a cell as it passes through a series of ATM switches on its way to its destination.

Channel VCI

Virtual Channel Identifier in the range 0-65535 for VCC * for VPC.

Connection Type

One of the following values:

0 = VCC

non zero = Local VP Id of the VPC (in the range 1-1000)

Service Type

Select one of the following Service Types:

1 = CBR

2 = VBR

3 = Standard ABR

4 = UBR

5 = rt-VBR

6 = ForeSight ABR

Controller Type (Signalling)

Select one of the following types:

1 = PVC (PAR) (the default)

2 = SPVC (PNNI)

mastership

Value to set status of the connection as master or slave.

1 = master

2 = slave (default)

RemoteEndConID

Node name, slot number, port number, and external connection ID number.


Example 1-11 Add a Standard ABR connection with default parameters.

pxmsjc.1.11.AUSMB8.a > addcon

Syntax : addcon "port_num vpi vci conn_type service_type [Controller_Type]
[mastership] [remoteConnId]
"
         port number -- values ranging from 1-8
         Channel VPI -- Virtual Path Identifier: 0 - 255
         Channel VCI -- Virtual Channel Identifier: 0 - 65535 for VCC, * for VPC
         Connection Type -- Connection Type : 0 - VCC , non zero - Local
                            VP Id of the VPC (1 to 1000)
         Service Type -- Service Type: 1 - CBR, 2 - VBR, 3 - Standard ABR,
                                       4 - UBR, 5 - rt-VBR, 6 - ForeSight ABR
         Controller Type (Signalling) -- 1: PVC (PAR) - Default , 2: SPVC (PNNI)
         Mastership -- 1 for master, 2 for slave   Default:Slave
         Remote end Connection ID -- Format : NodeName.SlotNo.PortNo.ExternalConnId

        possible errors are :
        a) Illegal/Invalid parameters
        b) channel already exists
        c) port may not be up


pxmsjc.1.11.AUSMB8.a > addcon 1 30 300 0 3 1 1 pxmsjc.11.1.20.200

Example 1-12 Use the dspconstdabr command to view standard ABR values. The following default values will be taken by the Standard ABR parameters for a connection.

pxmsjc.1.11.AUSMB8.a > dspconstdabr
     Minimum Cell Rate           :  10 Cells per second
     Peak Cell Rate              :  10 Cells per second
     Initial Cell rate           :  10 Cells per second
     Rate Increase Factor        :  128
     Rate Decrease Factor        :  16
     Nrm -- Inrate Cell Count    :  64
     Trm -- Time limit for Frm   :  255 milliseconds
     Transient Buffer Exposure   :  16777215 Cells
     Fixed Round Trip Time       :  0 milliseconds
     ACR Decrease Time Factor    :  500 milliseconds
     Cutoff Decrease Factor      :  16
     ABRType                     :  Switch behavior without VS/VD

Syntax: FRSM-T1/E1

addcon <port number> <DLCI> <CIR> <channel type> [CAC] [controller type] [mastership] [RemoteEndConID] [service type]

Syntax Description

port number

Port number in the range:

T1 = 1-192

E1 = 1-248

DLCI

Data-link connection identifier (DLCI) value, in the range 0-1023.

CIR

Committed information rate (CIR) bps value:

For T1 = in the range 0-1536000

For E1 = in the range 0-2048000.

channel type

Value to set 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

Connection Admission Control (CAC)

This is an optional parameter. You can select one of the following values:

1 = enable

2 = disable (the default)

controller type

Value to set signalling controller type as either PVC or SPVC.

1 = PVC (PAR) (default)

2 = SPVC (PNNI)

mastership

Value to set status of connection as master or slave.

1 = master

2 = slave (default)

Adm_cntrl

Value to enable or disable connection admission control (CAC).

1 = enable CAC

2 = disable CAC (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.

service type

Select one of the following service types:

1 = high priority

2 = rtVBR (real-time)

3 = nrtVBR (non-real-time)

4 = fstABR (ForeSight)

5 = UBR

9 = stdABR


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

Value to set 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

Value to set 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

Value to enable or disable connection admission control (CAC).

1 = enable CAC

2 = disable CAC (default)

controller_type

Value to set signalling controller type as either PVC or SPVC.

1 = PVC (PAR) (default)

2 = SPVC (PNNI)

mastership

Value to set status of connection as 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

Value to set 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

Value to set 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

Value to enable or disable CAC.

1 = enable CAC

2 = disable CAC (default)

controller_type

Value to set signalling controller type as either PVC or SPVC.

1 = PVC (PAR) (default)

2 = SPVC (PNNI)

mastership

Value to set status of connection as 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

Value to set 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

Value to set 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

Value to enable or disable CAC.

1 = enable CAC

2 = disable CAC (default)

controller_type

Value to set signalling controller type as either PVC or SPVC.

1 = PVC (PAR) (default)

2 = SPVC (PNNI)

mastership

Value to set status of the connection as 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: 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.

T1 range = 1-192

E1 range = 1-248

sig_type

Channel associated signalling (CAS) value.

1 = basic

2 = E1 CAS

3 = DS1 superframe CAS

4 = DS1 extended superframe CAS

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.

Structured E1, in the range 20-47.

Unstructured T1/E1, in the range 33-47.

cond_data

Conditional data UDT or SDT.

UDT = 255

SDT range = 0-255

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

Value to set signalling controller type as either PVC or SPVC.

1 = PVC (PAR) (default)

2 = SPVC (PNNI)

mastership

Value to set status of current end as the 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.


Related Commands

delcon, dspcons, dspcon

Attributes

Log: Yes

State: Active

Privilege: Any


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 non-contiguous

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
spirit4.1.28.VISM.a > 

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>

Syntax Description

group_num

Number of the IMA group to be configured, in the range 1-8.

port_type

Value to set port type as either UNI or NNI.

1 = UNI

2 = NN1

list_of_links

List of links to be included in group_num. Delineate each item with a (.) in the list .


Related Commands

dspimagrp, dspimagrpcnt, dspimagrps, dspimainfo, dspimalncnt

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-14 Add IMA group 2 as UNI with lines 3, 4, and 5

spirit4.1.88.AUSM.a > addimagrp 2 1 3.4.5  
spirit4.1.88.AUSM.a > 

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 = enter the value 15 or 31

port range = 1-3

Slot number 15 is used for the cards in slot and 15 and 16 (whichever is active) and slot 31 is used for cards in 31 and 32.

T1Slot

T1 slot number, in the range 1-28.

Number of T1s

Number of T1s, in the range 1-8.

Target Slot num

T1 service module slot number to be linked to the T1 line, in the ranges 1-6, or 11-14, or 17-22, or 27-30.

TargetSlotLineNum

T1 line number in the slot to be linked, in the range 1-4 or 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 15 and T1 line number 5 on the T1 service module in slot 3

spirit4.1.8.PXM.a > addlink 15.2 1 3 5 
spirit4.1.8.PXM.a > 

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. This command can be used only if a feeder trunk exists.

After you have executed the addlmiloop command on the MGX 8800 series 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 8800 series switch. The LMI messages will not show an increase after LMI looping is implemented.

Figure 1-3 Status Messages Halted between an MGX 8800 Series Switch and a BPX Switch

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


Example 1-16 Add an LMI loopback line numbered 1 to the current card (the PXM in slot 8)

spirit4.1.8.PXM.a > addlmiloop 1 
spirit4.1.8.PXM.a > 

Example 1-17 Add a feeder loop on the BPX

spirit4.1.8.PXM.a > addfdrlp 5.5
spirit4.1.8.PXM.a > 

Example 1-18 Display LMI loop

spirit4.1.8.PXM.a > dsplmiloop
TRK     IN LMI LOOP
-------------------
1.8 Yes 

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
Update Status    Rx:         203
Status Ack       Tx:         203


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
Update Status    Rx:         203
Status Ack       Tx:         203

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, VISM

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.port.

slot = enter a value from the range 7, 8, 15, 16, 31, or 32

port = 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.port.

slot = enter a value from the range 7, 8, 15, 16, 31, or 32

port = 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.port.

slot = enter a value of 7. Enter 8 if the active PXM is in slot 8

port = 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 8800 series switch node. With an OC-12 trunk, the only active port with any MGX 8800 series switch implementation is port 1.


Syntax: FRSM (8T1, 2CT3, HS1/B), AUSM, SRM, CESM, VISM

addln <line_num>

Syntax Description

line_num

Line number, in the range appropriate for the interface.

8T1 range = 1-2

CT3 range = 1-2

HS1/B range = 1-4


Syntax: AUSM (8T1/E1, IMATM-T3T1/E3E1), SRM, CESM, VISM

addln <line_num>

Syntax Description

line_num

Line number, in the range 1-8.


Related Commands

cnfln, delln, dspln

Attributes

Log: Yes

State: Active

Privilege: 1 (Any on PXM)


Example 1-20 Add a line numbered 1 to current card (the PXM in slot 8)

spirit4.1.8.PXM.a > addln 1 
spirit4.1.8.PXM.a > 

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.port.

slot = enter a value from the range 7, 8, 15, 16, 31, or 32

port = 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.port.

slot = enter a value from the range 7, 8, 15, 16, 31, or 32

port = 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.port.

slot = enter the value either 7 or 8

port = value in the range 1-N, as appropriate for the physical installation

Set line number value at 7 if the line type is SONET


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


Example 1-21 Add lines 1 and 2 to IMA group 2

spirit4.1.18.AUSM.a > addlns2aimgrp 2 1.
spirit4.1.18.AUSM.a > 

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 and FRSM-8T1E1-C 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> <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.

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 begging 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.1.CESM.a > addport 1 1 1 24 1
node501.1.1.CESM.a > 

addred

Add Redundancy

Use the addred command to link two MGX 8800 series switch slots (a primary slot and a secondary slot) so that the switch treats the cards in these slots as a redundant pair of cards.

The secondary slot should be in the same half of the shelf (upper or lower) as the primary slot. 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 1-6, or 9-14, or 17-22, or 25-30.

redSecondarySlotNum

Slot number that contains the secondary card of the card pair, in the ranges 1-6, or 9-14, or 17-22, or 25-30.

redType

Value to set 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 1

node501.1.7.PXM.a > addred 1 4 1
node501.1.7.PXM.a > 

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. The configuration should reflect future development plans for PNNI or other controllers.


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

Value to set 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 State

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.7.PXM.a > addserialif 1
NODENAME.1.7.PXM.a > 

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 will not age, and will not be 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.7.PXM.a > addtrapmgr 161.10.144.56 162
node501.1.7.PXM.a > 

addtrk

Add Trunk

Use the PAR 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 partitioned resources for PAR by using addrscprtn and 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 = 1-6, or 9-14, or 17-22, or 25-30

port range = 1-N, as appropriate for the physical installation


Related Commands

cnftrk, dsptrkcnf, dsptrkload, dsptrks

Attributes

Log: No

State: Active

Privilege: 1


Example 1-26 Activate trunk on port 4 in the card in slot 1

node501.1.7.PXM.a > addtrk 1.4
node501.1.7.PXM.a > 

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: 5-6


Example 1-27 Add a user named fin with privilege level ANYUSER

spirit.1.7.PXM.a > adduser fin ANYUSER

Enter password:
Re-enter password: 
 
spirit.1.7.PXM.a >

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

Value to enable or disable aging of either the 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 State

Privilege: 1-6


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 State

Privilege: 1-6


Example 1-28 Display Help screen for AUSM service module

raviraj.1.9.AUSM8.a > aimhelp

AUSM-8P Commands

  addcon          :  Add a Connection
  addimagrp       :  Add an IMA group
  addln           :  Add a line
  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
  delln           :  Delete DS1 line
  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
  dspln           :  Display DS1 line
  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
ory cell
  tstdelay        :  Measure the delay towards the N/W side
  tstdelaysti     :  Measure the delay towards the N/W side using STI supervisor
y cell
  upport          :  Up an ATM port
  xcnfalm         :  Configure alms of a DS1 line
  xcnfln          :  Configure a DS1 line      
  xcnfln          :  Configure a DS1 line


raviraj.1.9.AUSM8.a > 

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, 6 bytes long. Also known as a hardware address, MAC-layer address, and physical address.


Related Commands

arpShow, arpDelete, arpFlush

Attributes

Log: No

State: Any State

Privilege: 1-6


Example 1-29 Add an ARP entry on current PXM, then show ARP entry

NODENAME.1.7.PXM.a > arpAdd 172.29.36.102 0:e0:4f:5c:6c:5a

NODENAME.1.7.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
NODENAME.1.7.PXM.a >

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 State

Privilege: 1-6


Example 1-30 Delete ARP entry for IP address 172.29.36.102

NODENAME.1.7.PXM.a> arpDelete    172.29.36.102
172.29.36.102 (172.29.36.102) deleted
NODENAME.1.7.PXM.a>

arpFlush

Flush Address Resolution Protocol Table

Use the arpFlush command to remove non-permanent 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 State

Privilege: 1-6


Example 1-31 Flush ARP table, then show ARP table

NODENAME.1.7.PXM.a > arpFlush

NODENAME.1.7.PXM.a > arpShow
171.71.54.104 at 0:e0:4f:5c:6c:20
NODENAME.1.7.PXM.a >

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 State

Privilege: 1-6


Example 1-32 Show ARP table on current PXM

NODENAME.1.7.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
NODENAME.1.7.PXM.a >

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.7.PXM.a > bootChange

'.' = clear field;  '-' = go to previous field;  ^D = quit

boot device          : lnPci
processor number     : 0
host name            :
file name            :
inet on ethernet (e) : 172.29.37.41 : ffffff00
inet on backplane (b):
host inet (h)        :
gateway inet (g)     : 172.29.37.1
user (u)             :
ftp password (pw) (blank = use rsh):
flags (f)            : 0x0
target name (tn)     :
startup script (s)   :
other (o)            :


raviraj.1.7.PXM.a >  

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 State

Privilege: Any


Example 1-34 Exit current CLI shell

spirit.1.8.PXM.a > bye
 
(session ended)

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-32.


Related Commands

None

Attributes

Log: Yes

State: Any State

Privilege: Any


Example 1-35 Switch from AUSM in slot 22 to PXM in slot 8

node1.1.22.AUSM8.a > cc 8 
 
(session redirected)
 
node1.1.8.PXM.a >

A system message does not occur unless an error is detected. If the card slot is empty, an error message is presented.

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 State

Privilege: 3


Example 1-36 Change directory to FW

raviraj.1.7.PXM.a > cd FW

raviraj.1.7.PXM.a >

Verify the current directory by using the pwd command.

Example 1-37 Return to Root directory

raviraj.1.7.PXM.a > pwd
C:FW

raviraj.1.7.PXM.a > cd ..

raviraj.1.7.PXM.a > pwd
C:

raviraj.1.7.PXM.a > 

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


Example 1-38 Clear all AIM group counters in AIM group 8

node1.1.22.AUSM8.a > clraimgrpcnt 8
node1.1.22.AUSM8.a > 

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


Example 1-39 Clear all AIM line counters in AIM group 8

node1.1.22.AUSM8.a > clraimlncnt 8
node1.1.22.AUSM8.a > 

clrallcnf

Clear All Configurations

Use the clrallcnf command to clear all configuration elements for all the cards in the node. The system will query for confirmation before executing the clrallcnf command.


Caution Take care when using this command. This will clear 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: 1-3


Example 1-40 Clear Configuration Confirmation Query

node1.1.7.PXM.a > clrallcnf

All SM's config will be deleted, and
        the shelf will be reset.
Do you want to proceed (Yes/No)? No
(command not executed)

node1.1.7.PXM.a > 

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, VISM

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.port.

slot = enter a value from the range 7, 8, 15, 16, 31, 32

port 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.port.

slot = enter a value from the range 7, 8, 15, 16, 31, 32

port 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.port.

slot = enter the value either 7 or 8

port 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 range 1-N.

line number = enter a value from the range 7, 8, 15, 16, 31, 32


Syntax: FRSM, AUSM, CESM, or VISM

clralm -ds1 <LineNum>

Syntax Description

-ds1

Command delineator that precedes the LineNum entry.

LineNum

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

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

LineNum = 1-N, where N = 3 if SRM-3T3


Syntax: FRSM-HS1

clralm -hs1 <LineNum>

Syntax Description

-hs1

Command delineator that precedes the LineNum entry.

LineNum

LineNum = 1-N, where N = 4 if FRSM


Related Commands

clralms, dspalm, dspalms

Attributes

Log: No

State: Any State

Privilege: 5-6


Example 1-41 Clear all alarms caused by the collection of statistical data for line 1 on current card

node1.1.22.AUSM8.a > clralm -ds1 1
node1.1.22.AUSM8.a > 

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, VISM

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.port

slot = enter a value from the range 7, 8, 15, 16, 31, 32

port 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.port

slot = enter a value from the range 7, 8, 15, 16, 31, 32

port 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.port

slot = enter the value either 7 or 8

port range = 1-N, as appropriate for the physical installation

-plcp

Command delineator that precedes the PLCPNUM entry.

PLCPNUM

Physical Layer Protocol Processor (PLCP) value. Range: 1-N, as appropriate for the physical installation.

slot = enter a value from the range 7, 8, 15, 16, 31, 32


Syntax: FRSM, AUSM, CESM, or VISM

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 State

Privilege: Any (5 on PXM)


Example 1-42 Clear all alarm counters and statistics collected for line 1 on current card

node1.1.22.AUSM8.a > clralmcnt -ds1 1
node1.1.22.AUSM8.a > 

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, VISM

Syntax

clralmcnts

Related Commands

dspalmcnt, clralmcnt

Attributes

Log: No

State: Any State

Privilege: 1-5


Example 1-43 Clear all alarm counters and statistics collected for current card

node1.1.22.AUSM8.a > clralmcnts
node1.1.22.AUSM8.a > 

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.

Card(s) on Which This Command Executes

FRSM, AUSM, CESM, VISM

Syntax: FRSM, AUSM,CESM, or VISM

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 State

Privilege: 1-5


Example 1-44 Clear all alarms triggered by the collection of statistics for line 1 on current card

node1.1.22.AUSM8.a > clralms -ds1 1
node1.1.22.AUSM8.a > 

clratmlncnt

Clear All ATM Line Counters on Specified Line Number

The clratmlncnt clears 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 State

Privilege: Any


Example 1-45 Clear all ATM event counters for line 1 on the PXM

node1.1.7.PXM.a > clratmlncnt 1
node1.1.7.PXM.a > 

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 State

Privilege: Any


Example 1-46 Clear all ATM event counters on the PXM

node1.1.7.PXM.a > clratmlncnts
node1.1.7.PXM.a > 

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 State

Privilege: Any


Example 1-47 Clear all BERT counters on the current FRSM

raviraj.1.13.VHS2CT3.a > clrbertcntrs

raviraj.1.13.VHS2CT3.a >

clrcderrs

Clear Hardware/Reset Errors in BRAM

The clrcderrs command clears all card-related errors in an MGX 8800 series switch card. No response messages appear on screen. 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 State

Privilege: SuperUser


Example 1-48 Clear all card-related errors on the FRSM in slot 4

node1.1.4.FRSM.a > clrcderrs
node1.1.4.FRSM.a > 

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

Value to set 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 State

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
node1.1.4.FRSM.a > 

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 State

Privilege: 1-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
node1.1.4.FRSM.a > 

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 circuit identifier in the range 0-65535


Related Commands

dspcon, clrconcnts, dspconcnt

Attributes

Log: Yes

State: Any State

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.8.PXM.a > clrconcnt 1.2.2
node4.1.8.PXM.a > 

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 State

Privilege: Any


Example 1-52 Clear all counters for all connections on the PXM card

node4.1.8.PXM.a > clrconcnts
node4.1.8.PXM.a > 

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 State

Privilege: Any


Example 1-53 Show clrerr confirmation query

wilco.1.7.PXM.a > clrerr

Do you want to proceed (Yes/No)? No
(command not executed) 

wilco.1.7.PXM.a > 

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 State

Privilege: Any


Example 1-54 Clear counters for the specified broadband interface (1)

wilco.1.7.PXM.a > clrifcnt 1
ilco.1.7.PXM.a > 

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 State

Privilege: Any


Example 1-55 Clear counters for all broadband interfaces on the PXM card

wilco.1.7.PXM.a > clrifcnts
wilco.1.7.PXM.a > 

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


Example 1-56 Clear all inverse multiplexing ATM group counters for IMA group 1 on the AUSM card in slot 17

flyers01.1.17.AUSM.a > clrimagrpcnt 1
flyers01.1.17.AUSM.a > 

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

dspaimlncnt, clraimlncnt

Attributes

Log: No

State: Active

Privilege: 1


Example 1-57 Clear all inverse multiplexing ATM line counters for IMA group 1 on the AUSM card in slot 17

flyers01.1.17.AUSM.a > clrimalncnt 1
flyers01.1.17.AUSM.a > 

clrlmistats

Clear All LMI Statistics

Use the clrlmistats command to clear the Local Management Interface (LMI)-related statistics on the current PXM.

Card(s) on Which This Command Executes

PXM

Syntax

clrlmistats

Related Commands

dsplmistats

Attributes

Log: No

State: Any State

Privilege: Any


Example 1-58 Clear LMI statistics on the PXM card

penguin.1.7.PXM.a > clrlmistats

Enabled        :          1   Port Status    :          1
VPI.VCI        :        3.31
Polling enable :          1
T393           :         10   N394           :          5
T394           :         10   N395           :          5
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
Invalid Trans  :          0
BPX IP Addr    :  172.3.3.62

penguin.1.7.PXM.a > 

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 State

Privilege: 1


Example 1-59 Clear all event log files on the PXM card

wilco.1.7.PXM.a > clrlog

Do you want to proceed (Yes/No)? Yes  

wilco.1.7.PXM.a > 

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, VISM

Syntax

clrmsgcnt

Related Commands

dspmsgcnt

Attributes

Log: No

State: Any State

Privilege: 1-5


Example 1-60 Clear all control message counters on the AUSM card in slot 17

flyers01.1.17.AUSM.a > clrmsgcnt 1
flyers01.1.17.AUSM.a > 

clrportcnt

Clear Port Counters

Use the clrportcnt command to clear counter values on a specified port associated with the current PXM, AUSM, or FRSM.

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

HS1/B

X.21 range = 1-4

HSSI range = 1-2


Related Commands

clrportcnts, dspportcnt

Attributes

Log: No

State: Any State

Privilege: 1-5 (Any on PXM)


Example 1-61 Clear port counters on port 1 on the AUSM card in slot 17

flyers01.1.17.AUSM.a > clrportcnt 1
flyers01.1.17.AUSM.a > 

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 State

Privilege: 1-5


Example 1-62 Clear all port counters on all ports on the AUSM card in slot 17

flyers01.1.17.AUSM.a > clrportcnts
flyers01.1.17.AUSM.a > 

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

Number of FERF cells that were received on this channel

Number of BCM cells that were received on this channel

Number of End2End loop cells that were received on this channel

Number of segment loop cells that were received on this channel

Number of cells that had the CRC error on this channel

Card(s) on Which This Command Executes

FRSM, AUSM, CESM, VISM

Syntax for FRSM-8T1E1

clrsarcnt -chn <ChanNum>

Syntax Description

-chn

Command delineator that precedes the ChanNum entry.

ChanNum

Channel number in the range 16-1015.


Syntax for CESM-8T1E1

clrsarcnt -chn <ChanNum>

Syntax Description

-chan

Command delineator that precedes the ChanNum entry.

ChanNum

Channel number in the range 0-279.


Syntax for AUSM-8T1E1

clrsarcnt <port.VPI.VCI>

Syntax Description

port.VPI.VCI

Port range = 1-N, as appropriate for the physical installation.

VPI range = 1-4095.

VCI range = 1-65535.


Related Commands

dspsarcnt

Attributes

Log: No

State: Any State

Privilege: 1-5


Example 1-63 Clear SAR counters for channel number 20 on the FRSM card

NODENAME.1.17.FRSM.a > clrsarcnt -chn 20
NODENAME.1.17.FRSM.a >

clrsarcnts

Clear SAR Counters

Use the clrsarcnts command to clear the segmentation and reassembly (SAR) counters for all the channels or connections on the card from which the command is executed.

Syntax

clrsarcnts

Card(s) on Which This Command Executes

FRSM, AUSM, CESM, VISM

Related Commands

clrsarcnt, dspsarcnt, dspsarcnts

Attributes

Log: No

State: Any State

Privilege: Any


Example 1-64 Clear all SAR counters on all cards in the node

flyers01.1.17.AUSM.a > clrsarcnts
flyers01.1.17.AUSM.a > 

clrscrn

Clear Terminal Screen

Use the clrscrn command to clear the control terminal screen. After this command executes, only the current command line prompt appears on the screen.

Card(s) on Which This Command Executes

PXM, FRSM, AUSM, CESM, VISM

Syntax

clrscrn

Related Commands

None

Attributes

Log: No

State: Any State

Privilege: Any


Example 1-65 Clear the screen

flyers01.1.17.AUSM.a > clrscrn
flyers01.1.17.AUSM.a > 

clrslftst

Clear Self-Test

Use the clrslftst command to clear the results of the last self-test on the current card.

Card(s) on Which This Command Executes

FRSM, AUSM, CESM

Syntax

clrslftst

Related Commands

cnfslftst, dspslftst, runslftstno

Attributes

Log: No

State: Any State

Privilege: Any


Example 1-66 Clear results of last self-test for the AUSM card in slot 17

flyers01.1.17.AUSM.a > clrslftst
flyers01.1.17.AUSM.a > 

clrsmcnf

Clear Service Module Configuration

Use the clrsmcnf command to clear the following configuration elements for the selected service card:

Configuration

Rate control function

Channelization on the card

MIB version


Note Before executing the clrsmcnf command, clear (delete) all lines, ports, and channels on the affected service module(s).


Card(s) on Which This Command Executes

PXM

Syntax

clrsmcnf <slot num>

Syntax Description

slot num

Slot number in the range 1-6, or 9-14, or 17-22, or 25-30.


Related Commands

dspsmcnf

Attributes

Log: Yes

State: Active

Privilege: 3


Example 1-67 Clear all configuration elements on the AUSM card in slot 17

flyers01.1.7.PXM.a > clrsmcnf 17
flyers01.1.7.PXM.a > 

clrsrmcnf

Clear SRM-3T3 Configuration

Use the clrsrmcnf command to clear SRM-3T3 card information and to remove all T1 link mappings. All links are switched back to their respective service modules.

Card(s) on Which This Command Executes

PXM

Syntax

clrsrmcnf <slot num>

Syntax Description

slot num

Slot number. Enter the value 15 or 31.

Slot number 15 is used for the cards in slot and 15 and 16 (whichever is active).

Slot 31 is used for cards in 31 and 32.


Related Commands

addlink, dsplink, xcnfsrmlink, xdspsrmlink

Attributes

Log: Yes

State: Active

Privilege: Any


Example 1-68 Clear all configuration information and remove all T1 link mappings on the SRM-3T3 card in slot 15

flyers01.1.7.PXM.a > clrsrmcnf 15
flyers01.1.7.PXM.a > 

cmdhistory

Display Command History

Use the cmdhistory command to view the last 10 commands executed on the current card.

Card(s) on Which This Command Executes

PXM

Syntax

cmdhistory

Related Commands

history

Attributes

Log: No

State: Any State

Privilege: Any


Example 1-69 Display previous 10 commands executed on the PXM card

spirit4.1.8.PXM.a > cmdhistory

Size of cmdHistory is currently 10 line(s)
  1 dspconcnt 2.39.45
  2 dsplmistats
  3 dsplmiloop
  4 dsplm
  5 clrportcnt
  6 dspportcnts
  7 dspportcnt
  8 dspportcnt 1
  9 dsplmistats
 10 cmdhistory

spirit4.1.8.PXM.a > 

cnfaimgrp

Configure AIM Group

Use the cnfaimgrp command to configure an AIMUX group on the AUSM.

Card(s) on Which This Command Executes

AUSM

Syntax

cnfaimgrp <grp> <max_diff_delay> <min_num_links>

Syntax Description

grp

IMA group number, in the range 1-8.

max_diff_delay

Maximum differential delay, in the range appropriate for the interface.

8T1 range = 0-275

8E1 range = 0-200

min_num_links

Minimum number of links for the group formation, in the range 1-8.


Related Commands

addaimgrp, delaimgrp, dspaimgrp, dspaimgrps

Attributes

Log: Yes

State: Active

Privilege: 1-2



Note Redundant link(s) indicates the number of link(s) the system can lose without bringing down the AIMUX group. However, the <link_loss_severity> option overrides this feature.

The <read_wr_ptr_diff> value cannot be decreased from its existing value—it can only be increased (this is because decreasing the <read_wr_ptr_diff> in an established AIMUX group involves dropping cells that are stored in the delay compensation buffer.


Example 1-70 Configure AIMUX group 1 on the AUSM card in slot 17 to have a read/write pointer differential of 5, a link loss severity of 2, a maximum tolerable differential delay of 5, and 2 redundant links

flyers01.1.17.AUSM.a > cnfaimgrp 1 -rwdiff 5 -severity 2 -maxdiff 3 -red 2
flyers01.1.17.AUSM.a > 

cnfapsln

Configure APS Line

Use the cnfapsln command to set Automatic Protection Switching (APS) parameters for a line on the current PXM. APS is a standard that provides a means for SONET line redundancy. APS involves switching between working (active) and protection (standby) SONET lines in the event of a hardware failure detected by the receiving end or by the far end. This support applies only to PXM OC-3 and PXM OC-12 back cards.

The 1.1.20 software release provides support for the SONET Linear APS 1+1 mode with two back cards. The SONET Linear APS 1+1 standard specifies that for every working line there must exist a redundant protection line. Traffic protected by the redundant line is carried simultaneously on both the working line and the protection line. The line switch-over to the protection line has to be completed within 60 ms.

Figure 1-4 illustrates a "dual back card" redundancy configuration. This design requires two PXM front cards and two SONET back cards. Ports are paired as follows:

Port 1 of active PXM and port 1 of standby PXM

Figure 1-4 SONET APS 1+1 with Two Back Cards

SONET 155 also can be configured to have this redundancy configuration. Ports are paired as follows:

Port 1 of active PXM and port 1 of standby PXM

Port 2 of active PXM and port 2 of standby PXM

Port 3 of active PXM and port 3 of standby PXM

Port 4 of active PXM and port 4 of standby PXM

Switching of the paired port on the pair back card can be done independently of the other paired ports.

You must add an APS line with the addapsln command before using the cnfapsln command.

Card(s) on Which This Command Executes

PXM

Syntax

cnfapsln <workline> <SFBER> <SDBER> <WTR> <Direction> <Revertive> <K1K2>

Syntax Description

workline

OC-3 or OC-12 line number, in the range appropriate for the associated interface.

OC-3 range = 1-4

OC-12 = enter the value 1

SFBER

Signal failure BER threshold, in the range 3-5.

5 = signal failure BER threshold = 10 ^^ -5

SDBER

Signal degrade BER threshold, in the range 5-9.

5 = signal degrade BER threshold = 10 ^^ -5

WTR

Number of minutes to wait before attempting to switch back to the working line, in the range 1 to 12. This setting is not applicable if the line is configured in non-revertive mode (Revertive set to 1).

Direction

Switching direction for either unidirectional or bidirectional.

1 = Unidirectional: This APS line supports only one direction.

2 = Bidirectional: This APS line supports both ends of the line.

Revertive

APS revertive or non-revertive function.

1 = Non-revertive

2 = Revertive: This setting allows the line to switch back to the working line after the wait-to-restore interval has expired and the working line SF/SD has been cleared.

K1K2

K1/K2 inband interface on the protection line. User should always set to 1.

1 = enable

2 = disable


Related Commands

addapsln, delapsln, dspapsln, dspapscfg

Attributes

Log: Yes

State: Active

Privilege: SuperUser


Example 1-71 Configure APS working line 1 on the active PXM card in slot 7 to have a signal failure BER threshold of 10^^5, a signal degrade BER threshold of 10^^5, to enable switch back after signal failure or degradation has cleared, to wait 2 minutes before attempting to switch back, to make switching bidirectional, and to enable the K1/K2 inband interface on the protection line

flyers01.1.7.PXM.a > cnfapsln 1 5 5 1 2 1 1
flyers01.1.7.PXM.a > 

cnfatmln

Configure ATM Line

Use the cnfatmln command to configure a UNI or NNI cell header for a PXM trunk. UNI cell headers are typically used on the line that connects to a workstation rather than a switch.


Note You must configure the cell header type using the cnfatmln command before adding lines and ports.


Card(s) on Which This Command Executes

PXM (in an MGX 8800 series switch stand-alone node)

Syntax

cnfatmln <line_num> <type>

Syntax Description

line_num

OC-3 or OC-12 line number, in the range appropriate for the interface.

OC-3 range = 1-4

OC-12 = enter the value 1

type

Cell header type for either UNI or NNI.

2 = UNI

3 = NNI (default)


Related Commands

dspatmlncnf, clratmlncnt

Attributes

Log: No

State: Any State

Privilege: Any


Example 1-72 Set cell header type for trunk 1 on the PXM to NNI

flyers01.1.7.PXM.a > cnfatmln 1 3
flyers01.1.7.PXM.a > 

cnfbctype

Configure Back Card Type

Use the cnfbctype command to specify the interface of the 12in1 dual-personality back card. The back card can be configured with either an X.21 or a V.35 interface. The default interface is V.35.


Note The cnfbctype is not allowed if there are enabled lines on the card.


Card(s) on Which This Command Executes

FRSM-HS1B

Syntax

cnfbctype <cardType>

Syntax Description

cardType

Integer that specifies the interface type:

1 = X.21

2 = V.35 (default)


Related Commands

dspbctype

Attributes

Log: Yes

State: Any State

Privilege: Service


Example 1-73 Configure interface type on the current FRSM card

man.1.14.FRSM.a > cnfbctype 1

Example 1-74 Display interface type on the current FRSM

man.1.14.FRSM.a > dspbctype

Backcard Personality: X.21

cnfbert

Configure BERT

Use the cnfbert command to configure bit error rate testing (BERT) parameters on the PXM.

A BERT session does not time out automatically. Use the delbert command to end the test.


Caution BERT is a disruptive test. Activation of this test will stop the data flow on all the channels configured on the port under test. BERT requires the presence of an SRM-3T3/B card in the service bay, in which the card under test is located.

Card(s) on Which This Command Executes

PXM

Syntax: PXM

cnfbert <slot>

Syntax Description

slot

Slot number that contains the card on which to perform BERT.


Related Commands

delbert, dspbert, modbert, xcnfbert

Attributes

Log: Yes

State: Active

Privilege: 1


cnfcbclk

Configure Cell Bus Clock

Use the cnfcbclk command to set the cell bus (CB) operating clock rate to high (42 MHz) or low
(21 MHz). There are eight cell buses in an MGX 8800 series switch shelf. You can use the cnfcbclk command to set the cell bus to different operating clock rates to take advantage of high-speed service modules whenever possible. Note that not all service modules can support the high clock rate.


Note Even though you can specify this command against CB4 and CB8, note that the clock rate will not change for either cell bus.


Card(s) on Which This Command Executes

FRSM_2CT3, FRSM_2T3, FRSM_2E3, FRSM_HS2, CESM_T3, CESM_E3, VISM_8T1, VISM_8E1, RPM (new), PXM

Syntax

cnfcbclk <cellBus> <clockRate>

Syntax Description

cellBus

A string denoting a bus, in the range CB1 to CB8.

clockRate

A rate value, in MHz.

21

42


Possible Errors

Set failed due to illegal option value(s).

Certain service modules will not operate at the clock rate you specified. Please check the service modules in the slots where the cell bus clock rate is affected by this command.

Related Commands

dspcbclk

Attributes

Log: Yes

State: Active

Privilege: SuperUser


Example 1-75 Display cards in the chassis, display current clock settings, configure CB2 for 42 MHz, and display clock settings with new setting for CB2

NODENAME12.1.7.PXM.a > dspcds
Command Executed :dspcds

    Slot  CardState    CardType     CardAlarm  Redundancy
    ----  -----------  --------     ---------  -----------
    1.1   Empty                     Clear
    1.2   Active       FRSM-8T1     Clear
    1.3   Empty                     Clear
    1.4   Empty                     Clear
    1.5   Empty                     Clear
    1.6   Active       FRSM-8T1     Clear
    1.7   Active       PXM1-OC3     Clear
    1.8   Empty                     Clear
    1.9   Empty                     Clear
    1.10  Empty                     Clear
    1.11  Empty                     Clear
    1.12  Empty                     Clear
    1.13  Empty                     Clear
    1.14  Empty                     Clear
    1.15  Empty                     Clear
    1.16  Empty                     Clear
    1.17  Empty                     Clear
    1.18  Empty                     Clear
    1.19  Empty                     Clear

Type <CR> to continue, Q<CR> to stop: q

NODENAME12.1.7.PXM.a > dspcbclk
Command Executed :dspcbclk

     CellBus    Rate (MHz)    Slot
    -------------------------------
       CB1         21        1, 2
       CB2         21        3, 4
       CB3         21        5, 6
       CB4         21        17 - 22
       CB5         21        9, 10
       CB6         21        11, 12
       CB7         21        13, 14
       CB8         21        25 - 30

NODENAME12.1.7.PXM.a > cnfcbclk cb2 42
Command Executed :cnfcbclk
NODENAME12.1.7.PXM.a > dspcbclk
Command Executed :dspcbclk

     CellBus    Rate (MHz)    Slot
    -------------------------------
       CB1         21        1, 2
       CB2         42        3, 4
       CB3         21        5, 6
       CB4         21        17 - 22
       CB5         21        9, 10
       CB6         21        11, 12
       CB7         21        13, 14
       CB8         21        25 - 30

Example 1-76 Error messages that might be displayed when executing this command

popeye12.1.7.PXM.a > cnfcbclk cb1 42
Command Executed :cnfcbclk
Set failed due to illegal option value(s)

Syntax: cnfcbclk <cellBus> <clockRate>
        cellBus -- a string CB1..CB8
        clockRate -- a number 21 or 42 (MHz)

WARNING: Certain Service Modules will not operate at the clock rate you
specified. Please check the Service Modules in the slots where the Cell Bus clock
rate is effected by this command

cnfcdprtntype

Configure Card Resource Type

Use the cnfcdprtntype command to configure the type of partition to serve as the basis for sharing global logical connection numbers (GLCNs). The GLCNs are shared by the network controller applications (PAR, for example) on a logical broadband interface.

Card(s) on Which This Command Executes

PXM, FRSM, AUSM, CESM

Syntax

cnfcdprtntype <prtn_type>

Syntax Description

prtn_type

Value to set card partition type, in the range 1-3.

1 = noPartition
All controllers compete for the total number of (G)LCNs available for the card.

2 = controllerBased
The total number of (G)LCNs available to each controller is fixed but there is no reservation on each port.

3 = portControllerBased
Some of the (G)LCNs that are available on each port for each controller are reserved.


Related Commands

cnfcdrscprtn

Attributes

Log: No

State: Any State

Privilege: Any


Example 1-77 Allow all controllers access to all (G)LCNs available for the card

spirit3.1.10.AUSMB8.a > cnfcdprtntype 1
spirit3.1.10.AUSMB8.a > 

cnfcdrscprtn

Configure Card Resource Partition

Use the cnfcdrscprtn command to modify card-level resource partitions on the current card. This command creates a template of available connections among the network controllers to provide card-level partitioning for PAR, PNNI, or Tag. 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.

The matrix in Table 1-13 describes the effects of each of three usages of cnfcdrscprtn.

Table 1-13 Degrees of Card-Level Resource Partitioning

Command
Description

cnfcdrscprtn off

Card-level partitioning is inactive. If you specify that card-level partitioning is off (cnfcdrscprtn off), you must configure port-level partitions (cnfportrscprtn).

cnfcdrscprtn 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, so each controller competes for the connections.

cnfcdrscprtn on <x> <y> <z>

The x, y, and z represent a number of connections per port available to the PAR, PNNI, and Tag controllers, respectively.



Note PNNI is always 0 in Release 1 of the MGX 8800 series switch.


Additional characteristics of this command are:

If you do not execute cnfcdrscprtn, the default state of cnfcdrscprtn on is in effect.

If you specify card-level partitioning (cnfcdrscprtn 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, AUSM, CESM, VISM

Syntax

cnfcdrscprtn <number_PAR_conns> <number_PNNI_conns> <number_Tag_conns>

Syntax Description

number_PAR_conns

Maximum number of PAR connections, in the range appropriate for the current card.

PXM range = 0-32,767 GLCNs

FRSM range = 1-4000

AUSM range = 1-1000

CESM range = 1-1000

SRM range = 1-1000

number_PNNI_conns

Maximum number of PNNI connections. Enter the value 0 (zero).

number_Tag_conns

Maximum number of Tag connections.


Related Commands

addcdrscprtn, delcdrscprtn, dspcdrscprtn

Attributes

Log: Yes

State: Any State (Active for PXM)

Privilege: Any


Example 1-78 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.

spirit.1.7.PXM.a > cnfcdrscprtn 10000 0 10000
spirit.1.7.PXM.a > 

cnfchan

Configure Channel

Use the cnfchan command to configure channels on the current service card.

Card(s) on Which the Command Executes

PXM, AUSM, CESM

Syntax: PXM

cnfchan <LCN> <chan_rte_pri> <chan_max_cost> <chan_restrict_trk_type>

Syntax Description

LCN

LCN, in the range16-4111.

chan_rte_pri

Channel route priority, in the range 1-15.

chan_max_cost

Maximum cost, in the range 1-255.

chan_restrict_trk_type

Channel Restrict Trunk Type.

1 = No Restriction

2 = Terrestrial Trunk

3 = Satellite Trunk


Syntax: AUSM-8T1E1

cnfchan <chan_num> <RoutingPriority> <MaxCost> <RestrictTrunkType> <PCR> <MCR> <PctUtil>

Syntax Description

chan_num

Channel number, in the range 16-1015.

RoutingPriority

Routing Priority, in the range 1-15.

MaxCost

Maximum cost, in the range 1-255.

RestrictTrunkType

Restrict Trunk Type.

1 = No Restriction

2 = Terrestrial Trunk

3 = Satellite Trunk

PCR

Peak cell rate, in the range 1-65525 cells per second.

MCR

Minimum cell rate, in the range 1-65525 cells/second.

PctUtil

Percentage of utilization, in the range 1-100.


Syntax: CESM-8T1E1

cnfchan <chan_num> <CDVT> <CLIP> <bufsize> <clockmode> <IdleSuppEnable> <ForceIS>

Syntax Description

chan_num

Channel number (LCN). Enter the value 32.

CDVT

Cell Delay Variation Tolerance in the range appropriate for T1 or E1.

T1 = 125-24000 microseconds

E1 = 125-32000 microseconds

CLIP

Cell Loss Integration Period. Enter a value in the range 1000-65535 milliseconds.

bufsize

Maximum Egress Buffer size, as appropriate for T1 or E1.

Structured T1 = 9216 bytes (maximum)

Unstructured T1 or E1 = 16384 bytes (maximum)

clockmode

Clock mode of the CBR virtual circuit.

1 = synchronous clocking

2 = synchronous residual time-stamp clocking

3 = adaptive clocking

IdleSuppenable

Idle suppression, either disabled or enabled.

1 = disable

2 = enable

ForceIS

Forced idle suppression or normal operations.

1 = normal operation

2 = force Virtual Circuit into idle signal code suppression


Syntax: CESM-T3E3

cnfchan <chan_num> <CDVT> <CLIP> <bufsize>

Syntax Description

chan_num

Channel number (LCN). Enter the value 32.

CDVT

Cell delay variation tolerance, in the range appropriate for T3 or E3.

T3 range = 125-24000 microseconds

E3 range = 125-32000 microseconds

CLIP

Cell Loss Integration Period, in the range 1000-65535 milliseconds.

bufsize

Maximum egress buffer size, in bytes. Set up to the maximum 16384 for unstructured T3 or E3.


Related Commands

addchan

Attributes

Log: No

State: Any State

Privilege: Any


Example 1-79 On current AUSM in slot 17, change the configuration for channel 16 to set a routing priority of 1, a maximum cost of 5, restrict trunk routing for this channel to terrestrial trunks only, set the peak cell rate to 655525 cells per second, set the minimum cell rate to 655525 cells per second, and set the percent utilization to 100 percent

spirit.1.17.AUSM.a > cnfchan 16 1 5 2 65525 65525 100
spirit.1.17.AUSM.a > 

cnfchanabrparams

Configure Channel Standard ABR Parameters

Use the cnfchanabrparams command to configure ABR parameters for channels on an FRSM-8T1/E1 service module.

To configure rate parameters, refer to the cnfchanstdabr command.

For more information about configuring Standard ABR, including default ABR parameters, refer to the addcon command on page 32.

Card(s) on Which This Command Executes

FRSM-8T1/E

Syntax

cnfchanabrparams <Port.DLCI/CHAN_NUM> <rif > <rdf> <nrm> <trm> <tbe> <frtt> <adtf> <cdf>

Syntax Description

Port.DLCI/Channel Number

Connection identifier, in the format Port.DLCI or channel number.

rif

The Rate Increase Factor controls the amount by which the cell transmission rate may increase upon receipt of an RM cell. RIF is a power of 2. Values range from 1-32768.

rdf

The Rate Decrease Factor controls the decrease in the cell transmission rate. RDF is a power of 2. Values range from 10-32768.

nrm

The Inrate Cell Count is the maximum number of cells a source may send for each forward RM cell. Values range from 2-256 (in steps of power of 2).

trm

The Max Delay for FRM provides an upper bound on the time between forward RM cells for an active source.

Values range from 3-255 msec.

tbe

The Transient Buffer Exposure is the negotiated number of cells that the network would like to limit the source to sending during startup periods, before the first RM cell returns. Values range from 0 to 16777215 cells.

frtt

The Fixed Round Trip Time is the sum of the fixed and propagation delays from the source to the furthest destination and back. Values range from 0 to 16700 msec.

adtf

The ACR decrease time factor is the time permitted between sending RM-cells before the rate is decreased to ICR.

Values range from 10 to 10230 msec.

cdf

The Cutoff Decrease Factor controls the decrease in ACR associated with CRM. Values range from 0 to 64, in steps of power of 2.


Related Commands

cnfchanabrrates, dspchanstdabr, cnfchanstdabr, addcon, dspchan

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-80 Parameters for cnfchanabrparams

NODENAME.1.29.FRSM.a > cnfchanabrparams

Syntax : cnfchanabrparams "Port.DLCI/CHAN_NUM rif rdf nrm trm tbe frtt adtf
cdf"
         Port.Dlci -- Port.Dlci identifying a connection
         RIF -- Valid values range from 1 to 32768 (in steps of power of 2)
         RDF -- Valid values range from 1 to 32768 (in steps of power of 2)
         Nrm -- Valid values range from 2 to 256 (in steps of power of 2)
         Trm -- Valid values range from 3 to 255 in msec.
         TBE -- Valid values range from 0 to 16777215 in cells
         FRTT -- Valid values range from 0 to 16700 in msec.
         ADTF -- Valid values range from 10 to 10230 in msec.
         CDF -- Valid values range from 0 to 64 (in steps of power of 2)<Get an example>


cnfchanabrrates

Configure Channel ABR Rates

Use the cnfchanabrrates command to configure the rate parameters of the Standard ABR channel.

Card(s) on Which This Command Executes

FRSM-8T1E1

Syntax

cnfchanabrrates <Port.DLCI/Channel Number> <MCR> <PCR> <ICR>

Syntax Description

Port.DLCI/Channel Number

Connection identifier.

MCR

Minimum cell rate allowed. The PCR and the MCR define the allowable cell rate (ACR) range. The MCR is the rate at which the source is always allowed to send. The MCR includes bandwidth occupied by both data cells and the inrate RM cells. Values range from 10-10000 cps.

PCR

Peak cell rate allowed. The PCR and the MCR define the allowable cell rate (ACR) range. Values range from 10-10000. The PCR includes bandwidth occupied by both data cells and the in-rate RM cps.

ICR

Initial cell rate is the rate to which a source should send initially and after an idle period. Values range from 10-10000 cps.


Related Commands

cnfchanstdabr, dspchanstdabr, cnfchanabrparams, addcon, dspchan

Attributes

Log: yes

State: Active

Privilege: any


Example 1-81 Parameters for cnfchanabrrates

NODENAME.1.29.FRSM.a > cnfchanabrrates

Syntax : cnfchanabrrates "Port.DLCI/CHAN_NUM mcr pcr icr "
         Port.Dlci -- Port.Dlci identifying a connection
         MCR -- Valid values range from 10 to 10000 in cells/sec
         PCR -- Valid values range from 10 to 10000 in cells/sec
         ICR -- Valid values range from 10 to 10000 in cells/sec


cnfchaneir

Configure Channel EIR

moduleUse the cnfchaneir command to configure the Frame Relay policing parameter excess information rate (EIR), which is the second bucket leak rate for a channel. No messages appear on the screen unless an error occurs.

Available

Release 1.1.21 and higher

Card(s) on Which the Command Executes

FRSM-8T1/E1, FRSM-VHS, FRSM-HS1

Syntax for FRSM-8T1/E1, FRSM-VHS

cnfchaneir <chan_num> <zerocireir>

Syntax Description

chan_num

Specifies the channel for which you are modifying the policing parameter. Values are:

FRSM-8T1/E = 16-1015

FRSM-2CT3 = 16-4015

FRSM-2T3/E3 and FRSM-HS2 = 16-2015

FRSM-HS1 = 16-1015

zerocireir

Specifies the excess information rate for 0 CIR cases. Values are:

FRSM-8T1 = 0-1536000 bps

FRSM-8E1 = 0-2048000 bps

FRSM-2CT3 = 0-1536000 bps

FRSM-2T3 = 0-44210000 bps

FSM-2E3 = 0-34010000 bps

FRSM-HS2 = 0-51840000 bps

FRSM-HS1 = 0-819200 bps


Related Commands

dspchan

Attributes

Log: Yes

State: Active

Privilege: 1-2


cnfchancacoff

Configure Channel CAC Off

Use the cnfchancacoff command to turn off the connection admission control (CAC) function for a channel.

Card(s) on Which This Command Executes

FRSM

Syntax

cnfchancacoff <chan_num>

Syntax Description

chan_num

Channel number, in the range appropriate for the interface type.

8T1/E1 range = 16-1015

HS1/B range = 16-1015

T3/E3/HS2 range = 16-2015

2CT3 range = 16-4015


Related Commands

None

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-82 On current FRSM in slot 27, change configuration for channel 16 to turn off connection admission control (CAC) function

spirit.1.27.FRSM.a > cnfchancacoff 16
spirit.1.27.FRSM.a > 

cnfchanegressq

Configure Channel Egress Queue

Use the cnfchanegressq command to configure the egress queue for a specified channel.

Card(s) on Which This Command Executes

FRSM

Syntax

cnfchanegressq <ChanNum> <QSel> <QDepth> <QDEThresh> <QECNThresh>

Syntax Description

ChanNum

Channel number, in the range appropriate for the interface type.

8T1/E1 range = 16-1015

T3/E3/HS2 range = 16-2015

2CT3 range = 16-4015

QSel

Egress queue select.

1 = High-priority queue, usually used for constant bit rate (CBR) connections.

2 = Low-priority queue (default).

3 = Not used. This option only for the FRSM-T3/E3/HS2 and FRSM-2CT3 service modules. For these service modules, the queue to which the channel gets mapped is determined by the channel service type.

QDepth

Egress queue depth, in the range 1-65535 bytes. This setting is the maximum allowable depth for the queue before it starts dropping cells.

Default = 65535 bytes

QDEThresh

Egress queue DE Threshold, in the range 1-65535 bytes. This setting is the maximum depth for the queue before the cells are tagged as discard eligible (DE). Default = 32767 bytes

QECNThresh

Egress queue ECN Threshold, in the range 1-65535 bytes. This setting is the maximum depth for the queue before initiating flow control.

Default = 65535 bytes


Related Commands

cnfchaningressq

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-83 On current FRSM in slot 27, change configuration of egress queue for channel 16 to set the priority to high, the maximum queue depth to 65535, the Discard Eligible threshold to 32767, and the ECN threshold to 65535

spirit.1.27.FRSM.a > cnfchanegressq 16 1 65535 32767 65535
spirit.1.27.FRSM.a > 

cnfchanfst

Configure Channel ForeSight

Use the cnfchanfst command to configure ForeSight parameters for a Frame Relay or ATM channel.

Card(s) on Which This Command Executes

FRSM, AUSM

Syntax: FRSM

cnfchanfst <chan_num> <fst_enable> <mir> <pir> <qir>

Syntax Description

chan_num

Channel number, in the range appropriate for the FRSM card type.

8T1/E1 range = 16-1015

T3/E3/HS2 range = 16-2015

2CT3 range = 16-4015

fst_enable

ForeSight, either enabled or disabled.

1 = enable

2 = disable

mir

Minimum information rate, as appropriate for the FRSM card type.

8T1/E1 the range = 10-8000 cps.

T3/E3/HS2/2CT3 range = 10-400000 in cps.

Default = 1000

pir

Peak information rate, as appropriate for the FRSM card type.

8T1/E1 range = 10-8000 in cell/sec.

T3/E3/HS2/2CT3, the range is 10-400000 in cps.

Default = 1000

qir

Quiescent information rate, as appropriate for the FRSM card type.

8T1/E1 range = 0-8000 cps.

T3/E3/HS2/2CT3 range = 10-400000 cps.

Default = 1000


Syntax: AUSM

cnfchanfst <port.VPI.VCI | channel number> <enable | disable> <fgcra_enable> <ibs> <pcr> <mcr> <icr>

Syntax Description

port.VPI.VCI

Connection identifier, in the format port.VPI.VCI.

Port range = 1-N, as appropriate for the physical installation

VPI range = 1-4095

VPI range = 1-65535

channel number

Channel number, in the range 16-1015.

enable | disable

Value to enable or disable ForeSight:

1 = disable

2 = enable

fgcra_enable

Value to enable or disable FGCRA for the specified channel.

1 = disable

2 = enable

ibs

Initial burst size, in the range 0-5000 cells.

pcr

Peak cell rate, in the range 10-38328 cps.

10-PortRate (T1-3622, E1-4528, clearE1-4830)

IMA, T1-3591, E1-4490, clrE1-4789

Note that the IMA port's speed is variable and depends on the number of links in the port. Multiply the rate by the number of links.

mcr

Minimum cell rate, in the range 10-38328 cells per second.

0-PortRate(T1-3622, E1-4528, clearE1-4830)

For IMA, T1-3591, E1-4490, clrE1-4789

Note that the IMA port's speed is variable and depends on the number of links in the port. Multiply the rate by the number of links.

icr

Initial cell rate, in the range 10-38328 cells per second.

0-PortRate (T1-3622, E1-4528, clearE1-4830)

For IMA, T1-3591, E1-4490, clrE1-4789

Note that the IMA port's speed is variable and depends on the number of links in the port. Multiply the rate by the number of links.


Related Commands

dspchan

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-84 On current FRSM in slot 27, change configuration of the ForeSight for channel 16 to enable ForeSight, to set the minimum information rate to 1000 cells per second, the peak information rate to 1000 cells per second, and the quiescent information rate to 1000 cells per second

spirit.1.27.FRSM.a > cnfchanfst 16 1 1000 1000 1000
spirit.1.27.FRSM.a >
 

A system response does not occur unless an error is detected.

Example 1-85 On current AUSM in slot 12, change the configuration using the port.VPI.VCI argument

s1.1.12.AUSM8.a > cnfchanfst 2.1.5 2 1 2000 4000 2000 2000
s1.1.12.AUSM8.a >

Example 1-86 On current AUSM in slot 12, change the configuration using the channel number argument

s1.1.12.AUSM8.a > cnfchanfst 31 2 1 2000 4000 2000 2000
s1.1.12.AUSM8.a >


Note This command is valid only for ABR-type channels.


cnfchaningressq

Configure Channel Ingress Queue

Use the cnfchaningressq command to configure the ingress queue for a specified channel.

Card(s) on Which This Command Executes

FRSM

Syntax

cnfchaningressq <ChanNum> <QSel> <QDepth> <QDEThresh> <QECNThresh>

Syntax Description

ChanNum

Channel number, in the range appropriate for the FRSM card type.

8T1/E1 range = 16-1015

HS1/B range = 16-1015

T3/E3/HS2 range = 16-2015

2CT3 range = 16-4015

QSel

FRSM-8T1/E1 only.

Egress queue select.

1 = High-priority queue, usually used for constant bit rate (CBR) connections.

2 = Low-priority queue (default).

3 = Not used. This option only for the FRSM-T3/E3/HS2 and FRSM-2CT3 service modules. For these service modules, the queue to which the channel gets mapped is determined by the channel service type.

QDepth

Ingress queue depth, in the range 1-65535 bytes. This setting is the maximum depth for the queue before it starts dropping cells.

Default = 65535 bytes

QDEThresh

Ingress queue DE Threshold, in the range 1-65535 bytes. This setting is the maximum depth for the queue before the cells are tagged as discard eligible (DE).

Default = 32767 bytes

QECNThresh

Ingress queue ECN Threshold, in the range 1-65535 bytes. This setting is the maximum depth for the queue before initiating flow control.

Default value = 65535 bytes


Related Commands

cnfchanegressq

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-87 On current FRSM in slot 27, change configuration of the egress queue for channel 16 to set the priority to high, set the maximum queue depth to 65535, the Discard Eligible threshold to 32767, and the ECN threshold to 65535

spirit.1.27.FRSM.a > cnfchaningressq 16 1 65535 32767 65535
spirit.1.27.FRSM.a > 

cnfchanmap

Configure Channel Map

Use the cnfchanmap command to configure interworking field mapping for a specified channel.

Card(s) on Which This Command Executes

FRSM

Syntax

cnfchanmap <chan_num> <chanType> <FECN/EFCI> <DE to CLP> <CLP to DE>

Syntax Description

chan_num

Channel number, in the range appropriate for the FRSM card type.

8T1/E1 range = 16-1015

HS1/B range = 16-1015

T3/E3/HS2 range = 16-2015

2CT3 range = 16-4015

chanType

Channel type.

1 = network interworking

2 = service interworking in transparent mode

3 = service interworking in translation mode

4 = FUNI

5 = frame forwarding

FECN/EFCI

Mapping between FECN and EFCI.

1 = map EFCI (this option valid only for service interworking)

2 = make EFCI 0

DE to CLP

DE to CLP mapping.

1 = map DE to CLP

2 = make CLP 0

3 = make CLP 1

CLP to DE

CLP to DE mapping.

1 = map CLP to DE

2 = make DE 0

3 = make DE 1

4 = ignore CLP (this option valid only for network interworking)


Related Commands

dspchanmap

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-88 On current FRSM in slot 27, change configuration of the interworking channel mapping for channel 16 to set the channel type to network interworking, to set EFCI equal to 0, the DE to CLP mapping to map DE to CLP, and the CLP to DE mapping to map CLP to DE

spirit.1.27.FRSM.a > cnfchanmap 16 1 1 1
spirit.1.27.FRSM.a > 

cnfchanpol

Configure Channel Policing

Use the cnfchanpol command to configure the Frame Relay policing parameters for a channel. No messages appear on screen unless an error occurs.

Card(s) on Which This Command Executes

FRSM

Syntax

cnfchanpol <chan_num> <cir> <bc> <be> <ibs> <detag> <egrat>

Syntax Description

chan_num

Channel number, in the range appropriate for the FRSM card type.

8T1/E1 range = 16-1015

HS1/B range = 16-1025

T3/E3/HS2 range = 16-2015

2CT3 range = 16-4015

cir

Committed information rate, in the range appropriate for the interface.

T1 range = 0-1536000 bps

E1 range = 0-2048000 bps

T3 range = 0-44210000 bps

E3 range = 0-34010000 bps

HSSI range = 0-51840000 bps

Default = 2400 bits per second (bps)

Note that for the FRSM-2CT3 service module, the peak value for permissible CIR is 1536000 bits per second.

bc

Burst committed rate, in the range appropriate for the FRSM card type.

FRSM-8T1/E1 range = 0-65535 bytes

FRSM-T3/E3/HS2 range = 0-2097151 bytes

FRSM-2CT3 range = 0-2097151 bytes

Default = 5100 bytes


Note The burst committed value cannot be 0 when the committed information rate is not 0.
The burst committed value MUST be set to 0 when the committed information rate is set to 0.


be

Burst excess rate, in the range appropriate for the FRSM card type.

FRSM-8T1/E1 range = 0-65535 bytes

FRSM-T3/E3/HS2 range = 0-2097151 bytes

FRSM-2CT3 = 0-2097151 bytes

Default = 5100 bytes


Note The burst excess value cannot be 0 when the committed information rate is set to 0.


ibs

Initial burst size, in the range appropriate for the FRSM card type.

FRSM-8T1/E1 range = 0-65535 bytes

FRSM-T3/E3/HS2 range = 0-2097151 bytes

FRSM-2CT3 range = 0-2097151 bytes

Default =100 bytes


Note The initial burst size should be less than or equal to the value of the burst committed when the committed information rate is set to greater than 0.
When the committed information rate is set to 0, the initial burst size MUST be set to 0.


detag

Value to enable or disable ingress discard eligible (DE) tagging.

1 = enable

2 = disable (default)

egrat

Egress service rate, in the range appropriate for the interface.

T1 range = 0-1536000 bps

E1 range = 0-2048000 bps


Related Commands

dspchan

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-89 On current FRSM in slot 27, change the configuration of the ForeSight for channel 16 to enable ForeSight, to set the committed information rate to 100000 cells per second, the committed burst size to 65535 bytes, the burst excess to 65535 bytes, the initial burst size to 1000 bytes, and to enable discard eligible tagging

spirit.1.27.FRSM.a > cnfchanpol 16 1 100000 65535 65535 1000 1
spirit.1.27.FRSM.a > 

cnfchanq

Configure Channel Queue

Use the cnfchanq command configure queue parameters for a specified channel on the current PXM or AUSM.

Card(s) on Which This Command Executes

PXM, AUSM

Syntax: PXM

cnfchanq <LCN> <discard_option> <clp_thresh_high> <clp_thresh_low> <efci_thresh> <update_code> <max_cell_cnt>

Syntax Description

LCN

Channel number, in the range 16-4111.

discard_option

Discard option for hysteresis or frame discard.

1 =CLP hysteresis

2 = Frame discard

clp_thresh_high

CLP threshold high, in the range 1-491520 cells.

Once the high cell loss priority threshold is exceeded, cells can have a CLP bit set, making them discard eligible.

clp_thresh_low

CLP threshold low, in the range 1-491520 cells.

Once the low cell loss priority threshold is passed, cells will no longer have the CLP bit set, making them discard eligible.

efci_thresh

EFCI threshold, in the range 1-491520 cells.

An explicit forward congestion indicator (EFCI) is sent to the sending node when the threshold is exceeded.

update_code

Congestion update.

1 = Don't update

2 = Set CI bit

3 = Set EFCI bit

4 = Clear EFCI

max_cell_cnt

Maximum cell count, in the range 0-512000 cells.


Syntax: AUSM

cnfchanq <chan_num> <vc_q_depth> <clp_thresh_high> <clp_thresh_low> <efci_thresh>

Syntax Description

chan_num

Channel number, in the range 16-1015.

vc_q_depth

Ingress queue depth, in the range 0-16000 cells.

clp_thresh_high

CLP threshold high, in the range 1-16000 cells.

Once the high cell loss priority threshold is exceeded, cells can have a CLP bit set, making them discard eligible.

clp_thresh_low

CLP threshold low, in the range 1-16000 cells.

Once the low cell loss priority threshold is exceeded, cells will no longer have the CLP bit set, making them discard eligible.

efci_thresh

EFCI threshold, in the range 1-16000 cells.

An explicit forward congestion indicator (EFCI) is sent to the sending node when the threshold is exceeded.


Related Commands

dspchan

Attributes

Log: Yes

State: Active

Privilege: 1-2 on AUSM, Any on PXM


Example 1-90 On current AUSM in slot 1, change the configuration of the channel queue for channel 16 to set the ingress queue depth to 16000, the CLP high threshold to 16000, the CLP Low threshold to 10000, and the EFCI threshold to 12000

spirit.1.1.AUSM.a > cnfchanq 16 16000 16000 10000 12000
spirit.1.1.AUSM.a > 

cnfchansrvrate

Configure Channel Service Rate

Use the cnfchansrvrate command to provision the service rate of a channel independent of the CIR rate of the connection. This feature separates the policing parameters (CIR, BC, BE, IBS) from the service rate, providing you with more traffic management control over the connection.

Card(s) on Which This Command Executes

FRSM 2T3/E3, FRSM HS2, FRSM-8, FRSM HS1

Syntax

cnfchansrvrate <chan_num> <srvord> <srvrate>

Syntax Description

chan_num

Channel number, in the range:

FRSM-8T1/E1, FRSM-HS1, 16-1015

FRSM-HS2, 2T3, 2E3, 16-2015

FRSM-2CT3, 16-4015

srvovrd

Channel service rate override programming option.

1 = enable

2 = disable

srvrate

The actual channel service rate to be provisioned for the given channel (in cps).

FRSM-8T1/E1, FRSM-HS1, 10-10000 cps

FRSM-VHS = 10-198412


Related Commands

cnfchanfst

Attributes

Log: Yes

State: Any State

Privilege: Any


Example 1-91 Configure the SAR on current FRSM, service connection 16, at 4000 cells per second, even though the CIR for the connection may be set to 0

NODENAME.1.26.VHS2CT3.a > cnfchansrvrate 16 1 4000
NODENAME.1.26.VHS2CT3.a >

cnfchanstdabr

Configure Channel for Standard ABR

Use the cnfchanstdabr command to configure ABR parameters.

Unlike the Standard ABR implementation on the AUSM-8T1/E1, the FRSM-8T1/E1 supports only Terminating Standard ABR—source/destination behavior. While at least one control loop between source and destination end systems is required, you can choose to segment the control loop. Using this method, an intermediate switch can close the control loop and initiate a new control loop by behaving as both a destination and a new source. Source/destination behavior is useful when you need to reduce the length of individual control loops, or create separate control domains for administrative reasons.

For more information about configuring Standard ABR, including default ABR parameters, refer to the addcon command on page 32.

Card(s) on Which This Command Executes

FRSM-8T1/E

Syntax

cnfchanstdabr <Port:DLCI/CHAN_NUM> <mcr> <pcr> <icr> <rif > <rdf> <nrm> <trm> <tbe> <frtt> <adtf> <cdf>

Syntax Description

Port.VPI.VCI/Chan_Num

Connection identifier, in the format Port.DLCI or channel number.

mcr

Minimum cell rate allowed. The PCR and the MCR define the Allowable Cell Rate (ACR) range. The MCR is the rate at which the source is always allowed to send. The MCR shall include bandwidth occupied by both data cells and the inrate RM cells. Values range from 10-10000.

pcr

Peak cell rate allowed. The PCR and the MCR define the Allowable Cell Rate (ACR) range. Values range from 10-10000. The PCR shall include bandwidth occupied by both data cells and the inrate RM cells.

icr

Initial cell rate is the rate to which a source should send initially and after an idle period. Values range from 10-10000.

rif

Rate increase factor controls the amount by which the cell transmission rate may increase upon receipt of an RM cell. Values range from 1-32768.

rdf

Rate decrease factor controls the decrease in the cell transmission rate. RDF is a power of 2. Values range from 10-32768.

nrm

The inrate cell count is the maximum number of cells a source may send for each forward RM cell. Values range from 2-256 (in steps of power of 2.

trm

The maximum delay for FRM provides an upper bound on the time between forward RM cells for an active source.

Values range from 3-255 msec.

tbe

The transient buffer exposure is a negotiated number of cells that the network would like to limit the source to sending during startup periods, before the first RM cell returns. Values range from 0 to 16777215 cells.

 

The fixed round trip time is the sum of the fixed and propagation delays from the source to the furthest destination and back. Values range from 0 to 16700.

dtf

The ACR decrease time factor is the time permitted between sending RM-cells before the rate is decreased to ICR.

Values range from 10 to 10230 msec.

cdf

Cutoff decrease factor controls the decrease in ACR associated with CRM. Values range from 0 to 64, in steps of power of 2.


Related Commands

cnfchanabrrates, dspchanstdabr, cnfchanabrparams, addcon, dspchan

Attributes

Log: yes

State: Acive

Privilege: 1-2


Example 1-92 Parameters for cnfchanstdabr

NODENAME.1.29.FRSM.a > cnfchanstdabr

Syntax : cnfchanstdabr "Port.DLCI/CHAN_NUM mcr pcr icr rif rdf nrm trm tbe
frtt adtf cdf"
         Port.Dlci -- Port.Dlci identifying a connection
         MCR -- Valid values range from 10 to 10000 in cells/sec
         PCR -- Valid values range from 10 to 10000 in cells/sec
         ICR -- Valid values range from 10 to 10000 in cells/sec
         RIF -- Valid values range from 1 to 32768 (in steps of power of 2)
         RDF -- Valid values range from 1 to 32768 (in steps of power of 2)
         Nrm -- Valid values range from 2 to 256 (in steps of power of 2)
         Trm -- Valid values range from 3 to 255 in msec.
         TBE -- Valid values range from 0 to 16777215 in cells
         FRTT -- Valid values range from 0 to 16700 in msec.
         ADTF -- Valid values range from 10 to 10230 in msec.
         CDF -- Valid values range from 0 to 64 (in steps of power of 2)

cnfclklevel

Configure Clock Stratum Level

Use the cnclklevel command to select the Stratum level of the clock source.

In Release 1.1.31, the MGX 8800 series switch now supports Stratum-3 as well as Stratum-4 clocking. While the Stratum-4 clock circuits are present in the front card, the new PXM-UI-S3 backcards provide the clock circuits supporting Stratum-3 clocking. The default clock source is set to the Internal Oscillator. Consequently, an External/Inband/SM clock can be configured to be the primary/secondary clock driving the node.

Note the following limitations:

1. There are two physical ports on the PXM-UI-S3 backcard for providing the external clock. However, only "Ext Clk 1" is currently supported.

2. There are two physical LAN ports on the PXM-UI-S3 backcard. However, only "LAN port 1" is currently supported.

Card(s) on Which This Command Executes

PXM

Syntax

cnfclklevel <level>

Syntax Description

level

Specify one of the following:

4 = Stratum-4

3 = Stratum-3


Related Commands

cnfclksrc, cnfextclk, dspclkinfo, dspclrsrc, dspcurclk

Attributes

Log: Yes

State: Active

Privilege: 3


Example 1-93 <Get an example caption for Configure Standard ABR on a channel. >

<Get an example>

Example 1-94 Display the clocking information, than configure clock leve Stratum 4 on connection 1.1.8.

golden1.1.8.PXM.a > dspclkinfo

 ****** Clock HW registers ********
SEL_T1 = t1      SEL100 = ON     SEL120 = ON     SEL75 = ON
NOEXTCLK = ON

 priMuxClockSource = INTERNAL_OSC
 prevPriMuxClockSource = none
 primaryInbandClockSourceLineNum = 0
 secMuxClockSource = INTERNAL_OSC
 prevSecMuxClockSource = INTERNAL_OSC
 secondaryInbandClockSourceLineNumber = 0
 currentClockSetReq = primary
 currentClockHwStat = secondary
 StratumLevel  = STRATUM3
 PreviousClockHwStat = none
 extClockPresent = No
 extClkConnectorType = RJ45
 extClkSrcImpedance = 100 Ohms
 Internal Clock Status=255, Primary Clock Status=0

                 Secondary Clock Status=0, Last inband Clock State=0
 last Inband Clock state= 0, Last External Clock Present = 1

golden1.1.8.PXM.a > cnfclklevel 4
Set STRATUM4 clk ..

cnfclksrc

Configure Clock Source

Use the cnfclksrc command to configure an interface as a clock source. Available clock sources are shown in Table 1-14. Any combination of clock sources are configurable in any order (primary or secondary). For example, you can configure an external clock source as the primary clock source and a line as the secondary clock source. If the primary and secondary clock sources fail, the internal oscillator becomes the source.

Before using the cnfclksrc command, the PXM1 broadband interfaces and the service module lines must be configured; therefore, you would first need to run the addln command, then the addport command. Configure only one clock source each time you execute cnfclksrc, and run the command from the active PXM1.

Stratum Level 3 (S3) clocking is supported in software Release 1.1.31 and higher. This feature provides for the new Stratum-3 clocking level supported by the PXM-UI-S3 back card. Note that although there are two external clock ports available in the PXM-UI-S3 back card, only one external clock source is configurable.

Table 1-14 Clock Sources

Clock Source
Description

Internal clock

Comes from an oscillator on the PXM1. It is the default source when the switch first comes up and remains so until you specify a different clock source.

Inband clock

Originates on a BPX 8600 series node or another vendor's switch and comes through the trunk on the PXM1 uplink card.

External clock

Comes from an external timing source and arrives at the T1 or E1 clock connector on the PXM UI. Frequently, the external source is a highly reliable, dedicated device that can provide a Stratum 2 or Stratum 3 clock. (As the subsequent configuration steps show, an additional step is necessary for an external clock source.)

Line on a service module or PXM1 UNI port

The PXM UNI line source is available on a stand-alone node only. A line must be active before you can specify it as a clock source.


Card(s) on Which This Command Executes

PXM, FRSM, CESM. AUSM

Syntax: PXM, FRSM, CESM, AUSM

cnfclksrc <slot.port> <clktyp>

Syntax Description

slot.port

For the PXM1:

Slot is 7, regardless of where the active PXM1 resides.

Port range = 1-N, as appropriate for the physical installation.

For the FRSM, CESM, AUSM:

Slot and port number.

Slot = 1-6, or 9-14, or 17-22, or 25-30.

Port range = 1-N, as appropriate for the physical installation.

For the trunk to a BPX 8600 series or other backbone node-sourced clock:

Port is always 1.

For the external clock:

Port is always 35.

For the UNI line (stand-alone only):

Port depends upon the number of lines on the back card.

For a service module providing the clock source:

Slot is the slot number of the card.

Port is the number of the line that provides the clock.

If you're using an external clock source:

Use the cnfextclk command to select the T1 or E1 line and the impedance of the line. The command syntax is

cnfextclk <ClockType> <Impedance>

where:

<ClockType> 1 = T1 source, 2 = E1 source

<Impedance> is one of the following:

T1 source: 1 = 75 ohms

E1 source: 2 = 100 ohms, 3 = 120 ohms


Note For Stratum 3 clocking, "cnfextclk" takes only one argument, namely cnfextclk <ClockType>. The <impedance> value is automatically set.


clktyp

Value to set the clock type to be sourced on the specified interface.

p = primary

s = secondary

n = null: use only for removing clock configuration that currently applies to the specified slot.port


Related Commands

dspclksrc, dspclkinfo, cnfextclk

Attributes

Log: Yes

State: Active

Privilege: 1


Example 1-95 Configure clock source on connection 7.1.

golden1.1.8.PXM.a > cnfclksrc 7.1 P

golden1.1.8.PXM.a > s3: Switching to clock : 1, (1=P, 2=S, 3=I)

golden1.1.8.PXM.a > dspclkinfo

 ****** Clock HW registers ********
SEL_T1 = t1      SEL100 = ON     SEL120 = ON     SEL75 = ON
NOEXTCLK = ON

 priMuxClockSource = INBAND_CLK1
 prevPriMuxClockSource = INTERNAL_OSC
 primaryInbandClockSourceLineNum = 1
 secMuxClockSource = INTERNAL_OSC
 prevSecMuxClockSource = none
 secondaryInbandClockSourceLineNumber = 1
 currentClockSetReq = primary
 currentClockHwStat = primary
 StratumLevel  = STRATUM3
 PreviousClockHwStat = primary
 extClockPresent = No
 extClkConnectorType = RJ45
extClkSrcImpedance = 100 Ohms
 Internal Clock Status=255, Primary Clock Status=0

                 Secondary Clock Status=0, Last inband Clock State=0
 last Inband Clock state= 0, Last External Clock Present = 1

cnfcon

Configure Connection

Use the cnfcon command to configure connectivity parameters on the PXM, AUSM, FRSM, or CESM. The applicable parameters were previously specified by the addcon command.

Card(s) on Which This Command Executes

PXM, FRSM, AUSM, CESM

Syntax: PXM

cnfcon <conn_ID> <route_priority> <max_cost> <restrict_trunk_type> [CAC]

Syntax Description

conn_ID

Connection identifier, in the format PortNo.VPI.VCI.

route_priority

Routing priority number, in the range 1-15.

max_cost

Maximum cost for the connection, in the range 1-255.

restrict_trunk_type

Restriction on the trunk.

1 = no restriction

2 = terrestrial trunk

3 = satellite trunk

CAC

(optional) Connection admission control (CAC), either enabled or disabled.

1 = enable

2 = disable


Syntax: FRSM, AUSM

cnfcon <Port.Dlci> <chan_type> <cir> [CAC]

Syntax Description

Port.Dlci

Port number and DLCI.

chan_type

Channel type.

1 = NIW

2 = SIW- transparent

3 = SIW- translation

4 = FUNI

5 = Frame Forward

cir

Committed information rate (CIR), in the range appropriate for the interface.

T1 range = 0-1536000

E1 range = 0-2048000

X.21 range = 0-10000000 bps

HSSI range = 0-20000000 bps

CAC

(optional) Connection admission control (CAC), either enabled or disabled.

1 = enable

2 = disable


Syntax: CESM

cnfcon <port_num> <CDVT> <CLIP> <bufsize> <clockmode> <IdleSuppEnable> <ForceSuppression>

Syntax Description

port_num

Unique port number.

CDVT

Cell delay variation tolerance (CDVT), as appropriate for the interface.

T1 range = 125-24000 microseconds

E1 range = 125-26000 microseconds

CLIP

Cell loss integration period (CLIP), in the range 1000-65535 milliseconds.

bufsize

Egress bufsize = 0 to autocompute.

Min value depends on CDVT configured.

Min BufSize = greater (CDVT in frames * 2) * N, (CDVT + frames in two cells) * N

Max for T1 UDT and E1 UDT: 16224 bytes

Max for T1 SDT: 384 * N bytes

Max for E1 SDT: 417 * N bytes, where N is the number of timeslots assigned in Nx64 connection, and N = 32 for T1/E1 UDT

clockmode

Clock mode.

1 = synchronous

2 = SRTS

3 = adaptive

IdleSuppEnable

Idle suppression, either enabled or disabled.

1 = disable

2 = enable

ForceSuppression

External idle suppression, either enabled or disabled.

1 = disable

2 = enable


Related Commands

addcon, dspcon, dspcons, delcon

Attributes

Log: Yes

State: Active

Privilege: Any


Example 1-96 Configures connection on port 1 with a VCI of 2 and a VPI of 5 to use routing priority 15, a maximum routing cost of 255, to not use satellite trunks, and to enable connection admission control

spirit01.1.7.PXM.a > cnfcon 1.2.5 15 255 3 2
spirit01.1.7.PXM.a >

cnfconabrrates

Configure Connection ABR Rates

Use the cnfconabrrates command to configure the rate parameters of the Standard ABR channel. This becomes useful, especially for a transparent (switch-behaving) ABR connection.

Card(s) on Which This Command Executes

AUSM-8T1E1

Syntax

cnfconabrrates <Port.VPI.VCI/Channel Number> <MCR> <PCR> <ICR>

Syntax Description

Port.VPI.VCI/
Channel Number

Connection identifier, in the format PortNo.VPI.VCI or channel number.

mcr

Minimum cell rate allowed. The PCR and the MCR define the allowable cell rate (ACR) range. The MCR is the rate at which the source is always allowed to send. The MCR shall include bandwidth occupied by both data cells and the inrate RM cells. Values range from 10-38328.

pcr

Peak cell rate allowed. The PCR and the MCR define the allowable cell rate (ACR) range. Values range from 10-38328. The PCR shall include bandwidth occupied by both data cells and the inrate RM cells.

icr

Initial cell rate is the rate to which a source should send initially and after an idle period. Values range from 10-38238.


Related Commands

cnfconstdabr, dspconstdabr, cnfconabrparms, addcon, dspcon

Attributes

Log: <need>

State: <need>

Privilege: <need>


Example 1-97 Configure the ABR parameters on connection 27

pxmsjc.1.11.AUSMB8.a > cnfconabrrates

         Port.VPI.VCI -- A unique Port.VPI.VCI identifying a connection
         Minimum Cell Rate -- Valid values range from 10 to 38328
         Peak Cell Rate -- Valid values range from 10 to 38328
         Initial Cell Rate -- Valid values range from 10 to 38328

pxmsjc.1.11.AUSMB8.a > cnfconabrrates 27 20 1600 500

Example 1-98 Display the ABR parameter changes on connection 27

pxmsjc.1.11.AUSMB8.a > dspconstdabr 27

     ChannelNumber               :  27
     Minimum Cell Rate           :  20 Cells per second
     Peak Cell Rate              :  1600 Cells per second
     Initial Cell rate           :  500 Cells per second
     Rate Increase Factor        :  128
     Rate Decrease Factor        :  16
     Nrm -- Inrate Cell Count    :  64
     Trm -- Time limit for Frm   :  255 milliseconds
     Transient Buffer Exposure   :  16777215 Cells
     Fixed Round Trip Time       :  0 milliseconds
     ACR Decrease Time Factor    :  500 milliseconds
     Cutoff Decrease Factor      :  16
     ABRType                     :  Source Destination behavior

cnfconabrparams

Configure Connection ABR Parameters

Use the cnfconabrparams command configure all the parameters of the Standard ABR connection except the rate parameters (use cnfconabrrates command to configure rates). Use the "Type of ABR Service" parameter to toggle between "Terminating Standard ABR" or "Transparent ABR."

For more information about configuring Standard ABR, including default ABR parameters, refer to the addcon command on page 32.

Card(s) on Which This Command Executes

AUSM-8T1E1

Syntax

cnfconabrparams <Port.VPI.VCI/Channel Number> <ABRType> <RIF><RDF> <NRM> <TRM> <TBE> <FRTT> <ADTF> <CDF>

Syntax Description

Port.VPI.VCI/
Channel Number

Connection identifier, in the format PortNo.VPI.VCI or channel number.

ABRType

One of the following types of ABR serviceL

1 = Terminating ABR or Switch Behavior

2 = Transparent ABR or Source Destination Behavior

RIF

This controls the amount by which the cell transmission rate may increase upon receipt of an RM cell. The additive increase rate AIR=PCR*RIF. RIF is a power of 2, ranging from 1/32768 to 1. Values range from 10-32768.

RDF

Rate decrease factor controls the decrease in the cell transmission rate. RDF is a power of 2 from 1/32768 to 1.Values range from 10-32768.

NRM

The inrate cell count is the maximum number of cells a source may send for each forward RM cell. Values range from 2-256.

TRM

the maximum delay for FRM provides an upper bound on the time between forward RM cells for an active source.

Values range from 3-255 msec, standard deviation.

TBE

Transient buffer exposure is the negotiated number of cells that the network would like to limit the source to sending during startup periods, before the first RM cell returns. Values range from 0 to 16777215.

FRTT

The fixed round trip time is the sum of the fixed and propagation delays from the source to the furthest destination and back. Values range from 0 to 16700.

ADTF

TheACR decrease time factor is the time permitted between sending RM-cells before the rate is decreased to ICR.

Values range from 10 to 10230.

CDF

The cutoff decrease factor controls the decrease in ACR associated with CRM. Values range from 0 to 64.


Related Commands

cnfconstdabr, dspconstdabr, cnfconabrrates, addcon, dspcon

Attributes

Log: No

State:Any

Privilege: 1-2


Example 1-99 Configure the ABR parameters on connection 27

pxmsjc.1.11.AUSMB8.a > cnfconabrparams

Syntax : cnfconabrparams "Port.VPI.VCI/CHAN_NUM ABRType rif rdf
                nrm trm tbe frtt adtf cdf "
         Port.VPI.VCI -- A unique Port.VPI.VCI identifying a connection
         Type of ABR Service -- Valid values are 1 (Switch Behaviour) and 2 (Src
Dest Behaviour)
         Rate Increase Factor -- Valid values range from 1 to 32768
         Rate Decrease Factor -- Valid values range from 1 to 32768
         Inrate Cell Count -- Valid values range from 2 to 256
         Max delay for FRM -- Valid values range from 3 to 255
         Transient Buf Exposure -- Valid values range from 0 to 16777215
         Fixed Round Trip Time -- Valid values range from 0 to 16700
         ACR Decrease Time Factor -- Valid values range from 10 to 10230
         Cutoff Decrease Factor -- Valid values range from 0 to 64

pxmsjc.1.11.AUSMB8.a > cnfconabrparams 27 2 64 16 64 200 16777215 100 500 16

Example 1-100 Display the ABR parameter changes on connection 27

pxmsjc.1.11.AUSMB8.a > dspconstdabr 27

     ChannelNumber               :  27
     Minimum Cell Rate           :  20 Cells per second
     Peak Cell Rate              :  1600 Cells per second
     Initial Cell rate           :  500 Cells per second
     Rate Increase Factor        :  64
     Rate Decrease Factor        :  16
     Nrm -- Inrate Cell Count    :  64
     Trm -- Time limit for Frm   :  200 milliseconds
     Transient Buffer Exposure   :  16777215 Cells
     Fixed Round Trip Time       :  100 milliseconds
     ACR Decrease Time Factor    :  500 milliseconds
     Cutoff Decrease Factor      :  16
     ABRType                     :  Source Destination behavior
pxmsjc.1.11.AUSMB8.a >

cnfconstdabr

Configure Connection for Standard ABR

Use the cnfconstabr command to configure ABR parameters.

To toggle between Terminating Standard ABR (Source) behavior and Transparent (Switch) behavior, set the parameter "Type of ABR Service" to either "2" for Terminating Standard ABR, or "1" for Transparent ABR.

For more information about configuring Standard ABR, including default ABR parameters, refer to the addcon command on page 32.

Card(s) on Which This Command Executes

AUSM 8T1/E1

Syntax

cnfconstdabr <Port.VPI.VCI/CHAN_NUM> <ABRType> <mcr> <pcr> <icr> <rif > <rdf> <nrm> <trm> <tbe> <frtt> <adtf> <cdf>

Syntax Description

Port.VPI.VCI/
Channel Number

Connection identifier, in the format PortNo.VPI.VCI or channel number.

ABRType

Type of ABR service.

1 = Terminating ABR or Switch Behavior

2 = Transparent ABR or Source Destination Behavior

mcr

Minimum cell rate allowed. The PCR and the MCR define the allowable cell rate (ACR) range. The MCR is the rate at which the source is always allowed to send. The MCR shall include bandwidth occupied by both data cells and the inrate RM cells. Values range from 10-38328 cps.

pcr

Peak cell rate allowed. The PCR and the MCR define the allowable cell rate (ACR) range. The PCR shall include bandwidth occupied by both data cells and the inrate RM cells. Values range from 10-38328 cps.

icr

Initial cell rate is the rate to which a source should send initially and after an idle period. Values range from 10-38238 cps.

rif

Rate increase factor controls the amount by which the cell transmission rate may increase upon receipt of an RM cell. The additive increase rate AIR=PCR*RIF. RIF is a power of 2, ranging from 1/32768 to 1. Values range from 10-32768.

rdf

Rate decrease factor controls the decrease in the cell transmission rate. RDF is a power of 2 from 1/32768 to 1.Values range from 10-32768.

nrm

Inrate cell count is the maximum number of cells a source may send for each forward RM cell. Values range from 2-256.

trm

Maximum delay for FRM provides an upper bound on the time between forward RM cells for an active source.

Values range from 3-255 msec.

tbe

Transient buffer exposure is the negotiated number of cells that the network would like to limit the source to sending during startup periods, before the first RM cell returns. Values range from 0 to 16777215 cells.

frtt

Fixed round trip time is the sum of the fixed and propagation delays from the source to the furthest destination and back. Values range from 0 to 16700 msec.

adtf

The ACR decrease time factor permitted between the sending RM cells and before the rate is decreased to ICR.

Values range from 10 to 10230.

cdf

Cutoff decrease factor controls the decrease in ACR associated with CRM. Values range from 0 to 64.


Related Commands

cnfconabrparms, dspconstdabr, cnfconabrrates, addcon, dspcon

Attributes

Log: No

State: Any

Privilege: 1-2


Example 1-101 Configure the Standard ABR connection to emulate the source/destination or terminating behavior of the TM 4.0 specification

pxmsjc.1.11.AUSMB8.a > cnfconstdabr
         Port.VPI.VCI -- A unique Port.VPI.VCI identifying a connection
         Type of ABR Service -- Valid values are 1 (Switch Behaviour) and 2 (Src
Dest Behaviour)
         Minimum Cell Rate -- Valid values range from 10 to 38328
         Peak Cell Rate -- Valid values range from 10 to 38328
         Initial Cell Rate -- Valid values range from 10 to 38328
         Rate Increase Factor -- Valid values range from 1 to 32768
         Rate Decrease Factor -- Valid values range from 1 to 32768
         Inrate Cell Count -- Valid values range from 2 to 256
         Max delay for FRM -- Valid values range from 3 to 255
         Transient Buf Exposure -- Valid values range from 0 to 16777215
         Fixed Round Trip Time -- Valid values range from 0 to 16700
         ACR Decrease Time Factor -- Valid values range from 10 to 10230
         Cutoff Decrease Factor -- Valid values range from 0 to 64


pxmsjc.1.11.AUSMB8.a > cnfconstdabr 27 2 10 1500 100 128 16 64 255 16777215 0 500
16

Example 1-102 The dspconstdabr command issued against the connection configured above reflects the new parameter values

pxmsjc.1.11.AUSMB8.a > dspconstdabr 27

     ChannelNumber               :  27
     Minimum Cell Rate           :  10 Cells per second
     Peak Cell Rate              :  1500 Cells per second
     Initial Cell rate           :  100 Cells per second
     Rate Increase Factor        :  128
     Rate Decrease Factor        :  16
     Nrm -- Inrate Cell Count    :  64
     Trm -- Time limit for Frm   :  255 milliseconds
     Transient Buffer Exposure   :  16777215 Cells
     Fixed Round Trip Time       :  0 milliseconds
     ACR Decrease Time Factor    :  500 milliseconds
     Cutoff Decrease Factor      :  16
     ABRType                     :  Source Destination behavior

cnfdate

Configure Date

Use the cnfdate command to set the system date.

Card(s) on Which This Command Executes

PXM

Syntax

cnfdate <mm/dd/yyyy>

Syntax Description

mm/dd/yyyy

Month, day, year.

mm = month, in the range 01 through 12

dd = day, in the range 01-31

yyyy = year, in the 0000-9999


Related Commands

None

Attributes

Log: Yes

State: Active

Privilege: SuperUser


Example 1-103 Set date to be 03/29/2000

excel.1.3.PXM.a > cnfdate 03/29/2000
Date = 03/29/2000

excel.1.3.PXM.a > 

cnfdsx3bert

Configure DS3 BERT

Use the cnfdsx3bert command to specify a pattern for bit error rate testing (BERT) on the FRSM.

Card(s) on Which This Command Executes

FRSM 2T3E3, CESMT3

Syntax

cnfdsx3bert <test pattern>

Syntax Description

test pattern

DSX3 BERT pattern

1 = all ones

2 = all zeros

3 = alternating ones and zeroes

4 = double alternating ones and zeros

5 = 3 in 24

6 = 1 in 16

7 = 1 in 8

8 = 1 in 4

9 = D4 loop activate

10 = D4 loop deactivate

11 = 2**3-1

12 = 2**4-1

13 = 2**5-1

14 = 2**6-1

15 = 2**7-1

16 = FT1 LB activate

17 = FT1 LB deactivate

18 = 2**9-1

19 = 2**10-1

20 = 2**11-1

21 = 2**15-1

22 = 2**17-1

23 = 2**18-1

24 = 2**20-1

25 = QRSS

26 = 2**21-1

27 = 2**22-1

28 = 2**23-1

29 = 2**25-1

30 = 2**28-1

31 = 2**28-1

32 = 2**31-1

33 = 2**32-1


Related Commands

None

Attributes

Log: Yes

State: Active

Privilege: SuperUser


Example 1-104 Set double alternating ones-and-zeroes pattern for the BERT

popeye1.1.21.CESMT3.a > cnfdsx3bert 4

popeye1.1.21.CESMT3.a >

cnfegrservtype

Configure Egress Servicing Type

Use the cnfegrservtype command to change the egress port servicing algorithm. Egress port queue servicing type is a card-level option. You can choose either four-queue, weighted fair queuing (WFQ) algorithm with quality of service (QoS) guaranteed, or simple ratio-based, two-queue algorithm without quality of service.

Software Version

Command available with 1.1.20 and higher

Card(s) on Which This Command Executes

FRSM-VHS (2CT3/2T3/2E3/HS2)

Syntax

cnfegrservtype <servicing type>

Syntax Description

servicing type

A value representing one of the following servicing types:

87 = WFQ algorithm with four queues.

99 = Ratio-based algorithm with two queues.


Related Commands

dspegrservtype

Attributes

Log: Yes

State: Active

Privilege: SuperUser


Example 1-105 Configure egress service type to queue ratio

raviraj.1.10.VHS2CT3.a > cnfegrservtype "99"
The card will be reset, Do you want to proceed (Yes/No)? Yes

Err: card reset/removed/failed on slot 10
slot 2 (cardInx 3) is present, insertion msg from PXM 7

cnfextclk

Configure External Clocking

Use the cnfextclk command to configure external clock. The clock type and impedance value need to be specified with this command. For Stratum-3 clocking, the impedance is automatically detected by the hardware. Therefore, this parameter should not be set for Stratum-3 clocking. Card(s) on Which This Command Executes

PXM

Syntax

cnfextclk <ClockType> <Impedance>

Syntax Description

ClockType

Clock source on the line.

1 = T1

2 = E1

Impedance

Impedance for the line selected as the external clocking source.

1 = 75 ohms

2 = 100 ohms (default)

3 = 120 ohms

Stratum 3 = automatically detected by the hardware


Related Commands

None

Attributes

Log: Yes

State: Active

Privilege: 3


Example 1-106 Configure clock type

golden1.1.8.PXM.a > cnfextclkk

cnfextclk <ClockType>
        where <ClockType> = 1: T1  2: E1
ERR: command "cnfextclk" failed

golden1.1.8.PXM.a > cnfextclk 1

golden1.1.8.PXM.a > cnfextclk 2
golden1.1.8.PXM.a >

cnfenetgw

Configure Ethernet Gateway

Use the cnfenetgw command to establish the Ethernet gateway route permanently.

Software Version

Command available with 1.1.20 and higher

Card(s) on Which This Command Executes

PXM

Syntax

cnfenetgw <IPaddress>

Syntax Description

IPaddress

IP address for the default gateway; a subnet.


Related Commands

dspenetgw

Attributes

Log: No

State: Active

Privilege: SuperUser


Example 1-107 Configure gateway 172.29.37.1 and add necessary routes

excel.1.3.PXM.a > cnfenetgw 172.28.37.1
excel.1.3.PXM.a > 

cnffst

Configure ForeSight

Use the cnffst command to configure ForeSight parameters for the current card.

Card(s) on Which This Command Executes

FRSM, AUSM

Syntax

cnffst <rate_up> <rate_down> <rate-fast_down> <qir_time_out> <rtd_interval>

Syntax Description

rate_up

Rate up, in the range 1-100 percent. If free bandwidth is available, this setting is the rate at which ForeSight increases transmission (as a percentage of MIR).

rate_down

Rate down, in the range 1-100 percent. If free bandwidth becomes unavailable, this setting is the rate at which ForeSight decreases transmission (as a percentage of current rate).

rate-fast_down

Rate fast down, in the range 1-100 percent. If a cell is dropped or the TxQ is full, this setting is the rate at which ForeSight decreases transmission (as a percentage of current rate).

qir_time_out

QIR timeout period before resetting IR to QIR, in the range 1-255 seconds.

rtd_interval

Interval between round-trip delay measurement requests, in the range
1-255 seconds.


Related Commands

dspfst

Attributes

Log: Yes

State: Active

Privilege: 1-2


cnfif

Configure Broadband Interface

Use the cnfif command to modify parameters for an existing broadband interface on a PXM. System software does not allow you to conflict with existing configurations. You may need to reduce the bandwidth allocation or VPI/VCI range on one or more interfaces before you expand the resources for an interface. Refer to the upif command description for more information on resource partitioning.

Card(s) on Which This Command Executes

PXM

Syntax

cnfif <if_num> <pct_bw> <min_vpi> <max_vpi>

Syntax Description

if_num

Interface number of the logical interface, in the range 1-32.

pct_bw

Percentage of the line bandwidth to be allocated for the logical interface, in the range 0-100. This setting applies to both the ingress and egress.

min_vpi

Minimum virtual path identifier (VPI) value for UNI or NNI.

UNI range = 0-255

NNI range = 0-4095

UNI typically applies to a line connecting a stand-alone node to a workstation.

max_vpi

Maximum VPI value for UNI or NNI.

UNI range = 0-255

NNI range = 0-4095

UNI typically applies to a line connecting a stand-alone node to a workstation.


Related Commands

upif

Attributes

Log: No

State: Any State

Privilege: Any


Example 1-108 Configure broadband interface number 1 to use 10% of the line bandwidth for both ingress and egress, have a minimum virtual path interface (VPI) of 0, and a maximum virtual path interface (VPI) of 19

wilco.1.7.PXM.a > cnfif 1 10 0 19
wilco.1.7.PXM.a > 

Example 1-109 Confirm configuration for the broadband interface

wilco.1.7.PXM.a > dspif    
                   
 ifNum  Status  Line  ingrPctBw egrPctBw minVpi maxVpi
------------------------------------------------------
  1     Ena       1       10       10        0     19 

wilco.1.7.PXM.a > 

cnfifastrk

Configure Interface as Trunk

Use the cnfifastrk PAR command to configure a logical interface on the PXM to act as a feeder trunk. The application for this command is dependent upon the activation of the paid feature option of feeder capability on the MGX 8800 series switch node. Before configuring the interface as a feeder trunk, the option must be activated with the cnfswfunc command. Therefore, the default is rtrk for routing trunk. The routing trunk utilization applies to both a routing node and a stand-alone node.

Card(s) on Which This Command Executes

PXM

Syntax

cnfifastrk <slot.port> <ftrk | rtrk | vtrk>

Syntax Description

slot.port

Slot and port number.

slot = enter the value 7, or 15, or 31

port range = 1-N, as appropriate for the physical installation

<ftrk | rtrk | vtrk>

Trunk type.

ftrk = feeder trunk

rtrk = routing trunk (default)

vtrk = virtual trunk


Related Commands

uncnfifastrk

Attributes

Log: No

State: Active

Privilege: 2


Example 1-110 Configure line 1 on PXM in slot 7 as a feeder trunk

wilco.1.7.PXM.a > cnfifastrk 7.1 ftrk
wilco.1.7.PXM.a > 

cnfifip

Configure Interface Address

Use the cnfifip command to configure the interface address for LAN, SLIP, or ATM on the PXM. In addition, you can specify an interface to be up or down dynamically. No reboot is required to bring an interface up or down, and interfaces set to down are persistent across resets.

A shelf now can have one or two IP addresses for Ethernet. The shelf IP address set using the cnfifip command will always be the IP address of the active card.

The bootChange IP address is used for the standby card and backup boot if it is different from the shelf IP address. If the bootChange IP address is same as the shelf IP address, then the Ethernet interface on the standby card or in backup boot is left in the down state.

Software Version

New feature (up/down IP interface) available with 1.1.20 and higher

Card(s) on Which This Command Executes

PXM

Syntax

cnfifip <Interface> <IPaddr> [<NetMask> [BroadcastAddr]] InterfaceFlag

Syntax Description

Interface

Interface as Ethernet, SLIP, or ATM.

26 = Ethernet

28 = SLIP

37 = ATM

IPaddr

A 32-bit IP address in dotted decimal format.

NetMask

<n>.<n>.<n>.<n> where <n> = integer 0-255

If netmask "255.255.255.252" is used for the SLIP interface, the PXM will automatically add host route for its peer whenever the interface is turned ON.

BroadcastAddr

<n>.<n>.<n>.<n> where <n> = integer 0-255.

InterfaceFlag

Interface flag, either UP or DOWN.


Related Commands

dspifip

Attributes

Log: Yes

State: Active

Privilege: SuperUser


Example 1-111 Configure ATM interface and bring it up

wilco.1.7.PXM.a > cnfifip atm 192.9.200.1 255.255.255.128
wilco.1.7.PXM.a > 

A system response does not occur unless an error is detected. To confirm your configuration for the interface address, use the dspifip command.

Example 1-112 Configure ATM interface with the current information in the database

wilco.1.7.PXM.a > cnfifip atm up
wilco.1.7.PXM.a >

Example 1-113 Remove ATM interface and preserve the information in the database

wilco.1.7.PXM.a > cnfifip atm down
wilco.1.7.PXM.a >

cnfilmi

Configure ILMI

Use the cnfilmi command to configure the local management interface port on the PXM or AUSM. A system response does not occur unless an error is detected.

Card(s) on Which This Command Executes

PXM, AUSM

Syntax: PXM

cnfilmi <ifNum> <bbIfSigPortNum> <ilmiEnable> <sigProtocolType> <signallingVPI> <signallingVCI> <iLMITrap> <minTrapInterval> <keepAlive> <errorThresholdN491> <pollingIntervalT491> <eventThresholdN492> <minEnquiryIntervalT493> <addrRegEnable>

Syntax Description

ifNum

Interface number.

bbIfSigPortNum

Broadband interface signal port number, in the range 1-32.

ilmiEnable

ILMI, either enabled or disabled.

1 = disable

2 = enable

sigProtocolType

Signal protocol type.

1 = other

2 = no signalling

3 = ILMI

signallingVPI

Signalling virtual path identifier (VPI), in the range 0-4095.

signallingVCI

Signalling virtual channel identifier (VCC), in the range 0-4095.

iLMITrap

ILMI trap, either enabled or disabled.

1 = disable

2 = enable

minTrapInterval

Minimum trap interval, in the range 1-10 seconds.

keepAlive

Keep alive function, either enabled or disabled.

1 = disable

2 = enable

errorThresholdN491

Error threshold N491, in the range 1-10.

pollingIntervalT491

Polling interval T491, in the range 1-v12.

eventThresholdN492

Event threshold N492, in the range 1-10.

minEnquiryIntervalT493

Minimum enquiry interval, in the range 1-20.

addrRegEnable

Address registration, either enabled or disabled.

1 = disable

2 = enable


Syntax: AUSM

cnfilmi <port_num> <signal_type> <vpi> <vci> <scr> <trap_enable> <min_trap_int> <keep_alive>

Syntax Description

port_num

Port number, in the range 1-8.

signal_type

Signalling type.

1 = other

2 = no signalling

3 = ILMI

vpi

Virtual path identifier (VPI), in the range 0-259.

vci

Virtual circuit identifier (VCI), in the range 0-65535.

trap_enable

ILMI trap, either enabled or disabled.

1 = disable

2 = enable

min_trap_int

Minimum trap interval, in the range 1-10 seconds.

keep_alive

Keep alive polling, either enabled or disabled.

1 = disable

2 = enable


Related Commands

dspilmi, dspilmicnt

Attributes

Log: Yes

State: Active

Privilege: 1 (Cisco for PXM)


cnfimagrp

Configure IMA Group

Use the cnfimagrp command to configure delay and resilient links for inverse multiplexing ATM (IMA) parameters on the current AUSM card.

Card(s) on Which This Command Executes

AUSM

Syntax

cnfimagrp <grp> <max_diff_delay> <min_num_links>

Syntax Description

grp

IMA group number, in the range 1-8.

max_diff_delay

Maximum tolerable differential delay between the various links in the IMA group in the range appropriate for the SM type.

AUSM8-T1 = 0-275 milliseconds

AUSM8-E1 = 0-200 milliseconds

min_num_links

Number of resilient links in the inverse multiplexer. This setting is the number of links the system can lose from this IMA group without bringing it down.

Default = one less than the number of links in the selected group.


Related Commands

dspimagrp, dspimagrps, dspimagrpcnt

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-114 Configure AIMUX group 1 on the AUSM card in slot 17 to have a read/write pointer differential of 5, a link loss severity of 2, a maximum tolerable differential delay of 5, and 2 redundant links

flyers01.1.17.AUSM.a > cnfimagrp 1 -rwdiff 5 -severity 2 -maxdiff 3 -red 2
flyers01.1.17.AUSM.a > 

cnfln

Configure Line

Use the optional cnfln command to configure line characteristics after the line becomes active (see addln). Applicable cards are the core cards and service modules. For the PXM1 and optional SRM, a syntax switch or command delineator is necessary to identify the interface type as well as the parameters. (See syntax descriptions that follow.)


Note On the PXM1 CLI, all parameters for this command are optional and position-independent. Therefore, you can enter them in any order after the interface identifier. A parameter value is mandatory only if you type the delineator for that parameter.


Card(s) on Which This Command Executes

PXM, FRSM, AUSM, CESM, VISM


Note The cnfln command on the PXM supports a loopback parameter.


On all PXM interfaces, a loopback is available. The local loopback exists between the daughter card and the back card. The remote loopback exists between the CPE or switch and the PXM daughter card. With a remote loopback, the data originates on the CPE or external switch, arrives at the PXM daughter card, then returns to the remote equipment. (See Figure 1-5.)

Figure 1-5 Local and Remote Loopbacks on the PXM

DS3 Loopback

In software Release 1.1.31 and higher, the switch can be configured to perform DS3 loopback testing on the PXM-T3 back card. The installation and configuration manual for this switch contains complete procedures for the following tests:

Configure loopback on the entire DS3 line

Configure loopback on all DS1s in a DS3 line

Receive a loopback request; to verify that the loopback can be configured on the entire DS3 line

Configure DS3 for sending looped or normal data

Configure loopback on all DS1s in a DS3 line

Configure DS3 for sending looped or normal data

Configure DS3 to send Line loopback

Configure DS3 for sending loopback deactivation request

Configuring FEAC validation criteria to be FEACCodes4 Of5

Configuring FEAC validation criteria to be FEACCodes8Of10

Configure loopback on the entire DS3 line

Configure loopback on all DS1s in a DS3 line

Configuring Receive validation FEAC code

Configuring Transmit FEAC code

Configure DS3 for sending looped or normal data

Configure DS3 to send Line loopback

Configure DS3 for sending loopback deactivation request

Configuring Receive validation FEAC code

Configuring FEAC validation criteria to be FEACCodes4Of5

Syntax: PXM (SONET)

cnfln -sonet <LineNum> -slt <LineType> -lpb <LoopCmd> -smask <HCSmasking>
-sps <PayloadScramble> -sfs <FrameScramble>

Syntax Description

-sonet

Command delineator that precedes the LineNum entry.

LineNum

Line number in the format slot.line.

Slot number is 7 or 8

The line number is 1 for the OC-12 card or in the range 1-4 for the OC-3 card

-slt

Command delineator that precedes the LineType entry.

LineType

Line type:

1 = sonetSts3c

2 = sonetStm1

3 = sonetSts12c

4 = sonetStm4

-lpb

Command delineator that precedes the LoopCmd entry.

LoopCmd

Loopback mode of the SONET interface.

1 specifies no loopback. The purpose is to remove an existing loopback.

2 specifies that the near end loops back data from the remote end.

3 specifies that the near end loops back local data.

-smask

Command delineator that precedes the HCSmasking entry.

HCSmasking

HCS masking, either enabled or disabled.

1 = disable

2 = enable

-sps

Command delineator that precedes the PayloadScramble entry.

PayloadScramble

Payload scramble, either enabled or disabled.

1 = disable

2 = enable

-sfs

Command delineator that precedes the FrameScramble entry.

FrameScramble

Frame scramble, either enabled or disabled.

1 = disable

2 = enable


Syntax: PXM (T3)

cnfln -ds3 <LineNum> -lc <LineCoding> -ltp <LineType> -len <LineLength> -oof <LineOOFCriteria>
-cb <LineAIScBitsCheck> -lpb <LoopCmd> -felpnum <FarEndLoopbLineNum> -rfeac <LineRcvFEACValidation> -teac <XmtFEACCode> -pls <dsx3plcpPayloadScramble>


Syntax Description

-ds3

Command delineator that precedes the LineNum entry.

LineNum

DS3 line number in the format slot.port and has the following possible values:

For a PXM1, the slot is 7 or 8. For an optional SRM (controlled from the PXM1 CLI), the slot is 15, 16, 31, or 32.

The port is 1-2 for a PXM1 or 1-3 for an SRM.

-lc

Command delineator that precedes the LineCoding entry.

LineCoding

Line coding for Zero Code Suppression B3ZS or HDB3.

1 = B3ZS on a DSX3 line

2 = HDB3 on an E3 line

-ltp

Command delineator that precedes the LineType entry.

LineType

Select one of the following values:

1 = Cbit parity

2 = not allowed

3 = m23

-len

Command delineator that precedes the LineLength entry.

LineLength

Number of line feet.

1 = less than 225 feet

2 = 225 feet or more

-oof

Command delineator that precedes the LineOOFCriteria entry.

LineOOFCriteria

Threshold for triggering an Out Of Frame condition.

1 = 3 out of 8
An Out Of Frame condition is declared if at least 3 of 8 framing bits are in error.

2 = 3 out of 16
An Out Of Frame condition is declared if at least 3 of 16 framing bits are in error.

-cb

Command delineator that precedes the LineAIScBitsCheck entry.

LineAIScBitsCheck

Test of the C-bit in response to AIS status.

1 = check the C-bit

2 = ignore the C-bit

-lpb

Command delineator that precedes the LoopCmd entry.

LoopCmd

Loopback mode of the DS3/T3 interface. The looped data is the line framing synchronization and is sent every 10 ms. The loop exists on the daughter card attached to the PXM1 front card. The back card is involved only as a passive part of the loopback and only in the case of a remote loopback. For remote loopback, the far end can be CPE on a UNI port or a switch at the far end of a trunk. For local loopback, the data passes between only the PXM1 front card and the daughter card. Note that the mere execution of a loop may clear line alarms.

1 = no loopback. The purpose is to remove an existing loopback.

2 = that the near end loops back data from the remote end.

3 = local data loopback.

4 = inband local loopback.

-felpbnum

Command delineator that precedes the FarEndLoopbkLineNum entry.

FarEndLoopbkLineNum

Specify one of the following values:

FarEndLoopbkLineNum = 1-30

DS1 Line Number = 1-28

DS1 Line = 29

All = 30

-rfeac

Command delineator that precedes the LineRcvFEACValidation entry.

LineRcvFEACValidation

A number to specify criteria to validate far-end alarm and control (FEAC) code.

Enter 1 to specify 4 out of 5. A valid FEAC code is declared if 4 of 5 codes match.

Enter 2 to specify 8 out of 10. A valid FEAC code is declared if 8 of 10 codes match.

-tfeac

Command delineator that precedes the XmtFEACCode entry.

XmtFEACCode

One of the following transmit option, in the range 1-6:

1 = Send No Code

2 = Send Line Code

3 = Send Payload Code

4 = Send Reset Code

5 = Send DS1 Loopback Code

6 = Send Test Pattern

-pls

Command delineator that precedes the dsx3PlcpPayloadScramble entry.

dsx3PlcpPayloadScramble

One of the following values:

1 = enable

2 = disable


Example 1-115 Configures the FarEndLoopbkLineNum to DS3 line, and configures the transmit FEAC code to SendLineCode

cnfln -ds3 8.1
Not enough arguments
=== to configure ds3 line ===
cnfln "-ds3 <LineNum> -lc <LineCoding> -ltp <LineType> -len <LineLength>
       -oof <LineOOFCriteria> -cb <LineAIScBitsCheck> -lpb <LoopCmd>
-felpbnum <FarEndLoopbkLineNum>
       -rfeac <LineRcvFEACValidation> -tfeac <XmtFEACCode> -pls
<dsx3PlcpPayloadScramble>"
<LineNum> where LineNum = Slot.Line
where Slot = 7,8,15,16,31,32
Line = 1 - n
    -ltp <lineType> where 1-Cbit-Parity, 2: not allowed, 3: m23
    -lc <LineCoding> where LineCoding = 1 - 2, 1: dsx3B3ZS, 2: e3HDB3
    -len <LineLength> where LineLength = 1 - 2, 1: < 225 ft  2: >= 225
ft
    -oof <OOFCriteria> where OOFCriteria = 1 - 2, 1: 3 Out of 8, 2: 3
Out of 16
    -cb <AIScBitsCheck> where AIScBitsCheck = 1 - 2,1: Chk C-bit, 2:
Ignor C-bit
    -lpb <LoopCmd> where LoopCmd = 1-4
                1:NoLoop 2:RemoteLineLoop 3:LocalLineLoop
4:InbandLocalLoop
    -rfeac <RcvFEACValidation> where RcvFEACValidation = 1 - 3
                                1: 4 Out of 5, 2: 8 out of 10, 3:
Disable FEAC
    -tfeac <XmtFEACCode> where XmtFEACCode = 1 - 6

 1: SendNoCode, 2: SendLineCode

                                3: SendPayloadCode, 4: SendResetCode

                                5: SendDS1LoopCode, 6: SendTestPattern
    -felpbnum <FarEndLoopbkLineNum> where FarEndLoopbkLineNum = 1-30
                                1-28:ds1lineNum,  29: ds1lineAll, 30:
ds3line
    -pls <dsx3PlcpPayloadScramble> where dsx3PlcpPayloadScramble = 1-2
        1:enable , 2:disable


cnfln -ds3 8.1 -tfeac 2 -felpbnum 30

Example 1-116 Verify the configuration shown in the previous example.

dspln -ds3 8.1
  LineNum:               1
  LineType:              dsx3CbitParity
  LineCoding:            dsx3B3ZS
  LineLength:            lessThan225
  LineOOFCriteria:       fBits3Of8
  LineAIScBitsCheck:     Check C-bits
  LineLoopbackCommand:   NoLoop
  LineRcvFEACValidation: 4 out of 5 FEAC codes
  LineXmtFEACCode:       SendLineCode <<<<<<<<<<<<<<<<<<<<
  FarEndLoopbkLineNum:   ds3line  <<<<<<<<<<<<<<<<<<<<<<<
  LineEnable:            Enabled
  LinePayloadScramble:   Disabled

Example 1-117 Disabling the FEAC codes.

cnfln -ds3 8.1 -rfeac 3

dspln -ds3 8.1
  LineNum:               1
  LineType:              dsx3CbitParity
  LineCoding:            dsx3B3ZS
  LineLength:            lessThan225
  LineOOFCriteria:       fBits3Of8
  LineAIScBitsCheck:     Check C-bits
  LineLoopbackCommand:   NoLoop
  LineRcvFEACValidation: Disable FEAC Code   <<<<<<<<<<<<<<<<
  LineXmtFEACCode:       SendLineCode
  FarEndLoopbkLineNum:   ds3line
  LineEnable:            Enabled
  LinePayloadScramble:   Disabled

Syntax: PXM E3

cnfln -e3 <LineNum> -lc <LineCoding> -len <LineLength> -lpb <LoopCmd>
-topt <TrailTraceOption> -txtt <txTrailTrace> -txma <txTimingMarker>
-rxma <rxTimingMarker> -txpt <txPayloadType>

Syntax Description

-e3

Command delineator that precedes the LineNum entry.

LineNum

Line number in the format slot.line and has the following possible values:

For a PXM1, the slot is 7 or 8. For an optional SRM (controlled from the PXM1 CLI), the slot is 15, 16, 31, or 32.

The line number is 1-2 for the E3 back card on the PXM1. No E3 back card exists for the SRM.

-lc

Command delineator that precedes the LineCoding entry.

LineCoding

Line coding for Zero Code Suppression B3ZS or HDB3.

1 = B3ZS on a DSX3 line

2 = HDB3 on an E3 line

-len

Command delineator that precedes the LineLength entry.

LineLength

Number of line feet.

1 = less than 225 feet

2 = 225 feet or more

-lpb

Command delineator that precedes the LoopCmd entry.

LoopCmd

Loopback mode of the E3 interface.

1 = no loopback. The purpose is to remove an existing loopback.

2 = that the near end loops back data from the remote end.

3 = local data loopback.

-topt

Command delineator that precedes the TrailTraceOption entry.

TrailTraceOption

Trail trace, either enabled or disabled.

1= disable

2 = enable

-txtt

Command delineator that precedes the txTrailTrace entry.

txTrailTrace

Length of the trail trace string in the transmit direction (away from the switch). The maximum length of txTrailTrace is 16 bytes.

-txma

Command delineator that precedes the txTimingMarker entry.

txTimingMarker

Timing marker tracer during outbound transmission.

1 = traceable

2 = untraceable

-rxma

Command delineator that precedes the rxTimingMarker entry.

rxTimingMarker

Timing marker tracer during inbound transmission.

1 = traceable

2 = untraceable

-txpt

Command delineator that precedes the txPayloadType entry.

txPayloadType

Payload type.

1 = unequipped

2 = equipped

3 = ATM

4 = sdhtu12s


Syntax: FRSM 8T1, 8E1, 2CT3

cnfln <line_num> <line_type> <clk_src>

Syntax Description

line_num

DS1 Line number, in the range 1-56.

line_type

Type of line to be configured.

1 = dsx1ESF

2 = dsx1D4

clk_src

DSX1 clock source.

1 = loop clock

2 = local clock


Syntax: FRSM 2T3, 2E3, 2CT3, HS2

cnfds3ln <line_num> <line_type> <line_len> <clk_src>

Syntax Description

line_num

DS3 line number, in the range 1-2.

line_type

Type of line to be configured.

1 = C-bit parity

2 = g832_g804

3 = M13

4 = g751

line_len

Length of line.

1 = less than 225 feet

2 = greater than 225 feet

clk_src

DSX3 clock source.

1 = backplane clock

2 = recovery clock

3 = local clock


Syntax: FRSM HS1/B

cnfln <line_num> <line_type> <line_rate>

Syntax Description

line_num

Line number, in the range 1-4.

line_type

Line type.

1 = DTE

2 = DCE

3 = DTE_ST (V.35 only)

line_rate

Line rate, in the range 48 Kbps-52 Mbps.

1= 48000 11= 320000 21= 1792000 31= 6315000 41=12629000

2= 56000 12= 336000 22= 1920000 32= 7744000 42=13897000

3= 64000 13= 384000 23= 1984000 33= 7899000 43=14222000

4= 112000 14= 392000 24= 2048000 34= 8192000 44=14336000

5= 128000 15= 448000 25= 3097000 35= 9289000 45=15488000

6= 168000 16= 512000 26= 3157000 36= 9472000 46=15799000

7= 192000 17= 768000 27= 4096000 37=10240000 47=16384000

8= 224000 18= 1024000 28= 4645000 38=10890000 48=20025000

9= 256000 19= 1536000 29= 4736000 39=11059000 49=24986000

10= 280000 20= 1544000 30= 6195000 40=12390000 50=52000000


AUSM, CESM, VISM (for T1 or E1)

cnfln <line_num> <line_code> <line_len> <clk_src> [E1-signalling]

Syntax Description

line_num

Line number, in the range 1-8.

line_code

Line coding.

2 = B8ZS, applies to T1

3 = HDB3, applies to E1

4 = AMI, applies to T1 or E1

line_len

Line length, as appropriate for the interface.

T1: 10-15

10: 0-131 ft.

11: 131-262 ft.

12: 262-393 ft.

13: 393-524 ft.

14: 524-655 ft.

15: 655+ ft.

E1 with SMB module: 8

E1 with RJ-48 module: 9

clk_src

Clock source, either loop clock or local clock.

1 = loop clock

2 = local clock

E1-signalling

CAS: CAS, no CRC

CAS_CRC: CAS with CRC

CCS: CCS no CRC

CCS_CRC: CCS with CRC

CLEAR: Clear E1


Related Commands

addln, delln, dsplns, dspln

Attributes

Log: Yes

State: Active

Privilege: 1


Example 1-118 Configure line 4 on the current card (an AUSM in slot 4) to be T1 with B8ZS line coding, have a length of 10, and use the loop clock as a clock source

wilco.1.4.AUSM.a > cnfln 4 2 10 1 
wilco.1.4.AUSM.a > 


----------
cnfln -ds3 8.1
Not enough arguments
=== to configure ds3 line ===
cnfln "-ds3 <LineNum> -lc <LineCoding> -ltp <LineType> -len <LineLength>

       -oof <LineOOFCriteria> -cb <LineAIScBitsCheck> -lpb <LoopCmd>
-felpbnum <FarEndLoopbkLineNum>
       -rfeac <LineRcvFEACValidation> -tfeac <XmtFEACCode> -pls
<dsx3PlcpPayloadScramble>"

    <LineNum> where LineNum = Slot.Line

                where Slot = 7,8,15,16,31,32

                      Line = 1 - n

    -ltp <lineType> where 1-Cbit-Parity, 2: not allowed, 3: m23
    -lc <LineCoding> where LineCoding = 1 - 2, 1: dsx3B3ZS, 2: e3HDB3
    -len <LineLength> where LineLength = 1 - 2, 1: < 225 ft  2: >= 225
ft
    -oof <OOFCriteria> where OOFCriteria = 1 - 2, 1: 3 Out of 8, 2: 3
Out of 16
    -cb <AIScBitsCheck> where AIScBitsCheck = 1 - 2,1: Chk C-bit, 2:
Ignor C-bit
    -lpb <LoopCmd> where LoopCmd = 1-4
                1:NoLoop 2:RemoteLineLoop 3:LocalLineLoop
4:InbandLocalLoop
    -rfeac <RcvFEACValidation> where RcvFEACValidation = 1 - 3
                                1: 4 Out of 5, 2: 8 out of 10, 3:
Disable FEAC
    -tfeac <XmtFEACCode> where XmtFEACCode = 1 - 6

 1: SendNoCode, 2: SendLineCode

                                3: SendPayloadCode, 4: SendResetCode

                                5: SendDS1LoopCode, 6: SendTestPattern
    -felpbnum <FarEndLoopbkLineNum> where FarEndLoopbkLineNum = 1-30
                                1-28:ds1lineNum,  29: ds1lineAll, 30:
ds3line
    -pls <dsx3PlcpPayloadScramble> where dsx3PlcpPayloadScramble = 1-2
        1:enable , 2:disable

e.g >>
cnfln -ds3 8.1 -tfeac 2 -felpbnum 30

configures the FarEndLoopbkLineNum to DS3 line.
configures the transmit feac code to SendLineCode

verify this by
==========

dspln -ds3 8.1
  LineNum:               1
  LineType:              dsx3CbitParity
  LineCoding:            dsx3B3ZS
  LineLength:            lessThan225
  LineOOFCriteria:       fBits3Of8
  LineAIScBitsCheck:     Check C-bits
  LineLoopbackCommand:   NoLoop
  LineRcvFEACValidation: 4 out of 5 FEAC codes
  LineXmtFEACCode:       SendLineCode <<<<<<<<<<<<<<<<<<<<
  FarEndLoopbkLineNum:   ds3line  <<<<<<<<<<<<<<<<<<<<<<<
  LineEnable:            Enabled
  LinePayloadScramble:   Disabled

These values are defined in the cnfln -ds3 option mentioned above.

disabling the feac codes
====================

 cnfln -ds3 8.1 -rfeac 3

dspln -ds3 8.1
  LineNum:               1
  LineType:              dsx3CbitParity
  LineCoding:            dsx3B3ZS
  LineLength:            lessThan225
  LineOOFCriteria:       fBits3Of8
  LineAIScBitsCheck:     Check C-bits
  LineLoopbackCommand:   NoLoop
  LineRcvFEACValidation: Disable FEAC Code   <<<<<<<<<<<<<<<<
  LineXmtFEACCode:       SendLineCode
  FarEndLoopbkLineNum:   ds3line
  LineEnable:            Enabled
  LinePayloadScramble:   Disabled

cnflnsubrate

Configure Line Subrate

Use cnflnsubrate to configure the T3/E3 line subrate mode. This command provides T3/E3 line subrates for Digital Link and ADC Kentrox DSUs.

Possible errors associated with this command are

Illegal/invalid parameters

Feature is already enabled

Line doesn't exist

Software Version

Command available with 1.1.20 and higher.

Card(s) on Which This Command Executes

FRSM-2T3/2E3

Syntax

cnflnsubrate <line_num> <dsu_subrate_ena> <dsu_select> <dsu_scramble_ena> <dsu_line_rate >

Syntax Description

line_num

DS3 line number, in the range 1 to 2.

dsu_subrate_ena

One of the following values:

1 = disable

2 = enable

dsu_select

One of the following modes:

1 = Digital Link 3100 Mode

2 = ADC-Kentrox

dsu_scramble_ena

DSU line scrambling:

1 = disable

2 = enable

dsu_line_rate

A DSU line rate, values ranging from x to y.

For DL3100:

FRSM-2T3: x = 300, y = 44210

FRSM-2E3: x = 358, y = 34010

For ADC-Kentrox Mode:

FRSM-2T3/E3: x = 500, y = 44210 or 34010 in steps of x-value


.

Related Commands

None

Attributes

Log: Yes

State: Active

Privilege: 1-2


cnfname

Configure Name

Use the cnfname PAR command to set the switch name. The name can consist of letters, special characters "_" and "-" and numbers. It must begin with a letter and cannot contain spaces. The name is case-sensitive.

Card(s) on Which This Command Executes

PXM

Syntax

cnfname <node name>

Syntax Description

node name

Node name consisting of up to eight alphanumeric characters.


Related Commands

None

Attributes

Log: Yes

State: Active

Privilege: 1


Example 1-119 Set the switch name. The prompt returns with the new name. However, on the command line, the name is truncated to eight characters because of the information displayed in the prompt

NODENAME.1.7.PXM.a > cnfname kanchendzonga
kanchend.1.3.PXM.a >

cnfoamlpbk

Configure OAM Loopback

Use the cnfoamlpbk command to configure the OAM loopback test. This nonintrusive test sends OAM cells to an idle PVC, one not receiving data for a whole minute, to verify connection continuity. No remote end loopback is necessary for this test to run. OAM cells are automatically recognized and returned without the need for the remote end to be looping back all data. If the endpoints reside in FastPacket cards, then "test delay" cells are transmitted instead of OAM loopback cells.

The OAM cell is initiated at an endpoint and sent into the network, where it will be returned by the card at the remote end of the connection. (Note that the cells do not go through NNI trunks.) When ten consecutive cells are not received, the PVC is declared failed. The test logs alarms when significant continuous cell loss is encountered.

Once a failed PVC is detected, the local end from which the test started sends a network message to the endpoint node indicating a failure. This provides consistent network views for both ends of the connection.

Card(s) on Which This Command Executes

FRSM 2T3/E3, FRSM HS2

Syntax

cnfoamlpbk <action> <frequency>

Syntax Description

action

One of the following actions:

1 = OamRas enabled

2 = OamRas disabled

frequency

Frequency at which the loopback cells should be sent, in the range 1 to
10 minutes.


Related Commands

dspoamlpbk

Attributes

Log: Yes

State: Any State

Privilege: Any


Example 1-120 Send OAM cells every 10 minutes on an FRSM-2CT3 card

NODENAME.1.19.VHS2CT3.a > cnfoamlpbk 1 10
NODENAME.1.19.VHS2CT3.a > 

cnfpasswd

Configure Password

Use the cnfpasswd command to set the password for the specified User ID. Enter the command without arguments to change your own password. Prompts are presented to let you enter the new password and to confirm it.

Card(s) on Which This Command Executes

PXM

Syntax

cnfpasswd [<user_id>]

Syntax Description

user_id

User name.


Related Commands

None

Attributes

Log: Yes

State: Active

Privilege: Any


Example 1-121 Change your own password. Prompts appear for you to enter the new password and confirm it.

spirit4.1.8.PXM.a > cnfpasswd

Enter password:
Re-enter password:
 
 
spirit4.1.8.PXM.a >

cnfplpp

Configure PLPP

Use the cnfplpp command to set physical layer protocol process (PLPP) parameters on the current AUSM card.

Card(s) on Which This Command Executes

AUSM

Syntax

cnfplpp <phy_port_num> <loopback> <scramble> <singlebit_errcorr_ena>

Syntax Description

phy_port_num

Physical port number, in the range 1-8.

loopback

PLPP loopback.

1 = no loopback

2 = remote loopback

3 = local loopback

scramble

Enable or disable cell scramble.

1 = no scramble

2 = scramble

singlebit_errcorr_ena

Enable or disable single-bit error correction.

1 = disable

2 = enable


Related Commands

dspplpp

Attributes

Log: Yes

State: Active

Privilege: 1-2


Example 1-122 Configure PLPP parameters on port 1 on current AUSM card in slot 22 to disable cell scramble, to disable PLPP loopback, and to disable single-bit error correction

spirit3.1.22.AUSM8.a > cnfplpp 1 1 1 1
spirit3.1.22.AUSM8.a > 

A system response does not occur unless an error is detected. To confirm your configurations for PLPP parameters, use the dspplpp command.

Example 1-123 Confirm PLPP configuration

spirit3.1.22.AUSM8.a > dspplpp 1
  PhysicalPortNumber:            1
  CellFraming:                   ATM
  CellScramble:                  No Scramble
  Plpp Loopback:                 No Loopback
  Single-bit error correction:   Disabled
 
spirit3.1.22.AUSM8.a >

cnfport

Configure Port

Use the cnfport command to configure service port on an FRSM or a PXM. The configuration can be verified using the dspport command.

Card(s) on Which This Command Executes

PXM, FRSM

Syntax: PXM

cnfport <port_number> <percent_bandwidth> <min_VPI> <max_VPI>

Syntax Description

port_number

Port number, in the range 1-32.

percent_bandwidth

Percentage of bandwidth to be allocated on the port, in the range 1-100.

min_VPI

Minimum virtual path identifier (VPI), in the range 0-4095.

max_