Using the Email Server Simulator

The BlackBerry JDE includes an Email Server Simulator that enables you to send and receive email between the device simulator and either a desktop email application, such as Microsoft Outlook, or POP3 and SMTP servers. A BlackBerry Enterprise Server is not required.

Start the Email Server Simulator

On the Start menu, click Programs > Research In Motion > BlackBerry Java Development Environment 4.0 > Email Server Simulator.

Select one of the following modes:


Mode	Description
Standalone mode	The ESS stores messages on the local file system and communicates directly with a desktop email application. No POP3 or SMTP server is required./The ESS can communicate with any desktop email application that supports POP3 and SMTP, such as Microsoft Outlook Express. The desktop email account must have the POP3 server set to localhost on port 110 and the SMTP server set to localhost on port 25.
Connected mode	The ESS polls the user POP3 email server for incoming messages, and uses the user SMTP server to send messages. Valid POP3 and SMTP servers are required.

If you select the Standalone mode option, click Clean FS to erase ESS messages that are stored on the local file system.

If you select the Connected mode option, complete the following fields:


Field	Description
Outgoing	The host name of the SMTP server that your email account uses
Incoming	The host name of the POP3 server that your email account uses
User name	The user name with which to connect to your email account
Password	The password with which to connect to your email account
Poll inbox	How often, in seconds, the simulator checks your email inbox for new messages

Complete the following fields:


Field	Description
Name	The name to display in outgoing messages from the device simulator
Email	The email address to display in outgoing messages from the device simulator
PIN	The personal information number (PIN) that is used by the device simulator (by default, the PIN is 0x2100000A)

Send an email using the device simulator

Start the Email Server Simulator. See "Start the Email Server Simulator" on page 3 for more information.

Click Launch.

Check the command prompt for detailed information on ESS startup, including any login errors.

Start the device simulator. See "Starting the device simulator" on page 4 for more information.

Open the Messages application.

Click the mouse wheel button.

Click Compose Email.

Select an email address.

Click the mouse wheel button.

Type a subject and message.

Click Send.

Load test using the device simulator

Start the Email Server Simulator. See "Start the Email Server Simulator" on page 3 for more information.

Click Load Test.

Check the command prompt for detailed information on ESS startup, including any login errors.


	Note: There must be one or more email messages in the Inbox associated with the Email Service Simulator for the load test functionality to work.

Test an application that uses synchronization in the simulator

Simulate a desktop connection. See "Simulating a desktop connection" on page 13 for more information.


	Note: If you start the device simulator from a command prompt, specify the /rport=0x4d4e parameter to communicate with the email server simulator.

On the Start menu, click Programs > BlackBerry > Desktop Manager.

Click the Intellisync tool and configure your synchronization settings as required.

Click Synchronize Now to test the synchronization.

Legal disclaimers

© 2004 Research In Motion Limited. All Rights Reserved. The BlackBerry and RIM families of related marks, images, and symbols are the exclusive properties of Research In Motion Limited. RIM, Research In Motion, "Always On, Always Connected" and BlackBerry are registered with the U.S. Patent and Trademark Office and might be pending or registered in other countries.

All other brands, product names, company names, trademarks, and service marks are the properties of their respective owners.

The BlackBerry handheld and/or associated software are protected by copyright, international treaties, and various patents, including one or more of the following U.S. patents: 6,278,442; 6,271,605; 6,219,694; 6,075,470; 6,073,318; D445,428; D433,460; D416,256. Other patents are registered or pending in various countries around the world. Visit www.rim.com/patents.shtml for a current listing of applicable patents.

This document is provided "as is" and Research In Motion Limited (RIM) assumes no responsibility for any typographical, technical, or other inaccuracies in this document. RIM reserves the right to periodically change information that is contained in this document; however, RIM makes no commitment to provide any such changes, updates, enhancements, or other additions to this document to you in a timely manner or at all. RIM MAKES NO REPRESENTATIONS, WARRANTIES, CONDITIONS, OR COVENANTS, EITHER EXPRESS OR IMPLIED (INCLUDING, WITHOUT LIMITATION, ANY EXPRESS OR IMPLIED WARRANTIES OR CONDITIONS OF FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, MERCHANTABILITY, DURABILITY, TITLE, OR RELATED TO THE PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE REFERENCED HEREIN, OR PERFORMANCE OF ANY SERVICES REFERENCED HEREIN). IN CONNECTION WITH YOUR USE OF THIS DOCUMENTATION, NEITHER RIM NOR ITS AFFILIATED COMPANIES AND THEIR RESPECTIVE DIRECTORS, OFFICERS, EMPLOYEES, OR CONSULTANTS SHALL BE LIABLE TO YOU FOR ANY DAMAGES WHATSOEVER BE THEY DIRECT, ECONOMIC, COMMERCIAL, SPECIAL, CONSEQUENTIAL, INCIDENTAL, EXEMPLARY, OR INDIRECT DAMAGES, EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, INCLUDING, WITHOUT LIMITATION, LOSS OF BUSINESS REVENUE OR EARNINGS, LOST DATA, DAMAGES CAUSED BY DELAYS, LOST PROFITS, OR A FAILURE TO REALIZE EXPECTED SAVINGS.

This document might contain references to third-party sources of information and/or third-party web sites ("Third-Party Information"). RIM does not control, and is not responsible for, any Third-Party Information, including, without limitation, the content, accuracy, copyright compliance, legality, decency, links, or any other aspect of Third-Party Information. The inclusion of Third-Party Information in this document does not imply endorsement by RIM of the third party in any way. Any dealings with third parties, including, without limitation, compliance with applicable licenses, and terms and conditions are solely between you and the third party. RIM shall not be responsible or liable for any part of such dealings.

The software referenced in this online help facilitates the creation of content for the BlackBerry Browser. In order to use the software referenced herein as intended, you must have valid agreements in place with the licensor(s) of the hardware and software referenced in this user guide. In addition to being required to comply with such license terms, you are strictly prohibited from using the software referenced herein to create, adapt, or otherwise use in any fashion any content that infringes upon or violates the intellectual property rights of any third party. The disclaimer of liability set forth above shall apply with respect to your use of the software in any manner not authorized by Plazmic, Inc.


Research In Motion Limited 295 Phillip Street Waterloo, ON N2L 3W8 Canada	Research In Motion UK Limited Centrum House, 36 Station Road Egham, Surrey TW20 9LF United Kingdom