BAROC Send Event

brcSendEvent

brcSendEvent (cell, message, severity, viewer name)

Sends an event to a BAROC cell. A connection to the cell must have been established using the brcConnect function. The following slot values are populated in the event:

  • msg
  • mc_host
  • mc_host_address
  • mc_tool_address
  • mc_tool_uri
  • mc_tool_time
  • mc_tool_rule
  • mc_took_key
  • mc_incident_time
  • mc_incident_report_time
  • mc_ueid
  • mc_priority
  • severity

Slot values may be enriched or overridden within the rule that sends the event.

If the message was previously sent, the event is updated with the modified slot values.

Parameters:

cell - the name of the cell

message - the message in MVCA format

severity - the severity of the message. Valid choices are

'CRITICAL', 'MAJOR', 'MINOR', 'WARNING', 'INFO', 'OK', 'UNKNOWN' viewer name - the name of the viewer if a user uses BPPM to connect back to MVCA

Returns:

Returns true if the connection was successful, false if not.

Example

trigger on message.COLOR == WHITE
user = 'user'
cell = 'BMC2'
//
// Send the event. A call to brcConnect should have been done previously.
//
status = brcSendEvent(cell, message, 'CRITICAL', 'ZOS1')
if status then
monitorMessage(message, closeEvent)
else
error = brcGetLastError()
errorMsg = createMessage('Error sending BAROC message to '
& cell & ', error: ' & error)
sendMessageToAllViewers(errorMsg)
endif
//
// Function: closeEvent //
// This function gets called when the message turns color or rolls off
// the console.
// function closeEvent(message, reason)
{
brcCloseEvent(message)
}

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*