Overview of Building an ESQL Executable

After you design and program your ESQL application, follow these steps to build an ESQL executable:

  1. If required for your operating system, set up your environment using PROENV, which is provided with your Progress installation.
  2. PROENV sets the environment variables for the sqlcpp preprocessor, C compiler, and linker. For more information on PROENV and whether you need to run it, see the Progress Client Deployment Guide.

  3. If your ESQL source files contain Progress/ESQL statements, preprocess your source files with the sqlald() preprocessor.
  4. This step produces a preprocessed (pure) C source file. If you run the preprocessor with the precompile option, this step produces an r-code file for each unique static ESQL statement in your application. For more information, see the "Preprocessing Progress/ESQL Source Files" section.

    NOTE: You do not have to preprocess ESQL source files that call ESQL-LIB directly and contain no Progress/ESQL statements.

  5. Compile your pure C source files.
  6. This step produces an object file for each source file. For more information, see the "Compiling ESQL Source Files" section.

  7. Link your ESQL executable.
  8. Use the link script that the PROBUILD utility generates for all ESQL clients except the Windows small client.

    NOTE: To link the Windows small client, use your own linker response file.

    If you are using Microsoft Visual Studio‚ to build your ESQL application, add sqlald() (located in %DLC%\probuild\esqlc) to the objs/line. The companion file, esql32.dll, is located in %DLC%\bin.

    The PROBUILD utility automatically generates a UNIX link script or Windows linker response file based on:

    • The ESQL client or preprocessor product that you want to build.
    • The Progress configurable elements to include in your executable, such as communications protocols or user-defined sort routines and DataServers to non-Progress databases (large client and preprocessor products only).
    • The object modules to include for your ESQL application.
    • For more information on linking all ESQL client executables and PROBUILD, see the "Linking ESQL Executables" section.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095