TSP Lab SgaSS7_L5 - The SS7-over-IP (SigTran) interface handler SgaSS7_L5

The SS7-over-IP (SigTran) interface handler module
("SgaSS7_L5")

Features

Basic operation

User interface

The main menu

Menu Menuitem Shortcut(s) Meaning
[Log]
  Find line containing... (Ctrl-F) Finds text in log window
  Find next matching line (F3) Finds next occurence of text in log window
  Details   Detail level of logging (Off, Normal, Detailed, or Debug)
[SCTP]
  A: Allow auto-connecting (left-side ) Allows automatic (re-)connecting to the SCTP server on association A
  A: Shutdown now!   Immediately disconnects association A
  B: Allow auto-connecting (right-side ) Allows automatic (re-)connecting to the SCTP server on association B
  B: Shutdown now!   Immediately disconnects association B
[Connection]
  Disconnect *all* active ones   Shutting down of all active connections
  Zero counters of *all* connections   Request and answer counters of connections will be cleared (on the Connections window)
[Options]
  Auto scroll (ScrollLock, or ) Allows automatic scrolling of the log screen
  Show log (Ctrl-Tab) Show the log screen
  Show connections (Ctrl-Tab) Show the connection screen
  Save settings   Saves actual settings into the configuration (INI) file
[Debug] Items in this menu are only for debug and test purposes!
  A: Send an ASPsm/ASPUP message   Sends an "ASP state maintenance/ASP up" message on association A
  A: Send an ASPtm/ASPAC message   Sends an "ASP traffic maintenance/ASP active" message on association A
  A: Send an SS7snm/DAUD(remotePC) messages   Sends an "SS7 signaling network maintenance/Destination state audit" message using INI/[SS7]/wRemotePointCode_A as the "Affected point code"
  B: Send an ASPsm/ASPUP message   Sends an "ASP state maintenance/ASP up" message on association B
  B: Send an ASPtm/ASPAC message   Sends an "ASP traffic maintenance/ASP active" message on association B
  B: Send an SS7snm/DAUD(remotePC) messages   Sends an "SS7 signaling network maintenance/Destination state audit" message using INI/[SS7]/wRemotePointCode_B as the "Affected point code"
  Send a T/DATA/SS7/SST(remotePC,1) message   Sends an "SS7/Subsystem status test" message with SubSystemNumber=1 using INI/[SS7]/wRemotePointCode_A as the "Affected point code"
  Send a T/DATA/SS7/SST(remotePC,HLR=6) message   Sends an "SS7/Subsystem status test" message with SubSystemNumber=6 using INI/[SS7]/wRemotePointCode_A as the "Affected point code"
  Send a T/DATA/SS7/SST(remotePC,VLR=7) message   Sends an "SS7/Subsystem status test" message with SubSystemNumber=7 using INI/[SS7]/wRemotePointCode_A as the "Affected point code"
  Send a T/DATA/SS7/SST(remotePC,MSC=8) message   Sends an "SS7/Subsystem status test" message with SubSystemNumber=8 using INI/[SS7]/wRemotePointCode_A as the "Affected point code"

Status-line of SS7 links

The bottom status-line

Details of connections window

The popup menu of the connections screen

Right-click on a row on the connections screen window to access this menu!
  Menuitem Shortcut(s) Meaning
  Disconnect this connection   Disconnects selected client connection
  Forget pending request   Forgets last request received from client
  Reply "Software malfunctioning"   Answers received request with "Software malfunctioning" cause value (-3)
  Zero counters of this connection   Zeros Request and Answer counters for this connection
  Send a test MSU for this connection   (Not available in this version)

Configuration (INI) file settings

Section Entry Example Meaning
[Position]
  iLeft 140 Position of the program module on the display screen
  iTop 72 Position of the program module on the display screen
  iWidth 995 Position of the program module on the display screen
  iHeight 694 Position of the program module on the display screen
[Options]
  bAutoScroll True (Refer to the [Options]/Auto scroll menu item!)
[SCTP]
  wAutoConnectIntervalSec 2 Period for automatic connection of SCTP associations
  bAllowAutoConnectAtStartup_A True (Refer to the [SCTP]/A: Allow auto-connecting menu item!)
  bAllowAutoConnectAtStartup_B True (Refer to the [SCTP]/B: Allow auto-connecting menu item!)
  sLocalIPAddress#N 10.0.123.10 Local IP addresses for SCTP connections.
If more IP addresses are listed then multiple paths are used in associations (MultiHoming).
N runs from 0 to 9.
  sRemoteIPAddress_A#1, sRemoteIPAddress_A#2 10.0.123.20, 10.0.123.21 Alternative IP Addresses of the SCTP server A.
  sRemoteIPAddress_B#1, sRemoteIPAddress_B#2 10.0.124.20, 10.0.124.21 Alternative IP Addresses of the SCTP server B.
  wRemoteSCTPPort_A 2905 SCTP port of the SCTP server A
  wRemoteSCTPPort_B 2905 SCTP port of the SCTP server B
  wLocalSCTPPort 2905 Optional parameter if the SCTP server sticks to a given port. Normally, it should not be used.
  wHeartbeatIntervalSec 10 SCTP/HEARTBEAT period
  dwMaxRTOmsec 15000 Retransmission Timeout value in milliseconds
  dwMaxRetransmitsPerInit 3 Maximum number of retransmission for INIT chunks
  dwMaxRetransmitsPerAssociation 9 Maximum number of retransmissions per association
  dwMaxRetransmitsPerPath 4 Maximum number of retransmissions per path
  byIPfieldDSCP 16 Default value of DSCP field of IP protocol level can be overwriten by this value.
Please note: this feature should also be enabled in Windows operating system by modifying the related registry entry!
[SS7]
  wRemotePointCode_A 201 The point code of the remote SS7 device on association A
  wRemotePointCode_B 201 The point code of the remote SS7 device on association B
  wLocalPointCodeNI2 13 Local point code, when NI parameter is 2 in SCCP layer
  wLocalPointCodeNI3 200 Local point code, when NI parameter is 3 in SCCP layer
  szSS7LocalGT 36509489931F The SS7 Global Title of the module (ClgPA/GT in this module initiated BEGIN messages)
  szSS7FakeGT 36509489931F This value will be used as the originating SC-address in SRI4SM and ForwardSM BEGIN messages (sm-rp-OA)
  szSS7gsmSCFAddress 36509489931F The gsmSCFAddress field in the Invocation of AnyTimeInterrogation will be set with this value
  bySS7smsSCTSTZ 0x00 TimeZone of ServiceCenter parameter (TP-SCTS/TZ) can be adjusted. (Its value is interpreted as specified in GSM 03.40; can be set either as decimal or hexadecimal, defaults to 0x00.
bySS7smsSCTSTZ=999 is treated as "set ForwardSM/Deliver/SCTS/TZ field automatically".)
  bDontAbortAtAbort False If True the incoming TCAP/ABORT answer immediately causes sending of an abort for the corresponding client request.
If False the module will wait the preset time-out (dwRequestValiditySec irrespectively of the ABORT answer.
  dwRequestValiditySec 900 The module is waiting until this time for the answer for an SS7 request
[RemoteRequest]
  wMaxConcurrentConnectionCount 25 Maximum number of connections made by remote modules
  wLocalTCPPort 3000 Port number, where the remote modules can connect
  bSuppressDisconnectTrap True When it is true traps on disconnecting connections are suppressed
  127.0.0.1 Allowed Client with this IP address can connect to the SgaS7_L4 module This section may contain more IP address entries as a white list; those that are not listed will get barred (refused) silently, i.e., w/o trap, but still logged.
[Advanced]
  wLogDetailLevel 3 (Equals to the listed order; refer to the [Log]/Details menu item!)
  dwMaxLinesInLogWindow 1000 Number of lines in the log window on screen
  sLogFilesPath d:\LogFiles Path for the LOG files
  sTrapFilesPath d:\TrapFiles Path for the SNMP Trap files to be sent
  bAlternateTrapUID False Allows using fixed UIDs in SNMP traps (See SNMP trap list below for details)
  wThreadPeriod 100 Time period when idle threads are given CPU time slice (given in milliseconds)

SNMP trap list

UID Type Text Remarks To Do
If bAlternateTrapUID is set to TRUE
9 CEA 'Sga-SS7/L5 v2.01' module is started. Send a welcome message; indication of module start-up  
9 CRI 'Sga-SS7/L5 v2.01' module has been shut down by operator. Send a farewell warning message; indication of module shut-down Start the 'Sga-SS7/L5 v2.01' module
90 CEA SCTP(A) connection is up.    
90 CRI SCTP(A) connection has died. Connection is down; indicating SCTP problem at either end Check if the point codes are correct or the other side device works properly
90 CRI SCTP(A) connection has died. (operator) Connection is down. Operator has executed the [SCTP]/Shutdown now! menu item. Set SCTP(A) auto-connecting to be true ([SCTP]/A: Allow auto-connecting menu item)
91 CEA SCTP(B) connection is up.    
91 CRI SCTP(B) connection has died. Connection is down; indicating SCTP problem at either end Check if the point codes are correct or the other side device works properly
91 CRI SCTP(B) connection has died. (operator) Connection is down. Operator has executed the [SCTP]/Shutdown now! menu item. Set SCTP(B) auto-connecting to be true ([SCTP]/B: Allow auto-connecting menu item)
92 INF TCP connection #... is up.    
92 ERR/CEA TCP connection #...: Received ... bytes of illegible request - dropping connection. Illegal request has been received Check if the remote module works properly or the TCP connection is reliable. Possibly an illegal connection was made up.
92 ERR/CEA TCP connection #...: Received request with bad MagicCode - dropping connection. Illegal request has been received Check if the remote module works properly or the TCP connection is reliable. Possibly an illegal connection was made up.
92 ERR/CEA TCP connection #...: Received ... bytes of illegible request - dropping connection. Illegal request has been received Check if the remote module works properly or the TCP connection is reliable. Possibly an illegal connection was made up.
92 ERR/CEA TCP connection #...: Received request with bad MagicCode - dropping connection. Illegal request has been received Check if the remote module works properly or the TCP connection is reliable. Possibly an illegal connection was made up.
92 ERR/CEA TCP connection #... closed by the remote side. Only if INI/[RemoteRequest]/bSuppressDisconnectTrap=False
When the remote module shuts the connection down 		 
92 ERR/CEA TCP connection #... closed by operator. Only if INI/[RemoteRequest]/bSuppressDisconnectTrap=False
When the operator disconnects using Disconnect this connection menuitem 		 
93 WAR TCP connection #...: Answer (for [OPERATION_CODE]) timed-out. No CEA is related
When an answer does not arrive or arrive later than INI/[SS7]/dwRequestValiditySec 		Check parameters of the request
94 WAR Received an unexpected MSU, or its format is unknown. Badly formatted MSU or the of the arrived MSU is not recognized Check if the MSU traffic directed to this device is addressed and formatted properly
95 CRI No more TCP connections are available. No CEA is related
More than INI/[RemoteRequest]/wMaxConcurrentConnectionCount connection try to be established 		Increase value of that configuration entry
If bAlternateTrapUID is set to FALSE
0 INF 'Sga-SS7/L5 v2.01' module is started. Send a welcome message; indication of module start-up  
0 WAR 'Sga-SS7/L5 v2.01' module has been shut down by operator. Send a farewell warning message; indication of module shut-down Start the 'Sga-SS7/L5 v2.01' module
0 INF SCTP(A/B) connection is up. Connection A/B is up for the very first time; subsequent ones are indicated with the corresponding CEA  
++N CRI SCTP(A/B) connection has died. Connection A/B is down; Check the connection
++N CRI SCTP(A/B) connection has died. (operator) Connection A/B is down; Try to set auto-connecting to be true to enable the connection ([SCTP]/(A|B): Allow auto-connecting menuitem)
N CEA SCTP(A/B)/MTP2 connection has died. When connection A/B is up after a down  
0 INF TCP connection #... is up. Given TCP connection is up for the very first time; subsequent ones are indicated with the corresponding CEA  
++N ERR TCP connection #... closed by the remote side. Given TCP connection is down; other side closed the connection  
++N ERR TCP connection #... closed by operator. Given TCP connection is down; operator closed the connection  
N CEA TCP connection #... closed. TCP connection #... is up after a down  
++N CRI No more TCP connections are available. All available connections have already been in use; a new one has just been refused Check and increase value of INI/[RemoteRequest]/wMaxConcurrentConnectionCount entry
++N ERR TCP connection #...: Received ... bytes of illegible request - dropping connection. Illegal request has been received Check if the remote module works properly or the TCP connection is reliable. Possibly an illegal connection was made up.
++N WAR TCP connection #...: Answer (for [OPERATION_CODE] timed-out. TCAP dialog with MAP operation has not finished within the time-out interval (INI/[SS7]/dwRequestValiditySec) Check parameters of the message

Version history