home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / y.lbr / ZSLIB0.HZP / ZSLIB0.HLP
Encoding:
Text File  |  1991-07-20  |  3.9 KB  |  86 lines
  1.  Get ZSDOS File Datestamp     - GETSTP
  2.  Set ZSDOS File Datestamp     - SETSTP
  3.  Get CP/M-Plus File Datestamp - GSTPCP
  4.  Set CP/M-Plus File Datestamp - SSTPCP
  5. :
  6. GETSTP - Get ZSDOS file datestamp to 128-byte buffer.
  7.  
  8.   ENTER: DE = address of file's FCB,
  9.          HL = address of 128-byte datestamp buffer.
  10.   EXIT:  Zero flag set (Z) and A=0 if buffer filled,
  11.          Zero flag reset (NZ) if error or not ZSDOS.
  12.   USES:  AF
  13.  
  14. Usage: Buffer is filled with 15-byte datestamp  as  yy mm dd hh min of file
  15. creation, last access, and last modification, respectively.  If file is not
  16. at default drive, FCB must be initialized with drive.  If  file  is  not at
  17. default user, FCB must be initialized with user number and ZSDOS error mode
  18. set to non-zero.
  19. :
  20. SETSTP - Set file datestamp from 128-byte buffer.
  21.  
  22.   ENTER: DE = address of file's FCB,
  23.          HL = address of 128-byte datestamp buffer.
  24.   EXIT:  Zero flag set (Z) and A=0 if file stamped,
  25.          Zero flag reset (NZ) if error or not ZSDOS.
  26.   USES:  AF
  27.  
  28. Usage: Buffer is filled with 15-byte datestamp  as  yy mm dd hh min of file
  29. creation, last access, and last modification, respectively.  If file is not
  30. at default drive, FCB must be initialized with drive.  If  file  is  not at
  31. default user, FCB must be initialized with user number and ZSDOS error mode
  32. set to non-zero.
  33. :
  34. GSTPCP - Get file datestamp from CP/M Plus to 128-byte buffer.
  35.  
  36.   ENTER: DE = address of file's FCB,
  37.          HL = address of 128-byte datestamp buffer.
  38.   EXIT:  Zero flag set (Z) and A=0 if buffer filled,
  39.          Zero flag reset (NZ) if error or not CP/M Plus.
  40.   USES:  AF
  41.  
  42. Usage: If file is not at default drive, FCB must be initialized with drive.
  43. File must be  at  default  user.  File  stamp  is  converted to DateStamper
  44. format  (yy  mm  dd  hh  min  of  file  creation,  last  access,  and  last
  45. modification, respectively, in BCD).  The CP/M Plus create/access  stamp is
  46. copied to  both  the  create and access fields of the caller's buffer.  The
  47. calling program must examine the disk label to determine which field(s) are
  48. valid.  On exit, only the first 15 bytes of data in the caller's buffer are
  49. valid.
  50. :
  51. SSTPCP - Set file datestamp to CP/M Plus from 128-byte buffer.
  52.  
  53.   ENTER: DE = address of file's FCB,
  54.          HL = address of 128-byte datestamp buffer,
  55.          BC = address of 1024-byte DMA buffer.
  56.   EXIT:  Zero flag set and A=0 if stamp set,
  57.          Zero flag reset (NZ) if error, error in <A>:
  58.            FF = file not found,
  59.            06 = not CP/M Plus,
  60.            05 = no stamps on disk,
  61.            04 = BIOS sector size > 1024 bytes,
  62.            03 = drive invalid,
  63.            02 = BIOS read error,
  64.            01 = BIOS write error.
  65.   USES:  AF
  66.  
  67.  
  68. (continued next screen)
  69.  
  70. SSTPCP (continued)
  71.  
  72. Usage: The datestamp buffer should be  filled  on  entry to BCD yy mm dd hh
  73. min of file creation, last access, and last modification, respectively.  If
  74. valid, (month <> 0) the BCD creation  field  is  copied  to  the  CP/M Plus
  75. Create/Access field.  Otherwise,  the BCD last access field is used, or the
  76. CP/M Plus Create/Access field  is  zeroed if neither are valid.  Similarly,
  77. the BCD last modification field is copied to the CP/M Plus Update field, or
  78. the Update field is zeroed if the BCD  stamp  is  invalid.  The  file whose
  79. stamp is  to  be  set  must  either be on the current drive or at the drive
  80. specified by FCB byte 0.  Only  files  at  the  current user number will be
  81. matched.  To allow a reasonable interface standard, this  routine  will NOT
  82. work under systems configured with BIOS sectors larger than 1k.  No systems
  83. exceeding this  size  have yet been encountered, but BIOS sectors of 2k and
  84. 4k are technically legal under CP/M  Plus.  No wildcards are allowed in the
  85. file's FCB.
  86.