2.2.3.17 CLUSTER_REG_BATCH_UPDATE

The CLUSTER_REG_BATCH_UPDATE structure is a self-describing data structure that contains a sequence of command blocks that describes one or more modifications or read operations to be performed on the cluster registry. A CLUSTER_REG_BATCH_UPDATE structure MUST consist of the following elements:

• A version number.

• One or more batch update command blocks describing a set of modifications to the registry or read operations from the registry.

  Each batch update command block, in turn, MUST consist of the following elements:

  • A command type.

  • The name of a key or value.

  • Any optional data required for the command.

Conceptually, a CLUSTER_REG_BATCH_UPDATE structure can be illustrated as in the following diagram.

Figure 2: CLUSTER_REG_BATCH_UPDATE structure

CLUSTER_REG_BATCH_UPDATE is a custom-marshaled structure that has fields as follows.

0	1	2	3	4	5	6	7	8	9	1 0	1	2	3	4	5	6	7	8	9	2 0	1	2	3	4	5	6	7	8	9	3 0	1
VersionNumber
BatchUpdateCommand (variable)
...

VersionNumber (4 bytes): A 32-bit integer that indicates the version of the batch update command block. This value MUST be set to one.

BatchUpdateCommand (variable): One or more instances of a variable-length data structure that describes a set of modifications to be made to the cluster registry.