Creating detail links in configuration change event reports in IBM Tivoli Monitoring

You can create links in a report table to a workspace displaying change history and details directly from the TADDM server. These links give more detailed information than what is displayed in a report.

To create a link, in a configuration change event report, to more detailed change event information, complete the following steps:

  1. To create a workspace to display the information, complete the following steps:
    1. In the Navigator pane, right-click the node within which you want to contain the workspace. Click File > Save workspace as.
      The Save Workspace As window is displayed.
    2. In the Name field, type the name of the workspace.
      For example, ConfigChangeDetails.
    3. In the Description field, type a description of the workspace.
      For example, Generic workspace for the change event table.
    4. Select the Only selectable as the target of a Workspace Link check box.
    5. Click OK.
  2. To configure the workspace using IBM® Tivoli® Monitoring 6.2.1, or later, complete the following steps:
    1. Configure the workspace to have one navigator pane and two browser panes.
    2. Click Edit > Properties.
    3. In the Browser pane, select the first instance of Getting Started.
    4. In the Style pane, select Use Provided Location.
    5. Click OK.
    6. In the Location field of one of the browser panes, type the URL of the Change History view in TADDM. When you have typed the URL on one line, do not press Enter. 
      http://$taddm_server$:$taddm_port$/cdm/servlet/
LICServlet?view=changehistory&hoursback=10000&console=web&guid=$taddm_guid$
      The hoursback parameter specifies the number of hours for which change events are displayed. For example, setting hoursback to 6 displays all change events in the previous six hours.
    7. In the Browser pane, select the second instance of Getting Started.
    8. In the Style pane, select Use Provided Location.
    9. Click OK.
    10. In the Location field of the second of the browser panes, type the URL of the Object Details view in TADDM. When you have typed the URL on one line, do not press Enter. 
      http://$taddm_server$:$taddm_port$/cdm/servlet/LICServlet?console=web
&guid=$taddm_guid$
    11. To save the new workspace, click File > Save.
    Immediately after you have typed the URL into the Location field, do not press Enter, but save the workspace.
  3. Open IBM Tivoli Enterprise Portal. In the Report pane, right-click a row in the Report table.
  4. Click Link To > Link Wizard.
    The Welcome page of the Workspace Link Wizard is displayed.
  5. Click Create a new link. Click Next.
    The Link Name page of the Workspace Link Wizard is displayed.
  6. In the Name field, type the name of the link.
    For example, Show Details.
  7. In the Description field, type a description of the link.
    For example, Link to details.
  8. Click Next.
    The Link Type page of the Workspace Link Wizard is displayed.
  9. Click Absolute. Click Next.
    The Target Workspace page of the Workspace Link Wizard is displayed.
  10. In the Navigator panel, select the node containing the workspace you created. In the Workspace panel, select the workspace you created.
  11. Click Next.
    The Parameters page of the Workspace Link Wizard is displayed.
  12. You must add three symbols: "taddm_server", "taddm_port", and "taddm_guid". To add a symbol, complete the following steps:
    1. Click Add Symbol.
      The Add Symbol window is displayed.
    2. In the Symbol field, type the name of the symbol.
    3. Click OK.
  13. For each symbol you create, you must link it to an attribute representing the correct column in the report.
    • Link the "taddm_server" symbol to the TADDM server attribute.
    • Link the "taddm_port" symbol to the TADDM web console port number.
    • Link the "taddm_guid" symbol to the Component GUID attribute.
    To link a symbol to an attribute, complete the following steps:
    1. In the Parameters page of the Workspace Link Wizard, select the symbol you want to link to a report column.
    2. Click Modify Expression.
      The Expression Editor window is displayed.
    3. Click Symbol.
      The Symbols window is displayed.
    4. Navigate to Attributes, and select the attribute you want to link to the symbol. Click OK.
    5. In the Expression Editor window, click OK.
      The Parameters page of the Workspace Link Wizard is displayed.
  14. Click Next.
    The Summary page of the Workspace Link Wizard is displayed.
  15. Click Finish.
If you have active events in your change event report, a link icon is displayed next to each table row. To move to the target workspace, click the link icon and select Show Details. In the table row, values are substituted for symbols. In the workspace, the Change History and Object Details panels are launched in context.