Trailing-Edge
-
PDP-10 Archives
-
bb-d868e-bm_tops20_v41_2020_dist_1of2
-
new-subsys/link.hlp
There are 61 other files named link.hlp in the archive. Click here to see a list.
NOTE
This file contains
conditionals to generate
either the TOPS-10 or the
TOPS-20 version of the LINK
help file. To get the TOPS-10
version, specify
/VARIANT:(OK,TEN) to RUNOFF.
To get the TOPS-20 version,
specify /VARIANT:(OK,TWENTY).
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:
1. *TWELVE/SSAVE/MAP=ONE,TWO/GO
2. *ONE,TWO
*TWELVE/SSAVE
*TWELVE/MAP
*/GO
3. */MAP TWELVE=ONE
*TWO
*TWELVE/SSAVE/GO
When using LINK's overlay facility, the command format is as
follows:
*/OVERLAY
*file,file,file,file/LINK:ROOT
*/NODE:ROOT file,file,file/LINK:name
*/NODE:name file,file,file/LINK:name
. . .
*/GO
Page 2
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:
ALL [NO]ABSOLUTE
[NO]COMMON DEFAULT
[NO]ENTRY [NO]GLOBAL
[NO]LOCALS NONE
[NO]RELOCATABLE [NO]UNDEFINED
[NO]ZERO
/COUNTER Types psect origins and breaks.
/DDEBUG:keyword Selects a default debugger for
/DEBUG.
Keywords:
ALGDDT ALGOL COBDDT
COBOL DDT FAIL
FORDDT FORTRAN MACRO
SAIL SDDT SIMDDT
SIMULA PASCAL PASDDT
/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:
ALGDDT ALGOL COBDDT
COBOL DDT FAIL
FORDDT FORTRAN MACRO
SAIL SDDT SIMDDT
SIMULA PASCAL PASDDT
/DEFAULT:keyword Changes LINK's defaults for missing
parts of file specs, or sets file
specific switches for the remainder
of the load.
Keywords:
INPUT OUTPUT
/DEFINE:name:decimal Defines a global symbol.
Page 3
/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 normally
suppressed.
/EXCLUDE:name Prevents the named module from
being loaded from the input file.
/EXECUTE Tells LINK to start the program
after loading is completed.
/FRECOR:decimal Maintains space between LINK's
internal areas to cut down on the
amount of shuffling done. The
default value is 1024.
/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.
/HELP:arg Causes terminal typeout for LINK.
The argument is optional, and maybe
either SWITCHES or TEXT.
/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.
/LIMIT:psect:address If the psect grows beyond the
specified address, LINK will send a
warning message, but will continue
loading.
/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
Page 4
valuable if you want a map or a
runtiime symbol table.
/LOG Requests an output file containing
a log of the loading process.
/LOGLEVEL:decimal Like /ERRORLEVEL, but controls
which messages get put into the
log.
/MAP:keyword Requests a map of the program being
loaded.
Keywords:
END NOW
/MAXNODE:n Specifies the number of links to be
defined when an overlayed program
requires more than 256 links. This
switch must be place after the
/OVERLAY switch and must precede
the first /NODE switch.
/MISSING Types a list of modules requested
by a global /INCLUDE that have not
yet been seen.
/MTAPE:keyword Performs a tape operation on the
current input or output magtape.
Keywords:
MTBLK MTBSF MTBSR
MTDEC MTEOF MTEOT
MTIND MTREW MTSKF
MTSKR MTUNL
/NEWPAGE:keyword Rounds the specified segment up to
the next page boundary.
Keywords:
LOW HIGH
/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 at
runtime.
/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
Page 5
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.
/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 at runtime.
/NOSEARCH Turns off library search mode for
the current file.
/NOSTART Tells LINK to ignore any start
addresses in the current file.
/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:
ANY F40 ALGOL
FAIL BASIC FORTRAN
BCPL MACRO BLISS
MIDAS BLS36 NELIAC
CBL74 PL1 SAIL
COBOL SIMULA SITGO
/NOUSERLIBRARY:keyword Takes the current file out of
LINK's internal list of user
libraries, as set by /USERLIBRARY.
Keywords:
ANY FAIL
ALGOL FORTRAN
BASIC MACRO
BCPL MIDAS
BLISS NELIAC
BLS36 PL1
CBL74 SAIL
CBL79 SIMULA
COBOL SITGO
Page 6
F40
/ONLY:keyword Loads only the named segment of
modules in the current file.
Keywords:
HIGH LOW BOTH
/OTSEGMENT:keyword Controls whether the runtime system
should be loaded by LINK or brought
in at runtime from SYS: by the
program itself.
Keywords:
SHARABLE NONSHARABLE
/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.
Keywords:
ABSOLUTE [NO]LOGFILE
RELOCATABLE [NO]WARNING
/PATCHSIZE:decimal Controls the size of the PAT.. area
that is allocated if a runtime
symbol table is requested.
/PLOT:keyword Requests an output file containing
a diagram of your overlay structure
in a format suitable for output on
a plotter.
Keywords:
INCHES:decimal
LEAVES:decimal
STEPS:decimal
/PLTTYP:keyword Allows specification of the plot
file format.
Keywords:
DEFAULT
PLOTTER
PRINTER
/PVBLOCK:keyword Requests a program data vector and
specifies where the vector goes.
Keywords:
DEFAULT HIGH
LOW NONE
PSECT:name
/PVDATA:keyword:value Changes the contents of a program
data vector specified with the
/PVBLOCK switch.
Keywords:
Page 7
NAME VERSION
MEMORY PROGRAM
CBLOCK START
/REQUEST Types a list of unsatisfied
external subroutine calls in the
current overlay link.
/REQUIRE:name Generates a global request for the
named symbol.
/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.
/SEARCH Tells LINK to load selectively from
the current file, in library search
mode. Only modules that satisfy
undefined global symbols are
loaded.
/SEGMENT:keyword Loads low and high segment code
from the current file into the
named segment. Psect code is not
affected.
Keywords:
DEFAULT LOW
HIGH NONE
/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.
/START:address Specifies the start address for the
Page 8
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.
Keywords:
ALGOL RADIX50 TRIPLET
/SYMSEG:keyword Places the symbol table immediately
following the named segment or
psect.
Keywords:
DEFAULT HIGH
LOW NONE
PSECT:name
/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:
ANY ALGOL BASIC
BCPL BLISS BLS36
CBL74 COBOL FAIL
FORTRAN F40 MACRO
MIDAS NELIAC PL1
SAIL SIMULA SITGO
/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.
Keywords:
ALGDDT ALGOL COBDDT
COBOL DDT FAIL
FORDDT FORTRAN MACRO
SAIL SDDT SIMDDT
SIMULA PASCAL PASDDT
/UNDEFINED Types a list of global symbols that
are not yet defined.
/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.
Page 9
/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:
ANY ALGOL BASIC
BCPL BLISS BLS36
CBL74 COBOL FAIL
FORTRAN F40 MACRO
MIDAS NELIAC PL1
SAIL SIMULA SITGO
/VALUE:symbol Types the name, value, and
attributes of the specified symbol.
/VERBOSITY:keyword Tells LINK how much of each message
to type.
Keywords:
SHORT
MEDIUM
LONG
/VERSION:version Sets the version of a file if
specified for an output file, or
for the program and all output
files otherwise.