2.2.3.4 MACHINE_GROUP_MERGE_OPTIONS Enumeration

  • Article

The MACHINE_GROUP_MERGE_OPTIONS enumeration defines options for machine group modification.

 typedef [v1_enum] enum 
 {
   OVERWRITE_MG_MERGE_OPTION = 1,
   OVERRIDE_MG_MERGE_OPTION = 2,
   APPEND_MG_MERGE_OPTION = 3,
   SMART_MG_MERGE_OPTION = 4,
 } MACHINE_GROUP_MERGE_OPTIONS;

OVERWRITE_MG_MERGE_OPTION:  Specifies that the machine group configuration SHOULD be overwritten.

OVERRIDE_MG_MERGE_OPTION:  Specifies that the machine group configuration SHOULD be overridden. That means that if the same machine group name exists with the same hierarchy then this (along with its children) SHOULD be replaced by the new machine group node. Nonconflicting new nodes SHOULD be imported as is. Nonconflicting existing nodes SHOULD remain as is.

APPEND_MG_MERGE_OPTION:  Specifies that the machine group configuration SHOULD be appended. This means that nonconflicting nodes SHOULD remain as is in the existing configuration. Nonconflicting new nodes SHOULD be imported as is. Conflicting nodes SHOULD not be modified.

SMART_MG_MERGE_OPTION:  Specifies that the machine group configuration SHOULD be handled smartly. This means that nonconflicting nodes SHOULD remain as is in the existing configuration. Nonconflicting new nodes SHOULD be imported as is. Conflicting nodes SHOULD be merged in a way that the name of the imported node will be changed to avoid name conflict. The new name of the conflicting object, which is being imported, is built by appending its original name with the string "##@" followed by a number. The numbers used are in the range 1-16384 and a number, once used, is not reused until the object it was used in is either deleted or renamed. For example, an object name "ObjectName" might become "ObjectName##@1" after using this option. This range is sufficiently large and is not consumed completely because, in the WSRM configuration, the maximum allowed number of objects of each type is 128. In addition, whenever an object with a smart name is deleted or renamed, the number that was used in its name is available for reuse.