home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / z.lbr / ZSDOS5.HZP / ZSDOS5.HLP
Encoding:
Text File  |  1991-11-18  |  8.6 KB  |  190 lines
  1.  Function   0: Boot         -- Miscellaneous Functions --
  2.  Function  12: Return CP/M Version Number
  3.  Function  48: Return Enhanced DOS Version
  4.  Function  98: Get System Time
  5.  Function  99: Set System Time
  6.  Function 100: Get ZSDOS Flags
  7.  Function 101: Set ZSDOS Flags
  8.  Function 102: Get File Stamp
  9.  Function 103: Set File Stamp
  10.  Time/Date Codes
  11. :
  12.  
  13.      +---------------------------------------------------------------+
  14.      |                      FUNCTION 0 -- BOOT                       |
  15.      +------------------------------+--------------------------------+
  16.      | Entry:  C = 0 (00h)          | Exit:  None                    |
  17.      |                              |                                |
  18.      |                              |                                |
  19.      +------------------------------+--------------------------------+
  20.  
  21. Rarely used, but provides a clean termination of program: removable disks 
  22. are reset, the DMA address is set to the default 80h, and the CCP is 
  23. reloaded.
  24.  
  25. The same results are obtained if the terminating program jumps to location 
  26. 00h.
  27.  
  28. It is usually more desirable to terminate an program by returning (RET) to 
  29. the CCP, if it has not been overwritten.
  30. :
  31.  
  32.      +---------------------------------------------------------------+
  33.      |           FUNCTION 12 -- RETURN CP/M VERSION NUMBER           |
  34.      +------------------------------+--------------------------------+
  35.      | Entry:  C = 12 (0Ch)         | Exit:  HL = 22h                |
  36.      |                              |                                |
  37.      |                              |                                |
  38.      +------------------------------+--------------------------------+
  39.  
  40. Returns 22h to indicate compatibility with CP/M 2.2.  To confirm the ZSDOS 
  41. version use Function 48.
  42.  
  43. For compatibility with older programs written for Plu*Perfect DateStamper, 
  44. if DateStamper file date stamping is running, the function also returns the 
  45. address of the DateStamper clock routine in DE, if "D" (44h) is passed in E 
  46. when the function is called.
  47. :
  48.  
  49.      +---------------------------------------------------------------+
  50.      |          FUNCTION 48 -- RETURN ENHANCED DOS VERSION           |
  51.      +-------------------------------+-------------------------------+
  52.      | Entry:  C = 48 (30h)          | Exit:  A = Version number     |
  53.      |                               |        H = DOS identifier     |
  54.      |                               |        L = Same as A          |
  55.      +-------------------------------+-------------------------------+
  56.  
  57. Returns the current ZSDOS version number in both A and L.  In addition, an 
  58. indentifier is returned in H to allow differentiation between the various 
  59. enhanced DOS's.
  60.  
  61. CP/M returns zero (not implemented) in A and L.  Only three DOS identifiers 
  62. are currently in use:
  63.                             0           ZRDOS
  64.                            'D' (44h)    ZDDOS
  65.                            'S' (53h)    ZSDOS
  66. :
  67.  
  68.      +---------------------------------------------------------------+
  69.      |                    FUNCTION 98 -- GET TIME                    |
  70.      +-------------------------------+-------------------------------+
  71.      | Entry:  C = 98 (62h)          | Exit:  A = Time/date code     |
  72.      |        DE = Address of buffer |                               |
  73.      |                               |                               |
  74.      +-------------------------------+-------------------------------+
  75.  
  76. Puts system time as a 6-byte BCD date specification into the buffer whose 
  77. address is passed in DE.
  78.  
  79. Returns an error if the clock cannot be read or if no clock driver is 
  80. installed.
  81. :
  82.  
  83.      +---------------------------------------------------------------+
  84.      |                    FUNCTION 99 -- SET TIME                    |
  85.      +-------------------------------+-------------------------------+
  86.      | Entry:  C = 99 (63h)          | Exit:  A = Time/date code     |
  87.      |        DE = Address of buffer |                               |
  88.      |                               |                               |
  89.      +-------------------------------+-------------------------------+
  90.  
  91. Sets the system time from a 6-byte BCD date specification in the buffer 
  92. whose address is passed in DE.
  93.  
  94. Returns an error if the clock cannot be set or if no clock drive is 
  95. installed.
  96. :
  97.  
  98.      +---------------------------------------------------------------+
  99.      |                   FUNCTION 100 -- GET FLAGS                   |
  100.      +-------------------------------+-------------------------------+
  101.      | Entry:  C = 100 (64h)         | Exit: HL = Flags              |
  102.      |                               |                               |
  103.      |                               |                               |
  104.      +-------------------------------+-------------------------------+
  105.  
  106. Returns current ZSDOS configuration flags in L.  For future compatibility H 
  107. is set to zero.
  108.  
  109. Bit flags in L (1=enable, 0=disable):
  110.      b0 = allow public files using public attribute
  111.      b1 = allow writing to public files or along path
  112.      b2 = preserve write-protect vector across warm boots
  113.      b3 = allow fast fixed disk relog
  114.      b4 = issue warning of disk change
  115.      b5 = use ZCPR path to open system files (not used by ZDDOS)
  116.      b6 = allow opening non-system files on path (if b5 is set)
  117.      b7 = reserved
  118. :
  119.  
  120.      +---------------------------------------------------------------+
  121.      |                   FUNCTION 101 -- SET FLAGS                   |
  122.      +-------------------------------+-------------------------------+
  123.      | Entry:  C = 101 (65h)         | Exit:  None                   |
  124.      |        DE = Flags             |                               |
  125.      |                               |                               |
  126.      +-------------------------------+-------------------------------+
  127.  
  128. Sets current ZSDOS configuration flags from the value passed in E.  For 
  129. future compatibility D should be set to zero, although it is currently 
  130. ignored by this function.
  131.  
  132. Bit flags in E (1=enable, 0=disable):
  133.      b0 = allow public files using public attribute
  134.      b1 = allow writing to public files or along path
  135.      b2 = preserve write-protect vector across warm boots
  136.      b3 = allow fast fixed disk relog
  137.      b4 = issue warning of disk change
  138.      b5 = use ZCPR path to open system files (not used by ZDDOS)
  139.      b6 = allow opening non-system files on path (if b5 is set)
  140.      b7 = reserved
  141. :
  142.  
  143.      +---------------------------------------------------------------+
  144.      |                   FUNCTION 102 -- GET STAMP                   |
  145.      +-------------------------------+-------------------------------+
  146.      | Entry:  C = 102 (66h)         | Exit:  A = Time/date code     |
  147.      |        DE = Address of FCB    |                               |
  148.      |                               |                               |
  149.      +-------------------------------+-------------------------------+
  150.  
  151. Puts the BCD file stamp for the file in the file control block (FCB) in the 
  152. first 15 bytes of the current DMA buffer.  The buffer length must be at 
  153. least 128 bytes.
  154.  
  155. Returns an error if the stamp could not be read or if no driver is 
  156. installed.
  157.  
  158. The extent (FCB+12) and data module (FCB+14) bytes in the FCB must be zero, 
  159. and the correct user number for the file must be set via Functions 32 or 
  160. 45.
  161. :
  162.  
  163.      +---------------------------------------------------------------+
  164.      |                   FUNCTION 103 -- SET STAMP                   |
  165.      +-------------------------------+-------------------------------+
  166.      | Entry:  C = 103 (67h)         | Exit:  A = Time/date code     |
  167.      |        DE = Address of FCB    |                               |
  168.      |                               |                               |
  169.      +-------------------------------+-------------------------------+
  170.  
  171. Gets the BCD file stamp for the file in the file control block (FCB) from 
  172. the first 15 bytes of the current DMA buffer and records it on disk.  The 
  173. buffer length must be at least 128 bytes.
  174.  
  175. Returns an error if the stamp could not be written or if no driver is 
  176. installed.  No stamp will be written if the disk is write protected.
  177.  
  178. The extent (FCB+12) and data module (FCB+14) bytes in the FCB must be zero, 
  179. and the correct user number for the file must be set via either Functions 
  180. 32 or 45.
  181. :
  182.  
  183.  
  184.                               TIME/DATE CODES
  185.  
  186.                (Returned by Functions 98, 99, 102, and 103)
  187.  
  188.                             A = 1     no error
  189.                             A = FFh   error
  190.