home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ENTERPRS / CPM / UTILS / F / M80-L80.LBR / L80NEW.HZP / L80NEW.HLP
Text File  |  2000-06-30  |  4KB  |  112 lines
  1. Linker for Microsoft/Cromemco Products
  2. Command Line
  3. Switches
  4. Error Messages
  5. :LINK:
  6.         The linker is used to link assembled, Compiled programs modules
  7. together, load them into memory, and begin execution if desired.  The
  8. program modules can come from different sources  Some of the sources are
  9.           BASCOM
  10.           COBOL
  11.           FORTRAN
  12.           ASSEMBLER
  13.           RPG
  14.           
  15. :LINK:
  16.     The format for the involk of Linker is
  17.  
  18.  
  19.    LINK <filename1.ext/s,filename2.ext/s,....>
  20.  
  21.     where   filename stands for   Disk drive letter followed by a colon
  22.                      followed by the absolute file name
  23.  
  24.             ext  is used if the module extension is different than .rel
  25.             
  26.             /s   stands for switch options.
  27.   EXAMPLE of a link
  28.  
  29.      LINK MAIN,FORLIB/S,MAIN/N/G/E
  30.  
  31.       The first MAIN is the name of the module from the fortran compiler
  32.       The FORLIB/S  is the library of standard fortran routines that will
  33.            be selected
  34.       The MAIN/N/G/E  means to name the .COM file MAIN and to save it on
  35.            current disk then execute MAIN automatically.
  36.  
  37. :LINK:
  38.                           SWITCH OPTIONS
  39.  
  40.     Each switch option is preceded by a /
  41.  
  42.     E ....  Exit to operating system
  43. |         The /E switch may also be followed by the global symbol where
  44. |         execution should begin when the program is run, by using the
  45. |         format:    /E:LABEL      Note that the label may be a maximum
  46. |         of six characters in length.  Link will insert a    JMP LABEL
  47. |         instruction at address 0100(hex) so that execution will begin
  48. |         at the desired location.  An ORG statement to 0100(hex) must
  49. |         not be used in any of the source modules when using this option,
  50. |         since the ORG will override the /E switch mechanism.
  51.     
  52.     G ....  Go start execution
  53.           Start execution of the program as soon as the current command
  54.           line has been interpreted.
  55.  
  56.     M ....  Map all symbols
  57.           List both all the defined globals and their values and all 
  58.           undefined globals followed by an asterisk.
  59.  
  60.     R ....  Reset the linker
  61.           Puts the linker back to its initial state.   the /R is used
  62.           to restart LINK if the wrong file was loaded by mistake.
  63.  
  64.     S ....  Search file
  65.           Search the disk file having the filename immediately preceding
  66.           the /S in the command string, to satisfy any undefined globals.
  67.           This is convenient for having the linker search a library file
  68.           of much-used routines.
  69.  
  70.     U ....  List all undefined globals
  71.           List all undefined globals as soon as the current command line
  72.           has been interpreted and executed.  Link defaults to this 
  73.           switch; therefore it is generally not needed.
  74.  
  75. |   H ....  List all values in hexidecimal
  76. |      List all numeric values, such as defined and undefined globals,
  77. |         program start address, data and program size, in hexidecimal.
  78. |         Link defaults to this switch; therefore it is generally not
  79. |         needed.
  80.  
  81. |   O ....  List all values in octal
  82. |         List all numeric values octal.  This switch behaves like the
  83. |         /H option, except the base used for numeric display is base 8.
  84.  
  85. |   X ....  Generate a .HEX output file
  86. |         The code output of the linker will be in Intel .HEX format
  87. |         instead of the default .COM format.
  88.  
  89. |   Y ....  Generate a symbol table file
  90. |         The linker will generate a .SYM file, containing a list of all
  91. |         globals and their addresses, suitable for use with a symbolic
  92. |         debugging tool such as SID.COM or ZSID.COM.
  93.  
  94. :LINK:
  95.                  ERRORS
  96.  
  97.    No start address       a /G is issued but no main program module
  98.                           has been loaded.
  99.  
  100.    Loading error          The file given is not a properly formatted
  101.                           link object file.
  102.  
  103.    Fatal Table Collision  There is not enough memory
  104.  
  105.    Command error          Unrecognizable link command
  106.  
  107.    File not found         Specified file not on specified disk
  108.  
  109.    mult def global        More than one definition of the global name
  110.                           (possibly wrong modules combined)
  111. :LINK:
  112.