MeetingCancellationV04

seev.002.001.04

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
%% MeetingCancellationV04 recursion level 0 with max 0
MeetingCancellationV04 *-- "1..1" MessageIdentification1 : Identification
MeetingCancellationV04 *-- "0..1" AmendInformation1 : MessageCancellation
MeetingCancellationV04 *-- "1..1" MeetingReference5 : MeetingReference
MeetingCancellationV04 *-- "0..1" IPartyIdentification9Choice : NotifyingParty
MeetingCancellationV04 *-- "0..200" SecurityPosition6 : Security
MeetingCancellationV04 *-- "1..1" MeetingCancellationReason2 : Reason
MeetingCancellationV04 *-- "0..1" Extension2 : Extension
  

Now, we will zero-in one-by-one on each of these building blocks.

Identification 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

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

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
%% MeetingReference5 recursion level 0 with max 1
class MeetingReference5{
    MeetingIdentification IsoMax35Text
    IssuerMeetingIdentification IsoMax35Text
    MeetingDateAndTime IsoISODateTime
    Type MeetingType2Code
}
MeetingReference5 *-- "0..1" IMeetingTypeClassification1Choice : Classification
MeetingReference5 *-- "0..5" PostalAddress1 : Location
%% IMeetingTypeClassification1Choice recursion level 1 with max 1
%% 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
}
  

MeetingReference5 members

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

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
%% SecurityPosition6 recursion level 0 with max 1
SecurityPosition6 *-- "1..1" SecurityIdentification11 : Identification
SecurityPosition6 *-- "0..1000" EligiblePosition3 : Position
%% SecurityIdentification11 recursion level 1 with max 1
class SecurityIdentification11{
    Description IsoMax140Text
}
SecurityIdentification11 *-- "1..1" ISecurityIdentification11Choice : Identification
%% EligiblePosition3 recursion level 1 with max 1
class EligiblePosition3{
    AccountIdentification IsoMax35Text
}
EligiblePosition3 *-- "0..1" IPartyIdentification9Choice : AccountOwner
EligiblePosition3 *-- "0..10" HoldingBalance6 : HoldingBalance
EligiblePosition3 *-- "0..10" IPartyIdentification9Choice : RightsHolder
  

SecurityPosition6 members

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
%% MeetingCancellationReason2 recursion level 0 with max 1
class MeetingCancellationReason2{
    CancellationReason IsoMax140Text
}
MeetingCancellationReason2 *-- "0..1" IMeetingCancellationReason1Choice : CancellationReasonCode
%% IMeetingCancellationReason1Choice recursion level 1 with max 1
  

MeetingCancellationReason2 members

Extension building block

Additional information that can not be captured in the structured fields and/or any other specific block. Additional information that can not be captured in the structured fields and/or any other specific block. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Extension2 recursion level 0 with max 1
class Extension2{
    PlaceAndName IsoMax350Text
}
Extension2 *-- "1..1" ExtensionEnvelope1 : ExtensionEnvelope
%% ExtensionEnvelope1 recursion level 1 with max 1
ExtensionEnvelope1 *-- "1..1" ExtensionContents1 : ExtensionContents
  

Extension2 members

Extensibility and generalization considerations

To facilitate generalized design patterns in the system, the MeetingCancellationV04 implementation follows a specific implementaiton pattern. First of all, MeetingCancellationV04 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, MeetingCancellationV04Document implements IOuterDocument. Because MeetingCancellationV04 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type MeetingCancellationV04.

classDiagram
    class IOuterRecord
    MeetingCancellationV04 --|> IOuterRecord : Implements
    MeetingCancellationV04Document --|> IOuterDocument~MeetingCancellationV04~ : Implements
    class IOuterDocument~MeetingCancellationV04~ {
        MeetingCancellationV04 Message
     }
  

Document wrapper for serialization

The only real purpose MeetingCancellationV04Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.002.001.04’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using MeetingCancellationV04.ToDocument() method. The returned MeetingCancellationV04Document value will serialize correctly according to ISO 20022 standards.

classDiagram
    MeetingCancellationV04Document *-- MeetingCancellationV04 : 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.04">
    <MtgCxl>
        <Id>
            <!-- Identification inner content -->
        </Id>
        <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>
        <Xtnsn>
            <!-- Extension inner content -->
        </Xtnsn>
    </MtgCxl>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_TlmIHtEwEd-BzquC8wXy7w_-1684108229"
  nextVersions="_xDAOAVtcEeSwKe7KuKvXhg"
  previousVersion="_TlSmJNEwEd-BzquC8wXy7w_-1183208887"
  name="MeetingCancellationV04"
  definition="Scope&#xD;&#xA;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.&#xD;&#xA;Usage&#xD;&#xA;The MeetingCancellation message is used in two different situations.&#xD;&#xA;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.&#xD;&#xA;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="_TlvSBdEwEd-BzquC8wXy7w_269200866"
    nextVersions="_xDAOA1tcEeSwKe7KuKvXhg"
    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="_TlvSCNEwEd-BzquC8wXy7w_-33855649"
    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="_TlvSC9EwEd-BzquC8wXy7w_-1030928002"
    name="MeetingIdentificationAndPreviousReference1Guideline"
    definition="If MessageCancellation is not present, then the meeting has been cancelled by the issuer."
    registrationStatus="Provisionally Registered" />
  <constraint
    xmi:id="_Tl5DAdEwEd-BzquC8wXy7w_420231620"
    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="_TlmIH9EwEd-BzquC8wXy7w_26118050"
    name="Identification"
    definition="Identifies the cancellation message."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Id"
    complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
  <messageBuildingBlock
    xmi:id="_TlmIINEwEd-BzquC8wXy7w_2019170750"
    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="_TlvSANEwEd-BzquC8wXy7w_-1689849520"
    nextVersions="_xDAOD1tcEeSwKe7KuKvXhg"
    name="MeetingReference"
    definition="Series of elements which allow to identify a meeting."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="MtgRef"
    complexType="_Tk62R9p-Ed-ak6NoX_4Aeg_-8393617" />
  <messageBuildingBlock
    xmi:id="_TlvSAdEwEd-BzquC8wXy7w_-1235762251"
    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="_TlvSAtEwEd-BzquC8wXy7w_1987199986"
    nextVersions="_xDAOE1tcEeSwKe7KuKvXhg"
    name="Security"
    definition="Identifies the security for which the meeting was organised."
    registrationStatus="Provisionally Registered"
    maxOccurs="200"
    minOccurs="0"
    xmlTag="Scty"
    complexType="_QTaCNdp-Ed-ak6NoX_4Aeg_-582916783" />
  <messageBuildingBlock
    xmi:id="_TlvSA9EwEd-BzquC8wXy7w_-2140747415"
    nextVersions="_xDAOFVtcEeSwKe7KuKvXhg"
    name="Reason"
    definition="Defines the justification for the cancellation."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Rsn"
    complexType="_RCMa19p-Ed-ak6NoX_4Aeg_1000768570" />
  <messageBuildingBlock
    xmi:id="_TlvSBNEwEd-BzquC8wXy7w_-628495307"
    name="Extension"
    definition="Additional information that can not be captured in the structured fields and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="Xtnsn"
    complexType="_QzJSNdp-Ed-ak6NoX_4Aeg_251191216" />
  <messageDefinitionIdentifier
    businessArea="seev"
    messageFunctionality="002"
    flavour="001"
    version="04" />
</messageDefinition>

ISO Building Blocks

The following items are used as building blocks to construct this message.