Registry Operation for MTELpage 2012
This
instruction describes the registry functions in the MTELpage
suite of applications. This instruction applies to MTELPage versions V3.50
(347) and above and MTELServe versions V3.3 (460) and above.
The registry is a table in the c:\mtelsys
directory and contains settings for all MTELPage and MS
applications. The table is a replacement for the older style Windows
95 system of storing configuration data for windows programs in
resident global memory.
Instead MP suite of applications has individual
database files located in a fixed directory in which registry like
data are loaded into the application global memory.
When applications are shutdown the registry
data is saved back to the table for safe keeping until the
application is restarted.
The main reason for moving away from the
windows based registry is that in computers with many users the
registry was different for every user. MP changes could not be
easily kept between users.
The second reason is the move to Windows Vista
complicated the registry settings location and so the move to a
table in a database became mandatory.
The third reason is the table data was easier
to change and document then the registry information.
When a MP application starts it looks for its
system file in c:\mtelsys directory. This is hard coded and MP will
not start without this file.
The files for all the MP suite is as follows;
-
MTELPage
c:\mtelsys\mtelpagesysTCP.mdb
-
MTELserve S01
c:\mtelsys\mtelsrvs01.mdb
-
MTELserve S02
c:\mtelsys\mtelsrvs02.mdb
-
MTELserve S03
c:\mtelsys\mtelsrvs03.mdb
-
MTELserve S04
c:\mtelsys\mtelsrvs04.mdb
-
MTELserve S05
c:\mtelsys\mtelsrvs05.mdb
-
MTELDatabase
c:\mtelsys\mtelsysdb.mdb
Registry Read/Write
Each file contains several tables including a
Registry table.
On start-up the application opens this database
and reads in all the Registry data. If data fields are missing the
application will use a default.
On shutting down the application writes back to
the registry only the values in the Registry table.
To force the application to write all
values to the table, there is a Force Registry function in
the Advanced menu in MTELPage. This will empty the Registry
table and then write all current settings to the Registry. Registry
values not previously in the table will now be added and the value
will be the hard coded default or a new value if the application has
changed it.
It is important to perform the Force Registry
on an application that is working satisfactory. Otherwise the
function may write default data from start-up which may change
during normal operation.
Default Settings
It is important to note that Default settings
are primarily used to allow the application to initialise and
correctly start up.
There is absolutely no guarantee that the
settings will work for the immediate user.
Force Registry between versions
The use of the Force Registry function must
only be done if the application is working successfully.
When moving to a new version of the application
this is extremely important as the new version may delete older
settings not required by the new version if the Force Registry is
utilised. This has implications when rolling back to the previous
version as it may not work as the deleted setting will then be
populated with a default setting by the old version when rolling
back and the application is restarted.
In general only use the Force Registry if
instructed to from release notes accompanying the application.
Registry Values for Version V3.50 and below
The table below is the registry with typical
values and default values. There is also an explanation of the
field.
Fields in Red are
not in use and will be removed in future versions. To remove the
fields use Force Registry in the future versions.
Fields in Purple
are not valid for use in the QFRS/QAS implementations. These
settings relate to directly connected paging servers.
Key_Description |
Key_Data |
Default |
Description |
AllowCannedSave |
True |
False |
Allows canned messages to be edited |
AllowGroupPage |
True |
True |
|
AppendCanned |
True |
True |
Allows canned messages to be appended in one message |
BackUpDate |
15/10/2012 12:37:26 PM |
12:00:00 AM |
The date and time of the last backup |
BackUpPeriod |
7 |
7 |
The period in days between backups |
BlankMessage |
Blank Message |
Blank Message |
If the message field is empty this setting will be the message. |
CaseSensitive |
False |
|
|
ClientDescription |
MTELpage Client software |
MTELpage Client software |
No longer in use |
ClientId |
c03 |
C01 |
Unique identifier of the application |
Contacts |
cairns.mdb |
c:\pager\regions\client.mdb |
This is the main client list |
CurrentTCPSocket |
2 |
1 |
Used by MTELPage DIRECT to switch TCP servers |
Customer |
QAS |
QFRS |
Configures MTELpage to do customer specific functions |
FServer |
z:\pager |
c:\pager |
The base location of the pager directory |
GroupSelection |
True |
|
|
IdCounter |
5108 |
0 |
Used by the application to create unique message id's. |
InsertSpaces |
True |
|
|
Load |
2 |
1 |
Not in use |
LogBackupLines |
5000 |
5000 |
If the log length is greater than 5000 lines then on start up the log
file is backed up |
MaxNoServers |
0 |
1 |
The number of servers that MTELPage will monitor the watchdog |
MessageExpireyLimit |
12:30:00 AM |
12:10:00 AM |
This is the time a message can stay in the queue before expiring. |
NameServerId |
w01 |
w01 |
|
No Information Tag |
{No Information} |
{No Information} |
The text for the information tag when no information is in the database |
NoInformationTagEnabled |
True |
True |
Enable the replacement text if no information field is empty in the
database |
Page2MDS |
HUTCH |
NONE |
Determines which pagers go to Relay |
PETBaudEnabled |
False |
False |
In TCP PET the baud rate is in the packet |
PETCapcode |
False |
False |
In TCP PET the pager number is the capcode |
PromptNewNetwork |
True |
True |
If true then on a redirection of the home network a warning message pops
up |
PromptOnGroupPage |
False |
|
|
Region File0 |
cairns.mdb |
{NULL} |
The first alternate contact list file name |
Region File1 |
kawana.mdb |
{NULL} |
The second alternate contact list file name |
Region File2 |
twmba.mdb |
{NULL} |
The third alternate contact list file name |
Region File3 |
tnsv.mdb |
{NULL} |
The fourth alternate contact list file name |
Region File4 |
qessp.mdb |
{NULL} |
The fifth alternate contact list file name |
Region File5 |
central.mdb |
{NULL} |
The sixth alternate contact list file name |
Region File6 |
qfra.mdb |
{NULL} |
The seventh alternate contact list file name |
Region File7 |
{NULL} |
{NULL} |
The eight alternate contact list file name |
Region File8 |
{NULL} |
{NULL} |
The ninth alternate contact list file name |
Region File9 |
{NULL} |
{NULL} |
The tenth alternate contact list file name |
Region Title0 |
Far Northern |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
Region Title1 |
North Coast |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
Region Title2 |
South West |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
Region Title3 |
Northern |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
Region Title4 |
South East |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
Region Title5 |
Central |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
Region Title6 |
Springhill |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
Region Title7 |
{NULL} |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
Region Title8 |
{NULL} |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
Region Title9 |
{NULL} |
{NULL} |
The alternate contact list proxy name to be displayed for the file name |
RegionHoldTime |
180 |
180 |
The time in seconds the home region is reselected automatically after
selecting another region |
RegionTestID |
Central |
None |
The region which MTELPage operates testing on picocells. |
RelayAddress |
192.168.0.43 |
192.168.0.44 |
The relay IP address |
RelayEnabled |
True |
True |
Enable the communications to the relay socket |
RelayPort |
7003 |
7001 |
The relay port |
RemoveControlCharacters |
True |
True |
Checks the message for control characters and removes them |
RemoveKeyAccess |
False |
|
|
ReportingClient |
True |
False |
This application reports picocell test errors |
ReportLast |
19/05/2012 8:00:00 AM |
12:00:00 AM |
This is the last time a report was sent. Only one allowed every 24
hours. |
ResendExpireTime |
1:00:00 AM |
1:00:00 AM |
If the last message was sent older than this time a prompt warns that
the message is old. |
ServerBUIP |
192.168.0.112 |
192.168.0.56 |
The IP address of the TCP PET backup server |
ServerBUPort |
23 |
10001 |
The IP port of the TCP PET backup server |
ServerIP |
e2m.hutch.com.au |
192.168.0.57 |
The IP address of the TCP PET server |
ServerPort |
3030 |
10001 |
The IP port of the TCP PET server |
ServerWatchDogScan |
60 |
60 |
The number of seconds between checking servers are available. 0 turns it
off |
ShutDownOk |
True |
don’t care |
The applications sets this if the registry is saved correctly on an
application shutdown |
TCP_Alert |
True |
True |
Sends a TCP Alert message to the server if it is registered in the
picocell pstn database |
TCPAutoDetect |
False |
False |
On start up it will start looking for the TCP server |
TCPDirect |
False |
False |
Displays the TCP queue and other options on send a message |
TCPProtocol |
PET |
TNPP |
Use TCP PET or TCP TNPP protocols |
Time |
11:07:16 PM |
don’t care |
This is the last write time to the registry |
TNPP_E2054 |
False |
True |
Use E2054 protocol on TNPP packets |
TNPP_FREQ |
2 |
1 |
Assign frequency 2 in TNPP packets |
TNPP_Function |
3 |
3 |
Assign function 3 in TNPP packets |
ToneOnly |
True |
True |
If True then the message is allowed to be blank |
ValidRegistry |
True |
False |
This is used by the application to determine if the current settings
have sent a valid message |
Version |
V3.50 |
1.00.00 |
If registry is valid this field is set to the current version id |
Registry Values for Version V3.50 and below
The table below is how the registry information
relates to the application. Some settings operate together to form
specific functions.
In MTELPage these groups of settings can be
viewed in the Client Log then Settings tab.
An example of the printout is displayed as
follows;
-----------MTELsys
File----------
File Location:- c:\MTELsys\mtelpagesysTCP.mdb
-----------General----------
Customer:- QAS
Customer ID changes the operation of MTELpage for certain
customers.
File Server is:- z:\pager
Client ID is:- c03
All Clients must have a unique customer id.
Client File:- cairns.mdb
This is the default contact list.
Check for servers every (secs):- 60
Current Message ID Counter:- 5308
Max Number of Servers:- 0
If set to 0 it disables checking for servers. Otherwise
set it to the number of servers
TCP ALert to Servers:- True
in operation.
TCP alert will always be set to True.
----------- Layout ----------
Tone Only permitted:- True
Blank Message (inserted):- Blank Message
Append Canned Messages:- True
-----------Backup-----------
There should only be backup client. Usually C99. All
others should have a backup
BUSize is (days):- 7
date of 2099.
BUDate is:- 15/10/2012 12:37:26 PM
-----------Reporting-----------
There is only one reporting client in a system. Usually
the C99 Client
Reporting Client:- True
All other clients should be False. However the Region Test
ID should always be
Last Report:- 19/05/2012 8:00:00 AM
set as this setting allows MTELpage to filter the region
for manual test purposes.
Region Test ID:- Central
-----------Protocol---------
Message Expire Time (hms) is:- 12:30:00 AM
These settings are only for directly connected MTELPage
systems.
Packet Protocol:- PET
MTELPage connects to paging hardware servers using a TCP
socket.
Remote E2054 System:- False
It then can use several different protocols across
the TCP connection
TCP direct:- False
depending on the server.
TCP Port:- 3030
TCP IP:- e2m.hutch.com.au
TCP Auto Detect:- False
PET Capcode Enabled:- False
Add to PET packet Baud Rate:- False
TNPP Dedicated Freq Ch:- 2
TNPP Dedicated Function Mask:- 3
-----------Relay---------
These are the settings for sending messages to the MDS via
the MTELRelay.
Relay Address is:- 192.168.0.43
Relay Port is:- 7003
Relay Port Active:- True
Paging 2 MDS:- HUTCH
|