Nokia-specific system properties

The table below defines the Nokia-specific system properties used by Series 40 and Symbian devices.

**Table:** Nokia system properties
System property	Description	Symbian Release	Series 40 release	Value
`com.nokia.memoryramfree`	This can be used to query the available RAM in the operating system. This is a more realistic estimate of available RAM on the device than what is returned by `Runtime.getRuntime().freeMemory()`, which returns only free memory in the Java virtual machine. Note: This property is not available on all S60 3rd Edition devices.	S60 3rd Edition
`com.nokia.mid.calendars`	Returns the database names of all the calendars available on the device. For more information about calendars, see the following sections: Event list database Managing multiple calendars.	Symbian^3 (Java Runtime 2.2)		Returns the database names of the calendars. The names are separated by commas.
`com.nokia.mid.dateformat`	The preferred date format indicated as a string pattern, which is formatted according to the rules defined in Java 2, Standard Edition, version 1.4.1, `java.text.SimpleDateFormat` class documentation for date patterns.	S60 3rd Edition FP2	Series 40 3rd Edition
`com.nokia.mid.timeformat`	The preferred time format indicated as a string pattern, which is formatted according to the rules defined in Java Standard Edition, version 1.4.1, `java.text.SimpleDateFormat` class documentation for time patterns.	S60 3rd Edition FP2	Series 40 3rd Edition	hh:mm a
`com.nokia.mid.ui.customfontsize`	Returns `true` if the device supports the `DirectUtils.getFont` method, which is used for creating fonts with a custom height. Otherwise, returns `false`.	Symbian^3 (Java Runtime 2.1)
`com.nokia.mid.ui.frameanimator.fps`	Default platform value for maximum frames per second (fps). This can be used when specifying the maximum fps for a linear drag or kinetic scroll animation.		Series 40 6th Edition FP1	Returns the default maximum fps as a short integer.
`com.nokia.mid.ui.frameanimator.pps`	Default platform value for maximum pixels per second (pps). This can be used when specifying the maximum pps for a kinetic scroll animation.		Series 40 6th Edition FP1	Returns the default maximum pps as a short integer.
`com.nokia.mid.ui.screensaverprevention`	Returns `true` if the device supports the `DeviceControl.resetUserInactivityTime` method, which can be used for preventing the screen saver from starting. Otherwise, returns `false`.	Symbian^3 (Java Runtime 2.1)
`com.nokia.mid.ui.tactilefeedback`	Returns `true` if the device supports the `com.nokia.mid.ui.TactileFeedback` class. Otherwise, returns `false`. For more information about tactile feedback in touch devices, see section Tactile feedback.	Symbian^3 (Java Runtime 2.1)
`com.nokia.mid.batterylevel`	The battery charge level of device.	S60 3rd Edition FP2		Returns the percentage value of battery level.
`com.nokia.network.access`	Network access type of used active connection or a set default access point.	S60 3rd Edition FP2	Series 40 3rd Edition	`pd` - Packet data in GSM network `pd.EDGE` - Packet data in EDGE network `pd.3G` - Packet data in 3G network `pd.HSDPA` - High speed downlink packet access for 3G networks `csd` - Circuit switched data, for example GSM CSD/HSCSD data call `bt_pan` - Bluetooth PAN network `wlan` - Wireless network, for example 802.11b, 802.11G or WiMaX `na` - Not applicable, the implementation can’t determine the type
`com.nokia.midp.impl.isa.network.databearer`	Returns the type of GPRS support.		Series 40 5th Edition FP1	Possible values include, for example: `GPRS` `EGPRS` `GPRS over UMTS`
`com.nokia.dir.name:xxxx`	Returns the full path translated name.		Series 40 5th Edition FP1	Returns the full path translated name, for example: `String gameFolderString = System.getProperty("com.nokia.dir.name: C:\\predefjava\\predefgames")`
`com.nokia.mid.countrycode`	Current network country code. On Symbian devices this property is available for all applications. From JRT 2.1 onwards this property is bound to the Location function group. Security prompting behaves according to Location function group settings.	S60 3rd Edition FP2		Returns the mobile country code defined in ITU-T Recommendation E.212
`com.nokia.mid.networkid`	Network identification parameters (Network Identification Number (NID) in CDMA and Mobile Network Code (MNC) in GSM) and network short name. On Symbian devices this property is available for all applications. From JRT 2.1 onwards this property is bound to the Location function group. Security prompting behaves according to Location function group settings. On Series 40 devices, this property is available only in the manufacturer and operator domains.	S60 3rd Edition FP2	Series 40 3rd Edition FP1	Returns two values: network ID network short name For a list of possible values, see list of MNCs
`com.nokia.mid.cellid`	On 2G devices, returns identity of the cell from which a mobile telephony call was made or received. On 3G devices, returns UC-ID (UTRAN ID) value, which is a combination of Radio Network Controller ID (RNC-ID) and cell ID. On Symbian devices this property is available for all applications. From JRT 2.1 onwards this property is bound to the Location function group. Security prompting behaves according to Location function group settings. On Series 40 devices, this property is available only in the manufacturer and operator domains.	S60 3rd Edition FP2	Series 40 5th Edition FP1
`com.nokia.mid.lac`	Returns current GSM location area code (LAC) as a string. The SIM card must be inserted and service acquired in order to return a LAC value, otherwise returns `null`. This value applies only to 2G devices. On Series 40 devices, this property is available only in the manufacturer and operator domains.	S60 3rd Edition FP2	Series 40 5th Edition FP1
`com.nokia.mid.impl.nativeDigitSupport`	Returns the setting from a user menu option elsewhere in the phone software.		Series 40 5th Edition FP1
`com.nokia.mid.ui.layout`	Returns layout alignment.		Series 40 6th Edition FP1	Returns the string `ltr`, if the native layout is left-to-right aligned. Returns the string `rtl` if the native layout if right-to-left aligned.
`com.nokia.mid.ui.version`	Returns the Nokia UI API version supported by the device.	S60 3rd Edition FP2		`<X.X>` For example: `1.2`
`com.nokia.mid.settings.ombActive`	Whether OMB is enabled or disabled. This property is available only in the manufacturer and operator domains.		Series 40 6th Edition FP1	Returns the string `On` if the user has enabled OMB. Returns the string `Off` if the user has disabled OMB.
`com.nokia.mid.networkstatus`	Whether the device is in home network or roaming currently.	S60 3rd Edition FP2		`home` - The device is in the home network `roaming` - The device is roaming `unknown` - The status of the network is unknown
`com.nokia.mid.networkavailability`	Network availability.	S60 3rd Edition FP2		`available` or `unavailable`
`com.nokia.mid.networksignal`	Current (GSM/CDMA) network signal strength. The output format is as follows: `<the number of bars the phone should display>(<the signal strength in dBm> dBm)`	S60 3rd Edition FP2		Returns two values: the number of bars the phone should display the signal strength in dBm
`com.nokia.mid.imei`	The IMEI (International Mobile Equipment Identity) of the device. On Series 40 devices, this property is available only in the manufacturer and operator domains.	S60 3rd Edition FP2	Series 40 3rd Edition FP1	Returns a 14 digit decimal number that uniquely identifies the device.
`com.nokia.mid.imsi`	The IMSI (International Mobile Subscriber Identity) stored in the SIM card. Note that the access to this system property is limited with `com.nokia.mid.Mobinfo.IMSI` permission. By default, this permission is available only in manufacturer and operator domain. On Series 40 devices, this property is available only in the manufacturer and operator domains.	S60 3rd Edition FP2	Series 40 3rd Edition FP1	Returns the subscriber number associated with the device. The IMSI number is usually 14 decimal digits long, but it may be shorter.
`com.nokia.mid.spn`	Returns service provider name (if available on SIM). In Series 40, this property is available only in the manufacturer and operator domains. In Symbian, this property is available for all applications. From JRT 2.2 onwards this property is bound to the `'Read user data`' function group. Security prompting behaves according to '`Read user data`' function group settings."	Symbian^3 (Java Runtime 2.2)	Series 40 3rd Edition FP1	Returns `""` if not available, and `null` if the API is not supported.
`com.nokia.mid.mnc`	Returns the Mobile Country Code (MCC) and Mobile Network Code (MNC). This property is available only in the manufacturer and operator domains.		Series 40 3rd Edition FP1	Returns the MCC and MNC as a 4 to 6 digit string (depending on operator).
`com.nokia.mid.ons`	Returns operator name. This property is available only in the manufacturer and operator domains. In Symbian, this property is available for all applications. From JRT 2.2 onwards this property is bound to the `'Read user data`' function group. Security prompting behaves according to '`Read user data`' function group settings."	Symbian^3 (Java Runtime 2.2)	Series 40 3rd Edition FP1	Returns operator name as string.
`com.nokia.mid.gid1`	Returns Group Identifier level 1 (GID1). This property is available only in the manufacturer and operator domains.		Series 40 6th Edition	The structure of GID1 and GID2 are identical. They are provided to allow the network operator to enforce different levels of security dependant on application.
`com.nokia.mid.gid2`	Returns Group Identifier level 2 (GID2). This property is available only in the manufacturer and operator domains.		Series 40 6th Edition	The structure of GID1 and GID2 are identical. They are provided to allow the network operator to enforce different levels of security dependant on application.
`com.nokia.mid.msisdn`	The MSISDN (Mobile Station International Subscriber Directory Number) stored in the SIM card. This property is available only in the manufacturer and operator domains.	Newer S60 3rd Edition FP2 devices and devices with Java Runtime 1.3	Series 40 6th Edition	Returns all MSISDN numbers stored in the SIM separated by blank (Unicode U+0020). One MSISDN number is usually maximized to 15 decimal digits. Note: SIM cards do not necessarily contain a single MSISDN. If none are present, `com.nokia.mid.msisdn` returns `null`.
`com.nokia.canvas.net.indicator.location`	Indicates the area covered by the networking indicator in full-screen mode `Canvas`.	S60 5th Edition		`x,y,width,height` Used only when `Canvas` in full-screen mode and set as the current `Displayable`. Otherwise returns `null`.
`com.nokia.softkey1.label.location`, `com.nokia.softkey2.label.location` and `com.nokia.softkey3.label.location`	Indicates the position of the left (1), right (2) and middle (3) softkey labels, respectively.	S60 5th Edition		`x,y,width,height` Used only when `Canvas` in full-screen mode and set as the current `Displayable`. Otherwise returns `null`. For an example on using softkey labels, see section Setting softkey label location
`com.nokia.softkey1.label.anchor`, `com.nokia.softkey2.label.anchor` and `com.nokia.softkey3.label.anchor`	Indicates the alignment of the left (1), right (2) and middle (3) softkey labels, respectively.	S60 5th Edition		Used only when `Canvas` in full-screen mode and set as the current `Displayable`. The value is the combined (bitwise OR) values of anchor points as defined in MIDP specification in `javax.microedition.lcdui.Graphics`. The anchor point values are presented in decimal as Unicode digits. Otherwise returns `null`. For an example on using softkey labels, see section Setting softkey label location
`com.nokia.mid.cmdline`	Returns the whole command line input when launching applications with parameters. A parameter can be mapped to a value (`param=value`) or it can itself represent a boolean value, for example `silent` or `WizardMode`. In the latter case, `getProperty` returns an empty string (`""`) for the parameter.	Symbian^3 (Java Runtime 2.1)		`param1=value1;param2=value2;param3=value3;param4`
`com.nokia.mid.cmdline.instance`	Returns the number of times the MIDlet has been launched.	Symbian^3 (Java Runtime 2.1)		An incremental number of times the MIDlet has been launched.
`com.nokia.pointer.number`	Returns pointer number when multipoint touch events are enabled.	Symbian^3 (Java Runtime 2.2)		The pointer number of the pointer that generated a pointer event. This system property exists only in scope of `Canvas` methods `pointerPressed`, `pointerDragged` or `pointerReleased`. Outside of these methods, or when multipoint touch events are not enabled, the returned value is null.

The com.nokia.mid.timeformat and com.nokia.mid.dateformat system properties indicate the user preferences of date and time formats. For example, on many devices there are settings available for the user to indicate the date and time formatting settings: ordering of date, month and year components of date strings, separators used between components of date and time strings, whether 12 or 24 hour clock is used, and so on. The values of the above system properties indicate the currently active user preferences for these settings. MIDlets can use these values, for example, to format date and time strings they need to display in the user interface.

For a list of keypad-oriented system properties, see section System properties for keypad settings.