Configuring the Runtime for a Helper Application

When used as a helper application or viewer, the ACUCOBOL-GT runtime is invoked to process a single file. If your application contains more than a single object file, it must be packaged in a library file that contains all of the necessary COBOL objects and bitmap resources. Because helper applications process only a single file, you cannot include a configuration file with your program as you normally might.

To get around this limitation, we recommend using the SET CONFIGURATION (or SET ENVIRONMENT) phrase to enter your configuration options programmatically.

For example, if your application uses a configuration file with the entries:

FILE-PREFIX @hal:/u2/serverfiles

COMPRESS-FILES 1

KEYSTROKE EDIT=PREVIOUS EXCEPTION=52 kl

Add the following lines to your COBOL initialization code:

SET CONFIGURATION "FILE-PREFIX" TO "@hal:/u2/serverfiles".

SET CONFIGURATION "COMPRESS-FILES" to "1".

SET CONFIGURATION "KEYSTROKE" TO "EDIT=PREVIOUS EXCEPTION=52 kl"