;
                                  DSLIB.REL                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
DSLIB.REL      6k (46)   119E  4.1        Harold Bower 5/89        Z3LIB4
DSLIBS.REL     6k (43)   FA1B  4.1        Harold Bower 5/89        Z3LIB4

  1- Introduction  2- Routines  3- Help File  4- DSLIB.HLP                    

   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 

   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).



   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.HLP

             Size (recs) CRC   Version    Author/Latest Issue      Disk
              23k (179)  CC0C  4.1        Harold Bower 5/89        Z3HLP4
==============================================================================

   DSLIB.HLP is a Z-System help file on the use of DSLIB.REL.
:4:DSLIB
