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 220.127.116.11 and later
Oracle Network Management for Utilities - DMS - Version 18.104.22.168 and later
Information in this document applies to any platform.
**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 22.214.171.124 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:
- Open the event in Event Details.
- Press the Switching/Outage Correction button to create a new switch plan and form a Forced association.
- 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.
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