August 20, 2012

Maximo Integration Framework first setup

This entry is part of the Maximo Integration Framework series.

If you have never used the Maximo Integration Framework you have to check the MIF configuration before being able to play with it.

System Properties

All the configuration parameters for MIF can be managed from the System Properties  application: GoTo -> System Configuration -> Platform Configuration -> System Properties. -> mxe.int.*

The most important property to check is mxe.int.globaldir. This property specifies the root folder where all the integration configuration files are located. If this value is null, the folders are created under the directory from which the application server is started, or from the current working directory of the application server (e.g. C:\IBM\WebSphere\AppServer\profiles\AppSrv01).

Other important properties that need to be set before using MIF are:
  • mxe.int.webappurl: This specifies the integration Web application URL. The syntax is http://[HOST]:[PORT]/meaweb/maximo.
  • mxe.int.admintoemail: Email address to which the integration framework sends notification of message processing errors.

JMS Queue Setup

Java Message Service (JMS) is used for routing messages from the processing layers to the external systems.
To verify that the JMS Queues are correctly installed login to the WebSphere Integrated Solutions Console and go to Resources - JMS - Queues. Ensure the following queues are enabled:
  • cqin : Continuous Inbound Queue
  • sqin : Sequential Inbound Queue
  • sqout : Sequential Outbound Queue

CRON Tasks

There are several CRON tasks that must be active. Go to System Configuration - Platform Configuration - Cron Task Setup and ensure that the following Cron Tasks are enabled:
  • JMSQSEQCONSUMERThis cron task pulls records from JMS Queues for processing.
  • IFACETABLECONSUMER to regularly poll the interface tables
  • FLATFILECONSUMER to use flat files for inbound data import
  • XMLFILECONSUMER to use XML file for inbound data import

Continuous JMS Queue Configuration

The continuous JMS queues (CQIN and CQERR) requires some additional steps that requires to rebuild and redeploy the Maximo EAR. However this step can be skipped if you are willing to use only the sequential queues.

Edit maximo/applications/maximo/mboejb/ejbmodule/meta-inf/ejb-jar.xml file and make sure the following four sections are uncommented to look like below:

<!-- MEA MDB -->
<message-driven id="MessageDriven_JMSContQueueProcessor_1">
...
</message-driven>
 
<!-- MEA MDB for error queue -->
<message-driven id="MessageDriven_JMSContQueueProcessor_2">
...
</message-driven>
 
<!-- MEA MDB -->
<container-transaction>
...
</container-transaction>
 
<!-- MEA MDB for error queue -->
<container-transaction>
...
</container-transaction>

Edit maximo/applications/maximo/mboejb/ejbmodule/meta-inf/ibm-ejb-jar-bnd.xmi and make sure the following two sections are uncommented to look like below:

<!-- MEA MDB -->
<ejbBindings xmi:type="ejbbnd:MessageDrivenBeanBinding" xmi:id="MessageDrivenBeanBinding_1" activationSpecJndiName="intjmsact">
<enterpriseBean xmi:type="ejb:MessageDriven" href="META-INF/ejb-jar.xml#MessageDriven_JMSContQueueProcessor_1"/>
</ejbBindings>
 
<!-- MEA MDB for error queue -->
<ejbBindings xmi:type="ejbbnd:MessageDrivenBeanBinding" xmi:id="MessageDrivenBeanBinding_1" activationSpecJndiName="intjmsacterr">
<enterpriseBean xmi:type="ejb:MessageDriven" href="META-INF/ejb-jar.xml#MessageDriven_JMSContQueueProcessor_2"/>
</ejbBindings>

Now rebuild and deploy the maximo.ear.

14 comments:

  1. For those of us that can't remember how to get to the WAS console, this is the default url:

    https://hostname:9043/ibm/console

    ReplyDelete
  2. Hi There,
    I am looking to know how can I export a Purchase Order from Maximo to an external system or to C Drive.

    When a Purchase Order is created or Approved I want the PO to automatically go out of Maximo.

    Would appreciate if you could help me with this?

    ReplyDelete
    Replies
    1. You should configure a Publish Channel attached to an event listener.
      Unfortunately I haven't any tutorial about this.

      Delete
  3. Hi,

    I have created an Interface on WPITEM Table. Interface is Working during Data Export and while Reordering Direct Issue and getting entries in Iface Table, but not working when modifying wpmaterial and saving Workorder.

    Not sure why its not working during Work Order save.

    Would appreciate if you could help me on this?

    ReplyDelete
  4. Hi, I am currently using Maximo Lite, which is web based. I was wondering if someone can help me how to setup the system to work.

    We have 6x different SLA's which is running on 4x different escalation.

    for some reason when I run a UAT, it collapses when responding through escalation. Help!

    Also What I wanted to find out aswell that how do you direct and receive emails from escalation, once a service request been created?

    ReplyDelete
  5. Hi, I am currently using Maximo Lite, which is web based. I was wondering if someone can help me how to setup the system to work.

    We have 6x different SLA's which is running on 4x different escalation.

    for some reason when I run a UAT, it collapses when responding through escalation. Help!

    Also What I wanted to find out aswell that how do you direct and receive emails from escalation, once a service request been created?

    ReplyDelete
  6. Hi,

    There is a question I have. I am new to maximo and if I want to use the queue sqout to send information to a Enterprise service bus where do I get the JNDI context url and username and password for that queue?

    Thanks,
    Ashwin

    ReplyDelete
  7. Hi,

    There is a question I have. I am new to maximo and if I want to use the queue sqout to send information to a Enterprise service bus where do I get the JNDI context url and username and password for that queue?

    Thanks,
    Ashwin

    ReplyDelete
  8. This comment has been removed by the author.

    ReplyDelete
  9. hi Ashwin, you do not dont need password or username.

    ReplyDelete
  10. This comment has been removed by the author.

    ReplyDelete
  11. Hi,

    I have a couple of questions
    i)What are maximo integration parameters in maximo.
    ii) RunMEAUpdate.cmd - what this commannd will do exactly when we run this from command window?

    Thanks,
    Charan

    ReplyDelete
  12. Hi,

    I have configured MIF in maximo 7.5 env properly and i am trying to exporting the data from external systems application but the message is not storing into the global directory or any where in app server also, so can you suggest me on this

    ReplyDelete