db2UpdateHealthNotificationList API - Update the list of contacts to whom health alert notifications can be sent

Updates the contact list for notification about health alerts issued by an instance.

Authorization

One of the following authorities:
  • SYSADM
  • SYSCTRL
  • SYSMAINT

Required connection

Instance. If there is no instance attachment, a default instance attachment is created.

API include file

db2ApiDf.h

API and data structure syntax

SQL_API_RC SQL_API_FN
  db2UpdateHealthNotificationList (
   db2Uint32 versionNumber,
   void * pParmStruct,
   struct sqlca * pSqlca);

typedef SQL_STRUCTURE db2UpdateHealthNotificationListData
{
   db2Uint32 iNumUpdates;
   struct db2HealthNotificationListUpdate *piUpdates;
} db2UpdateHealthNotificationListData;

typedef SQL_STRUCTURE db2HealthNotificationListUpdate
{
   db2Uint32 iUpdateType;
   struct db2ContactTypeData *piContact;
} db2HealthNotificationListUpdate;

typedef SQL_STRUCTURE db2ContactTypeData
{
   db2Uint32 contactType;
   char *pName;
} db2ContactTypeData;

db2UpdateHealthNotificationList API parameters

versionNumber
Input. Specifies the version and release level of the structure passed as the second parameter pParmStruct.
pParmStruct
Input. A pointer to the db2UpdateHealthNotificationListData structure.
pSqlca
Output. A pointer to the sqlca structure.

db2UpdateHealthNotificationListData data structure parameters

iNumUpdates
Input. The number of updates.
piUpdates
Input. A pointer to the db2HealthNotificationListUpdate structure.

db2HealthNotificationListUpdate data structure parameters

iUpdateType
Input. Specifies the type of update. Valid values are:
  • DB2HEALTHNOTIFICATIONLIST_ADD
  • DB2HEALTHNOTIFICATIONLIST_DROP
piContact
Input. A pointer to the db2ContactTypeData structure.

db2ContactTypeData data structure parameters

contactType
Specifies the type of contact. Valid values are:
  • DB2CONTACT_SINGLE
  • DB2CONTACT_GROUP
pName
The contact group name, or the contact name if contactType is set to DB2CONTACT_SINGLE.