DLL Programmer's Guide for TNS/E Systems

Essential DLL Facility Controls
DLL Programmer’s Guide for TNS/E Systems—527252-006
2-12
Specifying a User Library for a Program
For Guardian, unless the -b static option is in effect, the linker searches in
$SYSTEM.ZDLL.
For Win 32, the linker does not search in any standard places.
You can have the linker skip steps 2 and 4 above by inserting the -nostdlib option
or its synonym -no_stdlib.In this event, the linker will search for libraries in places
specified by -first_L or -libvol options. -nostdlib is a one-time option that
applies to the linker only; it has no effect on subsequent loader operation.
The following example causes the linker to search for a library listed in a -lib option
first in a private subvolume, pvtsvol, before searching for it in the public libraries.
eld linkfile1 linkfile2 -lib dllfile1 &
-first_L pvtsvol -dll -o mainout
You may find it convenient to use a common search path that can work on different
linker platforms. The linker design supports this by allowing directory and subvolume
names for different platforms to be mixed in one search path definition. In this case, the
linker on one platform will find in its search path some directory or subvolume names
that are syntactically incorrect, because they are for the other platform. The linker
ignores these and searches only the ones it deems correct.
Allowing Missing Libraries
The linker terminates in error when it cannot find a file it searches for, unless it has
been instructed to allow missing libraries, by use of the -allow_missing_libs
option.
If the linker is directed to search for archives as well as libraries, then operating under
the -allow_missing_libs option, the linker treats any missing file as a library; thus
it can miss an archive as well. -allow_missing_libs is a one-time option.
If -allow_missing_libs is specified, and a specified library is not found, the name
from the -lib option is placed into the libList of the output loadfile.
Specifying a User Library for a Program
When linking a PIC Program, you can make an existing DLL the program’s user library
by inserting the -set libname <filename > option, where <filename > is the
name of that DLL. -libname is a synonym for -set libname.<filename > must
be a fully qualified Guardian file name on the execution target. -set libname is only
valid when linking a program.