DLL Programmer's Guide for TNS/R Systems

Essential DLL Facility Controls
DLL Programmer’s Guide for TNS/R Systems—522203-002
2-2
Option Types
Parameter – a non-file-name argument of an option
The command stream comprises all the tokens that modify an ld command; these are
processed in the order they appear in the command stream. These tokens can come
from the command line or from command files that are referenced in the command
line. In this document, to insert an item means to make it a token in the linker’s
command stream either directly or as an option argument.
Herein, options are defined with the file names and parameters they require. Thus, in
the next paragraph, the -obey option is defined as -obey filename, meaning that
filename is required when the option is declared.
-obey filename is a linker option that designates a command file containing tokens
to be incorporated into the linker’s command stream. The linker processes these
tokens in sequential order before it moves on to the next token on the command line.
Such a file is called an obey file. Obey files can be called from within an obey file. The
linker accepts -FL as a synonym for -obey. To use the standard input file as an obey
file, insert the -stdin option with no file names or parameters.
Option Types
Options fall into three categories:
•
Repeatable option: each occurrence adds another element of information or
causes the linker to repeat an operation.
•
Toggle option: a set of options, usually a pair. One of the set turns on a designated
linker behavior, and that behavior remains in effect until the linker encounters
another member of the set in the command stream, which invokes a different linker
behavior. Command-stream processing begins with one behavior as default, and
the option members can be repeated in the command stream as many times as
needed.
•
One-time option: all other options, which can only appear once in a command
stream.
The order in which an option appears in the command stream makes no difference
except where specifically mentioned. However, when adding an option to the command
stream, be sure to avoid inserting it where it separates some other option from its
arguments.
Specifying the Linker’s Output
By default, the linker merges linkfiles to produce loadfiles. Following the ld command,
you should list the names of the linkfiles to be combined, as illustrated in this
command-stream fragment:
ld linkfile1 linkfile2