Feature and Technical Overview

Local Navigation

Messaging process flows

Process flow: Sending a message to a BlackBerry device

This diagram shows the components that are described in the following text.
  1. The IBM® Lotus Notes® router delivers a new message to a user’s IBM Lotus Notes mailbox.
  2. The BlackBerry® Messaging Agent polls the user's mailbox and detects the message.
  3. The BlackBerry Messaging Agent applies global filter rules to the messages in the user’s mailbox and filters the messages that match the filter criteria.

    If global filter rules do not apply, the BlackBerry Messaging Agent applies filter rules that the user specified to the messages in the user’s mailbox.

  4. The BlackBerry Messaging Agent creates an entry in the BlackBerry state database.

    The BlackBerry Messaging Agent uses the entry to track the delivery state and associate the Unid (applied to the message in IBM Lotus Notes) with a randomly generated Reference ID (RefId) and tag. If the message is a meeting invitation or calendar entry, the BlackBerry Messaging Agent appends the calendar information to the message.

    The BlackBerry Messaging Agent uses the RefId to identify the message between the BlackBerry® Enterprise Server and the BlackBerry device. The BlackBerry Messaging Agent uses the tag to identify the message between the BlackBerry Enterprise Server and the wireless network.

  5. The BlackBerry Messaging Agent sends the first 2 KB of the message (plain text, or in an HTML message, the equivalent to 2 KB of plain text) to the BlackBerry Dispatcher.
  6. The BlackBerry Dispatcher compresses the first 2 KB of the message, encrypts it using the device transport key of the BlackBerry device, and sends the encrypted data to the BlackBerry Router.

    The user state database shows the message status, which appears in the IBM Lotus Notes console and IBM Lotus Notes log.

  7. The BlackBerry Router sends the encrypted data to the wireless network over port 3101, or over port 4101 if the BlackBerry device is a Wi-Fi® enabled BlackBerry device that is connected to the enterprise Wi-Fi network.
  8. The wireless network verifies that the PIN belongs to a valid BlackBerry device that is registered with the wireless network, and sends the message data to the BlackBerry device.
  9. The BlackBerry device sends a delivery confirmation to the BlackBerry Dispatcher. The BlackBerry Dispatcher sends the delivery confirmation to the BlackBerry Messaging Agent.

    The BlackBerry Messaging Agent writes the message delivery state to the BlackBerry state database. If the BlackBerry Messaging Agent does not receive a delivery confirmation within four hours, it sends the message to the wireless network again.

    The delivery confirmation verifies that the wireless network delivered the message to the BlackBerry device, but it does not verify that the user received or opened the message.

  10. The BlackBerry device decrypts and decompresses the message so that the user can view it, and notifies the user that the message arrived.

Process flow: Sending a message from a BlackBerry device

This diagram shows the components that are described in the following text.

This process flow applies to new messages, reconciled messages (messages that a user moved, deleted, or marked as read or unread), and wireless calendar entries.

  1. A user sends a message from a BlackBerry® device.

    The BlackBerry device assigns a RefId to the message. If the message is a meeting invitation or calendar entry, the BlackBerry device appends the calendar information to the message. The BlackBerry device compresses and encrypts the message, and sends the message to the wireless network over port 3101, or over port 4101 if the BlackBerry device is a Wi-Fi® enabled BlackBerry device that is connected to the enterprise Wi-Fi network.

  2. The wireless network sends the message to the BlackBerry® Enterprise Server.

    The BlackBerry Enterprise Server accepts only encrypted messages from the BlackBerry device.

  3. The BlackBerry Dispatcher uses the device transport key of the BlackBerry device to decrypt and decompress the message.

    If the BlackBerry Dispatcher cannot decrypt the message using the device transport key, the BlackBerry Enterprise Server ignores the message and sends an error message to the BlackBerry device.

  4. The BlackBerry Messaging Agent performs one of the following actions:
    • If the message is new, the BlackBerry Messaging Agent creates an entry in the BlackBerry state database.
    • If the message is a reply that includes the original text, or is a forwarded message, the BlackBerry Messaging Agent looks up the entry in the BlackBerry state database to correlate the incoming message to the original message in the user’s message file.

    The BlackBerry state database contains a link to the original message. Since the BlackBerry Messaging Agent forwards only the first portion of a message to the BlackBerry device, the BlackBerry Messaging Agent must locate and retrieve the full message text to forward it or reply to it with the original text.

  5. The BlackBerry Messaging Agent sends the message to the mail.box for the IBM® Lotus Notes® router to send to the user's email application.

    If the user is in the same IBM® Lotus® Domino® domain as the BlackBerry Enterprise Server, the BlackBerry Messaging Agent stores the message in the mail.box that is located on the BlackBerry Enterprise Server. If the user is in an IBM Lotus Domino domain separate from the BlackBerry Enterprise Server, the BlackBerry Messaging Agent stores the message in the mail.box that is located on the user’s messaging server.

  6. The BlackBerry Messaging Agent sends a copy of the message to the Sent view in the user’s mail file that is located on the messaging server.
  7. The messaging server delivers the message to the recipients.

Process flow: Sending a message that contains an attachment from a BlackBerry device

This diagram shows the components that are described in the following text.
  1. A user attaches a file to a message on a BlackBerry® device and sends the message.
    • If the BlackBerry device is not running BlackBerry® Device Software version 4.2 or later, and if the BlackBerry device does not have a CMIME service book that indicates that the BlackBerry® Enterprise Server supports attachment uploads, the Add Attachment menu item does not appear on the BlackBerry device.
    • If the user tries to attach a file that exceeds the maximum file size that you specified, a notification appears and the user cannot attach the file.
  2. The BlackBerry device compresses and encrypts the message, and sends the message to the wireless network over port 3101.

    The BlackBerry device formats the header of the message to indicate that a large attachment is part of the message. The BlackBerry device does not send the attachment content.

  3. The wireless network sends the message to the BlackBerry Enterprise Server.

  4. The BlackBerry Dispatcher decrypts and decompresses the message using the device transport key of the BlackBerry device.

    If the BlackBerry Dispatcher cannot decrypt the message using the device transport key, the BlackBerry Enterprise Server ignores the message and sends an error message to the BlackBerry device.

  5. The BlackBerry Messaging Agent stores the message properties in memory.

    The BlackBerry Messaging Agent sends a request for the attachment content through the BlackBerry Dispatcher to the BlackBerry device.

  6. The BlackBerry device sends the attachment content through the BlackBerry Dispatcher to the BlackBerry Messaging Agent.

    If the file size of the attachment content exceeds a single data packet, the BlackBerry device divides the content into multiple data packets and sends the data packets to the BlackBerry Messaging Agent.

  7. The BlackBerry Messaging Agent verifies the validity of the attachment content, and stores the content in memory as the content arrives.

    During the delivery of the attachment content, if the BlackBerry Messaging Agent does not receive content from the BlackBerry device for 15 minutes, the BlackBerry Messaging Agent cancels the message, deletes the partial attachment content from temporary storage, and sends an error message to the BlackBerry device.

    After all of the attachment content arrives, the BlackBerry Messaging Agent checks for other attachments that might be part of the same message.
    • If other attachments exist, the BlackBerry Messaging Agent requests the attachment content.
    • If no additional attachments exist, the BlackBerry Messaging Agent finishes processing the message and stores the message in the mail.box for the IBM® Lotus Notes® router to deliver to the user's email application.

    The messaging server delivers the message to the intended recipients.

Process flow: Sending an email message using IBM Lotus Notes encryption

This diagram shows the elements that are described in the following process flow.
  1. A user indicates, using the menu in the messages application, that the BlackBerry® device must encrypt the email message.
  2. The BlackBerry device performs the following actions:
    1. prompts the user for the password for the IBM® Lotus Notes® .id file
    2. configures the email message for Lotus Notes encryption
    3. encrypts the email message using BlackBerry transport layer encryption
    4. sends the email message and password to the BlackBerry® Enterprise Server
  3. The BlackBerry Enterprise Server decrypts the email message using BlackBerry transport layer encryption.
  4. The BlackBerry Messaging Agent on the BlackBerry Enterprise Server decrypts the cached password for the Lotus Notes .id file and validates the password that the BlackBerry device sent. If the BlackBerry Messaging Agent can verify the password, the BlackBerry Messaging Agent uses the password to encrypt the message using Lotus Notes encryption.
  5. The BlackBerry Enterprise Server sends the encrypted email message to the messaging server so that the messaging server can deliver it to the recipient.

Process flow: Receiving an IBM Lotus Notes encrypted message

This diagram shows the elements that are described in the following process flow.
  1. A user uses the IBM® Lotus Notes® application on the user’s computer to encrypt a message using the password for the Lotus Notes .id file.
  2. The BlackBerry® Enterprise Server performs the following actions:
    1. retrieves the Lotus Notes encrypted message from the messaging server
    2. encrypts the Lotus Notes encrypted message using BlackBerry transport layer encryption
    3. sends the encrypted message to the BlackBerry device
  3. The BlackBerry device decrypts the message using BlackBerry transport layer encryption and stores the message without decrypting the Lotus Notes encryption.
  4. The user tries to open the Lotus Notes encrypted message on the BlackBerry device.
  5. The BlackBerry Messaging Agent on the BlackBerry Enterprise Server decrypts the cached password for the Lotus Notes .id file and uses the password to decrypt the message. If the BlackBerry Messaging Agent does not have the password, from the menu in the messages application, the user must select More, More All, or Open Attachment to send the decrypted message to the BlackBerry device.
  6. The BlackBerry Enterprise Server deletes the decrypted password from the BlackBerry Messaging Agent memory cache and sends the decrypted message to the BlackBerry device.

Was this information helpful? Send us your comments.