Functional Description
The purpose of this section is to describe the basic functional capabilities of the Generic IBM MQ Mobile Adapter, as applied to the integration of Oracle Utilities Network Management System with mobile data systems (MDS). While a high-level graphical description is provided here, detailed descriptions are provided in subsequent sections.
Functional Requirements
The key requirements for the current implementation of the Generic IBM MQ Mobile Adapter are:
• Generation of MDS orders based on Oracle Utilities Network Management System events.
• Updates of MDS orders based on changes to Oracle Utilities Network Management System events.
• Updates to Oracle Utilities Network Management System events based on updates to MDS orders.
• Creation and update of crew information based on changes to crews on the MDS.
• The ability to map multiple events to a single MDS order, based on event relationships in Oracle Utilities Network Management System. This allows groups of events to be viewed as single units of work on the MDS. An example of this is multiple events involved in a set of partial restoration steps.
• The capability to send individual field changes to an order when events change so that there is a minimum usage of the limited bandwidth available to transmit data to and from field crews. This requires storing the data last sent to the MDS so that change detection can be used. This data is saved to the database, so that change detection can be used over an adapter shutdown and restart.
• The ability of data from various Oracle Utilities Network Management System sources to be transformed and combined for transmission to the MDS. The data sources include the Oracle Utilities Network Management System services and the database. Data from the Oracle Utilities Network Management System services will be obtained from both asynchronous notification messages and the use of API calls.
• The ability of data from the MDS to be transformed and sent to various Oracle Utilities Network Management System destinations, using database updates and API calls.
Hardware and Software Requirements
The purpose of this section is to describe the environment relevant to this interface.
Oracle Utilities Network Management System Environment
The Oracle Utilities Network Management System environment consists of a number of servers that are interconnected using the InterSys messaging system.
Adapter Server
The Generic IBM MQ Mobile Adapter environment may be resident on the same servers as the Oracle Utilities Network Management System services, or it may be implemented on a separate server. Specifications for a stand-alone adapter server:
• All Oracle Utilities Network Management System Unix and Linux operating systems are supported
• IBM MQ messaging product
Notes:
• Queues may reside on a remote machine.
• See the Oracle Utilities Network Management System Licensing Information User Manual for the IBM MQ version requirements.
• A LAN connection to the Oracle Utilities Network Management System server must be available
• Isis must be installed and configured
Oracle Utilities Network Management System Server
The Oracle Utilities Network Management System server environment is typically deployed on one or more Unix or Linux servers configured with the following:
• Unix/Linux operating system
• Oracle RDBMS with Oracle Utilities Network Management System model
• Oracle Utilities Network Management System service processes
• LAN connection to adapter server
• Message queues to be used by the MQ/XML Adapter appropriately declared in the defined database configuration table.
• Isis
External System Environment
The external system is any system that can exchange information with Oracle Utilities Network Management System through an adapter. The environment of the external system has the following capabilities:
• Any operating system which supports IBM MQ messaging
• IBM MQ messaging product
• Applications that can request or publish information in a manner which is either directly or indirectly (through a translator) compliant with the XML specifications contained within this document via queues
• Queues must be pre‑configured
• IBM MQ Integrator can be used as needed for routing and translation.
Required Installed Software
The following lists the required software that needs to be installed prior to any configuration of the Oracle Utilities Network Management System Generic IBM MQ Mobile Adapter.
• IBM MQ
• Isis (included in the base Oracle Utilities Network Management System installation)
Note: Isis is the messaging backbone for Oracle Utilities Network Management System and will already be present on any Network Management System servers. If the Generic IBM MQ Mobile Adapter is to be executed on a separate server than the Network Management System, then that server must also have Isis installed and running. Every server installation must be running the same version of Isis. The CMM_CELL environment variable must be set the same on any servers which are to communicate through Isis.