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.

CLUSTER_REG_BATCH_UPDATE structure

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.

Show: