Z-SRCH03

This document covers the following topics:


Description

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.

Parameters

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.

Return Codes

00 Success
02 Invalid cabinet name
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)

Subprograms

Z-120
Z-122
Z-123
Z-1200&0