Changing HTML Links to Point to User-Defined Workspaces

You can customize workspaces and change the corresponding HTML link to point to the user-defined workspace.

1. Determine the name of the workspace link that you want to use in order to point to a user-defined workspace.
   For example, you have created a customized Thread Wait Events workspace. Now you want to change the default Thread Wait Events HTML link to point to your customized Thread Wait Events workspace. In this case, the name of the workspace link that you want to change is Thread Wait Events.
2. Open the Properties dialog of the browser view of the HTML navigation browser and determine the navigation category that the workspace link belongs to. The available navigation categories are:
   • Statistic_Navigation
   • Thread_Detail_Navigation
   • Thread_Summary_Navigation
3. Navigate to your custom workspace that should become the new target of the HTML link. Determine the name of the new user-defined workspace that should be the new target for the link. You find the workspace name in the title bar of the Tivoli Enterprise Portal window.
4. Determine the workspace ID that uniquely identifies the new customized workspace. Enter the following SQL statement on the Tivoli Enterprise Portal Server database: select OBJECTID from <TEPS database name>.KFWWORKSPACE where "NAME" like '<name of the new user-defined workspace>'
   In this SQL statement <TEPS database name> is the database name of Tivoli Enterprise Portal Server.
   Make a note of the OBJECTID, as it is needed later.
5. Open the XML file that defines all HTML links for the chosen navigation category. The name of the XML file is <navigation category>.xml. The path for this XML file is the following:
   <ITM base directory>\CNB\classes\candle\kdp\resources\help\<language locale>\HTML_BrowserNavigation\V420
   where <ITM base directory> is the base directory of IBM Tivoli Monitoring.
   Remark: An empty language locale string represents the English language locale.
6. Search for the caption_NLS element that contains the name of the workspace link that you want to change. You have determined the workspace name in Step 1.

   <first_level_navigator>
   		<caption_EN_US>Thread Wait Events</caption_EN_US>
   		<caption_NLS>Thread Wait Events</caption_NLS>
   		<target_workspace_objectid>1013a039535:420</target_workspace_objectid>
   		<keep_symbols>true</keep_symbols>
   </first_level_navigator>

7. Make the following changes: Set the caption_NLS to the name of your customized workspace that you have determined in Step 3. Set the target_workspace_objectid to the OBJECTID that you have determined in Step 4.
   Parameter details:
   1. caption_EN_US: Do not change the text in this node as it is important for the proper function of the HTML navigation.
   2. caption_NLS: This xml node contains the link caption.
   3. target_workspace_objectid: This xml node defines the target workspace for the HTML link. Set it to the OBJECTID determined in Step 3.
   4. keep_symbols: This parameter is important for context-sensitive navigation.
      keep_symbols set to 'true' specifies that there is context information that must be passed along when linking to the workspace.
      keep_symbols set to 'false' specifies that no context information that must be passed along when linking to the workspace.
      Do not change this parameter.
8. XML files that are required for the HTML navigation in Tivoli Enterprise Portal are generated in this step. To generate these XML files, browse to the following directory:
   <ITM base directory>\CNB\classes\candle\kdp\resources\help\<language locale>\HTML_BrowserNavigation\V420
   where <ITM base directory> is the base directory of IBM Tivoli Monitoring.
9. Run the HTML_Navigation_Generator.bat.
10. Restart Tivoli Enterprise Portal.
11. The old HTML link caption has changed to the caption of the new customized workspace. When clicking on that customized workspace HTML link, Tivoli Enterprise Portal links to this new workspace.