Building Applications for UNIX** Environments

Micro Focus COBOL

The script file bldmfcc, in sqllib/samples/cobol_mf, contains the commands to build a sample COBOL program.

The first parameter, $1, specifies the name of your source file. The second parameter, $2, specifies the name of the database to which you want to connect. The third parameter, $3, specifies the user ID for the database, and $4, specifies the password. Only the first parameter, the source file name, is required. Database name, user ID, and password are optional. If no database name is supplied, the program uses the default sample database.

#! /bin/ksh # bldmfcc script file. # Usage: bldmfcc <prog_name> [ <db_name> [ <userid> <password> ]] # Connect to a database. if (($# < 2)) then db2 connect to sample elif (($# < 3)) then db2 connect to $2 else db2 connect to $2 user $3 using $4 fi # Precompile the program. db2 prep $1.sqb bindfile # Bind the program to the database. db2 bind $1.bnd # Disconnect from the database. db2 connect reset # Set COBCPY to include the DB2 COPY files directory. export COBCPY=/opt/IBMdb2/v5.0/include/cobol_mf:$COBCPY # Compile the checkerr.cbl error checking utility. cob -cx checkerr.cbl # Compile the program. cob -cx $1.cbl # Link the program. cob -x $1.o checkerr.o -L/opt/IBMdb2/v5.0/lib -ldb2 -ldb2gmf

Compile and Link Options for bldmfcc

The script file contains the following compile options:

cob
The Micro Focus COBOL compiler.
-cx
Compile to object module.

The script file contains the following link options:

cob
Use the compiler to link edit.
-x
Specify an executable program.
checkerr.o
Include the object file for error checking.
-Lpath
Specify the location of the DB2 runtime shared libraries. For example: -L/opt/IBMdb2/v5.0/lib.
-ldb2
Link with the DB2 library.
-ldb2gmf
Link with the DB2 library.

Refer to your compiler documentation for additional compiler options.

Compile and Link Options for bldmfcc
The script file contains the following compile options: `cob` The Micro Focus COBOL compiler. `-cx` Compile to object module.
The script file contains the following link options: `cob` Use the compiler to link edit. `-x` Specify an executable program. `checkerr.o` Include the object file for error checking. `-L`path Specify the location of the DB2 runtime shared libraries. For example: `-L/opt/IBMdb2/v5.0/lib`. `-ldb2` Link with the DB2 library. `-ldb2gmf` Link with the DB2 library. Refer to your compiler documentation for additional compiler options.

To build the sample program updat.sqb, do the following:

Go to the window in which you set your environment variables by running db2profile. Refer to "Setting Your Environment" if you need more information.
Start the database manager on the server, if it is not already running, by entering:
```
db2start
```
Build the sample program, connecting to the SAMPLE database, by entering:
bldmfcc updat

The result is an executable file updat. You can run the executable file against the SAMPLE database to see how it works by doing the following:

Go to the window in which you set your environment variables by running db2profile.
Start the database manager on the server, if it is not already running, by entering:
```
db2start
```
Run the program. If you built the updat sample program, enter:
updat

Note: To build Micro Focus COBOL applications that do not contain embedded SQL, you can use the script file bldmfapi. It contains the same compile and link options as bldmfcc, but does not connect, prep, bind, or disconnect from the SAMPLE database. It is used to compile and link DB2 API sample programs written in COBOL.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]

[ DB2 List of Books | Search the DB2 Books ]