home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / tclock.lbr / GTOSD.HZP / GTOSD.HLP
Encoding:
Text File  |  1993-06-07  |  3.0 KB  |  98 lines

  1. GT_OSD  - Identifies Operating system and Date/time protocol
  2. RDCLK   - Read the system clock, return packed BCD YYMMDDhhmmss
  3. TIME    - Read the system clock, return ASCII date/time string
  4. ASCIDT  - Convert BCD standard date/time to formatted ASCII
  5. :
  6. GT_OSD Identifies Operating system and Date/time protocol
  7.  
  8. Returns a pointer to a data structure which contains
  9. DOS identity, CPM compatibility, DOS version, and
  10. data for system clock access. A separate entry (RDCLK)
  11. provides for reading the clock.
  12.  
  13. CALL WITH:    (no calling parameters)
  14.  
  15. RETURN WITH:
  16.     CY set = unknown operating system
  17.     Cy clear = CP/M, CPM+, ZRDOS, ZSDOS, or ZDDOS
  18.         and System Clock set up for date/time access.
  19.     HL -> OS data structure
  20.  
  21.     public    gt_osd
  22.  
  23. SEE NEXT SCREEN for data structure
  24.  
  25. The data structure to which HL points is:
  26.  
  27. offset    size    description
  28.    0      1       CP/M version with which the DOS is compatible
  29.    1      1       DateStamper Flag, 'D' for DS, else 0
  30.    2      1       Version number of the current DOS
  31.    3      1       Byte value identifying current DOS
  32.  
  33.    4      1       Value passed in C for DOS clock calls
  34.    5      2       Address of the Clock read routine (may be BDOS)
  35.    7      2       Address of the local Date/Time buffer.
  36.  
  37. DOS identifying values (offset 3, above), all are ASCII
  38.     0 (binary null) = Unidentified DOS
  39.     C = CP/M    M = MP/M    O = ZOS
  40.     R = ZRDOS    S = ZSDOS    D = ZDDOS
  41.     3 = CP/M+ (=CP/M 3.0)
  42.  
  43.  
  44. :
  45. RDCLK  - routine to read the system clock
  46.  
  47. Reads system clock if present. Calls GT_OSD if necessary
  48. to identify the Clock calling parameters. Compatible with
  49. ZS/ZDDOS, DATESTAMPER, and CP/M+. Implementer can install
  50. other clock access routines after a call to GT_OSD.
  51.  
  52. CALL WITH:    (no parameters)
  53. RETURN WITH:
  54.     NC = NO CLOCK
  55.     CY set = clock has been read
  56.     HL -> date/time buffer, 6 bytes
  57. For CPM+, the first byte is undefined. Bytes 1,2 contain
  58. the number of days since 1 Jan 1978. Bytes 3 - 5 contain
  59. bcd hours, min, sec. (same as ZSDOS). For ZSDOS, ZDDOS,
  60. and DATESTAMPER, the first three bytes are Year, Month,
  61. and Day. All are in BCD. Year is last two digits.
  62.  
  63.     public    rdclk
  64.  
  65. :
  66. TIME - Read the system clock, return ASCII date/time
  67.  
  68. Uses the general purpose RDCLK routine to get the clock data,
  69. then converts it to an ASCII string in y/m/d h:m:s format.
  70.  
  71. CALL WITH:  (no calling parameters)
  72.  
  73. RETURN WITH:
  74.     HL -> the ASCII date/time string
  75.     FLAGS: C = valid null terminated D/T string
  76.           NC = no clock, string starts with null
  77.  
  78.     entry    time
  79.  
  80. :
  81. ASCIDT - Convert BCD standard date/time to formatted ASCII
  82.  
  83. Standard packed BCD input string is yy mm dd hh mm ss format.
  84.  
  85. Produces an ASCII string like yy/mm/dd hh:mm:ss which is null
  86. terminated. The formatted string is in the more familar form:
  87.         mm/dd/yy hh:mm:ss
  88.  
  89. CALL WITH:
  90.     HL -> BCD date/time in standard form
  91. RETURN WITH:
  92.     HL -> Formatted ASCII Date/Time string
  93. the string is null terminated
  94.  
  95.     entry    ascidt
  96.     ext    ma2hc
  97.  
  98.