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 "packages" all of the objects and associated resources of your application into a single file (see Section 4.3.2 Packaging Your Application and Resources).
Because of the way the runtime works when it is used as a helper application or viewer, you cannot include a configuration file in the object library. Instead you must configure the runtime programmatically using the SET CONFIGURATION or SET ENVIRONMENT variables.
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"
Note that MAX-FILES, MAX-LOCKS and LOCKS-PER-FILE cannot be modified using the SET verb and that the COBOL program can read environment variables using ACCEPT FROM CONFIGURATION (or ACCEPT FROM ENVIRONMENT).