;
                                  DSLIB.REL                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
DSLIB.REL      6k (44)   3905  4.3a       Harold Bower 7/91        Z3LIB4
DSLIBS.REL     6k (41)   721C  4.3a       Harold Bower 7/91        Z3LIB4

  1- Introduction  2- Routines  3- Notes  4- Help File                        

   DSLIB contains a collection of routines to facilitate addition of File Time
and Date Stamping and Real Time Clock features.  A common Date and Time format
is used to exchange date and time data with user programs.

   Generalized routines  are included  which uniformly  return Clock time,  as 
well  as  File  Stamp  data  from  ZSDOS/ZDDOS,  CP/M 2.2  or  ZRDOS 1.x  with 
Plu*Perfect Systems' DateStamper(tm),  and Digital Research's  CP/M Plus (also 
known as CP/M 3).   The common data structures  are automatically converted to 
the appropriate internal formats for the running system.
:1
 Introduction to DSLIB - 1/2 

   DSLIB uses BCD       Byte Offset   00  01  02  03  04  05
     digits as:                       --  --  --  --  --  --
		                      YY  MM  DD  hh  mm  ss

Where YY = Year (78-99 is 1978-1999, 00-77 is 2000-2077),  MM = Month (1..12),
DD = Day (1..28,30,31), hh = Hour (0..23),  mm = Minute (00..59),  ss = Second 
(00..59).

   As with the Clock structure,  File Stamp data is  handled  in  a consistent
DateStamper(tm)/ZSDOS format of packed BCD digits in a 15-byte field as:

	      |-- Create --|  |- L.Access -|  |-- Modify --|
 Byte Offset  00 01 02 03 04  05 06 07 08 09  10 11 12 13 14
	      -- -- -- -- --  -- -- -- -- --  -- -- -- -- --
	      YY MM DD hh mm  YY MM DD hh mm  YY MM DD hh mm

Where YY = Year (78-99  is 1978-1999, 00-77 is 2000-2077), MM = Month (1..12),
DD = Day (1..28,30,31), hh = Hour (0..23), mm = Minute (00..59).
 Introduction to DSLIB - 2/2 

   In addition to the generalized interface routines,  entry points  exist for 
DateStamper(tm) specific  routines.   Many  of  these  specific  routines  are 
automatically  called  from  the  generalized  routines  when  DateStamper  is 
detected.

   Conversion routines  also  exist  to  manage  interfaces  between Date/Time 
fields of DateStamper(tm),  the MS-DOS  compatible DosDisk(tm),  and  the CP/M 
Plus-compatible P2DOS format.
:2

DSLIB Routines:

 System Identity      - TIMINI, GETDOS, FINDCK, CKTDF
 Clock Reading        - RCLOCK, RDCLK
 File Stamp Routines  - GSTAMP, PSTAMP, GETTD, SETTD
 Directory Selection  - DDIRQS, DDIRQ, DDIRNPAK, DDIRPAK, DDIRSEL
 Time Conversions     - U2PTIM, P2UTIM, U2MTIM, M2UTIM
 Utility Routines     - FSTNXT, BCD2BIN, BIN2BCD, DVERS
 DateStamper(tm) T&D  - OPENTD, CLOSTD, RWTD
:3
 DSLIB Notes 

   a. Vs 4.3a updates (7/14/91, Hal Bower):
      - Now compatible with SYSLIB 4.3c  and  will be kept in step with future
        releases.  The significant change is that the Directory routines DDIRQ
        and DDIRQS now  use  the  general-purpose  sort  in  SYSLIB  which now
        employs the speedy Wright Sort (courtesy of Joe Wright).  To take max-
        imum advantage of this feature,  the  DE  register pair is now used to
        return a pointer to the  Order (Pointer) Table.   With this value, and
        the normal pointer to the  first  record  and number of records in the
        table, further sorts using pointers may be employed to perform custom-
        ized directory lists with date and time stamps.
      - Bit 6 of the second  select  byte  now  controls  whether  or  not the
        physical records  are  re-ordered  after  a sort of directory entries.  
        Things can move quite a bit faster if only pointers are moved!
:4

                                  DSLIB.HLP 

             Size (recs) CRC   Version    Author/Latest Issue      Disk
              26k (203)  9ACC  4.3a       Harold Bower 1/91        Z3HLP4
==============================================================================

   DSLIB.HLP is a Z-System help file on the use of DSLIB.REL.   You can access
this file from Z3HELP-Y.LBR.
