System properties

The table below defines the generic system properties used by Series 40 and S60 devices. All system properties are available to the application by calling the method java.lang.System.getProperty

**Table 56:** Generic system properties
System property	Description	Value
`microedition.platform`	Name of the host platform or device. Includes information about the device model number and version, platform version, and Java build version. Note: Series 40 is abbreviated S40 in the `sw_platform` parameter	`[DeviceModel]_[ModelVersion(optional)] / [FirmwareVersion] / [sw_platform]; [sw_platform_version]; [java_build_version]` For example: `Nokia5800d-1/20.0.012/sw_platform=S60; sw_platform_version=5.0; java_build_version=1.3.4`
`microedition.encoding`	Character encoding.	Always returns `ISO-8859-1`.
`microedition.configuration`	Name and version of the supported configuration.	`CLDC-1.0` or `CDLD-1.1`
`microedition.profiles`	Name of the supported MIDP profile. Devices that implement other profiles also return names of those profiles.	`MIDP-n.n`, for example `MIDP-2.1`
`microedition.locale`	The current locale on this device. Note: The set of locales supported by the device depends on the languages and region.	Locale in `[language]-[LOCATION]` format. For example `en-US`.
`microedition.commports`	A comma-separated list of ports. It can be combined with a `comm:` prefix as the URL string to be used when opening a serial port connection.	Defined in `javax.microedition.io.CommConnection`.
`microedition.hostname`	The local hostname, if it is available.	`localhost`
`microedition.jtwi.version`	Version number of the supported JTWI Specification	Always returns `1.0`
`microedition.msa.version`	Version number of the supported MSA Specification, or the subset of MSA.	The possible values are `1.0` or `1.0-SUBSET`.

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

**Table 57:** Nokia system properties
System property	Description	S60 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.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 FP 2
`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 FP 2		hh:mm a
`com.nokia.mid.batterylevel`	The battery charge level of device.	S60 3rd Edition FP 2		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 FP 2		`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.mid.countrycode`	Current network country code.	S60 3rd Edition FP 2		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 (NMC) in GSM) and network short name.	S60 3rd Edition FP 2		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.	S60 3rd Edition FP 2	Series 40 3rd Edition FP 1
`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.	S60 3rd Edition FP 2	Series 40 5th Edition FP 1
`com.nokia.mid.networkstatus`	Whether the device is in home network or roaming currently.	S60 3rd Edition FP 2		`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 FP 2		`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 FP 2		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.	S60 3rd Edition FP 2	Series 40 3rd Edition FP 1	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.	S60 3rd Edition FP 2	Series 40 5th Edition FP 1	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.msisdn`	The MSISDN (Mobile Station International Subscriber Directory Number) stored in the SIM card. This property is available only in manufacturer and operator domain.	S60 3rd Edition FP 2 (Only in Java Runtime 1.3 for S60 and later)		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

The com.nokia.mid.timeformat and com.nokia.mid.dateformat system properties indicate the user preferences of date and time formats.

For example, in many devices there are settings available for 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 above system properties indicate the currently active user preferences for these settings. MIDlets can use these values to format date and time strings they, for example, need to display in user interfaces.

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