Class lwh.config

Object
   |
   +--lwh.config

class lwh.config

manages the V3 configuration files.

• Configuration files are JavaScript source files on the server
• configuration is specific for on logged-in USER and its associated GROUP
• there are specific files for APPLICATION (3270..) and TYPE (keyboard..)
• some text files depend on LANGUAGE (basic texts only, and "overlay menu")

Field Detail

appl

String appl

the application sub-dir. lwData._ApplicationType such as "3270", or Unix: special such as "97801" or "vt" (extracted from lwData._VTTerminalType). Set on session start from lwData.

dir

Type_ArrayStrings dir

the directory listing of all config files for current appl and user. Loaded via dirlist() / dirlistResponse() from server. Elements (example):

    ".":         ["*97801_default.js","*_automacros.js"],

    "keyboard":  ["*97801_keyboard.js","*97801_keyboard_empty.js","*97801_keyboard_tm.js","97801_keyboard_empty.js"],

    "macro":     ["*97801_macro_empty.js","97801_macro_empty.js"],

    "menu":      ["*97801_menu_empty.js","*test1.js","97801_menu_empty.js"],

    "toolbar":   ["*97801_toolbar.js","*97801_toolbar_empty.js","97801_toolbar_empty.js"]

files

{_appl_ArrayStrings} files

the config file names for all terminal types.
• init via Cookie: lwh.pref.files
• files of current terminal type are in this.files[this.appl].
• Example: { "3270": ["_menu.js", "_keyboard.js", "_toolbar.js", "9750": ["*default.js",..],.. }

lang

String lang

the current language settings. initially from lwData._Language; e.g. "de".

lwh.config

lwh.config(appl)

Constructs a new V3 configuration files manager.

dirlist

void dirlist(<String> path)

load directory listing of all config files for current appl. Note: server calls dirlistResponse

Parameters:
path - optional: the directory path; e.g. lwh.config.appl == "5250"

See:
- dir
- dirlistResponse()

dirlistResponse

void dirlistResponse(obj, path)

callback from server dirlist(): the directory listing.

Parameters:
obj - the application file directories for current application and user. Elements (example):

     ".":         ["*97801_default.js","*_automacros.js"],
     "keyboard":  ["*97801_keyboard.js","*97801_keyboard_empty.js","*97801_keyboard_tm.js","97801_keyboard_empty.js"],
     "macro":     ["*97801_macro_empty.js","97801_macro_empty.js"],
     "macro/auto":["*S0Auto.js","*S1Auto.js",..,"*S8Auto.js","*S9Auto.js","S0Auto.js","S1Auto.js",..,"S8Auto.js","S9Auto.js"],
     "menu":      ["*97801_menu_empty.js","*test1.js","97801_menu_empty.js"],
     "toolbar":   ["*97801_toolbar.js","*97801_toolbar_empty.js","97801_toolbar_empty.js"] 

See:
- dir
- dirlist()

keyboard

int keyboard(<String> f)

loads the specified keyboard config file for current appl.

Parameters:
f - optional: the file name. If missing: returns the index of the current file (found in this.myFiles) into this.dir

Returns:
the index of the current config file (getter only)

keyboardUpdate

void keyboardUpdate(<String> f)

callback after loading a keyboard file. updates the current keyboard.

Parameters:
f - NOT SUPPORTED: if specified: the overlay file to be loaded

language

int language(<String> lang)

loads the language config files for the specified language.

Parameters:
lang - optional: the language to be used, e.g. de. if missing: returns index of current language.

Returns:
the index of the current language (getter only)

macro

int macro(<String> f)

loads the specified macro file for current appl.

Parameters:
f - the file name

Returns:
-1 (getter only - there is no "current" macro file..)

menu

int menu(<String> f)

loads the specified menu config file for current appl.

Parameters:
f - optional: the file name. If missing: returns the index of the current file (found in this.myFiles) into this.dir

Returns:
the index of the current config file (getter only)

menuUpdate

void menuUpdate(<String> f)

callback after loading a menu file. shows the current menu.

Parameters:
f - if specified: the overlay menu file to be loaded

terminal

void terminal(<String> appl)

loads the terminal config files for current appl. Load keyboard, toolbar and menu config files, and the auto-load macros.

Parameters:
appl - the _ApplicationType sub-dir name.

See:
- keyboard()
- toolbar()
- menu()
- loadAuto()

toolbar

int toolbar(<String> f)

loads the specified toolbar config file for current appl.

Parameters:
f - optional: the file name. If missing: returns the index of the current file (found in this.myFiles) into this.dir

Returns:
the index of the current config file (getter only)

toolbarUpdate

void toolbarUpdate(<String> f)

callback after loading a toolbar file. updates the current toolbar.

Parameters:
f - NOT SUPPORTED: if specified: the overlay file to be loaded