1
Introducing Pro*COBOL

This chapter describes the Oracle programmatic interface for the COBOL language running on Windows operating systems. Specific topics discussed are:

• What is Pro*COBOL?

• Release 1.8.51

• Supported Compilers

• Features

• Restrictions

• Directory Structure

  See Also: For more information on these topics, see the Pro*COBOL Precompiler Programmer's Guide.

What is Pro*COBOL?

To access an Oracle database, you use a high-level query language called Structured Query Language (SQL). You often use SQL through an interactive interface, such as SQL*Plus.

Pro*COBOL is a programming tool that enables you to embed SQL statements in a COBOL program. The Pro*COBOL precompiler converts the SQL statements in the COBOL program into standard Oracle run-time library calls. The generated output file can then be compiled, linked, and run in the usual manner.

Use the Pro*COBOL precompiler when rapid development and compatibility with other systems are your priorities.

Release 1.8.51

Oracle Corporation expects that any application written for Pro*COBOL release 1.8.x should precompile successfully with Pro*COBOL release 8.1.6. However, some vendor extensions may not be accepted and the application may not precompile successfully when migrating from release 1.8.x to release 8.1.6.

Note: To install Pro*COBOL release 1.8.51, you need to choose Custom Installation when installing the Oracle programmer products.

If you simply want to migrate a release 1.8.x application to release 8.1.6 without using any of the new features of Pro*COBOL version 8, but the application does not precompile successfully, then do the following:

• Use release 1.8.51.

• Report the problem to Oracle Support Services.

  Note: Oracle Corporation recommends that you use release 8.1.6 to develop new applications.

Supported Compilers

Pro*COBOL supports the following compilers:

• Fujitsu COBOL version 4.0 or later for 32-bit Windows NT and Windows 95/98

  Note: Pro*COBOL does not support the following Fujitsu COBOL extensions: USAGE BIT clause in data description entry CHARACTER TYPE clause in data description entry PRINTING POSITION clause in data description entry @OPTIONS compiler option directing statement Literal coded on column 73 or later

• MERANT Micro Focus NetExpress version 3.0 for 32-bit Windows NT and Windows 95

  Note: Pro*COBOL does not support Object Oriented COBOL (OOCOBOL) specifications for either compiler.

Features

Pro*COBOL supports the following:

• Oracle databases release 8.1.x

• Embedded PL/SQL blocks

• Bundled database calls, which can provide better performance in client/server environments

• Full ANSI compliance for embedded SQL programming

• Calls to PL/SQL stored procedures

Restrictions

Pro*COBOL does not support the following:

• User exits

• Access to the Oracle Call Interface

• Oracle8i object types

• Graphical user interface

• 16-bit code generation

Directory Structure

When you install Pro*COBOL, Oracle Universal Installer creates a directory called \precomp in your oracle_base\oracle_home directory.

Note: The \precomp directory can contain files for other products, such as Pro*C/C++.

The \precomp directory contains the following directories:

Directory Name	Contents
\admin	Configuration files
\demo\procob2	Sample programs for Pro*COBOL 8.1.6
\demo\procob	Sample programs for Pro*COBOL 1.8.51
\demo\sql	SQL scripts for sample programs
\doc\procob2	Readme files for Pro*COBOL 8.1.6
\doc\procob	Readme files for Pro*COBOL 1.8.51
\lib	Library files
\mesg	Message files
\public	Header files

Header Files

The oracle_base\oracle_home\precomp\public directory contains the Pro*COBOL header files.

Header File	Description
oraca.cob	Contains the Oracle Communications Area (ORACA), which helps you to diagnose runtime errors and to monitor your program's use of various Oracle resources.
oraca5.cob	ORACA5 is the COMP-5 version of ORACA.
sqlca.cob	Contains the SQL Communications Area (SQLCA), which helps you to diagnose runtime errors. The SQLCA is updated after every executable SQL statement.
sqlca5.cob	SQLCA5 is the COMP-5 version of SQLCA.
sqlda.cob	Contains the SQL Descriptor Area (SQLDA), which is a data structure required for programs that use dynamic SQL Method 4.
sqlda5.cob	This is the COMP-5 version of SQLDA.

Library File

The oracle_base\oracle_home \precomp\lib directory contains the library file that you use when linking Pro*COBOL applications. The library file is called orasql8.lib.