home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / asmutl / asmhelp.lbr / CHAP1.TQT / CHAP1.TXT
Encoding:
Text File  |  1985-03-22  |  7.5 KB  |  170 lines
  1.  
  2.  
  3.                               CHAP01.TXT
  4.                          Version 1.01 01/29/85
  5.                       Leonard Gilberg 74126,2044
  6.                         Robert Flagg 72466,2332
  7.  
  8.                          THE JOYS OF ASSEMBLY
  9.  
  10.         This   "Cookbook"  is  the  brainchild  of  Robert  Flagg
  11. [72466,2332],  Leonard   Gilberg   [74126,2044],   Bonnell  Frost
  12. [74076,223]  and   others,  who,   with  the  blessing  of  Frank
  13. Fallon (SYSOP),   felt  it  would  be helpful  if some members of
  14. the  Sig,   new and otherwise,   had an oppor tunity to  see  the
  15. struggles  of  members new to CP/M learning the ins and  outs  of
  16. using ASM,   LASM3 and/or ZASM.   Some of the "Recipes" here  are
  17. the  contribution of several members of the Sig who are  grateful
  18. to have the  opportunity  to pass along information given to them
  19. by  more  ex perienced members when they were struggling too.
  20.  
  21.         Too   often,    members  are  afraid  to  ask  for  help,
  22. thinking that the  question is too basic or that they will appear
  23. "dumb".   The   only  dumb  question is the unasked  one  because
  24. there  are always others eager to  pass  along advice and excited
  25. about  the  opportunity to  repay  the favors given them  in  the
  26. beginning, by helping someone else along.
  27.  
  28.         Should this Cookbook be approved and placed in "use",  we
  29. will all be happy to have been a part of it, especially, if it is
  30. of help to any one.
  31.  
  32.         Normally,  files  with  the extension  .ASM,  when  down-
  33. loaded,  are transformed into files with the extension .COM after
  34. the application of some version of ASM.COM and LOAD.COM.  At that
  35. time,   they  are  ready to run as in the case of any other  .COM
  36. file  you  have by simply typing the filename  without  the  .COM
  37. extension.
  38.  
  39.         In  some  cases,    for  example  where  the  program  is
  40. installed  as a patch,   in WordStar for instance,  you will stop
  41. after the use of ASM so that the file will have a .HEX extension.
  42. You will not,  in such cases, use  the LOAD.COM procedure.  There
  43. are some rarer variations of  this, but they are beyond the scope
  44. of this discussion.
  45.  
  46.         For  the  sake of terminology,   the .ASM is referred  to
  47. as  the "Source Code" file and the .COM file as the "Object Code"
  48. file.
  49.  
  50.         You  may  one  of those who "almost" understand  what  is
  51. being said about a particular program or action,   but really are
  52. not  sure  because some of the words are strange.    You  may  be
  53. afraid  that if you ask what the  word or words  mean,   everyone
  54. will think you're so dumb they won't want to talk to you anymore.
  55. Perish the thought!  For those of you who feel you need it,  here
  56. is our attempt at some sort of table of definitions.
  57.  
  58.                               DEFINITIONS
  59.  
  60.      ALGORITHM   - Generally,   a   special method of solving   a
  61. certain  kind of problem.
  62.  
  63. ASSEMBLERS  - Those programs,   such  as  ASM.COM,   LASM.COM   &
  64. ZASM.COM, which take an Assembly Language Source File and  create
  65. two  other  files--the object code .HEX file and  the  diagnostic
  66. .PRN file.
  67.  
  68. COMPILER - A language translator which takes as input source code
  69. in a high-level language such as Fortran, C, Pascal, or Cobol and
  70. generates  as  output either assembler-input code or object  code
  71. directly.
  72.  
  73. DDT   - An utility program,  by Digital Research Institute (DRI),
  74. supplied   with CP/M and used to "debug" programs.     Hence  the
  75. name DDT (cute,    huh?).  Used  to break a program down into its
  76. 8080 mnemonics so that those who know what they are can make  the
  77. changes desired.  DDT is RAM-memory oriented.
  78.  
  79. DU  - Another  utility program,    designed by  Ward  Christensen
  80. which works,   essentially,   the   same  as DDT,   with a little
  81. different  configuration,  and  now followed by DUU.COM.   DU  is
  82. oriented to work on disk memory.
  83.  
  84. ENTRY   POINTS  - The  specific location in a  program  where  an
  85. Overlay or other modification to the program begins.
  86.  
  87. GENERIC - A non-specific class, general in nature.
  88.  
  89. HEX   - A  "shorthand" reference to Hexidecimal  values,  usually
  90. known  as Intel format,   and created by the ASM program.    Also
  91. used as a file extension,  i.e., Filename.HEX.  Also, a situation
  92. which exists when Mother Nature discovers that you forgot to  put
  93. surge   protectors  on your equipment and calls down the elements
  94. to teach you better.
  95.  
  96. INITIALIZATION - A command or sequence of commands which  readies
  97. equipment  or a program for execution as desired.   Normally used
  98. in connection with setting equipment,  such as printers, to their
  99. default values.
  100.  
  101. INTERACTIVE - In the computereze climate, this is usually a point
  102. in   a  program  where you input information from  the   keyboard
  103. or  "interact" with the program.
  104.  
  105. LANGUAGE - A word which describes the particular type of instruc
  106. tion to a computer.     The "language" must be structured in such
  107. a  way  that  the  computer  "understands" and is able to convert
  108. the  instructions  contained  in the "language" into object code.
  109. Examples  could  be Assembly,   Cobol, Fortran, C, Pascal, Forth,
  110. etc.
  111.  
  112.  
  113. LOAD - The program,  usually supplied with CP/M,  which takes the
  114. .HEX  file generated by the ASM program and converts it  into   a
  115. .COM program ready to run.  LOAD.COM and MLOAD.COM are examples.
  116.  
  117. MACHINE LANGUAGE - Binary code, a series of 1's and 0's, which is
  118. the  only instruction that a computer  understands.   Every other
  119. language is either translated,  interpreted,  compiled, assembled
  120. or loaded so as to, ultimately, reach machine language.
  121.  
  122. MICROPROCESSOR - Usually, a silicon chip (such as Intel's 8080 or
  123. Zilog Z-80, such as is used in the Kaypro).
  124.  
  125. MNEMONICS - "Short-hand" or abbreviated instructions required  by
  126. a   particular  language processor in order for the  compiler  or
  127. assembler to generate object code.
  128.  
  129. OBJECT FILE  - The file which contains the binary code which  you
  130. always  wanted when you started with the "Source File."   Usually
  131. this is a .HEX or a .COM file.
  132.  
  133. OFFSET - Has more than one meaning.   In 8 bit operation, such as
  134. CP/M,  usually means a hexidecimal position or address other than
  135. the "usual" or "expected" location or address.  Normally given as
  136. an auxilliary address in the command where it is used.
  137.  
  138. OVERLAY  - A method allowing a group of changes to be made in  an
  139. existing  program.   The "overlay" program is typically a smaller
  140. program which,  when "overlaid" on an existing  program,  changes
  141. part  of the instructions in the existing program.   Overlays are
  142. commonly used to configure "generic" software to enable it to run
  143. on specific hardware setups.
  144.  
  145. PATCH, PATCHING - The process of changing a program byte-by-byte.
  146. Often  used  when  smaller changes are required  to  customize  a
  147. program.
  148.  
  149. SCREEN  CLEARING  - The act of giving or causing to  be  given  a
  150. command  or  series of commands which cause the CRT to  clear  or
  151. become blank.
  152.  
  153. SEQUENCE  - A series of commands,  structured to give a  computer
  154. specific instructions to accomplish.  Usually, must be given in a
  155. pre-set or predetermined order.
  156.  
  157. SOURCE   FILE   - The program  written in a  human-understandable
  158. language  which assemblers or compilers will convert to  machine-
  159. understandable object code.
  160.  
  161. SPECS - Short for specifications.
  162.  
  163. SUB - An  extension (.SUB) for a source file of commands for  the
  164. SUBMIT or EX program.
  165.  
  166. ZCPR  - A  Z80 Command Processor replacement for the CP/M Console
  167. Command Processor (CCP) which performs a new and different set of
  168. commands as well as the familiar CP/M commands.   Author is  Rick
  169. Conn.
  170. e to enable it to