The following command line options are supported as of version 2.0:
The cmlog searches a configuration file in the following order: 1) -f or -cfg, 2) .cmlogrc in the user home directory and 3) CMLOG_CONFIG environment variable specifying a file location. If syntax errors are detected during start up of cmlog, the default setting will be used.
The cmlog chooses a default file to save current settings in the following way. If there is a configuration file provided other than the CMLOG_CONFIG file, the configuration file will be used as the default. If there is no configuration file, .cmlogrc in the user home directory will be the default file. Finally if the configuration file is the CMLOG_CONFIG, the .cmlogrc in the user home directory is the default.
In addition the cmlog allows users to save current display into an ASCII file from ``Save Screen'' menu, to cancel a long query, to convert set of integer values of a tag to strings, to display values in different colors and to blink, to bell or to do an action (user script) color coded values (bell and user actions will only be effective in the updating mode).
The following is a sample configuration file for cmlog:
# Configuration file for cmlog
# Name of this config
name MCC Control
# Type Title Tag Width
Col Facility facility 98
Col Host host 90
Col User user 48
Col Time cmlogTime 178
Col Status status 49
Col Severity severity 79
Col Message text 250
# Buffer size for updating the message
ubufsize 2000
# Default query message
queryMessage ``none'' -36:0 now
# Default update selection message
updateMessage ``none''
# Window Width
windowWidth 977
# Window Height
windowHeight 500
#Code Conversion
codeConversion ``none'' Severity
{
0 Info Green
1 Info1 Blue
2 Info2 LightBlue
3 Warning Yellow flash:bell:action
4 Fatal Red flash
}
#Code Conversion
codeConversion ``Facility == 'EPICS' '' status
{
100 Info Blue
101 Info1 Blue
102 Info2 LightBlue
103 Warning Yellow blink:bell:dosomething
104 Fatal Red doother:flash
}
Note: ``none'' in queryMessage or updateMessage stands for no message.
Note: End time ``now'' in queryMessage stands for current time.
Note: Correct syntax to specify time interval in the queryMessage can be one of the followings: ``H stands for hour, M stands for minutes, m stands for months, d stands for days in a month and Y stands for long year (1999 not 99).
Note: The second field of codeConversion line identifies sources of data. In particular cmlog converts integer fields to string representations the same way regardless data sources if "none" is specified.
Note: The first column within a code conversion denotes integer values that will be converted to string representations that are shown in the second column. The values in third column give background color of those strings. The optional value in the forth column enables blinking of color coded values, ringing a bell or doing a user defined action.