IBM Integration Bus, Version 10.0.0.3 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Applying a monitoring profile

After you create a monitoring profile, apply it by using a configurable service.

Before you begin

Create a monitoring profile by following the instructions in Creating a monitoring profile.

About this task

To apply your monitoring profile, complete the following steps.

Procedure

  1. Use the mqsicreateconfigurableservice command to create a configurable service for the monitoring profile. In the following command example, replace myBroker with the name of your integration node, and myMonitoringProfile with the name of your monitoring profile.
    mqsicreateconfigurableservice myBroker -c MonitoringProfiles 
         -o myMonitoringProfile
  2. Use the mqsichangeproperties command to associate your monitoring profile XML file with the configurable service. In the following command example, replace myBroker with the name of your integration node, myMonitoringProfile with the name of your monitoring profile, and myMonitoringProfile.xml with the name of the monitoring profile XML file.
    mqsichangeproperties myBroker -c MonitoringProfiles -o myMonitoringProfile 
         -n profileProperties -p myMonitoringProfile.xml

    Set the useParserNameInMonitoringPayload property to TRUE to force the wmb:applicationData/wmb:complexContent/wmb:elementName attribute to hold the name of the input node parser, if present.

    mqsichangeproperties myBroker -c MonitoringProfiles -o myMonitoringProfile 
         -n useParserNameInMonitoringPayload -v TRUE
  3. Use one of the following methods to apply a monitoring profile configurable service to one or more message flows.
    • Use the mqsichangeflowmonitoring command to apply a monitoring profile configurable service to one or more message flows.
      • Apply a monitoring profile to a single message flow messageflow1 in integration server IS1:
        mqsichangeflowmonitoring myBroker -e IS1 -f messageflow1 -m myMonitoringProfile
      • Apply a monitoring profile to all message flows in all integration servers:
        mqsichangeflowmonitoring myBroker -g -j -m myMonitoringProfile
      Monitoring for the flow is inactive; applying the monitoring profile does not activate it.
    • Use the BAR File editor to apply a monitoring profile configurable service to one or more message flows, by setting message flow property Monitoring Profile Name.
      1. In the IBM® Integration Toolkit, switch to the Integration Development perspective.
      2. In the Application Development view, right-click the BAR file, then click Open with > BAR Editor.
      3. Click the Manage and Configure tab.
      4. Click the message flow on which you want to set the monitoring profile configurable service. The properties that you can configure for the message flow are displayed in the Properties view.
      5. In the Monitoring Profile Name field, enter the name of a monitoring profile.
      6. Save the BAR file.
      7. Deploy the BAR file.
      Monitoring for the flow is inactive; deploying the BAR file does not activate it.
  4. Activate monitoring for the flow by using the mqsichangeflowmonitoring -c command.
    • Activate monitoring for a single message flow messageflow1 in integration server IS1:
      mqsichangeflowmonitoring myBroker -e IS1 
           -f messageflow1 -c active
    • Activate monitoring for all message flows in all integration servers:
      mqsichangeflowmonitoring myBroker -g -j -c active

What to do next

If you edit the monitoring profile, use the mqsichangeproperties command to update the configurable service to use the changed XML file. For example,
mqsichangeproperties myBroker -c MonitoringProfiles -o myMonitoringProfile 
     -n profileProperties -p myMonitoringProfile.xml

ac60383_.htm | Last updated 2015-11-26 23:59:04