dtcm_entry

special file

`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 &str-Za;.

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

&cdeman.csa.csa.h;, &cdeman.csa.add.entry;, &cdeman.csa.call.callbacks;, &cdeman.csa.delete.calendar;, &cdeman.csa.delete.entry;, &cdeman.csa.free;, &cdeman.csa.free.time.search;, &cdeman.csa.list.calendar.attributes;, &cdeman.csa.list.calendars;, &cdeman.csa.list.entries;, &cdeman.csa.list.entry.attributes;, &cdeman.csa.list.entry.sequence;, &cdeman.csa.logoff;, &cdeman.csa.logon;, &cdeman.csa.look.up;, &cdeman.csa.query.configuration;, &cdeman.csa.read.calendar.attributes;, &cdeman.csa.read.entry.attributes;, &cdeman.csa.read.next.reminder;, &cdeman.csa.register.callback;, &cdeman.csa.unregister.callback;, &cdeman.csa.update.calendar.attributes;, &cdeman.csa.update.entry.attributes;.