Z-CAN06

This document covers the following topics:


Description

Cancel a meeting.

The following applies for a meeting with version 1: if none of the attendees has read the invitation, all invitations are deleted from the Inbaskets of all attendees and the cancelation message is not sent.

The following applies if the version is greater than 1 or if one of the attendees has already read the invitation: all attendees receive the cancelation message in their Inbaskets.

The cancelation message is not sent, if the meeting occurs in the past.

When the parameter Retain-in-calendar has not been specified, the meeting is erased from the originator's calendar.

Successful termination of Z-CAN06 always results in an END TRANSACTION. You are not able to control transaction handling.

Parameters

Parameter Format In Out Remarks
Return-code N2   X  
Cabinet A8 R   The cabinet in which the meeting is to be canceled.
Password A8 R   The password of the above cabinet.
Calendar-ISN P10 R X Input: ISN of the first record of the meeting to be canceled. Output: ISN of the first record of the meeting that has been canceled.
Retain-in-calendar A1 O   If marked, the meeting is not erased from the originator's calendar after it has been canceled.
Cancelation-message A37/1:10 O   Text for the cancelation message. If left empty, the standard cancelation message is generated.

Return Codes

00 Success
02 Invalid cabinet name
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 Unable to create transport service item
98 Meeting has already been canceled and retained in calendar
99 Cancel not allowed from Inbasket

Subprograms

N-IDATCM
N-GETMSG
Z-MPPDB
Z-MPPLF
N-NAMMOD
S-0216
Z-0106A
Z-0106AN
Z-0420
Z-0420A
Z-100
Z-110
Z-120
Z-122
Z-123
Z-124
Z-135
Z-147
Z-160
Z-165
Z-168
Z-175
Z-177
Z-180
Z-185
Z-190
Z-191
Z-194
Z-194A
Z-197
Z-208
Z-209
Z-210
Z-211
Z-212
Z-213
Z-216
Z-222
Z-223
Z-224
Z-225
Z-241
Z-373
Z-400
Z-401
Z-402
Z-403
Z-404
Z-406
Z-407
Z-711
Z-711A
Z-728
Z-729
Z-734
Z-735
Z-736
Z-737
Z-738
Z-739
Z-740
Z-742
Z-743
Z-747
Z-120&0
Z-RCONFM
Z-UNDO

See also the list of subprograms for Z-UNDO.

Example

DEFINE DATA
LOCAL
1 RETURN-CODE          (N2)
1 CABINET              (A8)
1 PASSWORD             (A8)
1 CALENDAR-ISN         (P10)
1 RETAIN-IN-CALENDAR   (A1)
1 CANCELATION-MESSAGE  (A37/1:10)
END-DEFINE
*
MOVE 'Cabinet'  TO CABINET
MOVE 'Password' TO PASSWORD
MOVE 102504     TO CALENDAR-ISN 
MOVE 'X'        TO RETAIN-IN-CALENDAR
MOVE 'First line of cancelation message ' TO CANCELATION-MESSAGE(1)
MOVE 'Second line of cancelation message' TO CANCELATION-MESSAGE(2)
*
CALLNAT 'Z-CAN06'
  RETURN-CODE
  CABINET
  PASSWORD
  CALENDAR-ISN
  RETAIN-IN-CALENDAR
  CANCELATION-MESSAGE(*)
*
WRITE
  '=' CABINET            /
  '=' PASSWORD           /
  '=' CALENDAR-ISN       /
  '=' RETAIN-IN-CALENDAR /
  '=' CANCELATION-MESSAGE(*)
*
IF RETURN-CODE NE 0
  WRITE / 'Return code' RETURN-CODE
ELSE
  WRITE / 'Return status OK'
END-IF
*
END