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 / ZSYS / ZSYSARK / Z3HLP01.ARK / C.LBR / CLRRSX.HZP / CLRRSX.HLP
Text File  |  1990-03-23  |  3KB  |  54 lines

  1. ;
  2.                                  CLRRSX.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                1k (6)    20DB  1.1        Jay Sage 7/86            Z3COM8
  6.  
  7.   1- Usage  2- Notes                                                          
  8.  
  9.    CLRRSX is  used  to  remove  any installed  RSX (resident system extension)
  10. modules that are present.  An  RSX is  deemed to  be present  if  the warmboot 
  11. vector at 0001h does  not point to an address ending in 03, or the BDOS vector 
  12. at 0006h does not point to an address ending in 06, or the BIOS and BDOS pages
  13. do not differ by 0EH.  
  14. :1
  15.  
  16.    Usage:  CLRRSX<cr>
  17.  
  18.    CLRRSX installs itself  automatically  the first time it is run with no RSX 
  19. present by copying the virgin BIOS jump vectors  into  a buffer  at the end of 
  20. the program.  (As of version 1.1,  the program also saves  the original BDOS+6 
  21. entry point and  the jump address  to  which it  branches.  This  is what some 
  22. above-the-BIOS  system extensions use to  divert BDOS  calls since they do not 
  23. have to protect the CCP.) 
  24.  
  25.    Subsequently, if  it is  called  with  an RSX present, it restores the BIOS 
  26. jump table (Version 1.1 restores jump address at BDOS+7) and warm boots.
  27.  
  28.    When it  is called with  an RSX present and it has not been installed, then 
  29. an error message is given.  Similarly,  an error message  is given when it has
  30. been installed already but is called when no RSX is present.
  31. :2
  32.  
  33. CLRRSX Notes:
  34.  
  35.    a. Note that the  file name in the FCB at the beginning of the code must be 
  36.       the actual name  of the program  in order to carry out the installation.
  37.       Once the program has been installed, however, it can be renamed.
  38.  
  39.    b. Version  1.1  adds  two  additional  capabilities:  it  now  checks  for
  40.       alteration of the  jump table  as an  RSX  condition, except  when being 
  41.       installed, in  which case  it would have no reference to check from.  It 
  42.       also restores  the original initial  BDOS jump address at BDOS+7.  These 
  43.       two additions  make CLRRSX useful for detaching BDOS/BIOS-diverting code 
  44.       that does  not  alter  page 0,  such  as  Plu*Perfect  DateStamper  when 
  45.       relocated above the BIOS.  This makes  it possible, for example, to load
  46.       DateStamper into the IOP buffer at IOP plus  an offset for the dummy IOP 
  47.       code, detach it at will with CLRRSX,  and reload it afterwards (INIT.IOP 
  48.       would have to  be LDRed into  place  before reloading  DateStamper if an 
  49.       active IOP is in the buffer - or patch the DS loader to patch in a dummy
  50.       IOP segment before loading the actual DS code).
  51.    CD  may 
  52. require a password to move to the new directory.  
  53.  
  54.    In the ZCPR3 environment,