dtcm_entry(4) — File Formats
CDE
NAME
dtcm_entry − format of calendar/appointment entry
DESCRIPTION
The calendar entry file format defines how one entry is saved to a file or used in a drag-and-drop transaction with another client. A grammar for the entry format is:
| appt_file | ::= | header_string entry_definition |
| ::= | ‘\n\n\t∗∗Calendar Appointment ∗∗\n’ | |
| entry_definition | ::= | appt_def ‘\n’ old_appt |
| | | old_appt; | |
| old_appt | ::= | date_mark start_mark end_mark repeat_mark |
| | | duration_mark text_mark | |
| date_mark | ::= | ‘\tDate: ’ date_value ‘\n’ |
| date_value | ::= | Date as mm/ dd/ yyyy |
| start_mark | ::= | ‘\tStart: ’ start_value ‘\n’ |
| start_value | ::= | Entry begin time as hh:mm[ampm], |
| where hh and mm | ||
| represent two-digit hours and minutes | ||
| and the optional ampm suffix is the string | ||
| am or pm | ||
| end_mark | ::= | ‘\tEnd: ’ end_value ‘\n’ |
| end_value | ::= | Entry begin time as hh:mm[ampm] |
| repeat_mark | ::= | ‘\tRepeat: ’ repeat_value ‘\n’ |
| repeat_value | ::= | ‘One Time’ | ‘Daily’ | ‘Weekly’ | ‘Every Two Weeks’ |
| | | ‘Monthly By Date’ | ‘Yearly’ | ‘Monthly By Weekday’ | |
| | | ‘Monday Thru Friday’ | ‘Mon, Wed, Fri’ | |
| | | ‘Tuesday, Thursday’ | |
| duration_mark | ::= | ‘\tFor: ’ duration_value ‘\n’ |
| duration_value | ::= | Integer that describes the number of repetitions. |
| text_mark | ::= | ‘\tWhat: ’ text_value |
| text_value | ::= | Up to 5 lines of text. |
| Each line after the first must have a leading | ||
| tab character. | ||
| appt_def | ::= | appt_start_marker attr_list appt_end_marker |
| attr_list | ::= | attr_def att_list |
| | | attr_def | |
| appt_start_marker | ::= | appt_marker ‘:string:begin\n’ |
| appt_end_marker | ::= | appt_marker ‘:string:end\n’ |
| appt_marker | ::= | ‘-//CDE_XAPIA_PRIVATE/CS/API/ENTRYATTR |
| //NONSGML ApptDelimiter//EN’ | ||
| attr_def | ::= | attr_name ‘:’ attr_type ‘:’ attr_value ‘\n’ |
| attr_type | ::= | ‘string’ | ‘integer’ | ‘reminder’ |
| | | ‘accesslist’ | ‘repeatdefinition’ | ‘custom’ | |
| attr_name | ::= | XAPIA string. |
| The span of characters that can be used in the | ||
| definition of an attribute name is specified in the | ||
| X/Open CAE Specification, X/Open XAPIA Calendar | ||
| API |
An example entry:
∗∗ Calendar Appointment ∗∗
-//CDE_XAPIA_PRIVATE/CS/API/ENTRYATTR//NONSGML ApptDelimiter//
EN:string:begin
-//XAPIA/CS/API/ENTRYATTR//NONSGML Start Date//EN:integer:775148400
-//XAPIA/CS/API/ENTRYATTR//NONSGML End Date//EN:integer:775148900
-//XAPIA/CS/API/ENTRYATTR//NONSGML Type//EN:string:CSA_TYPE_EVENT
-//CDE_XAPIA_PRIVATE/CS/API/ENTRYATTR//NONSGML Showtime//EN:integer:1
-//XAPIA/CS/API/ENTRYATTR//NONSGML Summary//EN:string:Foundation
planning meeting in Hari’s office
-//XAPIA/CS/API/ENTRYATTR//NONSGML Status//EN:integer:0
-//XAPIA/CS/API/ENTRYATTR//NONSGML Recurrence Rule//EN:string:M60 #12
-//XAPIA/CS/API/ENTRYATTR//NONSGML Audio Reminder//EN:reminder:-60:
-//XAPIA/CS/API/ENTRYATTR//NONSGML Flashing Reminder//EN:reminder:-60:
-//XAPIA/CS/API/ENTRYATTR//NONSGML Mail Reminder//EN:reminder:-1800:
hseldon@trantor
-//XAPIA/CS/API/ENTRYATTR//NONSGML Popup Reminder//EN:reminder:300:
-//CDE_XAPIA_PRIVATE/CS/API/ENTRYATTR//NONSGML ApptDelimiter//
EN:string:end
Date: 7/25/1994
Start: 8:00am
End: 9:00am
Repeat: Every Two Weeks, last
For:26
What: Foundation planning meeting
in Hari’s office
SEE ALSO
csacsa(5), csa_add_entry(3), csa_call_callbacks(3), csa_delete_calendar(3), csa_delete_entry(3), csa_free(3), csa_free_time_search(3), csa_list_calendar_attributes(3), csa_list_calendars(3), csa_list_entries(3), csa_list_entry_attributes(3), csa_list_entry_sequence(3), csa_logoff(3), csa_logon(3), csa_look_up(3), csa_query_configuration(3), csa_read_calendar_attributes(3), csa_read_entry_attributes(3), csa_read_next_reminder(3), csa_register_callback(3), csa_unregister_callback(3), csa_update_calendar_attributes(3), csa_update_entry_attributes(3).