mqsireportbluemixreporting command

Use the mqsireportbluemixreporting command to report the current status and configuration of the IBM® Cloud reporting function, for a specified integration server or for all integration servers on the specified integration node.

Purpose

You can use the mqsireportbluemixreporting command to display the current status and configuration of the IBM Cloud reporting function, either for a specific integration server or for all integration servers on the specified integration node.

The mqsireportbluemixreporting command displays the current reporting status and configuration, including the parameters that have been set for reporting startup and usage information to the IBM Cloud Product Insights service, and parameters that have been set for sending logging and statistics data to the IBM Cloud Log Analysis service.

IBM Cloud Product Insights is a service that is available on IBM Cloud. Ensure that your version (and fix-pack level) of IBM Integration Bus is compatible with the level of the service that you are using, before you enable IBM Integration Bus to connect to it.

The output of the mqsireportbluemixreporting command shows the values set by the mqsichangebluemixreporting command, and includes the following information:
  • The current state (active or inactive) for the reporting of startup and usage information to a Product Insights service
  • The API host for the startup and usage service in Product Insights
  • The API key for the startup and usage service in Product Insights
  • The URL of the HTTP proxy server (if any) through which the connection is made to the startup and usage service in Product Insights.
  • The optional group name for the startup and usage service in Product Insights
  • The reporting interval for the usage service in Product Insights, in minutes
  • The current state (active or inactive) for the reporting of logging and statistics data to the Log Analysis service
  • The host name and port number for the logging and statistics data services
  • The IBM Cloud space identifier for logging and statistics services
  • The tenant logging token for logging and statistics services
  • The interval, in seconds, for sending information to the logging and statistics service
  • If the integration server has been configured with the option to provide the user's IBM Cloud details, these details (with the exception of the password) are reported.

Syntax

Read syntax diagramSkip visual syntax diagrammqsireportbluemixreportingintegrationNodeName -e integrationServerName -g 

Parameters

integrationNodeName
(Required) The name of the integration node.
-e integrationServerName
(Optional) Specifies a single integration server for which the status and configuration information will be displayed. If you specify this parameter, you cannot specify the -g parameter.
-g
(Optional) Specifies that the status and configuration information will be displayed for all integration servers in the specified integration node. If you set this parameter, you cannot specify an integration server name by using the -e parameter.

If you specify neither the -e nor -g parameter, the -g parameter is set by default.

Authorization

The command must be run by a host operating system user ID that is a member of the mqbrkrs group.

Examples

Always enter the command on a single line; in some examples, line breaks have been added to enhance readability.

In the following example, status and configuration information is returned for all integration servers in the integration node called myIntegrationNode1 (in this case, there is only a single integration server called is01):
mqsireportbluemixreporting myIntegrationNode1
The output from the command reports the following information:
  • API host
  • API key
  • Report interval (in minutes and seconds)
  • Group name
  • Proxy
  • Host name
  • Port number
  • Tenant space ID
  • Tenant log token
  • Region
  • Organization
  • Space
  • User
In the following example, status and configuration information is returned for integration server is02 in the integration node called myIntegrationNode1:
mqsireportbluemixreporting myIntegrationNode1 -e is02
The output from the command, which in this case includes the name of an HTTP proxy server, includes the following information:
  • API host
  • API key
  • Report interval (in minutes)
  • Group name
  • Proxy