Simmule Turner
2 January 1989

This is version of clock with process alarms, and a simple application that
uses the F$TimAlrm call.  I'm still crunching the code(that's why no source).
I have been using this version since the 25th.

F$TimAlm ($26),  It send signal S$Alarm ($05)

X = pointer to a 6 byte time packet
B = Alarm Request
    0 = Clear any pending call
    1 = Set an alarm using Time Packet
    2 = Return Current Alarm Time

The time data is stored in the process descriptor.  Here is an exerpt
from my os9defs file, that shows the location(offsets) of the P$Alarm
packet.

P$NIO   rmb 6*2 additional DIO ptrs for net, compatible with 68K
P$SelP rmb 1 Selected Path for COCO Windows (Default 0)
*
P$UTicks rmb 4 User Tick counter
P$STicks rmb 4 System Tick counter
P$FCalls rmb 4 Number of F$ Calls
P$ICalls rmb 4 Number of I$ Calls
P$Time equ .
P$DatBeg rmb 3 Date of Creation
P$TimBeg rmb 3 Time of Creation
P$Alarm rmb 6 Process alarm time in yy/mm/dd hh:mm:ss

 rmb $200-. Local stack
P$Stack equ . Top of Stack
P$Size equ . Size of Process Descriptor

------

The following are typical calls in assembly, for C examples look
at the included source file alarm.c.

F$TimAlm equ $26

* Set an Alarm
 leax TimDat,u
 ldb #1 Set an alarm
 OS9 F$TimAlm

* Clear Alarm
 clrb
 OS9 F$TimAlm

* Return Alarm Settings
 leax TimDat,u
 ldb #2
 OS9 F$TimAlm

