Using TBSM to create a custom view of the data

This section describes how you can display the ITCAM for Transactions data in the custom portlets that are included in the TBSM customization files.

About this task

The custom portlets display ITCAM for Transactions data in a service tree and a chart. The CAM_Service_Tree template shows the data columns that correspond to ITCAM for Transactions attributes as shown in this table.

Table 1. CAM_Service_Tree columns

Column name	Description
State	The status of the service.
Percent Available	Reports the percentage of successful transactions. Available transactions have a Transaction Status of Good or Slow, but not Failed. The sum of percent available and percent failed equals 100%. Percent available shows any failure as red. Slow transactions are not counted in Percent Available. Any failure is considered important so Percent Available is marked green (Good) only when a transaction is 100% available.
Failed Requests	Reports the number of transactions that did not complete correctly or reported an error during the data interval. Failed status is indicated by a transaction Status Code with a value greater than 0. The sum of slow requests, successful requests and failed requests equals the number of total requests.
Percent Slow	Reports the percentage of transactions that completed successfully, but violated the Minimum Response Time Threshold (MRTTHRES attribute). The sum of percent good and percent slow equals the percent available. Percent slow flags any transaction that is slow as yellow. Slow transactions are not counted in Percent Available.
Response Time	Reports the number of seconds (up to 3 decimal places) that are required for the transaction to complete.
Total Requests	Reports the total number of transactions monitored during the data interval. The sum of slow requests, successful requests, and failed requests equals the number of total requests.

To view a custom tree template, you need to create a custom page for TBSM, add a service tree portlet to the page and assign user roles to the page. For information on creating custom pages, see the TBSM Scenarios Guide.

In TBSM, a user with administrator privileges can do the following tasks:

• To manage user roles, from the left navigation pane, click Settings → Role management. For more information, see the console help.
• To assign roles to users, from the left navigation pane, click Users and Groups → Administrative User Roles. For more information, see the console help.
• To manage pages, from the left navigation pane, click Settings → Page management. For more information, see the console help.
• To manage portlets, from the left navigation pane, click Settings → Portlet management. For more information, see the console help.

CAM Performance Trend chart

The CAM Performance Trend chart shows the number of slow requests, successful (good) requests, failed requests and total requests over a 2-hour time period.

This task shows how to create a sample page with the service tree, chart, and the Service Details portlet, as shown in this figure.

Figure 1. Sample TBSM dashboard

Note: You cannot use the Mozilla Firefox Web browser for all the steps in this procedure. Use a supported browser such as Microsoft Internet Explorer for steps 11-12.

1. Start TBSM in Internet Explorer and login to Tivoli Integrated Portal with Administrator privileges (such as the default user, tipadmin). If you want to see the results on the new page, assign all the user roles to the tipadmin user.
2. From the Navigation tree in the left pane, click Settings -> Page Management.
3. (Optional) On the Page Management page, click New Folder to create a new folder in the navigation tree. Enter a folder name and then click Save.
4. On the Page Management page, click New Page to display a list of portlets. Select Service Tree and click OK.

   The Service Tree page is displayed, showing the default service tree, such as Imported Business Services.

5. Divide the Service Tree page into sections so you can add an events portlet and a chart portlet. First, split the page horizontally by clicking the Horizontal Split icon, located in the upper right area of the Service Tree page.

   A new Choose a Portlet page is created beneath the Service Tree page.

6. Split the newly created Choose a Portlet page vertically by clicking the Vertical Split icon located in the upper right area of the Choose a Portlet page.

   A second new Choose a Portlet page is created next to the first page.

7. In the first Choose a Portlet page in the lower left, scroll down the list of portlets and select Service Details. Click OK to confirm your selection.
8. In the second Choose a Portlet page in the lower right, scroll down the list of portlets and select Charting. Click OK to confirm your selection.
9. At the top of the Create New Page tab, click Save.
10. Give the page a name (for example, Transaction Dashboard) and optionally specify the page location corresponding to the folder that you might have created in Step 3 above. You can navigate to the existing folder by clicking Location and then clicking Move to Folder to move to the created folder.
11. Click Save at the bottom of the page to save your information and display the newly created page. The name of the new page (for example, Transaction Dashboard) is displayed in the tab at the top of the page.
12. Set the ITCAM Service Tree to display in the newly created page by clicking the Edit Options icon (/), located in the top right area of the Service Tree portlet. From the menu that is displayed, select Edit Defaults.
13. Fill in the set of fields displayed in the Service Tree portlet:
    
    1. In the Portlet Title field, type a name for the portlet, such as Dashboard.
    2. In the Tree Template drop-down list, select CAM_Service_Tree.
    3. In the Set Starting Instance section of the portlet, click the Imported Business Services node to set it as the starting node.
    4. Scroll to the bottom of the portlet page and click Save to save your entries.
14. Configure the Charting portlet in the bottom right:
    1. Click the Tivoli Charts link.
    2. In the table that is displayed, select the TBSMChartService chart.
    3. Click Next to continue to the Select Chart to Import window.
    4. From the Groups drop-down list in the Select Chart to Import window, select TBSM Custom Charts.
    5. Select the CAM_Performance_Trend bar chart from the list of available TBSM custom charts.
    6. Click Finish at the bottom to save your selections.
15. If you do not see the CAM_Performance_Trend chart displayed, try to import it manually:
    1. Click the Back button until you can select the Custom Charts option.
    2. Select Custom Charts.
    3. Click the green arrow button to upload a chart.
    4. Locate the chart design file, CAM_Performance_Trend.rptdesign in your file system (it is part of the installation).
    5. Select Upload.
    6. After the chart is uploaded successfully, select the chart.
    7. Click Finish to display the chart.
16. Press Save and confirm the save by pressing Save again to save the changes to the Portlet.

    You have now successfully setup a custom Tivoli Integrated Portal page showing your ITCAM data.

17. To change the reporting period of the chart:
    1. Navigate to the Service Administration tab.
    2. Select Charts from the drop-down list.
    3. Double-click CAM_Performance_Trend.
    4. From the pane on the right, select Edit Policy.
    5. In the Policy Editor, change the value of ChartHours = 2; to the number of hours you want the chart to report.
    6. Click Save.