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