This document covers the following topics:
Add attendees and resources to a meeting.
You can add as many as 12 attendees with each call. To add further attendees, you have to re-invoke this subprogram with no changes to the parameter list - except for the specification of further attendees and attendee types.
Z-ADDATT does not validate the mail information for external attendees. Therefore, each external attendee must be fully defined.
Z-ADDATT creates an address list (if it does not already exist) and performs limited security checking - i.e. it validates the send level and the number of attendees. Valid attendees are reset to blank after checking.
If an attendee is not found or is invalid, the appropriate return code is set. In this case, the attendee is not reset to blank and the API ends.
Caution:
If one of the attendees is not found or is invalid (i.e. if the
return code is not 0), no attendees are added to the address list.
Z-MCONFM can later be used to send the invitations.
After the invitations have been sent, Z-UNDO can be used to undo attendees and resources.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | The cabinet of the originator. | |
| Password | A8 | R | The password of the above cabinet. | |
| Originator | A20 | O | Will be set to *USER if the originator has an own cabinet. Otherwise, the specified name will be used. | |
| Calendar-ISN | P10 | R | X | Input: ISN of the first record of the meeting to be modified. Output: ISN of the first record of the meeting that has been modified. |
| Attendees | A20/1:12 | R | X | Input: the names or user IDs of the attendees. Output: valid attendees are reset to blank. |
| Attendee-type | N2/1:12 | O | One of the following: 1=address (nickname), 5=cabinet, 10=distribution list, 29=resource, 33=user ID, 70=last name, 74=external. | |
| Work-parameter | A128 | For internal use. See The Work Parameter. |
| 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 a meeting |
| 21 | Attendee not found |
| 24 | Security violation |
| 25 | More attendees than allowed |
| 33 | Attendee not unique |
| 34 | Attendee type not found |
| 90 | Adding attendees is only allowed for the last version of the meeting |
| 91 | Attendees cannot be added to a canceled meeting |
Z-110
Z-120
Z-122
Z-123
Z-135
Z-147
Z-155
Z-165
Z-175
Z-190
Z-191A
Z-194
Z-197A
Z-200A
Z-201
Z-202
Z-207
Z-215
Z-216
Z-711
Z-742
Z-1200&0
DEFINE DATA LOCAL 1 RETURN-CODE (N2) 1 CABINET (A8) 1 PASSWORD (A8) 1 ORIGINATOR (A20) 1 CALENDAR-ISN (P10) 1 ATTENDEES (A20/1:12) 1 ATTENDEE-TYPE (N2/1:12) 1 WORK-PARAMETER (A128) * END-DEFINE * MOVE 'Cabinet' TO CABINET MOVE 'Password' TO PASSWORD MOVE 'David Brown' TO ORIGINATOR MOVE 102504 TO CALENDAR-ISN MOVE 'ESH' TO ATTENDEES(1) MOVE 33 TO ATTENDEE-TYPE(1) MOVE 'TPI' TO ATTENDEES(2) MOVE 33 TO ATTENDEE-TYPE(2) * CALLNAT 'Z-ADDATT' RETURN-CODE CABINET PASSWORD ORIGINATOR CALENDAR-ISN ATTENDEES (*) ATTENDEE-TYPE (*) WORK-PARAMETER * WRITE '=' CABINET / '=' PASSWORD / '=' ORIGINATOR / '=' CALENDAR-ISN / '=' ATTENDEES(*) / '=' ATTENDEE-TYPE(*) / * IF RETURN-CODE NE 0 WRITE / 'Return code' RETURN-CODE ELSE WRITE / 'Return status OK' END-IF * END