System Service Test

The System Service is used to obtain application-wide, IBM® Cognos® Analytics configuration parameters. This service also provides methods that can be used to normalize and validate locale strings, as well as to map locale strings to locales supported by your application. If this service is unavailable or fails to service requests, then, configuration parameters could not be obtained. as well as locale strings could not be validated by the application. This will result in an outdated application. To ensure that the configuration parameters are obtained periodically, it is essential for the administrators to keep a vigil on the System Service. The System Service test helps administrators in this regard!

This test monitors the System Service and reports the current status of the service. This test also throws light on the number of system service requests that were processed and the count of requests that were processed successfully.

Target of the test : An IBM Cognos Business Intelligence

Agent deploying the test : An internal/remote agent

Outputs of the test : One set of results for the target IBM Cognos Business Intelligence suite being monitored

Configurable parameters for the test



Test period

How often should the test be executed .


The host for which the test is to be configured.


The port number at which the specified host listens. By default, this is NULL.

JMX Remote Port

Here, specify the port at which the JMX listens for requests from remote hosts. Ensure that you specify the same port that you configured in the file available in the <IBM_COGNOS_BI_HOME>\webapps\p2pd\WEB-INF folder used by the target application server.

JMX User, JMX Password, and Confirm Password

By default, JMX requires no authentication or security (SSL). This is why, by default, the JMX User and JMX Password parameters are set to none. If JMX requires authentication only (but no security), then ensure that the JMX User and JMX Password parameters are configured with the credentials of an authorized user with access to JMX using the JMX Remote Port. Confirm the password by retyping it in the Confirm Password text box.

Measurements made by the test
Measurement Description Measurement Unit Interpretation


Indicates the current status of the service.


The values that this measure can report and their corresponding numeric values are listed in the table below:

Measure Value Numeric Value
Available 100
Unavailable 0


By default, this measure reports the Measure Values listed in the table above to indicate the current status of the service. In the graph of this measure however, the same is represented using the numeric equivalents only i.e., 0 or 100.

Processed requests

Indicates the number of requests that were processed during the last measurement period.



Successful requests per second

Indicates the rate at which the requests were processed successfully during the last measurement period.