mtp2mgr
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.
mtp2mgr -b board
Requires a single computer with a TX board installed and the following software:
Windows or UNIX
Natural Access
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 |
|
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. |
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.