System properties

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

**Table 38:** 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 `NokiaE70/4.42/sw_platform=S60;sw_platform_version=3.0;java_build_version=74327`
`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 S60 specific system properties used by S60 platform.

**Table 39:** Nokia system properties
System property	Description	Release	Value
`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.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. Only subset of `SimpleDateFormat` defined pattern letters are used in this system property.	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. Only subset of `SimpleDateFormat` defined pattern letters are used in this system property.	S60 3rd Edition FP 2	hh:mm a
`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.batterylevel`	The battery charge level of device.	S60 3rd Edition FP 2	Returns the percentage value of battery level.
`com.nokia.mid.countrycode`	Current network country code.	S60 3rd Edition FP 2	Returns the two-letter country code defined in ISO-3316.
`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.networkid`	Network identification parameters, such as network ID (NID in CDMA and MNC in GSM) and network short name.	S60 3rd Edition FP 2	Returns two values: network ID network short name
`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.cellid`	Identity or location label of the cell from which a mobile telephony call was made or received.	S60 3rd Edition FP 2	Returns the cell ID.
`com.nokia.mid.imei`	The IMEI (International Mobile Equipment Identity) of the device.	S60 3rd Edition FP 2	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	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	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,weight,height` Used only when `Canvas` in full-screen mode and set as the current `Displayable`. Otherwise returns `null`.
`com.nokia.softkey1.label.location`	Indicates the position of the left softkey label	S60 5th Edition	`x,y,weight,height` Used only when `Canvas` in full-screen mode and set as the current `Displayable`. Otherwise returns `null`.
`com.nokia.softkey2.label.location`	Indicates the position of the right softkey label	S60 5th Edition	`x,y,weight,height` Used only when `Canvas` in full-screen mode and set as the current `Displayable`. Otherwise returns `null`.
`com.nokia.softkey3.label.location`	Indicates the position of the middle softkey label	S60 5th Edition	`x,y,weight,height` Used only when `Canvas` in full-screen mode and set as the current `Displayable`. Otherwise returns `null`.
`com.nokia.softkey1.label.anchor`	Indicates the alignment of the left softkey label	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`.
`com.nokia.softkey2.label.anchor`	Indicates the alignment of the right softkey label	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`.
`com.nokia.softkey3.label.anchor`	Indicates the alignment of the middle softkey label	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`.

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.