127
Dialogic
®
DSI SS7MD Programmer’s Manual Issue 3
7.2.1
MONITOR_LINK – Configure Link in Monitoring Mode
Synopsis
The MONITOR_LINK command allows the user to configure a signaling link or ATM link to operate in
monitoring only mode. The command is differentiated based on the data rate parameter. Received signaling
messages are passed directly to a user application without further processing. If an ATM link is specified,
multiple MONITOR_LINK commands may reference the same ATM cell stream provided the cell stream VPI-
VCI combination is unique.
Note:
Often, applications that use MONITOR_LINK also require the line interfaces to operate in high
impedance mode. When using DSI SS7MD Boards, high impedance mode can be selected for a
particular LIU using the <liu_type> parameter in the LIU_CONFIG command.
Note:
The <filter> and <phys_mask> parameters are reserved and should be set to 0.
Syntax
MTP HSL/LSL Links
MONITOR_LINK <link_id> <board_id> <blink> <stream> <timeslot> <user_module> <filter> <flags>
<phys_mask> [<data_rate>]
Example
MONITOR_LINK 0 0 0 0 16 0x0d 0 0x0000 0x00 TDM
ATM Links
MONITOR_LINK <link_id> <board_id> <blink> <atm_stream> <vpi-vci> <user_module> <filter> <flags>
<phys_mask> [<data_rate>]
Example
MONITOR_LINK 0 0 0 0 8-100 0x0d 0 0x0000 0x00 ATM
Common Parameters
The MONITOR_LINK command includes the following parameters:
•
<link_id>
The unique logical identity of the link. It must be in the range 0 to one less than the total number of
signaling links supported.
•
<user_module>
The module ID of the process that will receive the incoming signaling messages, passed as
API_MSG_RX_IND or API_MSG_RX_INDT messages.
•
<filter>
For DSI SS7MD Boards, not applicable. Set to 0.
•
<flags>
A 32-bit value containing additional run-time options. The bit significance is as follows:
— Bit 0 - Set to 1 to enable timestamping of messages monitored by the board for this link. The
monitored messages are received in the API_MSG_RX_INDT message type to accommodate the
timestamp as well as the received message.
— Bit 1 - Enable Fill In Signal Units (FISUs) monitoring.
— Bit 10 - Set to the same value as in the MTP_LINK command.
— Bit 11 - Set to the same value as in the MTP_LINK command.
— Bit 12 - Set to the same value as in the MTP_LINK command.
— All other bits are reserved for future use and should be set to 0.
•
<phys_mask>
For DSI SS7MD Boards, not applicable. Set to 0.
