Mobile Connection for Notes - administration

All information for script administration are located in the registry of PC where script runs. All items are read at startup, so see settings refreshing if you want to take changes into effect. Only exception is logging level, which can be changed dynamically during the run.

Registry items

All registry items are stored in the HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\lnmobile\ branch.

ServerName

Name of Lotus Notes server with user mailboxes. Optional value; if it doesn't exist, name of server where script is running is used.

NotesIni

Full path to Lotus Notes INI file used by script to log in to Lotus Notes.

MaxContacts

Maximum number of contacts, which will be sent back to the user (1 contact = 1 SMS). If more contacts was found, user receives only information, that too many items were found and he must refine his searching criteria. Optional value; if not present, default value (5) is used.

MaxSmsLen

Maximum SMS length, used for trimming too long messages. Optional value; if not present, default value (160) is used.

CountryPrefix

Number being dialed before international preselection (what do you have to dial when calling into other country before other country's international number?). Optional value; if not present, 00 is used.

CityPrefix

Number being dialed before long distance preselection (what do you have to dial when calling into other city before other city's area code?). Optional value; if not present, 0 is used.

CountryCode

International phone preselection of your country (without leading zeroes or + sign). Optional value; if not present, 420 is used (country code of Czech republic).

CityCode

Area code of your city (without leading zero). Optional value; if not present, 2 is used (area code of Prague, Czech Republic).

AddrBook

Database name, which will be searched for contacts when user sends "?g" command (global address list).

ReplyInfo

Text inserted into reply message behind your text written in SMS message and original indented message. It should contain information about message origin and application, which processed the message. Optional value. Default value is "(Sent from cellular phone via MobilChange - Mobile Connection for Outlook)".

LogFileName

Name and path of log file, where script writes information about its work. Logging is turned on/off by LogEnabled value. Optional value; if not present, default value "C:\MobilChange\log\outlook.txt" is used

LogEnabled

Turns logging on/off, numeric value 1/0. Optional value; if not present, logging is turned off.

LogLevel

Logging level, numeric value 0-5 says how many details will be written into log file. Optional value; if not present, default value 1 is used. Any change in Loglevel is dynamic - so change takes into effect when new SMS is received.

Description of log levels follows::

0 - logging is paused; no messages, however log file is still opened. If you want to switch logging off, use LogEnabled value. If you want to delete log file and logging is turned on, see settings refreshing.
1 - information about received/sent SMS and error messages.
2 - basic log level; basic information about SMS processing. Used for determining most problems from the user's side.
3 - extended logging; detailed information about SMS processing. This level gives big volume of data written into log. Used especially when searching for error in code of script.
4 - logs all iterations; gives information about all records being searched. Volume of data in log dramatically grows (if for example company contacts contain about 1000 records). Used when script gives invalid results and you need to check tested values. After check you should clean up the log.
5 - complete logging; traces all function in the script. This level is not commonly used and we don't recommend it because of extra large volume of log writting.

Log file

Log file location is set by LogFileName value. State and level of logging is controlled by LogEnabled and LogLevel values. Log file is a text file, human readable. If logging is turned on (LogEnabled = 1), file is read only. If you want to delete log, see settings refreshing.

Settings refreshing

If changes in the registry should be taken into effect, or you need to delete log when logging is switched on, it is necessary to temporary stop MCN script task in UMS.TaskManager and start it again. Or simply restart UMS.TaskManager service, but it restarts also all other scripts, what don't have to be good idea.

Help file

Users can ask for simple help by SMS. It is text file "lnmobile-help.txt" located in "MobilChange\script\txt" folder. This file can be freely edited with consideration to maximal SMS length.