Enabling job, SMTP, and task queue metrics

By default, only the queue length metric for job, task, and SMTP queue metrics is enabled. Other metrics are also available for each but are set to zero and do not appear in the user interface unless you enable them.
  • Time in queue high water mark
  • Time in queue low water mark
  • Time in queue
  • Number of queue requests
  • Queue length high water mark
  • Queue length low water mark

For more information about these metrics, see System Performance Metrics. Note that enabling these settings may affect performance.

Before you begin

You must have the required permissions to access IBM Cognos Administration functionality. See Secured Functions and Features.

Procedure

  1. In IBM Cognos Administration, on the Status tab, click System.
  2. From the System Actions menu, click Set Properties.
  3. Click the Settings tab.
  4. For the Environment category, next to Advanced settings, click the Edit link.
  5. If it appears, select the Override the settings acquired from the parent entry check box. Otherwise, proceed to the next step.
  6. In the Parameter column, type the following settings: enable.tide.metrics.smtpqueue, enable.tide.metrics.jobqueue, and enable.tide.metrics.taskqueue.
  7. Beside each parameter, in the Value column, type True to enable the metric.
  8. Click OK.
  9. Open the c10_location/webapps/p2pd/WEB-INF/classes/iManage-metadata.xml file in an editor.

    Ensure that your editor supports saving files in UTF-8 format.

    For a distributed install, you must edit the iManage-metadata.xml file on every computer, otherwise, the global metrics may display initially but not persist after navigating away from the page.

  10. Uncomment the sections that begin with <!-- These metrics have been explicitly disabled. Please consult documentation on how to enable them. -->
  11. Save the file.
  12. Using IBM Cognos Configuration, stop and then restart IBM Cognos software.

    For information about stopping IBM Cognos software, see the IBM Cognos Business Intelligence Installation and Configuration Guide.