Dialogic DSI SS7MD - Manual (Page 110)

110
6 Message Reference
6.8.2 LIU_MSG_R_STATS – LIU Read Statistics Request
Synopsis
Message used to read back performance statistics associated with a Line Interface Unit (LIU).
Format
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:
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.