Digital trunk status: trunkmon

Name

trunkmon

Purpose

Displays the status of digital trunks.

Usage

trunkmon [ options ]

where options are:

Option

Description

-b board

Specifies the board to monitor. Default = 0.

-s

Enables beep when trunk alarm state changes. Default = no beep.

-?

Displays the trunkmon Help screen and terminates.

-l mode

Sets the framer loopback mode. Available mode entries include:

0 = No loopback - normal mode

1 = Line loopback

2 = Backplane loopback

The loopback option works only on CG boards and AG 4040 boards.

-t trunknumb

Specifies the trunk number. The trunk number is a zero-based index associated with the board by NMS OAM. If no trunk number is specified, trunkmon defaults to trunk 0.

-@ host

Displays the status of trunks on resource host host. If unspecified, it is assumed that the trunks are on the host on which trunkmon was initialized.

-q

For diagnostic purposes only. Queries framer loopback mode and displays the output in oammon.


Description

trunkmon displays the status of all trunks connected to the specified board. trunkmon continuously monitors the status of the trunks and updates the display if the data changes. If the -s option is specified, trunkmon beeps when an alarm transition occurs.

Framer loopback diagnostic options

Use the -l and -t loopback options for diagnostic purposes on CG and AG boards with DS1 interfaces. The loopback options verify whether the board's DS1 configuration matches the configuration of its incoming lines.

Caution:

trunkmon loopback options are intended for diagnostic purposes only. AG and CG boards cannot process data appropriately when either loopback mode is in use. In addition, the NMS compliance certificates obtained for the CG or AG board do not apply when loopback is in use.


Use the -l option to configure loopback in one of the following modes:

Loopback mode

Description

Line

Data from the board's external DS1 interfaces is looped back to the external DS1 through the framer chip's line interface unit (LIU).

Backplane

Data from the board's PCM highway is looped back to the board's PCM highway through the framer chip's PCM input.


Note: On AG boards, set the agtrace trace mask to 0x1000 before implementing loopback.

For example, if you run trunkmon with the following arguments:

trunkmon -l1 -t0

the first trunk is set up in line loopback mode. trunkmon displays the following output:

Set loopback mode 1 on trunk 0

You can use the -q option to query the current loopback mode and view the loopback output with oammon. For example, if you run trunkmon with the following arguments:

trunkmon -q -t1

oammon specifies the second trunk's loopback mode in the following way:

Get loopback mode 2 from trunk 1

Procedure

To run trunkmon for board number 0, enter:

trunkmon

trunkmon's output differs depending upon whether the digital trunks are ISDN primary rate (PRI) or basic rate (BRI). For boards with PRI trunks, the output resembles the following:

 Digital Trunk Monitor      NMS Communications        Ver 1.2  Jun 21 2001
 (Press F3 or ESC to exit, ALT-F1 to reset)
 BOARD # 0
 -------------------------------------------------------------------------
 Monitor start time:
                       Tue Jun 26 11:59:21 2001
          Alarms   Remote    Errored  Failed     Code      Slips    Frame
                   alarms      sec      sec   violations             sync
 -------------------------------------------------------------------------
 
 Trunk 0    RED     NONE         15       15        0         1    NoSgnl
 Trunk 1    NONE    YELLOW       15       15        2         0        OK
 Trunk 2    NONE    NONE          1        0        0         0        OK
 Trunk 3    NONE    NONE          1        0        0         0        OK

The following table explains the trunkmon output for PRI trunks:

trunkmon display (PRI trunks)

Description

Alarm

T1 trunks:

  • RED = Red alarm or loss of frame

  • BLUE = Blue alarm or AIS alarm

  • NONE = No alarm

 

E1 trunks:

  • AIS = All ones alarm

  • NO_FRM = Loss of frame

  • 16 AIS = All ones in timeslot 16

  • NONE = No alarm

Remote Alarm

T1 trunks:

  • YELLOW = Remote loss of frame

  • NONE = No alarm

 

E1 trunks:

  • FAULT = Remote loss of frame

  • NO_SMF = Remote loss of signaling multiframe

  • NONE = No alarm

Errored seconds

One second intervals containing one or more errors

Failed seconds

T1 trunks: Number of one-second intervals that are preceded by 10 consecutive failed seconds

E1 trunks: Number of one-second intervals in which loss of signal occurs, out-of-frame occurs, or excessive bit error rate is detected

Code violations

Line code violations

Slips

Slips accumulator

Frame sync

OK = Proper frame synchronization to the trunk

NoSgnl = Loss of signal

No Frm  = Loss of frame

No MF = Loss of signaling multiframe

NoCRCF = No CRC frame synchronization

?????? = Unknown framing error


For boards with BRI trunks, trunkmon's output resembles the following:

   Digital Trunk Monitor     NMS Communications       Ver 1.2  Jun 21 2001
                            (Press F3 or ESC to exit, ALT-F1 to reset)
    BOARD # 0
   -----------------------------------------------------------------------
    Monitor start time:
                           Mon Jul 23 09:10:04 2001
              State    Type   Slips   Errors  Receives   Transmits  B1  B2

    ----------------------------------------------------------------------

    Trunk 0    G3        NT     0        0       12         12      1   0 
    Trunk 1    NONE      ??     0        0        0          0      0   0 
    Trunk 2    F7        TE     0        0       12         11      1   0 
    Trunk 3    NONE      ??     0        0        0          0      0   0 

 

The following table explains the trunkmon output for BRI trunks:

trunkmon display (BRI trunks)

Description

State

Activation/deactivation layer 1 state machine (ITU-T I430):

F1-F8 = TE trunks

G1-G4 = NT trunks

NONE = All others

Type

Indicates how stack on trunk was initialized:

NT = Stack initialized as NT

TE = Stack initialized as TE

?? = Stack not initialized on this trunk

Slips

Slips accumulator

Errors

Errors accumulator

Receives

Indicates bytes received

Transmits

Indicates bytes transmitted

B1

Shows if there is communication currently on the B1 channel

B2

Shows if there is communication currently on the B2 channel