IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Create links to the Managing Server Visualization Engine using the Link Wizard

Throughout the Tivoli Enterprise Portal, you can use the Link Wizard to manually create links to the Managing Server Visualization Engine.


Create links

You can access the Link Wizard feature from other views and workspaces in the Tivoli Enterprise Portal.

  1. To access the Link Wizard, from any of the tables or views, right click the link icon and click Link Wizard.

  2. Follow the steps in the wizard to do one of the following actions:

    • Create a new link.

    • Modify an existing link.

    • Delete one or more links.

  3. Type the name and description of the link.

  4. Choose one to the following options with the aid of the descriptions in the Link Wizard.

    • Dynamic

    • Absolute

    • Relative

  5. Choose the option you want to use. Follow the instructions in the help within the application until you get to the Workspace Link Wizard Parameters page.


Add parameters to the Link Wizard

When you get to the Workspace Link Wizard Parameters page in the Link Wizard you will need to manually add these two symbols VEHOSTPORT and VEPATH and add information to these parameters. There are two predefined workspaces which have an embedded browser as its only view.

  1. To add Symbols to the Link Wizard. Click Symbol and type VEHOSTPORT.

  2. Click OK to add the Symbol.

  3. To add an expression select VEHOSTPORT click Modify Expression.
  4. Basic Setup: In the text field, type the expression you want to add. The value for the VEHOSTPORT is <your ve host>:<your ve port>. For example, if in your environment, the Managing Server Visualization Engine is installed on host1, with port 9080, then the VEHOSTPORT value is: “host1:9080”.

    • Double quotation marks are required in the expression.

    • If your Managing Server Visualization Engine host or port information changes, then you need to update the link you defined and correct the VEHOSTPORT information manually.

    Advanced Setup: In the text field, type the expression you want to add. The value for the VEHOSTPORT value is CALL(candle.kwj.ve.ITCAMLinkHelper, getVehostportForWASServer, null, null, $kfw.TableRow:ATTRIBUTE.<table_name>.ORIGINNODE$). To get the expression: $kfw.TableRow:ATTRIBUTE.<table_name>.ORIGINNODE$, in the Expression Editor, click Symbol.

  5. Click Origin Node and click OK to get $kfw.TableRow:ATTRIBUTE.<table_name>.ORIGINNODE$.

    When using the Advanced set up option, if your Managing Server Visualization Engine host or port information changes, ITCAM for Application Diagnostics custom code updates the changes automatically, you do not need to modify the links you defined manually to correct the information.

  6. To add an expression, Basic Setup: the VEPATH value can be set as “am/ve/sad/threadList?mappingTEPUrl=true”

    • Double quotation marks are required in the expression.

    • When you use the Basic Setup option, select the server group and the server in the Managing Server Visualization Engine yourself when you log in to Managing Server Visualization Engine.

    To add an expression, Advanced Setup: Set the VEPATH value in the Expression Editor as:"am/ve/sad/threadList?mappingTEPUrl=true&server=" + CALL(candle.kwj.ve.ITCAMLinkHelper, getServerIdForWASServer, null, null, $kfw.TableRow:ATTRIBUTE.<table_name>.ORIGINNODE$)

    Where the correct expression of $kfw.TableRow:ATTRIBUTE.<table_name>.ORIGINNODE$ can be found by using Symbols view under Expression Editor: $kfw.TableRow:ATTRIBUTE.<table_name>.ORIGINNODE$ (Symbol: Origin Node).

  7. Review the details in the Workspace Link Wizard - Summary. Click Finish.

  8. If you use the Advanced Setup options in Step 4 and Step 6, modify the linkIsEnabled parameter in the Workspace Link Wizard Parameters view with expression: CALL(candle.kwj.ve.ITCAMLinkHelper, isEnabledForWASServer, null, null, $kfw.TableRow:ATTRIBUTE.<table_name>.ORIGINNODE$) && $kfw.TableRow:ATTRIBUTE.<table_name>.ASID$ != -3. In the Expression Editor, use the Symbols view to find expressions of $kfw.TableRow:ATTRIBUTE.<table_name>.ORIGINNODE$ (Symbol: Origin Node)and $kfw.TableRow:ATTRIBUTE.<table_name>.ASID$ (Symbol: ASID).


Manually adding your own links to the Link Wizard

The minimum settings are VEHOSTPORT and VEPATH. If you need to link to a different page, you need to change this value to corresponding URL path. Here is a list of frequently used Managing Server Visualization Engine Paths page URL paths:

If you change the host port number at any point. You need to modify these two properties again and the kernel properties on the MS install will need to be restarted to identify the changes.


Link anchor

You can use the Link anchor option to access the Link anchor properties window. You can use the Link anchor properties window to display visual indicators on tables where customized links have been defined, and to establish a default link that opens when the user clicks the indicator.

  1. From any of the tables, right click the choose link icon and click Link Anchor to display the Link anchor properties window.

  2. Depending on the area of the table item you select, the window displays the following information:

    • Default no link

    • Show Link indicator

    • Link indicator always enabled.

  3. For more information about the uses of these items refer to the help within the Link anchor properties window.

Workspace link to Managing Server Visualization Engine


Parent topic:

Workspace link to Managing Server Visualization Engine