AccountModificationInstructionV02

acmt.003.001.02

Scope An account owner, eg, and investor or its designated agent, sends the AccountModificationInstruction message to an account servicer, eg, a registrar, transfer agent or custodian bank to modify, ie, create, update or delete specific details of an existing investment fund account. Usage The AccountModificationInstruction message is used to modify the details of an existing account. The AccountModificationInstruction message has three specific uses:

to maintain/update any of the existing account details, eg, to update the address of the beneficiary or modify the preference to income from distribution to capitalisation, or,
to add/create specific details to the existing account when these details were not yet recorded at the time of account creation, eg, to add a second address or to establish new cash settlement standing instructions, or,
to delete specific account details, eg, delete cash standing instructions. This message cannot be used to delete an entire account, as institution specific and regulatory rules pertaining to account deletion are diverse. The usage of this message may be subject to service level agreement (SLA) between the counterparties. Execution of the AccountModificationInstruction is confirmed via an AccountDetailsConfirmation message.

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
%% AccountModificationInstructionV02 recursion level 0 with max 0
AccountModificationInstructionV02 *-- "1..1" MessageIdentification1 : MessageIdentification
AccountModificationInstructionV02 *-- "0..1" AdditionalReference3 : PreviousReference
AccountModificationInstructionV02 *-- "0..1" InvestmentAccountModificationDetails : InstructionDetails
AccountModificationInstructionV02 *-- "1..1" InvestmentAccountSelection2 : InvestmentAccountSelection
AccountModificationInstructionV02 *-- "0..1" InvestmentAccount28 : ModifiedInvestmentAccount
AccountModificationInstructionV02 *-- "0..10" AccountParties4 : ModifiedAccountParties
AccountModificationInstructionV02 *-- "0..10" ModificationScope7 : ModifiedIntermediaries
AccountModificationInstructionV02 *-- "0..1" ReferredAgent1 : ModifiedPlacement
AccountModificationInstructionV02 *-- "0..1" ModificationScope9 : ModifiedIssueAllocation
AccountModificationInstructionV02 *-- "0..50" ModificationScope8 : ModifiedSavingsInvestmentPlan
AccountModificationInstructionV02 *-- "0..10" ModificationScope8 : ModifiedWithdrawalInvestmentPlan
AccountModificationInstructionV02 *-- "0..8" InvestmentFundCashSettlementInformation4 : ModifiedCashSettlement
AccountModificationInstructionV02 *-- "0..30" ModificationScope10 : ModifiedServiceLevelAgreement
AccountModificationInstructionV02 *-- "0..1" Extension1 : Extension

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

MessageIdentification building block

Identifies the 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

PreviousReference building block

Reference to a linked message that was previously sent. References a related message or provides another reference, such as a pool reference, linking a set of messages. The party which issued the related reference may be the Sender of the referenced message or a party other than the Sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AdditionalReference3 recursion level 0 with max 1
class AdditionalReference3{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference3 *-- "0..1" IPartyIdentification2Choice : ReferenceIssuer
%% IPartyIdentification2Choice recursion level 1 with max 1

AdditionalReference3 members

Member name	Description	Data Type / Multiplicity
Reference	Business reference of a message assigned by the party issuing the message. This reference must be unique amongst all messages of the same name sent by the same party.	IsoMax35Text - Required 1..1
ReferenceIssuer	Issuer of the reference.	IPartyIdentification2Choice - Optional 0..1
MessageName	Name of a message.	IsoMax35Text - Optional 0..1

InstructionDetails building block

Provide detailed information about the application modification instruction. Provide information about the reason for the modification and about the application request which triggered this modification. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% InvestmentAccountModificationDetails recursion level 0 with max 1
class InvestmentAccountModificationDetails{
    ModificationReason IsoMax350Text
    AccountApplicationIdentification IsoMax35Text
}

InvestmentAccountModificationDetails members

Member name	Description	Data Type / Multiplicity
ModificationReason	Reason for the modification brought to the investment account information.	IsoMax350Text - Optional 0..1
AccountApplicationIdentification	Unique and unambiguous identifier of the account modification request.	IsoMax35Text - Optional 0..1

InvestmentAccountSelection building block

Investment account selection information used to identify the account for which the information is modified. Choice between a unique account identification and a set of account selection criteria. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% InvestmentAccountSelection2 recursion level 0 with max 1
InvestmentAccountSelection2 *-- "1..1" AccountIdentification1 : AccountIdentification
InvestmentAccountSelection2 *-- "1..1" InvestmentAccount29 : OtherAccountSelectionData
%% AccountIdentification1 recursion level 1 with max 1
AccountIdentification1 *-- "1..1" SimpleIdentificationInformation : Proprietary
%% InvestmentAccount29 recursion level 1 with max 1
class InvestmentAccount29{
    Name IsoMax35Text
    Designation IsoMax35Text
    FundType IsoMax35Text
    FundFamilyName IsoMax350Text
}
InvestmentAccount29 *-- "0..1" FinancialInstrument10 : SecurityDetails
InvestmentAccount29 *-- "0..1" IIndividualPersonIdentificationChoice : IndividualOwnerIdentification
InvestmentAccount29 *-- "0..1" IPartyIdentification5Choice : OrganisationOwnerIdentification
InvestmentAccount29 *-- "0..10" Intermediary7 : Intermediary
InvestmentAccount29 *-- "0..1" IPartyIdentification2Choice : AccountServicer

InvestmentAccountSelection2 members

Member name	Description	Data Type / Multiplicity
AccountIdentification	Unique and unambiguous identification for the account between the account owner and the account servicer.	AccountIdentification1 - Required 1..1
OtherAccountSelectionData	Various investment account information used to select a specific account.	InvestmentAccount29 - Required 1..1

ModifiedInvestmentAccount building block

Information related to general characteristics of an investment account to be inserted, updated or deleted. Account between an investor(s) and a fund manager or a fund. The account can contain holdings in any investment fund or investment fund class managed (or distributed) by the fund manager, within the same fund family. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% InvestmentAccount28 recursion level 0 with max 1
class InvestmentAccount28{
    Name IsoMax35Text
    Designation IsoMax35Text
    Type FundCashAccount3Code
    ExtendedType IsoExtended350Code
    OwnershipType AccountOwnershipType3Code
    ExtendedOwnershipType IsoExtended350Code
    TaxExemptionReason TaxExemptReason1Code
    ExtendedTaxExemptionReason IsoExtended350Code
    StatementFrequency EventFrequency1Code
    ExtendedStatementFrequency IsoExtended350Code
    ReferenceCurrency ActiveCurrencyCode
    Language LanguageCode
    IncomePreference IncomePreference1Code
    TaxWithholdingMethod TaxWithholdingMethod1Code
    LetterIntentReference IsoMax35Text
    AccumulationRightReference IsoMax35Text
    RequiredSignatoriesNumber IsoNumber
    FundFamilyName IsoMax350Text
}
InvestmentAccount28 *-- "0..0" ModificationScope12 : ModifiedFundDetails
InvestmentAccount28 *-- "0..1" RoundingParameters1 : RoundingDetails
InvestmentAccount28 *-- "0..1" IPartyIdentification2Choice : AccountServicer
%% ModificationScope12 recursion level 1 with max 1
class ModificationScope12{
    ModificationScopeIndication DataModification2Code
}
ModificationScope12 *-- "1..1" FinancialInstrument10 : FundDetails
%% RoundingParameters1 recursion level 1 with max 1
class RoundingParameters1{
    RoundingModulus IsoDecimalNumber
    RoundingDirection RoundingDirection1Code
}
%% IPartyIdentification2Choice recursion level 1 with max 1

InvestmentAccount28 members

Member name	Description	Data Type / Multiplicity
Name	Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.	IsoMax35Text - Optional 0..1
Designation	Supplementary registration information applying to a specific block of units for dealing and reporting purposes. The supplementary registration information may be used when all the units are registered, for example, to a funds supermarket, but holdings for each investor have to reconciled individually.	IsoMax35Text - Optional 0..1
Type	Purpose of the account/source fund type. This is typically linked to an investment product, eg, wrapper, PEP, ISA.	FundCashAccount3Code - Optional 0..1
ExtendedType	Purpose of the account/source fund type. This is typically linked to an investment product, eg, wrapper, PEP, ISA.	IsoExtended350Code - Optional 0..1
OwnershipType	Ownership status of the account, eg, joint owners.	AccountOwnershipType3Code - Optional 0..1
ExtendedOwnershipType	Ownership status of the account, eg, joint owners.	IsoExtended350Code - Optional 0..1
TaxExemptionReason	Tax advantage specific to the account.	TaxExemptReason1Code - Optional 0..1
ExtendedTaxExemptionReason	Tax advantage specific to the account.	IsoExtended350Code - Optional 0..1
StatementFrequency	Regularity at which a statement is issued.	EventFrequency1Code - Optional 0..1
ExtendedStatementFrequency	Regularity at which a statement is issued.	IsoExtended350Code - Optional 0..1
ReferenceCurrency	Currency chosen for reporting purposes by the account owner in agreement with the account servicer.	ActiveCurrencyCode - Optional 0..1
Language	Language for all communication concerning the account.	LanguageCode - Optional 0..1
IncomePreference	Dividend option chosen by the account owner based on the options offered in the prospectus.	IncomePreference1Code - Optional 0..1
TaxWithholdingMethod	Method by which the tax (withholding tax) is to be processed i.e. either withheld at source or tax information reported to tax authorities or tax information is reported due to the provision of a tax certificate.	TaxWithholdingMethod1Code - Optional 0..1
LetterIntentReference	Reference of a letter of intent program, in which sales commissions are reduced based on the aggregate of a customer’s actual purchase and anticipated purchases, over a specific period of time, and as agreed by the customer. A letter of intent program is mainly used in the US market.	IsoMax35Text - Optional 0..1
AccumulationRightReference	Reference of an accumulation rights program, in which sales commissions are based on a customer’s present purchases of shares and the aggregate quantity previously purchased by the customer. An accumulation rights program is mainly used in the US market.	IsoMax35Text - Optional 0..1
RequiredSignatoriesNumber	Number of account owners or related parties required to authorise transactions on the account.	IsoNumber - Optional 0..1
FundFamilyName	Name of the investment fund family.	IsoMax350Text - Optional 0..1
ModifiedFundDetails	Detailed information about the investment fund associated to the account.	ModificationScope12 - Unknown 0..0
RoundingDetails	Parameters to be applied on deal amount for orders when the amount is a fractional number.	RoundingParameters1 - Optional 0..1
AccountServicer	Party that manages the account on behalf of the account owner, that is manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account.	IPartyIdentification2Choice - Optional 0..1

ModifiedAccountParties building block

Information related to the account related parties (eg. account owner) to be inserted, updated or deleted. Any party who is related to an investment account. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AccountParties4 recursion level 0 with max 1
class AccountParties4{
    ModificationScopeIndication DataModification1Code
}
AccountParties4 *-- "0..1" InvestmentAccountOwnershipInformation4 : PrimaryOwner
AccountParties4 *-- "0..5" InvestmentAccountOwnershipInformation4 : Trustee
AccountParties4 *-- "0..1" InvestmentAccountOwnershipInformation4 : CustodianForMinor
AccountParties4 *-- "0..1" InvestmentAccountOwnershipInformation4 : Nominee
AccountParties4 *-- "0..5" InvestmentAccountOwnershipInformation4 : JointOwner
AccountParties4 *-- "0..1" InvestmentAccountOwnershipInformation4 : SecondaryOwner
AccountParties4 *-- "0..1" InvestmentAccountOwnershipInformation4 : Beneficiary
AccountParties4 *-- "0..1" InvestmentAccountOwnershipInformation4 : PowerOfAttorney
AccountParties4 *-- "0..1" InvestmentAccountOwnershipInformation4 : LegalGuardian
AccountParties4 *-- "0..1" InvestmentAccountOwnershipInformation4 : SuccessorOnDeath
AccountParties4 *-- "0..1" InvestmentAccountOwnershipInformation4 : Administrator
AccountParties4 *-- "0..5" InvestmentAccountOwnershipInformation4 : Granter
AccountParties4 *-- "0..5" InvestmentAccountOwnershipInformation4 : Settler
AccountParties4 *-- "0..5" ExtendedParty1 : OtherParty
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% InvestmentAccountOwnershipInformation4 recursion level 1 with max 1
class InvestmentAccountOwnershipInformation4{
    MoneyLaunderingCheck MoneyLaunderingCheck1Code
    ExtendedMoneyLaunderingCheck IsoExtended350Code
    OwnershipBeneficiaryRate IsoPercentageRate
    ClientIdentification IsoMax35Text
    FiscalExemption IsoYesNoIndicator
    SignatoryRightIndicator IsoYesNoIndicator
}
InvestmentAccountOwnershipInformation4 *-- "1..1" Organisation3 : Organisation
InvestmentAccountOwnershipInformation4 *-- "1..1" IndividualPerson11 : IndividualPerson
InvestmentAccountOwnershipInformation4 *-- "0..10" ModificationScope11 : ModifiedInvestorProfileValidation
%% ExtendedParty1 recursion level 1 with max 1
class ExtendedParty1{
    ExtendedPartyRole IsoExtended350Code
}
ExtendedParty1 *-- "1..1" InvestmentAccountOwnershipInformation4 : OtherPartyDetails

AccountParties4 members

Member name	Description	Data Type / Multiplicity
ModificationScopeIndication	Specifies the type of modification to be applied on a set of information.	DataModification1Code - Required 1..1
PrimaryOwner	Single owner of the investment account or, when the ownership is split among several owners, the primary owner is the one giving its address and account details for the registration.	InvestmentAccountOwnershipInformation4 - Optional 0..1
Trustee	Legal owners of the property. However, the beneficiary has the equitable or beneficial ownership.	InvestmentAccountOwnershipInformation4 - Collection 0..5
CustodianForMinor	Entity that holds shares/units on behalf of a legal minor. Although the account is registered under the name of the minor, the custodian retains control of the account.	InvestmentAccountOwnershipInformation4 - Optional 0..1
Nominee	Entity named by the beneficial owner to act on its behalf, often to facilitate dealing, or to conceal the identity of the beneficiary.	InvestmentAccountOwnershipInformation4 - Optional 0..1
JointOwner	Co-owner of the investment account when the ownership is assigned to more than one party.	InvestmentAccountOwnershipInformation4 - Collection 0..5
SecondaryOwner	Entity that is not the primary owner when the ownership of the investment account is split among several owners.	InvestmentAccountOwnershipInformation4 - Optional 0..1
Beneficiary	Ultimate party that is entitled to either receive the benefits of the ownership of a financial instrument, or to be paid/credited as a result of a transfer.	InvestmentAccountOwnershipInformation4 - Optional 0..1
PowerOfAttorney	Entity that was given the authority by another entity to act on its behalf.	InvestmentAccountOwnershipInformation4 - Optional 0..1
LegalGuardian	Entity that has been appointed by a legal authority to act on behalf of a person judged to be incapacitated.	InvestmentAccountOwnershipInformation4 - Optional 0..1
SuccessorOnDeath	Deceased’s estate, or successor, to whom the respective percentage of ownership will be transferred upon the death of one of the owners.	InvestmentAccountOwnershipInformation4 - Optional 0..1
Administrator	Entity that has been appointed by a legal authorithy to act on behalf of a person or organisation that has gone bankrupt.	InvestmentAccountOwnershipInformation4 - Optional 0..1
Granter	Granter role in the hedge funds industry.	InvestmentAccountOwnershipInformation4 - Collection 0..5
Settler	Settler role in the hedge funds industry.	InvestmentAccountOwnershipInformation4 - Collection 0..5
OtherParty	An other type of party.	ExtendedParty1 - Collection 0..5

ModifiedIntermediaries building block

Information related to intermediaries to be inserted, updated or deleted. Scope of the modification to be applied on an identified set of information. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ModificationScope7 recursion level 0 with max 1
class ModificationScope7{
    ModificationScopeIndication DataModification1Code
}
ModificationScope7 *-- "1..1" Intermediary13 : Intermediary
%% Intermediary13 recursion level 1 with max 1
class Intermediary13{
    WaivedTrailerCommissionIndicator IsoYesNoIndicator
    Role InvestmentFundRole3Code
    ExtendedRole IsoExtended350Code
}
Intermediary13 *-- "1..1" IPartyIdentification4Choice : Identification
Intermediary13 *-- "0..1" Account2 : Account
Intermediary13 *-- "0..1" CommunicationAddress3 : PrimaryCommunicationAddress
Intermediary13 *-- "0..1" CommunicationAddress3 : SecondaryCommunicationAddress
Intermediary13 *-- "0..1" NameAndAddress4 : NameAndAddress

ModificationScope7 members

Member name	Description	Data Type / Multiplicity
ModificationScopeIndication	Specifies the type of modification to be applied on a set of information.	DataModification1Code - Required 1..1
Intermediary	Information related to intermediaries.	Intermediary13 - Required 1..1

ModifiedPlacement building block

Information related to referred placement agent in the hedge fund industry to be inserted, updated or deleted. Provides the placement agent identification for a hedge fund if the investor was referred by one. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ReferredAgent1 recursion level 0 with max 1
class ReferredAgent1{
    Referred Referred1Code
}
ReferredAgent1 *-- "0..1" IPartyIdentification2Choice : ReferredPlacementAgent
%% IPartyIdentification2Choice recursion level 1 with max 1

ReferredAgent1 members

Member name	Description	Data Type / Multiplicity
Referred	Indicates if the investor was referred by a placement agent.	Referred1Code - Required 1..1
ReferredPlacementAgent	Placement agent that referred the investor.	IPartyIdentification2Choice - Optional 0..1

ModifiedIssueAllocation building block

Eligibility conditions information related to new issues allocation to be inserted, updated or deleted. Scope of the modification to be applied on an identified set of information. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ModificationScope9 recursion level 0 with max 1
class ModificationScope9{
    ModificationScopeIndication DataModification1Code
}
ModificationScope9 *-- "1..1" NewIssueAllocation1 : IssueAllocation
%% NewIssueAllocation1 recursion level 1 with max 1
class NewIssueAllocation1{
    Restricted IsoYesNoIndicator
    ExemptPersonReason IsoMax350Text
}
NewIssueAllocation1 *-- "0..1" DeMinimusApplicable1 : DeMinimusApplicable
NewIssueAllocation1 *-- "0..1" DeMinimusNotApplicable1 : DeMinimusNotApplicable

ModificationScope9 members

Member name	Description	Data Type / Multiplicity
ModificationScopeIndication	Specifies the type of modification to be applied on a set of information.	DataModification1Code - Required 1..1
IssueAllocation	Information about the investment account ownership with respect to new issue allocation for a hedge fund.	NewIssueAllocation1 - Required 1..1

ModifiedSavingsInvestmentPlan building block

Information related to a savings plan to be either inserted, updated or deleted. Scope of the modification to be applied on an identified set of information. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ModificationScope8 recursion level 0 with max 1
class ModificationScope8{
    ModificationScopeIndication DataModification1Code
}
ModificationScope8 *-- "1..1" InvestmentPlan5 : InvestmentPlan
%% InvestmentPlan5 recursion level 1 with max 1
class InvestmentPlan5{
    Frequency EventFrequency1Code
    ExtendedFrequency IsoExtended350Code
    StartDate IsoISODate
    EndDate IsoISODate
    Amount IsoActiveCurrencyAndAmount
    GrossAmountIndicator IsoYesNoIndicator
    IncomePreference IncomePreference1Code
    InitialNumberOfInstalment IsoNumber
    TotalNumberOfInstalment IsoNumber
    RoundingDirection RoundingDirection1Code
}
InvestmentPlan5 *-- "1..50" Repartition1 : SecurityDetails
InvestmentPlan5 *-- "0..8" InvestmentFundCashSettlementInformation4 : ModifiedCashSettlement

ModificationScope8 members

Member name	Description	Data Type / Multiplicity
ModificationScopeIndication	Specifies the type of modification to be applied on a set of information.	DataModification1Code - Required 1..1
InvestmentPlan	Plan that allows investors to schedule periodical investments or divestments, according to pre-defined criteria.	InvestmentPlan5 - Required 1..1

ModifiedWithdrawalInvestmentPlan building block

Information related to a withrawal plan to be either inserted, updated or deleted. Scope of the modification to be applied on an identified set of information. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ModificationScope8 recursion level 0 with max 1
class ModificationScope8{
    ModificationScopeIndication DataModification1Code
}
ModificationScope8 *-- "1..1" InvestmentPlan5 : InvestmentPlan
%% InvestmentPlan5 recursion level 1 with max 1
class InvestmentPlan5{
    Frequency EventFrequency1Code
    ExtendedFrequency IsoExtended350Code
    StartDate IsoISODate
    EndDate IsoISODate
    Amount IsoActiveCurrencyAndAmount
    GrossAmountIndicator IsoYesNoIndicator
    IncomePreference IncomePreference1Code
    InitialNumberOfInstalment IsoNumber
    TotalNumberOfInstalment IsoNumber
    RoundingDirection RoundingDirection1Code
}
InvestmentPlan5 *-- "1..50" Repartition1 : SecurityDetails
InvestmentPlan5 *-- "0..8" InvestmentFundCashSettlementInformation4 : ModifiedCashSettlement

ModificationScope8 members

Member name	Description	Data Type / Multiplicity
ModificationScopeIndication	Specifies the type of modification to be applied on a set of information.	DataModification1Code - Required 1..1
InvestmentPlan	Plan that allows investors to schedule periodical investments or divestments, according to pre-defined criteria.	InvestmentPlan5 - Required 1..1

ModifiedCashSettlement building block

Cash settlement standing instruction associated to the investment fund transaction and to be either inserted or deleted. Settlement instructions to be used to transfer cash from the Debtor to the Creditor. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% InvestmentFundCashSettlementInformation4 recursion level 0 with max 1
class InvestmentFundCashSettlementInformation4{
    ModificationScopeIndication DataModification2Code
}
InvestmentFundCashSettlementInformation4 *-- "0..1" PaymentInstrument8 : SubscriptionPaymentInstrument
InvestmentFundCashSettlementInformation4 *-- "0..1" PaymentInstrument9 : RedemptionPaymentInstrument
InvestmentFundCashSettlementInformation4 *-- "0..1" PaymentInstrument9 : DividendPaymentInstrument
InvestmentFundCashSettlementInformation4 *-- "0..1" PaymentInstrument8 : SavingsPlanPaymentInstrument
%% PaymentInstrument8 recursion level 1 with max 1
class PaymentInstrument8{
    SettlementCurrency ActiveCurrencyCode
    Cheque IsoYesNoIndicator
    BankersDraft IsoYesNoIndicator
}
PaymentInstrument8 *-- "1..3" CashAccount4 : CashAccountDetails
PaymentInstrument8 *-- "1..1" PaymentCard2 : PaymentCardDetails
PaymentInstrument8 *-- "1..1" DirectDebitMandate4 : DirectDebitDetails
%% PaymentInstrument9 recursion level 1 with max 1
class PaymentInstrument9{
    SettlementCurrency ActiveCurrencyCode
}
PaymentInstrument9 *-- "1..3" CashAccount4 : CashAccountDetails
PaymentInstrument9 *-- "1..1" Cheque4 : ChequeDetails
PaymentInstrument9 *-- "1..1" Cheque4 : BankersDraftDetails
%% PaymentInstrument9 recursion level 1 with max 1
class PaymentInstrument9{
    SettlementCurrency ActiveCurrencyCode
}
PaymentInstrument9 *-- "1..3" CashAccount4 : CashAccountDetails
PaymentInstrument9 *-- "1..1" Cheque4 : ChequeDetails
PaymentInstrument9 *-- "1..1" Cheque4 : BankersDraftDetails
%% PaymentInstrument8 recursion level 1 with max 1
class PaymentInstrument8{
    SettlementCurrency ActiveCurrencyCode
    Cheque IsoYesNoIndicator
    BankersDraft IsoYesNoIndicator
}
PaymentInstrument8 *-- "1..3" CashAccount4 : CashAccountDetails
PaymentInstrument8 *-- "1..1" PaymentCard2 : PaymentCardDetails
PaymentInstrument8 *-- "1..1" DirectDebitMandate4 : DirectDebitDetails

InvestmentFundCashSettlementInformation4 members

Member name	Description	Data Type / Multiplicity
ModificationScopeIndication	Specifies the type of modification to be applied on a set of information.	DataModification2Code - Required 1..1
SubscriptionPaymentInstrument	Instrument that has or represents monetary value and is used to process a payment instruction for a subscription payment.	PaymentInstrument8 - Optional 0..1
RedemptionPaymentInstrument	Instrument that has or represents monetary value and is used to process a payment instruction for a redemption payment.	PaymentInstrument9 - Optional 0..1
DividendPaymentInstrument	Instrument that has or represents monetary value and is used to process a payment instruction for a dividend payment.	PaymentInstrument9 - Optional 0..1
SavingsPlanPaymentInstrument	Instrument that has or represents monetary value and is used to process a payment instruction for a savings plan payment.	PaymentInstrument8 - Optional 0..1

ModifiedServiceLevelAgreement building block

Information related to documents to be added, deleted or updated. . Scope of the modification to be applied on an identified set of information. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ModificationScope10 recursion level 0 with max 1
class ModificationScope10{
    ModificationScopeIndication DataModification1Code
}
ModificationScope10 *-- "1..1" DocumentToSend1 : ServiceLevelAgreement
%% DocumentToSend1 recursion level 1 with max 1
class DocumentToSend1{
    Type IsoMax140Text
    MethodOfTransmission CommunicationMethod1Code
    ExtendedMethodOfTransmission IsoExtended350Code
}
DocumentToSend1 *-- "1..1" IPartyIdentification2Choice : Recipient

ModificationScope10 members

Member name	Description	Data Type / Multiplicity
ModificationScopeIndication	Specifies the type of modification to be applied on a set of information.	DataModification1Code - Required 1..1
ServiceLevelAgreement	Identification of information which is part of a service level agreement.	DocumentToSend1 - Required 1..1

Extension building block

Additional information that cannot be captured in the structured elements 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
%% Extension1 recursion level 0 with max 1
class Extension1{
    PlaceAndName IsoMax350Text
    Text IsoMax350Text
}

Extension1 members

Member name	Description	Data Type / Multiplicity
PlaceAndName	Name qualifying the information provided in the Text field, and place where this information should be inserted.	IsoMax350Text - Required 1..1
Text	Text of the extension.	IsoMax350Text - Required 1..1

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    AccountModificationInstructionV02 --|> IOuterRecord : Implements
    AccountModificationInstructionV02Document --|> IOuterDocument~AccountModificationInstructionV02~ : Implements
    class IOuterDocument~AccountModificationInstructionV02~ {
        AccountModificationInstructionV02 Message
     }

Document wrapper for serialization

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

classDiagram
    AccountModificationInstructionV02Document *-- AccountModificationInstructionV02 : 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:acmt.003.001.02">
    <AcctModInstrV02>
        <MsgId>
            <!-- MessageIdentification inner content -->
        </MsgId>
        <PrvsRef>
            <!-- PreviousReference inner content -->
        </PrvsRef>
        <InstrDtls>
            <!-- InstructionDetails inner content -->
        </InstrDtls>
        <InvstmtAcctSelctn>
            <!-- InvestmentAccountSelection inner content -->
        </InvstmtAcctSelctn>
        <ModfdInvstmtAcct>
            <!-- ModifiedInvestmentAccount inner content -->
        </ModfdInvstmtAcct>
        <ModfdAcctPties>
            <!-- ModifiedAccountParties inner content -->
        </ModfdAcctPties>
        <ModfdIntrmies>
            <!-- ModifiedIntermediaries inner content -->
        </ModfdIntrmies>
        <ModfdPlcmnt>
            <!-- ModifiedPlacement inner content -->
        </ModfdPlcmnt>
        <ModfdIsseAllcn>
            <!-- ModifiedIssueAllocation inner content -->
        </ModfdIsseAllcn>
        <ModfdSvgsInvstmtPlan>
            <!-- ModifiedSavingsInvestmentPlan inner content -->
        </ModfdSvgsInvstmtPlan>
        <ModfdWdrwlInvstmtPlan>
            <!-- ModifiedWithdrawalInvestmentPlan inner content -->
        </ModfdWdrwlInvstmtPlan>
        <ModfdCshSttlm>
            <!-- ModifiedCashSettlement inner content -->
        </ModfdCshSttlm>
        <ModfdSvcLvlAgrmt>
            <!-- ModifiedServiceLevelAgreement inner content -->
        </ModfdSvcLvlAgrmt>
        <Xtnsn>
            <!-- Extension inner content -->
        </Xtnsn>
    </AcctModInstrV02>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_sfFeRdE9Ed-BzquC8wXy7w_-1423179150"
  nextVersions="_DSWQgRGzEeKVqeHljBM1MQ"
  name="AccountModificationInstructionV02"
  definition="Scope&#xD;&#xA;An account owner, eg, and investor or its designated agent, sends the AccountModificationInstruction message to an account servicer, eg, a registrar, transfer agent or custodian bank to modify, ie, create, update or delete specific details of an existing investment fund account.&#xD;&#xA;Usage&#xD;&#xA;The AccountModificationInstruction message is used to modify the details of an existing account.&#xD;&#xA;The AccountModificationInstruction message has three specific uses:&#xD;&#xA;- to maintain/update any of the existing account details, eg, to update the address of the beneficiary or modify the preference to income from distribution to capitalisation, or,&#xD;&#xA;- to add/create specific details to the existing account when these details were not yet recorded at the time of account creation, eg, to add a second address or to establish new cash settlement standing instructions, or,&#xD;&#xA;- to delete specific account details, eg, delete cash standing instructions.&#xD;&#xA;This message cannot be used to delete an entire account, as institution specific and regulatory rules pertaining to account deletion are diverse.&#xD;&#xA;The usage of this message may be subject to service level agreement (SLA) between the counterparties.&#xD;&#xA;Execution of the AccountModificationInstruction is confirmed via an AccountDetailsConfirmation message."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlTag="AcctModInstrV02"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_sfFeRtE9Ed-BzquC8wXy7w_-1821354979"
    name="MessageIdentification"
    definition="Identifies the message."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="MsgId"
    complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
  <messageBuildingBlock
    xmi:id="_sfFeR9E9Ed-BzquC8wXy7w_-1423178721"
    name="PreviousReference"
    definition="Reference to a linked message that was previously sent."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="PrvsRef"
    complexType="_Q6vvAdp-Ed-ak6NoX_4Aeg_2101402955" />
  <messageBuildingBlock
    xmi:id="_sfFeSNE9Ed-BzquC8wXy7w_-1423178686"
    name="InstructionDetails"
    definition="Provide detailed information about the application modification instruction."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="InstrDtls"
    complexType="_REb2gdp-Ed-ak6NoX_4Aeg_691417052" />
  <messageBuildingBlock
    xmi:id="_sfFeSdE9Ed-BzquC8wXy7w_-1423178644"
    name="InvestmentAccountSelection"
    definition="Investment account selection information used to identify the account for which the information is modified."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="InvstmtAcctSelctn"
    complexType="_RRsPZ9p-Ed-ak6NoX_4Aeg_-1532088201" />
  <messageBuildingBlock
    xmi:id="_sfOoMNE9Ed-BzquC8wXy7w_-1423178591"
    name="ModifiedInvestmentAccount"
    definition="Information related to general characteristics of an investment account to be inserted, updated or deleted."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="ModfdInvstmtAcct"
    complexType="_RxlQaNp-Ed-ak6NoX_4Aeg_-196073540" />
  <messageBuildingBlock
    xmi:id="_sfOoMdE9Ed-BzquC8wXy7w_-1423178194"
    name="ModifiedAccountParties"
    definition="Information related to the account related parties (eg. account owner) to be inserted, updated or deleted."
    registrationStatus="Provisionally Registered"
    maxOccurs="10"
    minOccurs="0"
    xmlTag="ModfdAcctPties"
    complexType="_RSvYTdp-Ed-ak6NoX_4Aeg_-1282825194" />
  <messageBuildingBlock
    xmi:id="_sfOoMtE9Ed-BzquC8wXy7w_-1423178454"
    name="ModifiedIntermediaries"
    definition="Information related to intermediaries to be inserted, updated or deleted."
    registrationStatus="Provisionally Registered"
    maxOccurs="10"
    minOccurs="0"
    xmlTag="ModfdIntrmies"
    complexType="_RRZUddp-Ed-ak6NoX_4Aeg_1555387855" />
  <messageBuildingBlock
    xmi:id="_sfOoM9E9Ed-BzquC8wXy7w_-1423178159"
    name="ModifiedPlacement"
    definition="Information related to referred placement agent in the hedge fund industry to be inserted, updated or deleted."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="ModfdPlcmnt"
    complexType="_RQy3hdp-Ed-ak6NoX_4Aeg_-1121982136" />
  <messageBuildingBlock
    xmi:id="_sfOoNNE9Ed-BzquC8wXy7w_-1252846017"
    name="ModifiedIssueAllocation"
    definition="Eligibility conditions information related to new issues allocation to be inserted, updated or deleted."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="ModfdIsseAllcn"
    complexType="_RRPjftp-Ed-ak6NoX_4Aeg_-1307334017" />
  <messageBuildingBlock
    xmi:id="_sfOoNdE9Ed-BzquC8wXy7w_-1423178549"
    name="ModifiedSavingsInvestmentPlan"
    definition="Information related to a savings plan to be either inserted, updated or deleted."
    registrationStatus="Provisionally Registered"
    maxOccurs="50"
    minOccurs="0"
    xmlTag="ModfdSvgsInvstmtPlan"
    complexType="_RRZUctp-Ed-ak6NoX_4Aeg_1378854894" />
  <messageBuildingBlock
    xmi:id="_sfOoNtE9Ed-BzquC8wXy7w_-1423178506"
    name="ModifiedWithdrawalInvestmentPlan"
    definition="Information related to a withrawal plan to be either inserted, updated or deleted."
    registrationStatus="Provisionally Registered"
    maxOccurs="10"
    minOccurs="0"
    xmlTag="ModfdWdrwlInvstmtPlan"
    complexType="_RRZUctp-Ed-ak6NoX_4Aeg_1378854894" />
  <messageBuildingBlock
    xmi:id="_sfOoN9E9Ed-BzquC8wXy7w_-1423178117"
    name="ModifiedCashSettlement"
    definition="Cash settlement standing instruction associated to the investment fund transaction and to be either inserted or deleted."
    registrationStatus="Provisionally Registered"
    maxOccurs="8"
    minOccurs="0"
    xmlTag="ModfdCshSttlm"
    complexType="_RRjFddp-Ed-ak6NoX_4Aeg_355595672" />
  <messageBuildingBlock
    xmi:id="_sfYZMNE9Ed-BzquC8wXy7w_-1423178082"
    name="ModifiedServiceLevelAgreement"
    definition="Information related to documents to be added, deleted or updated.&#xA;."
    registrationStatus="Provisionally Registered"
    maxOccurs="30"
    minOccurs="0"
    xmlTag="ModfdSvcLvlAgrmt"
    complexType="_RRjFctp-Ed-ak6NoX_4Aeg_-1364149663" />
  <messageBuildingBlock
    xmi:id="_sfYZMdE9Ed-BzquC8wXy7w_-1423177731"
    name="Extension"
    definition="Additional information that cannot be captured in the structured elements and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="Xtnsn"
    complexType="_Q6vvCNp-Ed-ak6NoX_4Aeg_1503007069" />
  <messageDefinitionIdentifier
    businessArea="acmt"
    messageFunctionality="003"
    flavour="001"
    version="02" />
</messageDefinition>

ISO Building Blocks

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