COBOL Manual for TNS/E Programs (H06.08+, J06.03+)

Example 170 Building a DLL From Multiple Source Files (OSS)
ecobol lib1.cob -Wshared -c
ecobol lib2.cob -Wshared -c
ecobol lib3.cob -Wshared -c
ecobol lib4.cob -Wshared -c
eld lib1.o lib2.o lib3.o lib4.o -shared -export_all
-optional_lib -l ZCOBDLL -l ZCREDLL -o mydll
PC Environment
1. Compile each source file with these options:
• -Wshared
• -c
The result of each compilation is a linkfile.
2. Link the linkfiles into a single loadfile, using the eld utility with these options:
• Either:
◦ -export_all, which exports all program names in the source file
◦ -export program-name, which exports only the specified program name. You
must repeat this option for every program name that you want to export.
• -shared, which links the linkfiles into a single loadfile that is a DLL
• -optional_lib followed by:
◦ -L lib-directory -lcob, which links your file with the DLL named ZCOBDLL
◦ -obey lib-directory\libc.obey, which links your file with the DLL named
ZCREDLL
lib-directory is the name of the directory of libraries.
In Example 171, the first four commands compile four source files (lib1.cob, lib2.cob,
lib3.cob, and lib4.cob), creating four linkable object files (lib1.o, lib2.o, lib3.o, and
lib4.o). The last command links the four linkable object files with the DLLs named ZCOBDLL and
ZCREDLL, creating a DLL named mydll.
Example 171 Building a DLL From Multiple Source Files (PC)
ecobol lib1.cob -Wshared -c
ecobol lib2.cob -Wshared -c
ecobol lib3.cob -Wshared -c
ecobol lib4.cob -Wshared -c
eld lib1.o lib2.o lib3.o lib4.o -shared -export_all
-optional_lib -L lib-directory -lcob
-obey lib-directory\libc.obey -o mydll
Specifying a DLL
To use an existing DLL, you must specify it to both the compiler and the linker. You can do this in
either one step or two.
Topics:
• Guardian Environment: Compile and Link in One Step
• Guardian Environment: Compile and Link in Two Steps
• OSS Environment: Compile and Link in One Step
• OSS Environment: Compile and Link in Two Steps
606 Libraries and Utility Routines