Application Configuration


This section is about the configuration of the TAlh application (functionality and look-and-feel).
For configuration of alarms see here.

All application configuration is performed with command line switches. Some command line configuration may be modified with the preferences dialog.

For the most up-to-date information about command line switches run TAlh -h

Command Line Switches

Short Long Value Function
--background<string>background colour13
-c --config <string> configuration path (default: user's home directory)  1
-d --debug <int> debug level 2
-e --edit enable editing of alarm configuration (default: no edit) 3
--fontsize<int>font size
-g --global enable global mode (default: local) - acknowledge to PV 4
or 'none'
override heartbeat PV from config file 5
-h --help print/display command line switches
--helpurl<string>URL for overriding the location of the on-line help files
-i --inline acknowledge on main window (can be changed:  File >> Preferences6
--instance<string>override the default instance name of the TAlh session
--ioccheckenables alarm configuration checking in IOC 14
-l --log <string> logger plugin name and parameters 7
--noackgroupdisable alarm group acknowledgement 15
-o --offline enable off-line mode (default: on-line) 8
-p --passive passive mode (default active) 9
-q --quicklog quick logging enabled (default disabled) 10
--selgroupselection transfer ack/unack --> hierarchy 17
-t--treefractionhierarchy (tree) pane percentage (20 .. 80)
--usebeepuse system beep for alarm annunciation
-v --version print/display TAlh version
-w--widthmode<int>width mode: 0 = best, 1 = half, 2 = free or <width,height> in pixels 11
-x--screenposition<int, int>set initial screen x, y position
-y --testmode set test mode 12
Alarm label look and feel:
--shortlabelsAlarm label look and feel:
short alarm severity and acknowledge severity labels (like alh) 16
--reversedlabelsAlarm label look and feel:
reversed alarm severity and acknowledge severity labels. 16
(text black, background severity colour)
--noalarmlabelsAlarm label look and feel:
if set show 'NO_ALARM' or 'N' in tree model, otherwise show nothing 16

  1. Path to the configuration file. If the path contains no file name, talh.alhConfig is used. The configuration directory may be used to store .WAV files for alarm enunciation.
  2. Determines detail level of application debug logging to console
  3. In edit mode, the user can modify the alarm configuration and save changes to the configuration file or a different configuration file.
  4. In global mode, operator acknowledge and setting/unsetting of acknowledging transient alarms is writtten to the respective PV.
  5. Defines heartbeat variable different from configuration file or suppresses heartbeat.
  6. In in-line mode, selecting an alarm for viewing details, acknowledging and run-time configuration is done on the main window, otherwise a dialog is popped up.
  7. See the help on Alarm Logging.
  8. Off-line mode implies edit mode. No connections to EPICS PVs are made.
  9. In passive mode, no writes to PVs are allowed, no commands are executed, no alarm acknowledgement is possible..
  10.  In quick mode, any alarm events received from IOCs are logged unfiltered.
  11. Determines the screen width. In best and half modes, the main window cannot be resized. In free mode the main window starts in best size and can be resized.
  12. A mode for regression testing of TAlh.
  13. Set the background. Value can be any valid SVG colour name or "rrggbb" defining a 24-bit colour value or "rgb" defining  a 12-bit colour value (in hex format).
    Note that prefixing a colour value with "#"  or "0x" is not valid;
  14. Enables IOC checking on the Options menu.
  15. Disable acknowledging of alarm groups. This disables the corresponding preference selection.
  16. Change look and feel of alarm label display. Can also be confiigured with Help >> Preferences.
  17. See section on Preferences
back to Table of Contents