There are 61 other files named link.hlp in the archive. Click here to see a list.
A command to LINK consists of a list of file names with associated
switches, terminated by the /GO switch. A command may take up one or
more lines. LINK uses SCAN, so all of the standard SCAN features
(indirect files, line continuation, /RUN, /PROTECT, etc.) are available.
Output files are requested by applying the appropriate switch to a file
name, either before or after the file name. An equals sign may
optionally be used to separate output file names from input file names,
but does not by itself designate an output file.
The following examples all load ONE.REL and TWO.REL, producing
TWELVE.EXE and TWELVE.MAP:
3. */MAP TWELVE=ONE
When using LINK's overlay facility, the command format is as follows:
. . .
The following list summarizes LINK's switches and what they do:
/ARSIZE:decimal Used in response to a LNKTMA message when
loading an overlaid program.
/BACKSPACE:decimal Backspaces files on an input magtape.
/COMMON:name:decimal Allocates a new common block.
/CONTENTS:keyword Specifies what types of symbols should appear
in the map file, if any. Keywords:
/CORE:decimal Tells LINK to begin with the specified amount
of memory. This can speed loading by cutting
down LINK's memory management overhead.
/COUNTER Types psect origins and breaks.
/CPU:keyword Requires that the program run on the named CPU
/DDEBUG:keyword Selects a default debugger for /DEBUG.
/DEBUG:keyword Loads a debugger and starts it executing. This
switch also turns on /LOCALS and /SYMSEG:LOW
for the remainder of the load. Keywords:
/DEFAULT:keyword Changes LINK's defaults for missing parts of
file specs, or sets file specific switches for
the remainder of the load. Keywords:
/DEFINE:name:decimal Defines a global symbol.
/ENTRY Types all entry points loaded so far.
/ERRORLEVEL:decimal Allows typeout of messages with message level
greater than or equal to the value specified.
Setting this parameter to less than 10 will
allow you to see some extra messages that are
/ESTIMATE:decimal Reserves the specified number of disk blocks
for the current output file.
/EXCLUDE:name Prevents the named module from being loaded
from the input file.
/EXECUTE Tells LINK to start the program after loading
/FRECOR:decimal Maintains space between LINK's internal areas
to cut down on the amount of shuffling done.
The default value is 1024.
/FOROTS Causes LINK to use the Fortran libraries if F40
code is loaded.
/FORSE Causes LINK to use the F40 libraries if F40
code is loaded.
/GO Finish up at the end of the current command
line instead of prompting for another line.
/HASHSIZE:decimal Sets the mimimum size of LINK's global symbol
hash table, to cut down on the number of
rehashes needed. The default value is 251.
/INCLUDE:name Loads the named module from the current file,
and tells LINK to process the file in include
mode, so that no other modules get loaded from
the file unless they are needed to satisfy
undefined globals and the current file is being
loaded in library search mode.
/LINK:name Closes off the current overlay link and gives
it the specified name.
/LOCALS Tells LINK to remember the local symbols from
all of the modules in the current file. These
are valuable if you want a map or a runtiime
/LOG Requests an output file containing a log of the
/LOGLEVEL:decimal Like /ERRORLEVEL, but controls which messages
get put into the log.
/MAP:keyword Requests a map of the program being loaded.
/MAXCOR:decimal Tells LINK not to expand its low segment larger
than the specified amount during the load.
/MISSING Types a list of modules requested by a global
/INCLUDE that have not yet been seen.
/MIXFOR Allows loading of both Fortran and F40 compiled
/MTAPE:keyword Performs a tape operation on the current input
or output magtape. Keywords:
/NEWPAGE:keyword Rounds the specified segment up to the next
page boundary. Keywords:
/NODE:linkid Tells LINK that the overlay link you are about
to start loading will be a new son of the named
link. linkid may be either the name or the
number of the node.
/NOENTRY:name Tells LINK that the named entry into the
current overlay link will not be referenced
from other links, thus saving some table space
/NOINCLUDE Tells LINK not to process the current file in
include mode. This means that the entire file
will be loaded unless you have requested
library search mode.
/NOINITIAL Prevents loading LINK's internal copy of the
JOBDAT symbols, and requests a library search
of SYS:JOBDAT.REL at the end of loading if any
undefined globals remain.
/NOLOCAL Prevent LINK from remembering any local symbols
from the current file.
/NOMIXFOR Requires that all loaded code be either Fortran
or F40, but not both.
/NOREQUESTS:name Tells LINK that the named symbol that is
referenced in the current overlay link but
defined in other(s) will not actually be
referenced at runtime. This saves table space
/NOSEARCH Turns off library search mode for the current
/NOSTART Tells LINK to ignore any start addresses in the
/NOSYMBOL Tells LINK that you will not need the local
symbols for any module loaded. If LINK has
already saved some, it throws them away.
/NOSYSLIBRARY:keyword Prevents the normal search of the named system
library at the end of loading. Keywords:
/NOUSERLIBRARY:keyword Takes the current file out of LINK's internal
list of user libraries, as set by /USERLIBRARY.
/ONLY:keyword Loads only the named segment of modules in the
current file. Keywords:
/OTSEGMENT:keyword Controls whether the runtime system should be
loaded by LINK or brought in at runtime from
SYS: by the program itself. Keywords:
/OVERLAY:keyword Tells LINK that you wish to load an overlay
structure, and names the .OVL and .EXE files if
associated with a file name. This switch must
appear before any .REL files have been loaded.
/PATCHSIZE:decimal Controls the size of the PAT.. area that is
allocated if a runtime symbol table is
/PLOT:keyword Requests an output file containing a diagram of
your overlay structure in a format suitable for
output on a plotter. Keywords:
/REQUEST Types a list of unsatisfied external subroutine
calls in the current overlay link.
/REQUIRE:name Generates a global request for the named
/RESET:linkid Equivalent to /NODE:linkid. /NODE is
/REWIND Rewinds the current input or output magtape.
/RUNAME:name Sets the name of the program being loaded.
/SAVE Requests an output .EXE file containing the
program being loaded. Any high segment saved
will be non-sharable.
/SEARCH Tells LINK to load selectively from the current
file, in library search mode. Only modules
that satisfy undefined global symbols are
/SEGMENT:keyword Loads low and high segment code from the
current file into the named segment. Psect
code is not affected. Keywords:
/SEVERITY:decimal Causes messages with severity greater than or
equal to the specified value to be fatal,
aborting the load. Setting this parameter to 8
will cause most warnings to become fatal.
/SET:name:octal Sets the loading address of a psect, or sets
the .HIGH. or .LOW. relocation counter.
/SKIP:decimal Skips the specified number of files on the
current input or output magtape.
/SPACE:decimal Reserves the specified amount of space for
runtime buffers after the current overlay link.
/SSAVE Same as /SAVE, except that any high segment
written will be sharable.
/START:address Specifies the start address for the loaded
program, and prevents replacement by any other
start addresses found later. The address may
be a global symbol or an octal number.
/SYFILE:keyword Tells LINK to output a symbol file to the
current file, and sets /SYMSEG:DEFAULT.
/SYMSEG:keyword Places the symbol table immediately following
the named segment or psect. Keywords:
/SYSLIBRARY:keyword Explictly searches one or more system
libraries. LINK automatically searches system
libraries at the end of the load or each
overlay link. Keywords:
/TEST:keyword Loads a debugger but does not start its
execution. This switch also turns on /LOCALS
and /SYMSEG:LOW for the remainder of the load.
/UNDEFINED Types a list of global symbols that are not yet
/UNLOAD Unloads the current input or output magtape.
/UPTO:address Prevents the symbol table from growing past the
specified address. The address may be a global
symbol or an octal number.
/USERLIBRARY:keyword Tells LINK to search the current file before
searching system libraries. The keyword
indicates that the given library is to be
searched only if a module from the
corresponding compiler was loaded. Keywords:
/VALUE:symbol Types the name, value, and attributes of the
/VERBOSITY:keyword Tells LINK how much of each message to type.
/VERSION:version Sets the version of a file if specified for an
output file, or for the program and all output
/XPN Requests an output file containing the entire
uncompressed program. /SAVE is preferrable.
/ZERO Zeros the directory of the current input or