2.6.9 Desktop Properties

This section describes the Desktop related properties that you can set in the STR.

A subset of the properties below are explicitly set in the file default.conf during installation. This file must not be updated. If you want set or or override properties, you should update client.conf instead.

Note!

You can override properties in the STR using the Desktop Launcher. For further information, see 1.1.1 Desktop Launcher in the Desktop User's Guide.

Advanced Properties
java.library.path	Default value: `${mz.home}/common/lib/native` This property must be set to `${mz.home}/common/lib/native`.
mz.crypto.hash.algorithm	Default value: SHA-256 This property is to use the crypto algorithm for hashing data, for example, files.
mz.crypto.key.crypt	Default value: AES This property is to use the crypto algorithm to encrypt and decrypt sensitive data within communications, for example, passwords. The value can be set to AES/GCM/NoPadding for a higher level of security. Note! If you have set the value to AES/GCM/NoPadding, and you try to decrypt data, and it does not succeed on the first attempt, the property value reverts to AES.
mz.crypto.key.stream	Default value: PBKDF2WithHmacSHA256 This property is to encrypt configurations when you have a user password for the encryption. The value can be set to PBEWithMD5AndDES. Note! If the decryption fails when using the selected algorithm, it will try to use the other algorithm.
mz.editor.use.bold.italic	Default value: true If the cursor is out of position in the APL or Ultra Editor in the Desktop, this may be due to problems with bold and italic fonts. To fix this issue, add this property and set the value to `false`.
mz.gui.apl.color.comments	Default value: `#b22222` With this property you can specify the color you want to use for comments in the APL code. Colors are entered in hex format, e g "#666666".
mz.gui.apl.color.constants	Default value: #`add8e6` With this property you can specify the color you want to use for constants in the APL code. Colors are entered in hex format, e g "#666666".
mz.gui.apl.color.error	Default value: `#ff0000` With this property you can specify the color you want to use for errors in the APL code. Colors are entered in hex format, e g "#666666".
mz.gui.apl.color.functions	Default value: `#0000ff` With this property you can specify the color you want to use for functions in the APL code. Colors are entered in hex format, e g "#666666".
mz.gui.apl.color.keywords	Default value: #a020f0 With this property you can specify the color you want to use for keywords in the APL code. Colors are entered in hex format, e g "#666666".
mz.gui.apl.color.normal	Default value: `#000000` With this property you can specify the color you want to use on your regular APL code. Colors are entered in hex format, e g "#666666".
mz.gui.apl.color.owntypes	Default value: `#b8860b` With this property you can specify the color you want to use for user defined types in the APL code. Colors are entered in hex format, e g "#666666".
mz.gui.apl.color.strings	Default value: `#bc8f8f` With this property you can specify the color you want to use for strings in the APL code. Colors are entered in hex format, e g "#666666".
mz.gui.apl.color.types	Default value: `#228b22` With this property you can specify the color you want to use for types in the APL code. Colors are entered in hex format, e g "#666666".
mz.gui.apl.syntaxfile	Default value: `""` With this property you can specify a file that contains further components within the APL code that you want to be able to highlight. The value should contain path and file name to the syntax file.
mz.gui.apl.syntaxhighlighting	Default value: yes This property specifies whether you want the text in your APL code to be color coded according to code definitions or not. The text is color coded according to the following definitions; brown = strings, dark blue = functions, light blue = constants, green = types, orange = user defined types, purple = key words, red = comments
mz.gui.color.space.active	Default value: `""` This property can be added in order to change the background color of the Desktop. Possible values are: blue, `green`, `yellow`, `orange`, `red`, `darkblue`, `darkgreen`, `magenta`, or `darkred`.
mz.gui.editor.autocomplete	Default value: `true` This property specifies whether you want the editor to automatically close brackets, parentheses, and quotation marks. Disable it by specifying `"false".`
mz.gui.editor.command	Default value: `notepad.exe` This property specifies the command used for starting the editor you want to use for editing APL code or Ultra Formats. If you, for example, want to use Emacs the command should be `emacs.exe`.
mz.gui.editor.menufontsizes	Default value: `8,10,12,14,18,20,24,36` This property specifies the font sizes you want to be able to choose from when editing APL code or Ultra Formats in the APL Code Editor and the Ultra Format Editor. The current value is displayed between the "-" and "+" magnifying glasses to the left in the button list in the editors and can be changed by clicking on the magnifying glasses, or using the key combinations CTRL+ and CTRL- The current value can also be changed by opening the right-click popup menu and selecting Font Size.
mz.gui.editor.name	Default value: N`otepad` This property specifies the editor display name in menus.
mz.gui.restart.tabs	Default value: `false` This property determines whether the tabs that are open when exiting Desktop should be remembered or not. The default behavior is that the tabs will not be remembered, but setting this property to `true` will restore the open tabs the next time Desktop is opened. Note! Setting this property to `true` may cause the startup of Desktop to be bit slower.
mz.gui.systemexport.default.dir	Default value: `""` This property can be added in order to configure the default directory you want to use when clicking on the Browse... button when doing a system export. The value must be the full path to an existing directory, e g `/home/mz`.
mz.gui.systemimport.default.dir	Default value: `""` This property can be added in order to configure the default directory you want to use when clicking on the Browse... button when doing a system import. The value must be the full path to an existing directory, e g `/home/mz`.
mz.gui.udreditor.limit	Default value: `yes` This property can be used to support decoding of files that are larger than 3MB. When set to `yes` the UDR File Editor will only read up to 3MB and then stop, when set to `no` the UDR File Editor will continue to read until the end of the file is reached.
mz.gui.ufl.color.comments	Default value: `#b22222` With this property you can specify the color you want to use for comments in the Ultra formats. Colors are entered in hex format, e g "#666666".
mz.gui.ufl.color.constants	Default value: #`add8e6` With this property you can specify the color you want to use for constants in the Ultra formats. Colors are entered in hex format, e g "#666666".
mz.gui.ufl.color.error	Default value: `#ff0000` With this property you can specify the color you want to use for errors in the Ultra formats. Colors are entered in hex format, e g "#666666".
mz.gui.ufl.color.functions	Default value: `#0000ff` With this property you can specify the color you want to use for functions in the Ultra formats. Colors are entered in hex format, e g "#666666".
mz.gui.ufl.color.keywords	Default value: `#a020f0` With this property you can specify the color you want to use for keywords in the Ultra formats. Colors are entered in hex format, e g "#666666".
mz.gui.ufl.color.normal	Default value: `#000000` With this property you can specify the color you want to use on your regular Ultra format text. Colors are entered in hex format, e g "#666666".
mz.gui.ufl.color.owntypes	Default value: #b8860b With this property you can specify the color you want to use for user defined types in the Ultra formats. Colors are entered in hex format, e g "#666666".
mz.gui.ufl.color.strings	Default value: `#bc8f8f` With this property you can specify the color you want to use for strings in the Ultra formats. Colors are entered in hex format, e g "#666666".
mz.gui.ufl.color.types	Default value: `#228b22` With this property you can specify the color you want to use for types in the Ultra formats. Colors are entered in hex format, e g "#666666".
mz.gui.ufl.syntaxfile	Default value: `""` With this property you can specify a file that contains further components within the Ultra formats that you want to be able to highlight. The value should contain path and file name to the syntax file.
mz.gui.ufl.syntaxhighlighting	Default value: `yes` This property specifies whether you want the text in your Ultra Formats to be color coded according to code definitions or not. The text is color coded according to the following definitions; brown = strings, dark blue = functions, light blue = constants, green = types, orange = user defined types, purple = key words, red = comments
mz.gui.wfeditor.maxrows	Default value: `500` This property can be added to change the maximum number of allowed rows in the workflow table. If this property has not been added, the default value of 500 rows will apply.
mz.docweb.enableOfflineDoc	Default value: "true" This property can be added to disable offline documentation access for the desktop client. This will remove the option for the selecting offline documentation, which includes all help buttons by linking them to their respective Infozone pages. If the property is not added, all references to offline documentation will remain as intended. Note! This property will only affect the desktop client that it is configured in.
mz.ultra.bitfield.codec	Default value: "false" This property selects the implementation that is to be used for ultra bit_block. If set to “true”, the newly selected implementation will be used. Values that are not set using this property will use the old implementation.
pico.bootstrapclass	Default value: `com.digitalroute.ui.MZDesktopMain` This property specifies the bootstrap classes used by the Desktop.
pico.cache.basedir	Default: `${mz.home}/pico-cache` This property must be set to `${mz.home}/pico-cache`.
pico.tmpdir	Default: `${mz.home}/tmp` This property must be set to `${mz.home}/tmp`.
pico.inhibit.startmessage	Default value: `"false"` This property determines if the start message, generated when starting the Desktop client, should be logged or not. The default value is `false`, which means that the start message will be logged. Excluding the property entirely will have the same effect. Setting the property to `false` will result in no logging of the start message.
pico.logdateformat	Default value: `"YYYY-MM-DD"` This property specifies the date format to be used in the log files. See http://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html for further information.
pico.name	Default value: `"<pico instance type>"` This property specifies the name of the pico instance used for the Desktop.
pico.pid	Default value: `$MZ_HOME/core/log` This property specifies the directory you want the Desktop to write process ID (PID) file to.
pico.stderr	Default value: `$MZ_HOME/core/log` This property specifies the directory you want the Desktop to write standard errors to.
pico.stdout	Default value: `$MZ_HOME/core/log` This property specifies the directory you want the Desktop to write standard output to.
pico.swing	Default value: `yes` This property specifies how you want notifications to be made for this pico. For Desktops you usually want notifications to be made in the GUI, and in that case this property should be set to `yes`, meaning that Swing will be used. For other picos, such as the Platform and the Execution Context, this property will usually be excluded, which will result in notifications being sent to the console instead.
pico.tmpdir	Default value: `${mz.home}/tmp` This property specifies the pico temp directory you want the Desktop to use.
pico.type	Default value: `desktop` This property specifies the type of pico instance used for the Desktop.
swing.aatext	Default value: `true` This property specifies that Java anti-aliasing should be used, which will improve the display of graphical elements in the GUI.

Next:

2.7 Managing Service Configurations