Cisco Frame Relay Services (FRSM/MPSM) Configuration Guide and Command Reference for MGX Switches, Release 5
Managing FRSM and MPSM Cards

Table Of Contents

Managing FRSM and MPSM Cards

Managing CLI Sessions

Managing Cards

Displaying General Card Information

Displaying Software Version and Status Information

Displaying FRSM 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

Deleting Ports

Monitoring Port Statistics

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

Testing with cnftrafficgen

Monitoring Connection Statistics

Displaying Connection Alarms

Managing Loopbacks

FRSM 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

FRSM-2T3E3 Onboard BERT

FRSM-2T3E3 Onboard BERT Features

Managing a BERT Session on the FRSM-2T3E3

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 FRSM and MPSM Cards


This chapter provides procedures for managing FRSM-8T1, FRSM-8E1, FRSM-2T3E3, FRSM-2CT3, FRSM-HS2/B, MPSM-8T1-FRM, and MPSM-8E1-FRM 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, 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 FRSM and MPSM cards is described in "Preparing FRSM and MPSM Lines and Ports for Communications," "Provisioning SPVCs (PXM1E/PXM45) on FRSM and MPSM Cards," and "Provisioning PVCs (PXM1) on FRSM and MPSM Cards."


This chapter describes the following FRSM 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 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, 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 FRSM and MPSM cards. For more information on these commands, see Chapter 6, "FRSM 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.

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, 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 FRSM 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, "FRSM and MPSM Command Reference."


Displaying General Card Information

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

The following example shows general information about a FRSM-HS2/B card:

PXM1E_SJ.1.11.VHSHS2B.a > dspcd

  ModuleSlotNumber:          11
  FunctionModuleState:       Active
  FunctionModuleType:        FRSM-HS2B-12IN1
  FunctionModuleSerialNum:   SAG05274SFR
  FunctionModuleHWRev:       ex
  FunctionModuleFWRev:       020.000.001.046-A
  FunctionModuleResetReason: Reset by PXM
  LineModuleType:            LM-12in1-8s
  LineModuleState:           Present
  mibVersionNumber:          80
  configChangeTypeBitMap:    CardCnfChng, LineCnfChng
  cardIntegratedAlarm:       Major
  cardMajorAlarmBitMap:      Line Alarm
  cardMinorAlarmBitMap:      Channel failure

      Front Card Info        

  pcb part no-(800 level):   800-17066-01 
  pcb part no-(73 level):    73-06948-01 
  pcb revision (800 level):  02 
  fab par no-(28 level):     28-05059-01 
  pcb serial no:             SAG05274SFR 
  clei code:                 0 
  manufacturing eng:         0x0        
  rma test history1:         0x0        
  rma test history2:         0x0        
  rma history:               0x0        
  platform features:         0x1        
  self test result:          0x0 

      Back Card Info        

  pcb part no-(800 level):   800-12345-01 
  pcb part no-(73 level):    73-01234-01 
  pcb revision (800 level):  02 
  fab par no-(28 level):     28-01234-01 
  pcb serial no:             123456 
  clei code:                 00 
  manufacturing eng:         0x0        
  rma test history1:         0x0        
  rma test history2:         0x0        
  rma history:               0x0        
PXM1E_SJ.1.11.VHSHS2B.a >


Note Note that the dspcd command displays information on card alarms.


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

M8850_SF.1.28.MPSM8T1.FRM.a > dspcd


  ModuleSlotNumber:          28
  FunctionModuleState:       Active
  FunctionModuleType:        MPSM-8T1-FRM
  FunctionModuleSerialNum:   SAG07208RRA
  FunctionModuleHWRev:       02
  FunctionModuleFWRev:       030.000.001.077-A
  FunctionModuleResetReason: Software Error
  LineModuleType:            ?
  LineModuleState:           Not Present
  mibVersionNumber:          100
  configChangeTypeBitMap:    No changes
  cardIntegratedAlarm:       Minor
  cardMinorAlarmBitMap:      Channel failure

      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.FRM.a >

To determine whether a card is a FRSM-8T1, FRSM-8E1, FRSM-2T3E3, FRSM-2CT3, FRSM-HS2/B, MPSM-8T1-FRM, or MPSM-8E1-FRM card, use the dspcd command on the FRSM 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 FRSM or MPSM card, use the chkflash and version commands.

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

PXM1E_SJ.1.30.FRSM.a > chkflash
Program length = 300145
Calculated checksum = 147bc308 stored checksum = 147bc308
Flash checksum passed

The following example shows the status of the boot software on an MPSM-8T1-FRM card:

M8850_SF.1.28.MPSM8T1.FRM.a > chkflash

[chkflashfn]: Program length = 1415976
Calculated checksum = 0xad984cff stored checksum = 0xad984cff

Flash checksum passed

M8850_SF.1.28.MPSM8T1.FRM.a > 

The following example displays the software versions running on a FRSM-HS2/B card:

PXM1E_SJ.1.11.VHSHS2B.a > version
***** Cisco System. FRSM-VHS Card *****
    Firmware Version    = 020.000.001.046-A
    Backup Boot version = VHS_BT_1.0.04_19Jul0
VxWorks (for CISCO) version 5.3.1.
Kernel: WIND version 2.5.
Made on Mon Apr 29 02:03:54 PDT 2002.
Boot line:

PXM1E_SJ.1.11.VHSHS2B.a >

The following example displays the software versions running on an MPSM-8T1-FRM card

M8850_SF.1.28.MPSM8T1.FRM.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.FRM.a > 

Displaying FRSM Card Features

Use the dspfeature command to display the features supported on FRSM cards. Some FRSM cards are available in channelized and nonchannelized versions, and all FRSM cards support the rate control feature for standard ABR and ForeSight services. ForeSight is supported only on PXM1 platforms.

The FRSM-8T1 and FRSM-8E1 cards are available in channelized and nonchannelized versions. The nonchannelized versions are labeled FRSM-8T1 and FRSM-8E1 on the front of the cards, and the channelized versions are labeled FRSM-8T1-C and FRSM-8E1-C. However, the CLI prompt on the FRSM card and the output of the dspcds (supported on the PXM1, PXM1E, or PXM45 controller card) and dspcd (supported on the FRSM card) commands do not differentiate between the channelized and nonchannelized versions.

To determine if a FRSM-8T1 or FRSM-8E1 is a nonchannelized or channelized version using the CLI, enter the dspfeature command as shown in the following example:

PXM1E_SJ.1.30.FRSM.a > dspfeature

  Channelized:  On
  Rate Control:  On

This example also shows that rate control is supported on the FRSM card.

The FRSM-2CT3 card also supports channelized T1 lines. Normally, this feature is enabled. If the channelization feature is turned off on the FRSM-2CT3 card, the T1 lines support only fractional T1 ports.

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 allocated to 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 rekey feature licenses, refer to the Cisco MGX 8850 (PXM1E/PXM45), Cisco MGX 8950, and Cisco MGX 8830 Configuration Guide, Release 5 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.

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. A rate control feature license is required to provision standard ABR and ForeSight services. ForeSight is supported only on PXM1 platforms.

In the following example, a standard ABR connection has been provisioned on an MPSM-8T1-FRM card. The displiccd command shows that one rate control feature license was needed and that one rate control feature license has been allocated to the MPSM card from the PXM license pool in order to provision the connection successfully:

M8850_SF.1.28.MPSM8T1.FRM.a > dspliccd
Card License Alarm:              None
Service Module Type:             MPSM8T1E1
Service Module Serial Number:    SAG07208RRA
Provisioning (addcon) Allowed:   YES
=========================================================
Needed License Type               Needed Licenses
-------------------               ---------------
RateControl                       1

=========================================================
Allocated License Type            Allocated licenses
----------------------            ------------------
RateControl                       1

=========================================================
Programmed  License Type          Programmed licenses
------------------------          -------------------

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

M8850_SF.1.28.MPSM8T1.FRM.a >

This example also shows that no feature licenses have been programmed into the NVRAM of the MPSM card.

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

M8250_SJ.1.22.MPSM8T1.FRM.a > dspliccd
Card License Alarm:            None
Service Module Type:           MPSM8T1E1
Service Module Serial Number:  SAG07208RSX
Provisioning (addcon) Allowed: YES
=========================================================
Needed License Type               Needed Licenses
-------------------               ---------------

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

=========================================================
Programmed  License Type          Programmed licenses
------------------------          -------------------
Rate-Control                      1

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

M8250_SJ.1.22.MPSM8T1.FRM.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:

M8250_SJ.1.22.MPSM8T1.FRM.a > movelic
------------------------------------------------
Programmed License Type          #Programmed
-----------------------          -----------
Rate-Control                      1

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

Card Licenses have been moved to license pool.

M8250_SJ.1.22.MPSM8T1.FRM.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:

M8250_SJ.1.22.MPSM8T1.FRM.a > dspliccd
Card License Alarm:            None
Service Module Type:           MPSM8T1E1
Service Module Serial Number:  SAG07208RSX
Provisioning (addcon) Allowed: YES
=========================================================
Needed License Type               Needed Licenses
-------------------               ---------------

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

=========================================================
Programmed  License Type          Programmed licenses
------------------------          -------------------
Rate-Control                      1

=========================================================
Programmed License Registered: YES
License registration node: M8250_SJ
License registration chassis: SCA05020GGR
=========================================================

M8250_SJ.1.22.MPSM8T1.FRM.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:

M8250_SJ.1.7.PXM.a > dsplics
Licensed           License      Licenses   Licenses   Licenses
Card Type          Type         Installed  Allocated  Available
-----------------  -----------  ---------  ---------  ---------
MPSM-8T1E1         RateControl  1          0          1 

M8250_SJ.1.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 allocate a rate control feature license to an MPSM card using Frame Relay services, add a standard ABR connection using the addcon command. If the license pool on the PXM card has an available license for that feature and MPSM card type, that license is automatically allocated to the MPSM 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 allocated to the MPSM card, it is no longer available for use by other MPSM cards until it returns to the license pool.

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

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. As shown in the following example on the PXM45 platform, the output of this command will indicate if the switch is in the node license alarm state:

M8850_SF.8.PXM.a > dspndalms
Node Alarm Summary

Alarm Type                     Critical        Major          Minor
----------                     --------       -------        -------
Clock Alarms                         0             0              0
Switching Alarms                     0             0              0
Environment Alarms                   0             0              0
Card Alarms                          0             0              0
Node License Alarm                   0             0              1

M8850_SF.8.PXM.a >

On PXM1 platforms, use the PXM dspcd command to troubleshoot the node license alarm. As shown in the following example, if the switch is in the node license alarm state, the cardIntegratedAlarm will be minor and the cardMinorAlarmBitMap will indicate License Alarm:

M8850_R1.1.7.PXM.a > dspcd

    ModuleSlotNumber:          7
    FunctionModuleState:       Active
    FunctionModuleType:        PXM1-OC3
    FunctionModuleSerialNum:   SAG05304YHH
    FunctionModuleHWRev:       D0
    FunctionModuleFWRev:       1.3.10.065
    FunctionModuleResetReason: Restoreallcnf
    LineModuleType:            PXM-UI
    LineModuleState:           Present
    SecondaryLineModuleType:   SMFIR-4-155
    SecondaryLineModuleState:  Present
    mibVersionNumber:          1.2.20
    configChangeTypeBitMap:    No changes
    cardIntegratedAlarm:       Minor
    cardMajorAlarmBitMap:      Clear
    cardMinorAlarmBitMap:      License Alarm
    BkCardSerialNum:           SBK042501CN
    TrunkBkCardSerialNum:      SBK05070188
    FrontCardPCBNumber:        800-06229-04
    TrunkBkCardPCBNumber:      800-05351-01
    UIBkCardPCBNumber:         800-03688-01

    SrmBackCardPCBNumber:      Not Applicable

M8850_R1.1.7.PXM.a > 

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 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 PXM1E, PXM45, and PXM1 platforms, use the PXM dsplicalms command to troubleshoot slot license alarms. The output of this command will indicate which MPSM cards are in the slot license alarm state.

The following example shows the output of the PXM dsplicalms command on the PXM45 platform. In this example, the MPSM card in slot 28 is in slot license alarm:

M8850_SF.8.PXM.a > dsplicalms
M8850_SF                         System Rev: 05.00   Jul. 10, 2004 04:35:12 GMT
MGX8850                                              Node Alarm: MINOR
Slot  Critical   Major     Minor   ||  Slot  Critical   Major     Minor 
----  --------  -------   -------  ||  ----  --------  -------   -------
 1          0        0         0   ||  17          0        0         0
 2          0        0         0   ||  18          0        0         0
 3          0        0         0   ||  19          0        0         0
 4          0        0         0   ||  20          0        0         0
 5          0        0         0   ||  21          0        0         0
 6          0        0         0   ||  22          0        0         0
 7          0        0         0   ||  23          0        0         0
 8          0        0         0   ||  24          0        0         0
 9          0        0         0   ||  25          0        0         0
10          0        0         0   ||  26          0        0         0
11          0        0         0   ||  27          0        0         0
12          0        0         0   ||  28          0        0         1
13          0        0         0   ||  29          0        0         0
14          0        0         0   ||  30          0        0         0
15          0        0         0   ||  31          0        0         0
16          0        0         0   ||  32          0        0         0

M8850_SF.8.PXM.a >

The following example shows the output of the PXM dsplicalms command on the PXM1 platform. In this example, the MPSM card in slot 22 is in slot license alarm:

M8850_R1.1.7.PXM.a > dsplicalms
Slot  Critical   Major     Minor   ||  Slot  Critical   Major     Minor 
----  --------  -------   -------  ||  ----  --------  -------   -------
 1          0        0         0   ||  17          0        0         0
 2          0        0         0   ||  18          0        0         0
 3          0        0         0   ||  19          0        0         0
 4          0        0         0   ||  20          0        0         0
 5          0        0         0   ||  21          0        0         0
 6          0        0         0   ||  22          0        0         1
 7          0        0         0   ||  23          0        0         0
 8          0        0         0   ||  24          0        0         0
 9          0        0         0   ||  25          0        0         0
10          0        0         0   ||  26          0        0         0
11          0        0         0   ||  27          0        0         0
12          0        0         0   ||  28          0        0         0
13          0        0         0   ||  29          0        0         0
14          0        0         0   ||  30          0        0         0
15          0        0         0   ||  31          0        0         0
16          0        0         0   ||  32          0        0         0

M8850_R1.1.7.PXM.a > 

On PXM45, PXM1E, and PXM1 platforms, the output of the PXM dspliccd <slot> command also shows if a card is in slot license alarm and displays how much time is left in the alarm grace period and if provisioning is allowed with the addcon command.

The following example shows the output of the PXM dspliccd <slot> command of an MPSM-8T1-FRM card in a PXM45 platform in the slot license alarm state:

M8850_SF.8.PXM.a > dspliccd 28
M8850_SF                         System Rev: 05.00   Jul. 10, 2004 05:02:24 GMT
MGX8850                                              Node Alarm: MINOR
Card License Alarm:             Minor
Service Module Type:            MPSM-8T1-FRM
Service Module Serial Number:   SAG07208RRA
Provisioning Allowed:           Yes
Grace-Period Remaining:         4 Days, 22 Hrs

=========================================================
Allocated License Type      Quantity
--------------------        --------
RateControl                 1

=========================================================
Programmed License Type     Quantity
--------------------        --------
RateControl                 1

=========================================================
Programmed License Registered:           Yes
License Registeration Node:              M8850_SF
License Registeration Chassis Serial No: SCA062300GF

M8850_SF.8.PXM.a > 

The following example shows the output of the PXM dspliccd <slot> command of an MPSM-8T1-FRM card in a PXM1 platform in the slot license alarm state:

M8850_R1.1.7.PXM.a > dspliccd 22
Card License Alarm:             Minor
Service Module Type:            MPSM-8T1E1
Service Module Serial Number:   SAD073103HH
Provisioning Allowed:           Yes
Grace-Period Remaining:         4 Days, 23 Hrs

=========================================================
Allocated License Type      Quantity
--------------------        --------
RateControl                 1

=========================================================
Programmed License Type     Quantity
--------------------        --------

=========================================================
Programmed Licenses Registered:          N/A
License Registration Node:               --
License Registration Chassis Serial No:  --

M8850_R1.1.7.PXM.a > 

On PXM45, PXM1E, and PXM1 platforms, the dspcd command will indicate if a card is in slot license alarm. If the card is in the slot license alarm state, the cardIntegratedAlarm will be minor and the cardMinorAlarmBitMap will indicate License Alarm.

The following example shows the output of the dspcd command of an MPSM-8T1-FRM card in a PXM45 platform in the slot license alarm state:

M8850_SF.1.28.MPSM8T1.FRM.a > dspcd 

  ModuleSlotNumber:          28
  FunctionModuleState:       Active
  FunctionModuleType:        MPSM-8T1-FRM
  FunctionModuleSerialNum:   SAG07208RRA
  FunctionModuleHWRev:       02
  FunctionModuleFWRev:       030.000.004.016-P2
  FunctionModuleResetReason: Reset by PXM
  LineModuleType:            LM-RJ48-8T1
  LineModuleState:           Present
  mibVersionNumber:          102
  configChangeTypeBitMap:    No changes
  cardIntegratedAlarm:       Minor
  cardMinorAlarmBitMap:      LICENSE 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):   000-00000-00 
  PCB PART NO-(73 LEVEL):    00-00000-00 
  PCB REVISION (800 LEVEL):  AA 
  FAB PART NO-(28 LEVEL):    28-02011-01 
  PCB SERIAL NO:             648467 
  MANUFACTURING ENG:         0x1C       
  RMA HISTORY:               0x0        
M8850_SF.1.28.MPSM8T1.FRM.a >

The following example shows the output of the dspcd command on an MPSM-8T1-FRM card in a PXM1 platform in the slot license alarm state:

M8850_R1.1.22.MPSM8T1.FRM.a > dspcd

  ModuleSlotNumber:          22
  FunctionModuleState:       Active
  FunctionModuleType:        MPSM-8T1-FRM
  FunctionModuleSerialNum:   SAD073103HH
  FunctionModuleHWRev:       02
  FunctionModuleFWRev:       030.000.004.016-P2
  FunctionModuleResetReason: Reset by PXM
  LineModuleType:            LM-RJ48-8T1
  LineModuleState:           Present
  mibVersionNumber:          102
  configChangeTypeBitMap:    No changes
  cardIntegratedAlarm:       Minor
  cardMinorAlarmBitMap:      LICENSE ALARM

      Front Card Info        

  PCB PART NO-(800 LEVEL):   800-24473-01 
  PCB PART_NO-(73 LEVEL):    73-9197-01 
  PCB REVISION (800 LEVEL):   
  PCB SERIAL NO:             SAD073103HH 
  CLEI CODE:                 0 
  MANUFACTURING ENG:         0x0        
  RMA TEST HISTORY:          0x0        
      Back Card Info        

  PCB PART NO-(800 LEVEL):   000-00000-00 
  PCB PART NO-(73 LEVEL):    00-00000-00 
  PCB REVISION (800 LEVEL):  AC 
  FAB PART NO-(28 LEVEL):    28-02011-01 
  PCB SERIAL NO:             B75816 
  MANUFACTURING ENG:         0x1C       
  RMA HISTORY:               0x0        
M8850_R1.1.22.MPSM8T1.FRM.a > 

On PXM45, PXM1E, and PXM1 platforms, the output of the dspliccd command also shows if a card is in slot license alarm.

The following example shows the output of the dspliccd command of an MPSM-8T1-FRM card in a PXM45 platform in the slot license alarm state:

M8850_SF.1.28.MPSM8T1.FRM.a > dspliccd
Card License Alarm:              Minor
Service Module Type:             MPSM8T1E1
Service Module Serial Number:    SAG07208RRA
Provisioning (addcon) Allowed:   YES
=========================================================
Needed License Type               Needed Licenses
-------------------               ---------------
RateControl                       1

=========================================================
Allocated License Type            Allocated licenses
----------------------            ------------------
RateControl                       1

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

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

Type <CR> to continue, Q<CR> to stop: 
License registration chassis:    SCA062300GF
=========================================================

M8850_SF.1.28.MPSM8T1.FRM.a >

The following example shows the output of the dspliccd command of an MPSM-8T1-FRM card in a PXM1 platform in the slot license alarm state:

M8850_R1.1.22.MPSM8T1.FRM.a > dspliccd
Card License Alarm:              Minor
Service Module Type:             MPSM8T1E1
Service Module Serial Number:    SAD073103HH
Provisioning (addcon) Allowed:   YES
=========================================================
Needed License Type               Needed Licenses
-------------------               ---------------
RateControl                       1

=========================================================
Allocated License Type            Allocated licenses
----------------------            ------------------
RateControl                       1

=========================================================
Programmed  License Type          Programmed licenses
------------------------          -------------------

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

M8850_R1.1.22.MPSM8T1.FRM.a > 

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 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 FRSM and MPSM Lines and Ports for Communications," describes how to bring up (add) and modify FRSM 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, "FRSM and MPSM Command Reference."


Displaying a List of Lines

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

PXM1E_SJ.1.25.FRSM.a > dsplns

  Line  Conn      Type     Status/Coding      Length     XmtClock Alarm Stats
        Type                                             Source         Alarm
  ----  ----- ------------ ------ -------- ------------- -------- ----- -----
  25.1  RJ-48 dsx1ESF         Mod/dsx1B8ZS 0-131 ft      LocalTim  Yes   No 
  25.2  RJ-48 dsx1ESF         Ena/dsx1B8ZS 0-131 ft      LocalTim  No    No 
  25.3  RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  25.4  RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  25.5  RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  25.6  RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  25.7  RJ-48 dsx1ESF         Dis/dsx1B8ZS 0-131 ft      LocalTim           
  25.8  RJ-48 dsx1ESF         Ena/dsx1B8ZS 0-131 ft      LocalTim  Yes   No 

  LineNumOfValidEntries: 8

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 a FRSM or MPSM card, enter the dspln command as follows:

PXM1E_SJ.1.30.FRSM.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 a FRSM card:

PXM1E_SJ.1.25.FRSM.a > dspln 2

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

  LineNumOfValidEntries: 8

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.30.FRSM.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.11.VHSHS2B.a > delln 8

PXM1E_SJ.1.11.VHSHS2B.a >


Managing Line Alarms

FRSM and MPSM cards generate line alarms when errors occur as specified in ANSI T1.231. The significance of the different types of alarms appears in Table 5-2.

Table 5-2 FRSM and MPSM Line Errors and Alarms 

Error
Alarm
Type
Transmit Downstream
Transmit Upstream
Comments

LOS (Loss of Signal)

Red

AIS OAM cells

RAI

Send line alarm trap

LOF (Loss of Frame)

Red

AIS OAM cells

RAI

Send line alarm trap

AIS (Alarm Indication Signal)

AIS (Blue) when receiving AIS on the line

AIS OAM cells

RAI

Send line alarm trap

MFAIS (E1 CAS only)

AIS (Blue) when receiving AIS on the line

AIS OAM cells

RAI

Send line alarm trap

RAI (Remote Alarm Indication)

Yellow

Send line alarm trap

MFRAI (E1 CAS only)

Yellow

Send line alarm trap

Loss of Multi-frame Sync (E1 CAS only)

Red

AIS OAM cells

RAI

Send line alarm trap

Loss of CRC MF Alignment (E1 CRC only)

Red

AIS OAM cells

RAI

Send line alarm trap



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.


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

Table 5-3 FRSM 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.


Managing Ports

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

Displaying a List of Ports

Displaying the Status of a Single Port

Deleting Ports

Monitoring Port Statistics

Displaying a List of Ports

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

PXM1E_SJ.1.30.FRSM.a > dspports

    Port   Ena/Speed EQServ  SignalType  T391 T392 N391 N392 N393   Type   Alarm ELMI
                     Ratio
  -------- --- ----- ------ ------------ ---- ---- ---- ---- ---- -------- ----- ----
  30.3.3   Add/1536k   1    NoSignalling   10   15    6    3    4 frameRel  No   Off
  30.4.4   Add/1536k   1    NoSignalling   10   15    6    3    4 frameRel  No   Off

  Number of ports:              2

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

The port number is found in the Port column in the format Slot.Line.Port. To determine if a port is in alarm, check the status in the Alarm column. 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 FRSM or MPSM card, enter the dspport command as follows:

PXM1E_SJ.1.30.FRSM.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 display for port 3.

PXM1E_SJ.1.30.FRSM.a > dspport 3

  SlotNum:                      30
  PortLineNum:                  3
  PortNum:                      3
  PortRowStatus:                Add
  PortDs0Speed:                 64k
  PortDs0ConfigBitMap(1stDS0):  0xffffff(1)
  PortEqueueServic