home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / y.lbr / ZRDOS.HZP / ZRDOS1.HLP
Encoding:
Text File  |  1991-10-14  |  7.1 KB  |  223 lines
  1. DIFFERENCES FROM CP/M 2.2 CCP
  2. DIFFERENCES FROM CP/M 2.2 BDOS
  3. ZRDOS EXTENDED FUNCTION CALLS
  4. ZRDOS UNIT RECORD FUNCTIONS
  5. ZRDOS DISK RELATED FUNCTIONS
  6. ZRDOS MISCELLANEOUS FUNCTIONS
  7. ZRDOS UTILITIES
  8. :DIFFERENCES FROM CP/M 2.2 CCP
  9.  
  10.      ZRDOS  is  a Z80 coded,  CP/M 2.2 compatible disk  operating 
  11. system designed to be used with the Echelon Z80 Command Processor  
  12. ZCPR3 by Richard Conn.
  13.  
  14.      ZRDOS  is compatible with all of the ZCPR3 utilities.  Named 
  15. Directories,  Redirectable I/O,  and all other ZCPR3 features can 
  16. used  with  ZRDOS.  For  the  installation  of  these  additional 
  17. features  please  refer  to  the  original  ZCPR3   documentation 
  18. package.
  19. :DIFFERENCES FROM CP/M 2.2 BDOS
  20.  
  21.  
  22.                           Disk Change
  23.  
  24.      ZRDOS  allows  the changing of disks without the need  of  a  
  25. warm boot.  CHANGED DISKS WILL BE AUTOMATICALLY LOGGED IN. 
  26.  
  27. NOTE:     The above mentioned auto login will not occur if a file 
  28.           was  open  when   the  disk was  changed  and  a  write 
  29.           operation is attempted to that file on the new diskette 
  30.           instead the following error message will be printed:
  31.  
  32.            Disk Changed Error On Drive B:
  33.  
  34.      It should also be noted that the automatic logon may or  may 
  35. not be able to handle changes in density or number of sides. This 
  36. depends  on  how  your bios handles deblocking and  double  sided 
  37. disks.  However if the disk is of the same density and number  of 
  38. sides  as  the  disk it is being swapped with there  will  be  no 
  39. problems.
  40.  
  41.  
  42.  
  43.                     Read Only Disk Status
  44.  
  45.      Under  ZRDOS  a  disk  can only be set  to  R/O  status  by 
  46. executing  function  call  28 (Protect Drive). 
  47.  
  48.  
  49.      ZRDOS function call 37 (Reset Drive) is different in that it 
  50. will  only reset the Read Only bits for the drive(s) specified in 
  51. the  user passed drive map in the register pair (DE).  With  CP/M 
  52. function 37 will also reset the bits for any drive not  currently 
  53. active.
  54.  
  55.      Function call 13 (Reset Disk System) is different in that it  
  56. will not reset drives that are set to  Read Only but will instead 
  57. reset the disk changed vector.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                     Read Console Buffer
  67.  
  68.      The  Read console buffer routine (Function 10) for ZRDOS  is 
  69. different in the following ways:
  70.  
  71.      . Rubout (DEL) is treated the same as a backspace.
  72.      . The Control-R edit function is not implemented.
  73.  
  74. NOTE:     In  CP/M these are teletype oriented edit commands  and 
  75.           were felt not to be required in ZRDOS.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.                       File Archiving
  90.  
  91.      ZRDOS  supports the use of the file archive  attribute.  The 
  92. support  of  this  feature is compatible with both CP/M  3.0  and 
  93. MP/M.  This bit when set indicates an archived file.   That is  a 
  94. file  which has not been altered.   The bit can be set by using a 
  95. Function 30  (Set File Attributes) function call.  Any update  to 
  96. this  file  once  the bit has been set will cause the bit  to  be 
  97. reset.  This  can then be used by a copy utility to indicate  the 
  98. need  to  backup the file.  The utility that backs  up  the  file 
  99. should  then  set the archive bit to indicate the file  has  been 
  100. backed up.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                       Wheel Protection
  113.  
  114.      ZRDOS uses the ZCPR3 wheel byte and a new file attribute bit 
  115. to  protect  files from non-wheel users.  This bit when set  will 
  116. write protect the file as long as the wheel byte is off.  If  the 
  117. wheel byte is set the file is treated as a normal file.  
  118.  
  119.      If  a  non-wheel user attempts to change a  wheel  protected 
  120. file the following error message will be displayed:
  121.  
  122.                      A0>File W/P Error on A:
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                        Error Messages
  136.  
  137.                ZRDOS                 CP/M
  138.  
  139.   Error
  140.   Number
  141.  
  142.     1    Read Error On A:              Bdos Err On A:Bad Sector
  143.     2    Drive Select Error On A:      Bdos Err On A:Select
  144.     3    Disk R/O Error On A:          Bdos Err On A:R/O
  145.     4    File R/O Error On A:          Bdos Err On A:File R/O
  146.     5    Disk Changed Error On A:      n/a
  147.     6    File W/P Error On A:          n/a
  148.  
  149.      With  ZRDOS  all non-retryable errors jump directly to  warm 
  150. boot after the error message has been printed.  Read Errors allow 
  151. the user the option of retrying the operation by pressing any key 
  152. but  control-c or aborting by pressing control-c.  Error  numbers 
  153. shown above are returned in the (A) register.  The selected drive 
  154. number is returned in register (E).
  155.  
  156.  
  157.  
  158. NOTE:     If  the warm boot trap (see FUNCTION 38) is  set  ZRDOS 
  159.           jumps  directly  to the  warm boot vector and no  error 
  160.           messages are displayed.
  161.  
  162.      CP/M handles the errors in the same  manor except a key must 
  163. be  pressed  before CP/M will return from any type of  error  and 
  164. CP/M doesn't return an error or drive number.  Nor does CP/M have 
  165. a warm boot trap function.
  166. :ZRDOS EXTENDED FUNCTION CALLS
  167.  
  168.              Function 47: Get Current DMA Address
  169.  
  170.      This function will return the currently assigned DMA address 
  171. in the register pair (HL).
  172.  
  173.  
  174.            Function 48: Return ZRDOS Version Number
  175.  
  176.      This function works the same as CP/M function call 12 except 
  177. the  ZRDOS Version number is returned instead of the CP/M version 
  178. number.  To maintain CP/M compatibility ZRDOS will return version 
  179. number 2.2 on a function 12 call. As with function 12 function 48 
  180. uses the register pair (HL) to return the version number. If user 
  181. programs  that use the extended ZRDOS functions are written  this 
  182. function  should  first be used to determine if  the  program  is 
  183. being run under ZRDOS.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                Function 50: Set Warm Boot Trap
  190.  
  191.      A new function call is provided that allows the user to  set 
  192. a trap on warm boot to a user specified address.  The trap is set 
  193. by  executing  a function 50 call with the trap  address  in  the 
  194. register  pair (DE).  The Warm boot jump address at location 001H 
  195. is  replaced  with the user supplied  trap  address.  Warm  boots 
  196. executed  after  the  trap is set will cause a jump to  the  trap 
  197. address. ZRDOS error messages are suppressed allowing the user to 
  198. print his own error messages. As noted in the ZRDOS error section 
  199. above  errors  detected by ZRDOS return an error number  and  the 
  200. active drive number which the user can then use to determine  how 
  201. best to handle the error.
  202.  
  203. WARNING:  Caution should be exercised when using this function as 
  204.           the  results  will be unpredictable  if a program  that 
  205.           has set the trap terminates without first resetting the 
  206.           trap. See FUNCTION 52 below.
  207.  
  208.  
  209.  
  210.  
  211.  
  212.               Function 52: Reset Warm Boot Trap
  213.  
  214.      This  new function call will reset the warm boot trap set by 
  215. function call 50.  The trap is reset by executing a function call 
  216. 52.  The  Real  bios warm boot address is  restored  to  location 
  217. 0001H.  If  function call 50 is used in a user program a function 
  218. call  52  should be executed before control is  returned  to  the 
  219. operating system.
  220. ::ZRDOS1A
  221. ::ZRDOS1B
  222. ::ZRDOS1D
  223. ::ZDU