cc/td/doc/product/wanbu/8850px45/rel52
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table Of Contents

Command Reference

Command Summary

Session Management Commands

Card Management Commands

Line Management Commands

Port Management Commands

Path Management Commands

Line, Port, and Path Bert Commands

IMA Group Commands

Multilink Frame Relay Commands

Multilink PPP Commands

Resource Partition Commands

Connection Management Commands

Command Line Interface

CLI Prompt

CLI Syntax

?

addapsln

addbert

addchanloop

addcon

addimagrp

addimalnk

addimaport

addlnloop

addmfrbundle

addmfrlnk

addmfrport

addmpbundle

addpart

addport

addppplink

addpppmux

addrscprtn

bootchange

bye

cc

ccc

clradjlnalmcnt

clrbecnt

clrchancnt

clrchancnts

clrilmicnt

clrimadelay

clrimagrpalmcnt

clrimagrpalmcnts

clrimalnkcnt

clrimalnkcnts

clrlnalmcnt

clrmfrbundlecnt

clrmfrbundlecnts

clrmfrlnkcnt

clrmfrlnkcnts

clrmpbundlecnt

clrmpbundlecnts

clrpathalmcnt

clrportcnt

clrportcnts

clrppplnkcnt

clrpppmuxcnt

clrsarcnt

clrscrn

cnfabr

cnfapsln

cnfatmlayer

cnfautolndiag

cnfautorestart

cnfbert

cnfcdmode

cnfcdsct

cnfchanstdabr

cnfclictx

cnfcon

cnffrparms

cnfilmi

cnfimagrp

cnfimalnk

cnfimalnktst

cnfimaparms


Command Reference


This chapter provides descriptions of the commands that are available on the MPSM-T3E3-155 and MPSM-16-T1E1 CLI. The commands are in alphabetical order. The descriptions include the following information about the commands:

The name of the command as it is entered in the CLI.

The full English name of the command and the cards on which it is available.

A description of the function of the command.

The syntax of the command.

The syntax description of the parameters.

The related commands that can be used in conjunction with the command.

The attributes of the command:

log: indicates whether the command is logged in a file or not.

state: indicates the state which the card must be in to execute the command.

privilege: indicates the privilege level that the user must have to execute the command.

An example of using the command in the CLI, including the output displayed and any messages that are returned.

Command Summary

The commands in the tables that follow ( Table 7-1 to Table 7-11) are divided by major functional group. Each table shows the complete name of the command and the service module cards for which the command is valid.

Session Management Commands

.

Table 7-1 Session Management Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

?

X

X

X

X

X

bootchange

X

X

X

X

X

bye

X

X

X

X

X

clrscrn

X

X

X

X

X

delsesn

X

X

X

X

X

exit

X

X

X

X

X

help

X

X

X

X

X

history

X

X

X

X

X

logout

X

X

X

X

X

sesntimeout

X

X

X

X

X

smclrscrn

X

X

X

X

X

timeout

X

X

X

X

X

users

X

X

X

X

X

who

X

X

X

X

X

whoami

X

X

X

X

X


Card Management Commands

Table 7-2 Card Management Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

cc

X

X

X

X

X

ccc

X

X

X

X

X

cnfcdsct

X

X

X

X

X

cnfclictx

X

X

X

X

 

cnfprfparam

X

X

X

X

X

cnfrmrsrc

X

X

X

X

X

core

X

X

X

X

X

dspapsbkplane

X

X

     

dspcd

X

X

X

X

X

dspcdsct

X

X

X

X

X

dspcdstatcnf

X

X

X

X

X

dspcduptime

X

X

X

X

X

dspclictx

X

X

X

X

X

dspeng

X

X

X

X

X

dspfile

X

X

X

X

X

dspliccd

X

X

X

X

X

dspprf

X

X

X

X

X

dspprfhist

X

X

X

X

X

dsprmalms

X

X

X

X

X

dsprminfo

X

X

X

X

X

dsprmrsrc

X

X

X

X

X

dsprmrsrcs

X

X

X

X

X

dspsct

X

X

X

X

X

dsptotals

X

X

X

X

X

dspversion

X

X

X

X

X

memshow

X

X

X

X

X

movelic

X

X

X

X

X

setctx

X

X

X

X

 

seteng

X

X

X

X

X

sfmDBShow

X

X

X

X

X

shellConn

X

X

X

X

X

trace

X

X

X

X

X


Line Management Commands

Table 7-3 Line Management Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

addapsln

X

X

     

addlnloop

X

X

X

X

X

clradjlnalmcnt

X

X

     

clrbecnt

X

X

     

clrlnalmcnt

X

X

X

X

X

cnfapsln

X

X

     

cnfautolndiag

X

X

X

X

X

cnfcdmode

X

X

X

X

X

cnfln

X

X

X

X

X

cnflnalm

X

X

     

delapsln

X

X

     

dellnloop

X

X

X

X

X

dnln

X

X

X

X

X

dspadjlnalm

X

X

     

dspadjlnalmcnt

X

X

     

dspapsln

X

X

     

dspapslns

X

X

     

dspatmlayer

X

 

X

   

dspatmlayercnt

X

 

X

   

dspautolndiag

X

X

X

X

X

dspbecnt

X

X

     

dspdiagresults

X

X

X

X

X

dspln

X

X

X

X

X

dsplnalm

X

X

X

X

X

dsplnalmcnf

X

X

     

dsplnalmcnt

X

X

X

X

X

dsplnalms

X

X

X

X

X

dsplnload

X

 

X

   

dsplnpmbucketcnt

X

X

X

X

X

dsplns

X

X

X

X

X

dspsct

X

X

X

X

X

dsptotals

X

X

X

X

X

switchapsln

X

X

     

upln

X

X

X

X

X


Port Management Commands

Table 7-4 Port Management Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

addport

X

X

X

X

 

clrilmicnt

X

 

X

   

clrportcnt

X

X

X

X

 

clrportcnts

 

X

 

X

 

cnffrparms

 

X

 

X

 

cnfilmi

X

 

X

   

cnfport

X

X

X

X

 

delport

X

X

X

X

 

dnallports

X

 

X

   

dnilmi

X

 

X

   

dnport

X

X

X

X

 

dspfrparms

 

X

 

X

X

dspilmi

X

 

X

   

dspilmicnt

X

 

X

   

dspilmis

X

 

X

   

dspport

X

X

X

X

X

dspportcnt

X

X

X

X

 

dspportload

X

 

X

   

dspports

X

X

X

X

X

dspportsct

X

X

X

X

X

dspsct

X

X

X

X

X

dsptotals

X

X

X

X

X

upilmi

X

 

X

   

upport

X

X

X

X

 

upallports

X

 

X

   

Path Management Commands

Table 7-5 Path Management Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

clrpathalmcnt

X

X

     

cnfatmlayer

X

       

cnfpath

X

X

     

cnfpathalm

X

X

     

cnftug3

X

X

     

dnpath

X

X

     

dspatmlayer

X

 

X

   

dspatmlayercnt

X

 

X

   

dsppath

X

X

     

dsppathalm

X

X

     

dsppathalmcnf

X

X

     

dsppathalmcnt

X

X

     

dsppathalms

X

X

     

dsppaths

X

X

     

dsptotals

X

X

X

X

X

dsptug3cnf

X

X

     

dsptug3s

X

X

     

uppath

X

X

     

Line, Port, and Path Bert Commands

Table 7-6 BERT Management Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

addbert

X

X

X

X

X

cnfbert

X

X

X

X

X

delbert

X

X

X

X

X

dspbert

X

X

X

X

X

dspbertcap

X

X

X

X

X

dspberts

X

X

X

X

X

dspbertstat

X

X

X

X

X

insbiterror

X

X

X

X

X


IMA Group Commands

Table 7-7 IMA Group Commands

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

addimagrp

X

 

X

   

addimalnk

X

 

X

   

addimaport

X

 

X

   

clrimadelay

X

 

X

   

clrimagrpalmcnt

X

 

X

   

clrimagrpalmcnts

X

 

X

   

clrimalnkcnt

X

 

X

   

clrimalnkcnt

X

 

X

   

clrimalnkcnts

X

 

X

   

cnfatmlayer

X

 

X

   

cnfautorestart

X

 

X

   

cnfimagrp

X

 

X

   

cnfimalnk

X

 

X

   

cnfimalnktst

X

 

X

   

cnfimaparms

X

 

X

   

delimagrp

X

 

X

   

delimalnk

X

 

X

   

dnimagrp

X

 

X

   

dspatmlayer

X

 

X

   

dspatmlayercnt

X

 

X

   

dspautorestart

X

 

X

   

dspimagrp

X

 

X

   

dspimagrpalm

X

 

X

   

dspimagrpalmcnt

X

 

X

   

dspimagrpalms

X

 

X

   

dspimagrpbucketcnt

X

 

X

   

dspimagrps

X

 

X

   

dspimagrps

X

 

X

   

dspimalnk

X

 

X

   

dspimalnkalm

X

 

X

   

dspimalnkalms

X

 

X

   

dspimalnkbucketcnt

X

 

X

   

dspimalnkcnt

X

 

X

   

dspimalnks

X

 

X

   

dspimaparms

X

 

X

   

dsptotals

X

 

X

   

restartimagrp

X

 

X

   

startimalnktst

X

 

X

   

stopimalnktst

X

 

X

   

upimagrp

X

 

X

   

Multilink Frame Relay Commands

Table 7-8 Multilink Frame Relay Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

addmfrbundle

 

X

     

addmfrlnk

 

X

     

addmfrport

 

X

     

clrmfrbundlecnt

 

X

     

clrmfrbundlecnts

 

X

     

clrmfrlnkcnt

 

X

     

clrmfrlnkcnts

 

X

     

cnfmfrbundle

 

X

     

cnfmfrlnk

 

X

     

delmfrbundle

 

X

     

delmfrlnk

 

X

     

dnmfrbundle

 

X

     

dspmfrbundle

 

X

     

dspmfrbundlealm

 

X

     

dspmfrbundlealms

 

X

     

dspmfrbundlebucketcnt

 

X

     

dspmfrbundlecnt

 

X

     

dspmfrbundles

 

X

     

dspmfrlnk

 

X

     

dspmfrlnkalm

 

X

     

dspmfrlnkalms

 

X

     

dspmfrlnkbucketcnt

 

X

     

dspmfrlnkcnt

 

X

     

dspmfrlnks

 

X

     

dsptotals

 

X

     

upmfrbundle

 

X

     

Multilink PPP Commands

Table 7-9 Multilink PPP Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

addmpbundle

       

X

addppplink

       

X

addpppmux

       

X

clrmpbundlecnt

       

X

clrmpbundlecnts

       

X

clrppplnkcnt

       

X

clrpppmuxcnt

       

X

cnfmpbundle

       

X

cnfmpbundleparams

       

X

cnfppplink

       

X

cnfpppmux

       

X

delmpbundle

       

X

delppplink

       

X

delpppmux

       

X

dnmpbundle

       

X

dnppplink

       

X

dspmpbundle

       

X

dspmpbundlecnt

       

X

dspmpbundleload

       

X

dspmpbundleparams

       

X

dspmpbundles

       

X

dspppplink

       

X

dspppplinks

       

X

dspppplnkcnt

       

X

dsppppmux

       

X

dsppppmuxcnt

       

X

dsptotals

       

X

dspwinpathload

       

X

dspwpbundles

       

X

upmpbundle

       

X

upppplink

       

X


Resource Partition Commands

Table 7-10 Resource Partition Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

addpart

X

X

X

X

 

addrscprtn

X

X

X

X

 

clrilmicnt

X

 

X

   

cnfpart

X

X

X

X

 

cnfilmi

X

 

X

   

cnfrscprtn

X

X

X

X

 

delpart

X

X

X

X

 

delrscprtn

X

X

X

X

 

dnilmi

X

 

X

   

dspilmi

X

 

X

   

dspilmicnt

X

 

X

   

dspilmis

X

 

X

   

dspload

X

X

X

X

 

dsppart

X

X

X

X

X

dspparts

X

X

X

X

X

dsprscprtn

X

X

X

X

X

dsprscprtns

X

X

X

X

X

dspvsiparts

X

X

X

X

X

upilmi

X

 

X

   

Connection Management Commands

Table 7-11 Connection Management Commands 

Command
MPSM-T3E3-155
MPSM-16-T1E1
ATM Context
FR Context
ATM Context
Frame Relay Context
PPP Context

addchanloop

X

X

X

X

 

addcon

X

X

X

X

X

clrchancnt

X

X

X

X

X

clrchancnts

X

X

X

X

X

clrsarcnt

X

X

X

X

X

cnfabr

X

 

X

   

cnfchanstdabr

 

X

 

X

 

cnfcon

X

X

X

X

X

delchanloop

X

X

X

X

 

delcon

X

X

X

X

X

dncon

X

X

X

X

X

dncons

X

 

X

   

dspchancnt

X

X

X

X

X

dspchanloop

X

X

X

X

 

dspchanstdabr

 

X

 

X

 

dspchantests

X

X

X

X

X

dspcon

X

X

X

X

X

dspconalmcnts

X

X

X

X

X

dspconalms

X

X

X

X

X

dspconload

X

 

X

   

dspcons

X

X

X

X

X

dspsarcnt

X

X

X

X

X

dsptotals

X

X

X

X

X

dspvsicon

X

X

X

X

X

dspvsicons

X

X

X

X

X

getpcrfromcir

 

X

 

X

X

rrtcon

X

X

X

X

X

tstcon

X

X

X

X

X

tstconseg

X

 

X

   

tstdelay

X

X

X

X

X

upcon

X

X

X

X

X

upcons

X

 

X

   

Command Line Interface

Each MPSM-T3E3-155 and MPSM-16-T1E1 card has its own command line interface (CLI), which is similar to the CLIs on the PXMs and the other service modules.

The CLI is the interface from which you to enter the commands that configure the card. You log into the CLI using the appropriate user name and password. For detailed information about user names, passwords, and logging into the CLI, see the Cisco MGX 8800/8900 Series Configuration Guide, Release 5.2.

After you have logged in, you see a CLI prompt such as the following one:

MGX8850.7.PXM.a >

To change from the CLI of one card to the CLI of another card, enter the change card (cc) command. For example:

MGX8850.7.PXM.a > cc 1

(session redirected)

MGX8850.1.MPSM155[ATM].a >

CLI Prompt

The format of the CLI prompt is as follows:

Name.Slot Number.Card Type.Card State >

For example:

MGX8850.1.MPSM155[ATM].a >

Table 7-12 describes the format of the CLI prompt:

Table 7-12 CLI Prompt Descriptions

Format

Name

Slot Number

Card Type

Service Context

Card State

Example

MGX8850

1

MPSM155

[ATM]

a

Description

The name of the switch.

The slot containing the front card.

The type of card, such as PXM, MPSM-T3E3-155,
MPSM-16-T1E1

The service context currently configured on the card. Can be [ATM] or [FR]. Can be [PPP] on MPSM-16-T1E1.

a-active
s-standby
i-initialized


CLI Syntax

This section explains the syntax for using commands in the CLI. The following topics are discussed:

Command Notation

Command Parameters

Command Entry

Command Notation

The notations for the CLI syntax are as follows:

Commands appear in bold, for example: addport

Keywords appear in bold, for example: -ds1

Literal strings appear in bold, for example: yes

Variables appear in italics, for example: bay.line

Required parameters appear within arrowheads (< >), for example: <ifNum>

Optional parameters appear within square brackets ([ ]),
for example: [-minvpi minvpi]

A vertical bar ( | ) represents the logical OR function

Braces {} enclosing keywords or arguments separated by a vertical bar ( | ) indicate a required choice.

Command Parameters

Parameters act as the arguments for the command. Parameters may consist of variables, keywords, and literal strings.

Commands may include parameters that are keyword-driven or position-dependent.

Position-dependent Parameters

You must type position-dependent parameters in the order they appear in the syntax description. For example, to add a logical port, you must enter the required, position-dependent parameters as follows:

addport <ifNum> <bay.line> <guaranteedRate> <maxrate> <sctID> <ifType> [vpi]

Keyword-driven Parameters

For a keyword-driven parameter, the keyword is preceded by a dash and followed by a variable, for example:

[-timeout secs]

Keyword-driven parameters are usually not position-dependent.

In the following example, the command contains both keyword-driven and position-dependent parameters.

delcons <ifNum> <vpi> <vci> [-num num. conns to del] [-verbose 1 | 0]

The keyword-driven parameters appear first in a specific order. The keyword-driven parameters can be in any order after that.

Command Entry

You enter a command by pressing the Return key or Enter key after you have typed the name of the command and all of its parameters in the proper order.

If you enter a command with incorrect parameters or with no parameters (when parameters are required), the CLI displays a message with the correct syntax, parameters, and ranges for the command. The message may also suggest what the problem is.


Note The history buffer stores the last 10 commands you entered. Enter the Up Arrow key to recall commands in the history buffer, beginning with the most recent command. Repeat the key sequence to recall older commands successively.


?

? (or Help)

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the ? or help command to view all commands you can use on the current card and current privilege level. The display does not show commands with a privilege level that is higher than that of the current user.

If you follow the ? with part of a command name, the output shows all commands that contain that string. If you follow the ? with the complete name of one command, the output simply states whether that command is available.

If you can enter two parameter strings, help provides information for each of the two strings separately (not a single, two-part string).

Syntax

? [command]

Syntax Description

command

Full or partial name of a command.


Related Commands

help

Attributes

Log: no

State: active, standby, init

Privilege: ANYUSER


Example

In the following example, the user displays all commands available on an MPSM-T3E3-155 card in the Frame Relay CLI context:

M8850_SF.9.MPSM155[FR].a > ?

Available commands
------------------
?
addapsln
addbert
addchanloop
addcon
addlnloop
addmaster
addmfrbundle
addmfrlnk
addmfrport
addpart
addport
addrscprtn
addslave
bootChange
bye
cc
ccc

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

In the following example, the user views all commands associated with a partial command entry string.

M8850_SF.9.MPSM155[FR].a > ? con

Available commands
------------------
addcon
cnfcon
delcon
dncon
dspcon
dspconalmcnts
dspconalms
dspcons
dspvsicons
rrtcon
shellConn
tstcon
upcon

addapsln

Add APS Line

Service Context—ATM and Frame Relay

Modules—MPSM-T3E3-155

Enter the addapsln command to designate a pair of lines (workingIndex, protectIndex) as APS lines. To configure the APS parameters, enter the cnfapsln command.

APS Overview

Automatic Protection Switching (APS) is a standards-based redundancy scheme which enhances network reliability by protecting against line failure. APS is defined in Bellcore and ITU standards for North American SONET and international Synchronous Digital Hierarchy (SDH) optical network links. The relevant standards are Bellcore GR-253 and ITU-T G.841.

APS enables a pair of SONET lines to be configured for line redundancy. The APS pair consists of a working line (workingIndex) and a protection line (protectIndex), where one line is active and the other is a backup. Whether or not the backup line passes traffic while in standby mode depends on the APS architecture mode (archmode).

Coordination of line switching is controlled by an in-band signaling protocol. If the fiber optic carrier for the active line is severed or damaged, the in-band signaling protocol must detect the fault within 10 milliseconds. After the in-band signaling protocol has detected the fault, it must switch the user traffic to the standby line within 50 milliseconds.

When the revertive option is enabled (see cnfapsln), the in-band signaling protocol will attempt to switch the user traffic back to the working line from the protection line after the working line becomes functional again. However, it must wait for the configured time period (wait to restore) to elapse.

Direction

APS can be configured in two directions (see direction parameter in cnfapsln), bidirectional and unidirectional. Bidirectional means that both the receiving and transmitting paths are switched. Unidirectional means that only the affected path, receiving or transmitting, is switched.

Same-card APS

In same-card APS, the working bay and protection bay must be the same, and the working line and protection line must be adjacent.

Architecture mode 1:1 is supported only on same-card APS.

Cross-card APS

In cross-card APS, the working slot and the protection slot must be adjacent. The working bay and line number, and the protection bay and line number must be the same. Card redundancy must be configured on the two cards before cross-card APS can be added.

APS Architecture Modes

MPSM-T3E3-155 supports the following APS architecture modes (archmode):

1 = 1+1-provides line redundancy with traffic on both lines

2 = 1:1-provides line redundancy with traffic on the active line only.

3 = 1+1-Annex B


Note The ITU GR.253 and the G.841 AnnexA protocols are supported in modes 1 and 2 on MPSM-T3E3-155.



Note Other architecture mode options may be displayed by the CLI when the addapsln command is entered with no parameters, but they are not supported at this time.


Syntax

addapsln <workingIndex> <protectIndex> <archmode>

Syntax Description

workingIndex

Indicates the working slot number, bay number, and line number of the working line in the format:

slot.bay.line

Note On the MPSM-T3E3-155 card, the bay is always 1.

protectIndex

Indicates the protection slot number, bay number, and line number of the protection line in the format:

slot.bay.line

Note On the MPSM-T3E3-155 card, the bay is always 1.

archmode

Indicates the APS architecture mode to be used on the working/protection line pairs.

1 = 1+1-Provides line redundancy with traffic on both lines

2 = 1:1-Provides line redundancy with traffic on the active line only.

3 = 1+1-Annex B


Related Commands

cnfapsln, delapsln, dspapsln, dspapslns, switchapsln, dspapsbkplane, clrbecnt, dspbecnt

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user adds 1+1 APS redundancy to the two lines on the same MPSM-T3E3-155 card:

mpsm_node.13.MPSM155[ATM].a > addapsln 9.1.1 9.1.2 1

addbert

Add Bit Error Rate Test

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addbert command to add a Bit Error Rate Test (BERT) session to a line, path, or port. After you add the BERT session, you can configure the test pattern and the type of loopback using the cnfbert command.

Syntax

addbert <bertIfNum>

Syntax Description

bertIfNum

Interface number (line, path, or port number) on which to add a BERT session.

Note Enter the dsplns , dsppaths or dspports command to display the line, path, or port numbers for the current card.

Note For the MPSM-T3E3-155, you can add BERT sessions to paths only.

Note For the MPSM-16-T1E1 in ATM or PPP contexts, you can add BERT sessions to lines only.


Related Commands

cnfbert, delbert, dspbert, dspbertcap, dspberts, dspbertstat, startbert, stopbert

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user adds a BERT session to the Frame Relay path 1.1.2.

M8830_CH.12.MPSM155[FR].a > addbert 1.1.2

addchanloop

Add Channel Loopback
Service Context—ATM, Frame Relay

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addchanloop command to place a channel in loopback mode.

Syntax (ATM Service Context)

addchanloop <IfNum><vpi><vci> <loopback>

Syntax Description (ATM Service Context)

IfNum

Interface number (port number) of the channel to configure.

MPSM-16-T1E1 range: 1-499

MPSM-T3E3-155 range: 1-1003

Note Enter the dspcons command in the ATM CLI context to display the port number, VPI, and VCI for all active ATM channels.

vpi

VPI, in the range 0-4095

vci

VCI, in the range 32-65535

loopback

The desired loopback type:

1=RemoteLoop (Ingress)

2=LocalLoop (Egress)


Syntax (Frame Relay Service Context)

addchanloop <IfNum> <dlci>

Syntax Description (Frame Relay Service Context)

IfNum

Interface number (port number) of the channel to configure.

MPSM-16-T1E1 range: 1-499

MPSM-T3E3-155 range: 1-1003

Note Enter the dspcons command in the Frame Relay CLI context to display the port number and DLCI for all active Frame Relay ports.

dlci

Data-link connection identifier, in the range 1-1022 for a 2-byte header, or 1-8388607 for 4-byte header.


Related Commands

dspchanloop, delchanloop, dspcons

Attributes

Log: yes

State: active

Privilege: GROUP1


Example (ATM Service Context)

In the following example, the user activates a local loopback on port 12, VPI 35, VCI 120.

M8830_CH.12.MPSM155[ATM].a > addchanloop 12 35 120 2

Example (Frame Relay Service Context)

In the following example, the user activates a loopback on port 11, DLCI 150.

M8830_CH.12.MPSM155[FR].a > addchanloop 11 150

addcon

Add Connection

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addcon command to add a logical connection, either an SPVC or PVC, between service module ports.

You can create two types of SPVCs:

Single-ended SPVCs

Double-ended SPVCs

Single-ended SPVCs are defined at the master endpoint and do not require configuration of a slave endpoint. The primary benefit of single-ended SPVCs is that they are easier to configure. After configuration, the master endpoint configures and brings up the slave endpoint. In order for this feature to work correctly, the destination endpoint must support single-ended SPVCs.

Double-ended SPVCs require separate configuration of the master and slave endpoints. The slave endpoint must be configured first because this step generates a 20 octet NSAP slave address that must be entered during master endpoint configuration.

For detailed information about adding ATM connections on an MPSM-T3E3-155 or MPSM-16-T1E1 card, see the "Provisioning and Managing SPVCs and SPVPs" section in Chapter 3, "Provisioning ATM Services on MPSM-T3E3-155 and MPSM-16-T1E1."

For detailed information about adding Frame Relay connections on an MPSM-T3E3-155 or MPSM-16-T1E1 card, see the "Provisioning and Managing SPVCs" section in Chapter 4, "Provisioning Frame Relay Services on MPSM-T3E3-155 and MPSM-16-T1E1."

Syntax (ATM Service Context)

addcon <ifNum> <vpi> <vci> <service type> <mastership>
[-casttype <value>] [-slave <NSAP.vpi.vci>]
[-lpcr <local PCR>] [-rpcr <remote PCR>]
[-lscr <local SCR>] [-rscr <remote SCR>]
[-lmbs <local MBS>] [-rmbs <remote MBS>]
[-lcdv <local maxCDV>] [-rcdv <remote maxCDV>]
[-lctd <local maxCTD>] [-rctd <remote maxCTD>]
[-lmcr <local MCR>][-rmcr <remote MCR>]
[-cdvt <local CDVT>] [-cc <OAM CC Cnfg>] [-stat <Stats Cnfg>]
[-frame <frame discard>] [-mc <maximum cost>]
[-lputil <local util>] [-rputil <remote util>]
[-slavepersflag <slavepers>]
[-rtngprio <routingPriority>]
[-prefrte <preferredRouteId>]
[-intvsvd <internal VSVD config>] [-extvsvd <external VSVD config>]
[-directrte <directRoute>]


Note To specify an OAM segment endpoint, enter the cnfcon command after you have created the connection by using the addcon command. The cnfcon parameter is -segep.


Syntax Description (ATM Service Context)

For the applicable parameters, the "local" end is the point at which you are provisioning the connection.

ifNum

Interface number (port number) of the port to connect.

MPSM-16-T1E1 range: 1-499

MPSM-T3E3-155 range: 1-1003

Note Enter the dspports command in the ATM CLI context to display the port numbers for all active ATM ports.

vpi

Specifies the Virtual Path Identifier.

VCC UNI range 0-255

VCC NNI or VNNI range: 0-4095

For a VNNI, specify one VPI per port.

vci

Specifies the Virtual Connection Identifier (VCI).

VCC UNI range: 1-4095

VCC NNI or VNNI range: 1-65535

VPC: 0 only

service type

Specifies the ATM service type:

1 = CBR1 (Constant Bit Rate 1)

2 = VBR1RT (Variable Bit Rate 1, Real Time)

3 = VBR2RT (Variable Bit Rate 2, Real Time)

4 = VBR3RT (Variable Bit Rate 3, Real Time)

5 = VBR1NRT (Variable Bit Rate 1, Non-Real Time)

6 = VBR2NRT (Variable Bit Rate 2, Non-Real Time)

7 = VBR3NRT (Variable Bit Rate 3, Non-Real Time)

8 = UBR1 (Unspecified Bit Rate 1)

9 = UBR2 (Unspecified Bit Rate 2)

10 = ABRSTD (Standard ABR—see cnfabr for VS/VD-specific parameters)

11 = CBR2 (Constant Bit Rate 2)

12 = CBR3 (Constant Bit Rate 3)

Note CBR2 and CBR3 will be obsoleted in the future. Use CBR1 instead.

Note For ATM-FR interworking, the service mapping is.

FR ATM

highpriority cbr1

rtVBR vbr3rt

rtVBR vbr3nrt

uBR ubr

stdABR stdabr

mastership

Defines the endpoint as master or slave:

1 = master

2 = slave

-casttype

Sets the broadcast type. Only one option is supported:

0 = point-to-point

-slave

Specifies the slave-end connection identifier for the master endpoint. You get the slave-end connection ID at the slave-end node when you add that endpoint. Specify the slave in the following format:

slave_nsap_address.vpi.vci

Note This parameter is required when you configure a master endpoint (mastership=1).

-lpcr

Specifies the Peak Cell Rate for this connection in the local to remote direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-rpcr

Specifies the Peak Cell Rate for this connection in the remote to local direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-lscr

Specifies the Sustainable Cell Rate for this connection in the local to remote direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-rscr

Specifies the Sustainable Cell Rate for this connection in the remote to local direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-lmbs

Specifies the Maximum Burst Size for variable bit rate connections in the local to remote direction. MBS is the maximum number of cells that can burst at the PCR and still be compliant. Range: 0-5000000 cells

-rmbs

Specifies the Maximum Burst Size for variable bit rate connections in the remote to local direction. MBS is the maximum number of cells that can burst at the PCR and still be compliant. Range: 0-5000000 cells

-lcdv

Specifies the Local Cell Delay Variation, which limits the peak to peak cell delay variation from the local endpoint to the remote endpoint, in the range 1-16777215 microseconds.

-rcdv

Specifies the Remote Cell Delay Variation, which limits the peak to peak cell delay variation from the remote endpoint to the local endpoint, in the range 1-16777215 microseconds.

Default: -1

-lctd

Specifies the Local Cell Transfer Delay (CTD), which limits the CTD from a local endpoint to a remote endpoint, in the ranges 0-65535 microseconds.

-rctd

Specifies the Remote Cell Transfer Delay (CTD), which limits the CTD from the remote endpoint to the local endpoint, in the range 0-65535 microseconds.

Default: -1

-lmcr

Specifies the Minimum Cell Rate for available bit rate connections in the local to remote direction.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-rmcr

Specifies the Minimum Cell Rate for available bit rate connections in the remote to local direction.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-cdvt

Specifies the Local Cell Delay Variation Tolerance (CDVT) from a local endpoint to a remote endpoint, in the range 1-5000000 microseconds. Cell Delay Variation Tolerance controls the time scale over which the PCR is policed.

Note No remote CDVT is necessary.

-cc

Enables or disables the Operations, Administration, and Maintenance continuity check (OAM CC):

1 = enable

0 = disable (default)

Continuity checking invokes a round trip of an OAM cell simply to confirm that both directions of the connection are intact.

To provision continuity checking, enable this function at both ends of the connection; otherwise, a connection alarm results. When you add a connection and include this parameter, the connection goes into alarm until both ends of the connection are added.

Note A non-zero AIS delay timer affects CC functionality (if enabled) during the intentional re-routing of a connection following the optrte or cnfrteopt command at the PXM card. The cnfaisdelaytimer command at the PXM card controls the AIS-delay feature. If the delay timer is configured and the connection is groomed, the switch turns off CC until the connection is re-routed.

-stat

Enables or disables connection statistics collection for the Cisco WAN Manager tool:

1 = enable

0 = disable (default)

Note Statistics collection has an impact, which may not be significant, on the real-time response, especially for SVCs (which can be affected even though you do not add SVCs). Therefore, you should enable statistics collection for only the subset of connections that really warrant such a feature.

-frame

Enables or disables frame discard for this connection. You can use this option only at the master endpoint of a connection.

1 = enable

0 = disable (default)

-mc

Specifies the Maximum Cost (maxcost), which creates a priority for the connection route. The switch can select a route if the cost does not exceed this value. If you do not specify maxcost, the connection has the highest routing priority by default. Use this parameter to lower the routing priority of a connection.

The following values are valid:

0: Use the optimal (or least expensive) path

1-4294967295: Use the path if the total cost for all links does not exceed this value.

The default value is 4294967295, which assigns the highest priority to an SPVC based on cost. If you do not specify maxcost, the cost appears as a -1 in the output of the dspcon command.

Note Although maxcost applies to an individual connection, routing costs primarily depend on a cost-per-link that you specify at every PNNI logical port in the network.

-lputil

Specifies the Local Percentage Utilization, in the range 1-100 percent.

Default: 100 percent

-rputil

Specifies the Remote Percentage Utilization, in the range 1-100 percent. Default: 100 percent.

-slavepersflag

Controls whether the endpoint is persistent or non-persistent. Enter a number to indicate the persistency as follows:

0 = persistent (default)

1 = non-persistent

-rtngprio

The routing priority for the connection, in the range 1-15. 0 is reserved for control connections, and 1 is reserved for IP to CWM.

Default: 8

-prefrte

This option associates a preferred route to the connection. Use this parameter at the master endpoint only. Be sure the route exists before you associate it with the connection because the system does not check it. Enter the dspprefs command at the PXM card to display preferred routes.

The following values are valid:

0: Disassociate a connection from a route (default)

1-65535: The preferred route id


Note Before you delete the route, disassociate all connections from the route; otherwise, a dangling preferred route path remains. Enter the dspcons [-rteid <pref rte id>] command at the PXM card to display all connections associated with a route.



Note An SPVC can be associated with one preferred route. For an XPVC, you can associate the preferred route with only the SPVC portion of the XPVC.


-intvsvd

Enables or disables VS/VD on the internal loop:

1 = Off (default)

2 = On

3 = Unspecified: Use the VS/VD specification in the SCT file.

The cnfintfvsvd command enables VS/VD at the PNNI port level.

-extvsvd

Enables or disables VS/VD on the external loop:

1 = Off (default)

2 = On

3 = Unspecified: Use the VS/VD specification in the SCT file.

The cnfintfvsvd command enables VS/VD at the PNNI port level.

-directrte

Enables or disables a direct route for this connection. When enabled (yes), the preferred route is the only permissible route for this connection. Should the directed preferred route be unavailable, the connection fails. When disabled (no), the connection tries another alternate route if the preferred route is unavailable.

The values are as follows:

1 = yes (make the preferred route required)

0 = no (do not require the connection to take the preferred route)

Default: 0


Syntax (Frame Relay Service Context)

addcon <ifNum> <dlci> <chanType> <serviceType> <mastership> <cir>
[-slave <value>] [-slavepersflag <slavepers>]
[-eir <zeroCirEir>] [-bc <Burst Commit>] [-be <Burst Excess>]
[-detag <DE Tagging Enable>] [-igde <Ignore Incoming DE>]
[-fecnmap <FECN map>] [-demap <DE to CLP map>]
[-clpmap <CLP to DE map>] [-eqsel <Egress Q Select>]
[-ingut <Ingress Perc Util>] [-egut <Egress Perc Util>]
[-egrat <Egress Service Rate>]
[-rtngprio <Routing Priority>] [-upc <UPC Cnfg>]
[-lpcr <local-remote PCR>] [-rpcr <remote-local PCR>]
[-lscr <local-remote SCR>] [-rscr <remote-local SCR>]
[-lmcr <local-remote MCR>] [-rmcr <remote-local MCR>]
[-prefrte <routeId>] [-directrte <yes|no>]
[-rmbs<remote MBS>] [-cc <OAM CC Cnfg>]

Syntax Description (Frame Relay Service Context)

For the applicable parameters, the "local" end is the point at which you are provisioning the connection.

ifNum

Interface number (port number) of the port to connect.

MPSM-16-T1E1 range: 1-499

MPSM-T3E3-155 range: 1-1003

Note Use the dspports command in the Frame Relay CLI context to display the port numbers for all active Frame Relay ports.

dlci

Specifies the Data-Link Connection Identifier.

2-byte header range: 1-1006 and 1008-1022

4-byte header range: 1-8257534 and 8257536-8388607

chanType

Specifies the channel type. Enter a number to indicate one of the following channel types:

1 = frNIW: Frame Relay network interworking

2 = frSIWtransparent: Service interworking without SDU translation

3 = frSIWtranslate: Service interworking with SDU translation

5 = frForward: Frame forwarding

6 = frNIWReplace: Frame Relay network interworking replace

serviceType

Specifies the service type for the connection. Enter a number to indicate one of the following service types:

1 = highpriority (use cbr1 at ATM endpoints)

2 = rtVBR: real-time variable bit rate (use vbr3rt at ATM endpoints)

3 = nrtVBR: non-real-time variable bit rate (use vbr3nrt at ATM endpoints)

5 = uBR: unspecified bit rate (use ubr at ATM endpoints)

9 = stdABR: available bit rate (use stdabr at ATM endpoints)

mastership

Controls whether this end of a connection is a master or slave endpoint. Enter a number to indicate the mastership of the endpoint as follows:

1 = master

2= slave

cir

Specifies the CIR for the connection.

MPSM-T3E3-155 range—T3: 0-44209688, E3_G832: 0-33920000, and E3_G751: 0-33831000 bps.

MPSM-16-T1E1 range: 0-1984000 bps.

-slave

Identifies the slave endpoint of the connection, in the following format:

slave_nsap_address.vpi.vci

Note This parameter is required when you configure a master endpoint.

-slavepersflag

Controls whether the endpoint is persistent or non-persistent. Enter a number to indicate the endpoint's persistency as follows:

0 = persistent (default)

1 = non-persistent

-eir

Specifies the excess information rate for the connection.

MPSM-T3E3-155 range—T3: 0-44209688, E3_G832: 0-33920000, and E3_G751: 0-33831000 bps.

MPSM-16-T1E1 range: 0-1984000 bps.

-bc

Specifies the Burst Commit size for the connection. Range: 0-2097151 bytes

The default Frame Relay value is 5100, and the default Frame Forwarding value is 10300.

-be

Specifies the Burst Excess size for the connection. Range: 0-2097151 bytes

The default Frame Relay value is 5100, and the default Frame Forwarding value is 10300.

-detag

Enables or disables Discard Enable Tagging on the connection. This parameter enables or disables tagging of the DE bit on ingress frames as the result of the policing mechanism. Enter a number to enable or disable DE Tagging as follows:

1 = enable

2 = disable (default)

-igde

Enables or disables a connection's response to incoming Discard Enable tags. Enter a number to ignore (disable) or accept (enable) incoming DE tags as follows:

1 = enable

2 = disable (default)

-fecnmap

Specifies the mapping between FECN and EFCI for this connection. Enter a number to set the configuration of the FECN map as follows:

1 = mapEFCI

2 = setEFCIzero (default)

-demap

Specifies the mapping between DE and CLP for this connection. Enter a number to set the DE to CLP mapping, as follows:

1 = mapCLP (default)

2 = setCLPzero

3 = setCLPone

-clpmap

Specifies the mapping between CLP and DE for this connection. Enter a number to set the CLP to DE mapping, as follows:

1 = mapDE (default)

2 = setDEzero

3 = setDEone

4 = ignoreCLP

-eqsel

Selects the Egress Queue for this connection. Enter a number to indicate one of the following options:

1 = highPriority

2 = lowPriority

3 = notSupported

The default value depends on the service type.

-ingut

Specifies the Ingress Percent Utilization for this connection. This value controls the bandwidth allocated for the connection and allows you to oversubscribe the network resources. Range: 1-100 percent

Default: 100 percent.

-egut

Specifies Egress Percent Utilization for this connections. This value controls the bandwidth allocated for the connection and allows you to oversubscribe the network resources. Range: 1-100 percent

Default: 100 percent

-egrat

Specifies the Egress Service Rate. This value is used for CAC to determine if the port can support the connection.

MPSM-T3E3-155 range: 0-44209688 bps

MPSM-16-T1E1 range: 0 and 1984000 bps

-rtngprio

Specifies the Routing Priority for this connections, in the range 1-15.

Default: 8

-upc

Enables or disables UPC configuration on the connection. Enter a number to enable/disable UPC configuration on the connection, as follows:

1 = enable (default)

2 = disable

-lpcr

Specifies the Peak Cell Rate for this connection in the local to remote direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-rpcr

Specifies the Peak Cell Rate for this connection in the remote to local direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-lscr

Specifies the Sustainable Cell Rate for this connection in the local to remote direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-rscr

Specifies the Sustainable Cell Rate for this connection in the remote to local direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-lmcr

Specifies the Minimum Cell Rate for available bit rate connections in the local to remote direction.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-rmcr

Specifies the Minimum Cell Rate for available bit rate connections in the remote to local direction.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-prefrte

This option associates a preferred route to the connection. Use this parameter at the master endpoint only. Be sure the route exists before you associate it with the connection because the system does not check it. Enter the dspprefs command at the PXM card to display preferred routes.

The following values are valid:

0: Disassociate a connection from a route (default)

1-65535: The preferred route id

Note Before you delete the route, disassociate all connections from the route; otherwise, a dangling preferred route path remains. Enter the dspcons [-rteid <pref rte id>] command at the PXM card to display all connections associated with a route.

Note An SPVC can be associated with one preferred route. For an XPVC, you can associate the preferred route with only the SPVC portion of the XPVC.

-directrte

Enables or disables a direct route for this connection. When enabled (yes), the preferred route is the only permissible route for this connection. Should the directed preferred route be unavailable, the connection fails. When disabled (no), the connection tries another alternate route if the preferred route is unavailable.

The values are as follows:

1 = yes (make the preferred route required)

0 = no (do not require the connection to take the preferred route)

Default: 0

-rmbs

Specifies the Maximum Burst Size for variable bit rate connections in the remote to local direction. MBS is the maximum number of cells that can burst at the PCR and still be compliant. Range 0-5000000 cells

-cc

Operations, administration, and maintenance continuity check (OAM CC):

1 = enable

0 = disable (default)

Continuity checking invokes a round trip of an OAM cell simply to confirm that both directions of the connection are intact.

To provision continuity checking, enable this function at both ends of the connection; otherwise, a connection alarm results. When you add a connection and include this parameter, the connection goes into alarm until both ends of the connection are added.


Error Messages

The system can display error messages for the following reasons:

Some of the traffic management parameters apply to specific service types (rt-VBR, for example). If you enter a parameter that does not apply to a selected traffic type, the connection is rejected.

Insufficient resources are available to accept the provisioning request.

The type of card does not support a certain feature.

The port cannot support SPVCs.

One of the following error messages appears if one of the preceding causes is true:

"Port does not support requested service Type"

"lscr/lmcr not allowed to exceed lpcr (dcmp)"

"rscr not allowed to exceed rpcr"

"lpcr must be defined for cbr service Type"

"rpcr must be defined for cbr serviceType"

"lpcr and lscr must be defined for vbr service Type"

"rpcr and rscr must be defined for vbr service Type"

"lpcr must be defined for abr/ubr service Type"

"rpcr must be defined for abr/ubr service Type"

"Requested rcdv is too low"

"Requested rctd is too low"

"Requested max cell loss ratio (clr) is too high"

"Requested cell rate (lscr/lpcr) is too high"

"Requested cell rate (rscr/rpcr) is too high"

Syntax (PPP Service Context)

addcon <ifNum> <dlci> <chanType> <serviceType> <mastership> <cir>
[-slave <value>] [-slavepersflag <slavepers>]
[-eir <zeroCirEir>] [-bc <Burst Commit>] [-be <Burst Excess>]
[-detag <DE Tagging Enable>] [-igde <Ignore Incoming DE>]
[-fecnmap <FECN map>] [-demap <DE to CLP map>]
[-clpmap <CLP to DE map>] [-eqsel <Egress Q Select>]
[-ingut <Ingress Perc Util>] [-egut <Egress Perc Util>]
[-egrat <Egress Service Rate>]
[-rtngprio <Routing Priority>] [-upc <UPC Cnfg>]
[-lpcr <local-remote PCR>] [-rpcr <remote-local PCR>]
[-lscr <local-remote SCR>] [-rscr <remote-local SCR>]
[-lmcr <local-remote MCR>] [-rmcr <remote-local MCR>]
[-prefrte <routeId>] [-directrte <yes|no>]
[-rmbs<remote MBS>] [-cc <OAM CC Cnfg>]

Syntax Description (PPP Service Context)

For the applicable parameters, the "local" end is the point at which you are provisioning the connection.

ifNum

Specifies the interface number (bundle number) of the bundle to connect.

MPSM-16-T1E1 range: 1-16

MPSM-T3E3-155 range: 1-84

Note Enter the dspports command to display the bundle number for all active MLPPP bundles.

dlci

Specifies the data-link connection identifier. Use 1000 for RPM-XF connections.

chanType

Specifies the channel type. The following channel type is valid:

5 = frForward: Frame Forwarding

serviceType

Specifies the service type for the connection. Enter a number to indicate one of the following service types:

2 = rtVBR: real-time variable bit rate (use vbr3rt at ATM endpoints)

3 = nrtVBR: non-real-time variable bit rate (use vbr3nrt at ATM endpoints)

mastership

Controls whether this end of a connection is a master or slave endpoint. Only master endpoints are allowed.

1 = master

2 = slave (not supported)

cir

Specifies the CIR for the connection.

MPSM-T3E3-155

T1 range: 0-9216000 bps (6 T1s)

E1 range: 0-11984000 bps (6 E1s)

MPSM-16-T1E1

T1 range: 0-6144000 bps (4 T1s)

E1 range:0-7936000 bps (4 E1s)

-slave

Identifies the slave endpoint of the connection, in the following format:

slave_nsap_address.vpi.vci

Note This parameter is required when you configure a master endpoint, and the MPSM is always the master endpoint.

-slavepersflag

Controls whether the endpoint is persistent or non-persistent. Enter a number to indicate the endpoint's persistency as follows:

0 = persistent (default)

1 = non-persistent

Note This parameter is not applicable to connections to the RPM-XF.

-eir

Specifies the excess information rate for the connection.

MPSM-T3E3-155 range—T3: 0-44209688, E3_G832: 0-33920000, and E3_G751: 0-33831000 bps.

MPSM-16-T1E1 range: 0-1984000 bps.

Note This parameter is not applicable to connections to the RPM-XF.

-bc

Specifies the Burst Commit size for the connection, in the range 0-2097151 bytes.

Note This parameter is not applicable to connections to the RPM-XF.

-be

Specifies the Burst Excess size for the connection, in the range 0-2097151 bytes.

Note This parameter is not applicable to connections to the RPM-XF.

-detag

Enables or disables Discard Enable Tagging on the connection. This parameter enables or disables tagging of the DE bit on ingress frames as the result of the policing mechanism. Enter a number to enable or disable DE Tagging as follows:

1 = enable

2 = disable (default)

Note This parameter is not applicable to connections to the RPM-XF.

-igde

Enables or disables a connection's response to incoming Discard Enable tags. Enter a number to ignore (disable) or accept (enable) incoming DE tags as follows:

1 = enable

2 = disable (default)

Note This parameter is not applicable to connections to the RPM-XF.

-fecnmap

Specifies the mapping between FECN and EFCI for this connection. Enter a number to set the configuration of the FECN map as follows:

1 = mapEFCI

2 = setEFCIzero (default)

Note This parameter is not applicable to connections to the RPM-XF.

-demap

Specifies the mapping between DE and CLP for this connection. Enter a number to set the DE to CLP mapping, as follows:

1 = mapCLP (default)

2 = setCLPzero

3 = setCLPone

Note This parameter is not applicable to connections to the RPM-XF.

-clpmap

Specifies the mapping between CLP and DE for this connection. Enter a number to set the CLP to DE mapping, as follows:

1 = mapDE (default)

2 = setDEzero

3 = setDEone

4 = ignoreCL

Note This parameter is not applicable to connections to the RPM-XF.

-eqsel

Selects the Egress Queue for this connection. Enter a number to indicate one of the following options:

1 = highPriority

2 = lowPriority

3 = notSupported

Note This parameter is not applicable to connections to the RPM-XF.

-ingut

Specifies the Ingress Percent Utilization for this connection. This value controls the bandwidth allocated for the connection and allows you to oversubscribe the network resources. Range: 1-100 percent

Note This parameter is fixed at 100 percent for connections to the RPM-XF.

-egut

Specifies Egress Percent Utilization for this connections. This value controls the bandwidth allocated for the connection and allows you to oversubscribe the network resources. Range: 1-100 percent

Note This parameter is fixed at 100 percent for connections to the RPM-XF.

-egrat

Specifies the Egress Service Rate. This value is used for CAC to determine if the port can support the connection.

MPSM-T3E3-155 range: 0-44209688 bps

MPSM-16-T1E1 range: 2400 and 1984000 bps

Note This parameter is not applicable to connections to the RPM-XF.

-rtngprio

Specifies the Routing Priority for this connections, in the range 1-15.

Default: 8

Note This parameter is not applicable to connections to the RPM-XF.

-upc

Enables or disables UPC configuration on the connection. Enter a number to enable/disable UPC configuration on the connection, as follows:

1 = enable (default)

2 = disable

Note This parameter is not applicable to connections to the RPM-XF.

-lpcr

Specifies the Peak Cell Rate for this connection in the local to remote direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-rpcr

Specifies the Peak Cell Rate for this connection in the remote to local direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-lscr

Specifies the Sustainable Cell Rate for this connection in the local to remote direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-rscr

Specifies the Sustainable Cell Rate for this connection in the remote to local direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps.

-lmcr

Specifies the Minimum Cell Rate for available bit rate connections in the local to remote direction.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

Note This parameter is not applicable to connections to the RPM-XF.

-rmcr

Specifies the Minimum Cell Rate for available bit rate connections in the remote to local direction.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

Note This parameter is not applicable to connections to the RPM-XF.

-prefrte

This option associates a preferred route to the connection. Use this parameter at the master endpoint only. Be sure the route exists before you associate it with the connection because the system does not check it. Enter the dspprefs command at the PXM card to display preferred routes.

The following values are valid:

0: Disassociate a connection from a route (default)

1-65535: The preferred route id

Note Before you delete the route, disassociate all connections from the route; otherwise, a dangling preferred route path remains. Enter the dspcons [-rteid <pref rte id> ] command at the PXM card to display all connections associated with a route.

Note An SPVC can be associated with one preferred route. For an XPVC, you can associate the preferred route with only the SPVC portion of the XPVC.

Note This parameter is not applicable to connections to the RPM-XF.

-directrte

Enables or disables a direct route for this connection. When enabled (yes), the preferred route is the only permissible route for this connection. Should the directed preferred route be unavailable, the connection fails. When disabled (no), the connection tries another alternate route if the preferred route is unavailable.

The values are as follows:

1 = yes (make the preferred route required)

0 = no (do not require the connection to take the preferred route)

Default: 0

Note This parameter is not applicable to connections to the RPM-XF.

-rmbs

Specifies the Maximum Burst Size for variable bit rate connections in the remote to local direction. MBS is the maximum number of cells that can burst at the PCR and still be compliant. Range 0-5000000 cells

Note This parameter is not applicable to connections to the RPM-XF.

-cc

Operations, administration, and maintenance continuity check (OAM CC):

1 = enable

0 = disable (default)

Continuity checking invokes a round trip of an OAM cell simply to confirm that both directions of the connection are intact.

Note To provision continuity checking, enable this function at both ends of the connection; otherwise, a connection alarm results. When you add a connection and include this parameter, the connection goes into alarm until both ends of the connection are added.

Note This parameter is not applicable to connections to the RPM-XF.


Related Commands

cnfcon, cnfabr, delcon, dspcon, dspcons, dncon, upcon

Attributes

Log: yes

State: active

Privilege: GROUP1


Example (ATM CLI context)

In the following example, the user adds the slave end of an ATM connection on logical port 5, VPI 100, VCI 100. The connection supports CBR service. Note that the user does not specify any optional parameters, so the defaults are applied to the connection.

M8830_CH.12.MPSM155[ATM].a > addcon 5 100 100 1 2
slave endpoint added successfully
slave endpoint id : 4700918100000000001A5389430000010C180500.100.100

Note The system returns the slave end connection identifier in the hexadecimal NSAP format with the VPI.VCI at the end. When you add the master endpoint of the connection, type -slave followed by this connection identifier.


In the following example, the user adds the master end of the ATM connection on an MPSM-T3E3-155 card in another Cisco MGX 8850 switch. Note that the user does not specify any optional parameters, so the defaults are applied to the connection.

M8850_NY.13.MPSM155[ATM].a > addcon 5 100 100 1 1 -casttype 0 -slave 4700918100000000001A5389430000010C180500.100.100
master endpoint added successfully
master endpoint id : 4700918100000000036B5E31B30000010D180500.100.100

Note Enter the dspcon or dspcons command to verify that connection has been added properly.


Example (Frame Relay Service Context)

In the following example, the user adds the slave end of a Frame Relay connection on logical port 1, DLCI 1000. The channel type is Frame Relay network interworking (frNIW), and it has a high priority service type and a CIR of 20000 bps. This example does not specify any optional parameters, so the defaults are applied to the connection.

M8850_NY.13.MPSM155[FR].a > addcon 1 1000 1 1 2 20000
slave endpoint added successfully
slave endpoint id : 4700918100000000036B5E31B30000010D1FFF00.2048.1000

Note The system returns the slave end connection identifier in the hexadecimal NSAP format with the VPI.VCI at the end. When you add the master endpoint of the connection, type -slave followed by this connection identifier.


In the following example, the user adds the master end of the Frame Relay connection on an MPSM-T3E3-155 card in another Cisco MGX 8850 switch. In this case, the slave endpoint must be specified. This example does not specify any other parameters, so the defaults are applied to the connection.

M8830_CH.12.MPSM155[FR].a > addcon 1 1000 1 1 1 20000 -slave 4700918100000000036B5E31B30000010D1FFF00.2048.1000
master endpoint added successfully
master endpoint id : 4700918100000000036A5E31B30000010D1FFF00.2048.1000

Note Enter the dspcon or dspcons command to verify that the connection has been added properly.


Example (PPP Service Context)

In the following example, the RPM-XF slave connection has previously been added. The slave connection has the following attributes:

NSAP address—47.009181000000000164444B61.000001011802.00

VPI—0

VCI—102

PCR—44433 cps

SCR—44433 cps

The following command adds a vbr-nrt connection from bundle 13 on the MPSM to the RPM-XF slave connection.

M8850_SF.25.MPSM16T1E1PPP[FR].a > addcon 13 1000 5 3 1 5952000 -slave 47009181000000000164444B6100000101180200.0.102 -lscr 44433 -lpcr 44433
master endpoint added successfully

master endpoint id : 47009181000000000164444B61000001191FFF00.24.1000

addimagrp

Add IMA Group

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addimagrp command to create and configure a new IMA Group.

Syntax

addimagrp <group> <version> <minLinks> <txImaId> <txFrameLen> <txclkMode> <diffDelayMax>

Syntax Description

group

The IMA group number.

MPSM-T3E3-155 range: 1-42

MPSM-16-T1E1 range: 1-16

version

The version number of ATM Forum IMA specification.

1 = Version 1.0

2 = Version 1.1

minLinks

The minimum number of links that must be operational before the IMA group is operational.

MPSM-T3E3-155 range: 1-16

MPSM-16-T1E1 range: 1-8

For example, if you create an IMA group of 4 links and specify a minimum number of 3 links, then three of the four specified links must be operational before the IMA group can be used.

txImaId

The IMA ID number transmitted in the IMA ID field of the ICP cell, in the range 0-255.

txFrameLen

The length of transmitted IMA frame in bytes. For IMA version 1.0, the txImaFrameLength value is 128. For version 1.1, the txImaFrameLength value can be 32, 64, 128, or 256.

txclkMode

Specifies the near-end transmit clock mode. Enter a number to indicate the transmit clock mode as follows:

1 = CTC

2 = ITC

Note Option 2 (ITC) is not supported in Release 5 of the MPSM-T3E3-155.

diffDelayMax

The maximum differential delay in milliseconds.

T1 range: 1-275 ms

E1 range: 1-220 ms


Related Commands

delimagrp, dspimagrp, dspimagrps, and cnfimagrp

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the example that follows, the user adds an IMA group with the following values:

Parameter
group
version
minLinks
txImaId
txFrameLen
txclkMode
diffDelayMax

Value

1

2

4

3

64

1

275


MGX8850.11.MPSM[ATM].a > addimagrp 1 2 4 3 64 1 275

addimalnk

Add IMA Link

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addimalnk command to add a T1 or E1 line or path to an IMA group.


Note After you add a line or path to an IMA group, it becomes an IMA link. Only T1 or E1 lines or paths can be IMA links.


Syntax

addimalnk <link> <group>

Syntax Description

link

Identifies the line or path to add to the IMA group:

DS1/E1 line: bay.line

DS1/E1 path:

DS3 line: bay.line:ds1

DS3 payload: bay.line.sts :ds1

VT payload : bay.line.sts:vtg.vt

VT structured payload: bay.line.sts:tug3.vtg.vt

where: bay=1, line=1, sts=0-3, ds1=1-28,
tug3=1-3, vtg=1-7, vt=1-4 (VT15) or 1-3 (VT2)

Note The MPSM-16-T1E1 requires all links in an IMA Group be within lines 1-8 or 9-16. For example, an IMA Group with lines 7,8 and 9 is not valid.

Note Enter the dsplns or dsppaths -all command to display all available lines or paths on the card.

group

Specifies the IMA group number.

MPSM-T3E3-155 range: 1-42

MPSM-16-T1E1 range: 1-16

Note Enter the dspimagrps command to display the all active IMA groups on the current card. You must be in the ATM service context to view or configure IMA groups.


Related Commands

dspimagrp, cnfimagrp, dspimalnk, delimalnk

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user adds the IMA path 1.1.2:1 to the IMA group 1.

MGX8850.11.MPSM[ATM].a > addimalnk 1.1.2:1 1

addimaport

Add IMA Port

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addimaport command to create and configure a new IMA virtual interface (ifnum) for the specified IMA group.

Syntax

addimaport <ifNum> <group> <guaranteedRate> <maxRate> <sctID> <ifType> [-vpi vpi] [-minvpi minvpi] [-maxvpi maxvpi]

Syntax Description

ifNum

Specifies an interface number (port number) for the port you are adding.

MPSM-16-T1E1 range: 4-499

MPSM-T3E3-155 range: 4-1003

Note Port numbers 1 through 3 are reserved for broadband Frame Relay ports.

group

The number of the IMA group to which you want to add an IMA port.

Note Enter the dspimagrps command to display the all active IMA groups on the current card.

guaranteedRate

The guaranteed minimum bandwidth rate in cells per second.

Range for T1: 50 to N * (3622 * (M-1)/M * 2048/2049)

Range for E1: 50 to N * (4528 * (M-1)/M * 2048/2049)

N = the number of IMA links in the IMA group
M = the IMA group frame length

Note The guaranteed rate and max rate settings must be the same.

maxRate

The maximum bandwidth rate for the IMA port in cells per second. See guaranteedRate.

Note The guaranteed rate and max rate settings must be the same.

sctID

The ID number of the port SCT file on the PXM disk, in the range from 0-255.

Defaul:0.

ifType

Specifies the port as one of the following types of interfaces:

1 = UNI (User-to-Network Interface)

2 = NNI (Network-to-Network Interface)

3 = VNNI (Virtual Network-to-Network Interface)

4 = VUNI (Virtual User-to-Network Interface)

5 = EVUNI (Enhanced Virtual User-to-Network Interface)

6 = EVNNI (Enhanced Virtual Network-to-Network Interface)

EVNNI and EVUNI permit a range of VPIs for a single interface, and this range of VPIs represents the virtual NNI or virtual UNI trunk. VNNI and VUNI allow only one VPI for a single interface, and that VPI represents the virtual NNI or virtual UNI trunk. Multiple VNNIs and EVNNIs can coexist on the same line.

-vpi

Virtual Path Identifier for a VNNI or VUNI interface:

VNNI range: 1-4095

VUNI range: 1-255

-minvpi

The minimum VPI for an EVUNI or EVNNI interface:

EVUNI range: 0-255

EVNNI range: 0-4095

-maxvpi

The maximum VPI for an EVUNI or EVNNI interface:

EVUNI range: 0-255

EVNNI range: 0-4095


Related Commands

dspport, dspports, delport, cnfport

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the example that follows, the user adds port 32 to IMA group 2 with the following values:

Parameter
ifNum
group
guaranteedRate
maxRate
sctID
ifType

Value

32

1

10000

10000

1

2


MGX8850.2.MPSM155[ATM].a> addimaport 32 1 10000 10000 1 2

addlnloop

Add Line Loop

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addlnloop command to place a line in loopback mode. For additional information about loopbacks supported by the MPSM card, see Chapter 6, "Card Management on MPSM-T3E3-155 and MPSM-16-T1E1."


Note Before changing from one loopback mode to another, you must first delete the existing loopback by executing dellnloop or addlnloop with the no loopback parameter.


Syntax

addlnloop {-ds3 | -e3 | -sonet | -ds1 | -e1} <bay.line> <-lpb loopback type>

Syntax Description

-ds3 | -e3 | -sonet | -ds1 | -e1

Select the keyword that corresponds the line type.

Note For MPSM-T3E3-155 cards, the keyword -ds3 applies to both DS3 and E3 line types.

bay.line

Identifies the line that you want to place in local loopback mode, in the format bay.line.

Note Enter the dsplns command to display the line numbers for all lines on the current card.

-lpb

Specifies the loopback type to apply.

1 = No loopback

2 = Local loopback

3 = Remote loopback


Attributes

Log: yes

State: active

Privilege: GROUP1


Related Commands

dellnloop

Example

In the following example, the user places DS3 line 1.1 in the local loopback state.

MGX8850.1.11.MPSM[ATM].a > addlnloop -ds3 1.1 -lpb 2

addmfrbundle

Add Multi-link Frame Relay Bundle

Service Context—Frame Relay

Modules—MPSM-T3E3-155

Enter the addmfrbundle command to add an MFR bundle.

Syntax

addmfrbundle <bundleNum> <activationClass>

Syntax Description

bundleNum

Bundle Number, in the range 1-42

activationClass

Bundle activation class:

1 = Class A—At least one bundle links must be operational for the MFR Bundle to be operational

2 = Class B—All the bundle links must be operational for the MFR Bundle to be operational

3 = Class C—Configured number of bundle links must be operational for the MFR Bundle to be operational.


Attributes

Log: yes

State: active

Privilege: GROUP1


Related Commands

cnfmfrbundle, delmfrbundle, dspmfrbundle

Example

In the following example, the user adds MFR bundle number 5 with Class A activation.

M8850_SF.10.MPSM155[FR].a > addfmrbundle 3 1


Note Adding a bundle does not automatically create an MFR port for the bundle. Add the MFR port using the addmfrport command.


addmfrlnk

Add Multi-link Frame Relay Link

Service Context—Frame Relay

Modules—MPSM-T3E3-155

Enter the addmfrlnk command to add links to an MFR bundle.

Syntax

addmfrlnk <link> <bundleNum>

Syntax Description

link

Specifies a DS1 or E1 path:

DS3 payload: bay.line.sts:ds1

VT payload: bay.line.sts:vtg.vt

VT structured: bay.line.sts:tug3.vtg.vt

where: bay=1, line=1-3, sts=0-3, ds1=1-28,
tug3=1-3, vtg=1-7, vt=1-4 (VT15) or 1-3 (VT2)

Note Enter the dsppaths -all command to display all available paths on the card.

bundleNum

Bundle number, in the range 1-42

Note Enter the dspmfrbundles command to display all bundles on the card.


Attributes

Log: yes

State: active

Privilege: GROUP1


Related Commands

cnfmfrlnk, dspmfrlnk, delmfrlnk, dspmfrbundles

Example

In the following example, the user adds DS1 link 1.1:11 to bundle 3.

M8850_SF.10.MPSM155[FR].a > addmfrlnk 1.1:11 3

addmfrport

Add Multi-link Frame Relay Port

Service Context—Frame Relay

Modules—MPSM-T3E3-155

Enter the addmfrport command to add and configure a port for an MFR bundle.

Syntax

addmfrport <ifNum> <bundle> <portType> <sct>
[-rat <rat>] [-oversub <oversub>]
[-lmiSig <lmiSigType> ] [-asynUpdt <updateType>]
[-elmi <elmiState>] [-segLmi <segLmiStatus>]
[-t391 <t391Value>] [-t392 <t392Value>]
[-n391 <n391Value>] [-n392 <n392Value>] [-n393 <n393Value>]

Syntax Description

ifNum

A number for the port, in the range 1-1003.

bundleNum

The MFR bundle number, in the range 1-42.

Note Enter the dspmfrbundles command to display all MFR bundles on the card.

portType

Type of logical interface (port):

1 = Frame Relay Service

3 = Frame Forward (Not applicable for MFR bundles)

sct

The Service class template (SCT) for the port, in the range 0-255.

Default: 0

Note The port SCT file must exist and be registered on the PXM disk before it is available for use. Enter the PXM dspscts command to view all registered SCT files on the PXM card.

-rat

The egress service ratio of the high priority and the low priority queues, in the range 0-15.

Enter 0 to indicate that no service ratio is configured. In this case, bandwidth is allocated to both the high priority and the low priority queues on demand, which means that traffic is dynamically allocated on a first-come, first-serve basis.

The default setting is 1. In this case, the traffic of the CBR and rt-VBR service categories is allocated to the high priority queue, while the traffic of the nrt-VBR, ABR, and UBR service categories is allocated to the low priority queue.

-oversub

Oversubscription control:

1 = enable

2 = disable (default)

-lmiSig

LMI signaling protocol type:

2 = No Signaling (default)

3 = StrataLMI

4 = AnnexAUNI

5= AnnexDUNI

6 = AnnexANNI

7 = AnnexDNNI

Note When LMI is configured, the maximum number of connections per port for Strata LMI port is 560 and for Annex A/D UNI/NNI port is 898.

-asynUpdt

Enables or disables asynchronous updates. Asynchronous updates are an extension to the LMI protocol that notify the user immediately of changes in PVC and Multicast status. Before enabling this feature, make sure that any DTE equipment you are connected to supports asynchronous updates from the network.

Asynchronous update control:

1 = Disable both Asynchronous Status Updates and Unsolicited Full Status (default)

2 = Enable Asynchronous Status Updates

3 = Enable Unsolicited Full Status

4 = Enable Asynchronous Status Updates and Unsolicited Full Status

-elmi

Enable or disable enhanced LMI. Enhanced LMI enables the automatic exchange of Frame Relay QoS parameter information between the DTE and DCE. When enabled on both the DTE and the MPSM port, this allows the DTE device to learn QoS parameters from the frame relay port and use them for traffic shaping, configuration, or management purposes.

1 = enable

2 = disable (default)

-segLmi

Segmented LMI control:

1 = enable

2 = disable (default)

-t391

T391 timer. This is the Link Integrity Verification polling timer. The user (DTE) sends Status Enquiry messages to the network (DCE) every T391 seconds. An error is recorded if a Status message is not received within T391 seconds. The T391 counter always applies to the user equipment. It applies to the user and network if NNI bi-directional polling is present. Range 5-30. Default: 10

-t392

T392 timer. This is the Polling Verification timer. The network (DCE) expects Status Enquiry messages from the user (DTE) every T392 seconds. If the network does not receive a Status Enquiry message from the user within T392 seconds and the timer expires, then the network records a missing Status Enquiry message by incrementing the N392 counter. This timer value must be set greater than the T391 timer. The T392 timer always applies to the network. It applies to the network and user if NNI bi-directional polling is present. Range 5-30. Default: 15

-n391

N391 counter. This setting establishes the Full Status (status of all PVCs) polling cycle. The user (DTE) sends a Full Report Status Enquiry to the network (DCE) every N391 polls. The N391 counter always applies to the user equipment. It applies to the user and network if NNI bi-directional polling is present. Range 1- 255. Default: 6

-n392

N392 counter. This setting specifies the UNI/NNI error threshold. This is the number of errors during N393 events that will cause an error condition. This counter should be less than or equal to the N393 counter. This counter can apply to both the user (DTE) and the network (DCE). Range 1-10. Default: 3

-n393

N393 counter. This setting is the monitored UNI/NNI events count, which must be greater than the N392 counter. N392 errors during N393 events will cause an error condition. If the N393 counter is set to a value much less than the N391 counter, the port could go in and out of an error condition without notification to either the user equipment or the network. This counter can apply to both the user (DTE) and the network (DCE). The value of this parameter should be greater than that for the -n392 parameter. Range: 1-10. Default: 4


Attributes

Log: yes

State: active

Privilege: GROUP1


Related Commands

cnfport, delport, dspport

Example

In the following example, the user adds a port for MFR bundle 3, specifying Frame Relay Service and the default service class template.

M8850_SF.10.MPSM155[FR].a > addmfrport 111 3 1 0

addmpbundle

Add an MLPPP Bundle

Service Context—PPP

Modules—MPSM-16-T1E1, MPSM-T3E3-155

Enter the addmpbundle command to add an MLPPP bundle.

Syntax

addmpbundle <bundleNumber> [-mrru <value>] [-endDisc <value>]

Syntax Description

bundleNumber

A number that identifies the new bundle.

MPSM-16-T1E1 range: 1-16

MPSM-T3E3-155 range: 1-84

-mrru

Specifies the Max Received Reconstructed Unit (MRRU), in the range 64 - 1524. The default is 1524.

After the user adds a link to an MLPPP bundle, the MRRU is sent to the remote end, which notifies the remote end that this link is capable of receiving MLPPP packets.

-endDisc

Describes the bundle endpoint. The value is null terminated string that contains printable ASCII characters, which include A-Z, a-z, and 0-9. Maximum length: 20 characters. The default value is a description of the format Node-Name.SlotNumber.BundleNumber.


Attributes

Log: yes

State: active

Privilege: GROUP1


Related Commands

cnfmpbundle, delmpbundle, dspmpbundle, dspmpbundles

Example

In the following example, the user adds MLPPP bundle 5.

M8850_SF.27.MPSM16T1E1PPP[FR].a > addmpbundle 5

addpart

Add Resource Partition

Service Context—ATM and Frame Relay

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addpart command to add a resource partition. Before you add a partition, be sure you have a plan for future developments, such as the addition of a new controller.

For detailed information about adding resource partitions on ATM ports, see the "Partitioning Port Resources on the PNNI Controller" section in Chapter 3, "Provisioning ATM Services on MPSM-T3E3-155 and MPSM-16-T1E1."

For detailed information about adding resource partitions on Frame Relay ports, see the "Partitioning Port Resources Between Controllers" section in Chapter 4, "Provisioning Frame Relay Services on MPSM-T3E3-155 and MPSM-16-T1E1."


Note The addpart and addrscprtn commands are identical. The command name "addrscprtn" is consistent with the corresponding command in Release 1 of the MGX 8850 node. Use the command name that you prefer. The same situation applies to commands that display and delete a resource partition.



Note A resource partition is automatically added when you add an ATM or Frame Relay port with the addport, addmfrport, or addimaport command. Enter the cnfpart command to change the configuration of the resource partition, or enter the addpart command to create additional resource partitions for a port.


Syntax (ATM Service Context)

addpart <if_num> <part_id> <ctrlr_id> <egrminbw> <egrmaxbw> <ingminbw> <ingmaxbw> <min_vpi> <max_vpi> <min_vci> <max_vci> <minConns> <maxConns>

Syntax Description (ATM Service Context)

if_num

The interface number (partition number) of the partition to add.

MPSM-16-T1E1 range: 4-499

MPSM-T3E3-155 range: 4-1003

Note Enter the dspparts command in the ATM CLI context to see all active ATM partitions.

part_id

A number that identifies the partition you are adding, in the range 1-20.

Note The same partition id must be used for all interfaces with the same controller.

ctrlr_id

Specifies a network controller protocol. Enter 2 to specify the PNNI controller.

Note Release 5 of the MPSM-T3E3-155 supports the PNNI controller (option 2) only. Options 1 (TAG switching) and 3 (MPLS) are not supported on the MPSM-T3E3-155 card.

egrminbw

A guaranteed percentage of egress bandwidth. Each unit of egrminbw is 0.0001 percent of the total bandwidth on the port. (An egrMinBw of 1000000 = 100%.) These small increments provide a high level of granularity.

egrmaxbw

A maximum percentage of egress bandwidth. Each unit of egrmaxbw is 0.0001 percent of the total bandwidth available to the port. (An egrMaxBw of 1000000 = 100%.) The minimum bandwidth must be at least 50 cps.

ingminbw

A guaranteed percentage of the ingress bandwidth. Each unit of ingminbw is 0.0001 percent of the total bandwidth available to a port. (An ingMinBw of 1000000 = 100%.)

ingmaxbw

A maximum percentage of the ingress bandwidth. Each increment of ingmaxbw is 0.0001 percent of the total bandwidth on the port. (An ingMaxBw of 100000000 = 100%.) The maximum ingress bandwidth must be at least 50 cps.

min_vpi

Minimum VPI for the partition:

UNI range 0-255

NNI or VNNI range: 0-4095

max_vpi

Maximum VPI for the partition

UNI range 0-255

NNI or VNNI range: 0-4095

The max_vpi cannot be less than the min_vpi.

min_vci

Minimum VCI, in the range from 1-65535

max_vci

Maximum VCI, in the range from 1-65535

The max_vci cannot be less than the min_vci.

minConns

Guaranteed number of connections. Value: 0 only

maxConns

A maximum number of connections, in the range 10-2000.


Syntax (Frame Relay Service Context)

addpart <ifNum> <ctrlNum> <ctlrId> <lcns> <dlcilow> <dlcihigh> <ibw> <ebw>

Syntax Description (Frame Relay Service Context)

if_num

Specifies the interface number (partition number) of the partition to add.

MPSM-16-T1E1 range: 1-499

MPSM-T3E3-155 range: 1-1003

Note Enter the dspparts command in the Frame Relay CLI context to see all active partitions.

ctrlNum

Specifies a controller protocol. Enter 2 to specify the PNNI controller.

Note Release 5 of the MPSM-T3E3-155 supports the PNNI controller (option 2) only. Options 1 (TAG switching) and 3 (MPLS) are not supported on the MPSM-T3E3-155 card.

ctrlr_id

Controller ID number, in the range 1-255.

lcns

Maximum number of connections.

MPSM-16-T1E1 range: 0-2000

MPSM-T3E3-155 range: 0-4000

dlcilow

Minimum DLCI value.

2-byte header range: 0-1023.

4-byte header range: 0-8355840, in multiples of 32768.

For example, you can enter one of the following numbers as the minimum DLCI value, or any other number that is a multiple of 32768:
0 = (0 x 32768)
163840 = (5 x 32768)
8355840 = (255 x 32768)

Unless your provisioning plan calls for a specific range of DLCI values on a port or card, specify the minimum DLCI value as 0.

dlcihigh

Maximum DLCI value.

2-byte header range: 0-1023.

4-byte header range: 32767-8355840, in multiples of 32768, minus 1.

For example, you can enter one of the following numbers as the maximum DLCI value, or any other number that is a multiple of 32768 minus l:
32767 = (32768 * 1)-1
163839 = (32768 * 5)-1
6520831 = (32768 * 199)-1

Unless your provisioning plan calls for a specific range of DLCI value on a port or card, specify the maximum DLCI value as 8388607.

inbw

Maximum ingress port bandwidth percentage for the controller type specified with the ctrlrNum argument, in the range 0-100 percent.

ebw

Maximum egress port bandwidth percentage for the controller type specified with the ctrlrNum argument, in the range 0-100 percent.


Related Commands

cnfpart, delpart, dspparts, dsppart

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

The addport and addmfrport commands automatically create a partition for the port. Enter the cnfpart command to change the automatically-created partitions.

addport

Add Port

Service Context—ATM and Frame Relay

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addport command to create and configure a logical port on an active physical line or logical path.

On a BNC-3-T3 or BNC-3-E3 back card, you can add a port on a physical line, or on a path. On an SFP-2-155 and the SMB-2-155-EL OC3 back card, you can add a port on a path only.

A line or path must be configured and brought up before you can add a port. See the description of the upln command to bring up a line, or see the description of the uppath command to bring up a path.


Note The MPSM-T3E3-155 card supports up to 128 ATM ports and 1000 Frame Relay ports. The maximum number of logical ports for the entire MPSM-T3E3-155 is 1000. For example, you can configure 8 72 Frame Relay ports and 128 ATM ports on a single MPSM-T3E3-155 card.



Note If you are going to use card statistics, you must use cnfcdstat before you add logical ports with the addport command. You cannot configure card statistics after adding ports.



Note Frame Relay ports are not supported on STS-3 paths.


Syntax (ATM Service Context)

addport <ifNum> <path_num> <guaranteedRate> <maxRate> <sctID> <ifType> [-vpi <vpi>] [-minvpi <minvpi>] [-maxvpi <maxvpi>]

Syntax Description (ATM Service Context)

ifNum

Specifies an interface number (port number) for the port you are adding.

MPSM-16-T1E1 range: 4-499

MPSM-T3E3-155 range: 4-1003

Note Port numbers 1 through 3 are reserved for broadband Frame Relay ports.

path_num

Identifies the line or path on which to add an ATM port:

DS1/E1 or DS3/E3 line: bay.line

STS path: bay.line.sts

DS3/E3/VT path:

DS3 payload: bay.line.sts

VT structured payload: bay.line.sts:tug3

DS1/E1 path:

DS3 line: bay.line:ds1

DS3 payload: bay.line.sts :ds1

VT payload : bay.line.sts:vtg.vt

VT structured payload: bay.line.sts:tug3.vtg.vt

where: bay=1, line=1, sts=0-3, ds1=1-28,
tug3=1-3, vtg=1-7, vt=1-4 (VT15) or 1-3 (VT2)

Note Enter the dsplns or dsppaths -all command to display all available line or path identifiers on the card.

Note On a BNC-3-T3 or BNC-3-E3 back card, you can add a port on a physical line, or a path on the line. On an SFP-2-155 and the SMB-2-155-EL OC3 back card, you can add a port on a path only.

guaranteedRate

Specifies the guaranteed rate on a port in cells per second. The guaranteed rate can be either max cell rate of the interface, or a multiple of 50.

The total guaranteed rates cannot exceed the highest value in the following ranges:

MPSM-T3E3-155 ranges:

OC3—50 through 353207 cps

STS1—50 through 114113 cps

DS3—between 50 and 96000(PLCP) or 104268(ADM)

E3—50 and 80000

E1—between 50 and 4528 cps

DS1—between 50 and 3622 cps

MPSM-T3E3-155 and MPSM-16-T1E1 ranges:

E1—between 50 and 4528 cps

DS1—between 50 and 3622 cps

Note For all interface types (UNI, NNI, VNNI, EVNNI, and EVUNI), the guaranteedRate must be the same as maxrate.

maxRate

Specifies the maximum rate on a logical port in cells/second. For all interface types (UNI, NNI, VNNI, EVNNI, and EVUNI), maxrate must be the same as guaranteedRate. See guaranteedRate.

sctID

The ID of a service class template (SCT) for the port. The range is 0-255. The SCT file must exist on the PXM disk. See cnfcdsct.

Note Currently, the system does not support certain parameters in the service class templates (SCTs). These parameters are (when applicable) PCR, SCR, and ICR. You can specify them through addcon, cnfcon, or Cisco WAN Manager.

ifType

Specifies the port as one of the following types of interfaces:

1 = UNI (User-to-Network Interface)

2 = NNI (Network-to-Network Interface)

3 = VNNI (Virtual Network-to-Network Interface)

4 = VUNI (Virtual User-to-Network Interface)

5 = EVUNI (Enhanced Virtual User-to-Network Interface)

6 = EVNNI (Enhanced Virtual Network-to-Network Interface)

EVNNI and EVUNI permit a range of VPIs for a single interface, and this range of VPIs represents the virtual NNI or virtual UNI trunk. VNNI and VUNI allow only one VPI for a single interface, and that VPI represents the virtual NNI or virtual UNI trunk. Multiple VNNIs and EVNNIs can coexist on the same line.

-vpi

Virtual Path Identifier for a VNNI or VUNI interface:

VNNI range: 1-4095

VUNI range: 1-255

-minvpi

The minimum VPI for an EVUNI or EVNNI interface:

EVUNI range: 0-255

EVNNI range: 0-4095

-maxvpi

The maximum VPI for an EVUNI or EVNNI interface:

EVUNI range: 0-255

EVNNI range: 0-4095


Syntax (Frame Relay Service Context)

addport <ifNum<path> <portType<sctId>
[-dlciLen <dlciLen>] [-flags <portFlagsBetweenFrames>] [-rat <PortEqueueServiceRatio>] [-csum <checksum>] [-oversub <overSubscribeEnable>] [-lmiSig <lmiSigType>]
[-asynUpdt <updateType>] [-elmi <elmiState>] [-segLmi <segLmiStatus>]
[-t391 <t391Value>] [-t392 <t392Value>] [-n391 <n391Value>]
[-n392 <n392Value>] [-n393 <n393Value>]
[-ds0speed <ds0speed>] [-ds0beg <ds0beg>] [-ds0num <ds0num>]
[-fragEnable <fragEnable>] [-fragSize <fragSize>] [-hdlcinv <hdlcinv>]

Syntax Description (Frame Relay Service Context)

ifNum

Specifies the interface number (port number) of the port you are adding.

MPSM-16-T1E1 range: 1-499

MPSM-T3E3-155 range: 1-1003

Note Port numbers 1 through 3 are reserved for broadband Frame Relay ports.

path_num

Identifies the line or path on which to add a frame relay port:

DS1/E1 or DS3/E3 line: bay.line

STS path: bay.line.sts

DS3/E3/VT path:

DS3 payload: bay.line.sts

VT structured payload: bay.line.sts:tug3

DS1/E1 path:

DS3 line: bay.line:ds1

DS3 payload: bay.line.sts :ds1

VT payload : bay.line.sts:vtg.vt

VT structured payload: bay.line.sts:tug3.vtg.vt

where: bay=1, line=1, sts=0-3, ds1=1-28,
tug3=1-3, vtg=1-7, vt=1-4 (VT15) or 1-3 (VT2)

Note Enter the dsplns or dsppaths -all command to display all available line or path identifiers on the card.

Note On a BNC-3-T3 or BNC-3-E3 back card, you can add a port on a physical line, or on a path. On an SFP-2-155 and the SMB-2-155-EL OC3 back card, you can add a port on a path only.

portType

Specifies the type of port:

1 = Frame Relay Service

3 = Frame Forward

sctId

Specifies the number of the Service class template (SCT) for the port:

Range: 0-255

Default: 0

-dlciLen

Specifies the DLCI header length:

1 = Two-byte DLCI header

2 = Four-byte DLC header (Broadband Frame Relay ports only)

-flags

Specifies the flags between frames:

1 = 1 flag

2 = 2 flags

3 = 4 flags

4 = 8 flags

5 = 16 flags

6 = 32 flags

7 = 64 flags

8 = 128 flags

-rat

This keyword and argument defines the egress service ratio between the high priority and the low priority queues.

Enter the keyword followed by a number that indicates the egress service ratio, in the range from 1 to 15.

Enter 1 to indicate that no service ratio is configured. In this case, bandwidth is allocated to both the high priority and the low priority queues on demand, which means that traffic is dynamically allocated on a first-come, first-serve basis.

The default setting is 1. In this case, the traffic of the CBR and rt-VBR service categories is allocated to the high priority queue, while the traffic of the nrt-VBR, ABR, and UBR service categories is allocated to the low priority queue.

-csum

Checksum type indicator:

1 = crc16

2 = crc32

-oversub

Oversubscription indicator:

1 = enable

2 = disable

-lmiSig

LMI signaling type indicator:

2 = No Signaling

3 = StrataLMI

4 = AnnexAUNI

5 = AnnexDUNI

6 = AnnexANNI

7 = AnnexDNNI

-asynUpdt

Enables or disables asynchronous updates. Asynchronous updates are an extension to the LMI protocol that notify the user immediately of changes in PVC and Multicast status. Before enabling this feature, make sure that any DTE equipment you are connected to supports asynchronous updates from the network.

Asynchronous update control:

1 = Disable both Asynchronous Status Updates and Unsolicited Full Status

2 = Enable Asynchronous Status Updates

3 = Enable Unsolicited Full Status

4 = Enable Asynchronous Status Updates and Unsolicited Full Status

-elmi

Enable or disable enhanced LMI. Enhanced LMI enables the automatic exchange of Frame Relay QoS parameter information between the DTE and DCE. When enabled on both the DTE and the MPSM port, this allows the DTE device to learn QoS parameters from the frame relay port and use them for traffic shaping, configuration, or management purposes. Enter a number to enable/disable enhanced LMI on the port.

1 = enable

2 = disable

-segLmi

Segmented LMI control:

1 = enable

2 = disable

-t391

T391 timer. This is the Link Integrity Verification polling timer. The user (DTE) sends Status Enquiry messages to the network (DCE) every T391 seconds. An error is recorded if a Status message is not received within T391 seconds. The T391 counter always applies to the user equipment. It applies to the user and network if NNI bi-directional polling is present. Range 5-30.

-t392

T392 timer. This is the Polling Verification timer. The network (DCE) expects Status Enquiry messages from the user (DTE) every T392 seconds. If the network does not receive a Status Enquiry message from the user within T392 seconds and the timer expires, then the network records a missing Status Enquiry message by incrementing the N392 counter. This timer value must be set greater than the T391 timer. The T392 timer always applies to the network. It applies to the network and user if NNI bi-directional polling is present. Range 5-30.

-n391

N391 counter. This setting establishes the Full Status (status of all PVCs) polling cycle. The user (DTE) sends a Full Report Status Enquiry to the network (DCE) every N391 polls. The N391 counter always applies to the user equipment. It applies to the user and network if NNI bi-directional polling is present. Range 1- 255. Default: 6

-n392

N392 counter. This setting specifies the UNI/NNI error threshold. This is the number of errors during N393 events that will cause an error condition. This counter should be less than or equal to the N393 counter. This counter can apply to both the user (DTE) and the network (DCE). Range 1-10.

-n393

N393 counter. This setting is the monitored UNI/NNI events count, which must be greater than the N392 counter. N392 errors during N393 events will cause an error condition. If the N393 counter is set to a value much less than the N391 counter, the port could go in and out of an error condition without notification to either the user equipment or the network. This counter can apply to both the user (DTE) and the network (DCE). The value of this parameter should be greater than that for the -n392 parameter. Range: 1-10.

-ds0speed

Specifies the speed of the DS0 channel:

1 = 56 Kbps

2 = 64 Kbps.

-ds0beg

Specifies the beginning DS0 number:

T1 paths: 1- 24

E1MF and E1CRCMF paths: 2-16, 18-32 (17 is reserved)

other E1 paths = 2-32

-ds0num

Specifies the number DS0 time slots that will follow the beginning DS0:

T1 paths: 1- 24

E1MF and E1CRCMF paths: 1-30

other E1 paths: 1-31

-fragEnable

Enables or disables fragmentation on the port.

1 = enable

2 = disable

-fragSize

Specifies the size of the fragments in bytes:

40

64

128

256

512

-hdlcinv

Enables/disables HDLC inversion on the port:

1 = enable

2 = disable


Related Commands

cnfport, delport, dspport, dspports, dspportsct

Attributes

Log: yes

State: active

Privilege: GROUP1


Example —ATM Service Context

In the following example, the user creates logical port 3 on line 3 of bay 1. The minimum and maximum cells per is 96000 cps. The port SCT file ID is 4. The interface type is NNI (specified by the 2 at the end of the command input).

MGX8850.6.MPSM155[ATM].a > addport 3 1.3 96000 96000 4 2

Example —Frame Relay Service Context

In the following example, the user creates logical port 1 on line 1 of bay 1. The port type is Frame Relay (specified by a 1 in the command input). The default SCT (0) is used. The DLCI header length is set to two bytes (specified by a 1 at the end of the command input).

mpsm_node.4.MPSM155[FR].a > addport 1 1.1 1 0 -dlciLen 1

addppplink

Add a link to a MLPPP Bundle

Service Context—PPP

Modules—MPSM-16-T1E1, MPSM-T3E3-155

Enter the addppplink command to add a link to an existing MLPPP bundle. MPSM-16-T1E1 links are T1/E1 lines, and MPSM-T3E3-155 links are channelized T1/E1 paths.

Syntax

addppplink <link> <bay.line> <bundleNumber> [-mru <value>] [-lcpTimeout <msec>]
[-startDS0 <value>] [-numDS0 <value>] [-ds0speed <mode>] [-pfcTx <mode>] [-acfcTx <mode>] [-loopCheck <mode>]

Syntax Description

link

A number for the PPP link.

MPSM-16-T1E1 range: 1-16

MPSM-T3E3-155 range: 1-84

bay.line

The line or path number of the link.

MPSM-16-T1E1 (DS1/E1 line):

bay.line, where bay = 1, line = 1-16.

Note All links on a bundle must be in the same range of lines, either 1-8 or 9-16

MPSM-T3E3-155 (DS1/E1 path):

DS3 line: bay.line:ds1

DS3 payload: bay.line.sts :ds1

VT payload : bay.line.sts:vtg.vt

VT structured payload: bay.line.sts:tug3.vtg.vt

where: bay=1, line=1-3, sts=0-3, ds1=1-28,
tug3=1-3, vtg=1-7, vt=1-4 (VT15) or 1-3 (VT2)

Note Enter the dsplns or dsppaths -all command to display all available lines or paths on the card.

bundleNumber

The MLPPP bundle number to which you are adding a PPP link.

MPSM-16-T1E1 range: 1-16

MPSM-T3E3-155 range: 1-84

Note Enter the dspmpbundles command to display all MLPPP bundles on the card.

-mru

Maximum Receive Unit, in the range 64-1524.

Default:1500

-lcpTimeout

Note The length of time to wait for an echo reply before bringing down LCP. The value is specified in msec, but is rounded down to the nearest 100 msec.

Range: 1000-4294967

Default: 10000 msec

-startDS0

Specifies a starting DS0 for a fractional T1/E1 link, in the following ranges:

T1 line or path: 1 - 24

E1 line or path:

E1 and CRC types: 2 - 32 (timeslot 0 reserved)

MF or CRCMF types: 2 - 16, 18 - 32 (timeslots 0 and 16 reserved)

Note This parameter is required for a fractional T1/E1 link.

-numDS0

Specifies the number of DS0s for a fractional T1/E1 link, in the following ranges:

T1 line or path: 1- 24

E1 line or path:

E1 and CRC types: 1- 31 (timeslot 0 reserved)

MF or CRCMF types: 1 - 30 (timeslots 0 and 16 reserved)

Default: Maximum number of DS0s

Note A fractional T1/E1 link has a contiguous set of DS0s.

-ds0speed

Specifies the speed of DS0 channels.

1 = 56K,

2 = 64K (default)

-pfcTx

Controls the compression of PF in PPP packets transmitted from this end.

1 = enable, PFC is performed if the far end is capable of receiving compressed PF.

2 = disable, PFC is not performed, even if the far end is capable of receiving compressed PF.

Default: 2

-acfcTX

Controls the compression of address/control fields in PPP packets transmitted from this end.

1 = enable, ACFC is performed if the far end is capable of receiving compressed address/control fields.

2 = disable, ACFC is not performed, even if far end is capable of receiving compressed address/control fields.

Default: 2

-loopCheck

Enables or disables loopback check. If loopback check is enabled, when the magic number in the incoming echo reply is the same as of this PPP link, then this PPP link assumes that the far end is in loopback and brings down the LCP session.

1 = enabled (default)

2 = disabled


Attributes

Log: yes

State: active

Privilege: GROUP1


Related Commands

cnfppplink, delppplink, dspppplink

Example

In the following example, the user adds a PPP link 5 to line 1.5 and bundle 5.

M8850_SF.27.MPSM16T1E1PPP[FR].a > addppplink 5 1.5 5

addpppmux

Enable PPPMUX on an MLPPP Bundle

Service Context—PPP

Modules—MPSM-16-T1E1, MPSM-T3E3-155

Enter the addpppmux command to enable a PPPMUX on an MLPPP bundle.

Syntax

addpppmux <bundleNumber> [-pid <value>] [-muxTimer <value>] [-frameLength <value>] [-subFrameLength <value>] [-subFrameCount <value>]

Syntax Description

bundleNumber

Specifies the bundle number to configure for PPPMUX.

MPSM-16-T1E1 range: 1-16

MPSM-T3E3-155 range: 1-84

Note Enter the dspmpbundles command to display all MLPPP bundles on the card.

-pid

Specifies the Default Protocol ID, in the range 0 - 65535

Default: 33 (cUDP).

-muxTimer

Specifies the maximum length of time to wait after the multiplexer operation starts before multiplexing begins.

Values: 0 (disabled) or 64-4000000 microseconds

Default: 600 microseconds

-frameLength

Specifies the maximum length of a multiplexer frame, in the range 1 - 512. Default: 256

-subFrameLength

Specifies the maximum length of a sub-frame, in the range 1 - 512.

Default: 64

-subFrameCount

Specifies the maximum number of sub-frames in a multiplex frame, in the range 2 - 15.

Default: 15


Attributes

Log: yes

State: active

Privilege: GROUP1


Related Commands

cnfpppmux, delpppmux, dsppppmux

Example

In the following example, the user adds PPPMUX to bundle 1.

U4.5.MPSM16T1E1PPP[FR].a > addpppmux 1

addrscprtn

Add Resource Partition

Service Context—ATM and Frame Relay

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the addrscprtn command to add a logical partition of resources for a network controller on a port. Before you add resource partitions, be sure a plan exists for future developments, such as the addition of a new controller.

For detailed information about adding resource partitions on ATM ports, see the "Partitioning Port Resources on the PNNI Controller" section in Chapter 3, "Provisioning ATM Services on MPSM-T3E3-155 and MPSM-16-T1E1."

For detailed information about adding resource partitions on Frame Relay ports, see the "Partitioning Port Resources Between Controllers" section in Chapter 4, "Provisioning Frame Relay Services on MPSM-T3E3-155 and MPSM-16-T1E1."


Note The addpart and addrscprtn commands are identical. Use the command name that suits you. The same identification applies to commands that display and delete a resource partition.



Note A resource partition is automatically added when you add an ATM or Frame Relay port with the addport, addmfrport, or addimaport command. You can use the cnfrscprtn command to change the configuration of the resource partition, and you can use the addrscprtn command to create additional resource partitions for a port.


Syntax (ATM Service Context)

addrscprtn <if_num> <part_id> <ctrlr_id> <egrminbw> <egrmaxbw> <ingminbw> <ingmaxbw> <min_vpi> <max_vpi> <min_vci> <max_vci> <minConns> <maxConns>

Syntax Description (ATM Service Context)

if_num

The interface number (partition number) of the partition to add.

MPSM-16-T1E1 range: 4-499

MPSM-T3E3-155 range: 4-1003

Note Enter the dspparts command in the ATM CLI context to see all active ATM partitions.

part_id

A number that identifies the partition you are adding, in the range 1-20.

Note The same partition id must be used for all interfaces with the same controller.

ctrlr_id

Specifies a network controller protocol. Enter 2 to specify the PNNI controller.

Note Release 5 of the MPSM-T3E3-155 supports the PNNI controller (option 2) only. Options 1 (TAG switching) and 3 (MPLS) are not supported on the MPSM-T3E3-155 card.

egrminbw

A guaranteed percentage of egress bandwidth. Each unit of egrminbw is 0.0001 percent of the total bandwidth on the port. (An egrMinBw of 1000000 = 100%.) These small increments provide a high level of granularity.

egrmaxbw

A maximum percentage of egress bandwidth. Each unit of egrmaxbw is 0.0001 percent of the total bandwidth available to the port. (An egrMaxBw of 1000000 = 100%.) The minimum bandwidth must be at least 50 cps.

ingminbw

A guaranteed percentage of the ingress bandwidth. Each unit of ingminbw is 0.0001 percent of the total bandwidth available to a port. (An ingMinBw of 1000000 = 100%.)

ingmaxbw

A maximum percentage of the ingress bandwidth. Each increment of ingmaxbw is 0.0001 percent of the total bandwidth on the port. (An ingMaxBw of 100000000 = 100%.) The maximum ingress bandwidth must be at least 50 cps.

min_vpi

Minimum VPI for the partition:

UNI range 0-255

NNI or VNNI range: 0-4095

max_vpi

Maximum VPI for the partition

UNI range 0-255

NNI or VNNI range: 0-4095

The max_vpi cannot be less than the min_vpi.

min_vci

Minimum VCI, in the range from 1-65535

max_vci

Maximum VCI, in the range from 1-65535

The max_vci cannot be less than the min_vci.

minConns

Guaranteed number of connections. Value: 0 only

maxConns

A maximum number of connections, in the range 10-2000.


Syntax (Frame Relay Service Context)

addrscprtn <ifNum> <ctrlNum> <ctlrId> <lcns> <dlcilow> <dlcihigh> <ibw> <ebw>

Syntax Description (Frame Relay Service Context)

if_num

Specifies the interface number (partition number) of the partition to add.

MPSM-16-T1E1 range: 1-499

MPSM-T3E3-155 range: 1-1003

Identifies the logical interface to which you want to add a resource partition.

Note Enter the dspparts command in the Frame Relay CLI context to see all active partitions.

ctrlNum

Specifies a network controller protocol. Enter 2 to specify the PNNI controller.

Note Release 5 of the MPSM-T3E3-155 supports the PNNI controller (option 2) only. Options 1 (TAG switching) and 3 (MPLS) are not supported on the MPSM-T3E3-155 card.

ctrlr_id

Controller ID number, in the range 1-255.

lcns

Maximum number of connections.

MPSM-16-T1E1 range: 0-2000

MPSM-T3E3-155 range: 0-4000

dlcilow

Minimum DLCI value.

2-byte header range: 0-1023.

4-byte header range: 0-8355840, in multiples of 32768.

For example, you can enter one of the following numbers as the minimum DLCI value, or any other number that is a multiple of 32768:
0 = (0 x 32768)
163840 = (5 x 32768)
8355840 = (255 x 32768)

Unless your provisioning plan calls for a specific range of DLCI values on a port or card, specify the minimum DLCI value as 0.

dlcihigh

Maximum DLCI value.

2-byte header range: 0-1023.

4-byte header range: 32767-8355840, in multiples of 32768, minus 1.

For example, you can enter one of the following numbers as the maximum DLCI value, or any other number that is a multiple of 32768 minus l:
32767 = (32768 * 1)-1
163839 = (32768 * 5)-1
6520831 = (32768 * 199)-1

Unless your provisioning plan calls for a specific range of DLCI value on a port or card, specify the maximum DLCI value as 8388607.

inbw

Maximum ingress port bandwidth percentage for the controller type specified with the ctrlrNum argument, in the range 0-100 percent.

ebw

Maximum egress port bandwidth percentage for the controller type specified with the ctrlrNum argument, in the range 0-100 percent.


Related Commands

cnfrscprtn, delrscprtn dsprscprtns, dsprscprtn

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

The addport, addimaport, and addmfrport commands automatically create a partition for the port. Enter the cnfpart command to change the automatically-created partitions.

bootchange

Boot Change

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the bootchange command to set the boot IP address and gateway address of the card. The boot IP address is used only when the card boots up.

The only parameters you should enter are "inet on ethernet (e)" and "gateway inet (g)." The bootchange command presents one parameter at a time. Therefore, press the Return (or Enter) key at each prompt except for these two.


Note The boot IP address does not get saved when you enter the saveallcnf on the PXM card.



Note Enter the ipifconfig command at the PXM card to assign IP addresses for the MPSM-T3E3-155 card and the shelf.


Syntax

bootchange

Related Commands

none

Attributes

Log: yes

State: active

Privilege: SERVICE_GP


Example

In the following example the user enters the bootchange command on an MPSM-T3E3-155 card:

M8850_SF.9.MPSM155[FR].a > bootchange ?

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

boot device : lnPci0
processor number : 0
host name : sycwanmvt1
file name : /usr/autoprog/MPSM_155/mpsm155_diag_5_00_02.fw
inet on ethernet (e) : 11.0.100.2
inet on backplane (b):
host inet (h) : 11.0.1.1
gateway inet (g) : 11.0.1.1
user (u) : autoprog
ftp password (pw) (blank = use rsh):
flags (f) : 0x0
target name (tn) : mpsm155
startup script (s) :
other (o) :

bye

Bye

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the bye command to exit the current CLI session.

Syntax

bye

Related Commands

logout, exit

Attributes

Log: yes

State: active, standby, init

Privilege: ANYUSER


Example

In the following example, the user exits the current CLI session.

M8850_NY.13.MPSM155[ATM].a > bye

(session ended)

cc

Change Card

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cc command to change from the current CLI to the CLI of another card. Follow cc with a slot number.

Syntax

cc <slot number>

Syntax Description

slot number

The number of the destination card slot.

Note To dsiplay a list of all cards installed on the current switch, cc to the active PXM card, and then enter the dspcds command.


Related Commands

None

Attributes

Log: yes

State: active, standby, init

Privilege: ANYUSER


Example

In the following example, the user changes from the command line of the MPSM-T3E3-155 in slot 3 to the command line of the PXM in slot 7.

mpsm_node.3.MPSM155[FR].a > cc 7

(session redirected)

mpsm_node.7.PXM.a >

Note If the slot is empty or the card is unreachable, the system displays an applicable message.


ccc

Change Card

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the ccc command to change from the current CLI to the CLI of another card. Follow ccc with a slot number.

Syntax

ccc <slot number>

Syntax Description

slot number

The number of the destination card slot.


Related Commands

None

Attributes

Log: yes

State: active, standby, init

Privilege: ANYUSER


Example

In the following example, the user changes from the command line of the MPSM-T3E3-155 card in slot 13 to a high priority command line session on the AXSM card in slot 1.

M8850_NY.13.MPSM155[FR].a > ccc 1

(ccc session redirected)

_UNKNOWN_.1.AXSM.a >
This is a high priority session.

clradjlnalmcnt

Clear Adjacent Line Alarm Counters

Service Context—ATM and Frame Relay

Modules—MPSM-T3E3-155

Enter the clradjlnalmcnt command to clear the statistical alarms and alarm counters for the adjacent back card. This command applies only when adjacent MPSM-T3E3-155 cards are configured as a redundant pair and when a line on the adjacent card protects a line on the working card (inter-card APS).

Syntax

clradjlnalmcnt <bay.line>

Syntax Description

bay.line

Identifies the line adjacent to the back card whose line alarm counters you want to clear, in the format bay.line. If you enter the <bay.line> of the protection line in an APS configuration, then the working line's alarms counters will be cleared. If you enter the <bay.line> of the working line in an APS configuration, then the protection line's alarms counters will be cleared.

Note Enter the dspapslns command to display the line numbers for the working and protection lines.


Related Commands

dspadjlnalm, dspadjlnalmcnt, dspapslns

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the following example, the user clears the alarm counters on bay 1, line 2 of the adjacent back card.

M8850_NY.13.MPSM155[ATM].a > clradjlnalmcnt 1.2

clrbecnt

Clear Bit Error Count

Service Context—ATM and Frame Relay

Modules—MPSM-T3E3-155

Enter the clrbecnt command to clear the APS-related bit error counters for working and protection line pairs. To display the error counters, enter the dspbecnt command.

Syntax

clrbecnt <working-bay.line>

Syntax Description

working-bay.line

Identifies the bay and the line number, which is always 1.1 for the MPSM-T3E3-155.


Related Commands

dspbecnt

Attributes

Log: no

State: active

Privilege: SERVICE_GP


Example

In the following example, the user clears the APS-related bit error counters for line 1.1 and 1.2 on card 9.

M8850_SF.9.MPSM155[FR].a > clrbecnt 1.2
ERR: Wrong value for Working Line number or APS not configured on the line

M8850_SF.9.MPSM155[FR].a > clrbecnt 1.1
Do you want to clear the bit error count in line 9.1.1 [Y/N]? y

The Count for line 9.1.1 is cleared
Do you want to clear the bit error count in line 9.1.2 [Y/N]? y

The Count for line 9.1.2 is cleared

clrchancnt

Clear Channel Counters

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrchancnt command to clear all statistics counters for ATM cells on a connection (channel). The command applies to an SVC or an SPVC. For a list of displayed counters, see the example of dspchancnt. After you execute clrchancnt, the previous counter contents are unrecoverable.

Syntax (ATM Service Context)

clrchancnt <ifNum> <vpi> <vci>

Syntax Description (ATM Service Context)

ifNum

Interface number (port number) of the channel to clear.

Note Enter the dspcons command in the ATM context to display the interface number, VPI, and VCI for all active ATM channels.

vpi

The VPI for the connection.

vci

The VCI for the connection.


Syntax (Frame Relay Service Context)

clrchancnt <ifNum> <dlci>

Syntax Description (Frame Relay Service Context)

ifNum

Interface number (port number) of the channel to clear.

Note Enter the dspcons command in the Frame Relay context to display the interface number and DLCI for all active channels.

dlci

Data-link Connection Identifier.


Syntax (PPP Service Context)

clrchancnt <ifNum> <dlci>

Syntax Description (PPP Service Context)

ifNum

Specifies the interface number (bundle number) of the bundle statistics to clear.

Note Enter the dspcons command to display the bundle number and DLCI for all active MLPPP channels.

dlci

Data-link Connection Identifier. Value: 1000 only for RPM-XF channels.


Related Commands

clrchancnts, dspchancnt

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example (ATM Service Context)

In the following example, the user clears all the channel counters on an MPSM-T3E3-155 for interface 12, VPI 35, and VCI 120.

M8850_NY.13.MPSM155[ATM].a > clrchancnt 12 35 120

Example (Frame Relay Service Context)

In the following example, the user clears all the channel counters on an MPSM-16-T1E1 for interface 11, DLCI 150.

M8850_SF.27.MPSM16T1E1[FR].a > clrchancnt 11 150

Example (PPP Service Context)

In the following example, the user clears all the channel counters on an MPSM-16-T1E1 for interface 11, DLCI 1000.

M8850_SF.25.MPSM16T1E1PPP[FR].a > clrchancnt 11 1000

clrchancnts

Clear Channel Counters

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrchancnts command to clear the statistics counters on all connections.

Syntax

clrchancnts

Syntax Description

No parameters

Related Commands

dspchancnt, clrchancnt

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the following example, the user clears the statistics counters for all connections.

M8850_SF.10.MPSM155[ATM].a > clrchancnts

clrilmicnt

Clear ILMI Counters

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrilmicnt command to clear the ILMI statistics for a partition and logical interface (port).

Syntax

clrilmicnt <ifNum> <partId>

Syntax Description

ifNum

Specifies the interface number (port number) on which you want to clear ILMI statistics.

Note Enter the dspparts command in the ATM CLI context to display the interface number and partition id for all active ATM ports.

partId

The partition identifier, in the range 1- 20.


Related Commands

dspilmicnt, dspilmi, dspilmis

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Examples

In the following example, the user clears the ILMI statistics for logical interface 10, resource partition 1.

mpsm_node.1.MPSM155[ATM].a > clrilmicnt 10 1
ilmi stats for ifNum 10, partId 1 cleared

clrimadelay

Clear IMA Delay

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrimadelay command to clear the accumulated delay in the signal propagation time for all the links in the specified IMA group. Using this command may improve performance.

Syntax

clrimadelay <group>

Syntax Description

group

The IMA group number.

Note Enter the dspimagrps command to dsiplay a list of all IMA groups on the current card.


Related Commands

None

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user clears the accumulated IMA delay for IMA group 10.

mpsm_node.1.MPSM155[ATM].a > clrimadelay 10

clrimagrpalmcnt

Clear IMA Group Alarm Count

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrimagrpalmcnt command to clear the alarm counters for the specified IMA group.

Syntax

clrimagrpalmcnt <group>

Syntax Description

group

The IMA group number.

Note Enter the dspimagrps command to dsiplay a list of all IMA groups on the current card.


Related Commands

clrimagrpalmcnts, clrimalnkcnts, dspimagrpalmcnt, dspimagrpbucketcnt

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the following example, the user clears the alarm count for IMA group 10.

mpsm_node.1.MPSM155[ATM].a > clrimagrpalmcnt 10

clrimagrpalmcnts

Clear IMA Group Alarm Counters

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrimagrpalmcnts command to clear the alarm counters for all configured IMA groups.

Syntax

clrimagrpalmcnts

Syntax Description

No parameters

Related Commands

clrimagrpalmcnt, dspimagrpalm, dspimagrpalms, dspimagrpalmcnt

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the following example, the user clears the alarm count for all configured IMA groups.

M8850_NY.13.MPSM155[ATM].a > clrimagrpalmcnts

clrimalnkcnt

Clear IMA Link Counters

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrimalnkcnt command to clear the IMA link performance and statistic counters on the specified link.

Syntax

clrimalnkcnt <link>

Syntax Description

link

Identifies the line or path for which to clear counters:

Note Enter the dspimalnks command to dsiplay a list of all links on the current card.


Related Commands

clrimalnkcnts, dspimalnkcnt, dspimalnkalm, dspimalnkalms

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the clears the link identified by the number 1.1.3:1.1.

mpsm_node.1.MPSM155[ATM].a > clrimalnkcnt 1.1.3:1.1

clrimalnkcnts

Clear IMA Alarm Counts

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrimalnkcnts command to clear the link counters for all configured IMA links on the card.

Syntax

clrimalnkcnts

Syntax Description

No parameters

Related Commands

clrimalnkcnt, dspimalnkcnt, dspimalnkalm, dspimalnkalms

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the following example, the user clears the link counters for all configured IMA links.

mpsm_node.1.MPSM155[ATM].a > clrimalnkcnts

clrlnalmcnt

Clear Line Alarm Counters

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrlnalmcnt command to clear the statistical alarms and alarm counters for the specified line.

Syntax

clrlnalmcnt <bay.line>

Syntax Description

bay.line

Identifies the line whose line alarm counters you want to clear, in the format bay.line.

Note Enter the dsplns command to display the line numbers for all lines on the current card.


Related Commands

dsplnalmcnt

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the following example, the user clears the alarm counters for line 1.1.

mpsm_node1.9.MPSM155[ATM].a > clrlnalmcnt 1.1

clrmfrbundlecnt

Clear counts on a Multi-Link Frame Relay Bundle

Service Context—Frame Relay

Modules—MPSM-T3E3-155

Enter the clrmfrbundlecnt command to clear the statistics counters for an MFR bundle.

Syntax

clrlmfrbundlecnt <bundleNumber>

Syntax Description

bundleNumber

Specifies the MFR bundle number.

Note Enter the dspmfrbundles command to display all MFR bundles on the card.


Attributes

Log: yes

State: active

Privilege: any


Related Commands

dspmfrbundlecnt

Example

In the following example, the user clears the counters for bundle 5.

M8850_SF.10.MPSM155[FR].a > clrmfrbundlecnt 5

clrmfrbundlecnts

Clear all counters on a Multi-Link Frame Relay Bundle

Service Context—Frame Relay

Modules—MPSM-T3E3-155

Enter the clrmfrbundlecnts command to clear the statistics counters on all MFR Bundles.

Syntax

clrlmfrbundlecnts

Syntax Description

Attributes

Log: yes

State: active

Privilege: any


Related Commands

dspmfrbundlecnt

Example

In the following example, the user clears all counters for all MFR bundles.

M8850_SF.10.MPSM155[FR].a > clrmfrbundlecnts

clrmfrlnkcnt

Clear Multi-link Frame Relay Counters for a Link

Service Context—Frame Relay

Modules—MPSM-T3E3-155

Enter the clrmfrlnkcnt command to clear the statistics counters for an MFR link.

Syntax

clrmfrlnkcnt <link>

Syntax Description

link

Specifies the MFR link for which to clear statistics.

Enter the dspmfrlnks command to display all MFR links on the card.


Attributes

Log: yes

State: active

Privilege: GROUP1


Related Commands

dspmfrlnkcnt, dspmfrlnks

Example

In the following example, the user clears counters for link 1.1:11.

M8850_SF.10.MPSM155[FR].a > clrmfrlnkcnt 1.1.:11

clrmfrlnkcnts

Clear all Multi-link Frame Relay Link Counts

Service Context—Frame Relay

Modules—MPSM-T3E3-155

Enter the clrmfrlnkcnts command to clear all statistics counters for all MFR links.

Syntax

clrmfrlnkcnts

Attributes

Log: yes

State: active

Privilege: GROUP1


Related Commands

dspmfrlnkcnt

Example

In the following example, the user clears all MFR link counters.

M8850_SF.10.MPSM155[FR].a > clrmfrlnkcnts

clrmpbundlecnt

Clear statistics for an MLPPP Bundle

Service Context—PPP

Modules—MPSM-16-T1E1, MPSM-T3E3-155

Enter the clrmpbundlecnt command to clear the statistics counters for an MLPPP Bundle.

Syntax

clrmpbundlecnt <bundleNumber>

Syntax Description

bundleNumber

Specifies the MLPPP bundle number for which t o clear statistics.

Note Enter the dspmpbundles command to display all MLPPP bundles on the card.


Attributes

Log: yes

State: active

Privilege: any


Related Commands

dspmpbundlecnt

Example

In the following example, the user clears the counters for bundle 5.

M8850_SF.27.MPSM16T1E1PPP[FR].a > clrmpbundlecnt 5

clrmpbundlecnts

Clear all Statistics on a Multi-Link PPP Bundle

Service Context—PPP

Modules—MPSM-16-T1E1

Enter the clrmpbundlecnts command to clear all the statistics counters for all MLPPP bundles.

Syntax

clrlmpbundlecnts

Syntax Description

None.

Attributes

Log: yes

State: active

Privilege: any


Related Commands

addmpbundle

Example

In the following example, the user clears the all MP bundle statistics.

M8850_SF.27.MPSM16T1E1PPP[FR].a > clrmpbundlecnts

clrpathalmcnt

Clear Path Alarm Counters

Service Context—ATM and Frame Relay

Modules—MPSM-T3E3-155

Enter the clrpathalmcnt command to clear all alarm counters on the specified path for the current 15 minute interval.

Syntax

clrpathalmcnt [path_filter] <path_num>

Syntax Description

path_filter

Identifies the path type on which to clear the current alarm counters.

Possible path_filter keywords are:

-sts—Select STS paths in SONET networks, or AU paths in SDH networks.

-vt—Select VT paths in SONET networks, or TU3 paths in SDH networks.

-ds3—Select DS3 paths in SONET and SDH networks.

-e3—Select E3 paths in SONET and SDH networks.

-ds1—Select DS1 paths in SONET and SDH networks.

-e1—Select E1 paths in SONET and SDH networks.

Note STS/STM paths and DS3 paths can have the same path number. If you enter the clrpathalmcnt command without the -path_filter option, and only STS/STM paths are configured on the card, the alarms counters are cleared on the STS/STM path. If there are DS3 paths configured on the card as well as STS/STM paths, and you do not include the -path_filter option with the dnpath command, the alarms counters are cleared on the lowest-level path (the DS3 path). To avoid confusion, Cisco recommends that you specify a -path_filter when you display a path.

path_num

The path for which you want to clear alarm counters.

Note Enter the dsppaths <path_filter> command to display the path numbers for available paths.


Related Commands

dsppathalmcnt

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the following example, the user clears the path alarm counters on the DS1 path 1.1.3:7.4.

mpsm_node.1.MPSM155[ATM].a > clrpathalmcnt -ds1 1.1.3:7.4

clrportcnt

Clear Port Counter

Service Context—ATM and Frame Relay

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrportcnt command to clear the statistics counters on a specific logical port.

Syntax (ATM Service Context)

clrportcnt <ifNum>

Syntax Description (ATM Service Context)

ifNum

Specifies an interface number (port number) for the port for which you are clearing counters.

Note Enter the dspports command to display all ATM port numbers.


Syntax (Frame Relay Service Context)

clrportcnt <ifNum>

Syntax Description (Frame Relay Service Context)

ifNum

Specifies the interface number (port number) of the port you are adding.

MPSM-16-T1E1 range: 1-499

MPSM-T3E3-155 range: 1-1003

Note Enter the dspports command to display all Frame Relay port numbers.


Related Commands

clrportcnts, dspportcnt

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the following example, the clears the counters on port 50.

mpsm_node.5.MPSM155[FR].a > clrportcnt 50

clrportcnts

Clear Port Counters

Service Context—Frame Relay

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrportcnts command to clear all Frame Relay port counters on the current card.

Syntax

clrportcnts

Syntax Description

No parameters

Related Commands

clrportcnt, dspportcnt

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the following example, the user clears all the Frame Relay port counters on the current card.

mpsm_node.5.MPSM155[FR].a > clrportcnts

clrppplnkcnt

Clear statistics for a PPP Link

Service Context—PPP

Modules—MPSM-16-T1E1, MPSM-T3E3-155

Enter the clrppplnkcnt command to clear statistics counters for a PPP link.

Syntax

clrppplnkcnt <link>

Syntax Description

link

Specifies the PPP link number for which to clear statistics.

Note Enter the dspppplinks command to display all PPP links on the card.


Attributes

Log: no

State: active

Privilege: any


Related Commands

dspppplnkcnt

Example

In the following example, the user clears statistics on PPP link 5.

M8850_SF.27.MPSM16T1E1PPP[FR].a > clrppplnkcnt 5

clrpppmuxcnt

Clear PPPMUX statistics for a bundle

Service Context—PPP

Modules—MPSM-16-T1E1, MPSM-T3E3-155

Enter the clrpppmuxcnt command to clear PPPMUX statistics counters for an MLPPP bundle.

Syntax

clrpppmuxcnt <bundleNumber>

Syntax Description

bundleNumber

Specifies the MLPPP bundle for which to clear PPPMUX statistics.

Note Enter the dspmpbundles command to display all MLPPP bundles on the card.


Attributes

Log: yes

State: active

Privilege: any


Related Commands

dsppppmuxcnt

Example

In the following example, the user clears PPPMUX statistics on bundle 5.

M8850_SF.27.MPSM16T1E1PPP[FR].a > clrpppmuxcnt 5

clrsarcnt

Clear Segmentation and Reassembly Counters

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrsarcnt command to clear the segmentation and reassembly (SAR) counters.

Syntax

clrsarcnt

Syntax Description

None.

Related Commands

dspsarcnt

Attributes

Log: yes

State: active, standby, init

Privilege: ANYUSER


Example

In the following example, the user clears the segmentation and reassembly (SAR) counters.

M8850_SF.10.MPSM155[ATM].a > clrsarcnt

clrscrn

Clear Screen

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the clrscrn command to clear the control terminal screen. After this command runs, only the command line prompt appears on the screen.

Syntax

clrscrn

Related Commands

None

Attributes

Log: no

State: active, standby, init

Privilege: ANYUSER


Example

In the following example, the user clears the screen.

mpsm_node.5.MPSM155[FR].a > clrscrn

After the user hits enter, the terminal displays only the current command line prompt, as shown in the following example:

mpsm_node.5.MPSM155[FR].a >

cnfabr

Configure ABR

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfabr command to configure the VS/VD-specific parameters for an existing ABR connection. The connection must be of service type ABR (in the addcon command, service type = 10).

The cards support ABR virtual source and virtual destination (VS/VD). Therefore, it can generate resource management (RM) cells and turn them around.


Note With ABR VS/VD, you can specify parameters but leave the VS/VD service disabled. You can later enable the service and thus activate the previously configured parameters. You can enable VS/VD at the PNNI port level by using the cnfintfvsvd command on the PXM.


Syntax

cnfabr <ifNum> <vpi <vci> [-icr <Initial cell rate>] [-adtf <ACR decr. factor>] [-rdf <Rate decr. factor>] [-rif <Rate incr. factor>] [-nrm <Cells per fwd RM>] [-trm <Time between fwd RMs>] [-cdf <cutoff decrease factor>] [-frtt <fix round trip delay>] [-tbe <transient buffer exposure>]

Syntax Description

ifNum

Specifies the interface number (port number) of the available bit rate (ABR) channel to configure.

Note Enter the dspcons command in the ATM context to display the interface number, VPI, and VCI for all active ATM channels.

vpi

Specifies the connection VPI.

vci

Specifies the connection VCI.

-icr

Initial Cell Rate (ICR) in cells per second. This is the rate at which the source should begin transmitting, and is also the rate at which the source should resume transmitting after an idle period.

MPSM-T3E3-155 range: 10-104268 cells per second

MPSM-16-T1E1 range: 10-36064 cells per second

-adtf

ACR Decrease Time Factor (ADTF). This is the time permitted to decrease the cell rate from the RM-cell rate to the Allowed Cell Rate (ACR) for normal traffic. The range is 1-1023 milliseconds.

-rdf

Rate Decrease Factor (RDF). This is the factor by which to decrease the Allowed Cell Rate (ACR), in the range 1-16. RDF equals 2 raised to the power [Rate decr. factor - 16], which is 1/32768 to 1.

-rif

Rate Increase Factor (RIF). This is the factor by which to increase the Allowed Cell Rate (ACR), in the range 1-16. RIF equals 2 raised to the power [Rate incr. factor - 16], which is 1/32768 to 1.

-nrm

Maximum number of cells that the source can send for each forward RM-cell, in the range 1-8. Nrm equals 2 raised to the power Cells per fwd RM, which is 2-256.

-trm

The maximum number of milliseconds for one RM-cell to travel from source to endpoint, in the range 1-8. Trm equals 100 times 2 raised to the power [Time between fwd RMs - 8], which equals 100 x 2-7 to 100 milliseconds.

-cdf

Cutoff Decrease Factor (CDF), which controls the decrease in Allowed Cell Rate (ACR) associated with Missing RM-cell count (CRM). The range is 1-8, where CDF equals 2 to the power [cutoff decrease factor - 8], which yields values of 1/64 to 1.

CRM limits the number of forward RM-cells that may be sent in the absence of received backward RM-cells. CRM is an integer. Its size is implementation specific.

-frtt

Fixed Round-Trip Time (FRTT), which is the sum of the fixed delays plus the propagation delays from the source to the destination and back. The range is 0-16700000 seconds.

-tbe

Transient Buffer Exposure (TBE), which 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. The range is 0-16,777,215 cells.


Related Commands

addcon, cnfabrtparmdft, dspabrtparmdft, cnfintfvsvd

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user configures the ABR connection 17 on VPI 44, VCI 55 for an ICR of 100 cells per second.

M8850_SF.10.MPSM155[ATM].a > cnfabr 17 44 55 -icr 100

Configuration successful

cnfapsln

Configure APS Line

Service Context—ATM, Frame Relay

Modules—MPSM-T3E3-155

Enter the cnfapsln command to configure the APS parameters for a line (working line). Enter the cnfapsln command after creating the line using the addapsln command.

See the description for the addapsln command for a detailed explanation of Automatic Protection Switching (APS).

Syntax

cnfapsln -w <working line> -sf <SignalFaultBER> -sd <SignalDegradeBER> -wtr <Wait To Restore> -dr <direction> -rv <revertive> -proto <protocol>


Note 1+1AnnexB operational mode is bi-directional, non-revertive, ITU protocol only.



Note If the ArchMode configured by the addapsln command is 1+1-Annex B, only WTR (-wtr), SF BER (-sf), and SD BER (-sd) are configurable with the cnfapsln command.


Syntax Description

-w

Identifies the working line. Enter the slot number, bay number, and line number of the active line to configure, in the format:

slot.bay.line

Note Enter the dspapslns command to display the working line numbers for all lines configured for APS.

-sf

A number between 3 and 5 indicating the Signal Fault Bit Error Rate (BER), in negative powers of ten:

3 = 10-3 (default)

4 = 10-4

5 = 10-5

-sd

A negative power of 10 in the range 5-9 that indicates the Signal Degrade Bit Error Rate (BER):

5 = 10-5 (default)

6 = 10-6

7 = 10-7

8 = 10-8

9 = 10-9

-wtr

The Wait to Restore option configures the number of minutes to wait after the working line has become functional again, before switching back to the working line from the protection line. The range is 1-12. Default: 5

-dr

Specifies the traffic direction to switch:

1 = unidirectional, only the affected path, either receiving or transmitting, is switched

2 = bidirectional, both the receiving and transmitting paths are switched (default)

-rv

Enables revertive behavior:

1 = non-revertive, do not switch the user traffic back to the working line from the protection line after the working line becomes functional again

2 = revertive, switch the user traffic back to the working line from the protection line after the working line becomes functional again (default)

-proto

Specify either Telcordia or ITU protocol:

1 = Bellcore-GR253 (default)

2 = ITU


Related Commands

addapsln, delapsln, dspapsln, dspapslns, switchapsln, dspapsbkplane, dspbecnt

Attributes

Log: yes

State: active

Privilege: SUPER_GP


Example

In the example that follows, the user configures APS on an MPSM-T3E3-155 card with the following parameters:

working line—1.1.1

signal Fault BER—10-3

signal Degrade BER—10-5

wait to Restore— 5 minutes

path switching direction—bi-directional

revertive behavior—revertive enabled

protocol—ITU

mpsm_node.1.MPSM155[ATM].a > cnfapsln -w 1.1.1 -sf 3 -sd 5 -wtr 5 -dr 2 -rv 2-proto 2

cnfatmlayer

Configure ATM Layer

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfatmlayer command to configure payload scrambling on the specified line, path, or IMA group.


Note The NullCellHdr and NullCellPayload of the ATM cell layer are not configurable because of hardware limitations.


Syntax

cnfatmlayer <line/path_id/ima_group> -sps <PayloadScramble>

Syntax Description

line/path_id/ima_group

Specifies the line, path, or IMA group for which you want to configure ATM parameters. The line or path must be configured for ATM service before you can configure the ATM layer.

Note Enter the dsplns, dsppaths, or dspimagrps command in the ATM CLI context to display the lines, paths, or IMA groups configured on the current card.

-sps

Enables or disables payload scramble.

1 = enable

2 = disable


Related Commands

dspatmlayercnt

Attributes

Log: no

State: active

Privilege: GROUP1


Example

In the following example, the user enables payload scrambling on IMA group 10.

mpsm_node.1.MPSM155[ATM].a > cnfatmlayer 10 1

cnfautolndiag

Configure Auto Line Diagnostics

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfautolndiag command to enable or disable auto line diagnostics on the card.

Syntax

cnfautolndiag <enable | disable>

Syntax Description

enable or disable

A keyword that enables or disables suto line diagnostics on the card:

1 = enable

2 = disable (default)


Related Commands

dspautolndiag

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user enables auto line diagnostics.

mpsm_node.1.MPSM155[ATM].a > cnfautolndiag 1

cnfautorestart

Configure Automatic Restart

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfautorestart command to enable or disable the IMA group automatic restart feature for the card. To enable automatic restart for ports, enter the cnfimagrp command. This feature automatically restarts an IMA group if the group operation stops after one of the following service events:

One or more lines placed in loopback at the near or far end

One or more lines inadvertently moved to another switch

The far end IMA group is deleted and re-added

Line changes can halt IMA group operation when the affected lines are the only operational lines in the IMA group.


Note The cnfautorestart <1|2> command is identical to the cnfimaparms -restart <1|2> command.



Note For the IMA automatic restart feature to work properly, the IMA group IDs (addimagrp command) at each end of the IMA connection must be different. If the IMA group IDs are the same, the card can not differentiate between lines that are connected to the remote switch and lines that are in loopback mode.


Syntax

cnfautorestart <1|2>

Syntax Description

1|2

Enables or disables the IMA automatic restart feature.

1 = Enable automatic restart

2 = Disable automatic restart.


Related Commands

cnfimaparms, cnfimagrp, dspautorestart, dspimaparms

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user enables the IMA group automatic restart feature for the card.

M8830_CH.12.MPSM155[ATM].a > cnfautorestart 1

cnfbert

Configure Bit Error Rate Test

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfbert command to configure the BERT (bit error rate test) session for a line, path, or port. The new configuration does not take effect if a BERT test pattern is already running. However, it will take effect if you stop and then start the test again.

The BERT test patterns range from 1-38 and are described in Table 7-13. To determine the test patterns supported on the card, enter the dspbertcap command.

Table 7-13 BERT Test Patterns 

No.
Test Pattern
Description

1

allZeros

all zeroes (..0000..)

2

allOnes

all ones (..1111..)

3

alternateOneZero

alternate ones and zeros (..1010..)

4

doubleAltOnesZeros

double alternate ones and zeros (..1100..)

5

oneIn4

a four bit pattern containing a single 1

6

oneIn8

an eight bit pattern containing a single 1

7

oneIn16

a sixteen bit pattern containing n ones where n equals 1-16

8

threeIn24

a 24 bit pattern which contains 3 ones

9

inbandLoopup

D4/SF Loopback activate

10

inbandLoopdown

D4/SF Loopback deactivate

11

twoE3MinusOne

23 - 1 (7 bits)

12

twoE4MinusOne

24 - 1 (15 bits)

13

twoE5MinusOne

25 - 1 (31 bits)

14

twoE6MinusOne

26 - 1 (63 bits)

15

twoE7MinusOne

27 - 1 (127 bits)

16

twoE7MinusOneFT1Loopup

27 - 1 (fractional T1 loop back activate)

17

twoE7MinusOneFT1Loopdown

27 - 1 (fractional T1 loop back deactivate)

18

twoE9MinusOne

29 - 1 (511 bits with a maximum of 8 non-inverted sequential zeros and 9 sequential ones)

19

twoE10MinusOne

the 210 - 1 (1023 bits)

20

twoE11MinusOne

211 - 1 (2047 bits with a maximum of 15 inverted sequential zeros)

21

twoE15MinusOne

215 - 1 (32767 bits with a maximum of 15 inverted sequential zeros)

22

twoE17MinusOne

217 - 1 (131071 bits)

23

twoE18MinusOne

218 - 1 (262144 bits)

24

twoE20MinusOne

220 - 1 (1048575 bits with a maximum of 19 non-inverted sequential zeros)

25

twoE20MinusOneQRSS

220 - 1 (1048575 bits with zero suppression: a quasi-random signal source)

26

twoE21MinusOne

221 - 1 (2097151 bits)

27

twoE22MinusOne

222 - 1 (4194303 bits)

28

twoE23MinusOne

223 - 1 (8388607 bits:) the highest stress pseudo-random pattern with maximum of 23 inverted sequential zeros and 23 sequential ones

29

twoE25MinusOne

221 - 1 (33554431 bits)

30

twoE28MinusOne

228 - 1 (268435455 bits)

31

twoE29MinusOne

the highest stress pseudo random pattern with a maximum of 29 inverted sequential zeros

32

twoE31MinusOne

a maximum of 31 sequential zeros

33

dds1pattern

DDS1 pattern

34

dds2pattern

DDS2 pattern

35

dds3pattern

DDS3 pattern

36

dds4pattern

DDS4 pattern

37

dds5pattern

DDS5 pattern

38

userPattern

A User defined pattern.

Note This option is not supported in Release 5.


Syntax

cnfbert <bertIfNum> [-tp <test pattern>] [-tpi <transmit pattern inverse>]
[-rpi <receive patter inverse>] [-eir <error insertion rate>] [-lpbk <loopbackCode>]

Syntax Description

bertIfNum

Identifies the line, path, or port on which to configure a BERT session.

Note Enter the dspberts command in the to display the line, path, or port numbers that have BERT test activated in the current CLI context.

-tp

The test pattern to configure. Range 1-38. See Table 7-13.

Note Enter the dspbertcap command to display the supported loopback codes and their associated numbers for the line, path, or port.

-tpi

Controls inversion of the transmit BERT pattern:

1 = Not inverted

2 = Inverted

-rpi

Controls inversion of the received BERT pattern:

1 = Not inverted

2 = Inverted

-eir

Inserts bit errors in the transmitted pattern at the following rates:

1 = noError: no errors

2=oneInTen: 1 bit error per 10 bits

3 = oneInHundred: 1 bit error per 100 bits

4 = oneInThousand: 1 bit error per 1000 bits

5 = oneIn10Thousand: 1 bit error per 10000 bits

6 = oneInHundredThousand: 1 bit error per 100000 bits

7 = oneInMillion: 1 bit error per 1000000 bits

8 = oneInTenMillion: 1 bit error per 10,000,000 bits

-lpbk

Specifies the loopback type, in the range from 1 through 18.

Note Enter the dspbertcap command to display the supported loopback types and their associated numbers.


Related Commands

addbert, delbert, dspbert, dspbertcap, dspberts, dspbertstat, startbert, stopbert

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user configures the BERT test pattern 30 so that the received and transmitted patterns are inverted.

NodeB.6.MPSM155[ATM].a > cnfbert 1.1:7 -tp 30 -tpi 2 -rpi 2

cnfcdmode

Configure Card Mode

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfcdmode command to specify the type of the lines in use on the back card. Enter the dspcd command to display the current backcard mode.


Note Use cnfcdmode only when the card is not provisioned.



Note The cnfcdmode command does not apply to the SFP-2-155 or the SMB-2-155-EL OC3 back cards.


Syntax

cnfcdmode <mode>

Syntax Description

mode

Indicates the type of lines used on the back card.

MPSM-T3E3-155 modes (with T3/E3 backcard):

3 = T3

4 = E3

MPSM-16-T1E1 modes:

1 = T1

2 = E1 - MCC

3 = E1 - RBBN


Related Commands

dspcd, dspcds

Attributes

Log: yes

State: active, standby

Privilege: GROUP1


Example

In the following example, the user configures the backcard mode to E3.

M8850_NY.13.MPSM155[ATM].a > cnfcdmode 4

cnfcdsct

Configure Card-Level Service Class Template

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfcdsct command to assign a service class template (SCT) at the card level. The template contains bandwidth and policing parameters.


Note Policing parameters apply only at the port, so specifying SCT 1 or SCT 3 does not provide a policing function. (As this description states, Cisco provides SCTs 1 and 3 for the card.)



Note Currently, the system does not support certain parameters in the service class templates (SCTs), so you can specify them through addcon, cnfcon, or Cisco WAN Manager. These parameters are (when applicable) PCR, SCR, and ICR.


Usage Guidelines

The cnfcdsct command is card-level because it applies to the card's interface to the backplane. (See addport for specifying an SCT for a port.) The following characteristics apply to cnfcdsct.

A valid SCT file must exist on the PXM disk before you execute cnfcdsct. To dsiplay a list of SCT files on the disk, execute cd to get to the SCT directory, then execute ls to display the directory named MPSM155.

You cannot change the SCT configuration if any ports, lines, or partitions are configured.

To display the ID of the current SCT, use dspcd for the card-level SCT or dspport for a port-level SCT.

To display the actual contents of a card-level SCT, enter the dspcdsct command. The current SCT is displayed next to the Card SCT Id: field.

Until you specify an SCT, the MPSM-T3E3-155 has a default SCT of 0. The system uses SCT ID = 0 when:

The card is powered-up for the first time.

The card's database is rebuilt.

The card is rebooted and the user-specified SCT file for a particular port is corrupt or missing. In this situation, the default applies to only the affected port.

Cisco Systems provides SCT numbers 1, 2, 3, and 4. The high-level distinctions between these SCTs are as follows:

SCT 1 is for high bandwidth ports (such as DS3, E3, and OC3 ports), and it contains policing parameters.

SCT 2 is for high bandwidth ports, and it does not contain policing parameters.

SCT 3 is for low bandwidth ports (such as DS1, E1, and DS0 ports), and it contains policing parameters.

SCT 4 is for low bandwidth ports, and it does not contain policing parameters.


Note You should use the provided SCTs or create new templates by using Cisco WAN Manager to modify the provided SCTs and save them with new IDs.


Syntax

cnfcdsct <sctID>

Syntax Description

sctID

Number of the card-level SCT . The range is from 0 through 255.

Note To dsiplay a list of SCT files on the PXM disk, enter the dspscts command at the PXM card.


Related Commands

dspcdsct, dspcd, dspsct

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user assigns card SCT 1 to the MPSM-T3E3-155 in slot 9. Before configuring the card, the user verifies the presence of card SCT 1 for the MPSM-T3E3-155 on the PXM disk.

M8850_SF.8.PXM.a > dspscts
-----------------------------------------------------------------------------
Card Type ID Major Minor Checksum Status Description
-----------------------------------------------------------------------------
MPSM155 PORT 00001 00001 00000 0xff192c05 valid cisco :MPSM155_SCT.PORT.1.V1
MPSM155 CARD 00001 00001 00000 0x8ecc3c57 valid cisco :MPSM155_SCT.CARD.1.V1
MPSM16T1E1 PORT 00003 00001 00000 0x3cb04789 valid cisco :MPSM16T1E1_SCT.PORT.3.V1
MPSM16T1E1 CARD 00001 00001 00000 0x818c3c54 valid cisco :MPSM16T1E1_SCT.CARD.1.V1

M8850_SF.8.PXM.a > cc 9

(session redirected)

M8850_SF.9.MPSM155[FR].a > cnfcdsct 1

Note The SCT file must reside on the PXM disk before you can configure it with the cnfcdsct command. If the specified SCT is not on the PXM disk, the cnfcdsct command fails and displays the following error message:
ERR:SCT file not present. Use tftp to load it on PXM disk


cnfchanstdabr

Configure Standard ABR Connection arguments ABR

Service Context— Frame Relay

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfchanstdabr command to configure the standard available bit rate (ABR) arguments, such as cell rates and times, for the specified logical interface (ifNum).

Syntax

cnfchanstdabr <ifNum> <dlci> [-mcr <Minimum Cell Rate>] [-pcr <Peak Cell Rate>]
[-icr <Initial Cell Rate>] [-rif <Rate Increase Factor>] [-rdf <Rate Decrease Factor>]
[-nrm <Cells per forward RM>] [-trm <Time betwn forward RM>] [-tbe <Transient Buffer Exposure>]
[-frtt <Fixed Round-Trip Time>] [-adtf <ACR DecreaseTime Factor>][-cdf <Cutoff Decrease Factor>]

Syntax Description

ifNum

Interface number (port number) of the available bit rate (ABR) channel to configure.

Note Enter the dspcons command in the Frame Relay CLI context to display the port and DLCI numbers for all active channels.

dlci

Data-link Connection Identifier.

-mcr

Minimum Cell Rate (MCR)

MPSM-T3E3-155 range: 10-165787 cells per second

MPSM-16-T1E1 range: 10-36064 cells per second

-pcr

Peak cell rate (PCR)

MPSM-T3E3-155 range: 10-165787 cells per second

MPSM-16-T1E1 range: 10-36064 cells per second

-icr

Initial Cell Rate (ICR) in cells per second. This is the rate at which the source should begin transmitting, and is also the rate at which the source should resume transmitting after an idle period.

MPSM-T3E3-155 range: 10-165787 cells per second

MPSM-16-T1E1 range: 10-36064 cells per second

-rif

Rate Increase Factor (RIF). This is the factor by which to increase the Allowed Cell Rate (ACR). RIF is a power of 2 in the range 32768 to 1.

-rdf

Rate Decrease Factor (RDF). This is the factor by which to decrease the Allowed Cell Rate (ACR). RIF is a power of 2 in the range 32768 to 1.

-nrm

Maximum number of cells that the source can send for each forward RM-cell. Nrm is a power of 2 in the range 2-256.

-trm

The maximum number of milliseconds for one RM-cell to travel from source to endpoint. Trm is one of the following values:

6

12

25

50

100

Any other input value is rounded off to next higher supported value.

-tbe

Transient Buffer Exposure (TBE). This 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. The range is 0-16,777,215 cells.

-frtt

Fixed Round-Trip Time (FRTT). This is the sum of the fixed delays plus the propagation delays from the source to the destination and back. The range is 0-16700 microseconds.

-adtf

ACR Decrease Time Factor (ADTF). This is the time permitted to decrease the cell rate from the RM-cell rate to the Allowed Cell Rate (ACR) for normal traffic. The range is 10-1023 milliseconds.

-cdf

Cutoff Decrease Factor (CDF). This controls the decrease in Allowed Cell Rate (ACR) associated with Missing RM-cell count (CRM). CDF can be either or the following:

Zero

Power of 2 in the range 1/64 to 1

CRM limits the number of forward RM-cells that may be sent in the absence of received backward RM-cells. CRM is an integer. Its size is implementation specific.


Related Commands

dspchanstdabr

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user configures DLCI 1000 on port 1 so that is has an MCR and PCR of 1000.

.M8830_CH.12.MPSM155[FR].a > cnfchanstdabr 1 1000 -mcr 1000 -pcr 1000
Configuration successful

cnfclictx

Configure CLI Context

Service Context—ATM, Frame Relay

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfclictx command to set the default service context for the current card to either ATM or Frame Relay (FR). The CLI context assumes the default context when you first cc to the card. To display the default context, enter the dspclictx command. For more information, see the "Setting the Service Context on MPSM-T3E3-155 and MPSM-16-T1E1 Cards" section in Chapter 2, "Preparing MPSM-T3E3-155 and MPSM-16-T1E1 Cards and Lines for Communication."


Note Any change in the default service context on the Active MPSM-T3E3-155 line card gets reflected on the Standby MPSM-T3E3-155 card.


Syntax

cnfclictx <atm | fr>

Syntax Description

atm | fr

Sets the default service context of the card to be ATM or Frame Relay. Enter atm or fr to set the context to ATM or Frame Relay, respectively.


Related Commands

setctx, dspclictx

Attributes

Log: yes

State: active, standby, init

Privilege: ANYUSER


Example

In the following example, the user sets the default service context for the MPSM-T3E3-155 in slot 12 to ATM.

Note that the switch prompt does not reflect the change to ATM until the user changes to the PXM card and then changes back to the MPSM-T3E3-155 in slot 12.

M8830_CH.12.MPSM155[FR].a > cnfclictx atm

M8830_CH.12.MPSM155[FR].a > cc 1

(session redirected)

M8830_CH.1.PXM.a > cc 12

(session redirected)

M8830_CH.12.MPSM155[ATM].a >

cnfcon

Configure Connection

Service Context—ATM, Frame Relay, PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfcon command to modify the bandwidth, policing, and routing parameters of an existing endpoint. This command applies to only an SPVC or SPVP. For VS/VD-specific parameters for an ABR connection, use cnfabr.

The command parameters consist of:

A logical port, VPI, and VCI to identify the connection

Bandwidth parameters for the local (master) end then the remote (slave) end

Policing parameters for the connection as a whole

After you specify the mandatory connection identifier, all other parameters are optional.

Usage Guidelines

The following sections discuss the application of certain cnfcon parameters.


Note On DAX connections, using cnfcon at the slave end has no effect. For DAX connections, use cnfcon at the master end only, and the parameters will take effect on the controller as well.



Note Frame Relay does not support P2MP connections.


Traffic Parameters

Traffic parameters such as PCR, SCR, MBS are entered at both the master and slave endpoints for both the forward and reverse directions. For PCR in the cnfcon command, however, specify lpcr and rpcr at the master endpoint only (the connection manager ignores PCR entries at the slave end for the cnfcon command). Be sure that the value entered as "local" on one end is equal to the value entered as "remote" on the other end. For example, the lpcr on the slave endpoint should be same as the rpcr on the master endpoint and vice versa when you provision the connection at the other end. If you modify traffic parameters after creating an SPVC, you just modify them at the master endpoint or at the slave endpoint (if there is only one slave endpoint).

Traffic parameters such as CDV, CTD are entered at both the master and slave endpoints for both the forward and reverse directions. However, the values of these parameters entered at the slave end are ignored during call setup. Therefore, you can specify the lcdv, rcdv, lctd, and rctd options at the master end only.

Routing Parameters

Routing parameters, such as maximum route cost (-mc maxcost) or the routing priority (-rtngprio routingPriority) need to be entered at the master endpoint only. The values of the parameters entered at the slave end are ignored during call setup.

You can assign a priority at the master end of an SPVC or SPVP. The PNNI controller routes higher priority connections before lower priority connections. The user-configurable range for a connection is, in descending order of priority, 1-15. The default is 8. See cnfpri-routing for a detailed description of the Priority Routing feature. Also, the cnfpri-routing command lets you configure groups of bandwidth so that the order of routing also reflects the bandwidth requirements of the connection.

If you use the cnfcon command to modify only the routing priority of a connection, PNNI does not immediately re-route the connection. Nevertheless, if you run dspcon for such a changed connection at the master endpoint, it immediately shows the changed priority even before PNNI re-routes the connection. You can also use the dsppncon command to display the priority of the SVC portion that is associated with master and slave endpoints. Note that the dsppncon command shows the new priority only after PNNI re-routes the connection.

Frame Discard

For frame discard (see -frame option), specify this parameter for VCCs only and only at the master endpoint. This parameter has no meaning at the slave end. Both early packet discard (EPD) and partial packet discard (PPD) are supported. If you do not specify frame discard here, the connection manager uses the frame discard flag in the operational SCT. The EPD on the QE depends on the thresholds in the SCT for the port. If the cells arriving in the CoSB exceed the threshold and are dropped, the whole frame is dropped.

Local-Only Parameters

The parameters CDVT, stats enable, cc enable (specified using -cdvt, -stat, -cc) are significant only at the endpoint where you enter them. Therefore, they can be different at each end of the connection.

Syntax (ATM Service Context)

cnfcon <ifNum> <vpi> <vci>
[-lpcr <local to remote PCR>] [-rpcr <remote to local PCR>]
[-lscr <local to remote SCR>] [-rscr <remote to local SCR>]
[-lmbs <local to remote MBS>] [-rmbs <remote to local MBS>]
[-lcdv <local to remote maxCDV>] [-rcdv <remote to local maxCDV>] [-lctd <local to remote maxCTD>] [-rctd <remote to local maxCTD>] [-cc <OAM CC Cnfg>] [-lmcr <local to remote MCR>] [-rmcr <remote to local MCR>]
[-cdvt <local CDVT>] [-cc <OAM CC Cnfg>] [-stat <Stats Cnfg>]
[-frame <frame discard>] [-mc <Max Cost>] [-segep <OAM segment endpoint>]
[-lputil <local -> remote PUtil>] [-rputil <remote -> local PUtil>] [-rtngprio <routingPriority>] [-prefrte <preferredRouteId>] [-directrte <directRoute>]

Syntax Description (ATM Service Context)

ifNum

Interface number (port number) of the connection to configure.

Note Enter the dspcons command in the ATM CLI context to display the port number, VPI, and VCI for all active ATM ports.

vpi

Specifies the Virtual Path Identifier (VPI) for the connection.

vci

Specifies the Virtual Connection Identifier (VCI) for the connection.

service type

Specifies the ATM service type:

1 = CBR1 (Constant Bit Rate 1)

2 = VBR1RT (Variable Bit Rate 1, Real Time)

3 = VBR2RT (Variable Bit Rate 2, Real Time)

4 = VBR3RT (Variable Bit Rate 3, Real Time)

5 = VBR1NRT (Variable Bit Rate 1, Non-Real Time)

6 = VBR2NRT (Variable Bit Rate 2, Non-Real Time)

7 = VBR3NRT (Variable Bit Rate 3, Non-Real Time)

8 = UBR1 (Unspecified Bit Rate 1)

9 = UBR2 (Unspecified Bit Rate 2)

10 = ABRSTD (Standard ABR—see cnfabr for VS/VD-specific parameters)

11 = CBR2 (Constant Bit Rate 2)

12 = CBR3 (Constant Bit Rate 3)

Note CBR2 and CBR3 will be obsoleted in the future. Use CBR1 instead.

Note For ATM-FR interworking, the service mapping is.

FR ATM

highpriority cbr1

rtVBR vbr3rt

rtVBR vbr3nrt

uBR ubr

stdABR stdabr

mastership

Defines the endpoint as master or slave:

1 = master

2 = slave

-lpcr

Specifies the Peak Cell Rate for this connection in the local to remote direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-rpcr

Specifies the Peak Cell Rate for this connection in the remote to local direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-lscr

Specifies the Sustainable Cell Rate for this connection in the local to remote direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-rscr

Specifies the Sustainable Cell Rate for this connection in the remote to local direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-lmbs

Specifies the Maximum Burst Size for variable bit rate connections in the local to remote direction. MBS is the maximum number of cells that can burst at the PCR and still be compliant. Range: 0-5000000 cells

-rmbs

Specifies the Maximum Burst Size for variable bit rate connections in the remote to local direction. MBS is the maximum number of cells that can burst at the PCR and still be compliant. Range: 0-5000000 cells

-lcdv

Specifies the Local Cell Delay Variation, which limits the peak to peak cell delay variation from the local endpoint to the remote endpoint, in the range 1-16777215 microseconds.

-rcdv

Specifies the Remote Cell Delay Variation, which limits the peak to peak cell delay variation from the remote endpoint to the local endpoint, in the range 1-16777215 microseconds.

-lctd

Specifies the Local Cell Transfer Delay (CTD), which limits the CTD from a local endpoint to a remote endpoint, in the ranges 0-65535 microseconds.

-rctd

Specifies the Remote Cell Transfer Delay (CTD), which limits the CTD from the remote endpoint to the local endpoint, in the range 0-65535 microseconds.

-lmcr

Specifies the Minimum Cell Rate for available bit rate connections in the local to remote direction.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-rmcr

Specifies the Minimum Cell Rate for available bit rate connections in the remote to local direction.

MPSM-T3E3-155 range: 10-104268 cps

MPSM-16-T1E1 range: 10-36064 cps

-cdvt

Specifies the Local Cell Delay Variation Tolerance (CDVT) from a local endpoint to a remote endpoint, in the range 1-5000000 microseconds. Cell Delay Variation Tolerance controls the time scale over which the PCR is policed.

Note No remote CDVT is necessary.

-cc

Enables or disables the Operations, Administration, and Maintenance continuity check (OAM CC):

1 = enable

0 = disable

Continuity checking invokes a round trip of an OAM cell simply to confirm that both directions of the connection are intact.

To provision continuity checking, enable this function at both ends of the connection; otherwise, a connection alarm results. When you add a connection and include this parameter, the connection goes into alarm until both ends of the connection are added.

Note A non-zero AIS delay timer affects CC functionality (if enabled) during the intentional re-routing of a connection following the optrte or cnfrteopt command at the PXM card. The cnfaisdelaytimer command at the PXM card controls the AIS-delay feature. If the delay timer is configured and the connection is groomed, the switch turns off CC until the connection is re-routed.

-stat

Enables or disables connection statistics collection for the Cisco WAN Manager tool:

1 = enable

0 = disable

Note Statistics collection has an impact, which may not be significant, on the real-time response, especially for SVCs (which can be affected even though you do not add SVCs). Therefore, you should enable statistics collection for only the subset of connections that really warrant such a feature.

-frame

Enables or disables frame discard for this connection. You can use this option only at the master endpoint of a connection.

1 = enable

0 = disable

-mc

Specifies the Maximum Cost (maxcost), which creates a priority for the connection route. The switch can select a route if the cost does not exceed this value. If you do not specify maxcost, the connection has the highest routing priority by default. Use this parameter to lower the routing priority of a connection.

The following values are valid:

0: Use the optimal (or least expensive) path

1-4294967295: Use the path if the total cost for all links does not exceed this value. Higher numbers have higher priorities.

Note Although maxcost applies to an individual connection, routing costs primarily depend on a cost-per-link that you specify at every PNNI logical port in the network.

-segep

Enables or disables an OAM segment endpoint:

1 = enable

0 = disable

-lputil

Specifies the Local Percentage Utilization, in the range 1-100 percent.

-rputil

Specifies the Remote Percentage Utilization, in the range 1-100 percent.

-slavepersflag

Controls whether the endpoint is persistent or non-persistent. Enter a number to indicate the persistency as follows:

0 = persistent

1 = non-persistent

-rtngprio

Specifies the routing priority of this connection, in the range 1-15.

-prefrte

This option associates a preferred route to the connection. Use this parameter at the master endpoint only. Be sure the route exists before you associate it with the connection because the system does not check it. Use the dspprefs command at the PXM card to display preferred routes.

The following values are valid:

0: Disassociate a connection from a route

1-65535: The preferred route id


Note Before you delete the route, disassociate all connections from the route; otherwise, a dangling preferred route path remains. Enter the dspcons [-rteid <pref rte id> ] command at the PXM card to display all connections associated with a route.



Note An SPVC can be associated with one preferred route. For an XPVC, you can associate the preferred route with only the SPVC portion of the XPVC.


-intvsvd

Enables or disables VS/VD on the internal loop:

1 = Off

2 = On

3 = Unspecified: Use the VS/VD specification in the SCT file.

The cnfintfvsvd command enables VS/VD at the PNNI port level.

-extvsvd

Enables or disables VS/VD on the external loop:

1 = Off

2 = On

3 = Unspecified: Use the VS/VD specification in the SCT file.

The cnfintfvsvd command enables VS/VD at the PNNI port level.

-directrte

Enables or disables a direct route for this connection. When enabled (yes), the preferred route is the only permissible route for this connection. Should the directed preferred route be unavailable, the connection fails. When disabled (no), the connection tries another alternate route if the preferred route is unavailable.

The values are as follows:

1 = yes (make the preferred route required)

0 = no (do not require the connection to take the preferred route)


Syntax (Frame Relay Service Context)

cnfcon <ifNum> <dlci>
[-cir <Committed Information Rate>]
[-eir <zeroCirEir>] [-bc <Burst Commit>] [-be <Burst Excess>]
[-detag <DE Tagging Enable>] [-igde <Ignore Incoming DE>]
[-fecnmap <FECN map>] [-demap <DE to CLP map>]
[-clpmap <CLP to DE map>] [-eqsel <Egress Q Select>]
[-ingut <Ingress Perc Util>] [-egut <Egress Perc Util>]
[-egrat <Egress Service Rate>]
[-rtngprio <Routing Priority>] [-mc <Max Cost>]
[-lpcr <local-remote PCR>] [-rpcr <remote-local PCR>]
[-lscr <local-remote SCR>] [-rscr <remote-local SCR>]
[-lmcr <local-remote MCR>] [-rmcr <remote-local MCR>]
[-rmbs <remote MBS>] [-cc <OAM CC Cnfg>]
[-stat <Stats Cnfg>] [-upc <UPC Cnfg>]
[-prefrte <routeId>] [-directrte {yes|no}]

Syntax Description (Frame Relay Service Context)

ifNum

Interface number (port number) of the connection to configure.

Note Enter the dspcons command in the Frame Relay context to display the port number, and DLCI for all active ATM ports.

dlci

Specifies the Data-Link Connection Identifier.

-cir

Specifies the CIR for the connection.

MPSM-T3E3-155 range—T3: 0-44209688, E3_G832: 0-33920000, and E3_G751: 0-33831000 bps.

MPSM-16-T1E1 range: 0-1984000 bps.

-eir

Specifies the excess information rate for the connection.

MPSM-T3E3-155 range—T3: 0-44209688, E3_G832: 0-33920000, and E3_G751: 0-33831000 bps.

MPSM-16-T1E1 range: 0-1984000 bps.

-bc

Specifies the Burst Commit size for the connection. Range: 0-2097151 bytes

-be

Specifies the Burst Excess size for the connection. Range: 0-2097151 bytes

-detag

Enables or disables Discard Enable Tagging on the connection. This parameter enables or disables tagging of the DE bit on ingress frames as the result of the policing mechanism. Enter a number to enable or disable DE Tagging as follows:

1 = enable

2 = disable

-igde

Enables or disables a connection's response to incoming Discard Enable tags. Enter a number to ignore (disable) or accept (enable) incoming DE tags as follows:

1 = enable

2 = disable

-fecnmap

Specifies the mapping between FECN and EFCI for this connection. Enter a number to set the configuration of the FECN map as follows:

1 = mapEFCI

2 = setEFCIzero

-demap

Specifies the mapping between DE and CLP for this connection. Enter a number to set the DE to CLP mapping, as follows:

1 = mapCLP

2 = setCLPzero

3 = setCLPone

-clpmap

Specifies the mapping between CLP and DE for this connection. Enter a number to set the CLP to DE mapping, as follows:

1 = mapDE

2 = setDEzero

3 = setDEone

4 = ignoreCLP

-eqsel

Selects the Egress Queue for this connection. Enter a number to indicate one of the following options:

1 = highPriority

2 = lowPriority

3 = notSupported

-ingut

Specifies the Ingress Percent Utilization for this connection. This value controls the bandwidth allocated for the connection and allows you to oversubscribe the network resources. Range: 1-100 percent

-egut

Specifies Egress Percent Utilization for this connections. This value controls the bandwidth allocated for the connection and allows you to oversubscribe the network resources. Range: 1-100 percent

-egrat

Specifies the Egress Service Rate. This value is used for CAC to determine if the port can support the connection.

MPSM-T3E3-155 range: 2400-44209688 bps

MPSM-16-T1E1 range: 2400 and 1984000 bps

-rtngprio

Specifies the Routing Priority for this connections, in the range 1-15.

-mc

Specifies the Maximum Cost (maxcost), which creates a priority for the connection route. The switch can select a route if the cost does not exceed this value. If you do not specify maxcost, the connection has the highest routing priority by default. Use this parameter to lower the routing priority of a connection.

The following values are valid:

0: Use the optimal (or least expensive) path

1-4294967295: Use the path if the total cost for all links does not exceed this value.

Note Although maxcost applies to an individual connection, routing costs primarily depend on a cost-per-link that you specify at every PNNI logical port in the network.

-lpcr

Specifies the Peak Cell Rate for this connection in the local to remote direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-rpcr

Specifies the Peak Cell Rate for this connection in the remote to local direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-lscr

Specifies the Sustainable Cell Rate for this connection in the local to remote direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-rscr

Specifies the Sustainable Cell Rate for this connection in the remote to local direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-lmcr

Specifies the Minimum Cell Rate for available bit rate connections in the local to remote direction.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-rmcr

Specifies the Minimum Cell Rate for available bit rate connections in the remote to local direction.

MPSM-T3E3-155 range: 10-165787 cps

MPSM-16-T1E1 range: 10-36064 cps

-rmbs

Specifies the Maximum Burst Size for variable bit rate connections in the remote to local direction. MBS is the maximum number of cells that can burst at the PCR and still be compliant. Range 0-5000000 cells

-cc

Operations, administration, and maintenance continuity check (OAM CC):

1 = enable

0 = disable

Continuity checking invokes a round trip of an OAM cell simply to confirm that both directions of the connection are intact.

To provision continuity checking, enable this function at both ends of the connection; otherwise, a connection alarm results. When you add a connection and include this parameter, the connection goes into alarm until both ends of the connection are added.

-stat

Enables or disables connection statistics collection for the Cisco WAN Manager tool:

1 = enable

0 = disable

Note Statistics collection has an impact, which may not be significant, on the real-time response, especially for SVCs (which can be affected even though you do not add SVCs). Therefore, you should enable statistics collection for only the subset of connections that really warrant such a feature.

-upc

Enables or disables UPC configuration on the connection. Enter a number to enable/disable UPC configuration on the connection, as follows:

1 = enable

2 = disable

-prefrte

This option associates a preferred route to the connection. Use this parameter at the master endpoint only. Be sure the route exists before you associate it with the connection because the system does not check it. Use the dspprefs command at the PXM card to display preferred routes.

The following values are valid:

0: Disassociate a connection from a route

1-65535: The preferred route id


Note Before you delete the route, disassociate all connections from the route; otherwise, a dangling preferred route path remains. Enter the dspcons [-rteid <pref rte id> ] command at the PXM card to display all connections associated with a route.



Note An SPVC can be associated with one preferred route. For an XPVC, you can associate the preferred route with only the SPVC portion of the XPVC.


-directrte

Enables or disables a direct route for this connection. When enabled (yes), the preferred route is the only permissible route for this connection. Should the directed preferred route be unavailable, the connection fails. When disabled (no), the connection tries another alternate route if the preferred route is unavailable.

The values are as follows:

1 = yes (make the preferred route required)

0 = no (do not require the connection to take the preferred route)


Related Commands

addcon, delcon, dspcon, dspcons, dspconstats

Attributes

Log: yes

State: active

Privilege: GROUP1


Syntax (PPP Service Context)

cnfcon <ifNum> <dlci>
[-cir <Committed Information Rate>]
[-eir <zeroCirEir>] [-bc <Burst Commit>] [-be <Burst Excess>]
[-detag <DE Tagging Enable>] [-igde <Ignore Incoming DE>]
[-fecnmap <FECN map>] [-demap <DE to CLP map>]
[-clpmap <CLP to DE map>] [-eqsel <Egress Q Select>]
[-ingut <Ingress Perc Util>] [-egut <Egress Perc Util>]
[-egrat <Egress Service Rate>]
[-rtngprio <Routing Priority>] [-mc <Max Cost>]
[-lpcr <local-remote PCR>] [-rpcr <remote-local PCR>]
[-lscr <local-remote SCR>] [-rscr <remote-local SCR>]
[-lmcr <local-remote MCR>] [-rmcr <remote-local MCR>]
[-rmbs <remote MBS>] [-cc <OAM CC Cnfg>]
[-stat <Stats Cnfg>] [-upc <UPC Cnfg>]
[-prefrte <routeId>] [-directrte {yes|no}]

Syntax Description ( PPP Service Context)

ifNum

Specifies the interface number (bundle number) of the bundle to configure.

MPSM-16-T1E1 range: 1-16

Note Enter the dspcons command to display the bundle number and DLCI for all active MLPPP bundles.

dlci

Specifies the Data-Link Connection Identifier. Use 1000 for RPM-XF connections.

-cir

Specifies the CIR for the connection.

MPSM-16-T1E1 range: 0-1984000 bps.

-eir

Specifies the excess information rate for the connection.

MPSM-16-T1E1 range: 0-1984000 bps.

Note This parameter does not apply to connections to the RPM-XF.

-bc

Specifies the Burst Commit size for the connection. Range: 0-2097151 bytes

The default Frame Relay value is 5100, and the default Frame Forwarding value is 10300.

Note This parameter does not apply to connections to the RPM-XF.

-be

Specifies the Burst Excess size for the connection. Range: 0-2097151 bytes

The default Frame Relay value is 5100, and the default Frame Forwarding value is 10300.

Note This parameter does not apply to connections to the RPM-XF.

-detag

Enables or disables Discard Enable Tagging on the connection. This parameter enables or disables tagging of the DE bit on ingress frames as the result of the policing mechanism. Enter a number to enable or disable DE Tagging as follows:

1 = enable

2 = disable

Note This parameter does not apply to connections to the RPM-XF.

-igde

Enables or disables a connection's response to incoming Discard Enable tags. Enter a number to ignore (disable) or accept (enable) incoming DE tags as follows:

1 = enable

2 = disable

Note This parameter does not apply to connections to the RPM-XF.

-fecnmap

Specifies the mapping between FECN and EFCI for this connection. Enter a number to set the configuration of the FECN map as follows:

1 = mapEFCI

2 = setEFCIzero

Note This parameter does not apply to connections to the RPM-XF.

-demap

Specifies the mapping between DE and CLP for this connection. Enter a number to set the DE to CLP mapping, as follows:

1 = mapCLP (default)

2 = setCLPzero

3 = setCLPone

Note This parameter does not apply to connections to the RPM-XF.

-clpmap

Specifies the mapping between CLP and DE for this connection. Enter a number to set the CLP to DE mapping, as follows:

1 = mapDE (default)

2 = setDEzero

3 = setDEone

4 = ignoreCLP

Note This parameter does not apply to connections to the RPM-XF.

-eqsel

Selects the Egress Queue for this connection. Enter a number to indicate one of the following options:

1 = highPriority

2 = lowPriority

3 = notSupported

Note This parameter does not apply to connections to the RPM-XF.

-ingut

Specifies the Ingress Percent Utilization for this connection. This value controls the bandwidth allocated for the connection and allows you to oversubscribe the network resources. Range: 1-100 percent

Note This parameter is fixed at 100 percent for connections to the RPM-XF.

-egut

Specifies Egress Percent Utilization for this connections. This value controls the bandwidth allocated for the connection and allows you to oversubscribe the network resources. Range: 1-100 percent

Note This parameter is fixed at 100 percent for connections to the RPM-XF.

-egrat

Specifies the Egress Service Rate. This value is used for CAC to determine if the port can support the connection.

MPSM-16-T1E1 range: 2400 and 1984000 bps

Note This parameter does not apply to connections to the RPM-XF.

-rtngprio

Specifies the Routing Priority for this connections, in the range 1-15.

Note This parameter does not apply to connections to the RPM-XF.

-mc

Specifies the Maximum Cost (maxcost), which creates a priority for the connection route. The switch can select a route if the cost does not exceed this value. If you do not specify maxcost, the connection has the highest routing priority by default. Use this parameter to lower the routing priority of a connection.

The following values are valid:

0: Use the optimal (or least expensive) path

1-4294967295: Use the path if the total cost for all links does not exceed this value.

Note This parameter does not apply to connections to the RPM-XF.

-lpcr

Specifies the Peak Cell Rate for this connection in the local to remote direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-16-T1E1 range: 10-36064 cps

Note This parameter does not apply to connections to the RPM-XF.

-rpcr

Specifies the Peak Cell Rate for this connection in the remote to local direction. The PCR of the local and remote endpoints must match to successfully create a connection.

MPSM-16-T1E1 range: 10-36064 cps

Note This parameter does not apply to connections to the RPM-XF.

-lscr

Specifies the Sustainable Cell Rate for this connection in the local to remote direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-16-T1E1 range: 10-36064 cps

Note This parameter does not apply to connections to the RPM-XF.

-rscr

Specifies the Sustainable Cell Rate for this connection in the remote to local direction. The SCR of the local and remote endpoints must match for variable bit rate connections.

MPSM-16-T1E1 range: 10-36064 cps

Note This parameter does not apply to connections to the RPM-XF.

-lmcr

Specifies the Minimum Cell Rate for available bit rate connections in the local to remote direction.

MPSM-16-T1E1 range: 10-36064 cps

Note This parameter does not apply to connections to the RPM-XF.

-rmcr

Specifies the Minimum Cell Rate for available bit rate connections in the remote to local direction.

MPSM-16-T1E1 range: 10-36064 cps

Note This parameter does not apply to connections to the RPM-XF.

-rmbs

Specifies the Maximum Burst Size for variable bit rate connections in the remote to local direction. MBS is the maximum number of cells that can burst at the PCR and still be compliant. Range 0-5000000 cells

Note This parameter does not apply to connections to the RPM-XF.

-cc

Operations, administration, and maintenance continuity check (OAM CC):

1 = enable

0 = disable (default)

Continuity checking invokes a round trip of an OAM cell simply to confirm that both directions of the connection are intact.

To provision continuity checking, enable this function at both ends of the connection; otherwise, a connection alarm results. When you add a connection and include this parameter, the connection goes into alarm until both ends of the connection are added.

Note This parameter does not apply to connections to the RPM-XF.

-stat

Enables or disables connection statistics collection for the Cisco WAN Manager tool:

1 = enable

0 = disable (default)

Note Statistics collection has an impact, which may not be significant, on the real-time response, especially for SVCs (which can be affected even though you do not add SVCs). Therefore, you should enable statistics collection for only the subset of connections that really warrant such a feature.

Note This parameter does not apply to connections to the RPM-XF.

-upc

Enables or disables UPC configuration on the connection. Enter a number to enable/disable UPC configuration on the connection, as follows:

1 = enable

2 = disable

Note This parameter does not apply to connections to the RPM-XF.

-prefrte

This option associates a preferred route to the connection. Use this parameter at the master endpoint only. Be sure the route exists before you associate it with the connection because the system does not check it. Enter the dspprefs command at the PXM card to display preferred routes.

The following values are valid:

0: Disassociate a connection from a route (default)

1-65535: The preferred route id

Note This parameter does not apply to connections to the RPM-XF.

-directrte

Enables or disables a direct route for this connection. When enabled (yes), the preferred route is the only permissible route for this connection. Should the directed preferred route be unavailable, the connection fails. When disabled (no), the connection tries another alternate route if the preferred route is unavailable.

The values are as follows:

1 = yes (make the preferred route required)

0 = no (do not require the connection to take the preferred route)

Note This parameter does not apply to connections to the RPM-XF.


Attributes

Log: yes

State: active

Privilege: any


Example (ATM)

In the following example, the user enables OAM CC in the connection with a VPI and VCI of 10 40 on interface 4.

M8850_NY.13.MPSM155[ATM].a > cnfcon 4 10 40 -cc 1
Warning: Changing connection parameters will result in a momentary loss of traf.
Do you want to proceed (Yes/No)? y
Configuration successful

In the following example, the user assigns a routing priority of 3 to the connection with a VPI and VCI of 100 on interface number 4, and then checks the result with the dspcon command.

M8850_NY.13.MPSM155[ATM].a > cnfcon 4 100 100 -rtngprio 3
Warning: Changing connection parameters will result in a momentary loss of traf.
Do you want to proceed (Yes/No)? y
Configuration successful

M8850_NY.13.MPSM155[ATM].a > dspcon 4 100 100
--------------------------------------------------------------------------
Local : NSAP Address vpi vci
(M) 4700918100000000036B5E31B30000010D180400 100 100
Remote : NSAP Address vpi vci
(s)       4700918100000000001A5389430000010C180400 0 0
--------------------------------------------------------------------------
Conn. Type : VCC Admn Status : ADMN-UP
Service Type : cbr1 Oper Status : FAIL
Controller : 2 Record # : 0
SlavePersist : YEA Cast-type : N/A
--------------------------------------------------------------------------
Local PCR : 50 Remote PCR : 50
Local SCR : N/A Remote SCR : N/A
Local CDV : N/A Remote CDV : N/A
Local CTD : N/A Remote CTD : N/A
Local MBS : N/A Remote MBS : N/A
Max Cost : N/A Frame discard: N/A
Local CDVT : 250000 OAM segment : ENABLED
Local PctUtil : 100 Rmt PctUtil : 100
Priority :        3
Pref Rte Id : N/A Directed route: N/A
--------------------------------------------------------------------------

Type <CR> to continue, Q<CR> to stop:
OAM CC Config : ENABLED Statistics : DISABLED
--------------------------------------------------------------------------
Loopback Type : No Lpbk | Dir: N/A | Status: No Lpbk | RTD: 0us
--------------------------------------------------------------------------

--------------------------------------------------------------------------
Port side Tx : AIS Swth side Tx : normal
Port side Rx : normal Swth side Rx : normal
--------------------------------------------------------------------------
I-AIS/RDI E-AIS/RDI CONDITIONED CCFAIL IfFail Mismatch LMI-ABIT
NO NO YES NO NO NO NO
--------------------------------------------------------------------------

Example (Frame Relay)

In the following example, the user sets the CIR to 10,000 bps on the connection with a DLCI of 10 40 on interface 4.

M8850_NY.13.MPSM155[FR].a >cnfcon 4 1040 -cir 10000
Warning: Changing connection parameters will result in a momentary loss of traf.
Do you want to proceed (Yes/No)? y
Configuration successful

Example (PPP Service Context)


In the following example, the user modifies a connection on bundle 1 with a DLCI of 1000.

U4.5.MPSM16T1E1PPP[FR].a > cnfcon 1 1000 -cir 123456
Warning: Changing connection parameters will result in a momentary loss of traffic.
Warning: Changing routing parameters will not take effect on the slave endpoint of a DAX connection.
Do you want to proceed (Yes/No)? y
Configuration successful

U4.5.MPSM16T1E1PPP[FR].a > dspcon 1 1000
--------------------------------------------------------------------------
Local : NSAP Address vpi vci
(S) 4700918100000000309409F6DD000001051FFF00 0 1000
Remote : NSAP Address vpi vci
(M) 0000000000000000000000000000000000000000 0 0
--------------------------------------------------------------------------
Port Number : 1 DLCI : 1000
Conn. Type : frForward Chan Service Type: High Priority
Conn Service Type : cbr1 Egress Queue Type: highPriority
Admn Status : UP Oper Status : FAILED
Slave Persist : N/A Max Cost : N/A
CIR (bps) : 123456 BC (bytes) : 10300
BE (bytes) : 10300 FECN Config : setEFCIzero
ChanDEtoCLPmap : setCLPzero ChanCLPtoDEmap : ignoreCLP
IngrPercentUtil : 100 EgrPercentUtil : 100
EgrSrvRate (bps) : 10000 ZeroCirEir (bps) : N/A
DE Tagging : DISABLED IgnoreIncomingDE : DISABLED
Pref Rte Id : 0 Directed Route : NO
Upload : 00000002 Routing Priority : 0
OAM CC Config : DISABLED Statistics : ENABLED
Local Loopback : DISABLED UPC : ENABLED
--------------------------------------------------------------------------

Type <CR> to continue, Q<CR> to stop:
Local PCR (cps) : 463 Remote PCR (cps) : 38
Local SCR (cps) : N/A Remote SCR (cps) : N/A
Local MCR (cps) : N/A Remote MCR (cps) : N/A
: Remote MBS (cps) : N/A
--------------------------------------------------------------------------
Xmt Abit State : A equal 0 Rcv Abit State : OFF
Xmt ATM State : Not Sending Rcv ATM State : Not Recving
--------------------------------------------------------------------------
E-AIS/RDI CONDITIONED CCFAIL IfFail Mismatch LMI-ABIT
NO YES NO NO NO NO
--------------------------------------------------------------------------

cnffrparms

Configure Frame Relay Parameters

Service Context—Frame Relay and PPP

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnffrparms command to configure the Frame Relay or PPP Egress QoS scheme.


Note You cannot change the QoS scheme configuration while Frame Relay ports exist on the card. If you want to modify the QoS scheme configuration, you must first delete all Frame Relay ports from the card.


Syntax

cnffrparms -egrQos <egrQos>

Syntax Description

-egrQos

Frame Relay Egress QoS Scheme:

3 = twoPlusOneFrame (default)

4 = twoPlusOneByte


Related Commands

dspfrparms, dspports

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user sets the QoS scheme to two plus one byte.

.M8830_CH.12.MPSM155[FR].a > cnffrparms -egrQos 4

cnfilmi

Configure ILMI

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfilmi command to configure the card-level interim local management interface (ILMI). Activating the card-level ILMI through cnfilmi requires a pre-existing logical port (see addport) and resource partition (see addrscprtn or addpart). The MPSM automatically adds a partition when you add a port.


Note For network-level ILMI in relation to PNNI, run the PNNI-specific ILMI commands on the PXM.


Syntax

cnfilmi -if <ifNum> -id <partitionID> -ilmi <ilmiEnable> -vpi <vpi> -vci <vci> -trap <ilmiTrapEnable> -s <keepAliveInt> -t <pollingIntervalT491> -k <pollInctFact>

Syntax Description

-if

Specifies the interface number (port number) for which you want to configure ILMI.

Note Enter the dspparts command in the ATM CLI context to display the interface number and partition id for all active ATM ports.

-id

Specifies the partition ID, in the range 1-20. (See description of addpart or addrscprtn for information regarding resource partition ID.)

-ilmi

Enable or disable ILMI.

1 = enable

2 = disable

-vpi

VPI for the ILMI signaling connection, in the range 0-255.

-vci

VPI for the ILMI signaling connection, in the range 0-65535.

-trap

Enable or disable ILMI trap.

1 = enable

2 = disable

-s

Keep alive interval, in the range 1-16 seconds.

-t

Polling interval timer value for T491, in the range 0-255 seconds.

Note Enter 0 to disable polling on the specified interface.

-k

Polling inactive factor K, in the range 0-255.


Related Commands

dspilmi, dspilmis, dnilmi, upilmi

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

Enable ILMI on port 4, partition 1, VPI 40/VCI 99 so that traps are sent at an interval of 20 seconds. Configure polling for T491 of 10 seconds and K intervals of 10.

M8850_NY.13.MPSM155[ATM].a > cnfilmi -if 4 -id 1 -ilmi 1 -vpi 40 -vci 99 -s 20 -t 10 -k 10

cnfimagrp

Configure IMA Group

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfimagrp command to configure an IMA group. Modifying any attribute restarts the IMA group.

Syntax

cnfimagrp <-grp group> [-ver <version>] [-txm <minLinks>] [-txid <txImaId>] [-txfl <txFrameLen>] [-dd <diffDelayMax>] [-uptim groupUpTime] [-dntim <groupDownTime>] [-vfb <verFallback> [-mode <autoRestart>] [-rxid <rxImaIdExpected>] [-cm <txclkMode>]

Syntax Description

-grp

Specifies the IMA group.

Note Enter the dspimagrps command to dsiplay a list of all IMA groups on the current card.

-ver

The version number of ATM Forum IMA specification.

1 = Version 1.0

2 = Version 1.1

-txm

The minimum number of links that must be operational before the IMA group is operational.

MPSM-T3E3-155 range: 1-16

MPSM-16-T1E1 range: 1-8

For example, if you create an IMA group of 4 links and specify a minimum number of 3 links, then three of the four specified links must be operational before the IMA group can be used.

-txid

The IMA ID number transmitted in the IMA ID field of the ICP cell, in the range 0-255.

-txfl

The length of transmitted IMA frame in bytes. For IMA version 1.0, the txImaFrameLength value is 128. For version 1.1, the txImaFrameLength value can be 32, 64, 128, or 256.

-dd

The maximum differential delay in milliseconds.

T1 range: 1-275 ms

E1 range: 1-220 ms

-uptim

The group up time, in the range 0-400000 milliseconds. Default: 10000.

-dntim

The group down time in the range 0-100000 milliseconds. Default: 2500.

-vfb

Enables or disables version fallback on the IMA group.

1 = Enable version fallback

2 = Disable version fallback

Note You must enable version fallback on the card level before you enable it for individual IMA groups. See cnfimaparms -fallback.

-mode

Configures IMA auto restart functionality for the current group.

1 = Disable IMA auto-restart

2 = Relearn IMA auto-restart

3 = Resume a previous IMA auto-restart

Note You must enable auto-restart on the card level before you enable it for individual IMA groups. See cnfimaparms -restart.

-rxid

Identifies the expected received IMA ID, either -1 or in the range 1-255.

-cm

Sets the transmit clock mode.

Note Applies to MPSM-16-T1E1 only.


Related Commands

addimagrp, delimagrp, dspimagrp, dspimagrps,

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the example that follows, the user configures IMA group 1 with the following options, and then displays the results:

IMA version: 1.1

minimum of transmit links: 4

transmit IMA Id: 1

transmit IMA frame length: 128 bytes

A maximum differential delay: 200 milliseconds

up time: 300000 milliseconds

down time: 20000 milliseconds

version fallback: enabled

auto-restart mode: disabled

expected received IMA ID: -1

NodeB.6.MPSM155[ATM].a > cnfimagrp -grp 1 -ver 2 -txm 4 -txid 1 -txfl 128 -dd 200 -uptim 300000 -dntim 20000 -vfb 1 -mode 1 -rxid -1

cnfimalnk

Configure IMA Link

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfimalnk command to configure LIF and LODS integration timers for an IMA link.

Syntax

cnfimalnk -lnk <line/pathId>, -uplif <lifUpTime>, -dnlif <lifDnTime>, -uplods <lodsUpTime>, -dnlods <lodsDnTime>

Syntax Description

-lnk

The link (line or path) in the IMA group to configure:

Note Enter the dspimalnks command to dsiplay a list of all line or path numbers on the current card.

-uplif

LIF integration up time, in the range 0-25000 milliseconds. The LIF (Loss of IMA Frame) defect is the occurrence of persistent OIF (Out of IMA Frame) anomalies for at least 2 IMA frames.

-dnlif

LIF integration down time, in the range 0-25000 milliseconds. The LIF (Loss of IMA Frame) defect is the occurrence of persistent OIF (Out of IMA Frame) anomalies for at least 2 IMA frames.

-uplods

LODS integration up time, in the range 0-25000 milliseconds. The LODS (Link Out of Delay Synchronization) is a link event indicating that the link is not synchronized with the other links within the IMA group.

-dnlods

LODS integration down time, in the range 0-25000 milliseconds. The LODS (Link Out of Delay Synchronization) is a link event indicating that the link is not synchronized with the other links within the IMA group.


Related Commands

addimalnk, delimalnk, dspimalnk, dspimalnks

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user configures IMA link 1.2:2 for a link LIF up time of 20000, a Link LIF downtime of 10000, al Link LODS uptime of 2500, and a link LODS integrated downtime of 10000.

NodeB.6.MPSM155[ATM].a > cnfimalnk -lnk 1.2:2 -uplif 20000 -dnlif 10000 -uplods 2500 -dnlods 10000

cnfimalnktst

Configure IMA Link Test

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfimalnktst command to change the test pattern number for the specified IMA group and link during an IMA link connectivity test.

Syntax

cnfimalnktst -grp <group> -lnk <link> -pat <testPat>

Syntax Description

-grp

Specifies the IMA group number.

Note Enter the dspimalnks command to display the all active IMA links and the groups to which they belong on the current card.

-lnk

Identifies the IMA link (line or path) to configure:

Note Enter the dspimalnks command to display the all active IMA links on the current card.

-pat

The test pattern number, in the range 1-254.

-1 causes the program to choose its own pattern.


Related Commands

startimalnktst, stopimalnktst

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user configures the IMA test pattern 200 on the IMA link 1.2:2 in IMA group 1.

NodeB.6.MPSM155[ATM].a > cnfimalnktst -grp 1 -lnk 1.2:2 -pat 200

cnfimaparms

Configure IMA Parameters

Service Context—ATM

Modules—MPSM-T3E3-155, MPSM-16-T1E1

Enter the cnfimaparms command to configure the card for global IMA parameters.


Note You can enter this command in both the ATM and Frame Relay service contexts, but it applies to ATM IMA groups only.


Syntax

cnfimaparms [-restart {enable | disable} [-fallback {enable | disable}
[-minId <min_id>] [-maxId <max_id>]

Syntax Description

-restart

Enables or disables the IMA group auto-restart feature for the card:

1 or enable = Enable the auto restart feature

2 or disable = Disable the auto restart feature (default)

Note To enable this feature on individual IMA groups, enter the cnfimagrp -mode <1|2> command.

Note The cnfautorestart <1|2> command also configures this feature.

-fallback

Enables or disables IMA version fallback support for the card.

1 = Enable the auto restart feature (default)

2 = Disable the auto restart feature

To enable this feature on individual IMA groups enter the cnfimagrp -vfb <1|2> .

-minId

Specifies the minimum IMA identifier that can be used for any IMA group on the current card, in the range 0-255.

-maxId

Specifies the maximum IMA identifier that can be used for any IMA group on the current card, in the range 0-255.


Related Commands

cnfimagrp, cnfautorestart, dspimaparms

Attributes

Log: yes

State: active

Privilege: GROUP1


Example

In the following example, the user enables IMA group auto-restart mode and IMA version fallback support, configures the minimum IMA ID to be 100, and configures the maximum IMA ID to be 200.

M8830_CH.12.MPSM155[FR].a > cnfimaparms -restart 1 -fallback 1 -minId 100 -maxId 200


hometocprevnextglossaryfeedbacksearchhelp

Posted: Tue Oct 24 15:17:37 PDT 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.