Overview of Building an ESQL Executable
After you design and program your ESQL application, follow these steps to build an ESQL executable:
- If required for your operating system, set up your environment using PROENV, which is provided with your Progress installation.
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.
- If your ESQL source files contain Progress/ESQL statements, preprocess your source files with the
sqlald()
preprocessor.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.- Compile your pure C source files.
This step produces an object file for each source file. For more information, see the "Compiling ESQL Source Files" section.
- Link your ESQL executable.
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 theobjs/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 |