This document covers the following topics:
Accept or decline an invitation to a meeting.
This subprogram can be used by all attendees. It can also be used for resources.
The Calendar-ISN must point to a meeting, invitation or cancelation message.
To accept the invitation, mark the parameter Accept with any character. The invitation can be accepted even if it was previously declined, but added to your calendar.
To decline the invitation, leave the parameter Accept blank. The invitation can be declined even if it was previously accepted. When you decline an invitation, it is erased and the meeting is stopped. However, if you mark the parameter Add-to-calendar, the meeting is added to your calendar.
An invitation can only be accepted and added to your calendar if its time range does not conflict with other entries in your calendar. However, if you mark the parameter Add-to-calendar, the invitation is accepted and added to your calendar even if there are conflicting entries.
The following applies for a resource: if you decline an invitation (i.e. leave the parameter Accept blank), the parameter Add-to-calendar is ignored. The meeting is not added to the calendar of the resource.
The following applies for a cancelation message: the parameter Accept is ignored since the cancelation of the meeting is automatically accepted. If you mark the parameter Add-to-calendar, the canceled meeting is added to your calendar.
Date and time when the attendee has displayed the invitation for the first time or changed its state from accepted to declined (or vice versa) is included in the address list. This corresponds to the "Date/Time Read" information that can be displayed in online mode using the ADDRESS command.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | X | ||
| Cabinet | A8 | R | The cabinet which contains the cancelation message or the invitation that is to be accepted or declined. | |
| Password | A8 | R | The password of the above cabinet. | |
| Calendar-ISN | P10 | R | X | Input: ISN of the invitation or cancelation message. Output: ISN of the accepted or declined invitation. |
| Accept | A1 | O | If marked, the invitation is accepted. If not marked, the invitation is declined. For a cancelation message, this parameter is ignored. | |
| Add-to-calendar | A1 | O | See the above description. For a resource, this parameter is ignored. |
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 03 | Password incorrect |
| 04 | ISN was not found |
| 09 | ISN does not point to correct object |
| 18 | API context buffer not available |
| 24 | Security violation |
| 90 | Date/time conflict with existing entry in calendar. Or resource is occupied during this time range. |
| 91 | History of meeting cannot be accepted or declined |
| 92 | Meeting has already been canceled (cannot be accepted or declined) |
| 93 | Resource does not exist |
Z-0106A
Z-0106AN
Z-0420
Z-0420A
Z-100
Z-110
Z-120
Z-122
Z-123
Z-124
Z-165
Z-175
Z-180
Z-185
Z-190
Z-194
Z-197
Z-216
Z-222
Z-223
Z-400
Z-401
Z-711
Z-711A
Z-726
Z-728
Z-729
Z-731
Z-736
Z-741
Z-744
Z-745
Z-751
Z-120&0
DEFINE DATA LOCAL 1 RETURN-CODE (N2) 1 CABINET (A8) 1 PASSWORD (A8) 1 CALENDAR-ISN (P10) 1 ACCEPT (A1) 1 ADD-TO-CALENDAR (A1) END-DEFINE * MOVE 'Cabinet' TO CABINET MOVE 'Password' TO PASSWORD MOVE 59870 TO CALENDAR-ISN MOVE 'X' TO ACCEPT MOVE 'X' TO ADD-TO-CALENDAR * CALLNAT 'Z-ACCEPT' RETURN-CODE CABINET PASSWORD CALENDAR-ISN ACCEPT ADD-TO-CALENDAR * WRITE '=' CABINET / '=' PASSWORD / '=' CALENDAR-ISN / '=' ACCEPT / '=' ADD-TO-CALENDAR // * IF RETURN-CODE NE 0 WRITE / 'Return code: ' RETURN-CODE ELSE WRITE / 'Return status OK' END-IF * * END