JavaOS Properties List

come from http://docs.sun.com/app/docs/doc/805-3076-10/6j2ugcgv4?l=en&a=view&q=JavaOS+Properties

Setting Properties

You can set the properties that control JavaOS operation on the JavaStation in one of two places:

• In the DHCP Vendor Options (see Chapter8, Booting the JavaStation Using Solaris).

• In a text file referenced in the DHCP Vendor Options.

The second option is preferable because the total length of DHCP Vendor Options is limited to 255 characters. In contrast, the text file can have any length.

Syntax

Each property setting must use one of the flags in Table 9-6. There is no space between each flag and its value. Note that certain flags are used only for JavaOS properties, while others are used only forsystem properties.

Table 9-6 Property Flags

Flag

Syntax

Definition

-d	-dJavaOS_property=value	The property name and value are stored in the JavaOS properties object. The names of properties set with this option always begin with javaos. Example: -djavaos.kbd=UKPS2
-D	-Dsystem_property=value	The system property and value are stored in the global system properties object. Example: -Duser.timezone=PST.
-a	-aJavaOS_property=value	The JavaOS property is set to the given value if it has never been set before. If the property already has a value, then its current value is appended with a semicolon and the value. Example: -ajavaos.printservice.lpd.printer\ =printer2 This example sets the property javaos.printservice.lpd.printer to printer2 if the property has no current value. If the property already has a value (say, printer1), the new value is appended (printer1;printer2). This flag is useful if you are building the value of a property from multiple places using the -i option below. Note that this property can itself be a semicolon-separated list of values; the entire list is added or appended as described above.
-A	-Asystem_property=value	This works just like the -a option, except that it sets system properties.
-u	-uJavaOS_property	Used to undefine a JavaOS property.
-U	-Usystem_property	Used to undefine a system property.
-i	-iHTTP_URL	The HTTP URL is expanded and the file referenced by the URL is itself evaluated as if it were a JavaOS command line. Properties are stored one per line in this file. One file can use -i to include another file. There is currently no check on infinite recursion.

Properties will be interpreted as the JavaOS command line, which is a formatted text string of any length that is interpreted when JavaOS boots. The command line can include:

• JavaOS and system properties

• Arguments to be used by JavaOS or an application launched by JavaOS

The syntax of the command line is as follows:

prop_setting1 prop_setting2... prop_settingn -- arg1 arg2... argn

where prop_setting is a JavaOS property setting and arg is an argument. Property settings and arguments are separated by two contiguous hyphens.

JavaOS and System Properties

Table 9-1 to Table 9-5 list all JavaOS and system properties. The properties are grouped by function. Each table includes the name of the property, its default value, and a description of what the property controls. All properties are JavaOS properties unless marked as system properties.

---

Note -

Due to space constraints, property names may take up two or more lines in the tables below. However, they should be typed on one line only. For example, the first property in Table 9-1 is javaos.mountlist.

---

General Properties

Table 9-1 lists miscellaneous JavaOS properties.

Table 9-1 JavaOS General Properties

Property Name

Default Value

Description

javaos. mountlist	null	A semicolon-separated list of pairs of network paths and local paths. As soon as the network is up, each remote file system is mounted onto the local file system. The syntax of each pair is: server:remote_path|local_path For example, to enable localized keyboards, mount /REMOTE from the server and file system that has JavaOS: -djavaos.mountlist=myserver:/export/root/javaos/classes|/REMOTE See Chapter11, Setting Locales and Adding Fonts" for more details.
javaos. snmpSysContact	null	This property sets the value that will be returned in the system Management Information Base (MIB) for the system contact field. It can be set with a string of your choice, which should be enclosed in quotes. Example: -djavaos.snmpSysContact="Bob"
javaos. snmpSysLocation	null	This property sets the value that will be returned in the system MIB for the system Location field. It can be set with a string of your choice, which should be enclosed in quotes. Example: -djavaos.snmpSysLocation="Sun MPK14"
javaos.kbd	null	By default, JavaOS assumes you are using a U.S. keyboard, To enable a different keyboard, use the syntax javaos.kbd=keyboard. Possible values for keyboard are provided in Chapter11, Setting Locales and Adding Fonts."
javaos. consoleHotKey	VK_PRINTSCREEN	This property sets the keyboard hotkey that activates the JavaStation console, which displays debugging information. The value of the property is the JDK virtual keycode name for the hotkey. The following codes are valid: VK_F1 VK_F2 VK_F3 VK_F4 VK_F5 VK_F6 VK_F7 VK_F8 VK_F9 VK_F10 VK_F11 VK_F12 VK_PRINTSCREEN VK_UNDEFINED (to disable the console) The value of this property is case-insensitive; VK_PRINTSCREEN and vk_PrInTSCreen are equivalent.
javaos.login	true	If true, JavaOS displays a login screen after booting and before starting the initial application. If false, JavaOS runs the main application as soon as it boots, without displaying a login screen. This means there is no user home directory and no system properties are read from a properties file. You may want to use the javaos.homedir property to specify an NFS directory to mount (see below).
javaos. alwaysUpdate	null	This property specifies that JavaOS is always or never updated in the JavaStation's flash memory, regardless of the value of the JavaOS checksum. It is useful for public kiosks or other systems where user input is not expected. If not set, the default behavior occurs: if the DHCP-supplied checksum is present and is not zero and does not match the checksum stored in flash, then an Update Flash dialog is displayed. If set to true, then if the above conditions hold, no dialog is displayed and flash is updated. If set to any value other than true, then regardless of checksum presence/value, flash is not updated. Note that if the DHCP checksum is not present or is zero, the flash is not updated.
javaos. allowGuest	false	If true, the login screen (if displayed at all) will contain a guest login button.
javaos.homedir	null	This property specifies the NFS path JavaOS should mount if NIS is not used to find the path based on the user name. The NFS path is specified as hostname:/path. This property is most often used if the javaos.login property is set to false, or, if NIS is not enabled or available, to determine the directory to use for the properties file that is read by HotJava at launch.
javaos.dns	true	When set to true, host name-to-address and address-to-host name resolution is performed using the DNS protocol. See also javaos.nis. If lookup using NIS is enabled also, NIS is attempted first, and DNS is attempted only if NIS lookup fails. See also javaos.hostaddrmap and javaos.hostnamemap.
javaos. hostnamemap	host. byname	The name of the NIS map used to perform host name-to-address resolution.
javaos. hostaddrmap	host. byaddr	The name of the NIS map used to perform address-to-host name resolution.
javaos. homedirmap	auto.home(sought first), auto_home	If NIS is enabled, this property is used to set the name of the NIS map used by JavaOS to determine a user's home directory.
javaos.nis	true	When set to true, login authentication, host name-to-address resolution and address-to-host name resolution are performed using the NIS protocol. See also javaos.dns. If lookup using DNS is also enabled, NIS is attempted first, and DNS is attempted only if NIS fails.

Application Loading Properties

The properties listed in Table 9-2 control selection and loading of the main application on the JavaStation after the user logs in. For instructions on using these properties, see Chapter10, Dynamically Loading Applications .

Table 9-2 JavaOS Application Loading Properties

Property Name

Default Value

Description

javaos.apps	null	If defined, JavaOS launches a simple point-and-click Application Launcher window. This property should be set to the URL of an HTML document that lists the applications to display.
javaos. mainProgram	sun.applet. AppletViewer	Set to the name of the application's main class.
javaos. mainHomeprop	appletviewer	Set to the name of the property specifying the application's root directory. For example, HotJava Views uses the hotjava.home property to specify its root directory. Other applications may have different property names. When the virtual file system is created, this property is set to enable the application to find its files.
javaos.mainZip	null	Set to the name of the archive containing the application files.

User Properties

Table 9-3 lists miscellaneous user properties that affect JavaOS operation. Most are related to localization. Certain settings cause other settings to be assumed. For example, setting user.region to ja causes the system to assume the JST time zone, even if user.timezone is not defined.

Table 9-3 JavaOS User Properties

Property Name

Default Value

Description

user.timezone	null	This system property tells the Java date and time API the time zone in which the JavaStation system is located. Example: -Duser.timezone=PST. Valid time zones are as follows (this list is from java.util.TimeZone.) GMT - Greenwich Mean Time ECT - European Central Time EET - Eastern European Time ART - (Arabic) Egypt Standard Time EAT - Eastern African Time MET - Middle East Time NET - Near East Time PLT - Pakistan Lahore Time IST - India Standard Time BST - Bangladesh Standard Time VST - Vietnam Standard Time CTT - China Taiwan Time JST - Japan Standard Time ACT - Australia Central Time AET - Australia Eastern Time SST - Solomon Standard Time NST - New Zealand Standard Time MIT - Midway Islands Time HST - Hawaii Standard Time AST - Alaska Standard Time PST - Pacific Standard Time PNT - Phoenix Standard Time MST - Mountain Standard Time CST - Central Standard Time EST - Eastern Standard Time IET - Indiana Eastern Standard Time PRT - Puerto Rico and US Virgin Islands Time CNT - Canada Newfoundland Time AGT - Argentina Standard Time BET - Brazil Eastern Time CAT - Central African Time
user.language	en	This system property must be set to a valid, lowercase, ISO-639 Language Code. Valid codes are listed at http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt. Example: -Duser.language=en
user.country	null	This system property must be set to a valid ISO-3166 Country Code. Valid codes are listed at http://userpage.chemie.fu-berlin.de/diverse/doc/ISO_3166.html. Example: -Duser.country=US

Printing Properties

Table 9-4 lists properties related to printing.

Table 9-4 JavaOS Printing Properties

Property Name

Default Value

Description

javaos. printservice. NIS.mapname	printers. conf	The name of the NIS map used to locate printers.
javaos. printservice. lpd.printers	null	A semicolon-separated list of printers available for use by the lpd printing client. The format of each entry is printer@server
javaos. printdialog. alwaysShow Printers	null	A semicolon-separated list of the printers available from this host. This property enables administrators to add access to the printer nearest a given JavaStation. The syntax of the printer name is the print service name, a colon, and the full name used by the print service to identify the printer. Example: -djavaos.printdialog.alwaysShowPrinters= lpd:raw@konaprint;lpd:ps@konaprint; NIS:droid@fred
javaos. printers. selected	null	A semicolon-separated list of the printers the user has selected to appear in print dialogs. The format is the same as for alwaysShowPrinters. This is a system property. Example: -Djavaos.printers.selected.
javaos. printservice. local.params. serial-port	null	The port portion of this property is the name of a serial port (which is always Serial for the JavaStation). This property sets the communications parameters for the serial port. The syntax of the parameters is baud_rate:data_bits:stop_bit: parity: flow_control. For example: -djavaos.printservice.local.params. serial-Serial=57600:8:1:none:hh Valid values for each parameter are as follows: baud_rate: 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 data_bits: 5, 6, 7, 8 stop_bits: 1, 1.5, 2 parity: none, odd, even flow_control: none, {s,h}{s,h} You can disable flow control by specifying none. Otherwise, specify an {input}{output} pair by selecting from Xon/Xoff (s) or RTS/CTS (h) for input and output.

Localization Properties

Table 9-5 lists properties related to localization.

Table 9-5 JavaOS Localization Properties

Property Name

Default Value

Description

javaos.font. properties. home	/FONTS	The local path name of a directory that contains a lib subdirectory. The font.properties files are read from this lib directory. The javaos.mountlist property is typically used to associate some server path with the /FONTS directory to enable JavaOS to load and use fonts from a server. For more information, refer to Chapter11, Setting Locales and Adding Fonts."
javaos.im. compose. deadkeys	false	This property changes the following keys into accent keys: '(single quote) "(double quote) `(grave accent) and ^(circumflex). Use this property if your keyboard is a U.S. keyboard, you are not setting the javaos.kbd property, and you wish to produce accented characters for ISO Latin locales. If set to true, the above keys do not produce a value of their own but cause the next key pressed to be an accented character. For example, pressing ' plus "a" produces á. If this property is false, these keys generate their expected values.
javaos.im.url	null	Set this property to the host name of the machine running Asian or Japanese Solaris that has the language engine you want to access. (A Microsoft Windows95` or Microsoft NT` system can also be used if a IIIMP (Internet/Intranet Input Method Protocol) server from JavaSoft` for the PC server is installed on it.) Set as follows: iiimp://iiimphost:port/engine where: iiimphost is the system running the language engine port is 9010 by default but can be different if configured that way during the server installation. Valid values of engine are provided in Chapter11, Setting Locales and Adding Fonts."
javaos. loginLocaleList	en_US	A semicolon-separated list of the locales to be presented as choices to the user at login. A locale is defined using one of the ISO-639 standard two-letter codes that define user.language followed by an underscore character "_" and one of the ISO-3166 standard two-letter codes that define user.country. For example: -djavaos.loginLocaleList=\ en_US;fr_FR;ja_JP;zh_CN;zh_TW
javaos.im. lookup.button	false	This property controls how the JavaStation user selects characters when using a Korean, Japanese, or Chinese input method. If false, when the list of candidate characters is displayed, letters are used to indicate each choice, and the user selects a choice by typing the letter. If true, letters are replaced with buttons so that the user clicks on a button to pick a choice. Note that enabling this option will negatively impact user input performance.
javaos.im. status.fixpopup	false	Setting this property to true enables a pop-up window with input method status information.