$VARIATION

Specify the library name for global objects needed by the application when the application starts. Libraries are typed, so each global object library can have the same name which functions as a shared namespace which can be specified by this setting.

$VARIATION {=} LibraryName

Defaults

Assignment file: Any application assignment file
Section: [SETTINGS]
Default value: None

Description

The value of $VARIATION determines the library used to locate the following resources at runtime:

  • Messages
  • Help texts
  • Menus
  • Panels
  • Glyphs
  • Device translation tables
  • Keyboard translation tables
  • Language setups

For example, by setting $VARIATION to MYAPP, you instruct Uniface to look for global objects in the libraries of this name. By also setting $LANGUAGE, you can specify which language-specific libraries to use for messages, menus, and glyphs. For example:

[SETTINGS]
$VARIATION = MyApp
$LANGUAGE = FRA

$VARIATION also determines the keyboard or device translation table loaded if $KEYBOARD or $DISPLAY are specified.

The value defined by $VARIATION can be tested or overridden at runtime using the $variation ProcScript function.

Related Topics