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

ecobol(1) OSS Shell and Utilities Reference Manual
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 flags 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 files it passes to compilation system components. It does verify that ope rand
identifies valid files to pass to compilation system components. ecobol and the components it runs
issue messages to the standard error file.
ecobol performs the following steps:
1. If the -Wsqlmx flag is specified, invokes the NonStop SQL/MX preprocessor to prepro-
cess any COBOL source files that contain embedded NonStop SQL/MX statements to
create either of the following:
• COBOL source files with module definitions (using the release 2 module manage-
ment method)
• COBOL-only source files and module definition files (MDFs) (using the release 1
module management method)
2. Compiles any specified COBOL source files or source files produced by Step 1 into object
files.
3. If the -Wmxcmp flag is specified, invokes the NonStop SQL/MX compiler to compile any
module definitions or MDFs.
4. Links the object files together with any libraries specified on the command line. This step
occurs if no flags that prevent linking (such as -c or -Wnolink) are specified and if the
source files are compiled without errors.
5. If the -Wsqlcomp flag is specified, invokes the NonStop SQL/MP compiler to process any
embedded NonStop SQL/MP statements in files created by Step 1 or specified in the com-
mand.
6. Writes an executable object file or dynamic link library (DLL) specified by the -o flag (if
present) or to the file a.out.
The files specified in the operand list are operated on by the appropriate program components of
the compilation system, depending on the command line flags and the type of file operands.
If the -c flag is specified, then for all pathname operands of the form file.cbl, the files $(basename
pathname.c).o are created as the result of successful compilation.
If -c is not specified, the object files created after successful compilation are combined by the link
operation into a program file, dynamic-link library (DLL), or user library. When linking is per-
formed and either the -Wsqlmx or -Wmxcmp flag is specified, the list of libraries searched
automatically includes zclidll. Object files created are not deleted after successful generation of
the executable program file.
The executable file is created according to OSS file creation rules, except that the file permissions
are set to S_IRWXO | S_IRWXG | S_IRWXU and the bits specified by the umask value of the
process are cleared.
3−36 Hewlett-Packard Company 527188-021