Open System Services Shell and Utilities Reference Manual (G06.25+, H06.03+)

ManualsBrandsHP ManualsServerHP NonStop G-Series

161

162

163

164

165

166

167

168

169

170

Table Of Contents

User Commands (d - f) ecobol(1)

DESCRIPTION

The ecobol utility is the interface to the ECOBOL compilation system; it accepts source code con-

forming to the ISO COBOL85 standard. The system consists of an ECOBOL compiler and a

linker utility (eld), with additional program components supporting SQL.

ecobol performs simple validation of the ﬂags and operands on its command line and, depending

on those items, invokes components of the language compilation system. ecobol does not verify

the existence of ﬁles it passes to compilation system components. It does verify that operand

identiﬁes valid ﬁles to pass to compilation system components. ecobol and the components it runs

issue messages to the standard error ﬁle.

ecobol performs the following steps:

1. If the -Wsqlmx ﬂag is speciﬁed, invokes the NonStop SQL/MX preprocessor to prepro-

cess any COBOL source ﬁles that contain embedded NonStop SQL/MX statements to

create either of the following:

• COBOL source ﬁles with module deﬁnitions (using the release 2 module manage-

ment method)

• COBOL-only source ﬁles and module deﬁnition ﬁles (MDFs) (using the release 1

module management method)

2. Compiles any speciﬁed COBOL source ﬁles or source ﬁles produced by Step 1 into object

ﬁles.

3. If the -Wmxcmp ﬂag is speciﬁed, invokes the NonStop SQL/MX compiler to compile any

module deﬁnitions or MDFs.

4. Links the object ﬁles together with any libraries speciﬁed on the command line. This step

occurs if no ﬂags that prevent linking (such as -c or -Wnolink) are speciﬁed and if the

source ﬁles are compiled without errors.

5. If the -Wsqlcomp ﬂag is speciﬁed, invokes the NonStop SQL/MP compiler to process any

embedded NonStop SQL/MP statements in ﬁles created by Step 1 or speciﬁed in the com-

mand.

6. Writes an executable object ﬁle or dynamic link library (DLL) speciﬁed by the -o ﬂag (if

present) or to the ﬁle a.out.

The ﬁles speciﬁed in the operand list are operated on by the appropriate program components of

the compilation system, depending on the command line ﬂags and the type of ﬁle operands.

If the -c ﬂag is speciﬁed, then for all pathname operands of the form ﬁle.cbl, the ﬁles $(basename

pathname.c).o are created as the result of successful compilation.

If -c is not speciﬁed, the object ﬁles created after successful compilation are combined by the link

operation into a program ﬁle, dynamic-link library (DLL), or user library. When linking is per-

formed and either the -Wsqlmx or -Wmxcmp ﬂag is speciﬁed, the list of libraries searched

automatically includes zclidll. Object ﬁles created are not deleted after successful generation of

the executable program ﬁle.

The executable ﬁle is created according to OSS ﬁle creation rules, except that the ﬁle permissions

are set to S_IRWXO | S_IRWXG | S_IRWXU and the bits speciﬁed by the umask value of the

process are cleared.

527188-003 Hewlett-Packard Company 3−35