This document covers the following topics:
Return information about an appointment, meeting, reminder or todo.
This subprogram returns the next appointment, meeting, reminder or todo beginning with the date and time entered in the Start-date and Start-time 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 parameters Start-date, Start-time, End-date and End-time refer to the entire entry as specified online in the "Add" screen (for example, a meeting which starts at 10:00 on May 5 and ends at 16:00 on May 8).
The returned list is similar to the list which is returned with Z-GET03B. However, the list returned with Z-GET06A contains additional information: each occurrence of an entry in the list contains the start and end date/time of the whole entry.
In addition to the parameters returned by Z-GET03B, the following parameters are also returned for an appointment or meeting: Agenda, Keywords, Private-flag, Security-flags, Start-date, Start-time, End-date and End-time.
For a reminder or todo only the first 3 lines of the description are returned (reminders and todos do not have the parameters Location, Agenda and Keywords).
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, location, agenda and keywords 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, meetings, reminders and todos.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | The cabinet which contains the calendar entry for which you want to return information. | |
| Password | A8 | R | The password of the above cabinet. | |
| Start-date | A8 | R | X | Format yyyymmdd. See the description above. |
| Start-time | A8 | O | X | Format hhmm. See the description above. |
| End-date | A8 | X | Format yyyymmdd. See the description above. | |
| End-time | A8 | X | Format hhmm. See the description above. | |
| Subject | A20 | X | The subject of the calendar entry. | |
| Description | A60/1:3 | X | The description of the calendar entry. | |
| Location | A60 | X | The location of the appointment or meeting. Does not apply for a reminder or todo. | |
| Agenda | A32 | X | Only applies for a meeting. The name of a document which has been linked to the meeting. | |
| Keywords | A15/1:6 | X | Only applies for an appointment or meeting. Keywords are helpful later when you search for an object. | |
| Private-flag | A1 | X | If marked, the appointment or meeting is a private object. Does not apply for a reminder or todo. | |
| Security-flags | A1/1:4 | X | Only applies for an appointment or meeting. The security levels for Read, Modify, Copy and Print. Values 0 to 9. | |
| Object-number | N2 | X | 3=appointment, 16=meeting, 28=reminder, 43=todo. | |
| Range-type | A1 | X | 1=the whole time range, 2=separate daily entries, 3=only a starting time. Each reminder and todo has the Range-type 3. | |
| No-occupation | A1 | X | Blank=the calendar entry occupies time; left parenthesis=the calendar entry does not occupy time. A reminder or todo does not occupy time. | |
| Current-date | A8 | X | Format yyyymmdd. See the description above. | |
| Current-start | A8 | X | Format hhmm. See the description above. | |
| Current-end | A8 | X | Format hhmm. See the description above. | |
| Work-parameter | A40 | For internal use. See The Work Parameter. |
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 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