Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

The MAPI message system

The Message Application Programming Interface (MAPI) is used in several popular email systems, such as Microsoft Mail and later versions of Lotus cc:Mail.

For a list of operating systems for which MAPI is supported, see the SQL Remote for SQL Anywhere table in  SQL Anywhere 10.0.1 Components by Platform.

To use SQL Remote and a MAPI message system, each database participating in the setup requires a MAPI user ID and address. These are distinct identifiers: the MAPI address is the destination of each message, and the MAPI user ID is the name entered by a user when they connect to their mail box.

Although SQL Remote messages may arrive in the same mailbox as email intended for reading, they do not in general show up in your email inbox.

SQL Remote attempts to send application-defined messages, which MAPI identifies and hides when the mailbox is opened. In this way, users can use the same email address and same connection to receive their personal email and their database updates, yet the SQL Remote messages do not interfere with the mail intended for reading.

If a message is routed via the Internet, or if certain security patches are applied to the operating system, the special message type information can be lost. The message then does show up in the recipient's mailbox.

The MAPI message system uses the following control parameters:

• Debug    When set to YES, displays all MAPI calls and the return codes. This is useful for troubleshooting MAPI support problems. Default is NO.

• Encode_dll    If you have implemented a custom encoding scheme, you must set this to the full path of the custom encoding DLL that you created.

  See Encoding and compressing messages.

• Force_Download    (default YES) controls if the MAPI_FORCE_DOWNLOAD option is set when calling MapiLogon. This might be useful when using remote mail software that dials when this option is set.

• IPM_Receive    This can be set to YES or NO (default YES). If set to NO, the MAPI link receives IPC messages, which are not visible in the mailbox. If set to YES, the MAPI link receives IPM messages, which are visible in the mailbox, and IPC messages, which are not visible in the mailbox. It is recommended that this value remain at YES to ensure that both IPC and IPM messages are picked up by SQL Remote.

• IPM_Send    This can be set to YES or NO (default NO). If set to YES, the MAPI link sends IPM messages, which are visible in the mailbox. If set to NO, the MAPI link attempts to send IPC messages, which are not visible in the mailbox. If a message is routed via the Internet, or if certain security patches are applied to the operating system, SQL Remote may be unable to send IPC messages.

• Profile    Use the specified Microsoft Exchange profile. You should use this if you are running the Message Agent as a service.

• Suppress_dialogs    If set to true, the Connect dialog does not appear after failed attempts to connect to the mail server. Instead, an error is generated.