TSP Lab Sga-HLRQuery2 - The HLR Query module Sga-HLRQuery2

The HLR Query module
("Sga-HLRQuery2")

Features

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 occurrence of text in log window
  Details   Detail level of logging (Off, Normal, Detailed, or Debug)
[Client connections]
  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 (Sga_HLRQuery2.ini) file

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
  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!)
[SS7]
  sLocalGT 36509489931F The SS7 Global Title of the module (ClgPA/GT in this module initiated BEGIN messages)
  sFakeGT 36509489931F This value will be used as the originating SC-address in SRI4SM and ForwardSM BEGIN messages (sm-rp-OA)
[SS7 over GyX]
  sRemoteIPAddress 127.0.0.3 IP address of GyX_SCTP module
  wRemoteTCPPort 9068 TCP port of GyX_SCTP
  wConnectRetryDelaySec 3 Period of attempts to reconnect
[Client Connections]
  wMaxConcurrentConnectionCount 25 Maximum number of connections made by remote modules
  wLocalTCPPort 3000 Port number, where the remote modules can connect
  127.0.0.1 Allowed Client with this IP address can connect to the Sga-HLRQuery2 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.
[Voice Mail MSISDN]
  36709090999F Voice mail MSISDN of VM service used to decide whether a "call forwarding" is to voice mail or not.
Note: the text after the equal sign is mandatory.
[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)
  sSS7FilesPath 100 If this entry has a valid path then the application saves sent and received SS7 messages into a special message file (*.dsp) which can be viewed with "Sga7w" protocol decoder. This option is useful during the installing/testing process, in normal operation is not needed. To turn off this option the path should be deleted (set "sSS7FilesPath=").

SNMP trap list

UID Type Text Remarks To Do
If bAlternateTrapUID is set to TRUE
9 CEA 'Sga-HLRQuery2 v0.91' module is started. Send a welcome message; indication of module start-up  
9 CRI 'Sga-HLRQuery2 v0.91' module has been shut down by operator. Send a farewell warning message; indication of module shut-down Start the 'Sga-HLRQuery2 v0.91' module
90 CEA GyX: Connection to remote module established.    
90 CRI GyX: Connection to remote module is lost.   Check the state of GyX module.
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.
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 Client connections are available. No CEA is related
More than INI/[Client connections]/wMaxConcurrentConnectionCount connection try to be established
Increase value of that configuration entry
If bAlternateTrapUID is set to FALSE
0 INF 'Sga-HLRQuery2 v0.91' module is started. Send a welcome message; indication of module start-up  
0 WAR 'Sga-HLRQuery2 v0.91' module has been shut down by operator. Send a farewell warning message; indication of module shut-down Start the 'Sga-HLRQuery2 v0.91' module
++N INF GyX: Connection to remote module established. When GyX connection is up first  
++N CRI GyX: Connection to remote module is lost.   Check the state of GyX module.
N CEA GyX: Connection to remote module established. When GyX connection is up after a disconnection  
++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