Page 1 ® Dialogic DSI SS7MD Network Interface Boards Programmer’s Manual www.dialogic.com...
Page 2 It is possible that the use or implementation of any one of the concepts, applications, or ideas described in this document, in marketing collateral produced by or on web pages maintained by Dialogic may infringe one or more patents or other intellectual property rights owned by third parties. Dialogic does not provide any intellectual property licenses with the sale of Dialogic products other than a license to use such product in accordance with intellectual property owned or validly licensed by Dialogic and no such licenses are provided except pursuant to a signed agreement with Dialogic.
Page 3: Table Of Contents
Software Installation for Linux ...19 3.2.1 Installing the Development Package for Linux ...19 3.2.2 Installing the DSI SS7MD Source Device Driver ...20 3.2.3 Support for a Large Number of DSI Messages ...21 3.2.4 Removing the Development Package for Linux ...21 3.2.5...
Page 4 Program Execution...43 Program Execution Overview ...44 Program Execution Under Linux and Solaris ...45 Message Reference ...47 DSI SS7MD Software Module IDs for DSI SS7MD Board ...48 General Configuration Messages ...49 Hardware Control Messages ...58 Signaling Interface Messages ...71 ATM Interface Messages ...78 Q.SAAL Module...89...
Page 5 Protocol Configuration Message Sequence Diagram ... 179 Q.SAAL Configuration Message Sequence Diagram ... 182 Tables SS7 Link Termination or Monitoring Capacity of the Dialogic® DSI SS7MDL4 Network Interface Board ...11 Files Installed on a System Running Linux...19 Files Installed on a System Running Solaris...23 Quick Reference to Commonly Configured Parameters ...26...
Page 6: Revision History
05-2640-003 May 2009 05-2640-002 April 2009 05-2640-001 Note: The current issue of this guide can be found at: http://www.dialogic.com/support/helpweb/signaling Issue Description Description of thermal sensor operation added. Support for introduction of ATM termination mode and timestamping. Supports the first production release.
Page 7: Introduction
The boards provide a hardware platform to enable running Dialogic of Signaling System Number 7 signaling nodes. In addition, the DSI SS7MD Boards can be used to build high performance monitoring applications. The boards can be used under the Linux and Solaris operating systems.
Page 8 1 Introduction...
Page 9: Specification
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Chapter 2: Specification This chapter provides information about: • Product Identifiers • ® Dialogic DSI SS7MDL4 Network Interface Board - Low Profile PCI Express Form Factor • Software Licenses...
Page 10: Product Identifiers
HSL links, up to 128 Q.SAAL links, or 4 ATM cell streams. Note: When used in this document, the generic term “DSI SS7MD” is meant to cover both the ”DSI SS7MDL4” and “DSI SS7MDL440Q” models of the DSI SS7MD Network Interface Boards.
Page 11: Dialogic ® Dsi Ss7Mdl4 Network Interface Board - Low Profile Pci Express Form Factor
— High impedance software selectable • SS7 links Terminate or monitor up to Table 1. SS7 Link Termination or Monitoring Capacity of the Dialogic® DSI SS7MDL4 Network Interface Board Link type Q.703 LSL (64kbit/s) Q.703 LSL (56kbit/s) Q.703 LSL (48kbit/s) Q.703 Annex A HSL Framed...
Page 12: Physical Interfaces
2 Specification which to install the board. Refer to information. 2.2.3 Physical Interfaces The DSI SS7MDL4 board supports the following physical interfaces: • Four T1/E1/J1/J1 digital trunk interfaces. See 2.2.3.1 T1/E1/J1 Digital Trunk Interface Properties The properties of the T1/E1/J1 digital trunk interfaces are described as follows: •...
Page 13: Visual Indicators
The board should be installed in host computers providing an airflow of at least 300 linear feet per minute (LFM), 1.5 m/s. This airflow should be evenly distributed across the board. See guidelines for selecting suitable servers for use with a Dialogic® DSI SS7MDL4 Network Interface 2.2.8...
Page 14: Safety, Emc And Telecommunications Specifications
• International Declaration of Conformity See http://www.dialogic.com/declarations. • Country-Specific Approvals See the Global Product Approvals list at Alternatively, contact your Dialogic technical sales representative for more information. 2.2.10 Reliability Product reliability is described by: • MTBF Predication 797,000 hours Telcordia SR-232, ground benign @ 40°C •...
Page 15: Software Licenses
For details on how to activate the host license please refer to Dialogic® DSI Protocol Stacks - Host Licensing User Guide U32SSS at http://www.dialogic.com/support/helpweb/signaling.
Page 16 2 Specification The following combinations of link types are available to the user: Run Mode Note: When using multiple link types on the same board, the run mode indicates to the board the predominant link type. Note: To change the run mode of a board, the board must be reset. LSL Links HSL Links ATM Links...
Page 17: Installation
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Chapter 3: Installation This chapter contains the following topics: • Software Packages • Software Installation for Linux • Software Installation for Solaris (SPARC)
Page 18: Software Packages
3.1.3 Binary for Dialogic The binary file contains the operating software for DSI SS7MD Boards. The binary file (also known as the codefile) is downloaded to the board at runtime by the driver program. Codefiles for DSI SS7MD Boards have a file suffix .dc6 and should not be confused with codefiles for other products that use different suffixes.
Page 19: Software Installation For Linux
DSI SS7MD Programmer’s Manual Issue 3 Software Installation for Linux The Development Package for Linux is distributed as a download from the Dialogic web site. See “Related Information” on page The distribution is in the form of a single compressed file called dpklnx6.Z.
Page 20: Installing The Dsi Ss7Md Source Device Driver
3.2.2.2 Installing the Driver Binary Install scripts are included in the package to allow the installation of the user-built drivers. The DSI SS7MD installation script is named install_ss7md.sh. The script loads the DSI SS7MD device driver, automatically allocates a major device number and creates the minor device nodes.
Page 21: Support For A Large Number Of Dsi Messages
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 3.2.3 Support for a Large Number of DSI Messages The default Linux configuration may need to be modified to support a large number of DSI messages. 1. Edit the /etc/rc.local (or distribution-specific equivalent) file to add the following line: sysctl -w kernel.msgmnb=<max_queue_bytes>...
Page 22 Where <ARCH> is i386 for 32bit operation and x86_64 for 64 bit operation systems. Note: Device driver binaries, including the one for the DSI SS7MD Board, will be built as rpmbuild is run. Therefore, it is necessary for the machine on which rpmbuild is run to share the same kernel version as the machine on which the RPM packages will be installed.
Page 23: Software Installation For Solaris (Sparc)
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Software Installation for Solaris (SPARC) Installation of the software is described in more detail in the following topics: • Additional Commands • Support for Larger Message Queues • Removing the Development Package for Solaris •...
Page 24: Additional Commands
3 Installation 3.3.1 Additional Commands Customers using Solaris 10 and the DSI SS7MD Boards must perform the following additional commands after installing the package: cd/opt/DKseptel chown root ssdm chmod +s ssdm Note: The commands should be executed by a user with super-user permissions.
Page 25: Dialogic® Dsi Ss7Md Board Configuration And Operation
Dialogic DSI SS7MD Programmer’s Manual Issue 3 Chapter 4: Dialogic® DSI SS7MD Board Configuration and Operation Before attempting software configuration, you should gain an appreciation of the flexibility of the protocol stack, the run-time options that exist and the mechanisms that are used to select specific features. This section gives an overview of these options.
Page 26: Regulatory And Geographic Considerations
T1/E1 Ports Frame format CRC/E-bit operation Clock priorities Links Link termination or monitoring mode DSI SS7MD Boards, although implemented in hardware, have selectable liu_type parameter in liu_type parameter in line_code parameter in frame_format parameter in CRC_mode parameter in flags parameter in...
Page 27: System Structure
This permits the user to evaluate the suitability of a host chassis for deployment. Refer to Purpose binary for use with DSI SS7MD Boards is in fact 'ssdm'. for more information. for more information. for more information.
Page 28: Running Host Binaries With Dialogic ® Dsi Ss7Md Board
4 Dialogic® DSI SS7MD Board Configuration and Operation Running Host Binaries With Dialogic ® The Dialogic DSI MTP2 Layer protocol module runs on the board. The other SS7 protocol modules (MTP3, ISUP, TUP, SCCP, TCAP, MAP, INAP, and IS41) must be run on the host machine.
Page 29: System Configuration
Software Environment Programmer's Manual for more information about this file. An example system.txt configuration file is shown below: ******************************************************************************** * Example System Configuration File (system.txt) for use with * the Linux Development Package for Dialogic(R) SS7 Boards ******************************************************************************** * Essential modules running on host: LOCAL...
Page 30: Generating The System.txt Configuration File
4 Dialogic® DSI SS7MD Board Configuration and Operation NUM_MSGS 1000 * Number of standard size messages * Optional Modules that run on the host: * LOCAL 0x23 * ISUP module * LOCAL 0x4a * TUP module * LOCAL 0x33 * SCCP module...
Page 31 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 It is next necessary to include FORK_PROCESS commands for the modules running on the host computer. All systems require ssdm, tick and tim binaries to be run. • For Linux users, the mandatory FORK_PROCESS commands are: FORK_PROCESS ./ssdm...
Page 32: Protocol Configuration
4 Dialogic® DSI SS7MD Board Configuration and Operation Protocol Configuration The Development Package contains the s7_mgt protocol configuration utility that performs initialization of all the software modules running on the signaling board. It reads the protocol configuration data from a text file, called config.txt, and provides a quick and flexible method of configuring the protocol modules without the...
Page 33 Example configuration of an ATM termination link * Example Protocol Configuration File (config.txt) for use with * Dialogic(R) DSI SS7MD Network Interface Boards. * This file needs to be modified to suit individual circumstances. * Refer to the relevant Programmer's Manuals for further details.
Page 34: Monitoring
(see the table in When used in a passive monitoring mode, the DSI SS7MD Boards treat the signaling timeslot as an HDLC channel so, in addition to SS7, other flag-idle HDLC-based protocols may be monitored, for example LAPB, Q.931 (ISDN PRI) and DPNSS.
Page 35: Atm Monitoring
The system can also be used to monitor AAL5 traffic that is running over ATM links. The following is an example config.txt configuration file to support AAL5 Monitoring: ******************************************************************************** * Example Protocol Configuration File (config.txt) for use with * Dialogic(R) DSI SS7MD Network Interface Boards. ******************************************************************************** * SS7_BOARD <board_id> <board_type> <flags> <code_file> <run_mode>...
Page 36: Switching Timeslots Between Lius
4 Dialogic® DSI SS7MD Board Configuration and Operation Switching Timeslots between LIUs The Dialogic DSI SS7MD Boards support multiple T1/E1/J1 Line Interface Units (LIUs). The onboard signaling processor handles the SS7 signaling timeslots, while the remaining circuits (voice or data bearer circuits) are switched to another onboard LIU for distribution to other boards.
Page 37: Static Initialization
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 4.8.2 Static Initialization Static initialization is handled by the s7_mgt protocol configuration utility. For each T1/E1/J1 Line Interface Unit (LIU), the user should include an LIU_SC_DRIVE command in the config.txt protocol configuration file.
Page 38: Interconnecting Lius Using Stream_Xcon
4 Dialogic® DSI SS7MD Board Configuration and Operation MSG *m; u8 *pptr; * Allocate a message (and fill in type, id, rsp_req & len): if ((m = getm(MVD_MSG_SC_LISTEN, 0, RESPONSE(OUR_MOD_ID), MVDML_SCLIS)) != 0) pptr = get_param(m); memset(pptr, 0, m->len); * Enter the parameters in machine independent format: rpackbytes(pptr, MVDMO_SCLIS_liu_id, (u32)liu_id, MVDMS_SCLIS_liu_id);...
Page 39: Received Message Timestamping
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Received Message Timestamping Timestamping of received messages can be enabled for monitored links. This functionality provides a timestamp of the time a message is received by a board. Individual boards maintain time by synchronising with the host time.
Page 40: High Speed Link Operation
— For E1, timeslot 0 is used for framing and 31 timeslots are available for signaling. The implementation supports the use of both 7-bit and 12-bit sequence numbers as a run-time configuration option. The DSI SS7MD Board will support up to 4 HSL links, dependent upon the licensing.
Page 41: Operation Of The Thermal Sensor
Appendix B, “Thermal guidelines for selecting suitable servers for use with a Dialogic® DSI SS7MDL4 Network Interface Board.” In order to guard against hardware failure due to inadequate cooling from the host chassis, the board is provided with an on-board thermal sensor which, in the event that the board gets too hot, will shutdown the board.
Page 42 4 Dialogic® DSI SS7MD Board Configuration and Operation...
Page 43: Program Execution
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Chapter 5: Program Execution This chapter describes how to start the software and execute programs. It assumes that: • The software has already been installed. Refer to • The system.txt configuration file has been modified correctly. Refer to on page •...
Page 44: Program Execution Overview
5 Program Execution Program Execution Overview There are three main stages to getting a new application up and running, although the precise means of achieving this vary slightly depending upon the operating system: 1. Ensure that the device driver is installed and running. 2.
Page 45: Program Execution Under Linux And Solaris
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Program Execution Under Linux and Solaris Proceed as follows: 1. Ensure the device driver has been installed and the system.txt configuration file has been modified in accordance with system requirements to select the correct protocols etc.
Page 46 5 Program Execution...
Page 47: Message Reference
DSI SS7MD Programmer’s Manual Issue 3 Chapter 6: Message Reference This section describes the individual messages that may be sent to or received from a Dialogic® DSI SS7MD Board. Some messages are sent by the user's application software, while others are sent by utility programs such as the s7_mgt protocol configuration utility.
Page 48: Dsi Ss7Md Software Module Ids For Dsi Ss7Md Board
6 Message Reference DSI SS7MD Software Module IDs for DSI SS7MD Board Table 6 lists the software modules IDs (by mnemonic and value) used on the DSI SS7MD Board. Table 6. DSI SS7MD Board Software Module IDs Mnemonic MGMT_TASK_ID MVD_TASK_ID...
Page 49: General Configuration Messages
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 General Configuration Messages General configuration messages are typically issued by the s7_mgt protocol configuration utility, in which case they need not, and should not, be generated by any user application software. If the user elects not to use the s7_mgt protocol configuration utility, it is necessary for the application to build and send messages that: •...
Page 50 The SSD_MSG_RST_BOARD message includes the following parameters: • board_type The type of board to be reset. This must be set to 16 for DSI SS7MD Boards. • code_file Null terminated string giving the filename of the codefile to be downloaded to the board.
Page 51 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • run_mode The protocols to be run. The following table shows the permitted values and their meaning. Value The following combinations of link types are available to the user. Mode Note: When using multiple link types on the same board, the run mode indicates to the board the predominant link type.
Page 52 Offset Description This message is used when a user application wants to obtain information about a DSI SS7MD Board. This can happen at any time after the board has been reported as being present in the system. Typically, in PCI address mode (see ssd_mode below), this message may be sent by the user application to the ssdm module at system startup to determine the serial numbers of boards present within the system.
Page 53 If the board is not licensed to run the requested software configuration, a status value of 0xfe is returned. Parameters The MGT_MSG_CONFIG0 message includes the following parameters: • config_type Set to 3 when using a DSI SS7MD Board. A separate link layer configuration message should be sent for each link using the MGT_MSG_L1_CONFIG • flags...
Page 54 6 Message Reference — Bit 15 is set to 1 for diagnostics purposes to cause the results of board configuration to be passed to the host. When set, all confirmation messages generated internally on the board during the configuration sequence are sent to the 0xdf module ID on the host. —...
Page 55 Value • link_source Configure the signaling source. Set to 0 for DSI SS7MD Board. • link_stream Signaling stream. This parameter is the physical identity of the T1/E1/J1 line interface containing the signaling link. The value range is 0 to one less than the number of LIUs.
Page 56 6 Message Reference 6.2.6 MGT_MSG_L1_END – Layer 1 Configuration End Synopsis Message sent to a board to remove an existing layer 1 link that was previously configured by sending an MGT_MSG_L1_CONFIG message. Format Field Name type rsp_req hclass status err_info Offset Parameters The MGT_MSG_L1_END message includes the following parameters:...
Page 57 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Parameters The MGT_MSG_NTP_CONFIG message includes the following parameters: • enable Set to 1 to enable timestamping, 0 to disable timestamping. • poll_interval Set to 4. • ntp_management_id Set to 0x20.
Page 58: Hardware Control Messages
6 Message Reference Hardware Control Messages Hardware control messages are used to control various hardware devices on the board, including the T1/E1/ J1 Line Interface Units (LIUs), the digital cross connect switches and the clocking mode for the board. In a static configuration, these hardware blocks can be set up using the s7_mgt protocol configuration utility along with the appropriate commands in the config.txt protocol configuration file.
Page 59 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.3.1 LIU_MSG_CONFIG – LIU Configuration Request Synopsis Message sent by the application to establish the operating mode for a Line Interface Unit (LIU). Note: When using the s7_mgt protocol configuration utility, this message is generated by...
Page 60 6 Message Reference Note: The option chosen by the user must be appropriate to the actual hardware fitted; otherwise an error status is returned. • line_code The line coding technique. The following table shows the permitted values and their meanings. Value •...
Page 61 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • ais_gen The (initial) mode used to generate the Alarm Indication Signal (Blue alarm). The user may subsequently modify the setting of the outgoing signal using the shows the permitted values and their meanings.
Page 62 6 Message Reference 6.3.2 LIU_MSG_CONTROL – LIU Control Request Synopsis Message sent by the application to dynamically control operation for a Line Interface Unit (LIU). Allows setting of outgoing alarms and diagnostic loopbacks. Format Field Name type rsp_req hclass status err_info Offset Description...
Page 63 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • loop_mode The diagnostic loopback mode. The following table shows the permitted values and their meanings. Value • prbs_gen The Pseudo Random Bit Sequence (PRBS) generation mode. The following table shows the permitted values and their meanings.
Page 64 6 Message Reference 6.3.4 LIU_MSG_R_CONTROL – LIU Read Control Request Synopsis Message sent by the application to read back the current Line Interface Unit (LIU) control options from the board. Format Field Name type rsp_req hclass status err_info Offset Description This message is sent to the board to read back the current control parameters selected for a Line Interface Unit (LIU).
Page 65 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 The confirmation message (if requested) indicates success with a status value of 0. On receipt of the confirmation message, the operation to reset the switch is completed. 6.3.6 MVD_MSG_SC_CONNECT – Connect Request Synopsis Message sent to the board to control the switch path.
Page 66 6 Message Reference Parameters The parameters that can be included in the mode. The following table depicts the parameters that are required for each possible mode: Mode local_ stream * indicates that the parameter is required, • local_stream Defines which local stream to use for all the modes of operation.The local_stream parameter specifies either a T1/E1/J1 Line Interface Unit (LIU) or CPU local bus stream.
Page 67 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Value • source_stream The source_stream references the cross connect switch streams that should be used as a source for data. The parameter takes values in the range of 0 to 31. For some modes (for example, 11 and 12), this field is used to specify a local stream instead of a switch stream.
Page 68 6 Message Reference 6.3.7 MVD_MSG_SC_MULTI_CONNECT – Multiple Connect Request Synopsis Message sent to the board to control the switch to connect multiple paths. Format Field Name type rsp_req hclass status err_info Offset Description This message is sent to the board in order to control the configuration of the cross connect switch for more complex configurations.
Page 69 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • source_st, source_ts When mode is set to 11, these parameters give the source_st and source_ts for connection to the specified local timeslots. For other modes the source_st and source_ts specify the cross connect switch stream and timeslot, respectively.
Page 70 6 Message Reference • mode The mode of operation that controls how the switch channels are allocated. Typically, when mode is set to 1, the first timeslot connected to the switch is connected to the timeslot indicated by sc_channel and each subsequent timeslot that is connected will be connected to the next switch channel. This allows maximum utilization of channels on the switch.
Page 71: Signaling Interface Messages
MTP3 module and the user part module (for example, ISUP, TUP or SCCP). In many cases, the user part module is an Dialogic to handle the MTP primitives as they pass directly between MTP3 and the user part module.
Page 72 6 Message Reference 6.4.1 SS7_MSG_CONFIG – MTP2 Link Configuration Request Synopsis Message issued by management to MTP2 to configure an individual signaling link for operation. Format Field Name type rsp_req hclass status err_info Offset Description This message is used to configure the operational parameters for an individual signaling link and to cause the power up action defined in Q.703 to be executed.
Page 73 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 messages may be issued to the MTP2 module to modify timer configuration parameters however; these messages do not affect SS7 operation (that is, the power up sequence is not re-executed, but the parameters are modified).
Page 74 6 Message Reference the loop delay in ms for 56 kbits/s operation. If set to 0, the MTP2 module assumes a value of 12800 for an HSL link, 400 otherwise. • rtv_attempts Reserved. Set to 0. • t1, t2, t3, t4n, t4e, t5, t6, t7 Values for the protocol timers as defined in Q.703.
Page 75 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Parameters The MTP_MSG_RX_IND message includes the following parameter: • Signaling Unit Data The SU data in binary format, excluding the Flags and Checksum. • User to User Information – parameter generated when operating in ATM monitoring mode only.
Page 76 6 Message Reference • seconds_fraction Binary fractions of a second. 6.4.4 API_MSG_TX_REQ – MTP2 Transmission Request Synopsis Message issued to the board by MTP3, containing an SS7 Message Signal Unit (MSU) for transmission on the specified link. Format FIELD NAME type rsp_req hclass...
Page 77 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.4.5 GEN_MSG_MOD_IDENT – Module Identification Request Synopsis Message issued to request software version. Format FIELD NAME type rsp_req hclass status err_info OFFSET Description Message issued to request software version. Parameters The GEN_MSG_MOD_INDENT message includes the following parameters: •...
Page 78: Atm Interface Messages
6 Message Reference ATM Interface Messages ATM Interface Messages allow ATM links to be configured, activated, and deactivated by the user. • ATM_MSG_CONFIG Configure ATM • ATM_MSG_CFG_STREAM • ATM_MSG_END_STREAM • ATM_MSG_R_STREAM_STATS • ATM_MSG_AAL_CFG_MON_LINK • ATM_MSG_AAL_END_LINK • ATM_MSG_R_AAL_LINK_STATS • ATM_MSG_STREAM_STATE • ATM_MSG_LINK_STATE AAL Link Status Indication 6.5.1...
Page 79 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • options Others • num_streams The maximum number of cell streams this module will be asked to simultaneously support. Each cell stream shall be treated independently of the link bandwidth the cell stream consumes.
Page 80 6 Message Reference 6.5.2 ATM_MSG_CFG_STREAM – ATM Cell Stream Configuration Synopsis Message used to configure an ATM cell stream. Format FIELD NAME type rsp_req hclass status err_info OFFSET Description Processed by the module (once a module configuration message has been correctly processed) to configure and activate an ATM cell stream (whether single TDM or IMA bundle).
Page 81 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • options Note: Either Payload Scrambling or ATM Coset mode, or both, must be enabled for correct operation. Configurations which disable both options will be rejected. • ima frame length The length of the IMA frame.
Page 82 6 Message Reference Note: Attempting to activate TDM timeslots that are not present on the underlying TDM (e.g., using a bitmap of 0xfffefffe when the TDM is configured as T1) may NOT result in the rejection of the configuration message. •...
Page 83 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 OFFSET Description Sent by the user to request (and optionally reset) the statistics for the cell stream. The values returned are the totals for the links using this cell stream. The confirmation message (if requested) indicates success with a status value of 0.
Page 84 6 Message Reference 6.5.5 ATM_MSG_AAL_CFG_MON_LINK – Configure AAL Monitor Link Synopsis Message used to configure a monitor link. Format FIELD NAME type rsp_req hclass status err_info OFFSET Description Sent by the user to configure the parameters of a monitored link. At present, the only link type available via this message is an AAL5 link.
Page 85 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • The VPI of the AAL5 stream to be monitored. The VPI must be viable in the mask configured in the ATM_MSG_CONFIG message. • The VCI of the AAL5 stream to be monitored. The VCI value must be viable in the mask specified in the ATM_MSG_CONFIG message.
Page 86 6 Message Reference 6.5.7 ATM_MSG_R_AAL_LINK_STATS – Per Monitored Link Statistics Synopsis Message used to retrieve (and reset) per monitored link statistics. Format FIELD NAME type rsp_req hclass status err_info OFFSET Description Sent by the user to request (and optionally reset) the statistics for the specified AAL link. The confirmation message (if requested) indicates success with a status value of 0.
Page 87 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.5.8 ATM_MSG_STREAM_STATE – ATM Stream Status Indication Synopsis Primitive generated by ATM to advise management of changes to the stream state. Message Format Field Name type rsp_req hclass status err_info Description Sent by the ATM module when a stream becomes active or inactive...
Page 88 6 Message Reference 6.5.9 ATM_MSG_LINK_STATE – AAL Link Status Indication Synopsis Primitive generated by AAL to advise management of changes to the link state. Format Field Name type rsp_req hclass status err_info Description Sent by the ATM module when an AAL link becomes active or inactive. Value MESSAGE HEADER ATM_MSG_LINK_STATE (0x026b)
Page 89: Q.saal Module
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Q.SAAL Module This section describes the formats of all the messages used in the non-primitive interface. The full list of management requests sent to Q.SAAL includes: • SS7_MSG_RESET Q.SAAL Module Reset Request •...
Page 90 6 Message Reference • num_links Maximum number of Q.SAAL signaling links to support on this board. This may range from 0 to one less than the maximum number of links supported depending on how many signaling links the user wishes to use.
Page 91 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 QSAAL_MSG_TIMERS messages may be issued to the Q.SAAL module to modify timer configuration parameters however; these messages do not affect Q.SAAL operation (that is, the power up sequence is not re-executed, but the parameters are modified).
Page 92 6 Message Reference • co1, co2, co3, ca1, ca2, ca3, cd1, cd2, cd3 Congestion onset, abatement and discard thresholds for use when the Multiple Congestion Thresholds mode of operation is selected. The following relationships must be true: ca1 <= co1 <= ca2 <= co2 <= ca3 <= co3 co1 <= cd1 <= co2 <= cd2 <= co3 <= cd3.
Page 93 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Description QSAAL_MSG_CFG_LINK messages may be issued to the Q.SAAL module to modify timer configuration parameters. Otherwise default timer values will be used. Timer ID Timer CC Time_keep_alive Timer_no_resp Timer_poll Timer_idle Timer T1...
Page 94 6 Message Reference 6.6.4 QSL_MSG_END_LINK – Remove Q.SAAL Link Synopsis Remove a Q.SAAL Link - only allowed when the link is in the inactive state. Message Format Field Name type rsp_req hclass status err_info Description Sent by the user to deactivate a link, remove its connection from the underling ATM cell stream and release its resources.
Page 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 Field Name type rsp_req hclass status err_info...
Page 96 6 Message Reference • ip_evt_mask The input 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 received by Q.SAAL. Care should be taken when tracing messages, as system throughput may be reduced.
Page 97 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.6.6 SS7_MSG_R_STATE – Read Link State Request Synopsis Message sent to Q.SAAL to retrieve current per link state in the same format as MTP2 Message Format Field Name type rsp_req hclass status...
Page 98 6 Message Reference 6.6.7 SS7_MSG_R_STATS – Read Link Statistics Request Synopsis Message sent to Q.SAAL module to retrieve per link statistics in same format as MTP2. Message Format Field Name type rsp_req hclass status err_info Offset Description Message used to retrieve Q.SAAL per-link statistics. The statistics are written into the parameter area of the message and the message is returned to the sender.
Page 99 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.6.8 MGT_MSG_QSL_EVENT – Q.SAAL "Q.791 style" Event Indication Synopsis "Q791 style" event indication generated by Q.SAAL module to advise management of protocol events. Message Format Field Name type rsp_req hclass status err_info Description Sent by Q.SAAL module to management when an event occurs.
Page 100: Primitives Issued From Mtp3-B
The LINK STATE is coded as shown in the following table: Value Mnemonic IN_SERVICE OUT_SERVICE INIT_ALIGN 6.6.10 Primitives issued from MTP3-b The following primitives are supported by the Q.SAAL module. For message definitions refer to Dialogic® SS7 Protocols MTP2 Programmer's Manual. MTP2 Primitive API_MSG_TX_REQ SS7_MSG_START SS7_MSG_STOP SS7_MSG_EMGCY SS7_MSG_EMGCY_CLRD...
Page 101: Primitives Issued To Mtp3-B
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.6.11 Primitives issued to MTP3-b The following primitives are supported by the Q.SAAL module. For message definitions refer to Dialogic® SS7 Protocols MTP2 Programmer's Manual. MTP2 Primitive API_MSG_RX_IND SS7_MSG_IN_SVC SS7_MSG_OUT_SVC SS7_MSG_RXD_BSNT API_MSG_RTVD_MSG...
Page 102: Event Indication Messages
6 Message Reference Event Indication Messages Event indication messages are the mechanism by which protocol and software error events are reported to the application. These messages are generated asynchronously by different modules within the stack. The messages in the event indication category include: •...
Page 103 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.7.2 MGT_MSG_TRACE_EV – Trace Event Indication Synopsis Message issued by a module to trace protocol events. Message Format Field Name type rsp_req hclass status err_info Offset Description An individual module may be configured to report to management each primitive issued or received. This is useful for trace and debug purposes.
Page 104 6 Message Reference 6.7.3 SSD_MSG_STATE_IND – Board Status Indication Synopsis Message sent to the application on completion of the reset and download sequence or on detection of a board status event. Note: This message is not required when using the s7_mgt protocol configuration utility. Format Field Name type...
Page 105 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.7.4 API_MSG_CNF_IND – Configuration Completion Status Indication Synopsis Message issued by the s7_mgt protocol configuration utility on completion of initial configuration sequence. Format Field Name type rsp_req hclass status err_info Description This message is issued by the s7_mgt protocol configuration utility on completion of the initial configuration sequence and indicates either success (status=0) or an error condition that occurred during configuration.
Page 106 6 Message Reference 6.7.5 MVD_MSG_LIU_STATUS – LIU Status Indication Synopsis Message issued by the board to provide notification of changes in LIU status. Format Field Name type rsp_req hclass status err_info Description This message is issued by the board for every change of state on the trunk interface. The MVD_MSG_LIU_STATUS message header uses the following parameters: •...
Page 107 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.7.6 MGT_MSG_SS7_EVENT – MTP2 Q.791 Event Indication Synopsis Message issued by the MTP2 module to advise management of protocol events in accordance with Q.791. Format Field Name type rsp_req hclass status err_info...
Page 108 6 Message Reference 6.7.7 MGT_MSG_NTP_SYNC – Timestamping Resynchronization Indication Synopsis Message sent if a significant time difference between the board and the host is detected. This message is generated only if received message timestamping is configured. See Timestamping” on page 39 for more information.
Page 109: Status Request Messages
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Status Request Messages Status request messages can be used to poll the status of modules or systems running on the board. The messages in the status request category include: • LIU_MSG_R_STATE LIU Read State Request •...
Page 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 Field Name type rsp_req hclass status err_info Offset 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.
Page 111 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 — For E1 operating modes, it is the number of errors detected in the frame alignment word. — For T1 interfaces operating in D3/D4 frame format, it is the number of framing bit errors.
Page 112 Parameters The MGT_MSG_R_BRDINFO message includes the following parameters: • board_type The board type. Board type. 16 for DSI SS7MD Board. • board_rev The board revision number. Currently 0. • The board’s production serial number (ASCII characters, null terminated) •...
Page 113 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 6.8.4 DVR_MSG_R_L1_STATS – Link Statistics Request Synopsis Retrieve link statistics. Format Field Name type rsp_req hclass status err_info Offset Description This message provides the user with a number of statistics on a per link basis. If the user sends the message with a non zero status field, the statistics are reset to 0 after being read.
Page 114 6 Message Reference • receiver_busy_cnt The number of times the receiver has entered the busy state as a result of the number of internal buffers falling below a set threshold. • rx_frame_cnt The number of (error-free) frames received on the link, excluding any duplicate frames that are discarded as a result of the internal filtering mechanism.
Page 115: Message Summary Table
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Message Summary Table The following table lists, by message type, all the messages described in this manual. Table 7. Message Summary Message Type 0x0003 0x0008 0x0201 0x0202 0x026a 0x026b 0x026c 0x06a0 0x0e01...
Page 116 6 Message Reference Table 7. Message Summary (Continued) Message Type 0x6214 SS7_MSG_R_STATS 0x6215 SS7_MSG_R_STATE 0x6263 ATM_MSG_R_STREAM_STATS 0x6266 ATM_MSG_R_AAL_LINK_STATS 0x6f0d MGT_MSG_R_BRDINFO 0x7200 SS7_MSG_RESET 0x7203 SS7_MSG_CONFIG 0x7260 ATM_MSG_CONFIG 0x7261 ATM_MSG_CFG_STREAM 0x7262 ATM_MSG_END_STREAM 0x7264 ATM_MSG_AAL_CFG_MON_LINK 0x7265 ATM_MSG_AAL_END_LINK 0x7267 QSL_MSG_CFG_LINK 0x7268 QSL_MSG_CFG_TIMERS 0x7269 QSL_MSG_END_LINK 0x7680 SSD_MSG_RESET 0x7681...
Page 117: Configuration Command Reference
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Chapter 7: Configuration Command Reference This chapter describes the commands and parameters used in the config.txt protocol configuration file. These commands are used by the s7_mgt protocol configuration utility to perform one time configuration of the protocol stack at startup.
Page 118: Physical Interface Configuration Commands
The physical interface configuration commands are: • SS7_BOARD Configure Dialogic • LIU_CONFIG Configure a T1/E1/J1 LIU • LIU_SC_DRIVE Set Up Path Between LIU • SCBUS_LISTEN Connect Switch Timeslot to LIU Timeslot • STREAM_XCON Cross Connect Configuration ® DSI SS7MD Network Interface Board...
Page 119: Ss7_Board - Configure Dialogic ® Dsi Ss7Md Network Interface Board
— All other bits are reserved and should be set to 0. • <code file> The name of the codefile that gets downloaded to the board when it is reset. Codefiles for DSI SS7MD Boards use the suffix .dc6. •...
Page 120 7 Configuration Command Reference • <board_id> The logical identity of the board in the range from 0 to one less than the number of boards supported. • <liu_id> The identifier of the T1/E1/J1 Line Interface Unit (LIU) in the range from 0 to one less than the number of LIUs.
Page 121 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • <build_out> The build out type. The following table shows the permitted values and their meanings. Value Description Setting for E1 devices T1/J1 default (short haul) T1/J1 long haul LBO (-0 dB) T1/J1 long haul LBO (-7.5 dB)
Page 122: Liu_Sc_Drive - Set Up Path Between Liu
MVD_MSG_SC_LISTEN Note: For DSI SS7MD Boards, the <sc_channel> must originate from the same board as identified by the <liu_id> parameter. Syntax LIU_SC_DRIVE <board_id>...
Page 123: Scbus_Listen - Connect Switch Timeslot To Liu Timeslot
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 7.1.4 SCBUS_LISTEN – Connect Switch Timeslot to LIU Timeslot Synopsis This command establishes a connection from the switch to an outgoing timeslot on the Line Interface Unit (LIU). Note: Dynamic modification of voice paths can only be performed by issuing messages directly to the board.
Page 124: Stream_Xcon - Cross Connect Configuration
Line Interface Unit (LIU) on each signaling board. The LIUs on a board are referenced by a fixed logical stream number. Note: The <mode> option 1 and <pattern> parameter is not supported on DSI SS7MD Boards. Syntax STREAM_XCON <bpos>...
Page 125 PCM ports on a signaling board, the <ts_mask> value 0x1fffffe should be used. In duplex mode both PCM ports should have been previously configured under the same type of PCM connector T1, E1 or J1. • <pattern> For DSI SS7MD Boards, not applicable. Set to 0.
Page 126: Monitor Configuration Commands
7 Configuration Command Reference Monitor Configuration Commands The monitor configuration command is: • MONITOR_LINK Configure Link in Monitoring Mode...
Page 127 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.
Page 128 7 Configuration Command Reference • <data_rate> An optional parameter to specify link parameters, required for HSL or ATM operation. The valid values are: Value E1_FRAMED T1_FRAMED E1_PCM MTP HSL/LSL Link Parameters • <board_id> The logical identity of the board in the range from 0 to one less than the number of boards supported. •...
Page 129: Mtp Configuration Commands
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 MTP Configuration Commands The Message Transfer Part (MTP) configuration commands are: • MTP_CONFIG Configure MTP • MTP_LINKSET Configure a Linkset • MTP_LINK Configure a Link • MTP_ROUTE Configure a Route • MTP_USER_PART Configure a Local User Part 7.3.1...
Page 130 7 Configuration Command Reference set to 0, on detection of RPO, the signaling link is taken out of service and restoration commences. This bit should normally be set to 1. — Bit 20 used in conjunction with bit 9 to select point codes (see table above). —...
Page 131 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 7.3.2 MTP_LINKSET – Configure a Linkset Synopsis Configuration of a linkset to an adjacent signaling point. Syntax MTP_LINKSET <linkset_id> <adjacent_spc> <num_links> <flags> <local_spc> <ssf> Example MTP_LINKSET 0x0000 Parameters The MTP_LINKSET command includes the following parameters: •...
Page 132 7 Configuration Command Reference Syntax MTP HSL/LSL Links MTP_LINK <link_id> <linkset_id> <link_ref> <slc> <board_id> <blink> <stream> <timeslot> <flags> [<data_rate>] Example MTP_LINK 0 0 0 0 0 0 0 16 0x0006 TDM ATM Links MTP_LINK <link_id> <linkset_id> <link_ref> <slc> <board_id> <blink> <atm_stream> <vpi-vci> <flags> ATM Example MTP_LINK Common Parameters...
Page 133 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 — Bit 12 is used to select 12- or 7-bit sequence numbers for HSL only. This bit should be set for 12-bit sequence numbers, clear otherwise. — Bits 13 and 14 reserved. Set to 0.
Page 134 7 Configuration Command Reference — vpi is the Virtual Path Indicator of the signaling link within the ATM cell stream. — vci is the Virtual Channel Indicator of the signaling link within the ATM cell stream. For restrictions on the choice of VPI-VCI combinations refer to page 7.3.4 MTP_ROUTE –...
Page 135 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 — All other bits are reserved for future use and must be set to 0. 7.3.5 MTP_USER_PART – Configure a Local User Part Synopsis Configuration of a local user part module, other than a user part which has its own configuration command in the config.txt protocol configuration file.
Page 136: Atm Configuration Commands
7 Configuration Command Reference ATM Configuration Commands The ATM configuration commands are: • ATM_CONFIG Configure the ATM Module • ATM_STREAM Configure ATM Cell Stream • ATM_TIMER Configure Timers for Q.SAAL Links...
Page 137 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 7.4.1 ATM_CONFIG – Configure the ATM Module Synopsis Global configuration of the ATM Module. Syntax ATM_CONFIG <options> <num_streams> Example ATM_CONFIG 0x0000 Parameters The ATM_CONFIG command includes the following parameters: • <options> A 16-bit value containing additional run-time options. The bit significance is as follows: —...
Page 138 7 Configuration Command Reference 7.4.2 ATM_STREAM – Configure ATM Cell Stream Synopsis Configures an ATM Cell Stream. Syntax ATM_STREAM <id> <board_id> <cellstream_id> <liu_id> <options> <ima_frame_len> <max_frame_len> <def_vpi> <def_vci> <timeslot> Example ATM_STREAM 0x00 Parameters The ATM_STREAM command includes the following parameters: •...
Page 139 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • <def_vci> A default AAL5 link will be configured for the cell stream to signal incoming active connections. This is the VCI that will be used for this connection. Values 0, 3, and 4 are reserved and should not be used.
Page 140 7 Configuration Command Reference 7.4.3 ATM_TIMER – Configure Timers for Q.SAAL Links Synopsis Override the default timer values for ATM Links. Syntax ATM_TIMER <reserved> <timer_id> <value> Example ATM_TIMER 0 T1 10 Parameters The ATM_TIMER command includes the following parameters: • <reserved>...
Page 141: Isup Configuration Commands
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 ISUP Configuration Commands The ISUP configuration commands are: • ISUP_CONFIG Configure ISUP • ISUP_CFG_CCTGRP Configure an ISUP Circuit Group • ISUP_TIMER Configure ISUP Timers 7.5.1 ISUP_CONFIG – Configure ISUP Synopsis The global configuration parameters for the ISUP module.
Page 142 7 Configuration Command Reference 7.5.2 ISUP_CFG_CCTGRP – Configure an ISUP Circuit Group Synopsis The configuration parameters for a group of ISUP circuits. Typically, a group is all the circuits in a single E1, T1, or J1 interface. Syntax ISUP_CFG_CCTGRP <gid> <dpc> <base_cic> <base_cid> <cic_mask> <options> <user_inst> <user_id> <opc> <ssf>...
Page 143 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 7.5.3 ISUP_TIMER – Configure ISUP Timers Synopsis The ISUP_TIMER command provides the ability to configure the ISUP protocol timers from the config.txt file. Syntax ISUP_TIMER <reserved> <timer_id> <value> Example ISUP_TIMER 0 t4 550...
Page 144: Tup Configuration Commands
7 Configuration Command Reference TUP Configuration Commands The TUP configuration commands are: • TUP_CONFIG Configure TUP • TUP_CFG_CCTGRP Configure a TUP Circuit Group 7.6.1 TUP_CONFIG – Configure TUP Synopsis The global configuration parameters for the TUP module. Syntax TUP_CONFIG <res1> <res2> <user_id> <options> <num_grps> <num_ccts> <partner_id> Example TUP_CONFIG 0x2d...
Page 145 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 7.6.2 TUP_CFG_CCTGRP – Configure a TUP Circuit Group Synopsis The configuration parameters for a group of TUP circuits. Syntax TUP_CFG_CCTGRP <gid> <dpc> <base_cic> <base_cid> <cic_mask> <options> <user_inst> <user_id> <opc> <ssf> <variant> <options2>...
Page 146: Sccp Configuration Commands
7 Configuration Command Reference SCCP Configuration Commands The SCCP configuration commands are: • SCCP_CONFIG Configure SCCP • SCCP_SSR SCCP Sub-System Resource • SCCP_CONC_SSR SCCP Concerned Sub-System Resource • SCCP_TRACE SCCP Trace • SCCP_GTT_PATTERN Define Global Title Pattern • SCCP_GTT_ADDRESS Define Global Title Address •...
Page 147 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 7.7.2 SCCP_SSR – SCCP Sub-System Resource Synopsis The SCCP_SSR command supplies the global configuration parameters for the SCCP. Syntax SCCP_SSR <ssr_id> RSP <remote_spc> <flags> <pc_mask> SCCP_SSR <ssr_id> LSS <local_ssn> <module_id> <flags> <protocol>...
Page 148 7 Configuration Command Reference 7.7.3 SCCP_CONC_SSR – SCCP Concerned Sub-System Resource Synopsis The SCCP_CONC_SSR command marks the specified sub-system (which was declared by SCCP_SSR) as requiring notification of changes in the accessibility of another sub-system. Notification is given in the form of an SCCP management indication.
Page 149 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 7.7.5 SCCP_GTT_PATTERN – Define Global Title Pattern Synopsis The SCCP_GTT_PATTERN command defines a global title pattern to be matched for a global title translation. Syntax SCCP_GTT_PATTERN <pattern_id> <addr_indicator> <pc> <ssn> <global_title> [<gtai_pattern>]...
Page 150 7 Configuration Command Reference • <address_id> A unique ID identifying the address. • <addr_indicator> The address indicator octets. • <pc> The point code. This is ignored if bit 0 of <addr_indicator> is not set. • <ssn> The subsystem number. This is ignored if bit 1 of <addr_indicator> is not set. •...
Page 151 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 <gtai_replacement> parameter of the associated contain the following: Mnemonic K or KEEP R or REPLACE • <primary_address_id> Identifies the SCCP_GTT_ADDRESS • <backup_address_id> Identifies the SCCP_GTT_ADDRESS SCCP_GTT_ADDRESS Function Padding (ignored). Separator used to split the mask into sections.
Page 152: Dtc Configuration Commands
7 Configuration Command Reference DTC Configuration Commands The DTC configuration commands are: • DTC_CONFIG Configure DTC • DTC_SSR DTC Sub System Resource 7.8.1 DTC_CONFIG – Configure DTC Synopsis The DTC_CONFIG command supplies the global configuration parameters for the DTC protocol, activating DTC and higher protocols.
Page 153 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • <protocol> Should be set to TCAP, MAP, INAP or IS41 according to the layer of the protocol stack to which the user application interfaces. Note: There can be at most one LSS for each of MAP, INAP and IS41.
Page 154: Tcap Configuration Commands
7 Configuration Command Reference TCAP Configuration Commands The TCAP configuration commands are: • TCAP_CONFIG Configure TCAP • TCAP_CFG_DGRP TCAP Dialog Group Configure • TCAP_TRACE TCAP Trace 7.9.1 TCAP_CONFIG – Configure TCAP Synopsis The TCAP_CONFIG command provides the TCAP operating parameters and, when used, must appear after SCCP_SSR DTC_SSR commands.
Page 155 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • <addr_format> Defines how TCAP should interpret address information from messages received from SCCP in order to direct received TCAP primitives to unique SCCP sub-systems (TCAP user applications). It should be set to...
Page 156 7 Configuration Command Reference 7.9.3 TCAP_TRACE – TCAP Trace Synopsis The TCAP_TRACE command is used to configure TCAP to send trace messages to the trace module whenever a specific message type is sent or received. See the TCAP Programmer’s Manual for details. Syntax TCAP_TRACE <op_evt_mask>...
Page 157: Map Configuration Commands
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 7.10 MAP Configuration Commands The MAP configuration commands are: • MAP_CONFIG Configure MAP • MAP_TRACE MAP Trace 7.10.1 MAP_CONFIG – Configure MAP Synopsis The MAP_CONFIG command provides the MAP operating parameters and, if used, must appear after the SCCP_SSR commands in the config.txt file.
Page 158: Inap Configuration Commands
7 Configuration Command Reference 7.11 INAP Configuration Commands The INAP configuration commands are: • INAP_CONFIG Configure INAP • INAP_FE INAP Functional Entities • INAP_AC INAP Application Context • INAP_TRACE INAP Trace 7.11.1 INAP_CONFIG – Configure INAP Synopsis The INAP_CONFIG command provides the INAP operating parameters and, if used, must appear after the SCCP_SSR commands in the config.txt file.
Page 159 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 7.11.3 INAP_AC – INAP Application Context Synopsis This command is used to configure the INAP Application Context (AC) records for use. These control the application context negotiation that the module conducts during dialog establishment. The supported application contexts must be individually configured using this message.
Page 160: Is41 Configuration Commands
7 Configuration Command Reference 7.12 IS41 Configuration Commands The IS41 configuration commands are: • IS41_TRACE IS41 Trace 7.12.1 IS41_TRACE – IS41 Trace Synopsis The IS41_TRACE command is used to configure IS41 to send trace messages to the trace module whenever a specific message type is sent or received.
Page 161: Host Utilities
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Chapter 8: Host Utilities This chapter describes the following host utilities that can be used with Dialogic • s7_log • s7_play • gctload • • tick • s7_mgt • ssdm • tempmon ®...
Page 162: S7_Log
The s7_log utility can optionally print the date and time of when a message is received by the utility. In addition, when used with DSI SS7MD Boards, the utility can decode the timestamps of messages on links monitored by boards. These timestamps identify the time that a message reached the board and may be different from the time the message was received by the s7_log utility.
Page 163 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 • -f<filename> Optionally specifies a file to which all screen output is written. If the specified file does not exist, it is created. If the specified file already exists, it is overwritten. The data is stored in the file in ASCII format.
Page 164 8 Host Utilities Messages that are not interpreted as text are displayed in hexadecimal format as follows: M t<type> i<id> f<src> d<dst> s<status> e<err_info> p<param> Each field contains the value of the corresponding message field in hexadecimal format.
Page 165: S7_Play
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 s7_play Description The s7_play utility is a console application that reads commands from as ASCII text file then executes the commands. Each command can specify either: • a message to be sent to a destination process •...
Page 166 8 Host Utilities Field Identifier Each field identifier is optional and causes the corresponding message field to be set to zero if not present. All values are entered in hexadecimal format. For example: M-tc701-i0000-f1d-d23-s00-p0000ffffffff The following command file sends a reset circuit group message to the first ISUP group, waits for 5 seconds, then sends a reset group message for group 1.
Page 167: Gctload
Specifies the message pool size, that is the number of messages available on the host. If this option is not defined, the default message pool size is 200. Note: For systems using DSI SS7MD Boards, a higher system throughput is expected; therefore the size of the pool should be increased to at least 2000.
Page 168: System Status (Gctload -T1)
8 Host Utilities • Terminate a running system. An active instance of the gctload module, together with any forked binaries, is terminated if a subsequent call of gctload binary is made with the -x parameter. Example To run gctload with the system.txt file as the configuration file, a congestion onset value of 70, a congestion abatement value of 30, and a message pool size of 2000, the command is: gctload -csystem.txt -Co70 -Ca30 -m2000 8.3.1...
Page 169 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 The output above indicates that there are messages sent to a destination module ID 0xef in the IPC system. Under normal operation, the message queues for destination tasks should either be empty or contain a small number of messages.
Page 170: Tim
8 Host Utilities Description The tim utility starts the tim process that receives periodic tick notification from tick processes and handles protocol timers for all other processes. Syntax tim_xxx [-v] where xxx is operating system specific, lnx for Linux and sol for Solaris versions. Command Line Options The tim utility supports the following command line options: •...
Page 171: Tick
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 tick Description The tick utility starts the tick process that sends periodic tick notification to the tim process, which in turn handles protocol timers. Syntax tick_xxx [-v] where xxx is operating system specific, lnx for Linux and sol for Solaris versions.
Page 172: S7_Mgt
8 Host Utilities s7_mgt Description The s7_mgt utility performs one-time protocol configuration for all protocol modules, deriving the configuration parameters from a text file (config.txt by default). This process is optional. As an alternative, the user may elect to perform protocol configuration by sending messages directly to the other modules in the system.
Page 173: Ssdm
Note: This process is often referred to in a generic manner as ssd although the name of the binary for use with DSI SS7MD Boards is in fact ssdm. Syntax ssdm [-v -o<addressing mode> -a<address> -d -s1 -s2]...
Page 174 8 Host Utilities -aPX00020,PX00015,PX00015,PX01000 Up to a maximum of 4 addresses can be specified in this list. In the example above, board_id = 0 would be the board with serial number PX00020 irrespective of where in the chassis this board was located. Notes: It is not necessary for all boards listed in this option to physically exist in a system.
Page 175: Tempmon
GCT environment and periodically reads back the temperature, as recorded by the on-board temperature sensor, of all DSI SS7MD Boards present in the system and logs these together with the date, time and board serial numbers. This permits the user to evaluate the suitability of a host chassis for deployment.
Page 176 8 Host Utilities Example tempmon -ftemplog.txt -t5 Sample Output tempmon: Temperature monitor (C) 2009 Dialogic Corporation ========================================================== 2009-06-02 10:36:00, PX800007, PX800046, PX800057, PX800023 2009-06-02 10:36:00, 2009-06-02 10:36:05, 2009-06-02 10:36:10, 2009-06-02 10:36:15, 2009-06-02 10:36:20, 2009-06-02 10:36:25, 2009-06-02 10:36:30, 2009-06-02 10:36:35,...
Page 177 3. Build and send a Board Configuration Request (MGMT_TASK_ID) to configure the basic board parameters. When using Dialogic the value of the config_type parameter in the version of the message, the automatic configuration of MTP parameters is not supported. Wait for the confirmation message and check the status.
Page 178 Appendix A Protocol Configuration Using Discrete Messages 9. Build and send an MTP3 Signaling Link Configuration Request (MTP_MSG_CNF_LINK) to set up configuration parameters for the individual link. See the MTP3 Programmer’s Manual for the message definition. Wait for the confirmation message and check the status. For each link set in the system perform the following: 10.
Page 179: Protocol Configuration Message Sequence Diagram
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Figure 3. Protocol Configuration Message Sequence Diagram USER_MGT SSD_MSG_RESET (0x7680) (0x3680) SSD_MSG_STATE_IND (0x06a0) Geographic addressing SSD_MSG_BOARD_INFO (0x7689) only (0x3689) SSD_MSG_RST_BOARD (0x7681) (0x3681) Board Status Indication (0x06a0) MGT_MSG_CONFIG0 (0x7f10) (0x3f10) LIU_CONFIG0 (0x7e34) (0x3e34)
Page 180 3. Build and send a Board Configuration Request (MGMT_TASK_ID) to configure the basic board parameters. When using DSI SS7MD Boards, the value of the config_type parameter in the message, the automatic configuration of MTP parameters is not supported. Wait for the confirmation message and check the status.
Page 181 3. Build and send a Board Configuration Request (MGMT_TASK_ID) to configure the basic board parameters. When using Dialogic the value of the config_type parameter in the version of the message, the automatic configuration of MTP parameters is not supported. Wait for the confirmation message and check the status.
Page 182 Appendix A Protocol Configuration Using Discrete Messages route. See the MTP3 Programmer's Manual for the message definition. Wait for the confirmation message and check the status. Proceed now with the User Part configuration procedure. Once this is complete, issue an MTP Link Activation Request (MTP_MSG_ACT_SL) for each link in the system as required to bring the link into service.
Page 183 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Appendix B: Thermal guidelines for selecting suitable servers for use with a Dialogic® DSI SS7MDL4 Network Interface Board ® The Dialogic DSI SS7MDL4 Network Interface Board is a high performance SS7 board capable of delivering over 30,000 MTP2 packets per second.
Page 184 Appendix B Thermal guidelines for selecting suitable servers for use with a Dialogic® DSI SS7MDL4 Network In- terface Board...
Page 185: Glossary
® Dialogic DSI SS7MD Programmer’s Manual Issue 3 Glossary AAL5 ATM Adaptive Layer part 5 Alarm Indication Signal (Blue alarm). Asynchronous Transfer Mode config.txt A text file used for protocol configuration. An example program that demonstrates how a user application can interface with telephony user parts, such as ISUP and TUP.
Page 186 SS7 Protocol Stack A set of software modules that implement the various layers of the SS7 protocol stack. SS7MD An identifier for the family of Dialogic® Multi Dimension Network Interface Boards. SS7MDDVR Device driver for Dialogic® Multi Dimension Network Interface Boards.
Page 187: Index
Linux 45 ATM monitoring 35 ATM_CONFIG 137 ATM_STREAM 138, 140 binary file ss7.dc6 18 binary files for DSI SS7MD Boards 18 board identifiers DSI SS7MD Network Interface Boards, DSI SS7ML4 boards, DSI SS7MDL44OQ boards 10 board serial number 173...
Page 188 Linux 19 software on RPM 21 software on Solaris 23 installing driver binary 20 installing DSI SS7MD source device driver 20 interconnect LIUs using STREAM_XCON 38 interface properties 12 interfaces DSI SS7MDL4 boards 12 IS41 configuration commands...
Page 189 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 LIU_MSG_R_CONFIG message 63 LIU_MSG_R_CONTROL message 64 LIU_MSG_R_STATE message 109 LIU_MSG_R_STATS message 110 LIU_SC_DRIVE 122 LIUs switching timeslots 36 log utility 162 logging s7_log 27 MAP configuration commands MAP_CONFIG 157 MAP_TRACE 157 MAP_CONFIG configuration command 157...
Page 190 Index DSI SS7MDL4 boards 14 relm( ) function usage 177 removing Development Package Linux 21 route configuration command 134 creation instructions 21 installation 21 packages 22 using management tools 22 running programs under Linux 45 runtime operations 34 s7_log utility 162 s7_mgt protocol configuration utility 32 s7_mgt utility 172 s7_play utility 165...
Page 191 ® Dialogic DSI SS7MD Programmer’s Manual Issue 3 tick 171 tim 170 verifying device driver loading 20 visual indicators DSI SS7MDL4 boards 13 warranty information link to 14...

Dialogic DSI SS7MD Programmer's Manual

Quick Links

Related Manuals for Dialogic DSI SS7MD

Summary of Contents for Dialogic DSI SS7MD

Table of Contents