This document covers the following topics:
Add an appointment.
The date range between Start-date and End-date must be equal to or less than 90 days (otherwise the return code 43 is issued). Start-date and End-date are computed according to the given time zone.
If a time zone is not specified, the Start-time and End-time are interpreted as GMT (0). If these values are to be put into a different time zone, the difference must be entered into the parameter Timezone.
If Start-time and End-time are not specified, the time range from 0:00 to 23:59 is automatically provided.
If the parameter No-time-occupancy is specified, the appointment does not occupy time in the calendar. This means that if another user wants to add a meeting and searches the calendar, this time range is not marked as reserved.
If the parameter Separate-daily-entries is specified, the appointment occupies only the specified time range for each day. If the parameter Separate-daily-entries is not specified, the whole time range starting with the Start-time of the first day and ending with the End-time of the last day is reserved.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | The cabinet in which the appointment is to be added. | |
| Password | A8 | R | The password of the above cabinet. | |
| Start-date | A8 | R | The starting date of the appointment. Format yyyymmdd. | |
| Start-time | A8 | O | The starting time of the appointment. Format hhmm. | |
| End-date | A8 | O | The ending date of the appointment. Format yyyymmdd. | |
| End-time | A8 | O | The ending time of the appointment. Format hhmm. | |
| No-time-occupancy | A1 | O | If specified, the appointment does not occupy time in the calendar. | |
| Separate-daily-entries | A1 | O | If specified, the appointment occupies only the specified time range for each day. | |
| Subject | A20 | R/O | The subject of the appointment. You must specify at least one of the following: Subject, Description or Location. | |
| Description | A60/1:3 | R/O | A brief description for the appointment. You must specify at least one of the following: Description, Subject or Location. | |
| Location | A60 | R/O | The location of the appointment. You must specify at least one of the following: Location, Subject or Description. | |
| Keywords | A15/1:6 | O | Keywords are helpful later when you search for an object. You can specify up to 6 keywords. A keyword must not contain an asterisk (*). | |
| Private-flag | A1 | O | Only allowed in a private cabinet. If marked, the appointment is a private object. | |
| Security-flags | A1/1:4 | O | The security levels for Read, Modify, Copy and Print. Values 0 to 9. You can also assign the value X which provides absolute protection. | |
| Timezone | N2 | O | Default: 0 (GMT). Values -12 to +11. |
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 03 | Password incorrect |
| 41 | Invalid start-date |
| 42 | Invalid start-time |
| 43 | Invalid end-date |
| 44 | Invalid end-time |
| 47 | Invalid timezone |
| 51 | Invalid name (subject) |
| 54 | At least one keyword was invalid |
| 61 | Invalid security code(s) |
N-IDATCM
Z-0106A
Z-0106C
Z-0106Z
Z-120
Z-122
Z-123
Z-160
Z-175
Z-185
Z-1200&0