home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / z3help43.lbr / DSLIB1.HZP / DSLIB1.HLP
Encoding:
Text File  |  1991-10-14  |  4.1 KB  |  87 lines
  1. ;
  2.                                   DSLIB.REL                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. DSLIB.REL      6k (44)   3905  4.3a       Harold Bower 7/91        Z3LIB4
  6. DSLIBS.REL     6k (41)   721C  4.3a       Harold Bower 7/91        Z3LIB4
  7.  
  8.   1- Introduction  2- Routines  3- Notes  4- Help File                        
  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 - 1/2 
  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.  Introduction to DSLIB - 2/2 
  41.  
  42.    In addition to the generalized interface routines,  entry points  exist for 
  43. DateStamper(tm) specific  routines.   Many  of  these  specific  routines  are 
  44. automatically  called  from  the  generalized  routines  when  DateStamper  is 
  45. detected.
  46.  
  47.    Conversion routines  also  exist  to  manage  interfaces  between Date/Time 
  48. fields of DateStamper(tm),  the MS-DOS  compatible DosDisk(tm),  and  the CP/M 
  49. Plus-compatible P2DOS format.
  50. :2
  51.  
  52. DSLIB Routines:
  53.  
  54.  System Identity      - TIMINI, GETDOS, FINDCK, CKTDF
  55.  Clock Reading        - RCLOCK, RDCLK
  56.  File Stamp Routines  - GSTAMP, PSTAMP, GETTD, SETTD
  57.  Directory Selection  - DDIRQS, DDIRQ, DDIRNPAK, DDIRPAK, DDIRSEL
  58.  Time Conversions     - U2PTIM, P2UTIM, U2MTIM, M2UTIM
  59.  Utility Routines     - FSTNXT, BCD2BIN, BIN2BCD, DVERS
  60.  DateStamper(tm) T&D  - OPENTD, CLOSTD, RWTD
  61. :3
  62.  DSLIB Notes 
  63.  
  64.    a. Vs 4.3a updates (7/14/91, Hal Bower):
  65.       - Now compatible with SYSLIB 4.3c  and  will be kept in step with future
  66.         releases.  The significant change is that the Directory routines DDIRQ
  67.         and DDIRQS now  use  the  general-purpose  sort  in  SYSLIB  which now
  68.         employs the speedy Wright Sort (courtesy of Joe Wright).  To take max-
  69.         imum advantage of this feature,  the  DE  register pair is now used to
  70.         return a pointer to the  Order (Pointer) Table.   With this value, and
  71.         the normal pointer to the  first  record  and number of records in the
  72.         table, further sorts using pointers may be employed to perform custom-
  73.         ized directory lists with date and time stamps.
  74.       - Bit 6 of the second  select  byte  now  controls  whether  or  not the
  75.         physical records  are  re-ordered  after  a sort of directory entries.  
  76.         Things can move quite a bit faster if only pointers are moved!
  77. :4
  78.  
  79.                                   DSLIB.HLP 
  80.  
  81.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  82.               26k (203)  9ACC  4.3a       Harold Bower 1/91        Z3HLP4
  83. ==============================================================================
  84.  
  85.    DSLIB.HLP is a Z-System help file on the use of DSLIB.REL.   You can access
  86. this file from Z3HELP-Y.LBR.
  87.