Registry

Home

 

Up

 

Registry Operation for MTELpage 2012

 

1.1       Focus

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.

 

1.2       MTELServe/MTELPage Registry Operation

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.

 

1.3       MTELPage Registry

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

 

 

1.4       MTELPage Registry Grouping

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

 

 

Home ] Up ]  
Copyright © 2012-2021 MTEL Communications Pty Ltd
Last modified: 01-Jun-2022