home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / zsys / znode-12 / s / z3help14.lbr / DSLIB1.HZP / DSLIB1.HLP
Encoding:
Text File  |  1993-06-12  |  3.1 KB  |  74 lines
  1. ;
  2.                                   DSLIB.REL                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. DSLIB.REL      6k (46)   119E  4.1        Harold Bower 5/89        Z3LIB4
  6. DSLIBS.REL     6k (43)   FA1B  4.1        Harold Bower 5/89        Z3LIB4
  7.  
  8.   1- Introduction  2- Routines  3- Help File  4- DSLIB.HLP                    
  9.  
  10.    DSLIB contains a collection of routines to facilitate addition of File Time
  11. and Date Stamping and Real Time Clock features.  A common Date and Time format
  12. is used to exchange date and time data with user programs.
  13.  
  14.    Generalized routines  are included  which uniformly  return Clock time,  as 
  15. well  as  File  Stamp  data  from  ZSDOS/ZDDOS,  CP/M 2.2  or  ZRDOS 1.x  with 
  16. Plu*Perfect Systems' DateStamper(tm),  and Digital Research's  CP/M Plus (also 
  17. known as CP/M 3).   The common data structures  are automatically converted to 
  18. the appropriate internal formats for the running system.
  19. :1
  20.  Introduction to DSLIB 
  21.  
  22.    DSLIB uses BCD       Byte Offset   00  01  02  03  04  05
  23.      digits as:                       --  --  --  --  --  --
  24.                               YY  MM  DD  hh  mm  ss
  25.  
  26. Where YY = Year (78-99 is 1978-1999, 00-77 is 2000-2077),  MM = Month (1..12),
  27. DD = Day (1..28,30,31), hh = Hour (0..23),  mm = Minute (00..59),  ss = Second 
  28. (00..59).
  29.  
  30.    As with the Clock structure,  File Stamp data is  handled  in  a consistent
  31. DateStamper(tm)/ZSDOS format of packed BCD digits in a 15-byte field as:
  32.  
  33.           |-- Create --|  |- L.Access -|  |-- Modify --|
  34.  Byte Offset  00 01 02 03 04  05 06 07 08 09  10 11 12 13 14
  35.           -- -- -- -- --  -- -- -- -- --  -- -- -- -- --
  36.           YY MM DD hh mm  YY MM DD hh mm  YY MM DD hh mm
  37.  
  38. Where YY = Year (78-99  is 1978-1999, 00-77 is 2000-2077), MM = Month (1..12),
  39. DD = Day (1..28,30,31), hh = Hour (0..23), mm = Minute (00..59).
  40.  
  41.  
  42.  
  43.    In addition to the generalized interface routines,  entry points  exist for 
  44. DateStamper(tm) specific  routines.   Many  of  these  specific  routines  are 
  45. automatically  called  from  the  generalized  routines  when  DateStamper  is 
  46. detected.
  47.  
  48.    Conversion routines  also  exist  to  manage  interfaces  between Date/Time 
  49. fields of DateStamper(tm),  the MS-DOS  compatible DosDisk(tm),  and  the CP/M 
  50. Plus-compatible P2DOS format.
  51. :2
  52.  
  53.  
  54. DSLIB Routines:
  55.  
  56.  System Identity      - TIMINI, GETDOS, FINDCK, CKTDF
  57.  Clock Reading        - RCLOCK, RDCLK
  58.  File Stamp Routines  - GSTAMP, PSTAMP, GETTD, SETTD
  59.  Directory Selection  - DDIRQS, DDIRQ, DDIRNPAK, DDIRPAK, DDIRSEL
  60.  Time Conversions     - U2PTIM, P2UTIM, U2MTIM, M2UTIM
  61.  Utility Routines     - FSTNXT, BCD2BIN, BIN2BCD, DVERS
  62.  DateStamper(tm) T&D  - OPENTD, CLOSTD, RWTD
  63. :3
  64.  
  65.  
  66.                                   DSLIB.HLP
  67.  
  68.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  69.               23k (179)  CC0C  4.1        Harold Bower 5/89        Z3HLP4
  70. ==============================================================================
  71.  
  72.    DSLIB.HLP is a Z-System help file on the use of DSLIB.REL.
  73. :4:DSLIB
  74.