Administration Guide > Configuration > Structure of the Configuration Files > Structure of the INI and BAT Files

UserInterface (Windows)

You use the UCDJ.INI file to specify call options to start the UserInterface and the UCDJ.BAT file to call Java for the UserInterface.

Environment variables can now also be used in path specifications. Insert the following placeholders:

Windows: %Variable%
UNIX: $Variable

The UserInterface then replaces the placeholder with the environment variable's value.

Structure of the INI File UCDJ.INI

Section/Parameter Description
[GLOBAL]   
cmd=

Command line call command for starting the UserInterface.

path=

Start path for the UserInterface.

title=

This parameter serves internal purpose in the UserInterface. The value must not be changed.

affinity=

Uses particular processors of the computer on which the UserInterface runs.
Specify one or several processors here and separate them by commas.

Examples:
affinity=0
affinity=(0,1)
affinity=(1,3,5)

Default value: "0"

affinityaction=

Connection assignment to the processors

Allowed values: "no" (default values) and "next"

"no" - The connection is assigned to the processors in turn.

Example for affinity=(1,3,5):
1. Connection to CPU1
2. Connection to CPU3
3. Connection to CPU5

4. Connection to CPU1
5. Connection to CPU3
etc.

"next" - Here, the same rules apply as for the value "no". Additionally, the processor assignment rotates because 1 is added to each processor number.

Example for affinity=(1,3,5):
1. Connection to CPU1
2. Connection to CPU3
3. Connection to CPU5

4. Connection to CPU2
5. Connection to CPU4
6. Connection to CPU6

7. Connection to CPU3
8. Connection to CPU5
etc.

After CPU31, counting continues at 0.

79. Connection to CPU27
80. Connection to CPU29
81. Connection to CPU31

82. Connection to CPU28
83. Connection to CPU30
84. Connection to CPU0

85. Connection to CPU29
86. Connection to CPU31
87. Connection to CPU1
etc.

[ENVIRONMENT]

 

classpath=

Path and file name of the Jar files in the UserInterface and Java functions library.

JAVA_OPTIONS=

By default these variables are empty. This is done to clear their values and avoid Java Tools that hook the JVM.

Removing these parameters or setting values for the may negatively influence the UserInterface.

JAVA_TOOL_OPTIONS=
[SPLASH]  
sound= Name of the WAV file to be played during UserInterface start (Splash screen).

Example of an INI File

[GLOBAL]
cmd="javaw" -Xmx1024m com.uc4.ucdf.UCDialogFactory -U%User% -IC:\AUTOMIC\uc4config.xml
path=.
title=B008 -
affinity=(0,1)
affinityaction=no


[ENVIRONMENT]
classpath=.;.\ucdj.jar.;.\psjoa.jar.;.\ucsjds84.jar
JAVA_OPTIONS=
JAVA_TOOL_OPTIONS=


[SPLASH]
sound=uc4.wav

Structure of the BAT File UCDJ.BAT

Setting Description
set JAVA_OPTIONS=

By default these variables are empty. This is done to clear their values and avoid Java Tools that hook the JVM.

Removing these parameters or setting values for the may negatively influence the UserInterface.

set JAVA_TOOL_OPTIONS=
set JAVA_TOOL_OPTIONS=
java Calls Java for the UserInterface with the parameters specified.

Example of a BAT File

set CLASSPATH=
set JAVA_OPTIONS=
set JAVA_TOOL_OPTIONS=
java -Xmx512m -XX:+UseG1GC -XX:MinHeapFreeRatio=40 -XX:MaxHeapFreeRatio=70 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=../temp -Dsun.locale.formatasdefault=true -cp .;.\ucdj.jar com/uc4/ucdf/UCDialogFactory

See also:

Configuration & Performance of the UserInterface
Start Parameters