home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Datafile PD-CD 3
/
PDCD_3.iso
/
pocketbk
/
utilsm
/
psionics
/
agenda.fmt
next >
Wrap
Text File
|
1995-01-17
|
4KB
|
98 lines
PSIONICS FILE - AGENDA.FMT
==========================
Format of Agenda files
Last modified 1994-01-15
========================
Agenda files are normal database files containing five primary and no secondary
fields; the primary fields are four word fields followed by one qstr field.
The file also contains one segmented record.
The segmented record contains one sub-record of type 15. This sub-record
always contains exactly 12 bytes. These are not always the same; the following
examples have been seen:
$E0,$01,$3C,$00,$01,$00,$0F,$00,$1C,$02,$3A,$00 (my main agenda)
$A4,$01,$3C,$00,$01,$00,$0F,$00,$1C,$02,$2E,$00 (a new database)
Each data record holds one calendar even (possibly repeating), one day-note
event (possibly repeating), or one to-do item. The record contents for each
of these are described here.
Calendar events have the format:
Field 1 (word): day number of the event
Field 2 (word): duration of the event in minutes, times 2, plus 1 if there
is not an alarm attached
Field 3 (word): time of the event, in minutes past midnight
Field 4 (word): time of the alarm in minutes before 23:59 of the day the
event occurs on, or $FFFF if there is no alarm
Field 5 (qstr): item text
Repeating calendar events have the format:
Field 1 (word): $FFFE
Field 2 (word): duration of the event in minutes, times 2, plus 1 if there
is not an alarm attached
Field 3 (word): time of the event, in minutes past midnight
Field 4 (word): time of the alarm in minutes before 23:59 of the day the
event occurs on, or $FFFF if there is no alarm
Field 5 (qstr): item text followed by repeat information
Day note events have the format:
Field 1 (word): day number of the event
Field 2 (word): 0 if an alarm is attached, or 1 if not
Field 3 (word): position of item in list:
$8000 = first day item on that date
$8001 = second day item on that date
etc.
Field 4 (word): time of the alarm in minutes before 23:59 of the day the
event occurs on, or $FFFF if there is no alarm
Field 5 (qstr): item text
Repeating day note events have the format:
Field 1 (word): $FFFE
Field 2 (word): 0 if an alarm is attached, or 1 if not
Field 3 (word): position of item in list:
$8000 = first day item on that date
$8001 = second day item on that date
etc.
Field 4 (word): time of the alarm in minutes before 23:59 of the day
Field 5 (qstr): item text followed by repeat information
To-do items have the format:
Field 1 (word): $FFFF
Field 2 (word): position of item among those with this priority:
0 = first item
2 = second item
4 = third item
6 = fourth item
etc.
Field 3 (word): item priority (1 to 9 inclusive)
Field 4 (word): unused
Field 5 (qstr): item text
For repeating items, the item text is always followed by a 6 byte block giving
the repeat information (this block is included in the qstr as far as the
database format is concerned). This block has the form:
Offset 0 (byte): repeat type:
0 = yearly
1 = monthly by date
2 = monthly by day
3 = weekly
4 = daily
5 = workdays
Offset 1 (byte): repeat interval
Offset 2 (word): day number of the first occurence
Offset 4 (word): day number of the last occurence, or 0 if repeats forever
Day numbers must lie between 29219 and 54786 (years 1980 and 2049) inclusive.
The end of a calendar event must lie in the same day as its start.
--
Clive D.W. Feather | Santa Cruz Operation | If you lie to the compiler,
clive@sco.com | Croxley Centre | it will get its revenge.
Phone: +44 923 816 344 | Hatters Lane, Watford | - Henry Spencer
Fax: +44 923 817 688 | WD1 8YN, United Kingdom |