TSP Lab	Sga-PSLquery - The Provide Subscriber Location query module	Sga-PSLquery

The Provide Subscriber Location query module
`("Sga-PSLquery")`

Features
User interface
Logging
Configuration
SNMP alarm list
Version history

Features

Connects to the signaling network using SCTP/IP connection via the SigTran interface module
Acts as an active element of the SS7 network
Receives query requests from PSLquery clients
Sends MAP/ProvideSubscriberLocation_Invocation messages to the given VLR
Forwards result to the PSLquery clients
Logs queries and responses
Provides simple statistical data and logging on the operation
Creates SNMP traps

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	()	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-PSLquery.ini`) file

The bottom status-line

GyX: Status of the connection to the signaling interface module (its color is gray in normal works, red refers to error)
- bps: Current transfer speed
- Rx OK/Fail: All received right and failed messages
- Tx OK/Fail: All transmitted right and failed messages
Uptime: Time elapsed since module has been started up
BEGIN: Number of emitted MAP/PSL_Inv messages
END:
- OK: Number of MAP/PSL_Res messages
- —: Number of empty END messages
- Err: Number of MAP errors and rejects
ABORT: Number of TCAP/ABORT messages
TCAP failure: Number of TCAP decoding problems

Details of connections window

ID: Identifier of the connection
Alive: This connections is alive if + (there is a connection)
IP Address: IP address of the client
Req.count: Number of received requests
Answ.count: Number of answered requests
Last request: Timestamp of last request
Last answer: Timestamp of last answer
Request TID: Transaction ID of the request
Answer TID: Transaction ID of the answer

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
	Reply "Software malfunctioning"		Sends an error to the client
	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)

Logging

The module creates daily logfiles about its working. The name of the logfile is "Modulename_YYYYMMDD.log" reflecting the day when it is created.
The module can write information into the logfile and onto the screen with several detail levels set by the [Log]/Details menu item. The logging level can be:

Off (0) - warnings/errors are only reported (minimal logfile size and CPU usage)
Normal (1) - information about normal operation are also written into the logfile/screen
Detailed (2) - every received and sent signaling messages are logged
Debug (3) - hexadecimal information of messages is recorded (largest logfile and CPU usage)
Debug, no screen (4) - it puts the same logging information into the logfiles as the Debug level, while the screen is not used to avoid the peaks in CPU usage

Status line counters are logged in every fifteen minutes irrespectively of logging level actually set.

The different colors of log entries have different meanings:

Code Color Usage
0 Black Compact data record
1 Red Errors
2 Green Open/close output file/stream
3 Blue Open/close input file/stream
4 Yellow Warnings
5 Light Gray Detailed data (debug info)
6 Dark Grey Detailed data (user info)
7 Purple Operator intervention;
Errors with emphasis

Code	Color	Usage
0	Black	Compact data record
1	Red	Errors
2	Green	Open/close output file/stream
3	Blue	Open/close input file/stream
4	Yellow	Warnings
5	Light Gray	Detailed data (debug info)
6	Dark Grey	Detailed data (user info)
7	Purple	Operator intervention; Errors with emphasis

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	36609998080	SCCP/CallingPartyAddressGT in MAP/PSL_Inv messages
[SS7 over GyX]			Settings for GyX connection
	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]			Settings for ESR-Logic connection
	byMaxConcurrentConnectionCount	4	Maximum number of allowed clients
	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-PSLquery 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
	sSS7FilesPath	d:\SS7Files	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=").
	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)

SNMP trap list

UID	Type	Text	Remarks	To Do
If `bAlternateTrapUID` is set to TRUE
9	CEA	`'Sga-PSLquery v0.91' module is started.`	Send a welcome message; indication of module start-up
9	CRI	`'Sga-PSLquery v0.92' module has been shut down by operator.`	Send a farewell warning message; indication of module shut-down	Start the `'Sga-PSLquery'` module
0	INF	`GyX: Connection to remote module established.`	Connection to GyX module is established for the first time
99	CEA	`GyX: Connection to remote module established.`
99	CRI	`GyX: Connection to remote module is lost.`		Check the state of GyX module.
If `bAlternateTrapUID` is set to FALSE
0	INF	`'Sga-PSLquery v0.91' module is started.`	Send a welcome message; indication of module start-up
0	WAR	`'Sga-PSLquery v0.91' module has been shut down by operator.`	Send a farewell warning message; indication of module shut-down	Start the 'Sga-PSLquery' module
0	INF	`GyX: Connection to remote module established.`	Connection to GyX module is established for the first time
++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

Version history

v0.94

(c) Request parameters are now logged as Param#1 and Param#2.

v0.93

(c) SCCP/CldPA/Nature of address indicator changed to '4' (international number).

v0.92

(n) MAP/SendRoutingInfoforLCS operation also can be requested.

v0.91

First official release.

The Provide Subscriber Location query module("Sga-PSLquery")

Table of Contents