# 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