[hdawg]

Turn on or turn off the Enterprise-Only Message Application icon in BlackBerry Enterprise Server software version 4.1.5
Doc ID : KB15003
Last Modified : 2008-06-05
Document Type : How To


Print this page

Environment

* BlackBerry® Enterprise Server software version 4.1 Service Pack 5 (4.1.5)
* BlackBerry® Desktop Manager 4.2 and later
* BlackBerry® Device Software 4.1 and later



Procedure

BlackBerry Enterprise Server 4.1 Service Pack 5 (4.1.5) introduces a feature that allows the administrator to add an icon on the Home screen of each BlackBerry smartphone in a BlackBerry domain. This icon will allow BlackBerry smartphone users to list only messages which are received from their organization's BlackBerry Enterprise Server. This feature sets a flag in the service book, which will turn on or turn off the icon. The name of the icon will be the same as the name of the service book, as specified in the Message service display name field on the Advanced tab of the Email Settings applet of the BlackBerry Desktop Manager software. The default setting for this feature is turned off. The following procedure indicates how it can be turned on and subsequently turned off.

Warning: Do not edit the files. Importing a modified file may cause problems on the BlackBerry Enterprise Server.

To turn the feature on or off, complete the following steps:

1. Unzip the BESOnlyMessageApplication.zip file to a temporary folder on the local computer.
2. From a command prompt, change the current directory to the temporary folder from step 1.
3. Use the BBDBUpdate.exe command line tool with one of the following files:

* To turn on this feature, the input file will be EnableBESOnlyMessageApplication.sql
* To turn off this feature, the input file will be DisableBESOnlyMessageApplication.sql

Note: The name of the file must be passed in using the -input parameter.

To find a list of command-line parameters for the BBDBUpdate.exe tool, run the tool from the command prompt with no parameters. Review the usage help screen to determine what parameters will be needed for your particular installation.

4. After running the BBDBUpdate.exe tool, review the screen output for any errors.

Once the database script is applied to the database, the BlackBerry Enterprise Server must send updated service book data to each BlackBerry smartphone. Once the service book data is received on the BlackBerry smartphone, the changes will be visible on the Home screen of the BlackBerry smartphone. If you are turning on this feature, a new message list application icon will appear, which will be labeled with message service display name as described earlier. If you are turning off this feature, the icon will disappear from the Home screen once the update is applied to the BlackBerry smartphone.

BESOnlyMessageApplication.zip

[porod]

Has anyone tried this? One of our users was interested in keeping their BIS emails from going into the "Messages" icon.

Is Desktop Manager software required? We don't typically install it on the user PCs.

[hdawg]

Originally Posted by porod

Has anyone tried this? One of our users was interested in keeping their BIS emails from going into the "Messages" icon.

Is Desktop Manager software required? We don't typically install it on the user PCs.

This will not prevent BIS email from going to the "Messages" icon. This creates a NEW icon, for BES email only.

DM is not required; this is a server setting change.

[RaGe]

Thank's for this message,

It's works perfect !!! Just one question : How can I rename the new Icon ?
The default Name is Desktop (1) not terrible....

++

[Frank Castle]

Not possible (yet) .. Main reason why I didn't do this in production. I'd like the icon to be "Company Name Email"

Supposedly it will be fixed to allow this in SP 6 or BES 5.0

[hdawg]

Originally Posted by jletendre

Not possible (yet) .. Main reason why I didn't do this in production. I'd like the icon to be "Company Name Email"

Supposedly it will be fixed to allow this in SP 6 or BES 5.0

You're in a big group ... I know of a few people that have submitted this request ... me included!

[HilltopJim]

Can the Enterprise-Only Message Application be enabled on Blackberry Professional software 4.1.4.3?

I tried it this morning and received the following error:

D:\>bbdbupdate.exe -db besmgmt -input D:\EnableBESOnlyMessageApplication.sql
BlackBerry Configuration Database Update tool Version 4.1.4.8
Copyright (c) Research In Motion, Ltd. 2000-2007. All rights reserved.
Modification date: Aug 8 2007

[20000] (07:27:57.879):{0x17C4} Connect to database server: localhost
[20000] (07:27:57.879):{0x17C4} Database name: besmgmt
[20000] (07:27:57.894):{0x17C4} Database connection opened!
[20000] (07:27:57.894):{0x17C4} Reading input file: D:\EnableBESOnlyMessageAppli
cation.sql
[10000] (07:27:57.894):{0x17C4} Problem occured while executing SQL commands.

Thanks,

Jim

[penguin3107]

Originally Posted by HilltopJim

Can the Enterprise-Only Message Application be enabled on Blackberry Professional software 4.1.4.3?

No, this is a BES feature, for BES versions 4.1.5 and higher.

[icontech]

Did anything change with these directions for SP6?

I would love it if you could do this on a per user level.

[Frank Castle]

No it's a global change and once you activate the user will have a new "messages" icon labeled "desktop" that will have your company email.

Until I can customize the name of the icon I'm not moving this out (though users would love it) I think it would be too confusing.

[fleece]

I really wish I could turn this feature on/off at the user level before BES 5.0 releases. I've had a few people move to Windows Mobile devices and ActiveSync because of it. I'd rather keep people on BB because there are less help desk calls for me on BB than Windows.