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

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-15
Files of Dummy Routines
For more information about the eld options -l or -lib, see the eld Manual.
In Example 13-15, the first command compiles the source file main.cob, specifying
the DLL named MYDLL and creating the linkable object file main.o. The second
command links main.o with mydll and the DLLs named ZCOBDLL and ZCREDLL,
creating the loadfile main.exe. MYDLL is in dll-location. (An example of dll-
location is C:\xxx\yyy.)
Files of Dummy Routines
Files of dummy routines enable the compiler to accept ENTER statements that are to
be resolved at program load time rather than by the linker.
When you install the compiler, the files of dummy routines are stored on the subvolume
$SYSTEM.SYSTEM. If you move any of them to another subvolume, use the
CONSULT directive to tell the compiler where to find the files you moved.
FastSort Interface Overview
The FastSort interface routines (in the ZCOBDLL file) give your HP COBOL program
access to the FastSort utility program, which provides more extensive sorting features
than HP COBOL has (such as parallel sorting).
Use the FastSort interface routines only with FastSort. If you use them with SORT, the
sort process might terminate abnormally.
To use FastSort routines, you must establish a set of parameters and then execute a
statement that uses those parameters. You can establish the set of parameters with
either FastSort interface routines or the =_SORT_DEFAULTS DEFINE.
Example 13-15. Specifying a DLL When You Compile and Then Link (PC)
ecobol main.cob -Wcall_shared -c -Wcobol="CONSULT MYDLL"
ld main.o -call_shared -L dll-location -l mydll -optional_lib
-L lib-directory -lcob -obey lib-directory\libc.obey -o main.exe
Table 13-4. Files of Dummy Routines
File Name Description of File (as released by HP)
ECOBEX0 Contains one dummy routine for each operating system routine in the
EXTDECS0 file. Represents the latest RVU.
ECOBEX1 Contains one dummy routine for each operating system routine in the
EXTDECS1 file. Represents the next-to-latest RVU.
ECOBEXT Contains one dummy routine for each operating system routine in the
EXTDECS file. Represents the second-next-to-latest RVU.