seev.002.001.02
Scope The MeetingCancellation message is sent by the party that sent the MeetingNotification message to the original receiver. It is sent to cancel the previous MeetingNotification message or to advise the cancellation of a meeting. Usage The MeetingCancellation message is used in two different situations. First, it is used to cancel a previously sent MeetingNotification message. In this case, the MessageCancellation, the MeetingReference and the Reason building blocks need to be present. Second, it is used to advise that the meeting is cancelled. In this case, only the MeetingReference and Reason building blocks need to be present.
Message Construction
Every ISO20022 message has at the highest level what we call ‘building blocks’. Because the message is constructed as immutable records, the association is by composition. Below you can see the relationship between the message and its constituent building blocks: For comparison, see the ISO20022 official specification
classDiagram
direction LR
%% MeetingCancellationV02 recursion level 0 with max 0
MeetingCancellationV02 *-- "1..1" MessageIdentification1 : CancellationIdentification
MeetingCancellationV02 *-- "0..1" AmendInformation1 : MessageCancellation
MeetingCancellationV02 *-- "1..1" MeetingReference2 : MeetingReference
MeetingCancellationV02 *-- "0..1" IPartyIdentification9Choice : NotifyingParty
MeetingCancellationV02 *-- "0..200" SecurityPosition5 : Security
MeetingCancellationV02 *-- "1..1" MeetingCancellationReason1 : Reason
Now, we will zero-in one-by-one on each of these building blocks.
CancellationIdentification building block
Identifies the cancellation message. Identifies a message by a unique identifier and the date and time when the message was created by the sender. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% MessageIdentification1 recursion level 0 with max 1
class MessageIdentification1{
Identification IsoMax35Text
CreationDateTime IsoISODateTime
}
MessageIdentification1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Identification of the message. | IsoMax35Text - Required 1..1 |
| CreationDateTime | Date of creation of the message. | IsoISODateTime - Required 1..1 |
MessageCancellation building block
Information indicating that the cancellation of a message previously sent is requested (and not the cancellation of the meeting). Information specific to an amendment or cancellation. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% AmendInformation1 recursion level 0 with max 1
class AmendInformation1{
ReconfirmInstructions IsoYesNoIndicator
}
AmendInformation1 *-- "1..1" MessageIdentification : PreviousReference
%% MessageIdentification recursion level 1 with max 1
class MessageIdentification{
Identification IsoMax35Text
}
AmendInformation1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PreviousReference | Identifies the linked message which was previously sent. | MessageIdentification - Required 1..1 |
| ReconfirmInstructions | Indicates whether instructions must be resent (in case of modification of the parameters of a meeting for which instructions have already been sent). | IsoYesNoIndicator - Required 1..1 |
MeetingReference building block
Series of elements which allow to identify a meeting. Elements which allow to identify a meeting. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% MeetingReference2 recursion level 0 with max 1
class MeetingReference2{
MeetingIdentification IsoMax35Text
IssuerMeetingIdentification IsoMax35Text
MeetingDateAndTime IsoISODateTime
Type MeetingType2Code
Classification MeetingTypeClassification1Code
ExtendedClassification IsoExtended350Code
}
MeetingReference2 *-- "0..5" PostalAddress1 : Location
%% PostalAddress1 recursion level 1 with max 1
class PostalAddress1{
AddressType AddressType2Code
AddressLine IsoMax70Text
StreetName IsoMax70Text
BuildingNumber IsoMax16Text
PostCode IsoMax16Text
TownName IsoMax35Text
CountrySubDivision IsoMax35Text
Country CountryCode
}
MeetingReference2 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| MeetingIdentification | Identification assigned to a general meeting by the party notifying the meeting. It must be unique for the party notifying the meeting. | IsoMax35Text - Required 1..1 |
| IssuerMeetingIdentification | Identification assigned to a meeting by the issuer. It must be unique for the issuer. | IsoMax35Text - Optional 0..1 |
| MeetingDateAndTime | Date and time at which the meeting will take place. | IsoISODateTime - Optional 0..1 |
| Type | Specifies the type of meeting for which instructions are sent. | MeetingType2Code - Optional 0..1 |
| Classification | Classifies the type of meeting. | MeetingTypeClassification1Code - Optional 0..1 |
| ExtendedClassification | This code can be used in case another meeting classifications is required. | IsoExtended350Code - Optional 0..1 |
| Location | Place of the company meeting for the scheduled meeting date. | PostalAddress1 - Collection 0..5 |
NotifyingParty building block
Party notifying the cancellation of the meeting. Identification of a party. For comparison, see the ISO20022 official specification
classDiagram direction tb %% IPartyIdentification9Choice recursion level 0 with max 1
PartyIdentification9Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
Security building block
Identifies the security for which the meeting was organised. Identifies the securities for which the meeting is organised. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% SecurityPosition5 recursion level 0 with max 1
SecurityPosition5 *-- "1..1" SecurityIdentification3 : Identification
SecurityPosition5 *-- "0..1000" EligiblePosition2 : Position
%% SecurityIdentification3 recursion level 1 with max 1
class SecurityIdentification3{
ISIN IsoISINIdentifier
TickerSymbol IsoTickerIdentifier
CUSIP IsoCUSIPIdentifier
SEDOL IsoSEDOLIdentifier
QUICK IsoQUICKIdentifier
}
SecurityIdentification3 *-- "0..1" AlternateFinancialInstrumentIdentification1 : OtherIdentification
%% EligiblePosition2 recursion level 1 with max 1
class EligiblePosition2{
AccountIdentification IsoMax35Text
}
EligiblePosition2 *-- "0..1" IPartyIdentification9Choice : AccountOwner
EligiblePosition2 *-- "0..10" HoldingBalance3 : HoldingBalance
EligiblePosition2 *-- "0..10" IPartyIdentification9Choice : RightsHolder
SecurityPosition5 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Security held in an account on which the balance is calculated. | SecurityIdentification3 - Required 1..1 |
| Position | Amount of securities that are eligible for the vote. | EligiblePosition2 - Collection 0..1000 |
Reason building block
Defines the justification for the cancellation. Specifies the reason for cancelling a meeting. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% MeetingCancellationReason1 recursion level 0 with max 1
class MeetingCancellationReason1{
Code MeetingCancellationReason2Code
ExtendedCode IsoExtended350Code
CancellationReason IsoMax140Text
}
MeetingCancellationReason1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Code | Specifies the reason for cancelling a meeting in coded form. | MeetingCancellationReason2Code - Required 1..1 |
| ExtendedCode | Specifies the reason for cancelling a meeting in free text form. | IsoExtended350Code - Required 1..1 |
| CancellationReason | Provides more information on the reason for cancelling a meeting in free format form. | IsoMax140Text - Optional 0..1 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the MeetingCancellationV02 implementation follows a specific implementaiton pattern. First of all, MeetingCancellationV02 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, MeetingCancellationV02Document implements IOuterDocument. Because MeetingCancellationV02 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type MeetingCancellationV02.
classDiagram
class IOuterRecord
MeetingCancellationV02 --|> IOuterRecord : Implements
MeetingCancellationV02Document --|> IOuterDocument~MeetingCancellationV02~ : Implements
class IOuterDocument~MeetingCancellationV02~ {
MeetingCancellationV02 Message
}
Document wrapper for serialization
The only real purpose MeetingCancellationV02Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.002.001.02’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using MeetingCancellationV02.ToDocument() method. The returned MeetingCancellationV02Document value will serialize correctly according to ISO 20022 standards.
classDiagram
MeetingCancellationV02Document *-- MeetingCancellationV02 : Document
Sample of message format
This is an abbreviated version of what the message should look like.
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:seev.002.001.02">
<MtgCxl>
<CxlId>
<!-- CancellationIdentification inner content -->
</CxlId>
<MsgCxl>
<!-- MessageCancellation inner content -->
</MsgCxl>
<MtgRef>
<!-- MeetingReference inner content -->
</MtgRef>
<NtifngPty>
<!-- NotifyingParty inner content -->
</NtifngPty>
<Scty>
<!-- Security inner content -->
</Scty>
<Rsn>
<!-- Reason inner content -->
</Rsn>
</MtgCxl>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_TlJcItEwEd-BzquC8wXy7w_-976963352"
nextVersions="_TlSmJNEwEd-BzquC8wXy7w_-1183208887"
name="MeetingCancellationV02"
definition="Scope
The MeetingCancellation message is sent by the party that sent the MeetingNotification message to the original receiver. It is sent to cancel the previous MeetingNotification message or to advise the cancellation of a meeting.
Usage
The MeetingCancellation message is used in two different situations.
First, it is used to cancel a previously sent MeetingNotification message. In this case, the MessageCancellation, the MeetingReference and the Reason building blocks need to be present.
Second, it is used to advise that the meeting is cancelled. In this case, only the MeetingReference and Reason building blocks need to be present."
registrationStatus="Registered"
messageSet="_urpIICeJEeOCeO5e7islRQ"
xmlTag="MtgCxl"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<constraint
xmi:id="_TlJcKdEwEd-BzquC8wXy7w_1794190097"
name="Cancellation1Guideline"
definition="It is recommended to cancel a meeting by using MeetingReference/MeetingIdentification and Reason only. It is recommended to avoid the repetition of optional building blocks or components."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_TlSmEtEwEd-BzquC8wXy7w_1978896950"
name="Cancellation2Guideline"
definition="It is recommended to cancel a meeting notification message by using MessageCancellation, MeetingReference/MeetingIdentification and Reason only. It is recommended to avoid the repetition of optional building blocks or components."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_TlSmFdEwEd-BzquC8wXy7w_1110025152"
name="MeetingIdentificationAndPreviousReference1Guideline"
definition="If MessageCancellation is not present, then the meeting has been cancelled by the issuer."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_TlSmGNEwEd-BzquC8wXy7w_1110025177"
name="MeetingIdentificationAndPreviousReference2Guideline"
definition="If MessageCancellation is present, then the MeetingNotification message is cancelled however the meeting itself is not cancelled."
registrationStatus="Provisionally Registered" />
<messageBuildingBlock
xmi:id="_TlJcI9EwEd-BzquC8wXy7w_-1270178957"
name="CancellationIdentification"
definition="Identifies the cancellation message."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="CxlId"
complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
<messageBuildingBlock
xmi:id="_TlJcJNEwEd-BzquC8wXy7w_-976963274"
name="MessageCancellation"
definition="Information indicating that the cancellation of a message previously sent is requested (and not the cancellation of the meeting)."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="MsgCxl"
complexType="_RVa40tp-Ed-ak6NoX_4Aeg_-1270467118" />
<messageBuildingBlock
xmi:id="_TlJcJdEwEd-BzquC8wXy7w_-976963350"
name="MeetingReference"
definition="Series of elements which allow to identify a meeting."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="MtgRef"
complexType="_TlqdItp-Ed-ak6NoX_4Aeg_-1779095008" />
<messageBuildingBlock
xmi:id="_TlJcJtEwEd-BzquC8wXy7w_-976963316"
name="NotifyingParty"
definition="Party notifying the cancellation of the meeting."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="NtifngPty"
complexType="_QRUXhtp-Ed-ak6NoX_4Aeg_967984948" />
<messageBuildingBlock
xmi:id="_TlJcJ9EwEd-BzquC8wXy7w_-976963334"
name="Security"
definition="Identifies the security for which the meeting was organised."
registrationStatus="Provisionally Registered"
maxOccurs="200"
minOccurs="0"
xmlTag="Scty"
complexType="_QT2uKNp-Ed-ak6NoX_4Aeg_583952553" />
<messageBuildingBlock
xmi:id="_TlJcKNEwEd-BzquC8wXy7w_-976963291"
name="Reason"
definition="Defines the justification for the cancellation."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="Rsn"
complexType="_RVRH0Np-Ed-ak6NoX_4Aeg_1713659135" />
<messageDefinitionIdentifier
businessArea="seev"
messageFunctionality="002"
flavour="001"
version="02" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.