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.
