background image

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. In board serial 
number address mode, if a board does not have a valid entry in the address list, that board will generally 
be inaccessible to the system except for messages that allow the user to specify a board's physical 
address (see below).
Under certain circumstances (for example to determine the serial number of a new card added to the 
system which, as yet, does not have a valid mapping in the system.txt file), the user may require access 
to all the boards in a system irrespective of the address mode or any address list specified in the 
system.txt file.
To retrieve a board's serial number under these conditions, the 

SSD_MSG_BOARD_INFO

 message allows 

each board to be addressed either via its logical address (as determined by the address list mapping) or 
via its physical address (as determined via its discovery order in the platforms PCI bus enumeration). To 
access the board under its physical address, the top bit of the 

SSD_MSG_BOARD_INFO

 ID field is set.

Summary of Contents for DSI SS7MD

Page 1: ...www dialogic com Dialogic DSI SS7MD Network Interface Boards Programmer s Manual...

Page 2: ...licensed by Dialogic and no such licenses are provided except pursuant to a signed agreement with Dialogic More detailed information about such intellectual property is available from Dialogic s legal...

Page 3: ...ion 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 Dev...

Page 4: ...6 6 11 Primitives issued to MTP3 b 101 6 7 Event Indication Messages 102 6 8 Status Request Messages 109 6 9 Message Summary Table 115 7 Configuration Command Reference 117 7 1 Physical Interface Conf...

Page 5: ...sage Sequence Diagram 182 Tables 1 SS7 Link Termination or Monitoring Capacity of the Dialogic DSI SS7MDL4 Network Interface Board 11 2 Files Installed on a System Running Linux 19 3 Files Installed o...

Page 6: ...logic 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 ATM term...

Page 7: ...Installation Guide and Regulatory Notice for the board These and other supporting documentation including the Programmer s Manuals for the individual protocol modules are listed in Section 1 1 Related...

Page 8: ...8 1 Introduction...

Page 9: ...S7MD 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 So...

Page 10: ...PCI Express Form Factor Product DSI SS7MDL4 PCI Express form factor product line includes the following DSI SS7MDL440Q A low profile PCI Express form factor with 4 T1 E1 J1 ports supporting up to 124...

Page 11: ...te In order to monitor both directions of a signaling link the user must separately connect each direction of the signaling link to the receive connection of two different LIUs on the DSI SS7MDL4 boar...

Page 12: ...ormat T1 F4 D3 D4 ESF and F72 SLC96 E1 E1 and E1 CRC4 J1 J1 frame format Line codes T1 B8ZS and AMI E1 HDB3 and AMI J1 B8ZS and AMI Connector type RJ 48C 2 2 4 Protocol Resource Support When used in a...

Page 13: ...ion 17 W max 2 2 7 Airflow Requirements 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 distribute...

Page 14: ...SI SS7MDL4 board conforms International Declaration of Conformity See http www dialogic com declarations Country Specific Approvals See the Global Product Approvals list at http www dialogic com decla...

Page 15: ...ther the link is unconfigured or the board on which the link is currently active is reset The following table shows the available licenses The number of link resources required for each link type is s...

Page 16: ...the user 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 Run Mode LS...

Page 17: ...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 SPA...

Page 18: ...he same content and are applicable to all supported operating systems The contents of the User Part Development Package should be extracted onto the development machine retaining the sub directory str...

Page 19: ...Z file to the development system that is running Linux Note Be sure to copy the file with the uppercase Z extension that identifies the file as a compressed file 4 Extract the files using the command...

Page 20: ...building kernel modules is available This must include the appropriate kernel include files found at lib modules uname r build for example lib modules 2 6 18 92 1 22 el5 build If these include files...

Page 21: ...x configuration including the entry for the kernel msgmnb parameter 3 2 4 Removing the Development Package for Linux Prior to installing a new version of the Development Package for Linux the previous...

Page 22: ...ies GCT run time shared library and SYSTEM TXT and CONFIG TXT configuration files ss7dpk devel DPK ARCH rpm Development Package development files including header files and GCT link time shared librar...

Page 23: ...dpksol64 Z pkgadd d dpksol64 The Solaris package installation utility pkgadd then prompts for further input The pkgadd command requires you to be logged in as root On successful completion of the ins...

Page 24: ...e sys msg h The new values for these parameters should be set to at least the following values There may be other users of these resources so the actual value may need to be greater than the values sh...

Page 25: ...res This section gives an overview of these options You should also read the Software Environment Programmer s Manual that describes the basic principles of modules and message passing This chapter pr...

Page 26: ...compliant overall system The table below details some of the areas where the correct selection of configuration options may be required Table 4 Quick Reference to Commonly Configured Parameters Config...

Page 27: ...lize the system environment and start the other related processes running on the host deriving the configuration from a text file system txt ssdm Process to interface with the device driver for passin...

Page 28: ...SI 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 Host protocol software is available for Linux a...

Page 29: ...ss of system messages The gctload program initializes the message queue look up table so that messages destined for modules that do not exist locally are redirected to a message queue for a module tha...

Page 30: ...sed protocol modules and the s7_log utility For example LOCAL 0xcf s7_mgt Management config task LOCAL 0x2d upe Example user part task LOCAL 0x3d s7_log Prints messages to screen file LOCAL 0x22 MTP3...

Page 31: ...ry FORK_PROCESS commands are FORK_PROCESS ssdm FORK_PROCESS tim_lnx FORK_PROCESS tick_lnx For Solaris users the mandatory FORK_PROCESS commands are FORK_PROCESS ssdm FORK_PROCESS tim_sol FORK_PROCESS...

Page 32: ...mmand is described in Chapter 7 Configuration Command Reference The s7_mgt protocol configuration utility can optionally be configured to send a message to a nominated module on completion of the conf...

Page 33: ...ation 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...

Page 34: ...ial x16 x12 x5 1 When operating in monitoring mode the 3rd and successive identical frames may be filtered It is possible to configure monitoring and terminated SS7 links on the same signaling card 4...

Page 35: ...uild_out LIU_CONFIG 0 0 6 1 1 1 0 ATM_CONFIG options num_streams ATM_CONFIG 0x0000 4 ATM_STREAM id board_id cellstream_id liu_id options ima_frame_len max_frame_len def_vpi def_vci timeslot ATM_STREAM...

Page 36: ...ing MVD_MSG_SC_DRIVE_LIU and MVD_MSG_SC_LISTEN messages LIU_SC_DRIVE SCBUS_LISTEN and STREAM_XCON config txt commands 4 8 1 Switching Model The basic switching model assumes that at system initializat...

Page 37: ...ssage to the board This message contains the liu_id in the range 0 to one less than the number of LIUs the timeslot number on the T1 E1 J1 interface and the switch channel number sc_channel to which t...

Page 38: ...5 Interconnecting LIUs using STREAM_XCON Interconnection of two Line Interface Units LIUs on the board is also supported through the STREAM_XCON command which controls the cross connect switch on the...

Page 39: ...e monitored link set bit 0 in the flags field to 1 For example MONITOR_LINK 0 0 0 0 1 0xef 7 0x01 0xff 3 Configure the s7_log utility to display board and or host timestamp information See Section 8 1...

Page 40: ...stream is framed as for conventional SS7 For T1 8 bits in each of 24 timeslots are available for signalling For E1 timeslot 0 is used for framing and 31 timeslots are available for signaling The impl...

Page 41: ...ost chassis that the threshold has been passed a MGT_MSG_EVENT_IND message with a status field of 0xc0 Exceeded Thermal Threshold will be sent to SIU_MGT_TASK_ID 0xdf If the board stays above this thr...

Page 42: ...42 4 Dialogic DSI SS7MD Board Configuration and Operation...

Page 43: ...een installed Refer to Chapter 3 Installation The system txt configuration file has been modified correctly Refer to Section 4 4 System Configuration on page 29 The config txt protocol configuration f...

Page 44: ...vice driver is installed and running 2 Ensure that the protocol software is running on the host 3 Write your application making use of the examples supplied compile it using the header files supplied...

Page 45: ...o the directory containing all the SS7 binaries and running the gctload program optionally specifying the system configuration file with the c option a To run the system in the foreground enter gctloa...

Page 46: ...46 5 Program Execution...

Page 47: ...eiving a message from the board the application should call the GCT_get_instance library function to determine which board the message came from These library functions are described in the Software E...

Page 48: ...used on the DSI SS7MD Board Table 6 DSI SS7MD Board Software Module IDs Mnemonic Value Description MGMT_TASK_ID 0x8e SS7MD Board Management Module MVD_TASK_ID 0x10 SS7MD LIU and Switch Management Mod...

Page 49: ...ation Request MGT_MSG_L1_CONFIG Layer 1 Configuration Request MGT_MSG_L1_END Layer 1 Configuration End MGT_MSG_NTP_CONFIG Network Time Configuration 6 2 1 SSD_MSG_RESET SSD Reset Request Synopsis Sets...

Page 50: ...eads the binary format codefile and transfers it to the board The confirmation message if requested indicates success with a status value of 0 This implies that the reset operation has commenced but d...

Page 51: ...the same board the run mode indicates to the board the predominant link type Note It is only possible to activate protocols that have been licensed to run on the board by use of a suitable host licens...

Page 52: ...or their physical address see Section 8 7 1 Geographic Addressing on page 173 Parameters The SSD_MSG_BOARD_INFO message includes the following parameters board_id The board_id should be set to the lo...

Page 53: ...s level 1 configurations The physical link parameters are configured on a per link basis using the MGT_MSG_L1_CONFIG command The confirmation message if requested indicates success with a status value...

Page 54: ...a board after successful processing of the MGT_MSG_CONFIG0 message to configure the layer 1 links Note When using the s7_mgt protocol configuration utility this message is generated by s7_mgt and shou...

Page 55: ...n time options as follows Bit 0 Set to 1 to disable automatic FISU generation This is normally required for Japanese MTP operation only Bit 1 Set to 1 to enable onboard time stamping on monitored link...

Page 56: ...ling processor MGMT module by the host application to enable or disable timestamping specify the poll interval and communicate host NTP server module ID MESSAGE HEADER Field Name Meaning type MGT_MSG_...

Page 57: ...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_mana...

Page 58: ...uration file If dynamic control of the hardware is required or the user has elected not to use s7_mgt the user application must build and send at least some of the hardware control messages The messag...

Page 59: ...n message if requested indicates success with a status value of 0 Parameters A description of the permitted parameter values are given below When the board is initially configured the LIUs are initial...

Page 60: ...120 ohm balanced interface Value Description 1 HDB3 E1 only 2 AMI 4 B8ZS T1 J1 Value Description 1 E1 double frame E1 only 2 E1 CRC4 multiframe E1 only 3 F4 4 frame multiframe T1 only 4 D3 D4 Yellow a...

Page 61: ...ed values and their meanings clk_options A 16 bit value containing clocking options for the LIU This value provides the ability to override default LIU clocking options for each LIU Default options ar...

Page 62: ...f 0 Parameters The LIU_MSG_CONTROL message includes the following parameters ais_gen The mode used to generate the Alarm Indication Signal Blue alarm The following table shows the permitted values and...

Page 63: ...ent configuration parameters in the parameter area of the message Value Description 0 Do not change diagnostic loopback mode 1 Disabled remove any diagnostic loop 2 Payload loopback 3 Remote loopback...

Page 64: ...board configuration Format Description This message is sent to the board to reset the state of the digital cross connect switch MESSAGE HEADER Field Name Meaning type LIU_MSG_R_CONTROL 0x5e38 id liu_...

Page 65: ...bus stream connection Local bus to cross connect switch connection Duplex connection between cross connect switch and CPU local bus stream Duplex connection between local bus timeslots Attempting to u...

Page 66: ...ndicates that the parameter is required 1 indicates that CPU local bus stream values are invalid Local Stream Type Local Slot Range Local stream to E1 LIU 1 to 31 Local stream to T1 LIU 1 to 24 Local...

Page 67: ...arameters to specify both timeslots for disconnection 8 Remove a connection between a switch timeslot and a CPU local bus timeslot Then create a simplex connection between the same CPU local bus times...

Page 68: ...shows the permitted values and their meaning MESSAGE HEADER Field Name Meaning type MVD_MSG_SC_MULTI_CONNECT 0x7e19 id 0 src Sending module ID dst MVD_module_ID rsp_req May be used to request a confir...

Page 69: ...entifier of the T1 E1 J1 Line Interface Unit LIU in the range 0 to one less than the number of LIUs This parameter can be set to a value of a CPU local bus streams in the range of 0x90 upwards where t...

Page 70: ...C_LISTEN Cross Connect Switch Listen Request Synopsis Establish a connection from an cross connect switch channel to an outgoing timeslot on an T1 E1 J1 Line Interface Unit LIU Format Description This...

Page 71: ...ed to handle the MTP primitives as they pass directly between MTP3 and the user part module In the case that the user application is implementing the user part functionality the MTP primitives are app...

Page 72: ...ID 3 1 lower_id Reserved Must be set to 0 4 1 mgmt_id Module_id of management module 5 1 monitor_id Reserved Must be set to 0 6 2 max_SIF_len for example 62 or 272 8 2 cong_onset Congestion onset thre...

Page 73: ...he single congestion threshold mode of operation Congestion is indicated when the total number of messages in the transmit and retransmit buffers rises to this value cong_abate The congestion abatemen...

Page 74: ...of all indications issued to the upper module that is MTP3 For single signaling processor systems this is typically the same as the l2_llid However when a system contains more than one MTP2 processor...

Page 75: ..._MSG_RX_INDT message includes the following parameters Signaling Unit Data The Signaling Unit data in binary format excluding the Flags and Checksum UUI User to User Information parameter generated wh...

Page 76: ...on the specified link Parameters The API_MSG_TX_REQ message includes the following parameters Signaling Unit Data The Signaling Unit data in binary format excluding the Flags and Checksum commencing...

Page 77: ...parameters maj_rev Major revision identifier for the object being queried min_rev Minor revision identifier for the object being queried text Null terminated string giving textual module identity for...

Page 78: ...ion First message sent to the ATM module to initialize all the per module options Note This message must be sent once for each board Until this message has been received and returned with a zero statu...

Page 79: ...masks These bitmasks are required when the option bit is set for full configuration via 16 VCI masks one for each of up to 16 VPI values configured The default mask 0x01ff allows VCI values from 0 to...

Page 80: ...dded or removed from an active IMA bundle To increase the bandwidth available via an IMA bundle the bundle will have to be removed and re added The confirmation message if requested indicates success...

Page 81: ...tions This is the VPI that will be used for this connection The VPI must be available in the mask configured in the ATM_MSG_CONFIG message default vci A default AAL5 link will be configured for the ce...

Page 82: ...user to stop processing on a previously configured ATM cell stream Once successfully processed the link may be reconfigured The confirmation message if requested indicates success with a status value...

Page 83: ...rx_frames Number of valid AAL5 frames received on this cell stream rx_octets Number of data octets received on this cell stream rx_octets rx_discard_frames Number of received AAL5 frames discarded fo...

Page 84: ...rameters options upper_link_id Upper layer link identifier stream The cell stream to which we wish to attach upper_mod_id The recipient module ID for the monitored link MESSAGE HEADER FIELD NAME MEANI...

Page 85: ...anagement module API_MSG_RX_IND messages will be sent to the module ID indicated with the ID field set to the upper layer id AAL5 messages of length greater than the maximum configured for the underly...

Page 86: ...read Parameters The ATM_MSG_R_AAL_LINK_STATS has the following parameters period Period since last reset in units of 100 ms rx_frames Total number of valid frames received on the link CRC_errors Total...

Page 87: ...Description Sent by the ATM module when a stream becomes active or inactive MESSAGE HEADER Field Name Meaning type ATM_MSG_STREAM_STATE 0x026a id Cell Stream ID src ATM_Task_ID dst Management Module...

Page 88: ...n Sent by the ATM module when an AAL link becomes active or inactive MESSAGE HEADER Field Name Meaning type ATM_MSG_LINK_STATE 0x026b id link_id src ATM Module ID dst Management Module ID rsp_req 0 hc...

Page 89: ...n First message sent to the Q SAAL module to initialise all the per module options Note This message is to be sent once for each board by the SSDM module with the message Instance identifying the boar...

Page 90: ...ividual Q SAAL link and to cause the power up action defined in Q 2140 Q 2110 to be executed One such message must be issued to Q SAAL after the SS7_MSG_RESET message has been issued for each link to...

Page 91: ...s should be set to either 62 or 272 in accordance with Q 703 cong_onset The congestion onset threshold for use with the single congestion threshold mode of operation Congestion is indicated when the t...

Page 92: ...t to the upper_link_id Messages of length greater than the maximum configured for the underlying cell stream will be silently discarded A count of discards may be retrieved via an ATM stats request AT...

Page 93: ...st be received otherwise the link has failed Timer_poll Poll timer interval Timer_idle Maximum Idle phase time of an SSCOP connection Timer_T1 Time between link release and link re establishment durin...

Page 94: ...Format Description Sent by the user to deactivate a link remove its connection from the underling ATM cell stream and release its resources link_id Identifier for this link MESSAGE HEADER Field Name M...

Page 95: ...trace message to be sent to the management module whenever a message is issued by Q SAAL Care should be taken when tracing messages because the system throughput may be reduced The fields in the trac...

Page 96: ...STATE state change indications and MGT_MSG_SS7_EVENT Q 791 event indications Bit 15 Bit 14 Bit 13 Bit 12 Bit 11 Bit 10 Bit 9 Bit 8 0 0 FLUSH LPO CLRD LPO RTVL REQ RTV BSNT EMGCY CLRD Bit 7 Bit 6 Bit 5...

Page 97: ...e written into the parameter area of the message and the message is returned to the sender Parameters lsc_state Current Link State control state cong_status Current congestion status num_msgs Total nu...

Page 98: ...SK_ID rsp_req 0 hclass 0 status 0 leave stats unchanged 1 reset stats after reading err_info 0 len 58 PARAMETER AREA Offset Size Name 0 4 insvc_duration Duration of link in service state 4 2 align_fai...

Page 99: ...stamp len 0 Value Mnemonic Description 0x00 SCF_STOP User requested disconnect 0x01 SCF_PROF Incompatible profile parameter 0x02 SCF_SESA Session is already active 0x03 SCF_DUP Session ID already used...

Page 100: ...g type MGT_MSG_SS7_STATE 0x0201 id Link ID src QSL_TASK_ID dst Management module ID rsp_req 0 hclass 0 status Link State see below err_info Timestamp len 0 Value Mnemonic Description 1 IN_SERVICE Ente...

Page 101: ...OUT_SVC Out of Service Indication AAL OUT_OF_SERVICE SS7_MSG_RXD_BSNT BSNT Indication extended version AAL BSNT API_MSG_RTVD_MSG Retrieved Message Indication AAL RETRIEVED_MESSAGES SS7_MSG_RTVL_COMPL...

Page 102: ...dication MGT_MSG_NTP_SYNC Timestamping Resynchronization Indication 6 7 1 MGT_MSG_EVENT_IND Error Indication Synopsis Message issued by SSD to advise management of errors or events occurring within th...

Page 103: ...re encoded in the parameter area of the trace message MESSAGE HEADER Field Name Meaning type MGT_MSG_TRACE_EV 0x0003 id 0 src generating module_id dst management module id rsp_req 0 hclass 0 status 0...

Page 104: ...following table shows the possible event_type values event_type Parameter The message parameters are board_type Set to 16 for SS7MD failure_code MESSAGE HEADER Field Name Meaning type SSD_MSG_STATE_IN...

Page 105: ...t i0x2d Note It is recommended that the user invoke this option then wait for an API_MSG_CNF_IND message to ensure that the application does not attempt to send messages until initial configuration is...

Page 106: ...llowing table shows the possible values and their meanings MESSAGE HEADER Field Name Meaning type MVD_MSG_LIU_STATUS 0x0e01 id liu_id in the range 0 to one less than the number of LIUs src MVD_module_...

Page 107: ...following field EVENT CODE The event that has just occurred The following table indicates the possible values and their meanings MESSAGE HEADER Field Name Meaning type MGT_MSG_SS7_EVENT 0x0202 id l2_l...

Page 108: ...YNC message is used to notify the host about step time updates Parameters The MGT_MSG_NTP_SYNC message contains the following parameters Adjustment timer integer A 4 byte value containing the number o...

Page 109: ...ead the current operating state of a Line Interface Unite LIU The user should always request a confirmation message The confirmation message indicates success with a status value of 0 and contains the...

Page 110: ...ly or daily read and reset the statistics and store the resulting information so that it can be accessed later for generation of performance reports for the line interface Parameters The LIU_MSG_R_STA...

Page 111: ...mber of frame slips that have occurred on the interface oos_transitions A count of the number of transitions from the in synchronization state to the out of synchronization state errored_seconds The n...

Page 112: ...ard_rev The board revision number Currently 0 lsn The board s production serial number ASCII characters null terminated current_temp Signed 8 bit value containing the current temperature of the board...

Page 113: ...too long or too short for a configured protocol rx_overrun The number of times that the receiver was forced to discard incoming frames as a result of there being no internal buffers available to rece...

Page 114: ...mechanism rx_pre_filter_cnt The total number of error free frames received on the link including any duplicate frames that are discarded as a result of the internal filtering mechanism tx_frame_cnt Th...

Page 115: ...TS 0x2215 Confirmation of SS7_MSG_R_STATE 0x1e39 Confirmation of LIU_MSG_R_STATE 0x3200 Confirmation of SS7_MSG_RESET 0x3203 Confirmation of SS7_MSG_CONFIG 0x3267 Confirmation of QSL_MSG_CFG_LINK 0x32...

Page 116: ...ET SSD Reset Request 0x7681 SSD_MSG_RST_BOARD Board Reset Request 0x7689 SSD_MSG_BOARD_INFO Board Information Request 0x7e00 MVD_MSG_RESETSWX Reset Switch Request 0x7e17 MVD_MSG_SC_LISTEN Cross Connec...

Page 117: ...orm one time configuration of the protocol stack at startup The commands are logically grouped in the following categories Physical Interface Configuration Commands Monitor Configuration Commands MTP...

Page 118: ...ds The physical interface configuration commands are SS7_BOARD Configure Dialogic DSI SS7MD Network Interface Board LIU_CONFIG Configure a T1 E1 J1 LIU LIU_SC_DRIVE Set Up Path Between LIU SCBUS_LISTE...

Page 119: ...t board types The bits have the following significance Bit 0 is set to 1 to recover the clock from the LIU 0 use internal clock All other bits are reserved and should be set to 0 code file The name of...

Page 120: ...rc_mode The CRC mode The following table shows the permitted values and their meanings Value Description 1 Disabled used to deactivate an LIU In this mode the LIU does not produce an output signal 3 E...

Page 121: ...e 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...

Page 122: ...s_mask is connected to the switch other timeslots are not affected Typically the mask should be set to include all bearer voice timeslots but no signaling timeslots Bit 0 corresponding to timeslot 0 o...

Page 123: ...31 23 Parameters The SCBUS_LISTEN command includes the following parameters 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 i...

Page 124: ...be a valid LIU at this position previously defined by a LIU_CONFIG command Valid values are stream_b A reference to the 2 Mb s stream for the input of a simplex connection mode 2 or one half of a dup...

Page 125: ...and 17 to 31 between the two ports on each signaling board by setting the ts_mask value to 0xfffefffe T1 J1 interfaces have 24 timeslots numbered 1 to 24 To cross connect all the timeslots on a T1 int...

Page 126: ...126 7 Configuration Command Reference 7 2 Monitor Configuration Commands The monitor configuration command is MONITOR_LINK Configure Link in Monitoring Mode...

Page 127: ...0x00 TDM ATM Links MONITOR_LINK link_id board_id blink atm_stream vpi vci user_module filter flags phys_mask data_rate Example MONITOR_LINK 0 0 0 0 8 100 0x0d 0 0x0000 0x00 ATM Common Parameters The M...

Page 128: ...ure use ATM Link Parameters board_id The logical identity of the board in the range from 0 to one less than the number of boards supported This should be the same value as used in the ATM_STREAM comma...

Page 129: ...ation point code contained in the message or 0 to allow the discrimination function to operate normally Bit 1 is set to 1 to disable sub service field SSF discrimination If this bit is set to 0 each r...

Page 130: ...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 to 0 All other bits are reserved...

Page 131: ...se to specify runtime options Currently no options are defined therefore the parameter must be set to 0 local_spc The point code of the signaling point itself ssf The value to be used in the Sub Servi...

Page 132: ...is 0 to 15 flags A 32 bit value containing additional run time options The bit significance is as follows Note If the data_rate is set to ATM only bits 0 to 2 are significant Bit 0 is set to 1 to forc...

Page 133: ...face 1 to 24 For an E1 interface 1 to 31 For a J1 interface 1 to 24 For HSL operation 0xff Data rate is set using the optional data rate parameter if not present data rate defaults based on LIU type T...

Page 134: ...nd linkset used to reach the specified destination This may be either of the following options The secondary linkset used to reach the destination only on failure of the preferred linkset One of a pai...

Page 135: ...ion command in the config txt protocol configuration file Syntax MTP_USER_PART si module_id Example MTP_USER_PART 0x0a 0x2d Parameters The MTP_USER_PART command includes the following parameters si Th...

Page 136: ...iguration Command Reference 7 4 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...

Page 137: ...00 4 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 Bit 0 Use ATM Forum Idle cell...

Page 138: ...MA is not active the parameter identifies the LIU to be used options A 16 bit value containing additional options for the ATM link The bit significance is as follows Bit 0 Enable payload scrambling Bi...

Page 139: ...he VCI that will be used for this connection Values 0 3 and 4 are reserved and should not be used Note The default VPI VCI combination configured here must not be specified for any AAL5 link on this c...

Page 140: ...rved for future use and should be set to zero timer_id The identifier of the timer to be changed It should be set to one of the following values CC KEEP_ALIVE NO_RESP POLL IDLE T1 T2 T3 value The time...

Page 141: ...ISUP Configure Request message as detailed in the ISUP Programmer s Manual num_grps The maximum number of ISUP circuit groups that the user intends to use This must not exceed the maximum number of c...

Page 142: ...t always be set since it represents the base_cic base_cid Subsequent bits represent the subsequent circuits ANSI circuit groups are not permitted to contain more than 24 circuits options A 32 bit valu...

Page 143: ...o be configured The supported set of timer mnemonics is shown in the table below value The timer value in seconds except T29 and T30 that are in multiples of tenths of a second 100 ms Any timers not e...

Page 144: ...age as detailed in the TUP Programmer s Manual num_grps The maximum number of TUP circuit groups that the user intends to use This must not exceed the maximum number of circuit groups supported otherw...

Page 145: ...group It must be in the range 0 to one less than the number of circuits supported cic_mask A 32 bit mask with bits set to indicate which circuits are to be allocated to the circuit group Bit 0 must a...

Page 146: ...oint code ssf The sub service field value that SCCP uses when exchanging messages with the MTP This value must always be set so that the Network Indicator bits the two most significant bits of the 4 b...

Page 147: ...for each bit is as defined for the options parameter described in the Configure Sub System Resource Request section of the SCCP Programmer s Manual module_id The module identifier of the user applica...

Page 148: ...ing parameters id A unique ID cssr_id The ID of the subsystem that will receive the notifications ssr_id The ID of the sub system for which state changes will be issued 7 7 4 SCCP_TRACE SCCP Trace Syn...

Page 149: ...ght order that is the pairs of digits are not swapped as is the case for a BCD string In addition to hexadecimal digits this string can contain the following characters 7 7 6 SCCP_GTT_ADDRESS Define G...

Page 150: ...d backup addresses referenced by this command must all have an identical number of sections Syntax SCCP_GTT pattern_id mask primary_address_id backup_address_id Example SCCP_GTT 5 R K 9 Parameters The...

Page 151: ...ies the SCCP_GTT_ADDRESS command to use as the backup translation Mnemonic Function Padding ignored Separator used to split the mask into sections K or KEEP The digits in the corresponding section of...

Page 152: ...ost number which should be unique across hosts rsi_status_user_id Module ID to forward RSI link status messages to 7 8 2 DTC_SSR DTC Sub System Resource Synopsis The DTC_SSR command configures a local...

Page 153: ...rogrammer 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 e...

Page 154: ...x0000 0 Parameters The TCAP_CONFIG command includes the following parameters base_ogdlg_id The dialogue_id for the first outgoing dialog nog_dialogues The number of outgoing dialogs to support The val...

Page 155: ...000 1024 0 0 Parameters The TCAP_CFG_DGRP command includes the following parameters gid A logical identifier for this group The valid range is 0 to 31 base_ogdlg_id The first outgoing dialog ID assign...

Page 156: ...e whenever 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_mask Example TCAP_TRACE 0x7 0xf 0x0 Parameters Th...

Page 157: ...ple MAP_CONFIG 2 Parameters The MAP_CONFIG command includes the following parameters options Specifies MAP protocol options as defined for the MAP Configuration Request message in the MAP Programmer s...

Page 158: ...nopsis This command is used to configure the INAP functional entity records for operation These allow the user application to refer to Functional Entities FEs in the network via a local reference rath...

Page 159: ...l incoming dialogs Syntax INAP_AC ac_ref ac Example INAP_AC 0x00 0xa109060704000101010000 Parameters The INAP_AC command includes the following parameters ac_ref A logical identifier for this Applicat...

Page 160: ...IS41 to send trace messages to the trace module whenever a specific message type is sent or received See the IS41 Programmer s Manual for details Syntax IS41_TRACE op_evt_mask ip_evt_mask non_prim_mas...

Page 161: ...SI 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...

Page 162: ...h bit that is set to 1 enables reporting of a particular message group or parameter field as described in the following table Bit Function 0 Enable text interpretation of all recognized messages 1 Dis...

Page 163: ...pecify a maximum log file size of between 1 kilobyte and 100 000 kilobytes If this option is not specified the maximum log file size is set to 1000 kilobytes by default When the maximum log file size...

Page 164: ...ages 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 fi...

Page 165: ...m txt file and must not be in use by any other process on the host f filename Specifies the text file that contains the commands to be executed by the s7_play utility Example To run s7_play with modul...

Page 166: ...response as set in the f field is the same as the module ID for the s7_play module as set in the command line otherwise the response will not reach the s7_play The Wait Message Response function P ca...

Page 167: ...also have to be increased to ensure stable operation See Section 3 2 3 Support for a Large Number of DSI Messages on page 21 Ci congestion module id Specifies the congestion handling module ID If thi...

Page 168: ...essages indicates that there is a problem for example messages may be being sent to a non existent queue or no process in the system is reading from the associated destination queue The behavior of th...

Page 169: ...be empty or contain a small number of messages If this is not the case this may be due to one of the following reasons No module has been configured to read messages for the listed destination queue T...

Page 170: ...er 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 v Show...

Page 171: ...s 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 utility supports the following command line options...

Page 172: ...on k config file Specifies the SS7 configuration file The default is config txt m module id Specifies the unique module ID that is assigned to s7_mgt for the Inter Process Communication IPC environmen...

Page 173: ...rmation a addressing mode Defines the geographic addresses to map to board identifiers Each address should be comma separated The first address will map to ID 0 the second to ID 1 etc See Section 8 7...

Page 174: ...board s physical address see below Under certain circumstances for example to determine the serial number of a new card added to the system which as yet does not have a valid mapping in the system tx...

Page 175: ...n the system and will print a line to the standard output and to any log file defined on the command line YYYY MM DD HH MM SS board 0 temperature board 1 temperature board 2 temperature board 3 temper...

Page 176: ...ation 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 36 2009 06 02 10 36 15 35 37 35 36 2009 06 02...

Page 177: ...ins the address or identifier of the board and the name of the codefile It causes the board to be reset and the codefile downloaded For each board the application should wait until a Board Status Indi...

Page 178: ...of links in the link set See the MTP3 Programmer s Manual for the message definition Wait for the confirmation message and check the status 11 For each destination that needs to be accessed including...

Page 179: ...peated per Link MGT_MSG_L1_CONFIG 0x7f17 LIU_CONFIG0 0x7e34 SS7_MSG_CONFIG 0x7203 0x3203 0x3300 MTP_MSG_CONFIG 0x7303 0x3303 MTP_MSG_CNF_LINK 0x7311 0x3311 MTP_MSG_CNF_LINKSET 0x7310 0x3310 MTP_MSG_CN...

Page 180: ...rd parameters When using DSI SS7MD Boards the value of the config_type parameter in the Board Configuration Request must be set to 3 For this version of the message the automatic configuration of MTP...

Page 181: ...ule and check the status For each ATM cell stream in the system 6 Build and send an ATM cell stream configuration request ATM_MSG_CFG_STREAM to set up the parameters of the ATM link Wait for the confi...

Page 182: ...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 i...

Page 183: ...wise specified To help determine if your chassis provides sufficient airflow to accommodate an SS7MDL4 board please confirm that Exterior inspection reveals visible air vents in front and at the back...

Page 184: ...184 Appendix B Thermal guidelines for selecting suitable servers for use with a Dialogic DSI SS7MDL4 Network In terface Board...

Page 185: ...face Unit LFM Linear Feet per Meter LSL Low Speed Link conforming to the specification in Q 703 MAP Mobile Application Part MAP An SS7 stack layer supporting messages sent between mobile switches and...

Page 186: ...he selection of an outgoing link for messages being routed to another point code SS7 Signaling System Number 7 SS7 Protocol Stack A set of software modules that implement the various layers of the SS7...

Page 187: ...CP_CONFIG 146 SCCP_GTT 150 SCCP_GTT_ADDRESS 149 SCCP_GTT_PATTERN 149 SCCP_SSR 147 SCCP_TRACE 148 SS7_BOARD 119 STREAM_XCON 124 TCAP_CFG_DGRP 155 TCAP_CONFIG 154 TCAP_TRACE 156 TUP_CFG_CCTGRP 145 TUP_C...

Page 188: ...on 39 host interface DSI SS7MDL4 boards 11 host utilities 161 I identifiers DSI SS7MD Network Interface Board DSI SS7MDL4 Network Interface Board DSI SS7MDL440Q Network Interface Board 10 INAP configu...

Page 189: ...C_LISTEN 70 MVD_MSG_SC_MULTI_CONNECT 68 SS7_MSG_CONFIG 72 SSD_MSG_BOARD_INFO 52 SSD_MSG_RESET 49 SSD_MSG_RST_BOARD 50 SSD_MSG_STATE_IND 104 MGT_MSG_CONFIG0 message 53 MGT_MSG_L1_CONFIG message 54 MGT_...

Page 190: ...4 boards environmental specification 13 SSD_MSG_BOARD_INFO message 52 SSD_MSG_RESET message 49 SSD_MSG_RST_BOARD message 50 SSD_MSG_STATE_IND message 104 ssdh utility 173 ssdm utility 173 static initi...

Page 191: ...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...

Reviews: