How to Complete a Stuck Event or Remove an Event/Switch Sheet Forced Association With the jms_api Program (Doc ID 1271873.1)

Last updated on JULY 28, 2017

Applies to:

Oracle Utilities Network Management System - Version 1.10.0.4 and later
Oracle Network Management for Utilities - DMS - Version 1.11.0.4 and later
Information in this document applies to any platform.

Goal

The purpose of this document is to detail the options available with the jms_api utility/tool.  This is used to break the association between a forced event and a switch plan when the association was incorrectly made or to fix a job that is in a state that can not be fixed through the normal user interface.  For example, a user may be unable to restore an active event due to GIS data issue where the phases are incorrect.

jms_api updates the event in JMService memory and the database using JMService APIs so that services do not need to be restarted.
The main concern with it would be if an event you did not mean to complete was passed in.

See also <Document:602782.1> "Unable To Complete Events"

Example of how the switch plan issue can occur:

  1. Open the event in Event Details.
  2. Press the Switching/Outage Correction button to create a new switch plan and form a Forced association.
  3. It is possible that a user created this new sheet and association incorrectly but there is no way to remove the event from the switch plan.

 

Under no circumstances will development support any configured functionality around this utility.  It is only to be used, under GCS direction, to correct a current operator mistake.

Solution

Sign In with your My Oracle Support account

Don't have a My Oracle Support account? Click to get started

My Oracle Support provides customers with access to over a
Million Knowledge Articles and hundreds of Community platforms