search cancel

How to configure Spectrum Web Service alarm subscriptions to trigger an alarm update on a Second occurrence of an alarm.

book

Article ID: 42242

calendar_today

Updated On:

Products

CA Spectrum

Issue/Introduction

How to configure Spectrum Web Service alarm subscriptions to trigger an alarm update on a Second occurrence of an alarm.

When using Web Services subscriptions, SPECTRUM will not send an alarm update on a second occurrence of an alarm by default.

Environment

Release: Any version of Spectrum
Component:

Resolution

A Spectrum Web Service subscription uses the POST HTTP method and is created with the following URL and XML Body:

http://localhost/spectrum/restful/subscription

 

<?xml version="1.0" encoding="UTF-8"?>

<rs:subscription-request
  xmlns:rs="http://www.ca.com/spectrum/restful/schema/request"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.ca.com/spectrum/restful/schema/request ../../../Rest.a/src/xsd/Request.xsd ">
 
  <!-- The client will poll for notifications, return up to 200
       models per poll and the client will poll approximately once
       every 30 seconds.  After 3 missed polls the server will
       assume the poller is no longer running and stop collecting
       data for this subscription
   -->
  <rs:push-delivery-mode>
    <rs:destination-url>http://localhost:8080/spectrum/restful/TestNotifications</rs:destination-url>
    <rs:username>Administrator</rs:username>
    <rs:password>spectrum</rs:password>
  </rs:push-delivery-mode>
 
  <rs:alarm-request>
    <rs:requested-attribute id="0x1006e" /> <!-- Model Name -->
    <rs:requested-attribute id="0x11f53" /> <!-- Model Handle -->
    <rs:requested-attribute id="0x11f56" /> <!-- Alarm Severity -->
    <rs:requested-attribute id="0x11f4e" /> <!-- Alarm Creation Date -->
    <rs:requested-attribute id="0x12b4c" /> <!-- Alarm Title -->
    <rs:requested-attribute id="0x11fc5" />  <!-- Alarm Occurrences -->
    <rs:requested-attribute id="0x1296e" /> <!-- Originating Event text -->
  </rs:alarm-request>
 
</rs:subscription-request>

 

To configure the XML body to send alarm updates, the "notify-of-changes" attribute needs to be added to the requested-attribute element for the Alarm Occurrences attribute (0x11f5c). The updated requested-attribute element should look like the following entry:

 

<rs:requested-attribute id="0x11fc5" notify-of-changes="true" />  <!-- Alarm Occurrences -->

 

After making the above change, the push subscription will send alarm updates to the stdout.log file when the alarm occurrences attribute is updated.