Group Services Programming Guide and Reference

Multiple ha_gs_special_block_t elements

It is possible for a single subscription notification to contain adapters which were deconfigured and which are mapped with multiple alias addresses. In this case, both of the above types of special data will be included. In this situation, the following conditions hold:

• HA_GS_SUBSCRIPTION_SPECIAL_DATA will be OR'ed into the gs_subscription_type field in the subscription notification.
• The gs_subscription_special_data field in the subscription notification will point to an ha_gs_special_data block.
  • The gs_special_block_count field will contain the count of ha_gs_special_block_t elements, which in this case may be two (2) or three (3).
  • The gs_special_block_flags field will contain a value of the OR'ed together flags HA_GS_CURRENT_ADAPTER_ALIAS_ARRAY, HA_GS_CHANGING_ADAPTER_ALIAS_ARRAY, and HA_GS_ADAPTER_DEATH_ARRAY.
  • The gs_subscription_special_data field in the subscription notification will point to the first ha_gs_special_block_t.
    • It is unpredictable which ha_gs_special_block_t will be first in the list.
    • The gs_next_special_block of each ha_gs_special_block_t will point to the next ha_gs_special_block_t.
    • The gs_next_special_block of the last ha_gs_special_block_t will be NULL.