Share via

2.2.1.4.4 Command Element Attributes

  • Article

The protocol defines the following attributes for the command element.

EngineURL (String): This attribute MUST be present and MUST be the identifier of the engine that is used to execute the command.

Nested (Hex String): This attribute MUST be present if this command was created as part of a creation-nested delta. A creation-nested delta is a delta that is created after another (containing) delta has been created, but before any commands in the containing delta have been executed. The commands of the creation-nested delta are included in the containing delta. These commands are marked to indicate that they were part of the creation-nested delta and may be treated differently by the engine. This attribute MUST NOT be present if this command was not created as part of a creation-nested delta. It is the creation nested sequence of the delta. This MUST be 16 characters. All commands that were part of the same creation-nested delta MUST have the same value for this attribute. If there were multiple layers of nested deltas, this MUST be the same only for commands that were part of the same innermost nested delta.

NOrd (Int): This attribute MUST be present if this command was created as part of a creation-nested delta. This attribute MUST NOT be present if this command was not created as part of a creation-nested delta. This is the nested ordinal of the command. This MUST be set to the 0-based ordinal of the command in the nested delta. If there were multiple layers of nested deltas, this MUST be the 0-based ordinal of the command in the outermost nested delta.

PurNot (Null): This attribute MUST be present if the engine that executed this command is notified when the command is purged.

urn:groove.net:CmdAsyncLocalOnly (Null): This attribute MUST be present if this command is only to be executed on the endpoint that created the delta.

urn:groove.net:CmdIdDiss (Null): This attribute MUST be present if this command is only to be executed on endpoints with the same Identity URL as the delta creator.