6 Message Reference

6.8.2LIU_MSG_R_STATS – LIU Read Statistics Request

Synopsis

Message used to read back performance statistics associated with a Line Interface Unit (LIU).

Format

 

 

 

MESSAGE HEADER

 

 

 

 

 

Field Name

Meaning

 

 

 

 

type

 

 

LIU_MSG_R_STATS (0x5e36)

 

 

 

 

id

 

 

liu_id (in the range 0 to one less than the number of LIUs)

 

 

 

 

src

 

 

Sending module ID

 

 

 

 

dst

 

 

MVD_module_ID

 

 

 

 

rsp_req

 

 

Used to request a confirmation.

 

 

 

 

hclass

 

 

0

 

 

 

 

status

 

 

0 to read statistics

 

 

1 to read statistics and reset counters

 

 

 

 

 

 

 

err_info

 

 

0

 

 

 

 

len

 

 

42

 

 

 

 

 

 

 

PARAMETER AREA

 

 

 

 

Offset

 

Size

Name

 

 

 

 

0

 

2

version

 

 

 

 

2

 

2

Reserved. Must be set to 0.

 

 

 

 

4

 

4

duration

 

 

 

 

8

 

4

bit_errors

 

 

 

 

12

 

4

code_violations

 

 

 

 

16

 

4

frame_slips

 

 

 

 

20

 

4

oos_transitions

 

 

 

 

24

 

4

errored_seconds

 

 

 

 

28

 

4

severely_errored_seconds

 

 

 

 

32

 

2

prbs_status

 

 

 

 

34

 

4

Reserved. Must be set to 0.

 

 

 

 

38

 

4

Reserved. Must be set to 0.

 

 

 

 

Description

This message is used to collect performance statistics for a given Line Interface Unit (LIU). A module requesting LIU statistic information is required to complete the version parameter of the message, request a response, and set all additional parameter values to zero.

The confirmation message shall feature a non-zero status in the event of an error. In the event of successful retrieval of information, the message parameter field shall contain LIU information as specified in the message format. The statistics can either be read and left unchanged, or read and reset in a single operation depending on the setting of the status field in the request message.

Typically, a managing application would be set up to periodically (for example, hourly or daily) read and reset the statistics and store the resulting information so that it can be accessed later for generation of performance reports for the line interface.

Parameters

The LIU_MSG_R_STATE message includes the following parameters:

version

Version of the parameter area.

duration

The duration (in seconds) since the statistics were last reset.

bit_errors

A count of the actual number of bit errors detected by the framer device for the LIU. The precise meaning of this parameter varies depending on the operating mode of the framer:

110

Page 110
Image 110
Dialogic DSI SS7MD manual Duration