home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / z.lbr / ZSDOS4.HZP / ZSDOS4.HLP
Encoding:
Text File  |  1991-11-18  |  11.1 KB  |  223 lines
  1.  Function 13: Reset Disk System  -- Miscellaneous Disk Functions --
  2.  Function 14: Select Disk
  3.  Function 24: Return Login Vector
  4.  Function 25: Return Current Disk
  5.  Function 27: Get Allocation Vector Address
  6.  Function 28: Write Protect Disk
  7.  Function 29: Get Write Protect (Read Only) Vector
  8.  Function 31: Get DPB Address
  9.  Function 32: Set/Get User Number
  10.  Function 37: Reset Multiple Drives
  11.  Function 39: Get Fixed Disk Login Vector
  12.  Function 45: Set BDOS Error Mode
  13. :
  14.  
  15.      +---------------------------------------------------------------+
  16.      |               FUNCTION 13 -- RESET DISK SYSTEM                |
  17.      +--------------------------------+------------------------------+
  18.      | Entry:  C = 13 (0Dh)           | Exit:  A = 0 if no $*.* file |
  19.      |                                |        A = FFh if $*.* file  |
  20.      |                                |                              |
  21.      +--------------------------------+------------------------------+
  22.  
  23. Logs out all current drives and resets the DMA buffer to 80h.  Drive A 
  24. becomes the default; the user area is not changed.  All files open for 
  25. writing should be closed before calling this function.
  26.  
  27. On return A acts as a submit file flag for the command processor.
  28.  
  29. This function is less efficient than function 37, which resets only 
  30. specified drives.  Since changed disks are automatically logged, functions 
  31. 13 and 37 are rarely needed.
  32.  
  33. The value returned in A is a clue to the CCP that a SUB does or does not 
  34. exist on the current drive.
  35. :
  36.  
  37.      +---------------------------------------------------------------+
  38.      |                  FUNCTION 14 -- SELECT DISK                   |
  39.      +--------------------------------+------------------------------+
  40.      | Entry:  C = 14 (0Eh)           | Exit:  A = 0 if no $*.* file |
  41.      |         E = drive (0=A, etc.)  |        A = FFh if $*.* file  |
  42.      |                                |        H <> 0 if error       |
  43.      +--------------------------------+------------------------------+
  44.  
  45. Selects the default disk drive, which is used for all file operation unless 
  46. it is overridden by drive specification in the file control block.  The 
  47. drive will also be logged in, if it has not been already.
  48.  
  49. If 0FFh is returned in the A register, check the H register for an error.  
  50. If the H register is zero, no error exists; if it is non-zero, then the 
  51. requested drive is invalid.
  52. :
  53.  
  54.      +---------------------------------------------------------------+
  55.      |              FUNCTION 24 -- RETURN LOGIN VECTOR               |
  56.      +--------------------------------+------------------------------+
  57.      | Entry:  C = 24 (18h)           | Exit: HL = Login vector      |
  58.      |                                |                              |
  59.      |                                |                              |
  60.      +--------------------------------+------------------------------+
  61.  
  62. Returns a bit map of the drives that are currently logged in:
  63.  
  64.                            Register H        Register L
  65.                          ---------------   --------------- 
  66.                 Bits:    7 6 5 4 3 2 1 0   7 6 5 4 3 2 1 0  
  67.                 Drives:  P O N M L K J I   H G F E D C B A
  68. :
  69.  
  70.      +---------------------------------------------------------------+
  71.      |              FUNCTION 25 -- RETURN CURRENT DISK               |
  72.      +--------------------------------+------------------------------+
  73.      | Entry:  C = 25 (19h)           | Exit:  A = Current disk      |
  74.      |                                |        (0=A, 1=B, etc.)      |
  75.      |                                |                              |
  76.      +--------------------------------+------------------------------+
  77.  
  78. Returns current default disk drive, from 0 (A) to 15 (P).
  79. :
  80.  
  81.      +---------------------------------------------------------------+
  82.      |         FUNCTION 27 -- GET ALLOCATION VECTOR ADDRESS          |
  83.      +--------------------------------+------------------------------+
  84.      | Entry:  C = 27 (1Bh)           | Exit: HL = Allocation vector |
  85.      |                                |            address           |
  86.      |                                |                              |
  87.      +--------------------------------+------------------------------+
  88.  
  89. Returns the address of the allocation vector for the current default drive.
  90. :
  91.  
  92.      +---------------------------------------------------------------+
  93.      |               FUNCTION 28 -- WRITE PROTECT DISK               |
  94.      +--------------------------------+------------------------------+
  95.      | Entry:  C = 28 (1Ch)           | Exit:  None                  |
  96.      |        DE = Read-only vector   |                              |
  97.      |                                |                              |
  98.      +--------------------------------+------------------------------+
  99.  
  100. Prevents writes, renames, deletions, etc., to drives specified in the bit 
  101. map passed in DE.  The ability to return a write-protected drive to 
  102. read/write status depends on the ZSDOS configuration flags.
  103.  
  104. Before calling this function, registers DE should be set to a bit map of 
  105. the drives to be made read-only:
  106.  
  107.                            Register D        Register E
  108.                          ---------------   --------------- 
  109.                 Bits:    7 6 5 4 3 2 1 0   7 6 5 4 3 2 1 0  
  110.                 Drives:  P O N M L K J I   H G F E D C B A
  111. :
  112.  
  113.      +---------------------------------------------------------------+
  114.      |            FUNCTION 29 -- GET WRITE PROTECT VECTOR            |
  115.      +--------------------------------+------------------------------+
  116.      | Entry:  C = 29 (1Dh)           | Exit: HL = Read-only vector  |
  117.      |                                |                              |
  118.      |                                |                              |
  119.      +--------------------------------+------------------------------+
  120.  
  121. Returns a map of drives made read-only (write protected) by Function 28.
  122.  
  123. Drives are not automatically set read-only when a disk is changed.  The 
  124. ability to reset drives to read/write status is dependant on the ZSDOS 
  125. configuration flags.
  126.  
  127. The bits of the returned map stand for drives as follows:
  128.                  
  129.                            Register H        Register L
  130.                          ---------------   --------------- 
  131.                 Bits:    7 6 5 4 3 2 1 0   7 6 5 4 3 2 1 0  
  132.                 Drives:  P O N M L K J I   H G F E D C B A
  133. :
  134.  
  135.      +---------------------------------------------------------------+
  136.      |                FUNCTION 31 -- GET DPB ADDRESS                 |
  137.      +--------------------------------+------------------------------+
  138.      | Entry:  C = 31 (1Fh)           | Exit: HL = Address of DPB    |
  139.      |                                |                              |
  140.      |                                |                              |
  141.      +--------------------------------+------------------------------+
  142.  
  143. Returns the address of the disk parameter block (DPB) for the current 
  144. default drive.  The DPB contains such information as the capacity of the 
  145. drive, the number of directory entries, to number of logical tracks, etc.
  146. :
  147.  
  148.      +---------------------------------------------------------------+
  149.      |              FUNCTION 32 -- SET/GET USER NUMBER               |
  150.      +--------------------------------+------------------------------+
  151.      | Entry:  C = 32 (20h)           | Exit:  A = User number (get) |
  152.      |         E = FFh (get)          |        A = 0 (set)           |
  153.      |         E = 0-31 (set)         |                              |
  154.      +--------------------------------+------------------------------+
  155.  
  156. Gets or sets the default user number.  If E is set to FFh, the current user 
  157. number is returned (0-31).  Otherwise, the user number is set for the 
  158. number passed in E.
  159.  
  160. This default is used for all file operations unless it is overridden by a 
  161. user specification in the file control block.
  162. :
  163.  
  164.      +---------------------------------------------------------------+
  165.      |             FUNCTION 37 -- RESET MULTIPLE DRIVES              |
  166.      +--------------------------------+------------------------------+
  167.      | Entry:  C = 37 (25h)           | Exit:  A = 0                 |
  168.      |        DE = Reset vector       |        A = FFh if default    |
  169.      |                                |            and $*.* exists   |
  170.      +--------------------------------+------------------------------+
  171.  
  172. Logs out drives specified in a bit map passed in DE:
  173.  
  174.                            Register D        Register E
  175.                          ---------------   --------------- 
  176.                 Bits:    7 6 5 4 3 2 1 0   7 6 5 4 3 2 1 0  
  177.                 Drives:  P O N M L K J I   H G F E D C B A
  178.  
  179. Files open for writing on a disk to be reset must first be closed.  A 
  180. program requesting a media change should call Function 37 only after the 
  181. change is completed.  Under fast fixed disk relogging, only Function 37 
  182. will relog fixed media.  It must be used after any BIOS calls that affect 
  183. the directory of a hard or RAM disk.
  184. :
  185.  
  186.      +---------------------------------------------------------------+
  187.      |         FUNCTION 39 -- RETURN FIXED DISK LOGIN VECTOR         |
  188.      +--------------------------------+------------------------------+
  189.      | Entry:  C = 39 (27h)           | Exit: HL = Fixed disk login  |
  190.      |                                |            vector            |
  191.      |                                |                              |
  192.      +--------------------------------+------------------------------+
  193.  
  194. Returns a bit map of the drives logged as fixed disks if the fast fixed 
  195. disk relog feature is enabled:
  196.  
  197.                            Register H        Register L
  198.                          ---------------   --------------- 
  199.                 Bits:    7 6 5 4 3 2 1 0   7 6 5 4 3 2 1 0  
  200.                 Drives:  P O N M L K J I   H G F E D C B A
  201. :
  202.  
  203.      +---------------------------------------------------------------+
  204.      |              FUNCTION 45 -- SET BDOS ERROR MODE               |
  205.      +-------------------------------+-------------------------------+
  206.      | Entry:  C = 45 (2Dh)          | Exit:  A = 00h                |
  207.      |         E = Mode flag         |                               |
  208.      |                               |                               |
  209.      +-------------------------------+-------------------------------+
  210.  
  211. Allows application programs to take over error handling, returning all disk 
  212. errors, including physical, select, and write protect errors, by passing a 
  213. mode flag in E:
  214.  
  215.      00h = default CP/M error mode.
  216.      80h = default ZSDOS error mode, allows use of user area in FCB.
  217.      FEh = display error message and return extended error code to program.
  218.      FFh = return extended error code to program.
  219.  
  220. Programs using extended error modes should reset the error mode to 00h 
  221. before exiting.  Although this function may seem similar to the same 
  222. function in CP/M Plus, the extended error codes returned are not the same.
  223.