My Oracle Support Banner

How to Complete a Stuck Event or Remove an Event/Switch Sheet Forced Association with the jms_api/ jms-api Tool (Doc ID 1271873.1)

Last updated on JUNE 13, 2023

Applies to:

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


**Examples provided in this article do not represent real life personal/confidential information**

**Disclaimer:** This KM article may include the following abbreviations:

DMS - Oracle Network Management for Utilities
NMS - Oracle Network Management System
JMS - Java Messaging Services
API - Application Programming Interface
GIS - Geographic Information Systems
RDO - Real Device Outage

The purpose of this document is to detail the options available with the jms_api utility/tool.   This is jms-api starting with the NMS release.  See <Document 2750816.1>" for other tool name changes."

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 JMS memory and the database using JMS 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.


To view full details, sign in with your My Oracle Support account.

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

In this Document

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.