Usage of LINK.COM

  taken from 'CP/M The Software Bus'

LINK  options  follow  the file specifications,  and are  enclosed  in  square 
brackets []. Multiple options are seperated by commas.

A                          Additional  memory.   Reduces  buffers  and   write
                            temporary data to disk.
B                          This is the BIOS link in banked CP/M 3.1
                            systems. It aligns data segments to page 
                            boundary,puts  length of code segment in 
                            header and defaults to SPR type.
Dnnnn                      Sets the memory origin to nnnn (hex) for
                            common and data areas
Gn                         Go. Sets start adress to label n
Lnnnn                      Load. Changes default load adress from 
                            100h to nnnn
Mnnnn                      Memory size. Define free memory for MP/M 
                            modules
NL                         No Listing of symbol table at console
NR                         No symbol table file
OC                         Output is COM file (default)
OP                         Output is PRL (page relocatable) file for
                            MP/M
OR                         Output is RSP (resident system process)
                            file for MP/M
OS                         Output is SPR (sytem page relocatable)
                            file for MP/M
Pnnnn                      Changes default program origin from 100h
                            to nnnn
Q                          Lists all symbols with leading question mark
$Cd                        Put console output to d,where d is X (console,
                            default) or Y (printer,LST device) or Z (no
                            output)
$Id                        Source of intermediate files where d is drive
                            A thru P, default is logged drive
$Ld                        Source of library
$Od                        Destination of object file. d is drive A thru P
                            or Z (no object file). Default is same drive
                            as first file in command line
$Sd                        Destination of symbol file. same as for $Od,but
                            pseudo drive Y(printer)


Some examples will illustrate the use of these commands

(1)         LINK file1,file2,file3

This  takes  the  three seperately combined  files,  resolves  their  external 
references and produces a single executable command file called file1.COM

(2)         LINK filename=file1,file2,file3

This does the same as ex.1 but the command file is called filename.com


(3)         LINK B:filename[NR]

This  option specifies no symbol table.  There must be a B:filename.REL and it 
will produce a file on B: called filename.com


(4)         LINK file1,file2[S]

The  linker  will search file2 for subroutines referenced in  file1  and  will 
combine them with file1 to produce an executable command file file1.COM


(5)         LINK filename[OP,Q]=file1,file2

This  will combine file1.REL and file2.REL producing filename.PRL and  listing 
all the symbols with leading question mark.




NOTE   LINK.COM  is the linker for CPM3.x,  it is also designed to  work  for 
   CP/M2.x and MP/M
 
A  full description of LINK-80 is supplied in th programmers utility guide for 
CP/M 3.
It  will  combine  REL files produced by RMAC ,  ZASM  ,  BASCOM  etc  into  a 
COM,RSX,PRL  file  ready  for execution.  It is also needed to  generate  CPM3 
systems.