Eventlog - ObjectVision/GeoDMS GitHub Wiki
User Guide GeoDMS GUI - eventlog
eventlog
The eventlog component shows messages to inform on the progress in the calculation process and warnings and errors that might occur during the process. Colors are used to indicate the contents or the severity type of the message.
tools
At the right side of the eventlog, 4 tools are available:
| tool | description |
|---|---|
 |
copy the selected eventlog messages to the clipboard. |
 |
turn eventlog filter on/off, see next paragraph |
 |
clear all eventlog messages. |
 |
scroll contents of message to bottom and keep up with the new log messages. |
filter
The eventlog filter is used to make a selection of relevant messages in the eventlog. The relevant message categories can be selected with the check boxes. The eventlog filter also functions as a legend, indicating which text colors are used for which category.
The left side groups the check boxes per subject:
- Calculation Progress: minor and major progress messages.
- Storage: messages on reading from (read) and writing to (write) a storage.
- Background Layer: messages on the connection to a background layer server and on the individual tile requests.
- the row underneath these three blocks selects on severity rather than on subject: Case mix-up warnings (warnings on deprecated mix-ups of upper and lower case in item and function names, which can also be switched for a single run with the
/SWresp./CWcommand line option), other warnings and error. - the column to the right of the blocks selects the remaining message categories: commands, memory and other.
Since GeoDMS 20.18.0 the panel shows all of these check boxes in full. In earlier versions its bottom row could be drawn clipped, because the panel was laid out slightly smaller than its contents; the check boxes were still there and still worked, but their text was cut off.
One kind of message never appears here: the report written when GeoDMS ends on a fatal error. That report is written straight to the session log file and to standard error, bypassing the eventlog on purpose, because the eventlog goes down with the rest of the application. So when the GUI disappears without an error message, the session log — started with the /L command line option — is where the explanation is. See the log file and fatal errors on that page.
The Filter on text part of the eventlog is used to filter messages on text parts (case insensitive). The Filter button becomes active if a (new) text is typed into the textbox. With the button the filter is applied in the text box. The Clear button can be used to clear the contents of the textbox (if the box contains characters).
The Filter message contents block is used for additional filter settings, with two subblocks:
- Clear eventlog before: This option can be set to clear the whole eventlog if a new configuration is opened (open configuration) and/or if the current configuration is reopened (reopen configuration).
- Add to each message: This option filters the contents of each message, the date/time, the thread number and the message category can be added or removed from each message.