Z-ADDATT

This document covers the following topics:


Description

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.

Parameters

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.

Return Codes

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

Subprograms

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

Example

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