COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-15
Building a DLL from Multiple Source Files
PC Environment: Two-Step Method
1. Compile the source file with these options:
•
-Wshared
•
-c
The result is a linkfile.
2. Link the linkfile, using the ld 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.
•
-optional_lib followed by:
°
-L lib-directory -lcob, which links your file with the SRL named
ZCOBSRL
°
-obey lib-directory\libc.obey, which links your file with the SRL
named ZCRESRL
lib-directory is the name of the directory of libraries.
The resulting loadfile is a DLL.
In Example 13-6, the first command compiles the source file lib1.cob, creating the
linkable object file lib1.o. The second command links lib1.o with the SRLs named
ZCOBSRL and ZCRESRL, creating a DLL named mydll.
Building a DLL from Multiple Source Files
Each source file from which you build the DLL can contain one or more source
programs.
Building a DLL from multiple source files takes two steps:
1. Compile the source files.
Example 13-5. Building a DLL From a Single Source File in One Step (PC)
nmcobol lib1.cob -Wshared -Wld="-export_all" -o mydll
Example 13-6. Building a DLL From a Single Source File in Two Steps (PC)
nmcobol lib1.cob -Wshared -c
ld lib1.o -shared -export_all -optional_lib -L lib-directory
-lcob -obey lib-directory\libc.obey -o mydll