Enabling CGI support

You need to enable CGI support to generate applications that use Embedded HTML.

To use Embedded HTML, you must have the following in place:

Project Specifications

  • Your Eclipse project must be a native COBOL project created by choosing File > New > COBOL Project or File > New > Remote COBOL Project and selecting Native as the compilation target.
  • In your project properties, choose Micro Focus > Build Configurations > Link and set Run Time Model to Dynamic.

Server Specifications

Apache server:

You need to configure the server as shown below. This example was created with Apache 2.4.

  • Enable mod_cgi
    LoadModule cgi_module modules/mod_cgi.so
  • Enable mod_env
    LoadModule env_module modules/mod_env.so
  • Specify a /cgi-bin script alias. For example:
    <IfModule alias_module>
     ScriptAlias /cgi-bin/ "${SRVROOT}/cgi-bin/"
    </IfModule>
  • Enable ExecCGI for the directory that contains your cgi executable. For example:
    <Directory "${SRVROOT}/cgi-bin">
        AllowOverride None
        Options None
        Require all granted
    </Directory>
  • Micro Focus Licensing Specifications
    If you are using a version of the COBOL Run-Time System earlier than the one supplied with the latest Visual COBOL, you must set the MFCES_INIT_LOCATION environment variable to point to your ces.ini file. For example:
    SetEnv MFCES_INIT_LOCATION "c:\programdata\micro focus\ces.ini"