Dialogic DSI SS7MD manual

www.dialogic.com Dialogic ® DSI SS7MD Network Interface Boards Programmer’s Manual[...]

2 Copyright© 2009 Dialogic Corporation. All Rights R eserved. Y ou may not re produce this document in whole or in part without permission in writing from D ialogic Corporation at the address prov ided below. All contents of this document are furnishe d for informational use only and are subjec t to change without notice and do not represent a com[...]

Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 3 Contents 1 Introduction ............................................................................................................. 7 1.1 Related Information ............................................................................................ 7 2 Specification ........................[...]

4 Contents 4.8.3 Dynamic Operation ................................................................................. 37 4.8.4 Example Code for Building and Send ing MVD_MSG_SC_LISTEN Message ........ 37 4.8.5 Interconnecting LIUs using STREAM_XCON ................................................ 38 4.9 Receiv ed Message Timestamping ...............[...]

Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 5 Figures 1 Switch Connections................................................................................................... 36 2 Drop and Insert........................................................................................................ 38 3 Protocol Configuration Message Sequen[...]

6 Contents Revision History Note: The current issue of this guide can be found at: http://www .dialogic.com/support/helpweb/signaling Date Part Number Issue Description July 2009 05-2640-003 3 Description of thermal sensor operation added. May 2009 05-2640-002 2 Support for introduction of A TM termination mode and timestamping. April 2009 05-2640-[...]

7 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 1: Introduction Dialogic ® DSI SS7MD Network Interface Boards are specialized T1/E1/J1 S S7 signaling boards suitable for use in PCI Express form factor systems. The boards use the common Dialogic ® DSI software API to the application that enables applic ations to be easily ported. Th[...]

8 1 Introduction[...]

9 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 F orm F actor • Software Licenses[...]

10 2 Specification 2.1 Product Identifiers The Dialogic ® DSI SS7MD Network Interface Board prod uct family includes the PCI Express form factor described in the following subsections. 2.1.1 Dialogic ® DSI SS7MDL4 Network Interface Board - Low Profile PCI Express Form Factor Product DSI SS7MDL4 PCI Express form factor pr oduct line includes the f[...]

11 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 2.2 Dialogic ® DSI SS7MDL4 Network Interface Board - Low Profile PCI Express Form Factor The DSI SS7MDL4 board is a x1 lane electrical, x4 lane ph ysical, low profile PCI Express form factor , which can be installed in x4, x8, or x16 lane slots. The board is supplied with two End Br ackets su[...]

12 2 Specification which to install the board. Refer to Section 2.2.7, “ Airflow Requirements” on page 13 for more information. 2.2.3 Physical Interfaces The DSI SS7MDL4 board supports the following physical interfaces: • Four T1/E1/J1/J1 digital trunk interfaces. See Section 2.2.3.1 below for more detail. 2.2.3.1 T1/E1/J1 Digital Tr unk Inte[...]

13 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 2.2.5 Visual Indicators The DSI SS7MDL4 board includes the following visual indicators: • T1/E1/J1 dual-color Green/Re d status LEDs: — Green indicates a valid link — Red indicates a line alarm Note: Only the LEDs 0, 1, 2, and 3 are active (LEDs 4, 5, 6, and 7 are reserv ed for future us[...]

14 2 Specification 2.2.9 Safety, EMC and Teleco mmunications Specifications Safety , EMC and telecommunications specification information is provid ed by the following: • Dialogic ® DSI SS7MDL440Q Network Interface Board Regulatory Notices Supplied with each product and provides a full list of the specifications to which DSI SS7MDL4 board confor[...]

15 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 2.3 Software Licenses The DSI SS7MDL4 codefile supports different MTP2 lin k densities on the board. T hese are enabled using a Host Software License that is to be ordered at the same time as t he hardware. The Host Software License licenses a specific number of link r esources on the host tha[...]

16 2 Specification The following combinations of link types are av ailable to the user: Note: When using multiple link types on the same board, the run mode indica tes to the board the predominant link type. Note: T o change the run mode of a bo ard, the board must be reset. Run Mode LSL Links HSL Links ATM Links IMA Links LSL Y Y Y H S L YYY A T M[...]

17 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 3: Installation This chapter contains the following topics: • Software P ackages • Software Installation for Linux • Software Installation for Solaris (SP ARC)[...]

18 3 Installation 3.1 Software Packages This manual describes the installation and use of the following software: • Development P ackage • User Part Dev elopment Package • Binary for Dialogic ® DSI SS7MD Network Interface Boards 3.1.1 Development Package Different variants of the Dev elopme nt Package are a vailable for the supported operati[...]

19 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 3.2 Software Installation for Linux The Development P ackage for Linux is distributed as a download from the Dialogic web site. See Section 1.1, “Related Information” on page 7 . The distribution is in the form of a single compressed file called dpklnx6.Z . Installation of the software is [...]

20 3 Installation The ldconfig utility creates a symbolic link to the GCT li brary shared object within the install directory . For e xa m p le : /opt/dpklnx: libgctlib.so.1 -> libgctlib.so.1.0.1 If the installation machine is to be used to build applications, an additional link must be created from libgctlib.so.1 to libgct.so : ln -s libgctlib.[...]

21 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> wh[...]

22 3 Installation ss7dpk-devel-5.08-1.<ARCH>.rpm ss7dpk-debuginfo-5.08-1.<ARCH>.rpm ss7dpk-kmod-5.08-1.2.6.9_34.EL.<ARCH>.rpm Where <ARCH> is i386 for 32bit operation and x86_64 for 64 bit operation systems. Note: Device driver binaries, includin g the one for the DSI S S7MD Board, will be built as rpmbuild is run. Therefore[...]

23 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 3.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 • Re moving the Development Package for Solaris • Solaris Interface Name Checking The Development P [...]

24 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. 3.3.2 Support for Larger Message Queues The number of[...]

25 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 4: Dialogic® DSI SS7MD Bo ard Configuration and Operation Before attempting software configur ation, you should g ain an appreciation of the flexibility of the protocol stack, the run-time options that ex ist and the mechanisms that are used to select specific features. This section g[...]

26 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.1 Regulatory and Geog raphic Considerations Certain functions of Dialogic ® DSI SS7MD Boards, although implemen ted in hardware, hav e selectable options that are configured by the ss7.dc6 codefile. A user or integr ator must consider the requirements of the application when choosing t[...]

27 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.2 System Structure The Dialogic ® DSI Protocol Stack software running on the board communicates with the higher level protocols running on the main CPU of the host comput er . The user ’ s application ma y also be running on the host computer . See Section 4.3, “Running Host Binaries Wi[...]

28 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.3 Running Host Binaries With Dialogic ® DSI SS7MD Board The Dialogic ® DSI MTP2 Layer protocol module runs on t he board. The other S S7 protocol modules (MTP3, ISUP , TUP , SCCP , TCAP , MAP , INAP , and IS 41) must be run on the host machine. Host protocol software is av ailable for[...]

29 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.4 System Configuration System configur ation is handled by the gctload program that reads system configur ation data from a file called system.txt . System initialization requires: • First, that a pool of message buffers is crea ted for subsequent inter-process communication. • Second, t[...]

30 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 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 * LOCAL 0x14 * TCAP module * LOCAL 0x22 * MTP3 module * * * Redirection of status indications: * REDIRECT 0xdf 0x2d[...]

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_PROCES S commands are: FORK_PROCESS ./ssdm FORK_PROCESS ./tim_lnx FORK_PROCESS ./tick_lnx •[...]

32 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.5 Protocol Configuration The Development P ackage contains the s7_mgt protocol configuration utility that performs initialization of all the software modules running on the signaling board. It reads the protocol configur ation data from a text file, called config.txt , and provides a qu[...]

33 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 * * ISUP parameters: * * Configure ISUP module: * ISUP_CONFIG <reserved> <reserved> <us er_id> <options> <num_grps> <num_ccts> *ISUP_CONFIG 0 0 0x1d 0x0435 4 64 * * Configure ISUP circuit groups: * ISUP_CFG_CCTGRP <gid> <dpc> <base_cic> <[...]

34 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.6 Monitoring The monitoring option can be used in conjunction wi th the SS7 Development P ackage for the appropriate operating system (Linux or Solaris) to realize a high-performance protocol mon itor with up to 4 boards, each monitoring a certain number of links (see the table in Secti[...]

35 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.7 ATM Monitoring The system can also be used to monitor AAL5 traffic that is running o ver A TM links. The following is an example config.txt co nfiguration file to support AAL5 Monitoring: ******************************************************************************** * Example Protocol Co[...]

36 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.8 Switching Time slots between LIUs The Dialogic DSI SS7MD Boards support multiple T1/E1/J1 Line Interface Un its (LIUs). The onboard signaling processor handles the SS7 signaling timeslots, while the re maining circuits (voice or data bearer circuits) are switched to another onboard LI[...]

37 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.8.2 Static Initialization Static initialization is handled by the s7_mgt protocol configuration utility . F or each T1/E1/J1 Line Interface Unit (LIU), the user should includ e an LIU_SC_DRIVE command in the config.txt protocol configuration file. The LIU_SC_DRIVE command has sever al parame[...]

38 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 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(p[...]

39 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.9 Received Message Timestamping Timestamping of received message s can be enabled for monitored lin ks. This functionality provides a timestamp of the time a message is received by a bo ard. Individual boards maint ain time by synchronising with the host time. The following table provides de[...]

40 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.10 High Speed Link Operation High Speed Link (HSL) operation is supported in the following mode: • Structured mode, where the data stream is fr amed as for conventional SS7: — For T1, 8 bits in each of 24 timeslots are available for signalling. — For E1, timeslot 0 is used for fr [...]

41 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.11 Operation of the Thermal Sensor Thermal Protection The Dialogic ® DSI SS7MDL4 Network Interface Board is a hi gh performance, densely pack ed, low profile PCIe board supporting high message rates. In achiev ing this performance, the board ma y dissipate up to 17W and this must be taken i[...]

42 4 Dialogic® DSI SS7MD Board Configuration and Oper ation[...]

43 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 5: Program Execution This chapter describes how to start the so ftware and execute progr ams. It assumes that: • The software has already been installed. R efer to Chapter 3, “Installation” . • The system.txt configuration file has been modified correctly . Refer to Section 4.4[...]

44 5 Program Execution 5.1 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 depe nding upon the operating system: 1. Ensure that the device driv er is installed and running. 2. Ensure that the protocol soft ware is running on the host. 3. W[...]

45 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 5.2 Program Execution Under Linux and Solaris Proceed as follows: 1. Ensure the device driver has been installed and the system.txt configur ation file has been modified in accordance with system requirements to select the correct protocols etc. 2. Ensure that the correct codefile has been cop[...]

46 5 Program Execution[...]

47 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 6: Message Reference This section describes the individual messages that may be sent to or received fr om a Dialogic® DSI S S7MD Board. Some messages are sent by the user's application software, while others are sent by utility progr ams such as the s7_mgt protocol configuration [...]

48 6 Message Reference 6.1 DSI SS7MD Software Modu le IDs for DSI SS7MD Board Ta b l e 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 Value Description MGMT_T ASK_ID 0x8e SS7MD Board Management Module MVD_T ASK_ID 0x10 SS7MD LIU and S witch Management Modul[...]

49 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.2 General Configuration Messages General configur ation messages are typically issued by the s7_mgt protocol configuration utility , in which case they need not, and should not, be gene r ated by any user application software. If the user elects not to use the s7_mgt protocol configuration u[...]

50 6 Message Reference Parameters The SSD_MSG_RESET message includes the following par ameters: • mgmt_id The module ID of the manageme nt module to which SSD should send board status indications. • num_boards The maximum number of boards that ssd is required to manage. This should not exceed 4. 6.2.2 SSD_MSG_RST_BOARD – Board Reset Request S[...]

51 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • run_mode The protocols to be run. The following tabl e shows the permitted v alues and their meaning. The following combinations of link types are av ailable to the user . Note: When using multiple link types on the same board, the run mode indica tes to the board the predominant link type[...]

52 6 Message Reference 6.2.3 SSD_MSG_BOARD_INFO – Board Information Request Synopsis Message used to retrieve inform ation about the DSI SS7MD Board. Format 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 report ed as being present i[...]

53 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • current_temp Signed 8-bit value containing the current temper ature of the board within the range -128 to 127 degrees Celsius. • max_temp Signed 8-bit value containing the maximum temper ature the board has reached since SSDM was last started. V alue is within the rang e -128 to 127 degr[...]

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 g enerated internally on the board during the configuration sequence are sent to the 0xdf module ID on the host. — All other bits are reserved for fu ture use and should b[...]

55 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Configure the LSL timeslot rate: • l1_resource_id Layer 1 (logical) resource identifier . • data_rate Used for setting the link operation. The following table shows the perm itted v alues and their meaning. • link_source Configure the signaling source. Set to 0 for DSI SS7MD Board. • l[...]

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 pr eviously configured by sending an MGT_MSG_L1_CONFIG message. Format Parameters The MGT_MSG_L1_END message includes the following parameters: • l1_resource_id Layer 1 (logical) resource identifie[...]

57 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Parameters The MGT_MSG_NTP_CONFIG message incl udes the following par ameters: • enable Set to 1 to enable timestamping, 0 to disable timestamping. • poll_interval Set to 4. • ntp_management_id Set to 0x20.[...]

58 6 Message Reference 6.3 Hardware Control Messages Hardware control messages are used to control v arious hardware devices on the board, including the T1/E1/ J1 Line Interface Units (LIUs), the digital cross connect switches and th e clocking mode for the board. In a static configuration, these hard w are blocks can be set up using the s7_mgt pro[...]

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 s7_mgt as a result of the LIU_CONFIG command. I[...]

60 6 Message Reference Note: The option chosen by the user m ust be appropriate to the actual hardw are fitted; otherwise an error status is returned. • line_code The line coding technique. The following table shows the permitted values and their meanings. • frame_format The frame format. The following table shows the permitted v alues and thei[...]

61 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • ais_gen The (initial) mode used to generate the Alarm Indi cation Signal (Blue alarm). The user may subsequently modify the setting of the outgoing signal using the LIU_MSG_CONTROL message. The following table shows the permitted valu es and their meanings. • high_Z The mode settings to [...]

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 an d diagnostic loopbacks. Format Description This message is sent to the board to perform dynami c changes to the operation of the Line Int[...]

63 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • loop_mode The diagnostic loopback mode. The following tabl e shows the permitted v alues and their meanings. • prbs_gen The Pseudo Random Bit Sequence (PRBS) gener ation mode. The following tabl e shows the permitted values and their meanings. 6.3.3 LIU_MSG_R_CONFIG – LIU Read Configur[...]

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 Interfac e Unit (LIU) control options from the board. Format Description This message is sent to the board to read back the current control parameters selected for a Line Interface Unit (LIU). The user s[...]

65 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 The confirmation message (if re quested) indicates success with a status v alue 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. Format Descr[...]

66 6 Message Reference Parameters The parameters that can be included in the MVD_MSG_SC_CONNECT message depend on the requested mode. The following table depicts the parameters that are required for each possible mode: • local_stream Defines which local stream to use for all the modes of operation.The local_stream par ameter specifies either a T1[...]

67 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • source_stream The source_stream references the cross connect sw itch streams that should be used as a source for data. The parameter tak es values in the range of 0 to 31. F or some modes (for example, 11 and 12), this field is used to specify a local st ream instead of a switch stream. ?[...]

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 Description This message is sent to the board in order to control the configuration of the cross connect switch for more complex configurations. Parameters The MVD_MSG_SC_MUL T[...]

69 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • source_st , source_ts When mode is set to 11, these paramete rs give the source_st and so urce_ts for conne ction to the specified local timeslots. For othe r modes the source_st an d source_ts specify the cross connect switch stream and timeslot, respectively . 6.3.8 MVD_MSG_SC_DRIVE_LIU [...]

70 6 Message Reference • mode The mode of operation that controls how the switch channels are allocated. T ypically , when mode is set to 1, the first timeslot connected to the switch is connected to th e timeslot indicated by sc_channel and each subsequent timeslot that is connected will be connected to th e next switch channel. This allows maxi[...]

71 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.4 Signaling Interface Messages Signaling interface messages allow signaling links to be ac tivated and deactiv ated by the user and provide a mechanism for communication between the MTP3 module and the user part module (for example, ISUP , TUP or SCCP). In many cases, the user part module is[...]

72 6 Message Reference 6.4.1 SS7_MSG_CONFIG – MTP2 Li nk Configuration Request Synopsis Message issued by management to MTP2 to con figure an individual signaling link for oper ation. Format Description This message is used to configure the operational par a meters for an individual signaling link and to cause the power up action defined in Q.703[...]

73 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 messages may be issued to the MTP2 module to modify timer configur ation parameters however; these messages do not affect SS7 oper ation (that is, th e power up sequence is not re-executed, but the parameters are modified). For backw ards compatibility , the MTP2 module acce pts messages with [...]

74 6 Message Reference the loop delay in ms for 56 kbits/ s operation. If set to 0, the MTP2 module assumes a v alue of 12800 for an HSL link, 400 otherwise. • rtv_attempts Re served. Set to 0. • t1, t2, t3, t4n, t4e, t5, t6, t7 V alues for the protocol timers as defined in Q.70 3. These should be set to the number of (tick * timer_res) interva[...]

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. • UUI User to User Information – pa rameter gener ated when operating in A TM monitoring mode only . • CPI Common Part Indicator[...]

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 tr ansmission on the specified link. Format Description Message issued to the board by MTP3 containing an SS 7 Message Signal Unit[...]

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 v ersion. Format Description Message issued to requ est software v ersion. Parameters The GEN_MSG_MOD_INDENT message incl udes the following parameters: • maj_rev Major revision identifier f[...]

78 6 Message Reference 6.5 ATM Interface Messages A TM Interface Messages allow A TM lin ks to be configured, activate d, and deactiv ated by the user . • A TM_MSG_CONFIG - Configure A TM • A TM_MSG_CFG_STREAM - A TM Cell Stream Configuration • A TM_MSG_END_STREAM - Remov e A TM Cell Stream Configuration • A TM_MSG_R_STREAM_ST A TS - P er A[...]

79 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • options • num_streams The maximum number of cell streams this modul e will be asked to simultaneously support. Each cell stream shall be treated independently of the link bandwidth the cell stream consumes. For an IMA bundle, each TDM stream within the bundle will be counted as separate.[...]

80 6 Message Reference 6.5.2 ATM_MSG_CFG_STREAM – ATM Cell Stream Configuration Synopsis Message used to configur e an A TM cell stream. Format Description Processed by the module (once a module configuration message has been correctly processed) to configure and activate an A TM cell stream (w hether single TDM or IMA bundle). After extraction o[...]

81 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • options Note: Either Pa yload Scrambling or A TM Coset mode, or both, must be enabled for correct operation. Configurations which disable bo th options will be rejected. • ima frame length The length of the IMA frame. Note: For non IMA streams this field is r eserved and should be set to[...]

82 6 Message Reference Note: Attempting to activ ate TDM tim eslots that are not present on th e underlying TDM (e.g. , using a bitmap of 0xfffefffe when the TDM is configured as T1) may NO T result in the rejection of the configuration message. • mgmt_id ID of management module for status updates. • upper_stream_id Upper layer (la yer 3) strea[...]

83 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Description Sent by the user to request (and optionally reset) the statistics for the cell stream. The v alues returned are the totals for the links using this cell stream. The confirmation message (if re quested) indicates success with a status v alue of 0. • Cell Stream ID The logical Cell[...]

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 Description Sent by the user to configure the pa rameters of a monitored link. At pr esent, the only link type a vailable via this message is an AAL5 link. • link_id Identifier for this link. Note: This id[...]

85 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • VPI The VPI of the AAL5 stream to be monitored. The VPI must be viable in the mask configured in the A TM_MSG_CONFIG message. • VCI The VCI of the AAL5 stream to be mon itored. The VCI v alue must be viab le in the mask specified in the A TM_MSG_CONFIG message. Note : 0, 3, and 4 are res[...]

86 6 Message Reference 6.5.7 ATM_MSG_R_AAL_LINK_STATS – Per Monitored Link Statistics Synopsis Message used to retrieve (and re set) per monitored link statistics. Format 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[...]

87 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.5.8 ATM_MSG_STREAM_STATE – AT M Stream Status Indication Synopsis Primitive generated by A TM to advise ma nagement of changes to the stream state. Message Format Description Sent by the A TM module when a st ream becomes active or inactive MESSAGE HEADER Field Name Meaning type A TM_MSG_S[...]

88 6 Message Reference 6.5.9 ATM_MSG_LINK_STATE – AA L Link Status Indication Synopsis Primitive generated by AAL to advise ma nagement of changes to the link state. Format Description Sent by the A TM module when an AAL link becomes active or inactive. MESSAGE HEADER Field Name Meaning type A TM_MSG_LINK_ST A TE (0x026b) id link_id src A TM Modu[...]

89 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.6 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_ MS G_R ESE T - Q.SAAL Module R eset Request • QSL_MSG_CFG_LINK - Configure Q.SAAL Link • QSL_MSG_CFG_TIMERS -[...]

90 6 Message Reference • num_links Maximum number of Q.SAAL signaling links to support on this board. This may r ange from 0 to one less than the maximum number of links supported depend ing on how many signaling links the user wishes to use. It is not necessary to alw a ys use this number of links. 6.6.2 QSL_MSG_CFG_LINK – Configure Q.SAAL Lin[...]

91 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 QSAAL_MSG_TIMERS messages may be issued to the Q .SAAL module to modify timer configur ation parameters howeve r; these messages do not affect Q.SA AL oper ation (that is, the power up sequence is not re-executed, but the par ameters are modified). • link_id Identifier for this link. Note: T[...]

92 6 Message Reference • co1, co2, co3, ca1, ca2, ca3, cd1, cd2, cd3 Congestion onset, abatement and discard thresholds for use when th e Multiple Congestion Thresholds mode of operation is selected. The following relationships must be true: ca1 <= co1 <= ca2 <= co2 <= ca3 <= co3 and co1 <= cd1 <= co2 <= cd2 <= co3 <[...]

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 configur ation parameters. Otherwise default timer v alues will be used. • Timer_CC Time between transmission of un- ack'ed BGN, END, ER, RS PDUs • Timer_keep_alive Time between keep alive mess[...]

94 6 Message Reference 6.6.4 QSL_MSG_END_LINK – Remove Q.SAAL Link Synopsis Re move a Q.SAAL Link - only allowed wh en the link is in the inactiv e state. Message Format Description Sent by the user to deactivate a link, remove its connection from the un derling A TM cell stream and release its resources. • link_id Identifier for this link. MES[...]

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 modu le to set the mask of wh ich messages should be traced Message Format Description The Q.SAAL module supports comprehe nsive tracing options on a per-lin k and per-primitive basis. The module can be confi[...]

96 6 Message Reference • ip_evt_mask The input event trace mask. This is a 16-bit v alue 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 take n when tracing messages, as system throughput ma y be red uced. The fields in the tr ace mask cause the events indi[...]

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 re trieve current per link state in the same format as MTP2 Message Format Description This message is issued to the Q.SAAL module to read the current internal state of the link and the number of MSU's cu[...]

98 6 Message Reference 6.6.7 SS7_MSG_R_STATS – Read Link Statistics Request Synopsis Message sent to Q.SAAL module to retriev e per link statistics in sa me format as MTP2. Message Format Description Message used to retrieve Q.S AAL per-link statistics. Th e statistics are written into the parameter area of the message and the message is returned[...]

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 gener ated by Q.SAAL module to advise management of protocol ev ents. Message Format Description Sent by Q.SAAL module to mana gement when an event occurs. MESSAGE HEADE[...]

100 6 Message Reference 6.6.9 MGT_MSG_SS7_STATE – Link State Indication Synopsis Indication generated by Q .SAAL module to advise management of changes to the per-link state Message Format Description: This primitive is used by Q.S AAL to advise management of changes of state within the Link State Control function. These indications are only give[...]

101 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.6.11 Primitives issued to MTP3-b The following primitives are supported by the Q.S AAL module. For message defi nitions refer to Dialogic® SS7 Protocols MTP2 Progr ammer's Manual. MTP2 Primitive Description NN I Primitive Equivalent API_MSG_RX_IND Received Data Indication AAL -RECEIVE[...]

102 6 Message Reference 6.7 Event Indication Messages Event indication messages are the mechanism by which pr otocol and software error ev ents are reported to the application. These messages are generated asynchronously by differ ent modules within the stack. The messages in the event indi cation category include: • MGT_MSG_EVENT_IND - Error Ind[...]

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 ev ents. Message Format Description An individual module may be configured to report to management each prim itive issued or received. This is useful for trace and debug purposes. The event[...]

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 down load sequence or on detection of a board status event. Note: This message is not re quired when using the s7_mgt protocol configuration utilit y . Format Description This message is used to convey [...]

105 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.7.4 API_MSG_CNF_IND – Configurat ion Completion Status Indication Synopsis Message issued by the s7_mgt protocol configuration utility on comp letion of initial configur ation sequence. Format Description This message is issued by the s7_mgt protocol configuration utility on completion of[...]

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 Description This message is issued by the board for ev ery change of state on the trunk interface. The MVD_MSG_LIU_ST A TUS message head er uses the following parameters: • liu_id[...]

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 ev ents in accordance with Q.791. Format Description This primitive is used by MTP2 to advise system mana gement of the occurrence of protocol related events in [...]

108 6 Message Reference 6.7.7 MGT_MSG_NTP_SYNC – Timestampi ng Resynchronization Indication Synopsis Message sent if a significant time difference between the board and the ho st is detected. This message is generated only if received message timestamping is configured. See Section 4.9, “Received Message Timestamping” on page 39 for more info[...]

109 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.8 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_ST A TE - LIU Read State R equest • LIU_MSG_R_ST A TS - LIU Re ad Statistics Request • MGT_MSG_[...]

110 6 Message Reference 6.8.2 LIU_MSG_R_STATS – LIU Read Statistics Request Synopsis Message used to read back perfo rmance statistics associated with a Line Interface Unit (LIU). Format Description This message is used to collect performance statisti cs for a given Line Interface Unit (LIU). A module requesting LIU statistic information is requi[...]

111 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 — For E1 oper ating modes, it is the number of errors detected in the frame alignment word. — For T1 interfaces oper ating in D3/D4 frame form at, it is the number of fr aming bit errors. — For T1 interfaces oper ating in ESF form at, it is the number of CRC6 errors. Note: In general, t[...]

112 6 Message Reference 6.8.3 MGT_MSG_R_BRDINFO – Read Board Info Request Synopsis Message used to request basic board information. Format Description This message is provided to request a reply indicating the v alues of a nu mber of attributes associated with the board. On receipt of th is request, the module retur ns the message with the stat u[...]

113 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.8.4 DVR_MSG_R_L1_STATS – Link Statistics Request Synopsis Re trieve link statistics. Format Description This message provides the user with a number of statis tics on a per link basis. If the user sends the message with a non zero status field, the stat istics are reset to 0 after being r[...]

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) fr ames received on the link, excluding any duplicate fr ames that are discarded as a result of th e internal filtering mec[...]

115 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.9 Message Summary Table The following table lists, by message type, all the messages described in this manual. Table 7. Message Summary Message Type Mnemonic Description 0x0003 MGT_MSG_TRACE_EV T race Event Indication 0x0008 MGT_MSG_EVENT_IND Error Indication 0x0201 MGT_MSG_SS7_ST ATE Link [...]

116 6 Message Reference 0x6214 SS7_MSG_R_ST AT S R ead Link Statistics Request 0x6215 SS7_MSG_R_ST ATE R ead Link State Request 0x6263 A TM_MSG_R_STREAM_ST ATS Per A TM Cell Stream Statistics 0x6266 A TM_MSG_R_AAL_LINK_ST A TS Per Monitored Link Statistics 0x6f0d MGT_MSG_R_BRDINFO Read Board Info R equest 0x7200 SS7_MSG_RESET Q.SAAL Module Reset R [...]

117 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 7: Configuration Command Reference This chapter describes the comman ds and parameters used in the config.txt protocol configur ation file. These commands are used by the s7_mgt protocol configuration utility to perform one time configur ation of the protocol stack at startup. The com[...]

118 7 Configuration Command R eference 7.1 Physical Interface Configuration Commands The physical interface configur ation commands are: • SS7_B OAR D - Configure Dialogic ® DSI SS7MD Network Interface Board • LIU_CONFIG - Configure a T1/E1/J1 LIU • LIU_SC_DRIVE - Set Up Path Between LIU • SCBUS_LISTEN - Connect Switch Timeslot to LIU Time[...]

119 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.1.1 SS7_BOARD – Configure Dialogic ® DSI SS7MD Network Interface Board Synopsis Command to configure a DSI SS7MD Board in the system. Syntax SS7_BOARD <board_id> <board_type> <flags> <code_file> <run_mode> Example SS7_BOARD 0 SS7MD 0x0000 ss7.dc6 LSL Paramet[...]

120 7 Configuration Command R eference • <board_id> The logical identity of the board in the range from 0 to one less th an 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. • <liu_type> The physical interface type. The[...]

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 Valid For 0 Setting for E1 devices liu_type = 5 1 T1/J1 default (short haul) liu_type = 4 8 T1/J1 long haul LBO (-0 dB) 9 T1/J1 long haul LBO (-7.5 dB) 10 T1/J1 long [...]

122 7 Configuration Command R eference 7.1.3 LIU_SC_DRIVE – Set Up Path Between LIU Synopsis This command is used during initialization to set up a static switch path betw een the Line Interface Units (LIUs) and the cross connect switch. It connects selecte d incoming voice timeslots from one T1/E1/J1 LIU to a sequential block of channels on the [...]

123 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.1.4 SCBUS_LISTEN – Connect Sw itch Timeslot to LIU Timeslot Synopsis This command establishes a connection from the switch to an outgoing timesl ot on the Line Interface Unit (LIU). Note: Dynamic modification of voice paths can only be performed by issuing messages directly to the board. [...]

124 7 Configuration Command R eference 7.1.5 STREAM_XCON – Cros s Connect Configuration Synopsis The STREAM_XCON command controls the cross connect switch on the signaling bo ards, enabling the cross- connection of timeslots between two Line Interface Unit (LIU ) on each signaling board . The LIUs on a board are referenced by a fixe d logical str[...]

125 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 — E1 interfaces have 32 timeslots numbered 0 to 31. Timeslot 0 is used for fr ame alignment and timeslot 16 is generally used for signaling or is empty . Hence the normal co nfigur ation is to cross connect timeslots 1 to 15 and 17 to 31 between the two ports on each signaling board by sett[...]

126 7 Configuration Command R eference 7.2 Monitor Configuration Commands The monitor configuration command is: • MONITOR_LINK - Configure Link in Monitoring Mode[...]

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 conf igure a signaling link or A TM link to operate in monitoring only mode. The command is differentiated based on the data rate par ameter . R eceived signaling messages are passed [...]

128 7 Configuration Command R eference • <data_rate> An optional parameter to specify link par ameters, re quired for HSL or A TM operation. The v alid values are: MTP HSL/LSL Link Parameters • <board_id> The logical identity of the board in the range from 0 to one less th an the number of boards supported. • <blink> The ind[...]

129 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.3 MTP Configuration Commands The Message T ransfer P art (MTP ) configuration commands are: • MTP_CONFIG - Configure MTP • MTP_LINKSET - Configure a Linkset • MTP_LINK - Configure a Link • MTP_ROUTE - Configure a R oute • MTP_USER_PAR T - Configure a Local User Part 7.3.1 MTP_CONF[...]

130 7 Configuration Command R eference set to 0, on detection of RPO, the signaling link is tak en 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). — Bit 21 should be set to 1 for use in Japanese networks; otherwise it should be set t[...]

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 0 321 2 0x0000 456 0x8 Parameters The MTP_[...]

132 7 Configuration Command R eference 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> [...]

133 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 — Bit 12 is used to select 12- or 7-bit sequence numbers for HSL only . Th is bit should be set for 12-bit sequence numbers, clear otherwise. — Bits 13 and 14 reserved. Set to 0. — Bit 15 is set to 1 to disable the link. This bit should be set to 0 to enable normal link oper ation. — [...]

134 7 Configuration Command R eference — vpi is the Virtual P ath Indicator of th e signaling link within the A TM cell stream. — vci is the Virtual Channel Indicator of th e signaling link within the A TM cell stream. For restrictions on the choice of VPI -VCI combinations refer to Section 6.5.1, “ A TM_MSG_CONFIG” on page 78 . 7.3.4 MTP_R[...]

135 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 — All other bits are reserved for fu ture 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 mod ule, other than a user part which has its own configuration command in the config.txt protocol configuration file. Syntax M[...]

136 7 Configuration Command R eference 7.4 ATM Configuration Commands The A TM configuration commands are: • A TM_CONFIG - Configure the A TM Module • A TM_STREAM - Configure A TM Cell Stream • A TM_TIMER - Configure Timers for Q.SAAL Links[...]

137 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.4.1 ATM_CONFIG – Configure the ATM Module Synopsis Global configuration of the A TM Module. Syntax ATM_CONFIG <options> <num_streams> Example ATM_CONFIG 0x0000 4 Parameters The A TM_CONFIG command includes the following parameters: • < options > A 16-bit value containi[...]

138 7 Configuration Command R eference 7.4.2 ATM_STREAM – Configure ATM Cell Stream Synopsis Configures an A TM 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 3 0 3 3 0x00[...]

139 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • < def_vci > A default AAL5 link will be configured for the cell stream to signal incomi ng active connections. This is the VCI that will be used for this connection. V alues 0, 3, and 4 are reserved an d should not be used. Note: The default VPI/VCI combination configured here m ust[...]

140 7 Configuration Command R eference 7.4.3 ATM_TIMER – Configure Timers for Q.SAAL Links Synopsis Override the default timer v alues for A TM Links. Syntax ATM_TIMER <reserved> <timer_id> <value> Example ATM_TIMER 0 T1 10 Parameters The A TM_TIMER command inc ludes the following parameters: • <reserved> This parameter [...]

141 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.5 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 par ame ters for the ISUP m[...]

142 7 Configuration Command R eference 7.5.2 ISUP_CFG_CCTGRP – Config ure an ISUP Circuit Group Synopsis The configuration par ameters for a grou p of ISUP circuits. T ypically , 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> <o[...]

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 Parameters The ISUP_TIMER command inclu[...]

144 7 Configuration Command R eference 7.6 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 par a meters for the TUP module. Syntax TUP_CONFIG <res1> <res2> <user_id> [...]

145 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.6.2 TUP_CFG_CCTGRP – Conf igure a TUP Circuit Group Synopsis The configuration par ameters 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>[...]

146 7 Configuration Command R eference 7.7 SCCP Configuration Commands The SCCP configuration commands are: • SCCP_CONFIG - Configure SCCP • SCCP_SSR - SCCP Sub-S ystem Resource • SCCP_CONC_SSR - SCCP Concerned Sub- System Re source • SCCP_TRACE - SCCP T race • SCCP_GT T_PA TTERN - Define Global Title P attern • SCCP_GT T_ADDRESS - Defi[...]

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 par ameters for the SCCP . Syntax SCCP_SSR <ssr_id> RSP <remote_spc> <flags> <pc_mask> SCCP_SSR <ssr_id> LSS <local_ssn> <module_id> <flags&[...]

148 7 Configuration Command R eference 7.7.3 SCCP_CONC_SSR – SCCP Co ncerned Sub-System Resource Synopsis The SCCP_CONC_SSR command marks the specified su b-system (which was dec lared by SCCP_S SR) as requiring notification of changes in the accessibility of another sub-system. No tification is given in the form of an SCCP management indication.[...]

149 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.7.5 SCCP_GTT_PATTERN – Defi ne Global Title Pattern Synopsis The SCCP_GT T_PA TTERN command defin es a global title pattern to be matc hed for a global title tr anslation. Syntax SCCP_GTT_PATTERN <pattern_id> <addr_indicator> <pc> <ssn> <global_title> [<gt[...]

150 7 Configuration Command R eference • <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 > [...]

151 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 < gtai_replacement > parameter of the associated SCCP_GTT_ADDRES S command. The mask can contain the following: • < primary_address_id > Identifies the SCCP_GT T_ADDRESS command to use as the primary translation. • < backup_address_id > Identifies the SCCP_GT T_ADDRESS c[...]

152 7 Configuration Command R eference 7.8 DTC Configuration Commands The DT C configuration commands are: • DT C_CONFIG - Configure D TC • DT C_SSR - D TC Sub S ystem Resource 7.8.1 DTC_CONFIG – Configure DTC Synopsis The DT C_CONFIG command supplies the global configuratio n par ameters for the DT C protocol, activating DT C and higher prot[...]

153 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • < protocol > Should be set to TCAP , MAP , INAP or IS41 according to the layer of th e protocol stack to which the user application interfaces. Note: There can be at most one LSS for each of MAP , INAP and IS41.[...]

154 7 Configuration Command R eference 7.9 TCAP Configuration Commands The TCAP configur ation commands are: • TCA P _ CO N F IG - Configure TCAP • TCA P _ CF G _ DG R P - TCAP Dialog Group Configure • TCAP_TRACE - T CAP T race 7.9.1 TCAP_CONFIG – Configure TCAP Synopsis The TCAP_CONFIG command provides the T CAP operatin g par ameters and,[...]

155 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • < addr_format > Defines how TCAP should interpret address informat ion from messages receiv ed from SCCP in order to direct received T CAP primitives to unique SCCP sub-systems (T CAP user a pplications). It should be set to 0, 1, 2, 3 or 4 for the following options: 7.9.2 TCAP_CFG_[...]

156 7 Configuration Command R eference 7.9.3 TCAP_TRACE – TCAP Trace Synopsis The TCAP_TRACE command is used to configure T CAP to send trace messa ges to the trace module whenev er a specific message type is sent or received. See the TCAP Programmer’s Manual for details. Syntax TCAP_TRACE <op_evt_mask> <ip_evt_mask> <non_prim_ma[...]

157 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 T race 7.10.1 MAP_CONFIG – Configure MAP Synopsis The MAP_CONFIG command provides the MAP operatin g parameters and, if used, must appear after the SCCP_SSR commands in the[...]

158 7 Configuration Command R eference 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 T race 7.11.1 INAP_CONFIG – Configure INAP Synopsis The INAP_CONFIG command provides the INAP operating pa[...]

159 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.11.3 INAP_AC – INAP Application Context Synopsis This command is used to configur e the INAP Application Context (AC) records for use. These control the application context negotiation that the module co nducts during dialog establishment. The supported application contexts must be indivi[...]

160 7 Configuration Command R eference 7.12 IS41 Configuration Commands The IS41 configuration commands are: • IS41_TRACE - IS41 T race 7.12.1 IS41_TRACE – IS41 Trace Synopsis The IS41_TRACE command is used to configure IS41 to send trace messa ges to the tr ace module whenever a specific message type is sent or received. See the IS41 Programme[...]

161 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 ® DSI SS7MD Boards: • s7_log • s7_play • gctload • tim • tick • s7_mgt • ssdm • tempmon[...]

162 8 Host Utilities 8.1 s7_log Description The s7_log utility is a console application program that recei v es messages and displays them as text on the host console. Maintenance and status events are interp reted as text; other messag es are typically display ed in hexadecimal format. The s7_log utility can optionally print the date and time of w[...]

163 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • -f<filename> Optionally specifies a file to which all screen output is written. If the sp ecified file does not exist, it is created. If the specified file already exists, it is overw ritten. The data is stored in the file in ASCII format. • -t[t|d] Specifies the format of timesta[...]

164 8 Host Utilities Messages that are not interprete d as text are display ed 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 correspon ding message field in hexadecimal format.[...]

165 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.2 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 • a delay to apply before the next command is executed Syntax s7_pl[...]

166 8 Host Utilities Each field identifier is optional and ca uses the corresponding message field to be set to zero if not present. All values are entered in hexa decimal format. F or example: M-tc701-i0000-f1d-d23-s00-p0000ffffffff The following command file sends a re set circuit group message to the first ISUP group, w aits for 5 seconds, then [...]

167 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.3 gctload Description gctload is a task that initializes the host system environment and starts up all other processes (such as ssd ), deriving the process and message queue configuration from a text file. F or further de tails of the operation of gctload, refer to the Software Environment [...]

168 8 Host Utilities • -x T erminate 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 T o run gctload with the system.txt file as the configuration file, a cong estion onset v alue of 70, a congestion abatemen[...]

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 ei ther be empty or contain a small number of messages. If this is not the case, th is may be due to one of the fo[...]

170 8 Host Utilities 8.4 tim 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 fo[...]

171 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.5 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. Command Line Options The tick[...]

172 8 Host Utilities 8.6 s7_mgt Description The s7_mgt utility performs one-time protocol config uration for all protocol modules, deriving the configuration par ameters from a text file ( config.txt by default). This process is optional. As an alternative, the user may elect to perform protocol configur ation by sending messages directly to th e o[...]

173 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.7 ssdm Description SSDM interfaces with the device driver for passing messages to and from the board and controls the downloading software to the board. SSDM can be con figured to handle different modes of addressing for each board within a system. This can be based on ei ther the PCI bus e[...]

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 th is board w as located. Notes: It is not necessary for all boards lis ted in this option to physically exist in a[...]

175 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.8 tempmon Description The tempmon (T emperature Monitor) ut ility is a standalone console application program that runs in isolation from the GCT environment and periodically reads back the temperature, as recorded by the on-board temperature sensor , of all DSI SS7MD Boards present in the [...]

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, 35, 36, 34, 35 2009-06-02 10:36:05, 35, 36, 34, 35 2009-06-02 10:36:10, 35, 36, 35[...]

177 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Appendix A: Protocol Configur ation Using Discrete Messages This appendix provides guidelines for protoc ol configur ation using individual messages. A.1 Protocol Configuration Us ing Individual Messages As an alternative to using the s7_mgt protocol configuration utilit y (see Section 4.5.1,[...]

178 Appendix A Protocol Configur ation Using Discrete Messages 9. Build and send an MTP3 Signaling Link Config uration R equest (MTP_MSG_CNF_LINK) to set up configuration par ameters for the individual link. See the MTP3 Programmer’s Manual for the message definition. W ait for the confirmat ion message and check the status. For each link set in [...]

179 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Figure 3. Protocol Configurat ion Message Sequence Diagram (0x3f 17) SSD_MSG_RESET (0x7680 ) (0x3680) SSD_MSG_RST_BOARD (0x7681 ) (0x3681) Board Stat us I ndicati on (0x 06a0) MGT_MSG_CONFIG0 (0x7f 10) (0x3f10) (0x3e34) Repeated per LI U Repeated per Li nk MGT_MSG_L1_CONFI G (0x 7f17 ) LIU_CO[...]

180 Appendix A Protocol Configur ation Using Discrete Messages A.2 Monitoring Configuration Using Individual Messages T o configure the board for monitoring it usi ng individual messages, proceed as follows: 1. Build and send an SSD R eset Request to the SSD module. This contains the par ameters to initialize the SSD m od ule . 2. Build and send a [...]

181 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 A.3 Q.SAAL Protocol Configuration Using Individual Messages The process to configure the board for Q.SAAL links usi ng individual messages is closely related to section A.1. The full message sequence is shown diagr ammatically in Figure 4 . Note: The format of all of the messages is desc ribe[...]

182 Appendix A Protocol Configur ation Using Discrete Messages route. See the MTP3 Programmer's Manual for the me ssage definition. W ait for the confirmation message and check the status. Proceed now with the User Part config ur ation procedure. Once this is comp lete, issue an MTP Link Activation Re quest (MTP_MSG_ACT_SL) for each link in th[...]

183 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Appendix B: Thermal guidelines for selecting suitable servers f or use with a Dialogic® DSI SS7MDL4 Network Interface Board The Dialogic ® DSI SS7MDL4 Network Interface Board is a hi gh performance SS7 board capable of delivering over 30,000 MTP2 pack ets per second. T o achieve such le vel[...]

184 Appendix B Thermal guide lines for selecting suitable serv ers for use with a Dialo gic® DSI SS7MDL 4 Network In- terface Board[...]

185 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Glossary AAL5 A TM Adaptive Layer part 5 AIS Alarm Indication Signal (Blue alarm). A TM Asynchronous T ransfer Mode config.txt A text file used for protocol configuration. ctu An example program that demonstr ates ho w a user application can interface with telephony user parts, such as ISUP a[...]

186 Glossary PRBS Pseudo Random Bit Sequence. A technique used for bit error rate testing on T1/E1/J1 trunks. Q.SAAL Link conforming to Q.2140/Q.2110/GR -2878. RAI R emote Alarm Indication (Y ellow alarm). route An MTP3 concept that determines how sign aling is distributed over linksets. A route consists of a destination point code and the lin kset[...]

187 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Index A API_MSG_CNF_IND message 105 API_MSG_RX_INDT message 75 application programs running under Linux 45 ATM monitoring 35 ATM_CONFIG 137 ATM_STREAM 138 , 140 B binary file ss7.dc6 18 binary files for DSI SS7MD Boards 18 board identifiers DSI SS7MD Network Interface Boards, DSI SS7ML4 board[...]

188 Index DSI SS7MDL4 boards 13 event indication messages 102 API_MSG_CNF_IND 105 MGT_MSG_NTP_SYNC 108 MGT_MSG_SS7_EVENT 107 MVD_MSG_LIU_STATUS 106 SSD_MSG_STATE_IND 104 example code for building and sending MVD_MSG_SC_LISTEN message 37 execution Linux 45 Solaris 45 F file suffix for DSI SS7MD Board codefile 18 files installed on Linux 19 installed[...]

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 M MAP configuration commands MAP_CONFIG 157 MAP_TRACE 157 MAP_CONFIG configuration command 157 MAP_TR[...]

190 Index DSI SS7MDL4 boards 14 relm( ) function usage 177 removing Development Package Linux 21 route configuration command 134 RPM creation instructions 21 installation 21 packages 22 using management tools 22 running programs under Linux 45 runtime operations 34 S s7_log utility 162 s7_mgt protocol configuration utility 32 s7_mgt utility 172 s7_[...]

191 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 tick 171 tim 170 V verifying device driver loading 20 visual indicators DSI SS7MDL4 boards 13 W warranty information link to 14[...]