Description: The A.I.M.O.S. SNMP Agent sends alarm notifications to as many alarm recipients as desired.

All notifications contains the following objects: . sysUpTime duration of time the SNMP Agent is running . snmpTrapOID notification OID (note: if aimosPhoneBookInterfaceType is set to ifAimosObsolete(4) aimosTrapOID is used instead) . aimosOMCSDN name of the OMC / SNMP Agent . aimosOrgID the SNMP Managers organisation ID . aimosAlarmTrapID trap number (unambiguous from SNMP Agents view) . aimosAlarmTrapNotificationID trap number (contiguous enumerated from SNMP Managers view) . aimosAlarmListID identifies an alarm list entry . aimosAlarmListAlarmEventID contiguously enumerates alarm events, change and clear alarms has the same event ID as the raise

aimosAgentAnnouncement notifications have afterwards the following object: . aimosAgentState indicates of what the A.I.M.O.S. SNMP Agent is about to do

aimosAlarmNew, aimosAlarmChanged and aimosAlarmCleared notifications have afterwards the following objects: . aimosAlarmListAlarmID kind of alarm . aimosAlarmListEventType . aimosAlarmListEventTime . aimosAlarmListProbableCause compliant to X.733 with additions . aimosAlarmListSpecificProblem . aimosAlarmListSeverity compliant to X.733 with one addition . aimosAlarmListTrendIndication . aimosAlarmListAdditionalText . aimosAlarmListSDN unique name of the affected device . aimosAlarmListCustomerMasterInfo custom name for the affected Master Unit . aimosAlarmListCustomerSubRackInfo custom name for the affected Sub Rack Master Unit . aimosAlarmListCustomerCableInfo custom names of the cables used in the interconnection between Master & Remote Unit . aimosAlarmListCustomerRemoteInfo custom name for the affected Remote Unit

aimosAlarmCleared notifications have afterwards the following object: . aimosAlarmListClearReason the reason why alarm has gone

All alarms end with the following objects: . aimosAcknowledgementOID acknowledgement OID value . snmpTrapEnterprise enterprise OID value (note: if aimosPhoneBookInterfaceType is set to ifAimosObsolete(4) aimosTrapEnterprise is used instead)

If aimosPhoneBookInterfaceType is on its default value ifMIBDefault(0), then each of the object mentioned before has an appropriate instance identifier. That is, aimosOrgID has the OrgID itself as instance identifier and, for example, aimosAlarmListID has aimosOrgID and aimosAlarmListID as instance identifier, since these objects are defined in that manner.

If aimosPhoneBookInterfaceType is set to ifAimosObsolete(4), then each object in the alarm notification has an instance identifier of zero. The only exception from this rule is aimosTrapOID. This object has no instance identifier.

After having emitted an alarm notification with the objects mentioned before included, the A.I.M.O.S. SNMP Agent expects an acknowledgement within a certain period of time. This interval can be specified in aimosAlarmAckExpectInterval.

Each SNMP Manager must confirm the receipt of the notification unless its inability of acknowledgements is indicated by appropriate settings made to aimosPhoneBookAckCapability. The acknowledgement will be done by setting aimosAlarmTrapAcknowledgementState to acknowledged(2). This OID is indexed by aimosOrgID, aimosAlarmTrapID and aimosAlarmListID. The notification makes the OID required for acknowledgement (object including instance identifiers) available in the aimosAcknowledgementOID.

If a set request is made to aimosAlarmTrapAcknowledgementState, additionally aimosAlarmTrapAcknowledgementUser is set to the current user and aimosAlarmTrapAcknowledgementTime is set to the time of the acknowledgement.

If an expected acknowledgement is missed by the A.I.M.O.S. SNMP Agent it will send the alarm repeatedly again until the alarm is acknowledged by the affected SNMP Manager. The objects contents of a re-sending alarm notification are identical to the preceding ones, especially the counter values (aimosAlarmTrapID, aimosAlarmTrapNotificationID, aimosAlarmListID, aimosAlarmListAlarmEventID).

Each SNMP Manager may examine the incoming alarms notification ID. If it is not incremented by one since the last notification, it is an indication for missing notifications. The SNMP manager should wait a while until the SnMP Agent has resend the missing notification(s) unless acknowledgement is deactivated (aimosPhoneBookAckCapability is false(0)). In the latter case the SNMP Manager should synchronize its alarm table with the SNMP Agent ones by setting aimosPhoneBookAlarmListResync to start(5).