This class allows user applications to generate an alert using one of the supported external monitoring protocols. See the External() class method for details.
This class method allows a Cache application to send an alert using an external monitoring or management interface, currently either SNMP or WMI. This call may be used within the Alert Evaluation Method to forward alerts generated by the Cache Monitor, or from anywhere within the application itself to simply create an SNMP Trap or WMI Event.
The parameters used are:
type = either 'SNMP' or 'WMI' to indicate how to send the alert
appname = a brief string (MAXLEN=20) to identify the source or application creating the alert
severity = a severity code where 0=info, 1=warning, 2=severe, 3=fatal
msg = a text message (MAXLEN=1024) which describes the problem or event
For SNMP, the alert is sent using the cacheAppAlert trap, with each of the parameters attached as auxiliary objects (see the ISC-CACHE.MIB). For WMI, a Cache_Event is constructed in the same way as other Cache SNMP system traps. The severity code is included as the Severity property, and the 'appname' and 'msg' parameters are appended with a dash separator in the AdditionalInfo property.