imov Messenger™ Enterprise and Basic Edition Users Guide

Welcome to the world of Universal Mobile Messaging! imov Messenger provides a secure, easy to use messaging client for your Windows CE device. Some of the features that are included in imov Messenger are:

- Interoperability with proprietary messaging systems such as Microsoft Instant Messenger™, America Online Instant Messenger™, ICQ™, Yahoo! Instant Messenger™, Google Talk™, Jabber™ and other messaging standards such as SMS.

- Encrypted communications using 128 bit Secure Socket Layer (SSL)

- Offline message queuing

imov Messenger works on all newer Windows CE devices, including all devices with Windows CE 2.11, 3.0, or HPC/2000, all PocketPC’s and all Microsoft Smartphones.

2 Installation

imov Messenger must be installed from your desktop PC. To correctly install the software, first connect your Windows Mobile device to your Windows desktop PC using ActiveSync. Next, double click the setup.exe installation program to install imov Messenger.

3 Quick Start

The following steps can be used to get imov Messenger running with your device. If you just want to use Google Talk please see this section in Appendix A.

1) Run the Setup Wizard using Setup->Setup Wizard from the Login screen on your PocketPC or Smartphone

2) Specify which services you want to use (MSN, Yahoo!, AIM, ICQ etc).

3) The software will ask for a Jabber server name, and a username and a password. For the Jabber server name, use movsoftware.com or one of the other server names here: http://www.movsoftware.com/servers. Choose a new username and password and check the "Create New Account" checkbox so that your account gets created on the Jabber server.

4) On the login screen click the connect button and you will log into the Jabber server and all your contacts should appear for all the services you selected in step 2.

4 Operation

The imov Messenger software can be launched by selecting the imov Messenger item from the Start menu. On Handheld PC devices, a shortcut is also available on the desktop.

Once the software is launched the first time you will see the imov Messenger Setup Wizard.

5 Setup Wizard

The Setup Wizard allows you to quickly configure imov Messenger on your device.

The Wizard will first ask you to specify which third party Instant Messaging services you wish to you use with imov Messenger. imov Messenger will use this information to allow you to communicate with other services such as MSN Instant Messenger, AOL Instant Messenger, Yahoo! Messenger, ICQ and others. Please note that not all Jabber servers support connections to third party Instant Messaging services. To find out if your Jabber server does, ask your Network Administrator or visit http://www.movsoftware.com/servers. Once you have specified the services you wish to use, click the “Next” button to continue.

The Wizard will next ask you to specify a Jabber server and an account to use for your connection. If you know which Jabber server you wish to use, type the name of the server in the “Server:” edit control. If you do not have the name of a Jabber server, you can use “jabber.org” or “jabber.com” as a server. To find other servers, visit http://www.movsoftware.com/servers using your web browser.

If you have an account already setup on that server, type in the username and password in the “Username:” and “Password:” edit controls. If you do not have an account on the server, or wish to setup a new account, type in the username and password you wish to use for the new account and click the “Create New Account” checkbox. Once this is done, click the “Next” button.

Now, for each service you selected in the previous step (MSN Instant Messenger, AOL Instant Messenger, etc) a dialog box will appear asking you to configure your settings for that service. For each service you will be asked to supply a username and password.

6 Managing Your Contacts

6.1 The Roster

Figure 1 - PocketPC Roster

Figure 2 - Smartphone Roster

The roster window allows you to manage your contacts. Each contact is part of a group. There are three previously defined groups: “Active Chats”, “Contacts” and “Services”. The “Active Chats” group lists all the chats that you currently have open. The “Contacts” group is the default group for all your defined contacts; all contacts that you add to your roster will belong to this group by default. The “Services” group will contain a listing of all the services that a server supports, once you are connected to a server.

You can choose to view only the online contacts via the “Only Online Contacts” menu item in the “View” menu. When this option is selected, only contacts that are currently logged in are displayed in the roster. This feature is only available to imov Messenger Enterprise users.

6.2 Adding a Contact

You can add a contact to your roster by clicking on the “Add” button at the bottom of the contact window. You will then be led through a series of steps. You will first be asked which service (MSN Instant Messenger, AOL Instant Messenger, Jabber, etc) the contact is using. You will also need to specify which group in your roster you wish to add your contact to. By default the “Contact” group is selected, but you can select from additional group via the combo box, or by typing in a new group name. In addition you will be asked to provide a nickname for this user. This nickname will be used as the name the contact appears as in your roster. Once you have specified this information, click the “OK” button.

Depending on which service you specified in the previous step, you will be asked to provide an address for your contact. For MSN Messenger the address is typically the email address of the contact. For other services, such as Yahoo! Messenger you will just need to supply a single username. Once you add all this information, click the “OK” button and the user should appear on your roster.

6.3 Removing a Contact

You can remove an existing contact from your roster by selecting the contacts nickname in the roster, and clicking the “Remove” button.

7 Messaging

Figure 3 - Messaging on the PocketPC

Figure 4 - Messaging on the Smartphone

You can send a message to a contact by either selecting the contact in your roster and clicking the “Chat” button, or by double clicking on the contact. Once this is done, a chat window will open up. The chat window consists of an upper panel that displays the chat test, and a lower input panel where you can enter your text.

By entering the message text you wish to send to your selected contact in the input panel and either clicking the send button, or hitting the “Control” and “Enter” keys, you will send the text to the contact.

If a network connection is not available, the message will be queued locally and will be sent once a network connection becomes available. If a message is locally queued, it will be displayed with a “[q]” string after your nickname in the chat window. For example:

Fred says[q]: This is a locally queued message.

The local queue will be cleared if you exit the imov Messenger application.

Additionally, if a contact is currently not available and you send a message to them, the message will be queued by the server for delivery as soon as the contact becomes available.

You also have the option of sending a message to an entire group of contacts by selecting the group name and clicking the “Chat” button, or double clicking on the group name. This will cause a chat window to appear and any messages sent in this window will be sent to all the contacts in that group. This option is only currently available on the PocketPC2002 version of imov Messenger Enterprise.

8 Setup Options

You can change various setup options of imov Messenger via the “Menu->Setup” menu item. When this option is chosen, a Setup dialog box will appear.

8.1 Notifications

You can specify how you want to be notified of certain actions via the “Notifications” checkboxes. The following options are supported across all Windows CE devices:

Play Sounds

When User Comes Online – Causes an alarm to sound when any users in your contact list come online.

On First Message – Causes an alarm to sound when a user sends you an initial message.

On Remaining Messages – Causes an alarm to sound when a user sends you any message.

8.2 Services

imov Messenger supports many of the popular Instant Messaging services such as AOL Instant Messenger (sm), Microsoft Instant Messenger ™, Yahoo Instant Messenger ™, and ICQ ™. Support for additional services are planned for future releases. In order to use any of these services, you will need to have to already have an account on the service provide account information for each service. Account information can either be specified when the Setup Wizard runs, or can be specified for each service individually in the “Setup” dialog box by selecting the service you wish to use in the “Service:” combo box and clicking the “Setup” button. You will then be presented with a dialog box that will ask you to specify account information for that particular service. In most cases, you will need to specify a username and password for the service.

8.3 Proxy Server

If you are behind a firewall, or have any reason to use a proxy server on your network, you can specify information about the server via the “Menu->Setup->Advanced” dialog box. imov Messenger supports SOCKS5 servers only, please check with your Network Administrator if you are not certain if your proxy server is SOCKS5 compliant.

To use the proxy server connection, click the “Use Proxy Server” checkbox and specify the name or IP of your proxy server, and the username and password of your proxy account. Most proxy servers run on port 1080, but if you need to specify an alternate port you can enter the port information in the “Port:” edit control.

8.4 Miscellaneous

Additional options exist in the “Setup” dialog box that allows you to specify advanced features such as encrypted connections and time stamped messages. Some options may not be available for certain Windows CE devices. Some options are only available with the Enterprise Edition of imov Messenger.

Encryption – Utilizes a SSL connection to the Jabber server. The selected server must be configured to handle SSL connections.
Popup Notifications (PocketPC2002 devices only) – Causes a popup window to appear whenever a new message is received or a contact comes online.
Auto Login – Causes imov Messenger to login to the Jabber server when imov Messenger starts up and a connection is available. If imov Messenger becomes disconnected from the server for some reason, it will also attempt to automatically reconnect if this option is available.
Timestamp (Enterprise Edition only) – Adds a timestamp to all received and sent messages.
Logging (Enterprise Edition only) – Allows all received and sent messages to be logged to a local text file. Log files are stored in the root directory of the device and are named with the following format: “imov Messenger_log[time and date].html”
Authentication (Enterprise Edition only) – Allows SASL authentication to be used to authenticate the connection to the Jabber server.
Password Encryption (Enterprise Edition only, also requires a device running Windows CE3.0 or greater which includes all PocketPC’s, HPC/2000 and SmartPhone devices) – All passwords to the services and the Jabber server will be converted via the Microsoft Encryption Services before being saved in the registry.

9 Keeping Your Communications Secure

imov Messenger offers many features that keep your communications safe to use in a corporate environment or over the Internet. Both the basic and Enterprise versions of the client support Secure Socket Layer (SSL) connections. SSL connections requires that all information sent between a client and a server to be encrypted by the sending software and decrypted by the receiving software, thus providing a high degree of confidentiality. Confidentiality is important for both parties to any private transaction. In addition, all data sent over an encrypted SSL connection is protected with a mechanism for detecting tampering--that is, for automatically determining whether the data has been altered in transit. imov Messenger uses RSA encryption for all of its SSL connections. To use the SSL feature, make sure that the “Use Encryption” checkbox is checked in the Setup dialog box. Once a connection is made to the server, a secure connection will be indicated if the Encryption status icon, which looks like a lock, will be highlighted in the status bar.

In addition to SSL, using the Enterprise Edition gives you SASL authentication capabilities. The SASL protocol ensures that the user connecting to the server is authentic, and does not require that a plaintext password be sent from the client to the server.

The Enterprise Edition also adds the ability to save the passwords to all your services (AIM™, MSN Instant Messenger™, Yahoo! Chat ™, etc) are saved in an encrypted state in the registry of your device. Encryption capabilities are provided by the Microsoft Encryption Services.

10 Voice over IP (VoIP) Support

Voice over IP support can be quickly added to your device by installing the iFon™ application by TABLETMedia. To initiate a VoIP connection to a contact in your contact list, simply select that contact and choose the “Menu->Call User Using iFon” menu item. iFon will immediately launch and connect to the remote user. If the remote user is not running imov Messenger, you will be prompted to provide the IP address of the remote user. Otherwise the VoIP call will be made automatically. Please note this requires that the remote user have compatible VoIP software installed on their device as well. This feature is only available to imov Messenger Enterprise users.

11 Microsoft Outlook™ Contact Integration

imov Messenger integrates with all your contacts on your device and allows you to quickly contact a user by selecting the contact in your Microsoft Outlook Contact™ application and selecting “IM with imov Messenger” from the resulting popup menu item. When this action is performed, a chat window will appear for that contact. You can then message the contact as described in the “Messaging” section of this document. For this to work correctly you must put the Jabber ID (e.g. movsoftware@jabber.org) of the contact in the “Email3:” field of the contact information in Microsoft Outlook Contact ™. This feature is only available to imov Messenger Enterprise users.

12 Sending Text with QuickPhrase™

Figure 5 - QuickPhrase on the PocketPC

Figure 6 - QuickPhrase on the Smartphone

The QuickPhrase™ technology contained within imov Messenger gives you the ability to quickly compose and send text to users via a graphical interface. QuickPhrase™ works by presenting a user with sequences of phrases that can be selected to rapidly build entire sentences. This allows you to quickly send responses to a contact where a keyboard interface is not available or practical – such as a PocketPC device.

You may create your own custom QuickPhrase™ data files using the QuickPhraseEditor software available as a download on http://www.movsoftware.com. For more information please refer to Section 14.3 in Appendix A.

13 News Headlines

imov Messenger supports the RDF Site Summary standard for content distribution.

14 Location Based Services

The term Location Based Services refers to applications that utilize geographical data. An application would use this geographical data (location) to provide additional value to a user of the service. One example of a Location Based Service application is imov Messenger. imov Messenger uses Geographical Positioning System (GPS) or user entered geographical data to share the location of the end user with other interested users. Additional features of the Location Based Services component include street level mapping of the users current location and automated driving directions.

14.1Setting up Location Based Services

To get maximum utility from the Location Based Services component, it is recommended that you use a Smartphone, PocketPC or HandheldPC with a GPS device, or a Windows Mobile device that has location based services technology.

All configuration Location Based Services is done through the Location Based Service Setup dialog box, which can be accessed via the “Setup->LBS” menu. The setup dialog box will allow you to turn on or off Location Based Services support in imov Messenger, specify if you wish to use a GPS device, and the port the GPS device is connected to. If you do not have a GPS device, or your Windows Mobile device does not support location based services, you can manually enter your current latitude/longitude and altitude in the provided edit controls.

If you have a NMEA compatible GPS device, attach the GPS to your Windows Mobile device, check the “Use GPS” checkbox, and choose the appropriate communication port for the GPS in the “Port:” combo box. If you do not know what communication port your GPS uses, choose “Auto” and imov Messenger will attempt to automatically detect your GPS device.

14.2Utilizing Location Based Services

To fully utilize the Location Based Services feature, you will need a movcast Locator account. You can sign up for an account on a public movcast Locator server at http://www.movsoftware.com/locator. You can also run your own movcast Locator service within your network. Too see if this is available, please contact your Network Manager.

imov Messenger will keep track of your current location automatically if you have a GPS or other location sensing device attached to your Windows Mobile device. This information will be transmitted to the movcast Locator service. The movcast Locator service will use this information to provide street level mapping of your current location to users of the system, and also routing/driving directions to or from your current location to other users, or to any postal address.

15 Troubleshooting

I cannot login to my Jabber server.

First make sure that you have a valid connection to the Internet by using Internet Explorer to visit a web address.

Also make sure that you have specified a valid server name and that you have a valid account on the server or the “Create New Account” checkbox is specified in the Jabber Service setup window. You can run the “Setup Wizard” via the “Setup->Run Setup Wizard” option to set this.

You may also need to check to make sure that you are not behind a firewall that prevents direct connections to the Internet. Ask you Network Administrator for details about you network. If you are behind a firewall you may need to specify a Proxy Connection. See the “Proxy Connection” section in this document for details on how to do this.

I cannot connect to the AOL Instant Messenger(sm), ICQ ™, Microsoft Messenger ™, etc service(s).

First make sure that you have specified the correct account information for the service. You will need to have a valid account on the service before you can use them in imov Messenger. See the “Services” section in this document on information on how to setup individual third party services for use with imov Messenger. Also, frequently third-party services are blocked from use or not supported by the Jabber server you are using. You may need to visit http://www.movsoftware.com/servers to see which Jabber servers are currently running which third party services.

16 Appendix A

16.1QuickPhrase™ File Format

The QuickPhrase™ data file is located in the \WINDOWS directory of your device. It is in XML format and can be edited using any ASCII or XML editor. The file consists of multiple <QuickPhrase> elements, each that describe a single phrase that the user can select. Included in the element description are a unique id of the element, a true/false attribute to indicate if it is a “root” phrase or not, a text attribute that contains the phrase text, and a list of <rphraseids> that list all the phrase identifiers of all the phrases that can follow that phrase.

The DTD of the QuickPhrase™ file is described below:

<!DOCTYPE QuickPhrase [

<!ELEMENT phrasetext (#PCDATA)>

<!ATTRIBUTE phraseid (#PCDATA)>

<!ATTRIBUTE root (#PCDATA)>

<!ELEMENT rphraseids (phraseid)>

<!ELEMENT phraseid (#PCDATA)>

16.2Creating Custom QuickPhrase™ Data Files

You can easily and quickly create your own QuickPhrase™ data files using the QuickPhraseEditor software available for download at http://www.movsoftware.com/developers.htm. This software will input a list of sentences via a text file and export out a QuickPhrase™ data file in the proper XML format. This data file can then be copied into your \WINDOWS directory on your device to make your custom sentences available to users of your device.

To generate a new QuickPhrase XML data file, you must first have a text file that contains the full set of sentences you wish to use as your data set. These sentences must be one per line, and be separated by a carriage return/linefeed sequence. An example input data file is included with the software as "sentences.txt"

To load your input data file, choose File->Open from the menu system and select your input file. The sentences will appear in a window in the application. To generate a QuickPhrase XML data file choose Analyze->Analyze from the menu system. A dialog box will appear which will prompt you to specify the number of iterations to run the analysis, and the minimum and maximum number of words that should appear in a typical phrase.

Once the analysis is complete you can choose File->Export from the menu system to save your QuickPhrase XML data file. To use the data file with the imov Messenger application, copy the data file to your \IPSM\WINDOWS (for Microsoft Smartphones) or \WINDOWS directory on your Windows CE based device.

16.2.1 Setting up your Data Connections for WAP Usage

If you have a data plan that charges for GPRS data usage, but allows unlimited WAP usage, you may want to configure your device to use a WAP connection for imov Messenger. This will allow you to save on GPRS data costs.

Go to Programs/Settings/Data Connections

There are two fields in Data Connections menu. One is called 'Internet Connection’ and the other is called 'WAP connection'. Both these fields need to be set to your WAP connection in order to utilize WAP.

To check if your WAP GPRS connection is correctly set up:

Use the menu keys to go to Programs/Settings/Data Connections/Menu/Edit

Connections/GPRS Connections/<your provider name> WAP

Typical settings are as below. Please check with your wireless provider for the correct WAP settings.

“Connects to:” field set to 'WAP Network'

Access point is the APN that your wireless provider gives you

Leave User name and Password fields blank

Primary DNS is 0.0.0.0

Secondary DNS is 0.0.0.0

IP address leave blank

16.3Registry Entries

The following registry entries are available to modify the behavior of your client. Please note that modifying these values incorrectly may cause your client to stop functioning.

All registry entries are contained in HKEY_LOCAL_MACHINE\Software\mov Software\JabberCE.

Key	Type	Valid Values/ Default	Purpose
ENTERKEY SENDS	DWORD	0 or 1 0	0 = Ctrl+Enter key sends message in chat windows 1 = Enter key sends message in chat windows
PRIORITY	DWORD	0-65535 10000	Defines the priority of this client. Priority determines which instance of a Jabber client will receive messages first. Higher priority clients receive messages first.
KEEPALIVE PERIOD	DWORD	0-10000000 50000	Number of milliseconds between sending keep-alive packets to the server
CHECK CONNECTION PERIOD	DWORD	0-10000000 50000	Number of milliseconds between detection of network connection status
SOUND ENTER	STRING	Path to .wav file \WINDOWS\alarm1.wav	Sound (.WAV) file that is played when a contact logs on
SOUND EXIT	STRING	Path to .wav file \WINDOWS\alarm2.wav	Sound (.WAV) file that is played when a contact logs off
SOUND FIRSTMESSAGE	STRING	Path to .wav file \WINDOWS\alarm3.wav	Sound (.WAV) file that is played when a contact sends you an initial message
SOUND MESSAGE	STRING	Path to .wav file \WINDOWS\alarm3.wav	Sound (.WAV) file that is played when a contact sends you additional messages
DEBUG MODE	DWORD	0 or 1