home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / f / ramtools.ark / RT.DOC < prev    next >
Text File  |  1988-02-04  |  12KB  |  234 lines
  1.                                                                 04/24/87
  2.                                                                 Sam Weiss
  3.  
  4.  
  5.                               Documentation for:
  6.  
  7.  
  8.                                *** Ram Tools ***
  9.  
  10.           The ultimate utilities program that stays in RAM!!!!
  11.  
  12.  
  13.  
  14.      So what is this program all about???
  15.  
  16.           Ram Tools is a RAM resident utility program that sits ABOVE 
  17.           CP/M  SO IT DOES NOT ANY TPA SPACE.   When this program  is 
  18.           installed,  with the touch of a key,  you get the following 
  19.           commands:   Screen  Saver(This is the Screen Saver  program 
  20.           available  to  you  in RAM,  anytime[Screen Saver  will  be 
  21.           discussed later in this document]), Turning the cursor into 
  22.           a solid block,  clear the screen,  cold boot(It asks you if 
  23.           you want to reset the computer before it does it), and send 
  24.           chars  to  the printer.    ALL THIS WITHOUT TAKING ANY  TPA 
  25.           SPACE!!!
  26.  
  27.      System Requirements:
  28.  
  29.           Kaypro 4'84 running plain CP/M,  or ZCPR3.   This will also 
  30.           work on the EPEX operating environment.  THE ABOVE ARE  THE 
  31.           ONLY  COMPUTERS/OPERATING  SYSTEMS THAT I HAVE TESTED  THIS 
  32.           PRODUCT ON.   IT MAY WORK WITH OTHERS TOO.   This may  work 
  33.           with  other 84 kaypros,  so long as the BIOS entry point is 
  34.           F400.   HOWEVER,  AS  FAR AS I KNOW THIS PROGRAM WILL  ONLY 
  35.           WORK ON THE KAYPROS THAT HAVE GRAPHICS  CAPABILITIES.   The 
  36.           code  is included,  so you can make your own changes.    IF 
  37.           Ram  Tools  is  found not to  work  on  your  computer/CP/M 
  38.           operating  system replacement,  write me a letter with  the 
  39.           address of the bios,  the type(name) of the computer, along 
  40.           with the following screen commands:   Clear screen,  status 
  41.           line  on/off(a permanent 25th line),  remember last  cursor 
  42.           position,  return  to remembered cursor position,  clear to 
  43.           end of line,  turn cursor on/off,  and I'll see what I  can 
  44.           do.  (THE ABOVE VIDEO COMMANDS MUST BE AVAILABLE UNLESS YOU 
  45.           DON'T CARE ABOUT GARBAGE ON YOUR DISPLAY SCREEN)[owners  of 
  46.           '84 Kaypros do not need to include the video commands]
  47.  
  48.      Invoking RamTools:
  49.  
  50.           getting  RamTools(RT)  installed in memory is  quite  easy.  
  51.           All  you  have to do is rename the proper  installation  of 
  52.           RamTools to RT,  Then just type RT.  So far, there are only 
  53.           2 versions of RT in this library:  RTCPM,  and RTZCPR.   If 
  54.           you  are  using plain CP/M,  use RTCPM.   If you are  using 
  55.           ZCPR3, use RTZCPR.
  56.  
  57.           Once  you have RT renamed,  all you have to do is type "RT" 
  58.           at the A0> prompt.   It will tell you that it is ready, and 
  59.           put a little command summary at the bottom of the screen(IF 
  60.           THE COMMAND SUMMARY GOES AWAY, IT DOES NOT MEAN THAT RT HAS 
  61.           GONE  AWAY TOO...  IT JUST MEANS THAT SOME  PROGRAM  NEEDED 
  62.           THE STATUS LINE FOR SOMETHING).
  63.  
  64.           Note:  when  you run RT,  the cursor will also turn into  a 
  65.           block automatically,  because I hate blinking cursors,  and 
  66.           if I have this program do it,  I don't need to put  another 
  67.           program on the disk to turn the cursor into a block.
  68.  
  69.           You  may wish to put RT in your startup batch file/program, 
  70.           or make it an autoboot program(I'll tell you how to do that 
  71.           later...)
  72.  
  73.      Removing RT from memory:
  74.  
  75.           You  may  remove RT from memory either 2 ways:  do  a  cold 
  76.           boot(press the reset button) of the computer(this may  also 
  77.           be  done by pressing the key which activates the cold  boot 
  78.           feature  in  this program).   OR,  you can just run the  RT 
  79.           program  again...   it toggles itself in and out of  memory 
  80.           (running RT the first time would put it in memory,  running 
  81.           rt the second time would take it out of memory,  running it 
  82.           a third time would put it back in memory, etc)
  83.  
  84.      OK... ALL THIS IS GREAT, BUT HOW DO I USE THE PROGRAM???
  85.  
  86.           NOTE:   AFTER ACTIVATION OF ONE OF THESE KEYS, AN ADDITION-
  87.           AL  KEY MAY HAVE TO BE PRESSED IN ORDER FOR THE PROGRAM YOU 
  88.           ARE CURRENTLY RUNNING TO GAIN CONTROL AGAIN.   ALSO, DURING 
  89.           THE OPPERATION OF THESE UTILITIES, THE PROGRAM EXECUTION OF 
  90.           THE   PROGRAM  CURRENTLY  IN  MEMORY  WILL  BE   SUSPENDED.  
  91.           However,  when  using the internal modem,  the  modem  will 
  92.           still  emit  the "carrier",  so you can use  the  utilities 
  93.           while on-line.
  94.  
  95.           Once  you  have RT in memory,  the following  keys  may  be 
  96.           pressed to do the following actions:
  97.  
  98.  
  99.  
  100.            Ctrl-@:  Screen  Saver...   this is used to save your  crt 
  101.              (^@)   screen from being "burned in" from stuff being on 
  102.                     the  screen for long periods of time.   After you 
  103.                     press this key,  the screen will clear (including 
  104.                     the status line),  and the cursor will be  turned 
  105.                     off.   This  computer will then wait for a key to 
  106.                     be pressed.   After a key has been  pressed,  the 
  107.                     cursor  will come back,  and control will go back 
  108.                     to the original program.
  109.  
  110.            Ctrl-^:  Pressing  this  key will turn the cursor  into  a 
  111.              (^^)   solid block.  The reason I put this command in is 
  112.                     because  I  have always hated a blinking cursor.
  113.  
  114.            Ctrl-_:  Cold  Boot...  Pressing  this key  will  cause  a 
  115.              (^_)   message to be displayed on the status line asking 
  116.                     if  you  want  to reset the  computer(do  a  cold 
  117.                     boot).   Pressing  'y' or 'Y' while the prompt is 
  118.                     displayed  will cause the computer to do  a  cold 
  119.                     boot.   Pressing  any  other key will  abort  the 
  120.                     attempt.
  121.  
  122.            Ctrl-]:  Clear the screen...   Pressing this key will just 
  123.              (^])   clear the screen--nothing else
  124.  
  125.            Ctrl-\:  Pressing  this key will put a prompt down at  the 
  126.                     (^\) status line that looks like this:  "Print>".  
  127.                     At this prompt,  anything you type will be echoed 
  128.                     to  the  printer.   You could use  this  to  send 
  129.                     control  codes  to your printer(note:  the  above 
  130.                     keys still have the same affect, so pressing '^^' 
  131.                     at this prompt would only turn the cursor into  a 
  132.                     solid  block,   and  NOT  send  anything  to  the 
  133.                     printer.).   You  could also use this feature  to 
  134.                     write  notes to yourself when you don't have  any 
  135.                     paper handy.
  136.  
  137.      Modifying Ram Tools
  138.  
  139.           The  source to RamTools is in two files,  because my Public 
  140.           Domain Z80 assembler(Z8MR) will not do phased code.  IF YOU 
  141.           CHANGE  THE BIOS ADDRESS,  BOTH FILES NEED TO BE  CHANGED!!  
  142.           So,  in order do change the files, you must make the neces-
  143.           sary  changes  and  assemble BOTH files(the code is in  Z80 
  144.           code,  so any Z80 assembler should be able to do it(I  used 
  145.           Z80MR).   AN  8080 ASSEMBLER WILL NOT WORK,  EVEN IF IT  IS 
  146.           CONVERTED TO 8080 CODE, BECAUSE IT USES THE "LDIR" COMMAND, 
  147.           WHICH IS NOT SUPPORTED BY THE 8080.).   After that, all you 
  148.           need  to do is place "EX.COM"(supplied),  RT.SUB(supplied), 
  149.           DDT(not  supplied),   and  the  two  hex  files(RT.HEX  and 
  150.           RT1.HEX)  [made from assembling rt.azm,  and rt1.azm] on  a 
  151.           disk and place it in drive a.   THE HEX FILES MUST BE NAMED 
  152.           "RT.HEX",  AND "RT1.HEX".  Then type "ex  rtcreate".   This 
  153.           will  make a program called "RTN.COM",  which can of course 
  154.           be renamed to whatever you like.
  155.  
  156.           NOTE:   There  are only three bytes left until you hit  the 
  157.           top of memory, so to make any additions to the program, you 
  158.           will have to shrink it a lot!!
  159.  
  160.           Please send any changes to this program back to me,  at the 
  161.           address below.
  162.  
  163.  
  164.      MAKING THIS PROGRAM "AUTO BOOT" WHEN YOU TURN ON YOUR COMPUTER
  165.  
  166.           Note:  As  far as I know,  this little patch will only work 
  167.           with plain CP/M.  I made this really simple... all you have 
  168.           to  do  is put dumpx(a file dumper AND sector  editor)[this 
  169.           file is supplied] onto a disk with RT,  "RTBOOT.SUB"  (SUP-
  170.           PLIED),  and "ex.com"(supplied).   Then, all you have to do 
  171.           is  type  "EX  RTBOOT".   After  it  is  done,  reset  your 
  172.           computer,  and  see what happens.   If you do not  get  the 
  173.           sign-on for RT, it is suggested that you re-copy the system 
  174.           onto  that disk,  because the system may be messed up,  and 
  175.           could mess up other things too.
  176.  
  177.      FINAL NOTES:
  178.  
  179.           Although this program has not crashed,  or caused any other 
  180.           program  to crash yet on my system,  it  is  possible.   So 
  181.           please   test  this  with  your  software  before  you  use 
  182.           it(especially if it is RAM-Resident).   I WILL NOT HOLD ANY 
  183.           RESPONSIBILITY  IF  ANY DATA OR A PROGRAM IS LOST  DUE  THE 
  184.           USAGE  OF  THIS PROGRAM.   If you do run  into  a  problem, 
  185.           please  notify  me of the problem,  and please include  any 
  186.           information  which  you  may think  helpful  to  solve  the 
  187.           problem.
  188.  
  189.           As far as I know, the only problem this program will create 
  190.           is messing up the screen(some programs really look weird if 
  191.           you clear the screen without it knowing you did.   Also, I 
  192.           know  that  this  program will not work with  dump10(a  ram 
  193.           resident screen to printer dump), because this program uses 
  194.           the  same memory space(that's where I got this idea to  put 
  195.           it above CP/M).
  196.  
  197.  
  198.  
  199.  
  200.  
  201.      For The future:
  202.  
  203.           For the future,  I intend to have a "patch bypass" key,  so 
  204.           you  can  enter the control chars that this thing uses  for 
  205.           it's   commands(being  able  to  press  "Ctrl-^"  and   get 
  206.           "Ctrl-^",  instead of a solid cursor.   I will also attempt 
  207.           to  CRAM  more useful commands into memory.   I would  also 
  208.           like  to find a way to make it "patchable" so any  computer 
  209.           can use the commands.  
  210.  
  211. -----------------
  212.  
  213. Any questions/comments/or (god forbid) complaints  should be directed to:
  214.  
  215.           Sam Weiss
  216.           1165 Balclutha Dr.
  217.           Foster City CA  94404
  218.  
  219.                --or--
  220.  
  221.           on compuserve:   Sam Weiss[74666,2263]
  222.  
  223.  
  224.                --or--
  225.  
  226.           Kay*fun BBS(415) 572-8219            300/1200/2400
  227.           Leave message to : Sam Weiss
  228.  
  229.  
  230.                              Thanks
  231.  
  232.                              Sam Weiss
  233.                             (Mad@Kaypro)
  234.