This document covers the following topics:
Return information about an appointment or meeting.
This subprogram returns the next appointment or meeting beginning with the date and time entered in the Current-date and Current-start parameters. On the following days, all calendar entries which exceed one day are returned starting with midnight (and not with the time you specified for the first day).
The following information pertains to the returned list. For each calendar entry, the parameters Current-date, Current-start and Current-end refer to the start and end time of each day. If a calendar entry extends past midnight, Con-nect automatically splits the entry for each day.
For a private calendar entry not belonging to the invoking cabinet, only the date and time are returned. The private entry has an asterisk (*) in the subject line; description and location are not returned.
The timezone is always GMT. Other timezones are not considered.
Provided that the Work-parameter is not corrupted by the calling program, this subprogram can be invoked iteratively to return successive appointments or meetings.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | The cabinet which contains the appointment or meeting for which you want to return information. | |
| Password | A8 | R | The password of the above cabinet. | |
| Current-date | A8 | R | X | Format yyyymmdd. See the description above. |
| Current-start | A8 | O | X | Format hhmm. See the description above. |
| Current-end | A8 | X | The end time of the currently returned appointment or meeting. Format hhmm. | |
| Subject | A20 | X | The subject of the appointment or meeting. | |
| Description | A60/1:3 | X | The description of the appointment or meeting. | |
| Location | A60 | X | The location of the appointment or meeting. | |
| Object-number | N2 | X | 3=appointment, 16=meeting. | |
| Range-type | A1 | X | 1=the whole time range, 2=separate daily entries, 3=only a starting time. | |
| No-occupation | A1 | X | Blank=the calendar entry occupies time; left parenthesis=the calendar entry does not occupy time. | |
| Daily-entries-status | A1 | X | *=First day, >=continued from the previous day, <=last day. | |
| Work-parameter | A40 | For internal use. See The Work Parameter. |
| 00 | Success |
| 02 | Invalid cabinet name |
| 03 | Password incorrect |
| 41 | Invalid start-date |
| 42 | Invalid start-time |
| 77 | End of list |
Z-120
Z-122
Z-123
Z-160
Z-1200&0