BlackBerry Administration Service for Microsoft Exchange Help 5.0 SP3

Changing how a BlackBerry Attachment Service converts attachments

If the BlackBerry® Enterprise Server receives requests from BlackBerry device users to view email message attachments, the BlackBerry Attachment Service converts the attachments into a DOM and caches the DOM locally. The BlackBerry Attachment Service accesses the DOM to process the requests. If users send requests to view the same message attachment again, the BlackBerry Attachment Service accesses the same DOM to process the requests. The BlackBerry Attachment Service keeps all of the cached data in memory only and never caches the original documents.

Each attachment conversion process allocates memory when it starts, uses memory on conversion, and caches the attachment DOM locally on the computer that hosts the BlackBerry Attachment Service. A larger cache size means that more memory is allocated to each running conversion process. The maximum file size of attachments impacts the amount of cached memory that the BlackBerry Attachment Service uses.

By default, the BlackBerry Attachment Service does not limit the file size of an attachment that is embedded in an email message or retrieved using a link. The BlackBerry Enterprise Server sends data to BlackBerry devices over the wireless network in packets that are no larger than 64 KB, and it can send an unlimited number of packets to BlackBerry devices.

You can change how the BlackBerry Attachment Service converts attachments by specifying a maximum file size for attachments that users can receive and controlling how the BlackBerry Attachment Service retrieves, distills, and converts attachment data.

BlackBerry Attachment Service optimization settings

Setting

Description

Range

Submit port

This setting specifies the TCP/IP port number that a BlackBerry® Attachment Service uses to listen for and receive attachment conversion requests in a predefined XML/binary protocol.

The default value is 1900.

—

Result port

This setting specifies the TCP/IP port number that a BlackBerry Attachment Service returns attachment conversion results to in a predefined XML/binary protocol.

The default value is 2000.

—

Configuration port

This setting specifies the TCP/IP port number that you can use with an XML protocol to configure or obtain configuration information for a BlackBerry Attachment Service, including version information, the number of conversion processes, and the number of cached documents.

The default value is 1999.

—

Document cache size

This setting specifies the maximum number of converted documents that can be located in the document cache (as DOM) for a single conversion process.

The default value is 32.

1 through 128

Maximum number of processes

This setting specifies the number of conversion requests that the BlackBerry Attachment Service can process at the same time. When you specify this value, consider the amount of available memory and the competing services on the computer that hosts the BlackBerry Attachment Service.

The default value is 4.

1 through 64

Process recycle time (minutes)

This setting specifies the length of time that an application conversion process can reuse system resources to reclaim space and prevent failed processes from occupying memory resources.

The default value is 25 minutes.

5 to 60 minutes

Maximum conversion threads

This setting specifies the number of documents that the BlackBerry Attachment Service can convert at the same time in a single conversion process. You can use this setting with the Server busy time setting to control thread saturation and manage the BlackBerry Attachment Service workload.

The default value is 4.

2 to 32

Server busy time (seconds)

This setting specifies the threshold at which the BlackBerry Attachment Service does not accept new conversion requests.

The default value is 120 seconds.

60 to 270 seconds

Allow remote services

This setting specifies whether you prevent or permit remote TCP/IP connections to the BlackBerry Attachment Service.

The default value is Yes.

—

Maximum archive (ZIP) level

This setting specifies how many levels of zipped files that the BlackBerry Attachment Service can process. For example, if you set this field to 2, the BlackBerry Attachment Service processes the .zip files within a .zip file. If you set this field to 1, the BlackBerry Attachment Service only lists the contents of a .zip file.

The default value is 1.

1 to 9
Last updated: 2011-09-16
© 2011 Research In Motion Limited. All Rights Reserved. | Glossary | Legal notice