Introduction
This document describes the Generic IBM MQ Mobile Adapter that can be used by Oracle Utilities Network Management System customers to exchange data with external mobile data systems using IBM MQ messages formatted using XML. The reader is assumed to have a working-level knowledge of Oracle Utilities Network Management System mobile data systems, XML, and IBM MQ technologies.
Overview Description
Integration of Oracle Utilities Network Management System to a mobile data system involves the implementation of an adapter process, which exchanges messages with a mobile data system (MDS). The contents of messages sent to the MDS are generated from data obtained from the Oracle Utilities Network Management System services, transformed so that they are suitable for the MDS, and formatted into XML. The contents of messages received from the MDS are extracted from XML, transformed so that they are suitable for Oracle Utilities Network Management System, and sent to the Oracle Utilities Network Management System services.
The current implementation of the adapter supports the exchange of the following types of messages:
Messages sent to the MDS
MDS order creation, update and cancellation messages, triggered by Event updates from Oracle Utilities Network Management System.
Interface communication status verification messages, triggered on a periodic basis.
Messages received from the MDS
MDS order update and completion messages, which trigger updates to the corresponding Oracle Utilities Network Management System events.
Crew log on, update, and log off messages, which trigger Oracle Utilities Network Management System crew creation, update, and de-activation.
Crew assignment creation, update, and deletion messages, which trigger status changes to the corresponding Oracle Utilities Network Management System crews and events.
Interface communication status verification messages, which trigger changes to the interface status.
Terminology
The following terms and acronyms are relevant to this specification
InterSys
The middleware infrastructure that supports Oracle Utilities Network Management System
MDS
A Mobile Data System that exchanges data with field crews' mobile data terminals.
MDS Order
A document or unit of work on the MDS. Also known under different names (for example, "Job").
Event
Oracle Utilities Network Management System outage and non-outage events are generated by SRS based on customer calls and changes to the Oracle Utilities Network Management System topology model.
SRS
Service Reliability System, the service within InterSys that analyzes and manages outages.
IBM MQ
A queue-based messaging system developed by IBM.
XML
Extensible Markup Language
DML
Dynamic Message Language. This language is used to configure the adapter.