This document covers the following topics:
Return a list of appointments or meetings which have the specified keywords.
The returned list contains only one kind of object (as specified in the parameter Object-number). Only the objects containing all specified keywords are returned.
When a calendar entry extends over several days or when it continues after midnight (e.g. when it is scheduled from 11 PM to 2 AM), it is returned only once.
This subprogram should be invoked iteratively until the return code 77 indicates the end of the list.
You cannot use this subprogram if the returned list is to contain more than 99999 results.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | The cabinet in which the list is to be returned. | |
| Password | A8 | R | The password of the above cabinet. | |
| Keywords-in | A15/1:6 | R | The keywords of the calendar entries that you are searching for. You can specify up to 6 keywords. A keyword must not contain an asterisk (*). | |
| Object-number | N2 | R | The kind of object to be returned: 3=appointment, 16=meeting. | |
| Object-table (20) | ||||
| Description | A60/1:4 | X | The description of the calendar entry. | |
| ISN | P8 | X | The ISN of the calendar entry which contains all specified keywords. | |
| Keywords-out | A15/1:6 | X | The keywords which have been defined for the calendar entry. | |
| Start-date | A8 | X | The starting date of the calendar entry. Format yyyymmdd. | |
| Start-time | A8 | X | The starting time of the calendar entry. Format hhmm. | |
| End-date | A8 | X | The ending date of the calendar entry. Format yyyymmdd. | |
| End-time | A8 | X | The ending time of the calendar entry. Format hhmm. | |
| Location | A60 | X | The location of the calendar entry. | |
| Agenda | A32 | X | Only applies for a meeting. The name of a document which has been linked to the meeting. | |
| Work-parameter | A160 | For internal use. See The Work Parameter. | ||
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 03 | Password incorrect |
| 13 | Invalid object number |
| 54 | At least one keyword was invalid |
| 77 | End of list |
| 90 | Returned list is too large (>99999) |
Z-120
Z-122
Z-123
Z-1200&0