<- Go to ProcessActions  ->

1 Definition 2 Protocollo 3 Syntax 4 Semantics

1 Definition

The Action of a Process in the Universe (U-Process) requesting that an Import Service:

  1. Send a Message to a Process in the M-Instance (M-Process) on its own initiative or upon request of the M-Process.
  2. Grant Rights to the Message to the M-Process in the M-Instance, based on Rights requested by the U-Process.

If the request is accepted, the Process in the M-Instance receives the Message and is granted the Rights to it requested by the M-Process.

2 Functional Requirements

  1. U-Process sends “UM-Send PA Request including Message, Rights (Status=Model), and M-ProcessID” to UM-Send Service.
    1. If UM-Send Service is free service, goto UM-Send.
    2. If UM-Send Service is pay service:
      1. U-Process sends “UM-SendPA Request including Service Pricing Model (Status=Model)” to UM-Send Service.
      2. UM-Send Service sends “UM-Send PA Response”:
        1. If “UM-Send PA Response includes Status=Err”, goto End
        2. If “UM-Send PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model)”, User:
          1. Transacts “Value included in Transaction”.
          2. Sends “UM-Send PA Request including Service Pricing Model (Status=Model) with Transaction (Status=Final)” to UM-Send Service.
  2. UM-Send: UM-Send Service
    1. Sends “Message and Rights” to ProcessID.
    2. Sends “UM-Send PA Response” including
      1. “Ack”.
      2. “Service Pricing Model (Status=Final)”, if UM-Send Service is a pay service.
  3. End

The protocol described using Workflow Description Language (WDL) is available at this link:

https://schemas.mpai.community/MMM4/V2.2/wdl/UMSend.wdl

3 Syntax

The structure of the input and output messages, using JavaScript Object Notation (JSON)  is available at this link:

https://schemas.mpai.community/MMM4/V2.2/actions/UMSendPA.json

4 Semantics

Label Description
Header UM-Send Process Action Header – Standard “USP-1SP-Vx.y”
MInstanceID Identifier of M-Instance.
UEnvironmentID Identifier of U-Environment.
UMSendPAID Identifier of this PA Instance.
UMSendPATime Creation time of this PA Instance.
MUMSendPAData Data included in this PA Instance.
– Time Time of PA Request emission and execution, or PA Response emission.
– RQ-Complements Complements in the PA Request.
  – Nil Message Message to be MU-Sent to M-Process.
  – To ProcessID M-Process where the Item is to be UM-Sent.
  – With Rights Requested Rights to be granted to the M-Process.
  – With SPM Service Pricing Model, if UM-Send is a pay service.
– D-Complements Complements in the PA Response.
  – With Rights Rights based on requested Rights if PA Request is accepted.
  – With PAStatus Status of PA Request.
    – Ack If PA Request could be performed.
    – Err If PA Request could not be performed.
      – FaultyPA Faulty PA Request.
      – IncID Incorrect ID.
      – InsRights Insufficient Rights.
      – InsValue Insufficient Value in Wallet.
DataXMData Identity, provenance, authorised usage, source, type, governance context, security, legality, and annotation of exchanged data.
 DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->