Cisco Circuit Emulation Services (CESM/MPSM) Configuration Guide and Command Reference for MGX Switches, Release 5.1
Managing CESM and MPSM Cards
Downloads: This chapterpdf (PDF - 784.0KB) The complete bookPDF (PDF - 4.44MB) | Feedback

Managing CESM and MPSM Cards

Table Of Contents

Managing CESM and MPSM Cards

Managing CLI Sessions

Managing Cards

Displaying General Card Information

Displaying Software Version and Status Information

Displaying CESM Card Features

Managing MPSM Feature Licenses

Displaying MPSM Feature Licenses

Moving MPSM Feature Licenses

Allocating MPSM Feature Licenses

Managing MPSM Feature License Alarms

Node License Alarm

Slot License Alarms

Managing Lines

Displaying a List of Lines

Displaying the Configuration for a Single Line

Bringing Down a Line

Managing Line Alarms

Managing Ports

Displaying a List of Ports

Displaying the Status of a Single Port

Changing a Port Configuration

Deleting Ports

Managing Resource Partitions

Resource Partitions on PXM45 and PXM1E Based Switches

Managing Port Resource Partitions on PXM45 and PXM1E Based Switches

Resource Partitions on PXM1 Based Switches

Managing Card Resource Partitions on PXM1 Based Switches

Managing Port Resource Partitions on PXM1 Based Switches

Managing Connections

Displaying a List of Connections

Displaying the Status of a Single Connection

Deleting SPVC Connections

Deleting PVC Connections

Testing Connections

Testing with tstcon

Testing with tstdelay

Monitoring Connection Statistics

Displaying Connection Alarms

Managing Loopbacks

CESM Card Loopbacks

MPSM Card Loopbacks

Managing Bit Error Rate Testing (BERT)

SRM Supported BERT

Overview of SRM Supported BERT

BERT Configuration Parameters on the SRM

MPSM-8T1E1 Onboard BERT

MPSM-8T1E1 Onboard BERT Features

Managing a BERT Session on the MPSM-8T1E1

Managing MPSM Online Diagnostics

MPSM-8T1E1 Online Diagnostics Features

Configuring Online Diagnostics on the MPSM-8T1E1

Managing MPSM Core Dumps

Overview of MPSM Core Dumps

Managing Core Dump Files

Aborting Core Dumps

Displaying Core Command Options

Displaying Core Dump Settings

Displaying the Core Dump Mask

Configuring Core Dump Settings

Enabling Automatic Core Dumping

Disabling Automatic Core Dumping

Changing the Core Dump Mask

Restoring the Default Core Dump Mask

Hot-Dumping the Core

Managing Line Conditioning

Overview of Line Conditioning

Line Conditioning Feature Limitations

Configuring Line Conditioning on CESM and MPSM Cards


Managing CESM and MPSM Cards


This chapter provides procedures for managing CESM-8T1/B, CESM-8T1, CESM-8E1, MPSM-8T1-CES, and MPSM-8E1-CES cards after the initial card setup and provisioning.


Note Initial card setup is described in the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Configuration Guide, Release 5.1, the Release Notes for Cisco MGX 8230, Cisco MGX 8250, and Cisco MGX 8850 (PXM1) Switches, Release 1.3.10, and the Cisco MGX 8850 Edge Concentrator Installation and Configuration, Release 1.1.3 documentation. The provisioning of CESM and MPSM cards is described in "Preparing CESM and MPSM Lines and Ports for Communications," "Provisioning SPVCs (PXM1E/PXM45) on CESM and MPSM Cards," and "Provisioning PVCs (PXM1) on CESM and MPSM Cards."


This chapter describes the following CESM and MPSM management procedures:

Managing CLI Sessions

Managing Cards

Managing MPSM Feature Licenses

Managing Lines

Managing Ports

Managing Resource Partitions

Managing Connections

Managing Loopbacks

Managing Bit Error Rate Testing (BERT)

Managing MPSM Online Diagnostics

Managing MPSM Core Dumps

Managing Line Conditioning

Managing CLI Sessions

Basic session initialization and management are described in the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Configuration Guide, Release 5.1, the Release Notes for Cisco MGX 8230, Cisco MGX 8250, and Cisco MGX 8850 (PXM1) Switches, Release 1.3.10, and the Cisco MGX 8850 Edge Concentrator Installation and Configuration, Release 1.1.3 documentation.

Table 5-1 lists and describes the session management commands supported on the CESM and MPSM cards. For more information on these commands, see Chapter 6, "CESM and MPSM Command Reference."

Table 5-1 Session Management Commands 

Command
Purpose

?
Help

Enter this command to display the available commands.

clear
clrscrn
cls

Enter this command to clear the session screen.

myid

Enter this command to display the user ID that was used to start the current session.

setcmdc

Enter this command to enable or disable the command completion feature, which automatically completes an incomplete command if the command portion entered uniquely identifies a supported command. This command is supported on the MPSM-8T1-CES and MPSM-8E1-CES only.

setpagemode

Enter this command to enable or disable the page feature, which breaks command displays into pages for easier viewing.


Managing Cards

Basic card initialization and configuration are described in the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Configuration Guide, Release 5.1, the Release Notes for Cisco MGX 8230, Cisco MGX 8250, and Cisco MGX 8850 (PXM1) Switches, Release 1.3.10, and the Cisco MGX 8850 Edge Concentrator Installation and Configuration, Release 1.1.3 documentation.

The following sections provide procedures for doing the following:

Displaying General Card Information

Displaying Software Version and Status Information

Displaying CESM Card Features


Note This section provides procedures for some of the most common card management commands. For a complete list of card management commands, refer to Table 6-2 in Chapter 6, "CESM and MPSM Command Reference."


Displaying General Card Information

To display general information about a CESM or MPSM card use the dspcd command.

The following example shows general information about a CESM-8T1/B card:

M8850_SF.1.26.CESM.a > dspcd


  ModuleSlotNumber:          26
  FunctionModuleState:       Active
  FunctionModuleType:        CESM-8T1/B
  FunctionModuleSerialNum:   B24356
  FunctionModuleHWRev:       aa
  FunctionModuleFWRev:       021.000.001.193-A
  FunctionModuleResetReason: Reset by PXM
  LineModuleType:            LM-RJ48-8T1
  LineModuleState:           Present
  mibVersionNumber:          82
  configChangeTypeBitMap:    CardCnfChng, LineCnfChng
  cardIntegratedAlarm:       Clear

       Front Card Info 
  Hardware Revision      :   AA
  Card Type              :   787
  Serial Number          :   B24356
  Fab Number             :   28-4253-01         

       Back Card Info 
  Hardware Revision      :   AA
  Card Type              :   22
  Serial Number          :   648395
  Fab Number             :   28-2011-01


Note The dspcd command displays information on card alarms.


The following example shows general information about an MPSM-8T1-CES card:

M8850_SF.1.28.MPSM8T1.CES.a > dspcd


  ModuleSlotNumber:          28
  FunctionModuleState:       Active
  FunctionModuleType:        MPSM-8T1-CES
  FunctionModuleSerialNum:   SAG07208RRA
  FunctionModuleHWRev:       02
  FunctionModuleFWRev:       030.000.001.077-A
  FunctionModuleResetReason: Reset by PXM
  LineModuleType:            ?
  LineModuleState:           Not Present
  mibVersionNumber:          100
  configChangeTypeBitMap:    No changes
  cardIntegratedAlarm:       Major
  cardMajorAlarmBitMap:      Line Alarm

      Front Card Info 

  PCB PART NO-(800 LEVEL):   800-22480-04 
  PCB PART_NO-(73 LEVEL):    73-8466-04 
  PCB REVISION (800 LEVEL):   
  PCB SERIAL NO:             SAG07208RRA 
  CLEI CODE:                 0 
  MANUFACTURING ENG:         0x0        
  RMA TEST HISTORY:          0x0        
 
      Back Card Info        

  PCB PART NO-(800 LEVEL):   ?? 
  PCB PART NO-(73 LEVEL):    ?? 
  PCB REVISION (800 LEVEL):  ?? 
  FAB PART NO-(28 LEVEL):    ?? 
  PCB SERIAL NO:             ?? 
  CLEI CODE:                 ?? 
  MANUFACTURING ENG:         ?? 
  RMA HISTORY:               ?? 
 
M8850_SF.1.28.MPSM8T1.CES.a > 

To determine whether a card is a CESM-8T1/B, CESM-8T1, CESM-8E1, MPSM-8T1-CES, or MPSM-8E1-CES card, use the dspcd command on the CESM or MPSM card, or use the dspcds command on the PXM1, PXM1E, or PXM45 controller card.

Displaying Software Version and Status Information

To display information about the software running on a CESM or MPSM card, use the chkflash and version commands.

The following example shows the status of the boot software on a CESM card:

PXM1E_SJ.1.20.CESM.a > chkflash
Program length = 264592
Calculated checksum = a9f614f6 stored checksum = a9f614f6
Flash checksum passed

PXM1E_SJ.1.20.CESM.a >

The following example shows the status of the boot software on an MPSM card:

M8850_SF.1.28.MPSM8T1.CES.a > chkflash

[chkflashfn]: Program length = 1477096
Calculated checksum = 0x5a73afb6 stored checksum = 0x5a73afb6

Flash checksum passed

M8850_SF.1.28.MPSM8T1.CES.a >

The following example displays the software versions running on a CESM card:

PXM1E_SJ.1.20.CESM.a > version
***** Cisco Systems CESM-8T1E1 Card *****
    Firmware Version    = 021.000.001.193-A
    Backup Boot version = CE8_BT_1.0.02
    ASCFRSM Xilinx file = cbslave.h
VxWorks (for CISCO) version 5.3.1.
Kernel: WIND version 2.5.
Made on Feb 11 2003, 03:07:58.
Boot line:
Boot from PROM 

PXM1E_SJ.1.20.CESM.a >

The following example displays the software versions running on an MPSM card:

M8850_SF.1.28.MPSM8T1.CES.a > version
***** Cisco System MPSM-8-T1E1 Card *****
    Firmware Version            = 030.000.001.077-A
    Backup Boot Version         = 030.000.001.077-A
VxWorks (for Broadcom BCM1125) version VxWorks5.4.2.
Kernel: WIND version 2.5.
Made on Dec  5 2003, 12:19:50.
Boot line:

M8850_SF.1.28.MPSM8T1.CES.a > 

Displaying CESM Card Features

The CESM-8T1/B, CESM-8T1, and CESM-8E1 cards are available in channelized (structured) and nonchannelized (unstructured) versions. To determine if a CESM-8T1/B, CESM-8T1, or CESM-8E1 is a nonchannelized or channelized version, enter the dspfeature command as shown in the following example:

PXM1E_SJ.1.20.CESM.a > dspfeature

  Channelized:  On
 
PXM1E_SJ.1.20.CESM.a >

The example above is for a channelized CESM-8T1/B card.

Managing MPSM Feature Licenses

Some features on the MPSM-8T1E1 card are enabled by the use of feature licenses. These feature licenses reside on the PXM processor in a license pool until needed by the MPSM card.

The following sections provide procedures for doing the following:

Displaying MPSM Feature Licenses

Moving MPSM Feature Licenses

Allocating MPSM Feature Licenses

Managing MPSM Feature License Alarms


Note To install spare feature licenses into the PXM license pool, transfer feature licenses from one switch to another switch, and re-key feature licenses, refer to the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Configuration Guide, Release 5.1 and the Release Notes for Cisco MGX 8230, Cisco MGX 8250, and Cisco MGX 8850 (PXM1) Switches, Release 1.3.10.


Displaying MPSM Feature Licenses

Use the dspliccd command to display the details of feature licenses that are needed, that have been allocated from the PXM license pool, or that have been programmed into the NVRAM of the MPSM-8T1E1 card.

Because the MPSM-8T1E1 card configured for Circuit Emulation services does not require any feature licenses, the dspliccd command is used exclusively to view feature licenses that have been programmed into the NVRAM of the MPSM-8T1E1 card.


Note The rate control feature license is the only feature license available for the MPSM-8T1E1 card. This feature license is used by the MPSM-8T1E1 card when configured for Frame Relay services.


In the following example, the dspliccd command shows one rate control feature license programmed into the NVRAM on the MPSM-8T1-CES card:

M8850_SF.1.28.MPSM8T1.CES.a > dspliccd

Card License Alarm:              None
Service Module Type:             MPSM8T1E1
Service Module Serial Number:    SAG07208RRA
Provisioning (addcon) Allowed:   YES
=========================================================
Needed License Type               Needed Licenses
-------------------               ---------------

=========================================================
Allocated License Type            Allocated licenses
----------------------            ------------------

=========================================================
Programmed  License Type          Programmed licenses
------------------------          -------------------
RateControl                       1

=========================================================
Programmed License Registered:   NO
License registration node:       NONE
License registration chassis:    NONE
=========================================================

M8850_SF.1.28.MPSM8T1.CES.a >

If a feature license is moved to the PXM license pool, then the Programmed License Registered field in the output of the dspliccd command will state YES. Notice in this example that the rate control license programmed into the NVRAM on the MPSM-8T1-CES card has not been moved to the PXM license pool.

Moving MPSM Feature Licenses

If a feature license is purchased at the same time as the MPSM card, that license can be programmed into the NVRAM on the MPSM card. When a feature license is programmed on an MPSM card, the license is unavailable to that MPSM card and all other cards on the switch. To enable use of the programmed feature license, it must be moved from the MPSM card and installed in the switch license pool, which is a database on the PXM processor card.

The movelic command is used to move feature licenses programmed on MPSM cards to the switch license pool on the PXM processor card.

To move feature licenses, perform the following steps:


Step 1 Enter the dspliccd command to view the feature licenses that have been programmed on the MPSM card:

M8850_SF.1.28.MPSM8T1.CES.a > dspliccd

Card License Alarm:              None
Service Module Type:             MPSM8T1E1
Service Module Serial Number:    SAG07208RRA
Provisioning (addcon) Allowed:   YES
=========================================================
Needed License Type               Needed Licenses
-------------------               ---------------

=========================================================
Allocated License Type            Allocated licenses
----------------------            ------------------

=========================================================
Programmed  License Type          Programmed licenses
------------------------          -------------------
RateControl                       1

=========================================================
Programmed License Registered:   NO
License registration node:       NONE
License registration chassis:    NONE
=========================================================

M8850_SF.1.28.MPSM8T1.CES.a >

In this example, the output of the dspliccd command shows that one Rate Control feature license has been programmed into the NVRAM on the MPSM card.

Step 2 Enter the movelic command to move the feature licenses programmed on the MPSM card to the switch license pool on the PXM processor card:

M8850_SF.1.28.MPSM8T1.CES.a > movelic
------------------------------------------------
Programmed License Type          #Programmed
-----------------------          -----------
RateControl                       1

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

Card Licenses have been moved to license pool.

M8850_SF.1.28.MPSM8T1.CES.a >

After the feature licenses are moved from the MPSM card and installed in the switch license pool on the PXM processor card, the feature licenses are available for use by the MPSM cards installed in that switch

Step 3 When feature licenses are moved from the NVRAM on the MPSM card to the PXM license pool, the process is also referred to as registration of licenses with the switch.

Enter the dspliccd command to verify feature license registration into the switch license pool:

M8850_SF.1.28.MPSM8T1.CES.a > dspliccd

Card License Alarm:              None
Service Module Type:             MPSM8T1E1
Service Module Serial Number:    SAG07208RRA
Provisioning (addcon) Allowed:   YES
=========================================================
Needed License Type               Needed Licenses
-------------------               ---------------

=========================================================
Allocated License Type            Allocated licenses
----------------------            ------------------

=========================================================
Programmed  License Type          Programmed licenses
------------------------          -------------------
RateControl                       1

=========================================================
Programmed License Registered:   YES
License registration node:       M8850_SF
License registration chassis:    SCA062300GF
=========================================================

M8850_SF.1.28.MPSM8T1.CES.a >

This example shows that the Rate Control feature license has been registered, the name of the switch where the license has been registered, and the chassis serial number of the switch where the feature license has been registered.

Step 4 Enter the dsplics command on the PXM processor card to view the MPSM feature licenses installed in the PXM license pool:

M8850_SF.7.PXM.a > dsplics
M8850_SF                         System Rev: 05.00   Jul. 02, 2004 01:51:22 GMT
MGX8850                                              Node Alarm: MINOR
Licensed           License      Licenses   Licenses   Licenses
Card Type          Type         Installed  Allocated  Available
-----------------  -----------  ---------  ---------  ---------
MPSM-8T1E1         RateControl  1          0          1

M8850_SF.7.PXM.a > 

In this example, one Rate Control feature license has been successfully moved from the MPSM-8T1E1 card into the PXM license pool.


Allocating MPSM Feature Licenses

To allocate a feature license to an MPSM card, configure the card to use the licensed feature.

For example, to assign a channelized feature license to an MPSM card, enter the addport command and use the channelization parameters to channelize the line. If the license pool on the PXM has an available license for that feature and MPSM card type, that license is automatically assigned to the card and the feature is successfully configured.

If you try to configure an MPSM card to use a feature for which no licenses are available, the configuration attempt will fail. Once a license is assigned to an MPSM card, it is no longer available for use by other MPSM cards until it returns to the license pool.


NoteBecause the MPSM-8T1E1 card configured for Circuit Emulation services does not require any feature licenses, no feature licenses are allocated from the PXM license pool for any features or services configured on the MPSM-8T1-CES or MPSM-8E1-CES cards.

The rate control feature license is the only feature license available for the MPSM-8T1E1 card. This feature license is used by the MPSM-8T1E1 card when configured for Frame Relay services.


Managing MPSM Feature License Alarms

MPSM feature license alarms can occur at the node level or the slot level of the switch. The following sections describe these alarms:

Node License Alarm

Slot License Alarms


Note Because the MPSM-8T1E1 card configured for Circuit Emulation services does not require any feature licenses, no feature licenses alarms will be raised on the MPSM-8T1-CES or MPSM-8E1-CES cards. The following sections are useful in alerting the user to MPSM feature license alarm conditions that may occur for MPSM-8T1E1 cards configured for Frame Relay services.


Node License Alarm

Node license alarms can happen under the following conditions:

A switch configuration that was saved before licenses were added or transferred to and from the PXM license pool has been restored. Any mismatch between the actual license count and the restored license count generates a minor license alarm. To prevent this type of alarm, always save the switch configuration after you move, transfer, or add licenses.

The switch configuration is restored on a different node, or the Cisco MGX chassis is replaced with another chassis. Because licenses are authorized for a specific backplane serial number, such conditions will cause a mismatch between the physical backplane serial number and serial number recorded in the database.

When a node license alarm is raised, all cards that are using feature licenses go into the slot license alarm state. If no licenses are in use by the cards, no slot license alarms will be raised.

On PXM45 and PXM1E platforms, use the PXM dspndalms command to troubleshoot the node license alarm. On PXM1 platforms, use the PXM dspcd command to troubleshoot the node license alarm.

Node license alarms are cleared by validating licenses in the license pool. This is done by applying the special Rekey feature license to the node using the cnflic command. When the pool licenses are validated, any existing slot license alarms are also cleared and normal operation is restored. For the procedure to rekey feature licenses, see the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Configuration Guide, Release 5.1 and the Release Notes for Cisco MGX 8230, Cisco MGX 8250, and Cisco MGX 8850 (PXM1) Switches, Release 1.3.10.


Note If the switch is in node license alarm, you must rekey the PXM license pool before proceeding with any other license management tasks.


Slot License Alarms

Slot license alarms are raised under the following conditions:

When a node license alarm is raised, all cards that are using feature licenses go into the slot license alarm state. Slot license alarms raised under this condition are cleared by rekeying the PXM license pool.

The slot in alarm has acquired or oversubscribed one or more licenses while these licenses were not available in the license pool. For example, on the PXM1 platform this situation might occur when a card is configured to use licenses, the card slot configuration is removed with the PXM clrsmcnf command, the licenses are assigned to another card, and then the card slot configuration is restored. Slot license alarms raised under this condition are cleared by adding the required number of licenses to the PXM license pool or by releasing corresponding licenses from other slots so that they become available to the slot in alarm. If slots in alarm have redundancy, you must add licenses to cover both the primary and secondary slots to clear the alarms.

On the PXM card, use the dsplicalms and dspliccd <slot> commands to troubleshoot slot license alarms. On the MPSM card, use the dspcd and dspliccd commands to troubleshoot slot license alarms.

For the procedures to rekey feature licenses, recover feature licenses, and add feature licenses to the PXM license pool see the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Configuration Guide, Release 5.1 and the Release Notes for Cisco MGX 8230, Cisco MGX 8250, and Cisco MGX 8850 (PXM1) Switches, Release 1.3.10.


Note If the switch is in node license alarm, you must rekey the PXM license pool before proceeding with any other license management tasks.


When the switch is in slot license alarm, you have a grace period of 5 days (120 hours) to resolve the alarm(s). During the first 4 days (96 hours), traps are sent every 24 hours. For the final 24 hours of the grace period, traps are sent every hour of operation. If the alarms do not get cleared, the following actions are taken:

An event is logged indicating the expiration of the grace period for a given slot needing license(s).

A trap is sent hourly indicating the expiration of the grace period.

The addcon command is blocked on the slot in license alarm until the license alarms are cleared.

When the PXM license pool has been rekeyed or licenses have been added to the PXM license pool, provisioning is restored and the switch exits the license alarm state.

Managing Lines

"Preparing CESM and MPSM Lines and Ports for Communications," describes how to bring up (add) and modify CESM and MPSM card lines. The following sections provide procedures for doing the following:

Displaying a List of Lines

Displaying the Configuration for a Single Line

Bringing Down a Line

Managing Line Alarms


Note This section provides procedures for some of the most common line management commands. For a complete list of line management commands, refer to Table 6-3 in Chapter 6, "CESM and MPSM Command Reference."


Displaying a List of Lines

To display a list of lines on the CESM or MPSM card, enter the dsplns command as follows:

PXM1E_SJ.1.20.CESM.a > dsplns

  Line  Conn      Type     Status/Coding      Length     XmtClock Alarm Stats
        Type                                             Source         Alarm
  ----  ----- ------------ ------ -------- ------------- -------- ----- -----
  20.1  RJ-48 dsx1ESF         Ena/dsx1B8ZS 0-131 ft      LocalTim  No    No 
  20.2  RJ-48 dsx1ESF         Ena/dsx1B8ZS 0-131 ft      LocalTim  No    No 
  20.3  RJ-48 dsx1ESF         Ena/dsx1B8ZS 0-131 ft      LocalTim  No    No 
  20.4  RJ-48 dsx1ESF         Ena/dsx1B8ZS 0-131 ft      LocalTim  Yes   No 
  20.5  RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  20.6  RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  20.7  RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  20.8  RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           

  LineNumOfValidEntries: 8

PXM1E_SJ.1.20.CESM.a >

The line number is found in the Line column in the format Slot.Line.

Displaying the Configuration for a Single Line

To display the configuration of a single line on the CESM or MPSM card, enter the dspln command as follows:

PXM1E_SJ.1.20.CESM.a > dspln <line>

Enter the line number with the command. You can view the available line numbers in the dsplns display.

The following example shows the information you can display with the dspln command on the CESM card:

PXM1E_SJ.1.20.CESM.a > dspln 8

  LineNum:                   8
  LineConnectorType:         RJ-48
  LineEnable:                Modify
  LineType:                  dsx1ESF
  LineCoding:                dsx1B8ZS
  LineLength:                0-131 ft
  LineXmtClockSource:        LocalTiming
  LineLoopbackCommand:       LocalLineLoop
  LineSendCode:              NoCode
  LineUsedTimeslotsBitMap:   0x0
  LineLoopbackCodeDetection: codeDetectDisabled
  
  LineNumOfValidEntries: 8

PXM1E_SJ.1.20.CESM.a >

The following example shows the information you can display with the dspln command on the MPSM card:

M8250_SJ.1.6.MPSM8T1.CES.a > dspln 1

  LineNum:                   1
  LineConnectorType:         RJ-48
  LineType:                  dsx1ESF
  LineEnable:                Enabled
  LineCoding:                dsx1B8ZS
  LineLength:                0-131 ft
  LineXmtClockSource:        LocalTiming
  LineLoopbackCommand:       NoLoop
  LineSendCode:              NoCode
  LineUsedTimeslotsBitMap:   0x0
  LineLoopbackCodeDetection: codeDetectDisabled
  LineBERTEnable:            Disable

  LineNumOfValidEntries: 8

M8250_SJ.1.6.MPSM8T1.CES.a > 

Bringing Down a Line

When a line is not working properly, it generates a line alarm. If you want to suppress the alarm and you do not have time to correct the problem, you can bring down the line. Bringing down the line takes it out of service, so no alarms are generated.


Tip You can reduce the level of an alarm on a failed line from major to minor by using the addlnloop command to place the line in local loopback mode. This does not completely eliminate the alarm, but it does reduce the severity and allow you to preserve the configured resources for that line.


To bring down a line, use the following procedure.


Step 1 Delete all connections that are associated with the line (dspcons and delcon commands).


Tip Connections are associated with ports (dspcons), and ports are associated with lines (dspports). To determine which connections use a line, first determine which ports are configured for that line.


Step 2 Delete all ports that are associated with the line (delport command).


Tip When a port is deleted, the resource partition associated with that port is also deleted at the same time. Therefore, it is not necessary to delete the port resource partition prior to deleting the port.


Step 3 Enter the delln command as follows:

PXM1E_SJ.1.20.CESM.a > delln <line>

Enter the line number with the command. You can view the available line numbers in the dsplns display.

The following example shows how to use the delln command:

PXM1E_SJ.1.20.CESM.a > delln 8

PXM1E_SJ.1.20.CESM.a >


Managing Line Alarms

CESM and MPSM cards generate line alarms when problems occur. When a loss of signal (LOS) alarm is detected, a CESM or MPSM card notifies the connected CPE in the upstream direction after an integration period. The CESM or MPSM card then continues to emit cells at the nominal rate but sets the ATM cell payload with an appropriate data pattern as specified by the ATM Forum CES-IS V2.0 specification. Also, an OAM cell with RDI code goes to the far end to indicate out-of-service. The significance of the different types of alarms appears in Table 5-2.

Table 5-2 CESM and MPSM Line Errors and Alarms 

Error
Alarm
Type
Transmit Downstream
Transmit Upstream
Comments

Receive LOS

Red

AIS

RAI

Receive LOF

Red

AIS

RAI

Receive AIS

Blue (AIS)

AIS (link)

FERF OAM cells

AIS—done over the T1/E1 link by sending the AIS data over the T1/E1 link

Receive RAI

Yellow

RAI

ATM Link Failure (RX)

Red (AIS)

AIS—OAM cells

None

Data cells According to ATM-Forum CES-IS V 2.0



Tip For more information on T1 and E1 signaling procedures and alarms, refer to the ATM Forum Circuit Emulation Service Interoperability Specification (AF-SAA-0032.00) or the Bellcore TR-NWT-000170.


Use the commands in table Table 5-3 to display, clear, and configure CESM and MPSM line alarms.

Table 5-3 CESM and MPSM Line Alarm Commands 

Command
Purpose

dspalm

Enter this command to display the active alarms associated with a specific line.

dspalms

Enter this command to display a summary of the active line alarms.

dspalmcnf

Enter this command to display the alarm configuration and thresholds for a specific line.

dspalmcnt

Enter this command to display the alarm counters for a specific line.

clralm

Enter this command to clear any active alarms on a specific line (Alarms will not clear if the cause for the alarm is still present).

clralms

Enter this command to clear active alarms on all lines (Alarms will not clear if the cause for the alarm is still present).

clralmcnt

Enter this command to clear the alarm counters for a specific line.

clralmcnts

Enter this command to clear the alarm counters for all lines.

xcnfalm

Enter this command to modify alarm counters, thresholds, and statistics for a specific line.

xcnfalmcnt

Enter this command to modify threshold values of statistical alarm counters for a specific line.


Table 5-4 lists other CESM and MPSM card alarms and shows how these alarms affect the transmit and receive channels for a line.

Table 5-4 CESM and MPSM Card Alarms 

Type of
Alarm
Channel RCV ATM State
Channel XMT ATM State
Action

Port Alarm

Sending AIS OAM

Generate OAM-AIS towards the network

Abit (from PXM)

Normal

Normal

Underrun

Normal

Normal

Conditioning towards line

Overrun

Normal

Normal

Conditioning towards line



Note When the line is in alarm, the line alarm trap is sent. There are no separate traps sent for the ports or for the connections that go into alarm due to the line alarm. Similarly when the port is in alarm, the port alarm trap is sent and no separate traps are sent for the connections that go into alarm due to the port alarm.


Managing Ports

"Preparing CESM and MPSM Lines and Ports for Communications," describes how to add logical ports to the lines on CESM and MPSM cards. The following sections provide procedures for doing the following:

Displaying a List of Ports

Displaying the Status of a Single Port

Changing a Port Configuration

Deleting Ports

Displaying a List of Ports

To display a list of ports provisioned on the CESM or MPSM card, enter the dspports command as follows:

PXM1E_SJ.1.4.CESM.a > dspports

  Port     Ena/Speed   Type
  ------   --- ------ --------
  4.1.1    Add/1536k structur
  4.2.2    Add/1536k structur
  4.3.3    Add/1536k structur
  4.4.4    Add/1536k structur

  Number of ports:              4

  PortDs0UsedLine1:             0x00ffffff
  PortDs0UsedLine2:             0x00ffffff
  PortDs0UsedLine3:             0x00ffffff
  PortDs0UsedLine4:             0x00ffffff
  PortDs0UsedLine5:             0x00000000
  PortDs0UsedLine6:             0x00000000
  PortDs0UsedLine7:             0x00000000
  PortDs0UsedLine8:             0x00000000
  PortNumNextAvailable:         5

PXM1E_SJ.1.4.CESM.a >

The port number is found in the Port column in the format Slot.Line.Port. For more information on a single port, use the dspport command.

Displaying the Status of a Single Port

To display the configuration and status of a single provisioned port on the CESM or MPSM card, enter the dspport command as follows:

PXM1E_SJ.1.4.CESM.a > dspport <port>

Enter the port number with the command. You can view the provisioned port numbers in the dspports display.

The following example shows the dspport report for a CESM-8T1/B card.

PXM1E_SJ.1.4.CESM.a > dspport 1

  SlotNum:                      4
  PortLineNum:                  1
  PortNum:                      1
  PortRowStatus:                Add
  PortNumOfSlots:               24
  PortDs0ConfigBitMap(1stDS0):  0xffffff(1)
  PortSpeed:                    1536kbps
  PortType:                     structured
  PortState:                    Active


PXM1E_SJ.1.4.CESM.a >

Changing a Port Configuration

To modify a circuit emulation port configuration that has been added using the addport command on a CESM or MPSM card, you must first delete the port using the delport command. Add the port again with the new port configuration parameters using the addport command.


Tip If there are any SPVC or PVC connections provisioned on the port, these must be deleted before you can change the port configuration.


Deleting Ports

To delete a Circuit Emulation port on a CESM or MPSM card, use the following procedure.


Step 1 Delete all connections that are associated with the port (dspcons and delcon commands).

Step 2 Enter the delport command as follows:

PXM1E_SJ.1.20.CESM.a > delport <port>

Replace the port parameter with the port number you want to delete. Port numbers are listed in the dspports command display.


Tip When a port is deleted, the resource partition associated with that port is also deleted at the same time. Therefore, it is not necessary to delete the port resource partition prior to deleting the port.


The following example shows how to use the delport command:

PXM1E_SJ.1.20.CESM.a > delport 1

PXM1E_SJ.1.20.CESM.a >

To delete multiple CESM or MPSM ports, enter the delports command as described in Chapter 6, "CESM and MPSM Command Reference."


Managing Resource Partitions

Resource partitions define how a switch's limited resources are distributed between two or more virtual switch controllers. By defining the limits of the resources available to each controller, competition and overlap is eliminated for these resources.

How resource partitions are managed on CESM and MPSM cards is dependent upon the platform in which the service modules are provisioned. On PXM1 platforms, service module resource partitions are managed on both the card level and the port level. On PXM45 and PXM1E platforms, service module resource partitions are managed only on the port level.

When a card is first brought up, the card resource partition consists of each controller sharing the maximum number of connections available for the service module type. This equal sharing of card level resources may be modified to eliminate resource conflicts.

When a port is added, a port resource partition is created and consists of the number of connections, the range of connection identifiers, and the ingress and egress bandwidth available to each controller. By default, the port resources are fully shared among the controllers and the connection values are inherited from the card resource partition. Port level resources may also be modified to eliminate resource conflicts.

These topics describe resource partitions on Cisco MGX switch platforms:

Resource Partitions on PXM45 and PXM1E Based Switches

Resource Partitions on PXM1 Based Switches

Resource Partitions on PXM45 and PXM1E Based Switches

On the PXM45 and PXM1E platforms, CESM and MPSM resource partitions are managed only on the port level. Cisco MGX Release 5.1 supports only the PNNI controller on service modules, so all port resources are assigned to the PNNI controller when a port is added. This resource assignment is automatically made by the software and results in the creation of a resource partition for the port.

The following section, "Managing Port Resource Partitions on PXM45 and PXM1E Based Switches", describes how to manage port resource partitions on PXM45 and PXM1E based switches.

Managing Port Resource Partitions on PXM45 and PXM1E Based Switches

The following tasks describe how to manage port resource partitions on CESM and MPSM cards installed in PXM45 and PXM1E based switches:

Displaying a Port Resource Partition Configuration on PXM45 and PXM1E Based Switches

Adding a Port Resource Partition on PXM45 and PXM1E Based Switches

Modifying a Port Resource Partition on PXM45 and PXM1E Based Switches

Deleting a Port Resource Partition Configuration on PXM45 and PXM1E Based Switches

During the normal operation of CESM and MPSM cards, you will not need to add a port resource partition. Port resource partitions are created automatically when you add a port to a line.

On the MPSM card, you can view the port resource partition configuration, make changes to it, or delete it. If you delete a port resource partition, you will have to add a new partition for that port before you can assign connections to the port. On the CESM card, you can view the port resource partition configuration and delete it, but you cannot modify it.

Table 5-5 lists the CESM and MPSM port resource partition commands supported on PXM45 and PXM1E platforms in Cisco MGX Release 5.1. For more information on these commands, see Chapter 6, "CESM and MPSM Command Reference."

Table 5-5 CESM/MPSM Port Resource Partitioning Commands (PXM45/PXM1E Platform) 

Command
MPSM-8T1-CES
MPSM-8E1-CES
CESM-8T1/B
CESM-8T1
CESM-8E1

addrscprtn

X

X

cnfrscprtn

X

 

delrscprtn

X

X

dsprscprtn

X1

X

xcnfrscprtn

X

 

cnfportrscprtn

X2

 

dspportrscprtn

X3

 

1 This command gives the same output as the dspportrscprtn command.

2 This command does nothing except change the partition status to modified. There are no options supported.

3 This command gives the same output as the dsprscprtn command.


Displaying a Port Resource Partition Configuration on PXM45 and PXM1E Based Switches

To display the resource partition configuration of a port on a CESM or MPSM card, enter the dsprscprtn command as follows:

PXM1E_SJ.1.4.CESM.a > dsprscprtn <port>

Replace the port parameter with the port number. For example:

PXM1E_SJ.1.4.CESM.a > dsprscprtn 1

  Port  User  Status  NumOfLcnAvail   LcnLow   LcnHigh   IngrBW  EgrBW CtrlrId
  ---- ------ ------ --------------  -------- ---------  ------  ----- --------
   1    PNNI   Add          1           1         1        100     100    2  


PXM1E_SJ.1.4.CESM.a >

Adding a Port Resource Partition on PXM45 and PXM1E Based Switches

To add a resource partition to a port on a CESM or MPSM card, enter the addrscprtn command as follows:

PXM1E_SJ.1.4.CESM.a > addrscprtn <port_num> <cntrlr_type> <cntrlr_id>

Table 5-6 lists and describes the parameters for the addrscprtn command on PXM45 and PXM1E platforms in Cisco MGX Release 5.1.

Table 5-6 Parameters for the addrscprtn/delrscprtn Commands 

Parameter
Description

port_num

Port number associated with the resource partition to be added or deleted. You must add a port to a line before you can define a partition for a port. Use the dspports command to view the available ports. The port number is found in the Port column in the format Slot.Line.Port.

cntrlr_type

Controller for this partition. Enter 2 as the PNNI controller is the only controller type supported in MGX Release 5.1.

1 = PAR (PVC)

2 = PNNI (SPVC)

3 = TAG (MPLS)

cntrlr_id

If adding a resource partition, enter a number that will be associated with the controller used by this partition. Range is 1 to 255.

If deleting a resource partition, enter the controller ID assigned to the partition you are deleting. To display the controller ID, use the dsprscprtn command. Valid range is from 1 to 255.


The following example adds a resource partition to a CESM port after the default partition was deleted:

PXM1E_SJ.1.4.CESM.a > addrscprtn 1 2 2

PXM1E_SJ.1.4.CESM.a >

Modifying a Port Resource Partition on PXM45 and PXM1E Based Switches

To modify the resource partition of a port on an MPSM card, enter the cnfrscprtn command as follows:

M8850_SF.1.28.MPSM8T1.CES.a > cnfrscprtn <port_num> <cntrlr> <pct_bw_ingr> <pct_bw_egr> 
<low_lcn> <high_lcn> <numOfLcnAvail>

Table 5-7 lists and describes the parameters for the cnfrscprtn command on PXM45 and PXM1E platforms in Cisco MGX Release 5.1.

Table 5-7 Parameters for the cnfrscprtn Command 

Parameter
Description

port_num

Port number associated with the resource partition to be modified. You must add a port to a line before you can modify the resource partition on a port. Use the dspports command to view the available ports. The port number is found in the Port column in the format Slot.Line.Port.

cntrlr

Controller for this partition. Enter 2 as the PNNI controller is the only controller type supported in MGX Release 5.1.

1 = PAR (PVC)

2 = PNNI (SPVC)

3 = TAG (MPLS)

pct_bw_ingr

Ingress bandwidth percentage. Enter the percentage of the line bandwidth to be used by this controller for ingress communications. Range is 0 to 100 percent.

pct_bw_egr

Egress bandwidth percentage. Enter the percentage of the line bandwidth to be used by this controller for egress communications. Range is 0 to 100 percent.

low_lcn

Low LCN number available in this port resource partition. Range is 1 to 1000.

high_lcn

High LCN number available in this port resource partition. Range is 1 to 1000.

numOfLcnAvail

Maximum LCNs (connections) available in this port resource partition. Range by card type:

CESM-8T1/B, CESM-8T1, MPSM-8T1-CES: 1-192

CESM-8E1, MPSM-8E1-CES: 1-248


The following example changes the PNNI port resource partition configured on port 1 of an MPSM card to use an ingress and egress bandwidth of 50 percent, a low LCN number of 1, a high LCN number of 1, and the maximum connections available as 1:

M8850_SF.1.28.MPSM8T1.CES.a > cnfrscprtn 1 2 50 50 1 1 1

M8850_SF.1.28.MPSM8T1.CES.a > 

Deleting a Port Resource Partition Configuration on PXM45 and PXM1E Based Switches

To delete the resource partition configuration of a port on a CESM or MPSM card, use the following procedure.


Step 1 Delete all connections that are associated with the port resource partition (dspcons and delcon commands).

Step 2 Enter the delrscprtn command as follows:

PXM1E_SJ.1.30.CESM.a > delrscprtn <port_num> <cntrlr_type> <cntrlr_id>

Table 5-6 lists and describes the parameters for the delrscprtn command.

The following example shows how to use the delrscprtn command:

PXM1E_SJ.1.30.CESM.a > delrscprtn 6 2 2

PXM1E_SJ.1.30.CESM.a >


Resource Partitions on PXM1 Based Switches

On the PXM1 platform, CESM and MPSM resource partitions are managed on both the card level and the port level. Cisco MGX Release 1.3 supports only the PAR controller on service modules, so all card and port resources are assigned to the PAR controller when a card is brought up and a port is added even though the PNNI and TAG controllers are present in the card and port partition display commands. This resource assignment is automatically made by the software and results in the creation of a resource partition for the card and the port.

The following topics describe how to manage card and port resource partitions on PXM1 based switches:

Managing Card Resource Partitions on PXM1 Based Switches

Managing Port Resource Partitions on PXM1 Based Switches

Managing Card Resource Partitions on PXM1 Based Switches

The following tasks describe how to manage card resource partitions on PXM1 switches:

Displaying a Card Resource Partition Type on PXM1 Based Switches

Displaying a Card Resource Partition Configuration on PXM1 Based Switches

Adding a Card Resource Partition on PXM1 Based Switches

Modifying a Card Resource Partition on PXM1 Based Switches

Deleting a Card Resource Partition Configuration on PXM1 Based Switches

On the CESM-8T1/B, CESM-8T1, CESM-8E1, and MPSM cards, the card resource partition type is not configurable. The default setting on these cards is for a Port Controller Based card resource partition type.

During the normal operation of CESM and MPSM cards, you will not need to add a card resource partition. Card resource partitions are created automatically when you bring up a card.

On the MPSM card you can view the card resource partition configuration, make changes to it, or delete it. If you delete a card resource partition, you will have to add a new partition for that card before you can assign ports to the card. On the 8-port CESM cards you can only view and make changes to the card resource partition.

Table 5-8 lists the CESM and MPSM card resource partition commands supported on PXM1 platforms in Cisco MGX Release 1.3. For more information on these commands, see Chapter 6, "CESM and MPSM Command Reference."

Table 5-8 CESM/MPSM Card Resource Partitioning Commands (PXM1 Platform) 

Command
MPSM-8T1-CES
MPSM-8E1-CES
CESM-8T1/B
CESM-8T1
CESM-8E1

cnfcdprtntype

X1

X1

dspcdprtntype

X

X

xcnfcdprtntype

X1

X1

addcdrscprtn

X

X2

cnfcdrscprtn

X3

X

delcdrscprtn

X

X1

dspcdrscprtn

X

X

xcnfcdrscprtn

X4

X5

1 This command is in the CLI, but it is not supported.

2 This command will modify the card resource partition if the status of the card resource partition is modified.

3 This command modifies all controllers. All controllers do not have to be present. Does not add controllers not present in the card resource partition.

4 This command cannot add or delete, only modify.

5 This command cannot add or delete, only modify. The add parameter will modify if the status of the card resource partition is modified


Displaying a Card Resource Partition Type on PXM1 Based Switches

To display the card resource partition type of a CESM or MPSM card, enter the dspcdprtntype command as follows:

M8250_SJ.1.22.MPSM8T1.CES.a > dspcdprtntype

   cardLcnPartitionType: port controller based

M8250_SJ.1.22.MPSM8T1.CES.a >

Displaying a Card Resource Partition Configuration on PXM1 Based Switches

To display the card resource partition configuration of a CESM or MPSM card, enter the dspcdrscprtn command as follows:

M8250_SJ.1.22.MPSM8T1.CES.a > dspcdrscprtn

User   NumOfLcnAvail
------  -------------
   PAR         192  
   PNNI        192  
   TAG         192  


M8250_SJ.1.22.MPSM8T1.CES.a > 


Note In this example, although the PAR controller is the only controller supported on the CESM and MPSM cards on PXM1 platforms, the PNNI and TAG controllers are also present in the display output.


Adding a Card Resource Partition on PXM1 Based Switches

To add a card resource partition to a CESM or MPSM card, enter the addcdrscprtn command as follows:

M8250_SJ.1.22.MPSM8T1.CES.a > addcdrscprtn <controller> <numOfLcnAvail>

Table 5-9 lists and describes the parameters for the addcdrscprtn command on PXM1 platforms in Cisco MGX Release 1.3.

Table 5-9 Parameters for the addcdrscprtn Command 

Parameter
Description

controller

Controller type for the resource partition.

1 = PAR (PVC)

2 = PNNI (SPVC)

3 = TAG (MPLS)

numOfLcnAvail

Number of LCNs (connections) available for the resource partition. Range by card type:

CESM-8T1/B, CESM-8T1, MPSM-8T1-CES range: 1-192

CESM-8E1, MPSM-8E1-CES range: 1-248


The following example adds a card resource partition to an MPSM card after the default partition was deleted.

M8250_SJ.1.22.MPSM8T1.CES.a > addcdrscprtn 1 100

M8250_SJ.1.22.MPSM8T1.CES.a >

Modifying a Card Resource Partition on PXM1 Based Switches

To modify the card resource partition on a CESM or MPSM card, enter the cnfcdrscprtn command as follows:

M8250_SJ.1.22.MPSM8T1.CES.a > cnfcdrscprtn <#PARcon> <#PNNIcon> <#TAGcon>

Table 5-10 lists and describes the parameters for the cnfcdrscprtn command on PXM1 platforms in Cisco MGX Release 1.3.

Table 5-10 Parameters for the cnfcdrscprtn Command 

Parameter
Description

#PARcon
#PNNIcon
#TAGcon

Maximum number of connections (LCNs) available to the PAR, PNNI, and TAG controllers. Range by card type:

CESM-8T1/B, CESM-8T1, MPSM-8T1-CES range: 1-192

CESM-8E1, MPSM-8E1-CES range: 1-248


The following example configures an MPSM card to support up to 100 connections per controller:

M8250_SJ.1.22.MPSM8T1.CES.a > cnfcdrscprtn 100 100 100

M8250_SJ.1.22.MPSM8T1.CES.a >

Deleting a Card Resource Partition Configuration on PXM1 Based Switches

To delete a card resource partition on a CESM or MPSM card, enter the delcdrscprtn command as follows:

M8250_SJ.1.22.MPSM8T1.CES.a > delcdrscprtn <controller>

Table 5-11 lists and describes the parameters for the delcdrscprtn command on PXM1 platforms in Cisco MGX Release 1.3.

Table 5-11 Parameters for the delcdrscprtn Command 

Parameter
Description

controller

Controller of the resource partition to delete:

1 = PAR (PVC)

2 = PNNI (SPVC)

3 = TAG (MPLS)


The following example deletes a PNNI card resource partition from an MPSM card:

M8250_SJ.1.22.MPSM8T1.CES.a > delcdrscprtn 2

M8250_SJ.1.22.MPSM8T1.CES.a >

The delcdrscprtn command is not supported on the 8-port CESM cards.

Managing Port Resource Partitions on PXM1 Based Switches

The following tasks describe how to manage port resource partitions on PXM1 switches:

Displaying a Port Resource Partition Configuration on PXM1 Based Switches

Modifying a Port Resource Partition on PXM1 Based Switches

On the CESM and MPSM cards, you can only view and make changes to the port resource partition configuration. The port resource partitions are created automatically when you add a port to a line.

Table 5-12 lists the CESM and MPSM port resource partition commands supported on PXM1 platforms in Cisco MGX Release 1.3. For more information on these commands, see Chapter 6, "CESM and MPSM Command Reference."

Table 5-12 CESM/MPSM Port Resource Partitioning Commands (PXM1 Platform) 

Command
MPSM-8T1-CES
MPSM-8E1-CES
CESM-8T1/B
CESM-8T1
CESM-8E1

addrscprtn

X1

X1

cnfrscprtn

X

X

delrscprtn

X2

X2

dsprscprtn

X3

 

xcnfrscprtn

X4

X4

cnfportrscprtn

X5

X5

dspportrscprtn

X6

X

1 This command is supported if the status of the card resource partition is modified.

2 This command is in the CLI, but it is not supported.

3 This command gives the same output as the dspportrscprtn command.

4 This command cannot add or delete, only modify. The add parameter will modify if the status of the port resource partition is modified.

5 This command does nothing except change the partition status to modified. There are no options supported

6 This command gives the same output as the dsprscprtn command.


Displaying a Port Resource Partition Configuration on PXM1 Based Switches

To display the resource partition configuration of a port on a CESM or MPSM card, enter the dspportrscprtn command as follows:

M8250_SJ.1.22.MPSM8T1.CES.a > dspportrscprtn

  Port  User  Status  NumOfLcnAvail   LcnLow   LcnHigh   IngrBW  EgrBW 
  ---- ------ ------ --------------  -------- ---------  ------  -----
   1    PAR    Add          1           0         0        100     100
   1    PNNI   Add          1           0         0        100     100
   1    TAG    Add          1           0         0        100     100


M8250_SJ.1.22.MPSM8T1.CES.a > 

Modifying a Port Resource Partition on PXM1 Based Switches

To modify a resource partition of a port on a CESM or MPSM card, enter the cnfrscprtn command as follows:

M8250_SJ.1.22.MPSM8T1.CES.a > cnfrscprtn <port_num> <cntrl> <pct_bw_ingr> <pct_bw_egr> 
<low_lcn> <high_lcn> <numOfLcnAvail>

Table 5-13 lists and describes the parameters for the cnfrscprtn command on PXM1 platforms in Cisco MGX Release 1.3.

Table 5-13 Parameters for the cnfrscprtn Command 

Parameter
Description

port_num

Port number associated with the resource partition to be modified. You must add a port to a line before you can modify the resource partition on a port. Use the dspports command to view the available ports.

cntrlr

Controller for this partition:

1 = PAR (PVC)

2 = PNNI (SPVC)

3 = TAG (MPLS)

pct_bw_ingr

Ingress bandwidth percentage. Enter the percentage of the line bandwidth to be used by this controller for ingress communications. Range is 0 to 100 percent.

pct_bw_egr

Egress bandwidth percentage. Enter the percentage of the line bandwidth to be used by this controller for egress communications. Range is 0 to 100 percent.

low_lcn

Low LCN number available in this port resource partition. Range is 1 to 1000.

high_lcn

High LCN number available in this port resource partition. Range is 1 to 1000.

numOfLcnAvail

Maximum LCNs (connections) available in this port resource partition. Range by card type:

CESM-8T1/B, CESM-8T1, MPSM-8T1-CES: 1-192

CESM-8E1, MPSM-8E1-CES: 1-248


The following example modifies a port resource partition on an MPSM card:

M8250_SJ.1.22.MPSM8T1.CES.a > cnfrscprtn 1 1 50 50 1 1 1

M8250_SJ.1.22.MPSM8T1.CES.a > 

Managing Connections

"Provisioning SPVCs (PXM1E/PXM45) on CESM and MPSM Cards," and "Provisioning PVCs (PXM1) on CESM and MPSM Cards," describe how to add connections to CESM and MPSM cards. The following sections provide procedures for doing the following:

Displaying a List of Connections

Displaying the Status of a Single Connection

Deleting SPVC Connections

Deleting PVC Connections

Testing Connections

Monitoring Connection Statistics

Displaying Connection Alarms

Displaying a List of Connections

Enter the dspcons command to display a list of the connections provisioned on the current CESM or MPSM card.

This example shows the connections provisioned on an MPSM-8T1-CES card installed in a PXM1E platform:

PXM1E_SJ.1.4.CESM.a > dspcons

  LCN  Port.VPI.VCI Type M/S Clock PCR    CDVT  BufSz CLIP  Admin Alarm 
  ---- ------------ ---- --- ----- ------ ----- ----- ----- ----- ----- 
  0035 001.04.035   stru S   Synch 4096   00500 00384 02500 Up    OK        
  0036 002.04.036   stru M   Synch 4096   01000 00384 02500 Up    OK        
  0037 003.04.037   stru S   Synch 4096   01000 00384 02500 Up    CTRLR-ABIT

  Number of channels:    3

  ChanNumNextAvailable:  38

PXM1E_SJ.1.4.CESM.a >

This example shows the connections provisioned on a CESM-8T1 card installed in a PXM1 platform:

M8250_SJ.1.3.CESM.a > dspcons

  Line     ConnId           ChNum Status CDVT  BufSize CLIP  CBRserv  Alarm
  ---- -------------------- ----- ------ ----- ------- ----- -------- -----
     1 M8250_SJ.3.1.0        32   Add     1000   192    2500   struct  Okay

  ChanNumNextAvailable:  33

M8250_SJ.1.3.CESM.a > 

To determine if a connection is in alarm, check the status in the Alarm column. For more information on a single connection, use the dspcon command.

Displaying the Status of a Single Connection

To display the configuration and status of a single connection, enter the dspcon command as follows:

PXM1E_SJ.1.4.CESM.a > dspcon <port>

Enter the port number with the command. You can view the port numbers in the dspcons display.

This example shows the configuration and status of a single connection provisioned on a CESM card installed in a PXM45 platform:

M8850_SF.1.30.CESM.a > dspcon 1

  -------------------------------------------
  ChanNum:   35         RowStatus: Add       
  AdmnState: Up         ChanState: Ok        
  ---------- ---------- ---------- ---------- 
  PORT-ALARM CTRLR-ABIT E-AIS/RDI  CELL-LOSS  
  ---------- ---------- ---------- ---------- 
      NO         NO         NO         NO     
  -------------------------------------------

  ChanNum:                  35
  ChanRowStatus:            Add
  ConnAdminStatus:          Up
  ChanLineNum:              1
  ChanMapVpi:               30
  ChanMapVci:               35
  ChanCBRService:           struct
  ChanClockMode:            Synchronous
  ChanCAS:                  Basic
  ChanPartialFill:          47
  ChanMaxBufSize:           240 bytes
  ChanCDVT:                 1000 micro seconds
  C L I P:                  2500 milliseconds
  ChanLocalRemoteLpbkState: Disabled
  ChanTestType:             TestOff
  ChanTestState:            NotInProgress
  ChanRTDresult:            65535 ms
  ChanPortNum               1
  ChanConnType              SPVC
  ISDetType                 DetectionDisabled
  CondData                  255
  CondSignalling            15
  ExtISTrig                 DisableIdleSupression
  ISIntgnPeriod             3 seconds 
  ISSignallingCode          0
  OnHookCode                1
  ChanLocalVpi:             30
  ChanLocalVci:             35
  ChanLocalNSAP:            47009181000000000164444b6100000107f30100
  ChanRemoteVpi:            0
  ChanRemoteVci:            0
  ChanRemoteNSAP:           NULL NSAP
  ChanMastership:           Slave
  ChanVpcFlag:              Vcc
  ChanConnServiceType:      CBR1
  ChanRoutingPriority:      8
  ChanPreferredRouteId:     0
  ChanDirectedRoute:        No
  ChanMaxCost:              2147483647
  ChanRestrictTrunkType:    No Restriction
  ChanConnPCR:              2560
  ChanConnMCR:              2560
  ChanConnPercentUtil:      100
  Channel Reroute:          False

  ChanNumNextAvailable:  37

This example shows the configuration and status of a connection provisioned on a CESM card installed in a PXM1 platform:

M8250_SJ.1.3.CESM.a > dspcon 1

  ChanNum:                  32
  ChanRowStatus:            Add
  ChanLineNum:              1
  ChanMapVpi:               3
  ChanMapVci:               32
  ChanCBRService:           struct
  ChanClockMode:            Synchronous
  ChanCAS:                  Basic
  ChanPartialFill:          47
  ChanMaxBufSize:           192 bytes
  ChanCDVT:                  1000 micro seconds
  C L I P:                  2500 milliseconds
  ChanLocalRemoteLpbkState: Disabled
  ChanTestType:             TestOff
  ChanTestState:            NotInProgress
  ChanRTDresult:            65535 ms
  ChanPortNum               1
  ChanConnType              PVC
  ISDetType                 DetectionDisabled
  CondData                  255
  CondSignalling            15
  ExtISTrig                 DisableIdleSupression
  ISIntgnPeriod             3 seconds 
  ISSignallingCode          0
  OnHookCode                1
  ChanLocalVpi:             0
  ChanLocalVci:             0
  ChanLocalNSAP:            4d383235305f534a000000000000000003000100
  ChanRemoteVpi:            11
  ChanRemoteVci:            100
  ChanRemoteNSAP:           4d383235305f534a000000000000000000000100
  ChanMastership:           Master
  ChanVpcFlag:              Vcc
  ChanConnServiceType:      CBR
  ChanRoutingPriority:      1
  ChanMaxCost:              2147483647
  ChanRestrictTrunkType:    No Restriction
  ChanConnPCR:              2048
  ChanConnMCR:              2048
  ChanConnPercentUtil:      100

  ChanNumNextAvailable:  33

M8250_SJ.1.3.CESM.a > 

Deleting SPVC Connections

Each SPVC connection has two endpoints. To completely delete a connection, you need to delete both endpoints. To delete an SPVC connection endpoint, enter the delcon command, as shown below:

PXM1E_SJ.1.4.CESM.a > delcon <port>

Replace the port parameter with the port number for the connection you want to delete. On PXM1E and PXM45 platforms, the port number is found in the Port.VPI.VCI column in the output of the dspcons command.

The delcon command deletes one end of the connection. Note, however, that this command does not delete the other end of the SPVC. The other endpoint of the SPVC can reside on the same service module, on a different service module located in the same switch, or on a service module located in a different switch. Issue the delcon command at the location of where the other endpoint is located to completely delete the SPVC connection.

Deleting PVC Connections

Each PVC connection has two endpoints. To completely delete a connection, you need to delete both endpoints. How a PVC is deleted depends upon whether the PVC is a feeder segment connection or a local connection.

To delete a feeder segment connection, perform the following steps:


Step 1 Establish a configuration session using a user name with GROUP1 privileges or higher.

Step 2 On the local CESM or MPSM card that hosts the feeder segment connection, enter the delcon command as shown below:

M8850_R1.1.2.CESM.a > delcon <port_num>

Replace the port parameter with the port number for the connection you want to delete. On the PXM1 platform, the port number is found in the ConnID column in the format Nodename.Slot.Port.0 in the output of the dspcons command.

Since feeder segment connections are added only as master connections from a service module user port to a PXM1 feeder trunk, the delcon command will delete both ends of the feeder segment connection.

Step 3 If the PVC you are deleting is part of a two segment feeder connection, delete the routing connection in the ATM core network. Refer to the software configuration guides for the switches in the ATM core network for instructions on deleting connections. See the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Configuration Guide, Release 5.1 or the Cisco BPX 8600 Series Installation and Configuration, Release 9.3.30.

Step 4 If the PVC you are deleting is part of a three segment feeder connection, delete the routing connection in the ATM core network, and then log in to the remote feeder switch and delete the feeder connection on the remote service module.

If the feeder connection on the remote switch originates from a CESM or MPSM user port, use the delcon command as outlined in step 2 to delete the feeder segment connection.

If the feeder connection on the remote feeder switch originates from a user port on a card other than a Circuit Emulation service module, refer to the documentation for that card for instructions on deleting the connection.


To delete a local connection on a feeder switch or standalone switch, perform the following steps:


Step 1 Establish a configuration session using a user name with GROUP1 privileges or higher.

Step 2 On the CESM or MPSM card that hosts one end of the local connection, enter the delcon command as shown below:

M8850_R1.1.2.CESM.a > delcon <port_num>

Replace the port parameter with the port number for the connection you want to delete. On the PXM1 platform, the port number is found in the ConnID column in the format Nodename.Slot.Port.0 in the output of the dspcons command.

Since local connections are added as slave and master endpoints, the delcon command deletes only one endpoint of the local connection. The other endpoint of the local connection can reside on a user port located on the same service module, or on a user port located on a different service module in the same switch.

Step 3 If the other end of the local connection is located on a CESM or MPSM user port, use the delcon command as outlined in step 2 to delete the endpoint.

If the other endpoint of the local connection is located on a user port on a card other than a Circuit Emulation service module, refer to the documentation for that card for instructions on deleting the connection.


Testing Connections

The following tasks describe how to test Circuit Emulation connections on CESM and MPSM cards:

Testing with tstcon

Testing with tstdelay

The tstcon and tstdelay commands perform short tests that verify that the switch can communicate with both ends of a connection.

Testing with tstcon

The tstcon command checks to see if the switch can communicate with both ends of a connection. To test a Circuit Emulation connection on a CESM or MPSM card with the tstcon command, enter the command as follows:

PXM1E_SJ.1.4.CESM.a > tstcon <port>

Replace the port parameter with the port number for the connection you want to test. On PXM1E and PXM45 platforms, the port number is found in the Port.VPI.VCI column in the output of the dspcons and dspchans commands. On the PXM1 platform, the port number is found in the ConnID column in the format Nodename.Slot.Port.0 in the output of the dspcons and dspchans commands.

The following is an example of a tstcon test:

PXM1E_SJ.1.4.CESM.a > tstcon 2

TestCon in progress.

TestCon Passed.

PXM1E_SJ.1.4.CESM.a >

The tstcon command sends a single collection of supervisory cells from the local to the remote end of a connection and displays a pass or fail message. If connection segments are failed or misconfigured, the tstcon command fails. Note that the tstcon command does not test quality of service or connectivity beyond the Cisco MGX network.

The tstcon command has some limitations:

It works only for local connections or connections in a tiered network comprising a Cisco backbone network.

It should be issued from both ends of a connection to completely verify connectivity.

A passing result of the test does not guarantee a connection's end-to-end performance.


Note In addition to the tstcon command, the tstchan command is available to test connections on CESM and MPSM cards. The tstchan command has the same functionality as the tstcon command.


Testing with tstdelay

The tstdelay command checks to see if the switch can communicate with both ends of a connection, and it returns a measurement of the round-trip delay across the connection. To test a Circuit Emulation connection on a CESM or MPSM card with the tstdelay command, enter the command as follows:

PXM1E_SJ.1.4.CESM.a > tstdelay <chan_num>

Replace the chan_num parameter with the channel number for the connection you want to test. On PXM1E and PXM45 platforms, the channel number is found in the LCN column in the output of the dspcons and dspchans commands. On the PXM1 platform, the channel number is found in the ChNum column in the output of the dspcons and dspchans commands.

The following is an example of a tstdelay test:

PXM1E_SJ.1.4.CESM.a > tstdelay 36

TestDelay in progress.

TestDelay Passed with 2 ms.

PXM1E_SJ.1.4.CESM.a >

The tstdelay command shares the same limitations as the tstcon command.

Monitoring Connection Statistics

Use the commands in table Table 5-14 to display and clear CESM and MPSM connection statistics. The channel count commands enable the user to monitor the traffic being transmitted to and received from attached end-user equipment. The SAR counter commands enable the user to monitor the cell bus SAR statistics.

Table 5-14 CESM and MPSM Connection Statistics Commands 

Command
Purpose

dspchancnt

Enter this command to display connection statistics of a specific connection.

xdspchancnt

Enter this command to display connection statistics of a specific connection.

clrchancnt

Enter this command to clear connection counter values of a specific connection.

xclrchancnt

Enter this command to clear connection counter values of a specific connection.

clrchancnts

Enter this command to clear connection counter values of all connections on a CESM or MPSM card.

dspsarcnt

Enter this command to display connection SAR statistics of a specific connection.

dspsarcnts

Enter this command to display connection SAR statistics of all connections on a CESM or MPSM card.

clrsarcnt

Enter this command to clear the SAR counter values for a specific connection.

clrsarcnts

Enter this command to clear connection SAR counter values of all connections on a CESM or MPSM card.


The following example shows the output of the dspchancnt command on a CESM card:

PXM1E_SJ.1.4.CESM.a > dspchancnt 35

ChanNum:                   35
Chan State:                Okay
Chan RCV ATM State:        Normal
Chan XMT ATM State:        Normal
Cell Loss Status:          No Cell Loss
Reassembled Cells:         3744204536
Generated Cells:           4192713783
Header Errors:             187710088
Seqence Mismatches :       93862536
Lost Cells:                22147575
Channel Uptime (secs.)     4144394
Signalling Status          Offhook

PXM1E_SJ.1.4.CESM.a > 

In the command output, the transmit (Tx) direction is from the ATM network and service module towards the CPE. The receive (Rx) direction is from the CPE towards the service module and ATM network.

The following example shows the output of the dspsarcnt command on a CESM card:

PXM1E_SJ.1.4.CESM.a > dspsarcnt 35

                          SarShelfNum:         1
                          SarSlotNum:          4
                          SarChanNum:          35
                                Tx                      Rx
                          ---------------       ---------------
  Total Cells:            72810522              72696866
  Total CellsCLP:         0                     0
  Total CellsAIS:         0                     0
  Total CellsFERF:        0                     0
  Total CellsEnd2EndLpBk: 0                     0
  Total CellsSegmentLpBk: 0                     0
  RcvCellsDiscOAM:                              0


PXM1E_SJ.1.4.CESM.a >

Displaying Connection Alarms

To display a list of any connections in alarm use the dspcons command:

M8850_SF.1.26.CESM.a > dspcons

  LCN  Port.VPI.VCI Type M/S Clock PCR    CDVT  BufSz CLIP  Admin Alarm 
  ---- ------------ ---- --- ----- ------ ----- ----- ----- ----- ----- 
  0035 001.26.035   stru S   Synch 2048   01000 00192 02500 Up    OK        
  0036 002.26.036   stru M   Synch 2048   01000 00192 02500 Down  ADMIN-DOWN
  0037 003.26.037   stru M   Synch 2048   01000 00192 02500 Up    OK        
  0038 004.26.038   stru S   Synch 2048   01000 00192 02500 Up    CTRLR-ABIT

  ChanNumNextAvailable:  39

M8850_SF.1.26.CESM.a > 

The connection alarm state displayed in the dspcons command follows the following hierarchy:

ADMIN_DOWN, PORT_ALARM, CTRLR-ABIT, E-AIS/RDI, CELL LOSS

To display the status and the type of alarms present on a connection use the dspcon command:

M8850_SF.1.26.CESM.a > dspcon 2

  -------------------------------------------
  ChanNum:   36         RowStatus: OOS       
  AdmnState: Down       ChanState: Failed    
  ---------- ---------- ---------- ---------- 
  PORT-ALARM CTRLR-ABIT E-AIS/RDI  CELL-LOSS  
  ---------- ---------- ---------- ---------- 
      NO        YES         NO        YES     
  -------------------------------------------

  ChanNum:                  36
  ChanRowStatus:            OOS
  ConnAdminStatus:          Down
  ChanLineNum:              1
  ChanMapVpi:               26
  ChanMapVci:               36
  ChanCBRService:           struct
  ChanClockMode:            Synchronous
  ChanCAS:                  Basic
  ChanPartialFill:          47
  ChanMaxBufSize:           192 bytes
  ChanCDVT:                 1000 micro seconds
  C L I P:                  2500 milliseconds
  ChanLocalRemoteLpbkState: Disabled
  ChanTestType:             TestOff
  ChanTestState:            NotInProgress
  ChanRTDresult:            65535 ms
  ChanPortNum               2
  ChanConnType              SPVC
  ISDetType                 DetectionDisabled
  CondData                  255
  CondSignalling            15
  ExtISTrig                 DisableIdleSupression
  ISIntgnPeriod             3 seconds 
  ISSignallingCode          0
  OnHookCode                1
  ChanLocalVpi:             26
  ChanLocalVci:             36
  ChanLocalNSAP:            47009181000000000164444b6100000107d30200
  ChanRemoteVpi:            4
  ChanRemoteVci:            36
  ChanRemoteNSAP:           4700918100000000001a53337700000107230200
  ChanMastership:           Master
  ChanVpcFlag:              Vcc
  ChanConnServiceType:      CBR1
  ChanRoutingPriority:      8
  ChanPreferredRouteId:     0
  ChanDirectedRoute:        No
  ChanMaxCost:              2147483647
  ChanRestrictTrunkType:    No Restriction
  ChanConnPCR:              2048
  ChanConnMCR:              2048
  ChanConnPercentUtil:      100
  Channel Reroute:          False

  ChanNumNextAvailable:  39

M8850_SF.1.26.CESM.a > 

Managing Loopbacks

Loopbacks are used as a troubleshooting tool to aid in resolving problems with physical lines and logical connections. These topics describe loopbacks on the CESM and MPSM cards:

CESM Card Loopbacks

MPSM Card Loopbacks

CESM Card Loopbacks

The CESM-8T1/B, CESM-8T1, and the CESM-8E1 cards support line loopbacks.

Line loopbacks can be enabled by:

Manually placing the line in loopback mode using CESM CLI commands.

Enabling loopback code detection using CESM CLI commands.

Placing a line in loopback mode using the SRM by means of PXM BERT CLI commands.

Channel loopbacks are not supported on the CESM-8T1/B, CESM-8T1, and CESM-8E1 cards.

Figure 5-1 shows the details of where the various types of loopbacks occur within the architecture of the CESM-8T1/B, CESM-8T1, and CESM-8E1 cards.

Figure 5-1 CESM-8T1E1 Line Loopbacks

Table 5-15 describes the loopback commands supported by the CESM-8T1/B, CESM-8T1, and CESM-8E1 cards. For more information on the use of these commands, see Chapter 6, "CESM and MPSM Command Reference."

Table 5-15 Loopback Commands Supported on the CESM-8T1 and CESM-8E1 

Command
Purpose

addlnloop

Enter this command to place a line in local loopback. When a line is in local loopback, all data is looped back to the network.

dellnloop

Enter this command to remove the local line loopback feature from a line.

xcnfln

Enter this command to enable or disable a local loopback on a line by using the -lpb option.

Note Although remote loopback is displayed as an option for this command, it is not supported and remote loopback must be enabled through the use of the SRM. A line in remote loopback loops data sent from the CPE back to the CPE.

Enter this command to enable loopback code detection by using the -detect option. Upon detecting a loopback activate code, the line goes into remote loopback.


MPSM Card Loopbacks

The MPSM-8T1-CES and MPSM-8E1-CES cards support line and channel loopbacks.

Line loopbacks can be enabled by:

Manually placing the line in loopback mode using MPSM CLI commands.

Enabling loopback code detection using MPSM CLI commands.

Placing a line in loopback mode using the SRM by means of PXM BERT CLI commands.

Channel loopbacks are enabled through use of CLI commands on the MPSM card.

Figure 5-2 shows the details of where the various types of loopbacks occur within the architecture of the MPSM-8T1E1 card.

Figure 5-2 MPSM-8T1E1 Line and Channel Loopbacks

Table 5-16 describes the loopback commands supported by the MPSM-8T1-CES and MPSM-8E1-CES cards. For more information on the use of these commands, see Chapter 6, "CESM and MPSM Command Reference."

Table 5-16 Loopback Commands Supported on the MPSM-8T1-CES and MPSM-8E1-CES Cards 

Command
Purpose

addlnloop

Enter this command to place a line in local loopback. When a line is in local loopback, all data is looped back to the network.

dellnloop

Enter this command to remove the local line loopback feature from a line.

xcnfln

Enter this command to enable or disable a local loopback or remote loopback on a line by using the -lpb option. A line in remote loopback loops data sent from the CPE back to the CPE.

Enter this command to enable loopback code detection by using the -detect option. Upon detecting a loopback activate code, the line goes into remote loopback.

addchanloop

Enter this command to place a connection in channel local remote loopback1.

delchanloop

Enter this command to remove the channel local remote loopback from a connection1.

xcnfchan, xcnfcon

Enter this command to enable or disable a channel local remote loopback1 by using the -rmtlb option.

1 A channel local remote loopback is enabled on the local card and looped back in the direction of the network to the remote end of a connection, hence the term local remote.


Managing Bit Error Rate Testing (BERT)

The following topics discuss Bit Error Rate Testing (BERT) on CESM and MPSM cards:

SRM Supported BERT

MPSM-8T1E1 Onboard BERT

Bit Error Rate Testing (BERT) is utilized to determine the health of a full T1, E1, or DS3 line, or can be run on a fractional T1 or E1 line, such as a single DS0 or group of DS0's. Tests are categorized into three broad areas: BERT pattern tests, Loopbacks, and Monitoring functions.

Bit Error Rate Testing involves sending a pseudo-random, a repetitive, or a user-specified pattern on a physical line. The loopbacked pattern received by the local end is compared with the original test pattern. The quality of a physical interface/line is determined by the number of bit errors discovered in the received patterns. When determining the bit error rate, the following formula is used: Bit Error Rate = Bits received in error/Bits sent.

BERT operations are data intrusive and regular, user traffic cannot flow on the line/port being tested while the operation is in progress. A BERT session requires the tested path to be in a loopback mode. The line/port is put into an alarmed state at the start of the operation and restored to a normal state when the operation is terminated.

BERT should not affect performance since it is a diagnostic feature. It is however important to note that this is a destructive/intrusive feature in that it puts the line or port being tested out of service. As a result, all channels that exist on the line/port being tested will go into the alarmed state. This may result in a flood of traps and/or other kinds of traffic (AIS, and so forth.) reporting the channel alarms. This might negatively impact the performance of other functions.

A typical sequence in performing Bit Error Rate Testing consists of the following steps:

1. Place the far end interface on the attached end-user equipment in loopback mode if it does not support loopback code detection.

2. Configure BERT. The user can configure the following parameters:

1. Type of loopback (The loopbacks configured are enabled when the BERT is started and deleted when the BERT is stopped)

2. Pattern to transmit

3. Error rate insertion

3. Start BERT: Start the Bit Error Rate Test on the specified interface. Generate the test pattern and detect the incoming pattern. Compare the two patterns and update the counters.

4. Display BERT results: Display the bit error count and the bit error rate.

5. Stop BERT: Stop generating the test pattern and the Bit Error Rate test.

SRM Supported BERT

The following topics provide an overview of SRM supported Bit Error Rate Testing (BERT):

Overview of SRM Supported BERT

BERT Configuration Parameters on the SRM

Overview of SRM Supported BERT

With support from the SRM-3T3/C, SRME, or SRME/B the Cisco MGX 8230, Cisco MGX 8250, Cisco MGX 8850 (PXM1), Cisco MGX 8850 (PXM1E/PXM45), and Cisco MGX 8830 switches can perform a bit error rate test (BERT) on an active T1 or E1 line or port on the MPSM-8T1-CES, MPSM-8E1-CES, CESM-8T1/B, CESM-8T1, or CESM-8E1 cards.

There are two BERT buses in the Cisco MGX 8250 and Cisco MGX 8850 switches. One is in the top bay and the other in the bottom bay. The shelf can run a maximum of two sessions at once. However, the Cisco MGX 8230 and the Cisco MGX 8830 switches have only one BERT bus and only one BERT session can be conducted at a time.

The CLI commands for configuring, displaying, modifying, and terminating SRM supported BERT are found on the PXM1, PXM1E, and PXM45 processor cards.

For instructions on how to configure SRM supported Bit Error Rate Tests on PXM1, PXM1E, and PXM45 platforms, refer to the Cisco MGX 8850 Edge Concentrator Installation and Configuration, Release 1.1.3 and the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Configuration Guide, Release 5.1 documentation.

BERT Configuration Parameters on the SRM

During BERT configuration on the PXM processor card, the choice of parameters or menu items depends first on the card type to be tested, and then whether the test medium is a physical line or a logical port.

Table 5-17 shows a summary of the SRM supported BERT configuration options available on the MPSM-8T1-CES, CESM-8T1, and CESM-8T1/B cards.

Table 5-17 SRM Supported BERT Configuration Options for MPSM-8T1-CES, CESM-8T1, and CESM-8T1/B Cards 

Test Medium
Medium Type
Test Type
Device to Loop
BERT Test Patterns
Loopback Type
 

Port with multiple timeslots (Nx56K, Nx64K)

BERT pattern

Loopback

v541

   
 

Port with one 64K timeslot

BERT Pattern

DDS seek2

Loopback

latch3

v541

all

l

Far end loopback

Remote loopback

Port

Port with one 56K timeslot

BERT pattern

DDS seek2

nolatch4

2^9

2^11

 
   

Loopback

latch3

v541

all

 

Line

 

BERT pattern

Loopback

inband/ESF5

metallic6

all

Far end loopback

Remote loopback

Metallic loopback

1 A polynomial loopback which loops only the timeslots sent across. V54 is used to test select channels and does not affect other user data on the T1.

2 Digital Dataphone Services (DDS) seek is a monitoring function test type and can be run only on a single DS0. This test is non-destructive and detects and displays network trouble codes, such as Abnormal Station Condition, Block, Channel Loopback, DSU Loopback, Far End Voice, Idle, Loopback Enable, MTU Alert, Mux Out of Sync, OCU Loopback, Release, Test, Test Alert, Transition in Progress, and Unassigned MUX Channel.

3 A device that can latch the data automatically unloops the loopback after the test signal ceases.

4 A device that does not latch the data receives the test pattern sent, enables the loopback automatically, and then must be manually taken out of loopback mode at the end of testing.

5 Far end inband loopback or far end ESF loopback.

6 A local loopback within the service module which does not involve an external device.


Table 5-18 shows a summary of the SRM supported BERT configuration options available on the MPSM-8E1-CES and CESM-8E1 cards.

Table 5-18 SRM Supported BERT Configuration Options for MPSM-8E1-CES and CESM-8E1 Cards 

Test Medium
Test Type
Device to Loop
BERT Test Patterns
Loopback Type

Port

BERT Pattern

Loopback

 

all

Remote loopback

Line

BERT Pattern

Loopback

metallic1

all

Remote loopback

Metallic loopback

1 A local loopback within the service module which does not involve an external device.


The available SRM supported T1 and E1 BERT patterns to choose from are shown in Table 5-19

Table 5-19 SRM Supported T1 and E1 BERT Patterns

Supported T1 and E1 BERT Patterns
 

1. All zeroes

2. All ones

3. Alternate Ones/Zeroes

4. Double Ones/Zeroes

5. 2^15 - 1 (non-ITU)

6. 2^20 - 1

7. 2^20 - 1 QRSS

8. 2^23 - 1 (non-ITU)

9. 1 in 8

10. 3 in 24

11. DDS-1

12. DDS-2

13. DDS-3

14. DDS-4

15. DDS-5

16. 2^9

17. 2^11


The loopback tests do not monitor the integrity of the data but rather the integrity of the path. The type of loopback indicates the direction of the data transmission. The loopback types supported by the SRM are described in Table 5-20.

Table 5-20 SRM Supported BERT Loopback Options 

Loopback Type
Function

Far End Loopback

The service module transmits data to the CPE and receives the data back. There are three subtypes of far end loopbacks: Inband, ESF, and SmartJack inband loop codes (SRME only).

Remote Loopback

The service module receives the data from the CPE and loops back to the CPE. Another way of configuring remote loopback is to enable loopback code detection on the service module, then send the loopback code from the CPE.

Metallic Loopback

The service module receives data from the network and loops it back to the network. Metallic loopback is not the same as local loopback. Metallic loopback loops the data back to the network at the physical port on the back card of a service module, whereas local loopback loops the data back to the network through the framer in the service module.


MPSM-8T1E1 Onboard BERT

The following topics describe MPSM-8T1E1 onboard BERT:

MPSM-8T1E1 Onboard BERT Features

Managing a BERT Session on the MPSM-8T1E1

MPSM-8T1E1 Onboard BERT Features

MPSM Onboard BERT features and limitations common to the MPSM-8T1E1 card regardless of the interface and service type configured include:

The MPSM onboard BERT session is initiated from the MPSM card.

The use of SRM supported BERT and MPSM onboard BERT at the same time on the same card is not supported.

Only one BERT session per line is supported.

All eight lines on the MPSM can be configured for BERT sessions at the same time.

The BERT CLI commands are not service dependent.

The Cisco BERT MIB is supported.

Line inband loopback codes are supported.

Remote loopbacks on ports are not supported.

Sending loopback codes on ports is not supported.

Port BERT session on 56k ports is not supported.

BERT sessions can be run only on active MPSM cards.

The tests patterns supported by the BERT generator/detector are compliant with CCITT/ITU O.150, O.151, O.152, O.153, and O.161 standards.

Table 5-21 describes the onboard BERT commands supported by the MPSM-8T1-CES and MPSM-8E1-CES cards. For more information about these commands, see Chapter 6, "CESM and MPSM Command Reference."

Table 5-21 Onboard BERT Commands Supported on the MPSM-8T1-CES and MPSM-8E1-CES Cards 

Command
Purpose

cnfbert

Enter this command to configure a Bit Error Rate Test on a line or port.

startbert

Enter this command to begin the Bit Error Rate Test configured on the specified line or port.

dspbert

Enter this command to view the BERT parameters configured with the cnfbert command and to view the status of the current BERT session.

dspbertstats

Enter this command to view statistics for the Bit Error Rate Test configured on the specified line or port. This command can be used to view changing statistics while the Bit Error Rate Test is running or it can be used after testing has stopped to view the total statistics accumulated during the test period.

clrbertstats

Enter this command to clear all statistics that have accumulated during Bit Error Rate Testing on the specified line or port. This command can be used to reset the statistics counters while Bit Error Rate Testing is running or it can be used to reset statistics counters after Bit Error Rate Testing has been stopped.

insbiterror

Use this command to insert single bit errors into the transmitted BERT pattern configured on the specified line or port.

stopbert

Enter this command to stop the Bit Error Rate Test running on the specified line or port.

delbert

Enter this command to clear a Bit Error Rate Testing configuration from a line or port. This command may be used to clear a BERT session that is running or may be used after the BERT session has been stopped.


Managing a BERT Session on the MPSM-8T1E1

To manage a Bit Error Rate Test using the MPSM-8T1E1 onboard BERT feature, perform the following steps:


Step 1 If the far end interface on the attached end-user equipment does not support loopback code detection, log into the attached end-user equipment and place the line under test into loopback mode.

Step 2 Establish a configuration session with the MPSM using a user name with GROUP1 privileges or higher.

Step 3 Enter the cnfbert command as follows to configure a BERT session:

M8850_SF.1.28.MPSM8T1.CES.a > cnfbert <ifNumber> [-tp <TestPattern>] [-lpbk <loopback>] 
[-eir <errorInsertRate>]

Table 5-22 lists and describes the parameters for the cnfbert command on the MPSM-8T1-CES and MPSM-8E1-CES cards.

Table 5-22 Parameters for the cnfbert Command 

Parameter
Description

ifNumber

Specify the interface number to be configured using the format line.port.

MPSM-8T1-CES, MPSM-8E1-CES Line number Range: 1-8

MPSM-8T1-CES Port number Range: 1-192

MPSM-8E1-CES Port number Range: 1-248

Note To specify a Line BERT session, the Port Number = 0.

When you enter the cnfbert command with only the interface number specified with no other options selected, the Bit Error Rate Test is configured using the defaults: test pattern 25, no loopback, and no error insertion rate.

-tp

Test pattern. Default test pattern is 25.

1 = All Zeros

2 = All Ones

3 = Alternate One and Zero

4 = Double Alternate Ones and Zeroes

5 = 1 in 4

6 = 1 in 8

7 = 1 in 16

8 = 3 in 24

9 = Inband Loop Back Activate

10 = Inband Loop Back Deactivate

11 = Three Bit (2^3-1)

12 = Four Bit (2^4-1)

13 = Five Bit (2^5-1)

14 = Six Bit (2^6-1)

15 = Seven Bit (2^7-1)

16 = Seven Bit (2^7-1) Fractional T1 Loop Up

17 = Seven Bit (2^7-1) Fractional T1 Loop Down

18 = Nine Bit (2^9-1)

19 = Ten Bit (2^10-1)

20 = Eleven Bit (2^11-1)

21 = Fifteen Bit (2^15-1)

22 = Seventeen Bit (2^17-1)

23 = Eighteen Bit (2^18-1)

24 = Twenty Bit (2^20-1) (Not supported in Cisco MGX Releases 5 and 1.3)

25 = Twenty Bit (2^20-1) QRSS

26 = TwentyOne Bit (2^21-1)

27 = TwentyTwo Bit (2^22-1)

28 = TwentyThree Bit (2^23-1)

29 = TwentyFive Bit (2^25-1)

30 = TwentyEight Bit (2^28-1)

31 = TwentyNine Bit (2^29-1)

32 = ThirtyOne Bit (2^31-1)

-lpbk

Loopback Code.

Line Inband = 12

No Loopback = 15 (Default)

-eir

Error Insertion Rate.

1 = No Error (Default)

2 = 1 in 10

3 = 1 in 100

4 = 1 in 1,000

5 = 1 in 10,000

6 = 1 in 100,000

7 = 1 in 1,000,000

8 = 1 in 10,000,000


The following example configures a Bit Error Rate Test on an MPSM-8T1-CES card on line 1 using the default parameters:

M8850_SF.1.28.MPSM8T1.CES.a > cnfbert 1.0

        Use startbert to start BERT
        Use delbert followed by cnfbert to re-configure BERT parameters

M8850_SF.1.28.MPSM8T1.CES.a > 

Step 4 Enter the dspbert command as follows to view the BERT parameters configured with the cnfbert command:

M8850_SF.1.28.MPSM8T1.CES.a > dspbert <ifNumber>

Replace the ifNumber parameter with the line and port number configured for the BERT session in the format line.port. To specify a line test, enter a port value of zero.

The following example shows the BERT parameters configured in the previous step:

M8850_SF.1.28.MPSM8T1.CES.a > dspbert 1.0

 Interface Number   : 1.0
 Loopback Code      : No Loopback
 Pattern            : TwoE20MinusOneQRSS
 ErrorInsertRate    : NoError
 Start Date/Time    : Not Started
 Operational Status : Out Of Sync

M8850_SF.1.28.MPSM8T1.CES.a >

Step 5 Enter the startbert command as follows to start a Bit Error Rate Test:

M8850_SF.1.28.MPSM8T1.CES.a > startbert <ifNumber>

Replace the ifNumber parameter with the line and port number configured for the BERT session in the format line.port. To specify a line test, enter a port value of zero.

The following example starts a BERT session:

M8850_SF.1.28.MPSM8T1.CES.a > startbert 1.0

M8850_SF.1.28.MPSM8T1.CES.a >

Step 6 Enter the dspbert command to verify the start of the Bit Error Rate Test:

M8850_SF.1.28.MPSM8T1.CES.a > dspbert 1.0

 Interface Number   : 1.0
 Loopback Code      : No Loopback
 Pattern            : TwoE20MinusOneQRSS
 ErrorInsertRate    : NoError
 Start Date/Time    : 03/17/2004 04:55:52
 Operational Status : In Sync


M8850_SF.1.28.MPSM8T1.CES.a >

In this example, an Operational Status of In Sync indicates that the test has been successfully started.

Step 7 Enter the dspbertstats command as follows to view statistics from a Bit Error Rate Test in progress:

M8850_SF.1.28.MPSM8T1.CES.a > dspbertstats <ifNumber>

Replace the ifNumber parameter with the line and port number configured for the BERT session in the format line.port. To specify a line test, enter a port value of zero.

The following example displays statistics from a BERT session in progress:

M8850_SF.1.28.MPSM8T1.CES.a > dspbertstats 1.0

 Interface Number          : 1.0
 Rx Bit Count              : 33793765
 Rx Bit Error Count        : 83
 Sync Loss Transition      : 0
 Pattern Loss Count (secs) : 0


M8850_SF.1.28.MPSM8T1.CES.a >

The dspbertstats command may also be used to view the total statistics gathered during a BERT session after the test has been stopped.

To clear the incrementing statistics during a BERT session or after the BERT session has been stopped, use the clrbertstats command to reset the statistics counters.

Step 8 Enter the insbiterror command as follows to insert single bit errors into an active BERT session:

M8850_SF.1.28.MPSM8T1.CES.a > insbiterror <ifNumber>

Replace the ifNumber parameter with the line and port number configured for the BERT session in the format line.port. To specify a line test, enter a port value of zero.

The following example inserts a single bit error into the BERT session in progress:

M8850_SF.1.28.MPSM8T1.CES.a > insbiterror 1.0

M8850_SF.1.28.MPSM8T1.CES.a >

Step 9 Enter the stopbert command as follows to stop a BERT session:

M8850_SF.1.28.MPSM8T1.CES.a > stopbert <ifNumber> 

Replace the ifNumber parameter with the line and port number configured for the BERT session in the format line.port. To specify a line test, enter a port value of zero.

The following example stops the current BERT session:

M8850_SF.1.28.MPSM8T1.CES.a > stopbert 1.0

M8850_SF.1.28.MPSM8T1.CES.a >

After a BERT session has been stopped, it may be restarted by using the startbert command.

Step 10 Enter the delbert command as follows to clear a BERT configuration:

M8850_SF.1.28.MPSM8T1.CES.a > delbert <ifNumber>

Replace the ifNumber parameter with the line and port number configured for the BERT session in the format line.port. To specify a line test, enter a port value of zero.

The following example clears the current BERT session configuration:

M8850_SF.1.28.MPSM8T1.CES.a > delbert 1.0

M8850_SF.1.28.MPSM8T1.CES.a >

To modify the configuration parameters of a BERT session, you must first clear the current BERT configuration with the delbert command and then reconfigure the new parameters with the cnfbert command.


Managing MPSM Online Diagnostics

The following topics describe MPSM-8T1E1 Online Diagnostics:

MPSM-8T1E1 Online Diagnostics Features

Configuring Online Diagnostics on the MPSM-8T1E1

MPSM-8T1E1 Online Diagnostics Features

The MPSM-8T1E1 Online Diagnostics are used to test and monitor the health of the components and data paths on the MPSM card after its successful boot up. These tests are used solely for hardware diagnosis and are not used to detect operational errors.

Online tests are diagnostics performed by the run-time firmware while a card is in an Active or Standby operational state. These tests are limited on the Active card due to the requirements that the tests be non-intrusive and not affect user traffic. More elaborate tests are performed on the Standby card without affecting switch-over time. Note that these tests cannot be configured on the Standby card using CLI commands. The tests have to be pre-configured when the card is in an Active state to run on a card in Standby mode.


Note In Cisco MGX Releases 5.1 and 1.3, diagnostic tests are supported only on Active cards.


Although alarms, logs, and traps are generated upon the failure of a test, there is no SNMP support for test configuration. All test configuration must be done by means of CLI commands on the MPSM card. Tests may be scheduled to run in the Online Diagnostics test suite or run individually.

The tests are common to all service types configured on the MPSM-8T1E1 card, however NP Utilization tests are not supported on an MPSM card in Frame Relay mode.

Table 5-23 shows the online diagnostics tests available on the MPSM-8T1E1 card.

Table 5-23 MPSM-8T1E1 Online Diagnostics Tests 

Test ID
Test Name
Function

1

Boot Checksum

This test verifies the checksum for the boot code in Flash memory.

2

Front card NVRAM Checksum

This test performs a front card NVRAM checksum test.

3

CPU Performance Monitor

This test monitors CPU performance based on the idle time.

4

NP Performance Monitor

This test monitors Network Processor performance based on the idle time. (This test is not supported in Frame Relay mode)

5

SLFP Access

This test accesses diagnostic registers in the SLFP FPGA and performs pattern tests to verify data bus integrity.

6

MPCTL Access

This test accesses diagnostic registers in the MPCTL FPGA and performs pattern tests to verify data bus integrity.

7

FRAMER Access

This test accesses diagnostic registers in the FRAMER and performs pattern tests to verify data bus integrity.

8

LDRAM Memory Availability

This test monitors the available DRAM memory.

9

Host Memory Availability

This test monitors the available Host memory.

10

Packet Memory Availability

This test monitors the available Packet memory.

11

Internal Memory Availability

This test monitors the available Internal memory.

12

Parameter Memory Availability

This test monitors the available Parameter memory.

13

Host Memory Access

This test accesses the Host memory and performs diagnostic pattern tests to verify data bus integrity.

14

Packet Memory Access

This test accesses the Packet memory and performs diagnostic
pattern tests to verify data bus integrity.

15

Parameter Memory Access

This test accesses the Parameter memory and performs diagnostic pattern tests to verify data bus integrity.

16

MPCTL Error Monitor

This test monitors the error counters for the MPCTL FPGA.

17

NP Error Monitor

This test monitors the error counters for the Network Processor input parameters.

18

NP Health Check

This test monitors the health of the Network Processor.

19

MPCTL Loopback

This test verifies the data path between the CPU and the MPCTL by injecting cells on a diagnostic LCN that the MPCTL will loop back.

20

PXM Data Path Loopback Test

This test verifies the data path between the MPSM and the PXM by injecting cells on a diagnostic LCN that the PXM will loop back.

21

NP TDM Loopback Test

This test verifies the data path between the CPU and the NP TDM port by injecting cells on a diagnostic LCN that the NP will loop back. (This test is not supported on an MPSM card in Active mode)

22

SLFP TDM Loopback Test

This test verifies the data path between the CPU and the SLFP by injecting cells on a diagnostic LCN that the SLFP will loop back. (This test is not supported on an MPSM card in Active mode)

23

Framer Loopback Test

This test verifies the data path between the CPU and the Framer by injecting cells on a diagnostic LCN that the Framer will loop back. (This test is not supported on an MPSM card in Active mode)


Table 5-24 shows the CLI commands used to configure and manage Online Diagnostics on the MPSM-8T1E1 card. For more information on the use of these commands, see Chapter 6, "CESM and MPSM Command Reference."

Table 5-24 MPSM-8T1E1 Online Diagnostics Commands 

Command
Purpose

dspdiagtests

Enter this command to view the complete list of available online diagnostic tests configured on the current MPSM card. Using this command with the Test ID number option will give detailed information about a specific online diagnostic test.

cnfdiagtest

Enter this command to modify the parameters of a single diagnostic test that is a member of the online diagnostics test suite. This command may also be used to modify all online diagnostic tests at the same time.

rundiagtest

Enter this command to run an individual online diagnostic test.

dspdiagresults

Enter this command to display the results of the configured diagnostic tests.

clrdiagresults

Enter this command to clear the results of all the configured online diagnostic tests.

pausediag

Enter this command to temporarily stop the scheduled online diagnostic tests.

resumediag

Enter this command to resume the previously paused diagnostic tests.


Configuring Online Diagnostics on the MPSM-8T1E1

To configure Online Diagnostics on the MPSM-8T1E1, perform the following steps:


Step 1 Establish a configuration session with the MPSM using a user name with GROUP1 privileges or higher.

Step 2 Enter the dspdiagtests command as follows to view the available online diagnostics tests on the MPSM-8T1E1 card:

M8250_SJ.1.22.MPSM8T1.CES.a > dspdiagtests

ID Name                            Enable   Role   StartTOD   Period  Iteratns 
-- ----------------------------    -------  ------ --------    ------  -------- 
1  Boot Checksum                    No      Active    NOW       1440  FOREVER 
2  Front card NVRAM Checksum        No      Active    NOW       1440  FOREVER 
3  CPU Performance Monitor          No      Active    NOW        5    FOREVER 
4  NP Performance Monitor           No      Active    NOW        5    FOREVER 
5  SLFP Access                      No      Active    NOW        5    FOREVER 
6  MPCTL Access                     No      Active    NOW        5    FOREVER 
7  FRAMER Access                    No      Active    NOW        5    FOREVER 
8  LDRAM Memory Availability        No      Active    NOW        5    FOREVER 
9  Host Memory Availability         No      Active    NOW        30   FOREVER 
10 Packet Memory Availability       No      Active    NOW        30   FOREVER 
11 Internal Memory Availability     No      Active    NOW        30   FOREVER 
12 Parameter Memory Availability    No      Active    NOW        30   FOREVER 
13 Host Memory Access               No      Active    NOW        1    FOREVER 
14 Packet Memory Access             No      Active    NOW        5    FOREVER 
15 Parameter Memory Access          No      Active    NOW        5    FOREVER 
16 MPCTL Error Monitor              No      Active    NOW        5    FOREVER 
17 NP Error Monitor                 No      Active    NOW        5    FOREVER 
18 NP Health Check                  No      Active    NOW        5    FOREVER 
19 MPCTL Loopback                   No      Active    NOW        1    FOREVER 
20 PXM Data Path Loopback Test      No      Active    NOW        1    FOREVER 
21 NP TDM Loopback Test             No      Active    NOW        30   FOREVER 
22 SLFP TDM Loopback Test           No      Active    NOW        30   FOREVER 
23 Framer Loopback Test             No      Active    NOW        30   FOREVER 

Online Diagnostic tests RUNNING.
 
M8250_SJ.1.22.MPSM8T1.CES.a > 

The output of the dspdiagtests commands shows the current configuration and status of all the available tests.

Step 3 Enter the dspdiagtests command as follows to view detailed information about a specific online diagnostic test:

M8250_SJ.1.22.MPSM8T1.CES.a > dspdiagtests <TestId>

Replace the TestId parameter with the ID number of the test shown in the dspdiagtests command display.

The following example shows the status and configuration of test number 10:

M8250_SJ.1.22.MPSM8T1.CES.a > dspdiagtests 10

Test Name: Packet Memory Availability
Function: Monitors the available Packet memory.
          Input Parameters:
           Threshold for available memory: 0 - 100%
           NP ID: 0 for MPSM-8T1E1, 0/1/2(Both NP) for MPSM-16T1E1
Alarm Raised on Failure: Major
Recovery Action: N.A
Role: Active   
Enable: No
StartTOD: NOW
Period: 30
Iterations: FOREVER
Configured Parameters:  2, 0

M8250_SJ.1.22.MPSM8T1.CES.a > 

Step 4 Enter the cnfdiagtest command as follows to modify the default configuration of a specific test or all online diagnostic tests:

M8250_SJ.1.22.MPSM8T1.CES.a > cnfdiagtest <TestId> [<enable|disable>] [-role <role>] 
[-startTOD <time>] [-period <period>] [-iterns <iterns>] [-param1 <param>] [-param2 
<param>]

Table 5-25 lists and describes the parameters for the cnfdiagtest command on the MPSM-8T1-CES and MPSM-8E1-CES cards.

Table 5-25 Parameters for the cnfdiagtest Command 

Parameter
Description

TestId

Test ID number of the diagnostic test to be modified in the range 1 to 23, or enter all to specify all tests. Enter the dspdiagtests command to view the diagnostic tests available and the associated test ID numbers.

Note Only the enable|disable and -role option may be used with the all command option. All other command options are for use with individual diagnostic tests.

enable|disable

Enables or disables the diagnostic test on the current card.

-role

State of the card on which the specified diagnostic test is performed:

Active state = 1

Note In Cisco MGX Releases 5.1 and 1.3, Online Diagnostic tests are supported only on Active cards.

-startTOD

Scheduled start time of the diagnostic test using a 24 hour format (HH:MM). Enter Now to execute the test immediately.

-period

Time between successive iterations of the diagnostic test in minutes.

-iterns

Number of times the diagnostic test should be repeated. When the value is specified as -1, the test will continuously execute.

-param1

Parameter 1 for test. Enter the dspdiagtests <TestId> command to display the configurable parameters for each online diagnostic test.

-param2

Parameter 2 for test. Enter the dspdiagtests <TestId> command to display the configurable parameters for each online diagnostic test.


The following example modifies diagnostic test number 9 to enabled in the active state, to start now, to wait one minute between successive tests, and run only twice:

M8250_SJ.1.22.MPSM8T1.CES.a > cnfdiagtest 9 enable -role 1 -startTOD now -period 1 -iterns 
2 

M8250_SJ.1.22.MPSM8T1.CES.a >

Step 5 Enter the rundiagtest command as follows to run an online diagnostic test on the MPSM-8T1E1 card:

M8250_SJ.1.22.MPSM8T1.CES.a > rundiagtest <TestId> [param1] [param2]

Table 5-26 lists and describes the parameters for the rundiagtest command on the MPSM-8T1-CES and MPSM-8E1-CES cards.

Table 5-26 Parameters for the rundiagtest Command 

Parameter
Description

TestId

Test ID number of the diagnostic test to be executed in the range 1 to 23. Enter the dspdiagtests command to view the diagnostic tests available and the associated test ID numbers.

param1

Parameter 1 for tests. Enter the dspdiagtests <TestId> command to display the configurable parameters for each online diagnostic test.

param2

Parameter 2 for tests. Enter the dspdiagtests <TestId> command to display the configurable parameters for each online diagnostic test.


The following example runs online diagnostic test number 9 on the current MPSM-8T1-CES card:

M8250_SJ.1.22.MPSM8T1.CES.a > rundiagtest 9 15

Host Memory Availability  PASSED

M8250_SJ.1.22.MPSM8T1.CES.a > 

To pause a currently running online diagnostic test, enter the pausediag command. To resume an online diagnostic test that has been paused, enter the resumediag command.

Step 6 Enter the dspdiagresults command as follows to view the results of an online diagnostic test:

M8250_SJ.1.22.MPSM8T1.CES.a > dspdiagresults

Online Diagnostic tests RUNNING.
 
ID Name                           Enable    Attempts   FailCnt   Result   
-- ------------------------------ -------   --------   -------   -------  
1  Boot Checksum                  No            1         0       Pass  
2  Front card NVRAM Checksum      No            0         0       N/A   
3  CPU Performance Monitor        No            0         0       N/A   
4  NP Performance Monitor         No            0         0       N/A   
5  SLFP Access                    No            0         0       N/A   
6  MPCTL Access                   No            0         0       N/A   
7  FRAMER Access                  No            0         0       N/A   
8  LDRAM Memory Availability      No            0         0       N/A   
9  Host Memory Availability       Yes           16        0       Pass  
10 Packet Memory Availability     No            0         0       N/A   
11 Internal Memory Availability   No            0         0       N/A   
12 Parameter Memory Availability  No            0         0       N/A   
13 Host Memory Access             No            0         0       N/A   
14 Packet Memory Access           No            0         0       N/A   
15 Parameter Memory Access        No            0         0       N/A   
16 MPCTL Error Monitor            No            0         0       N/A   
17 NP Error Monitor               No            0         0       N/A   
18 NP Health Check                No            0         0       N/A   
19 MPCTL Loopback                 No            0         0       N/A   
20 PXM Data Path Loopback Test    No            0         0       N/A   
21 NP TDM Loopback Test           No            0         0       N/A   
22 SLFP TDM Loopback Test         No            0         0       N/A   
23 Framer Loopback Test           No            0         0       N/A   


M8250_SJ.1.22.MPSM8T1.CES.a > 

To clear the results from an online diagnostic test, enter the clrdiagresults command.

Step 7 Enter the cnfdiagtests to stop a test that is continuously running.

Table 5-25 lists and describes the parameters for the cnfdiagtest command on the MPSM-8T1-CES and MPSM-8E1-CES cards

The following example stops online diagnostic test number 9:

M8250_SJ.1.22.MPSM8T1.CES.a > cnfdiagtest 9 disable

M8250_SJ.1.22.MPSM8T1.CES.a >


Managing MPSM Core Dumps

The following topics describe managing MPSM core dumps:

Overview of MPSM Core Dumps

Managing Core Dump Files

Aborting Core Dumps

Displaying Core Command Options

Displaying Core Dump Settings

Displaying the Core Dump Mask

Configuring Core Dump Settings

Hot-Dumping the Core

Overview of MPSM Core Dumps

The core command is used to manage core memory dumps on the MPSM-8T1E1 card. This command is supported on PXM1, PXM1E, and PXM45 platforms.

Core dumps are used to debug hardware and software errors. Certain software errors such as memory corruption, memory leaks, and resource leaks are difficult to catch during product testing. Other types of errors may manifest only after prolonged usage in a production network. When such errors occur, it is imperative to capture the software image in memory and the hardware configurations so that debugging can be performed.

Core memory dumps on the MPSM card are supported on MPSM cards in redundancy groups and on non-redundant MPSM cards.

When a software or hardware error condition requiring a reset occurs, the MPSM card will be reset after writing the reset reason to the NVRAM. The boot code will then examine the reset reason. If the reset reason is part of the core dump mask, a core dump to the PXM hard disk is performed by means of the cell bus. This type of core dump is known as a cold-dump. The goal is to capture the dump without affecting the tasks running on the PXM card or other service modules.


Note You must set the PXM core red-policy command to enable to support cold-dumps from a non-redundant MPSM card.


The MPSM card also supports a hot-dump or run-time snapshot of the current Host CPU memory, hardware configuration, and Winpath memory. Only one hot-dump of the core memory can take place at a time on an MPSM card.

The PXM processor card will allow multiple cold-dumps and hot-dumps of the MPSM core memory from different MPSM cards to take place at the same time on the switch.

Managing Core Dump Files

Cold-dump and hot-dump MPSM core dump files are saved in the C:/ directory on the PXM processor card.

Cold-dump files are saved in the format core_slotNumber.zip. New cold-dump files from the same slot will overwrite any existing cold-dump files from that same slot.

Hot-dump files are saved in the format filename.zip using a user specified filename. Do not use the same filename format used by cold-dump files, otherwise the hot-dump file could be overwritten by a subsequent cold-dump of the core.

Use FTP to transfer the core dump zip files to a work station. Core dump zip files must be sent to Cisco TAC for debugging.

Aborting Core Dumps

Both hot-dumps and cold-dumps of the core memory on the MPSM card may be aborted by using the PXM core abort-dump <slot> command.

Cold-dumps of the MPSM core memory will also be aborted if any of the following events occur:

The MPSM card is reset during a cold-dump in progress.

The PXM switchcc command is performed on the active PXM card during a cold-dump in progress on the MPSM card.

The cold-dump takes longer than the core dump time-out period in effect on the PXM card.

Hot-dumps of the MPSM core memory will also be aborted if any of the following events occur:

The MPSM card is reset during a hot-dump in progress.

The PXM switchcc command is performed on the active PXM card during a hot-dump in progress on the MPSM card.

The PXM switchredcd command is performed during a hot-dump in progress on the active MPSM card in a redundancy group.

On the PXM1 card, if there is less than 20MB of available space on the PXM1 hard drive.

The hot-dump takes longer than the core dump time-out period in effect on the PXM card.


Note To display and set the time-out period for cold and hot dumps of core memory, use the PXM core time-out command to view the time-out period in effect on the PXM card and use the PXM core time-out <timeInSecs> command to change the time-out setting on the PXM card.


Displaying Core Command Options

Enter the core command with a question mark to list the optional parameters for the core command as shown in the following example:

M8850_SF.1.28.MPSM8T1.CES.a > core ?

core command syntax: 

core                         ( show settings and saved images )
core ?                       ( print usage information        )
core mask                    ( show autodump conditions       )
core mask default            ( set default coredump mask      )
core mask <hex-mask>         ( select autodump conditions     )
core enable                  ( enable auto coredump           )
core disable                 ( disable auto coredump          )

core hot-dump <filename.zip> ( take hot dump and save to file )

M8850_SF.1.28.MPSM8T1.CES.a > 

Displaying Core Dump Settings

Enter the core command without any arguments to display the current core dump settings on the MPSM card. The following example shows the core dump settings on an MPSM card that has automatic core dumping enabled and where the saved core images are located:

M8850_SF.1.28.MPSM8T1.CES.a > core
Automatic core dumping is enabled for this slot.

Saved core images are on PXM's hard disk (C:/).

M8850_SF.1.28.MPSM8T1.CES.a > 

Displaying the Core Dump Mask

The core dump mask is the sum of the hexadecimal numbers associated with reset reasons that are enabled to trigger a core dump. Most reasons for a card reset can be enabled to trigger a core dump. If the reset reason in ON, the associated hexadecimal number is an element of the mask.

Enter the core mask command to display the current core dump mask and the error conditions for which a core dump is enabled as shown in the following example:

M8850_SF.1.28.MPSM8T1.CES.a > core mask
Automatic core dumping is enabled for this slot.
The current core mask is 0x273ae.

OFF 00001 not used (can't be turned ON)
ON  00002 DRAM Parity Error 
ON  00004 WatchDog Timeout Reset 
ON  00008 Resource Overflow 
OFF 00010 Clear All Configuration (can't be turned ON)
ON  00020 Missing Task 
OFF 00040 Reset because of PXM Low Voltage (can't be turned ON)
ON  00080 Reset By Event Log Task 
ON  00100 Reset from Shell 
ON  00200 Unknown 
OFF 00400 Reset from PXM (can't be turned ON)
OFF 00800 Reset System (can't be turned ON)
ON  01000 Switch Core Card 
ON  02000 Secondary Cache Error 
ON  04000 Software Error Reset 
OFF 08000 S/W reset due to upgrade (can't be turned ON)
OFF 10000 Restore All Configuration (can't be turned ON)
ON  20000 Device Driver Error 

M8850_SF.1.28.MPSM8T1.CES.a >

In this example, the mask is set to the default mask of 0x273ae. To change the mask, see "Changing the Core Dump Mask".

A reason that cannot trigger a core dump is indicated in the preceding example with can't be turned ON. A reset reason that can't be turned ON removes debugging information from memory and therefore is excluded from being part of the mask.

Configuring Core Dump Settings

The following topics describe the configuration of core dump settings:

Enabling Automatic Core Dumping

Disabling Automatic Core Dumping

Changing the Core Dump Mask

Restoring the Default Core Dump Mask

Enabling Automatic Core Dumping

Enter the core enable command to enable automatic core dumping as shown in the following example:

M8850_SF.1.28.MPSM8T1.CES.a > core enable
Automatic core dumping is enabled for this slot.

M8850_SF.1.28.MPSM8T1.CES.a > 

Disabling Automatic Core Dumping

You may want to disable automatic core dumps for the MPSM card due to the time it takes to write core memory to the PXM hard drive. For example:

You may have isolated a problem and want to save the time required to write RAM contents to disk.

The traffic on the MPSM card may be of such high priority that you do not want to dump core memory to disk.

The MPSM card is a non-redundant service module and the dump time may be a concern.


Note The PXM core red-policy [<enable|disable>] command is used to enable or disable core dumps on non-redundant MPSM cards. Setting the core red-policy command to disable does not disable hot-dumps of the core memory.


Enter the core disable command to disable automatic core dumping as shown in the following example:

M8850_SF.1.28.MPSM8T1.CES.a > core disable
Automatic core dumping is ** disabled ** for this slot.

M8850_SF.1.28.MPSM8T1.CES.a > 

The use of this command is similar to setting the mask to 0x0.

Changing the Core Dump Mask

Enter the core mask command as follows to change the core dump mask:

M8850_SF.1.28.MPSM8T1.CES.a > core mask <hex-mask>

Replace the <hex-mask> parameter with the sum of all the hexadecimal values for the reset reasons that you want to have in the new core dump mask.

In the following example, the default core dump mask of 0x273ae has been changed to 0x263ac:

M8850_SF.1.28.MPSM8T1.CES.a > core mask 263ac
Automatic core dumping is enabled for this slot.
The current core mask is 0x263ac.

OFF 00001 not used (can't be turned ON)
OFF 00002 DRAM Parity Error 
ON  00004 WatchDog Timeout Reset 
ON  00008 Resource Overflow 
OFF 00010 Clear All Configuration (can't be turned ON)
ON  00020 Missing Task 
OFF 00040 Reset because of PXM Low Voltage (can't be turned ON)
ON  00080 Reset By Event Log Task 
ON  00100 Reset from Shell 
ON  00200 Unknown 
OFF 00400 Reset from PXM (can't be turned ON)
OFF 00800 Reset System (can't be turned ON)
OFF 01000 Switch Core Card 
ON  02000 Secondary Cache Error 
ON  04000 Software Error Reset 
OFF 08000 S/W reset due to upgrade (can't be turned ON)
OFF 10000 Restore All Configuration (can't be turned ON)
ON  20000 Device Driver Error 

M8850_SF.1.28.MPSM8T1.CES.a > 


Note When automatic core dumping is disabled, changing the mask will not have any effect until the core dump feature is enabled using the core enable command.


Restoring the Default Core Dump Mask

Enter the core mask default command to restore the default core dump mask as shown in the following example:

M8850_SF.1.28.MPSM8T1.CES.a > core mask default
Automatic core dumping is enabled for this slot.
The current core mask is 0x273ae.

OFF 00001 not used (can't be turned ON)
ON  00002 DRAM Parity Error 
ON  00004 WatchDog Timeout Reset 
ON  00008 Resource Overflow 
OFF 00010 Clear All Configuration (can't be turned ON)
ON  00020 Missing Task 
OFF 00040 Reset because of PXM Low Voltage (can't be turned ON)
ON  00080 Reset By Event Log Task 
ON  00100 Reset from Shell 
ON  00200 Unknown 
OFF 00400 Reset from PXM (can't be turned ON)
OFF 00800 Reset System (can't be turned ON)
ON  01000 Switch Core Card 
ON  02000 Secondary Cache Error 
ON  04000 Software Error Reset 
OFF 08000 S/W reset due to upgrade (can't be turned ON)
OFF 10000 Restore All Configuration (can't be turned ON)
ON  20000 Device Driver Error 

M8850_SF.1.28.MPSM8T1.CES.a >

If you add all of the reset reasons that are ON in the default mask, the sum is the hexadecimal number 0x273ae.

Hot-Dumping the Core

A hot-dump of the core directs the boot code to save memory but not to reset the card. Because the memory-read during a hot-dump occurs while other tasks are running and modifying the memory, data structures may not be accurate or consistent in a hot-dump. The hot-dump is the only memory dump during which traffic continues to flow. Only one hot-dump of the core memory can take place at a time on an MPSM card.

Enter the core hot-dump command as follows to initiate a hot-dump of the core:

M8850_SF.1.28.MPSM8T1.CES.a > core hot-dump <filename.zip>

Replace the <filename.zip> parameter with a user specified filename with the .zip file extension. Specify a filename not already in use with each hot-dump performed, otherwise the core hot-dump command will fail.


Note When specifying the filename for a hot-dump of the core, do not use the same filename format as used by cold-dump files. This could cause the hot-dump file to be overwritten by a subsequent cold-dump of the core.


In the following example, a hot-dump of the core has been initiated and saved to a user specified file with the name of dump28.zip:

M8850_SF.1.28.MPSM8T1.CES.a > core hot-dump dump28.zip
Do you want to proceed (Yes/No)? y

Creating dump28.zip
..........................................................................................
..............
Creating WINPATHZIP
........................
Done.

M8850_SF.1.28.MPSM8T1.CES.a >


Note A hot-dump and cold-dump of the core memory on the MPSM card may be aborted by using the PXM core abort-dump <slot> command.


Managing Line Conditioning

The following topics describe line conditioning:

Overview of Line Conditioning

Line Conditioning Feature Limitations

Configuring Line Conditioning on CESM and MPSM Cards

Overview of Line Conditioning

Line conditioning is supported on connections configured on structured Circuit Emulation ports. This is helpful in applications where T1 to E1 conversion is required.

Line conditioning is the ability to pass a local CESM or MPSM line alarm across the ATM core network to the remote end, causing the remote CESM or MPSM line to go into alarm. Prior to having this feature, when a local T1 line went into alarm, the far end E1 line stayed up. The local line failure at one end of the T1 or E1 line was not propagated to the far end. (T1 to T1 and E1 to E1 connections do not have this problem because they are end-to-end bit transparent paths, and thus pass line side AIS signals transparently from end-to-end without problems.)

When line conditioning is enabled on a channel in a T1 to E1 configuration, the following events occur during a line fault on either side of the connection:

The local CESM or MPSM line enters the alarm state as a result of a line fault.

The local CESM or MPSM generates channel AIS signals towards the remote CESM or MPSM card.

The alarm task on the remote CESM or MPSM card monitors channel alarm events and if incoming channel AIS signals are detected, it starts generating an unframed all ones AIS signal on the line associated with the channel in alarm, thus putting the remote line in alarm.

The above steps occur in the T1 to E1 and E1 to T1 directions independently.

When line conditioning is disabled on a channel, unframed AIS signals are not sent on the line associated with the channel when the channel receives AIS signals from the remote end indicating a remote line failure. Unframed AIS signal generation on a line also ceases if the channel stops receiving AIS signals.

Line conditioning is supported on the MPSM-8T1-CES, MPSM-8E1-CES, CESM-8T1/B, CESM-8T1, and CESM-8E1 cards.

Table 5-27 shows the CLI commands used to configure and manage line conditioning. For more information on the use of these commands, see Chapter 6, "CESM and MPSM Command Reference."

Table 5-27 Line Conditioning Commands 

Command
Purpose

dspchan

Enter this command to display if line conditioning is enabled or disabled for a specific channel. The line conditioning state is displayed at the ChanLineConditionState parameter.

dspcon

Enter this command to display if line conditioning is enabled or disabled for a specific connection. The line conditioning state is displayed at the ChanLineConditionState parameter.

xcnfchan

Enter this command to enable or disable line conditioning through use of the -linecond option.

xcnfcon

Enter this command to enable or disable line conditioning through use of the -linecond option.

xdspchan

Enter this command to display if line conditioning is enabled or disabled for a specific channel. The line conditioning state is displayed at the ChanLineConditionState parameter.


Line Conditioning Feature Limitations

The following limitations are present with the line conditioning feature:

Line conditioning is not configurable from CWM and must be done using CLI commands.

The channel parameter is not available in the configuration upload file.

Normally, whenever any line alarm is received on a line, including RAI, the port and channels provisioned on that line go into major alarm, and all channels on that line send OAM AIS cells towards the network. When an AIS signal is generated on a line towards the CPE, the CPE will in turn send a RAI alarm back towards the service module. When the line conditioning feature is enabled, AIS OAM will not be sent towards the network if the RAI received from the CPE is a result of the AIS sent to the CPE as a result of this feature. Since we already know the channel is alarm at both ends, sending OAM AIS is not necessary and will avoid channel alarm loops where the channel remains in alarm after removing the failure condition.

In a configuration where the two ends of a channel have line conditioning enabled and the two ends of the lines have physical loopbacks in place, when one of the physical loopbacks is removed and replaced, the two ends of the lines and the channel will be stuck in alarm. To remove the alarms, add a soft loopback (addlnloop) to one line or disable line conditioning on one end of the channel.

In a configuration where the two ends of a channel have line conditioning enabled and the two ends of the lines are connected to the CPE, when the CPE keeps having an alarm condition and recovers from the alarm condition, this situation may cause the lines to be stuck in alarm, although there is a very low probability this will occur. To remove the alarms, add a soft loopback (addlnloop) to one line or disable line conditioning on one end of the channel.

Configuring Line Conditioning on CESM and MPSM Cards

To provision a structured T1 to E1 connection and enable line conditioning on this connection, perform the following steps:


Step 1 Establish a configuration session using a user name with GROUP1 privileges or higher.

Step 2 Enter the addln command to bring up the physical lines on the T1 and E1 ends of the configuration.

The following example shows bringing up the line on the T1 side of the configuration:

PXM1E_SJ.1.4.CESM.a > addln 4

PXM1E_SJ.1.4.CESM.a > dsplns

  Line  Conn      Type     Status/Coding      Length     XmtClock Alarm Stats
        Type                                             Source         Alarm
  ----  ----- ------------ ------ -------- ------------- -------- ----- -----
  4.1   RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim 
  4.2   RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  4.3   RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  4.4   RJ-48 dsx1ESF         Ena/dsx1B8ZS 0-131 ft      LocalTim  No    No 
  4.5   RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim 
  4.6   RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  4.7   RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim 
  4.8   RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim 

  LineNumOfValidEntries:8

PXM1E_SJ.1.4.CESM.a >

The following example shows bringing up the line on the E1 side of the configuration:

M8850_SF.1.30.CESM.a > addln 4

M8850_SF.1.30.CESM.a > dsplns

  Line  Conn      Type     Status/Coding      Length     XmtClock Alarm Stats
        Type                                             Source         Alarm
  ----  ----- ------------ ------ -------- ------------- -------- ----- -----
  30.1  RJ-48 dsx1E1MF        Dis/dsx1HDB3 G.703 120 ohm LocalTim 
  30.2  RJ-48 dsx1E1MF        Dis/dsx1HDB3 G.703 120 ohm LocalTim 
  30.3  RJ-48 dsx1E1MF        Dis/dsx1HDB3 G.703 120 ohm LocalTim           
  30.4  RJ-48 dsx1E1MF        Ena/dsx1HDB3 G.703 120 ohm LocalTim  No    No 
  30.5  RJ-48 dsx1E1MF        Dis/dsx1HDB3 G.703 120 ohm LocalTim 
  30.6  RJ-48 dsx1E1MF        Dis/dsx1HDB3 G.703 120 ohm LocalTim           
  30.7  RJ-48 dsx1E1MF        Dis/dsx1HDB3 G.703 120 ohm LocalTim 
  30.8  RJ-48 dsx1E1MF        Dis/dsx1HDB3 G.703 120 ohm LocalTim 

  LineNumOfValidEntries:8

M8850_SF.1.30.CESM.a >

For more information on bringing up lines, see "Bringing Up Lines" in "Preparing CESM and MPSM Lines and Ports for Communications".

Step 3 Enter the cnfln command to modify any line parameters on the T1 and E1 ends of the configuration.

In the following example, the line transmit clock source on the T1 side has been changed to loop timing:

PXM1E_SJ.1.4.CESM.a > cnfln 4 2 10 1

PXM1E_SJ.1.4.CESM.a > dspln 4

  LineNum:                  4
  LineConnectorType:        RJ-48
  LineEnable:               Modify
  LineType:                 dsx1ESF
  LineCoding:               dsx1B8ZS
  LineLength:               0-131 ft
  LineXmtClockSource:       LoopTiming
  LineLoopbackCommand:      NoLoop
  LineSendCode:             NoCode
  LineUsedTimeslotsBitMap:  0x0
  LineLoopbackCodeDetection:codeDetectDisabled
  
  LineNumOfValidEntries:8

PXM1E_SJ.1.4.CESM.a >

In the following example, the line transmit clock source on the E1 side has been changed to loop timing:

M8850_SF.1.30.CESM.a > cnfln 4 3 9 1 CAS

M8850_SF.1.30.CESM.a > dspln 4

  LineNum:                  4
  LineConnectorType:        RJ-48
  LineEnable:               Modify
  LineType:                 dsx1E1MF
  LineCoding:               dsx1HDB3
  LineLength:               G.703 120 ohm
  LineXmtClockSource:       LoopTiming
  LineLoopbackCommand:      NoLoop
  LineSendCode:             NoCode
  LineUsedTimeslotsBitMap:  0x0
  LineLoopbackCodeDetection:codeDetectDisabled
  
  LineNumOfValidEntries:8

M8850_SF.1.30.CESM.a > 

The examples above show the T1 and E1 sides configured to loop timing. In this clocking configuration, unless the CPE equipment attached to both the T1 and E1 side is traceable back to the same clock source, bit errors are likely to occur. If the CPE equipment attached to both the T1 and E1 side is not traceable back to the same clock source, then an alternative solution is to configure both lines on the T1 and E1 side to use local timing, with one MGX switch clocked to the other MGX switch.


Note Each individual network will have unique clocking architecture requirements and therefore the examples above are not intended to be the only solution for a T1 to E1 clocking solution in a network. These examples serve only as a reminder that it is important to develop a robust clocking plan for a network using CESM and MPSM cards, otherwise dribbling bit errors, frame slips, and other timing issues may be encountered in the network.


For more information on configuring lines, see "Configuring Lines" in "Preparing CESM and MPSM Lines and Ports for Communications".

Step 4 Enter the addport command to add structured ports on the T1 and E1 ends of the configuration.

The following example adds a structured port on the T1 side of the configuration:

PXM1E_SJ.1.4.CESM.a > addport 4 4 1 24 1

PXM1E_SJ.1.4.CESM.a > dspport 4

  SlotNum:                     4
  PortLineNum:                 4
  PortNum:                     4
  PortRowStatus:               Add
  PortNumOfSlots:              24
  PortDs0ConfigBitMap(1stDS0): 0xffffff(1)
  PortSpeed:                   1536kbps
  PortType:                    structured
  PortState:                   Active


PXM1E_SJ.1.4.CESM.a >

The following example adds a structured port on the E1 side of the configuration:

M8850_SF.1.30.CESM.a > addport 4 4 2 24 1

M8850_SF.1.30.CESM.a > dspport 4

  SlotNum:                     30
  PortLineNum:                 4
  PortNum:                     4
  PortRowStatus:               Add
  PortNumOfSlots:              24
  PortDs0ConfigBitMap(1stDS0): 0x3fefffe(2)
  PortSpeed:                   1536kbps
  PortType:                    structured
  PortState:                   Active


M8850_SF.1.30.CESM.a > 

For more information on adding ports, see "Adding Circuit Emulation Ports" in "Preparing CESM and MPSM Lines and Ports for Communications".

Step 5 Enter the addcon command to add a connection between the T1 and E1 sides of the configuration.

In this step we are using the example of adding an SPVC between the T1 and E1 ports.

The following example adds the slave side of an SPVC to the E1 side of the configuration:

M8850_SF.1.30.CESM.a > addcon 4

Local Connection ID is :47009181000000000164444b6100000107f30400.30.38

M8850_SF.1.30.CESM.a >

The following example add the master side of an SPVC to the T1 side of the configuration:

PXM1E_SJ.1.4.CESM.a > addcon 4 -master 1 -rmc 
47009181000000000164444b6100000107f30400.30.38

PXM1E_SJ.1.4.CESM.a >

After adding the master side of the SPVC, enter the dspcons command to verify that the SPVC has been added successfully and is not in alarm:

PXM1E_SJ.1.4.CESM.a >dspcons

  LCN  Port.VPI.VCI Type M/S Clock PCR    CDVT  BufSz CLIP  Admin Alarm 
  ---- ------------ ---- --- ----- ------ ----- ----- ----- ----- ----- 
  0038 004.04.038   stru M   Synch 4096   01000 00384 02500 Up    OK 

  Number of channels:   4

  ChanNumNextAvailable: 39

PXM1E_SJ.1.4.CESM.a >

Using the tstcon command from both sides of the connection also verifies the successful addition of the SPVC connection.

For more information on adding SPVC connections, see "Configuring SPVCs on CESM and MPSM Cards" in "Provisioning SPVCs (PXM1E/PXM45) on CESM and MPSM Cards".


Note Line conditioning is also supported on PVCs. For information on adding PVC connections, see "Configuring PVCs on CESM and MPSM Cards" in "Provisioning PVCs (PXM1) on CESM and MPSM Cards".


Step 6 Enter the xcnfchan or xcnfcon command to enable line conditioning on the connection added between the T1 and E1 sides of the configuration.

Line conditioning must be enabled on both sides of the connection to fully condition the connection provisioned on the structured T1 and E1 ports.

The following example enables line conditioning on the T1 side using the xcnfchan command:

PXM1E_SJ.1.4.CESM.a > xcnfchan -chn 38 -en 3 -linecond 1

PXM1E_SJ.1.4.CESM.a > 

The following example enables line conditioning on the E1 side using the xcnfcon command:

M8850_SF.1.30.CESM.a > xcnfcon -chn 38 -en 3 -linecond 1

M8850_SF.1.30.CESM.a > 

For more information on using the xcnfchan and xcnfcon commands, see Chapter 6, "CESM and MPSM Command Reference".

Step 7 Enter the dspchan, dspcon, or xdspchan command to verify that line conditioning has been enabled on a connection.

The following example displays line conditioning enabled on the T1 side of the connection. The line conditioning state is displayed at the ChanLineConditionState parameter:

PXM1E_SJ.1.4.CESM.a > dspchan 38

  -------------------------------------------
  ChanNum:  38         RowStatus:Mod       
  AdmnState:Up         ChanState:Ok        
  ---------- ---------- ---------- ---------- 
  PORT-ALARM CTRLR-ABIT E-AIS/RDI  CELL-LOSS  
  ---------- ---------- ---------- ---------- 
      NO         NO         NO         NO     
  -------------------------------------------

  ChanNum:                 38
  ChanRowStatus:           Mod
  ConnAdminStatus:         Up
  ChanLineNum:             4
  ChanMapVpi:              4
  ChanMapVci:              38
  ChanCBRService:          struct
  ChanClockMode:           Synchronous
  ChanCAS:                 Basic
  ChanPartialFill:         47
  ChanMaxBufSize:          384 bytes
  ChanCDVT:                1000 micro seconds
  C L I P:                 2500 milliseconds
  ChanLocalRemoteLpbkState:Disabled
  ChanTestType:            TestOff
  ChanTestState:           Passed
  ChanRTDresult:           2 ms
  ChanPortNum               4
  ChanConnType              SPVC
  ISDetType                 DetectionDisabled
  CondData                  255
  CondSignalling            15
  ExtISTrig                 DisableIdleSupression
  ISIntgnPeriod             3 seconds 
  ISSignallingCode          0
  OnHookCode                1
  ChanLocalVpi:            4
  ChanLocalVci:            38
  ChanLocalNSAP:           4700918100000000001a53337700000107230400
  ChanRemoteVpi:           30
  ChanRemoteVci:           38
  ChanRemoteNSAP:          47009181000000000164444b6100000107f30400
  ChanMastership:          Master
  ChanVpcFlag:             Vcc
  ChanConnServiceType:     CBR1
  ChanRoutingPriority:     8
  ChanPreferredRouteId:    0
  ChanDirectedRoute:       No
  ChanMaxCost:             2147483647
  ChanRestrictTrunkType:   No Restriction
  ChanConnPCR:             4096
  ChanConnMCR:             4096
  ChanConnPercentUtil:     100
  Channel Reroute:         False
  ChanLineConditionState:  Enabled

  ChanNumNextAvailable: 39

PXM1E_SJ.1.4.CESM.a > 

For more information on using the dspchan, dspcon, and xdspchan commands, see Chapter 6, "CESM and MPSM Command Reference".