Go to PGM-AUA V1.0 Data Types

Definition
Functional Requirements
Syntax
Semantics
Conformance Testing
Performance Assessment

Definition

AUS Directive (PGM‑AUSD) is a Directive issued by A‑User Control to A‑User Storage that establishes, for an A‑User session, the storage scopes, the retention and lifecycle policy, and the access rights A‑User Storage enforces on the read and write operations performed by AUS‑accessing AIMs, together with associated metadata for identification, exchange, and description.

Functional Requirements

  1. Directive Identification and Traceability: The directive shall include a unique identifier (AUSDirectiveID) and a timestamp (AUSDirectiveTime) to ensure traceability and correlation with execution status.
  2. Environment Identification: The directive shall include identifiers for the M-Instance (MInstance) and U-Environment (UEnvironment) in which the directive applies.
  3. Session Identification: The directive shall include a SessionID identifying the session whose storage this directive governs.
  4. Lifecycle Control: The directive shall specify the storage lifecycle command (open, close, archive session content to historical scope, delete) and the retention policy applied to stored content.
  5. Scope Configuration: The directive shall specify which storage scopes (session, historical) are active or available for the session.
  6. Access Rights: The directive shall specify the read and write authorisations A-User Storage enforces on incoming operations, in particular whether historical-scope reads are permitted and whether writes to the active scope are permitted; session-scope reads are implicit and require no authorisation.
  7. Data Exchange Metadata: The directive shall include DataXMData to provide standardised metadata supporting interoperability, traceability, and data exchange control.
  8. Descriptive Metadata: The directive may include DescrMetadata to provide additional human-readable context.

Syntax

https://schemas.mpai.community/PGM1/V1.0/data/AUSDirective.json

Semantics

Label Description
Header AUS Directive header identifier. Value: “PGM-AUSD-V1.0”.
MInstance Identifier of the M-Instance in which the directive applies.
UEnvironment Identifier of the U-Environment associated with the directive.
AUSDirectiveID Unique identifier for this AUS Directive instance.
AUSDirectiveTime Timestamp indicating when the directive was produced.
SessionID Identifier of the A-User session whose storage this directive governs.
Lifecycle Container specifying the storage lifecycle command and retention policy.
– Command Storage lifecycle command: Open | Close | Archive | Delete.
– RetentionPolicy Retention policy applied to stored content for each scope.
StorageScopes Container specifying the storage scopes active or available for the session.
– SessionScope Whether session-scope storage is active: enabled | disabled.
– HistoricalScope Whether historical-scope storage is available: enabled | disabled.
AccessRights Container specifying the access rights A-User Storage enforces on incoming operations.
– HistoricalReadAuthorisation Whether AUS-accessing AIMs are permitted to read historical-scope content: granted | denied.
– WriteAuthorisation Whether write operations to the active scope are permitted: granted | denied.
DataXMData Data Exchange Metadata compliant with MPAI-PTF V1.0.
DescrMetadata Optional descriptive metadata providing additional human-readable context.

Conformance Testing

Not part of this specification.

Performance Assessment

Not part of this specification.

Go to PGM-AUA V1.0 Data Types