Google
 

Trailing-Edge - PDP-10 Archives - BB-4172H-BM - 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.