Runtime environment notes

Localization

The labels of fields, attributes, array elements, and list names are localized.

The methods PIMList.getFieldLabel(), PIMList.getAttributeLabel(), PIMList.getArrayElementLabel(), and PIMList.getName() should be used for obtaining these localized labels.

Security settings

Security vulnerable operations in PIM API belong to two Function groups:

  • Read User Data Access

  • Write User Data Access

All methods which may throw a SecurityException (according to the API specification) are considered security vulnerable. Permission to access any security vulnerable operation are checked on every invocation.

The following table describes the security policy for the PIM API related Function groups:

Table 17: The security policy for the PIM API related Function groups

Function group

Identified Third Party Protection domain

Unidentified Third Party Protection domain

Read User Data Access

Default setting: Oneshot

Other settings: Blanket, Session, No

Default setting: Oneshot

Other settings: No

Write User Data Access

Default setting: Oneshot

Other settings: Blanket, Session, No

Default setting: Oneshot

Other settings: No

Explanation for the table values are as follows:

  • “Blanket” is valid for every invocation of an API by a MIDlet suite until it is uninstalled or the permission is changed by the user.

  • “Session” is valid from the invocation of a MIDlet suite until it terminates. “Session” mode must prompt the user on or before the first invocation of the API or function, which is protected. When the user re-invokes the MIDlet suite the prompt must be repeated as the user previously defined.

  • "Oneshot" means that the mode must prompt the user every time when the API or a protected function is invocated.

  • “No” means that the MIDlet can’t access the protected function at all.