MTP 2 manager: mtp2mgr

Name

mtp2mgr

Purpose

After downloading the MTP 2 configuration to the TX board with mtp2cfg, run mtp2mgr to monitor the status of the MTP 2 layer. mtp2mgr provides a command line interface from which statistics can be viewed.

Usage

mtp2mgr -b board

Prerequisites

Requires a single computer with a TX board installed and the following software:

Procedure

To run mtp2mgr, enter the following command at the command line prompt:

mtp2mgr -b board

where board is the TX board number to open.

mtp2mgr supports the following commands:

Command

Description

STATS link

Retrieves the statistics for the specified link.

STATUS link

Retrieves status information for the specified link.

MTP2FLOW ON | OFF

Deprecated.

BOARD board

Switches to a new target board.

Q

Quits the application.

? command

Lists available commands or parameters of a specified command.


The following sample shows output from mtp2mgr with the STATS command:

     mtp2mgr[1]>stats link 0
     Board 1, Link 0 MTP2 Stats:

inService  = 1037     lclBusy     = 0         slFailAll   = 1  
slFailAb   = 0        slFailAck   = 0         slFailErr   = 1 
slFailCong = 0        slFailAlign = 0         slNSUErr    = 0 
slNegAck   = 0        nRetrans    = 0       

Msg:        Rx        Tx          Msg:       Rx        Tx      
---         --        --          -----      -----     -----   
SIF/SIO     3         2           MSU        417       413     
LSSU*       12        12          FISU*      37984     37497   
* LSSU & FISU counts do not include those filtered by the firmware

               Current    High
               -------    ----
Tx Queue:      0          270     
Rtb Queue:     0          4       
lTx Queue:     0          125     
Sap Queue:     0          0       

The following table describes the mtp2mgr statistics:

Statistic

Description

inService

Amount of time (in 1/10 of a second) that the link has been in service (aligned).

lclBusy

Amount of time (in 1/10 of a second) that the link has been in congestion.

slFailAb

Number of bad sequence numbers in received frames.

slFailAck

Number of times an acknowledgment was not received within the T7 timeout.

slFailErr

Number of link failures due to the SUERM threshold being reached.

slFailCong

Number of link failures due to the T5 congestion timer expiring.

slFailAlign

Number of alignment failures due to T2 expiration.

slFailAll

Total number of link failures due to the link failure reasons.

slNSUErr

Not used.

slNegAck

Number of negative acknowledgments received.

nRetrans

Number of retransmissions performed.

SIF/SIO Tx

Number of SIO frames sent during alignment (normal error checking).

SIF/SIO Rx

Number of SIO frames received during alignment (both normal and PCR error checking).

MSU Tx/Rx

Number of message signal units transmitted and received.

LSSU Tx/Rx

Number of LSSUs transmitted and received. Counts do not include frames filtered by the firmware.

FISU Tx/Rx

Number of FISUs transmitted and received. Counts do not include frames filtered by the firmware.

Tx Queue

Current count and high water mark of the number of messages queued on the transmit queue waiting to be sent out to the network.

RtbQueue

Current count and high water mark of the number of messages queued on the retransmission queue. These are messages that have been transmitted but not yet acknowledged by the remote side.

lTx Queue

Current count and high water mark of the number of messages queued on the lower transmit queue. These are messages that were taken off the Tx Queue to be sent but could not be because layer 1 was busy at the time.

Sap Queue

Current count and high water mark of the number of messages queued on the inbound sap queue waiting to be sent to MTP 3.


The following sample shows output from mtp2mgr with the STATUS command:

mtp2mgr[1]>status link 0
Board 1, Link 0 MTP2 Status:

High lvl state = ENABLED    Frames out    = 1     Frames dropped = 0       
Low  lvl state = IN_SERVICE          

---- Current Link (0) Layer 2 configuration ----

Link Name  = T1      
maxFrmLen  = 272      congDisc = FALSE   
errType    = NORMAL   lssuLen  = 2          SUERMD rate = 256 
SUERM Thrsh= 64       AERM Thrsh N= 4       AERM Thrsh E= 1
    
Max RTB Msg= 127      Max RTB Oct = 34544   Max Prov Abt= 5
IsoThresh  = 1000     TxqThresh1  = 50      TxqThresh1A = 20
TxqThresh2 = 200      TxqThresh2A = 100     SapThresh   = 500
SapThreshA = 100     


       ----- Layer 2 Timers (in tenths/sec) -----
L2 t1      = 400       L2 t2      = 100       L2 t3      = 15 
L2 t4 norm = 82        L2 t4 emrg = 5         L2 t5      = 1  
L2 t6      = 60        L2 t7      = 20        L2 t10     = 30
L2 t11     = 20        L2 t12     = 20        L2 t13     = 20 

The following table describes the mtp2mgr status information:

Status

Description

High lvl state

Valid values are:

UNBOUND = Initial state

CONFIGURED = Link has been configured. Still unbound

DISABLED = Upper layer (MTP 3) has bound but not connected

ENABLED = Upper layer (MTP 3) has bound and connected successfully to a peer MTP 2

Low lvl state

See Low-level state values.

Frames out

Number of frames outstanding to layer 1 (transmission not yet complete by layer 1).

Frames dropped

Number of transmitted frames dropped due to level 1 transmit errors.


Low-level state values

Value

Description

UNUSED

Default to unused.

OUT_OF_SERVICE

Link out of service.

INITIAL_ALIGNMENT

Link in initial alignment.

ALIGNED_READY

Link aligned and ready.

ALIGNED_NOT_READY

Link aligning and not ready.

PROC_OUT

Processor outage detected.

IN_SERVICE

Link in service - data state.

IDLE

Link idling - data state.

NOT_ALIGNED

Link not yet aligned.

IS_ALIGNED

Link is aligned.

PROVING

Link is in initial proving phase.

LOCAL_PROC_OUT

Local processor outage - level 3.

REMOTE_PROC_OUT

Remote processor outage - level 3.

BOTH_PROC_OUT

Both processors outage - level 3.

MONITORING

Link monitoring.

CONGESTION

Link congested - level 2.

POWER_OFF

Power off state.


Refer to Mtp2InitLinkCfg for a description of all configuration parameters.