Dialogic DSI SS7MD manual 5 SS7MSGTRACEMASK Set Trace Mask Request, Bit

Dialogic® DSI SS7MD Programmer’s Manual Issue 3

6.6.5SS7_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

			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

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..

Bit 15	Bit 14	Bit 13	Bit 12	Bit 11	Bit 10	Bit 9	Bit 8
RTVL		LINK	LINK
	0	UNCON		0	0	0	0
FAIL			CONG
		G
Bit 7	Bit 6	Bit 5	Bit 4	Bit 3	Bit 2	Bit 1	Bit 0
RTVL	RTVD	RXD	0	0	OUT	IN SVC	RXD
COMPL	MSG	BSNT			SVC		MSG
				o RTVL_COMPL - Retrieval Complete
Key:				indication
				o RTVD_MSG - Retrieved message
o RTVL_FAIL - Retrieval not possible
				indication
indication
				o RXD_BSNT - Received BSNT indication
o LINK_UNCONG - Link uncongested
				o OUT_SVC - Out of service indication
indication
				o IN_SVC - In service indication
o LINK_CONG - Link congested indication
				o RXD_MSG - Received message
				indication

95