Text mode screen dump

For compatibility with IBM® Informix® 4GL, Genero supports the DBSCREENDUMP and DBSCREENOUT environment variables for debugging purpose, which allows you to take a screenshot when running in TUI mode and save the result in a file.

To enable TUI screenshot, set either DBSCREENDUMP or DBSCREENOUT to the name of the output file, then run your Genero program with FGLGUI=0 set and press the Ctrl-P key to dump the current screen. Each time you press Ctrl-P, the output file will be overwritten.

The DBSCREENDUMP variable writes the screen with escape sequences of TTY attributes, while DBSCREENOUT writes only the characters displayed on the screen, which makes the output more readable.

If both variables are set, the runtime will generate both output files. However use different file names, otherwise the output is undefined.