Existing IBM Cognos BI connection

You can use the wbmSetCognosDispatcher command to connect the IBM® Business Monitor server to an existing IBM Cognos® Business Intelligence service (one that was not installed by IBM Business Monitor). You can also use this command to modify the address of a locally installed IBM Cognos BI service.

Purpose

The wbmSetCognosDispatcher command sets the IBM Cognos BI address for use by the IBM Business Monitor server when you are using an existing IBM Cognos BI service.

Use this command to set the address of a remote or an existing IBM Cognos BI service, or to modify the address of a locally installed IBM Cognos BI service. To allow for single sign-on between IBM Cognos BI and IBM Business Monitor interactions, the IBM Cognos BI address should end with /ext (the full IBM Cognos BI external dispatcher address).

After changing the address, restart all IBM Business Monitor servers.

Examples

The following example uses Jacl to set the address of an existing IBM Cognos BI service.

$AdminTask wbmSetCognosDispatcher {-dispURI http://somehost.com:port_number/p2pd/servlet/dispatch/ext -adminUserName admin -adminPassword password}

The following example uses Jython to set the address of an existing Cognos service.

AdminTask.wbmSetCognosDispatcher('[-dispURI http://somehost.com:port_number/p2pd/servlet/dispatch/ext -adminUserName admin -adminPassword password]')

Parameters

The wbmSetCognosDispatcher command accepts the parameters listed in the following table.

Parameter and value	Required?	Description	Comments
-dispURI `address`	Required	The address of the IBM Cognos BI service.	This address is the "External dispatcher URI" address from the IBM Cognos BI configuration environment settings.
-adminUserName `admin_user_name`	Required	The user name of the IBM Cognos BI administrator.
-adminPassword `admin_password`	Required	The password of the IBM Cognos BI administrator.	To change the password later, use the wbmSetCognosAdminUser command or change the security authorization alias.