Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

PIM APIs

The PIM APIs include packages that allow you to access address books, calendars, tasks, and memopads from your application. The BlackBerry smartphone fully supports the J2ME PIM implementation established in JSR 75, and provides a number of custom extensions.

The javax.microedition.pim package provides interfaces that allow you to access PIM data on a smartphone. PIM data is organized into PIM lists, items, and fields. PIM lists are databases that contain all PIM items. PIM lists maintain categories, which are logical groupings for the PIM items contained in the list. Each PIMList object can support zero or more categories. Categories are represented by unique String names.

A PIMItem object represents a collection of data for a single PIM entry. A PIMItem is a grouping of related fields, with each field consisting of a label, a data type, value(s), and attribute(s). A PIM item is created from a particular PIM list and is associated with that list for the life of the item. A PIM item can have its data imported and exported using standard byte-based formats. Each implementing class defines what formats can be imported and exported for that item.

You can launch PIM applications with the BlackBerry Invoke API.

RIM extensions

RIM extensions to J2ME PIM are in the net.rim.blackberry.api.pdap package. These extensions include:

  • Support for multiple calendars, multiple calendar lists, and contact lists
  • Reading and writing to MemoPad
  • Getting and setting recurrence for ToDo items
  • Setting a standard UI for selecting a contact
  • Global Address List (GAL) lookups (for BlackBerry Enterprise Server environments)