Dialogic DSI SS7MD Network Card User Manual


 
95
Dialogic
®
DSI SS7MD Programmer’s Manual Issue 3
6.6.5 SS7_MSG_TRACE_MASK – Set Trace Mask Request
Synopsis
Message issued to Q.SAAL module to set the mask of which messages should be traced
Message Format
Description
The Q.SAAL module supports comprehensive tracing options on a per-link and per-primitive basis. The
module can be configured to trace any message received or transmitted and a number of management
events. This message is used to selectively enable tracing of events. It can be used at any time during
operation and continues to be effective until the next Trace Mask Set Request is received for the same link.
Traced events are indicated to the management module using the MGT_MSG_TRACE_EV Event Indication.
Parameters
The SS7_MSG_TRACE_MASK message includes the following parameters:
op_evt_mask
The output event trace mask. This is a 16-bit value with bits set to 1 to cause a trace message to be sent
to the management module whenever a message is issued by Q.SAAL. Care should be taken when
tracing messages because the system throughput may be reduced. The fields in the trace mask cause
the events indicated in the table below to be traced..
MESSAGE HEADER
Field Name Meaning
type SS7_MSG_TRACE_MASK (0x5213)
id Link ID
src User Module ID
dst QSL_TASK_ID
rsp_req Used to request a confirmation
hclass 0
status 0
err_info 0
len 6
PARAMETER AREA
Offset Size Name
0 2 op_evt_mask
2 2 ip_evt_mask
4 2 mgmt_evt_mask
Bit 15 Bit 14 Bit 13 Bit 12 Bit 11 Bit 10 Bit 9 Bit 8
RTVL
FAIL
0
LINK
UNCON
G
LINK
CONG
0000
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
RTVL
COMPL
RTVD
MSG
RXD
BSNT
00
OUT
SVC
IN SVC
RXD
MSG
Key:
o RTVL_FAIL - Retrieval not possible
indication
o LINK_UNCONG - Link uncongested
indication
o LINK_CONG - Link congested indication
o RTVL_COMPL - Retrieval Complete
indication
o RTVD_MSG - Retrieved message
indication
o RXD_BSNT - Received BSNT indication
o OUT_SVC - Out of service indication
o IN_SVC - In service indication
o RXD_MSG - Received message
indication