home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / nstar / user.cfg < prev    next >
Encoding:
Text File  |  1987-10-26  |  3.7 KB  |  77 lines
  1. Extracted  from  "CP/M2  ON  NORTH  STAR  DISK  DOUBLE DENSITY - QUAD
  2. CAPACITY USER'S NOTES BY LIFEBOAT ASSOCIATES"
  3.  
  4. There  are  two  methods of making changes in your I/O.  The SAVEUSER
  5. program  is providad as a quick and easy way of making short patches.
  6. The  SYSGEN  procedure  is  a  comprehensive  method of making system
  7. changes.
  8.  
  9.                      PATCHING WITH SAVEUSER
  10.  
  11.      Running the SAVEUSER program at any time will write a portion of
  12. the then running  CP/M system onto the disk in drive A.  The specific
  13. portion written consists  of  the  entire USER AREA (512 bytes or two
  14. pages starting at BIOS+700 hex) and  the  MODE  AREA which is the 128
  15. bytes  immediately  before  the  USER AREA.  In the distribution  24K
  16. system the MODE AREA starts at 5980  hex  and the USER AREA starts at
  17. 5A00 hex and ends at 5BFF hex.
  18.  
  19.      Normal changes in the MODE AREA would  be  modifying  the  CONFG
  20. byte  at  59F8 hex for two sided or fast stepping drives or making  a
  21. permanent change in the MODE BYTE.  Complete definitions of these are
  22. in Appendix A.  Any changes in the USER AREA would be for the purpose
  23. of making a  quick  patch  to  your  CONSOLE,  LIST,  PUNCH or READER
  24. routines.    These patches could be made with DDT and if  they  prove
  25. satisfactory, permanently saved on the system disk with SAVEUSER.
  26.  
  27.      To run the program, simply type "SAVEUSER".  It will sign on and
  28. ask for confirmation  that  you really wish to write onto the disk in
  29. drive A.  A <CR> response will  begin  the write.  You may also abort
  30. without writing anything by entering control C.
  31.  
  32.  
  33.                         SYSGEN PROCEDURE.
  34.  
  35.      The  SYSGEN PROCEDURE is an advanced  method  of  changing  your
  36. system configuration.    It  should  only be used when your system is
  37. running  properly and you have become completely  familiar  with  the
  38. features of CP/M.  This procedure uses the ED.COM editor, the ASM.COM
  39. assembler,    the  DDT.COM  debugger,  and  the  SYSGEN.COM  program.
  40. Familiarize yourself with the use of these programs before attempting
  41. to change your system configuration in this way.
  42.  
  43.      This procedure uses the facilities of CP/M to create an assembly
  44. language file containing  your  customized  I/O.    Use as a starting
  45. point  USER.ASM  which  contains the proper equates and  jump  table.
  46. Modify USER.ASM using ED  to  suit  your  own  purposes.   Be sure to
  47. change the equate for MSIZE in the file to the desired memory size of
  48. your CP/M.  Next, assemble your modified file with ASM.COM to produce
  49. USER.HEX  which  will  be  used  to  overlay and modify your existing
  50. system.
  51.  
  52.      The existing system is then brought into memory at location 900H
  53. (hex)  using  the SYSGEN program.  This  is  the  standard  and  most
  54. convenient memory  location  for  making  changes in the CP/M system.
  55. The copy of CP/M starting at 900H is usually called the SYSGEN IMAGE.
  56. Save  the  SYSGEN  IMAGE  as  a  disk file by the  command  "SAVE  40
  57. CPM.COM<CR>".
  58.  
  59.      CPM.COM is then brought back  into  memory  under the control of
  60. DDT with the command "DDT CPM.COM<CR>". The SYSGEN IMAGE  at  900H is
  61. then  overlaid  with  USER.HEX  using  the  "I"  insert  and "R" read
  62. commands of DDT.
  63.  
  64.      Note  that  USER.HEX is read in with an offset so that  the  hex
  65. file will be placed  at 2700H.  The offset changes for each different
  66. CP/M system size and is  equal  to  2700 hex minus wherever your USER
  67. AREA begins in memory (5A00 hex in standard  24K system).  The proper
  68. offset  is  automatically  calculated for each MSIZE  by  the  OFFSET
  69. equate in USER.ASM or the DDT  "H"  hex  calculator may be used as in
  70. the example.
  71.  
  72.      At this point, the new system has been  patched with your custom
  73. I/O and may be directly put on the system tracks with SYSGEN or saved
  74. again as a disk file for later use.
  75.  
  76.                               -end-
  77.