IBM Tivoli Netcool Performance Manager 1.4 Document Revision R2E1. Getting Started with Common Reporting IBM

Transcription

1 IBM Tivoli Netcool Performance Manager 1.4 Document Revision R2E1 Getting Started with Common Reporting IBM

2 Note Before using this information and the product it supports, read the information in Notices on page 39. Copyright IBM Corporation 2011, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

3 Contents Introduction v Service Management Connect v Tivoli Netcool Performance Manager technical training v Support information v Conventions used in this publication vi Typeface conventions vi Chapter 1. Common Reporting on Tivoli Netcool Performance Manager Tivoli Common Reporting Tivoli Common Reporting components Administering Dashboard Application Services Hub 3 Logging in to the reporting interface in Tivoli Netcool Performance Manager Authoring a web-based report Using Tivoli Common Reporting template... 6 Report Specifications Creating Reporting Models and Packages Performing ad-hoc reporting Chapter 2. Reports containing both Wireless and Wireline data Chapter 3. Getting started with Wireline reports Wireline data source Creating a report ing reports Scheduling reports Cognos Active Reports Dashboard reports Design considerations for Wireline report authors. 17 Modifying timestamps in custom charts to round up to minutes instead of milliseconds Conforming to Cognos reporting guidelines.. 18 Microsoft Excel formatting limitations Chapter 4. Getting started with Wireless reports Authoring a simple report Authoring an efficient report Authoring a drill-down report Authoring a charting report Drill-through reports Authoring a drill-through target report Authoring a drill-through source report Including multiple granularity items in the same report Displaying multiple granularity items with drill-down only Displaying multiple granularity items with drill up and drill down UDC calculations and drill downs Chapter 5. Known Common Reporting issues Appendix. Common directory locations for Jazz for Service Management Notices Terms and conditions for product documentation.. 41 Trademarks Copyright IBM Corp. 2011, 2018 iii

4 iv IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

5 Introduction The IBM Cognos Business Intelligence Reporting application provides the Tivoli Common Reporting interface with several advanced reporting functions. Getting Started with Common Reporting describes how to get started with Common Reporting in IBM Tivoli Netcool Performance Manager Wireline and Wireless Components. With Tivoli Common Reporting, you can run and view reports in different report formats, on your desktop or mobile devices. You can reports and work with reports offline. You can access the reporting interface directly from the Cognos Common Reporting URL, through Dashboard Application Services Hub, or through a Tivoli product s user interface. Service Management Connect Connect, learn, and share with Service Management professionals: product support technical experts who provide their perspectives and expertise. Access Network and Service Assurance community at developerworks/servicemanagement/nsa/index.html. Use Service Management Connect in the following ways: v Become involved with transparent development, an ongoing, open engagement between other users and IBM developers of Tivoli products. You can access early designs, sprint demonstrations, product roadmaps, and prerelease code. v Connect one-on-one with the experts to collaborate and network about Tivoli and the Network and Service Assurance community. v Read blogs to benefit from the expertise and experience of others. v Use wikis and forums to collaborate with the broader user community. Related information: Tivoli Netcool Performance Manager 1.4 community on developerworks Tivoli Netcool Performance Manager technical training Support information For Tivoli Netcool Performance Manager technical training information, see the following Tivoli Netcool Performance Manager Training website at: If you have a problem with your IBM software, you want to resolve it quickly. IBM provides the following ways for you to obtain the support you need: Online Access the IBM Software Support site at support/probsub.html. Copyright IBM Corp. 2011, 2018 v

6 IBM Support Assistant The IBM Support Assistant is a free local software serviceability workbench that helps you resolve questions and problems with IBM software products. The Support Assistant provides quick access to support-related information and serviceability tools for problem determination. To install the Support Assistant software, go to support/isa. Troubleshooting Guide For more information about resolving problems, see the problem determination information for this product. Conventions used in this publication Several conventions are used in this publication for special terms, actions, commands, and paths that are dependent on your operating system. Typeface conventions This publication uses the following typeface conventions: Bold Italic Monospace Bold monospace v Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text v Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) v Keywords and parameters in text v Citations (examples: titles of publications, diskettes, and CDs) v Words defined in text (example: a nonswitched line is called a point-to-point line) v Emphasis of words and letters (words as words example: "Use the word that to introduce a restrictive clause."; letters as letters example: "The LUN address must start with the letter L.") v New terms in text (except in a definition list): a view is a frame in a workspace that contains data. v Variables and values you must provide:... where myname represents... v Examples and code examples v File names, programming keywords, and other elements that are difficult to distinguish from surrounding text v Message text and prompts addressed to the user v Text that the user must type v Values for arguments or command options v Command names, and names of macros and utilities that you can type as commands v Environment variable names in text v Keywords vi IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

7 v Parameter names in text: API structure parameters, command parameters and arguments, and configuration parameters v Process names v Registry variable names in text v Script names Introduction vii

8 viii IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

9 Chapter 1. Common Reporting on Tivoli Netcool Performance Manager An overview of Common Reporting for Tivoli Netcool Performance Manager 1.4 users through the Dashboard Application Services Hub in Jazz for Service Management V Both Dashboard Application Services Hub and Tivoli Common Reporting are installed in the same application service environment, and the reporting interface is integrated with Dashboard Application Services Hub. Related information: Tivoli Common Reporting Jazz for Service Management overview Using Tivoli Common Reporting Reporting Services is an integration service for users to administer, run, edit, and create Tivoli reports. It is a follow-on implementation of the Tivoli Common Reporting component. Reporting Services provide web-based, launch-in-context report administration, and editing. Use the Common Reporting to publish, find, manage, organize, and view your organization s Business Intelligence content, such as reports, scorecards, and agents. If you have the necessary permissions, you can access the Report Studio and Query Studio or access the administration functions for content administration, including scheduling and distributing reports, and creating jobs. With Tivoli Common Reporting, you get the following advantages: Simplified interaction Simplified interfaces and interactions for report writers to create, customize, and publish reports faster and easier. Reporting workspaces, with free form layout, allows users drag sections from different reports to create workspaces with reporting content and enhance interactivity. Powerful report formats Built-in interactivity that is provided by Active Reports format. users an active report, which has interactive functions that the users can use offline. Interactive functions include clickable charts, sorting, tabs, and radio buttons, and check box filtering. Trending capabilities Supports trending to a report by using bar, line, area, bubble, and scatter charts, and with just a few clicks. Supports averages across series or for each series. Mobile device support Supports viewing and running reports on mobile devices, including Apple ipad, iphone, Android, BlackBerry, and Windows. Uses native applications for ipad and BlackBerry. Users can also interact offline with Active Reports with the ipad application. On-demand and self-service reporting Bridges gap between business and professional report authors. Enable report users to create and save multi-query ad hoc reports through the Copyright IBM Corp. 2011,

10 drag features, without the need for professional report writer s involvement. Supports enhanced user experience through easy modification of layout and format. Users can drag and resize widgets. They can filter data with a few clicks. Users can choose from a greater variety of charts to support trending. Compatible with IBM Cognos Report Studio. Cross-product report linking Extends the capability of cross-product report linkage for seamless flow between related reports of various Tivoli products. Robust Reporting Engine Simplified configuration with Java Database Connectivity (JDBC) support. Optimized SQL generation of complex queries for better runtime performance. Related information: Tivoli Common Reporting Getting started with reports Tivoli Common Reporting components Tivoli Common Reporting consists of data stores, reporting engines, their corresponding web user interfaces, and a command-line interface. Tivoli Common Reporting provides a flexible structure that can be adapted for load balancing. The core components are as follows: Cognos-based Tivoli Common Reporting engine The dispatcher is the entry point for IBM Cognos service requests sent by a web server gateway or other software. The dispatcher handles the routing requests and balances the load of user requests to the various IBM Cognos services. Cognos gateway A portal for communication between Tivoli Common Reporting Server and the Cognos-based Tivoli Common Reporting engine. Cognos Content Store A database that contains data that IBM Cognos uses to operate. The data comprises report specifications, published models, and the packages that contain them; connection information for data sources; information about the external namespace, and the Cognos namespace itself; and information about scheduling and bursting reports. Common Reporting user interface A web user interface that provides a portal for IBM Cognos and a component that interacts with the Cognos Content Store. The user interface is used to publish, find, manage, organize, and view organization's reports. You can access the reporting interface directly from the Cognos Common Reporting URL, through Dashboard Application Services Hub, or through a Tivoli product s user interface. IBM Cognos Mobile An application that provides mobile device support in Tivoli Common Reporting. After Cognos Mobile is installed in the same application service environment as Tivoli Common Reporting, users can run and view reports anywhere or any time on their mobile devices such as smartphones or 2 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

11 tablet computers. It is bundled with Tivoli Common Reporting on the Tivoli Common Reporting installation media. IBM Cognos Framework Manager A modeling tool to create data models. It is shipped with Jazz for Service Management, on its own installation media. IBM Cognos Business Intelligence Reporting Tivoli Common Reporting is based on Cognos Business Intelligence Reporting version The following Cognos components are available with Tivoli Common Reporting: v Query Studio - a reporting tool for creating simple queries and reports. v Report Studio - a web-based tool for creating sophisticated reports against multiple databases. v Event Studio - a web-based tool for monitoring data to detect business events and to performs tasks when those events occur, such as sending s or running reports. v Connection - an application where you can view and manage all your reports. v Workspace - a web-based tool for authoring simple reports and exploring your data. v Workspace advanced - a tool for performing advanced data analysis and creating reports with various data sources. Related information: IBM Tivoli Common Reporting on developerworks IBM Cognos Customer Center. Administering Dashboard Application Services Hub Dashboard Application Services Hub administration tasks include setting up the console, managing users, exporting and importing data, and configuring the type of mobile devices to use the mobile version of the console. About this task If Dashboard Application Services Hub and Administration Services are installed in the same Installation Manager software package group, that is, the JazzSM_HOME directory, the following actions occur: v Dashboard Application Services Hub is registered a managed resource with the Administration Services administration service provider. v The Dashboard Application Services Hub task bundle is also installed. This task bundle contains tasks to administer and implement best practices for Dashboard Application Services Hub. You can run these administration tasks by using the Administration Services CLI or UI. Depending on the administration task, you might have to restart the Dashboard Application Services Hub application or the Jazz for Service Management application server in which it is installed. Dashboard Application Services Hub also provides a command-line interface to work with console elements such as dashboards, views, widgets, charts, and preference profiles. You can run commands to list these elements, list roles that are Chapter 1. Common Reporting on Tivoli Netcool Performance Manager 3

12 assigned to them, then add or delete roles. The CLI also provides import and export commands. Related information: Administering Dashboard Application Services Hub Dashboard Application Services Hub command reference Logging in to the reporting interface in Tivoli Netcool Performance Manager You can access the reporting interface directly or through Dashboard Application Services Hub. Before you begin Ensure that you have the appropriate login credentials from your administrator. About this task With the Common Reporting interface, you can perform simple lightweight tasks and more advanced scalable reporting that is provided by IBM Cognos Business Intelligence Reporting. v Create on-demand reports. v Use the web-based report authoring. v reports. Tip: To access the Cognos documentation, click in the reporting interface. Access the reporting interface: Dashboard Application Services Hub Log in to the reporting interface from the Dashboard Application Services Hub login page. Both Dashboard Application Services Hub and Tivoli Common Reporting are installed in the same application service environment, and the reporting interface is integrated with Dashboard Application Services Hub. Access is determined by user roles that are associated with user IDs. The role that you need to access Tivoli Common Reporting is tcrportaloperator. See Authentication and authorization in Tivoli Common Reporting. Direct access Log in to the reporting interface from its own login page. Tivoli product s user interface Log in to the reporting interface from a Tivoli product s login page. Tivoli Common Reporting is integrated with a Tivoli product. Procedure v Access the reporting interface from Dashboard Application Services Hub as follows: 4 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

13 1. Open a web browser and enter the following URL for the Jazz for Service Management UI and reporting server: For example: Where: host.domain is the fully qualified host name or IP address of the Jazz for Service Management UI and reporting server. When single sign-on (SSO) is enabled, ensure that you use the fully qualified host name in the URL of the Jazz for Service Management reporting and UI server. SSO requires that the browser pass LTPA cookies to the Jazz for Service Management application server, and these cookies contain the fully qualified host name. port is the secure HTTP port number that was specified during installation. The default value is /DASH_context_root is the context root for the console that was specified during installation. The default value is /ibm/console. 2. On the Dashboard Application Services Hub login page, enter the user ID and password. Ensure that user ID has access to Tivoli Common Reporting. Click Log in. The Dashboard Application Services Hub Welcome page opens. 3. In the navigation bar, click Reporting > Common Reporting. The Common Reporting portal is displayed within a Dashboard Application Services Hub portlet page. v Access the reporting interface directly as follows: 1. Open a web browser and enter the following URL for the reporting interface: For example: Where: host.domain is the fully qualified host name or IP address of the Jazz for Service Management reporting server. Note: When single sign-on (SSO) is enabled, ensure that you use the fully qualified host name in the URL of the Jazz for Service Management reporting server. SSO requires that the browser pass LTPA cookies to the Jazz for Service Management application server, and these cookies contain the fully qualified host name. port is the non-secure HTTP port number that was specified during installation. The default value is Check with your organization s Jazz for Service Management administrator if you are unsure of the URL. 2. On the Login to IBM Cognos Software page, enter the user name and password. Click OK. The Common Reporting portal opens. v Access the reporting interface from a Tivoli product s user interface. Wireline DataView component is installed on the same server as the Jazz for Service Management server. Chapter 1. Common Reporting on Tivoli Netcool Performance Manager 5

14 Authoring a web-based report Create reports in a web-based tool that professional report authors use to build sophisticated, multiple-page, multiple-query reports against multiple databases. You can create any reports that your company requires, such as invoices, statements, and weekly sales and inventory reports. Procedure 1. Log in to the reporting interface. See Logging in to the reporting interface in Tivoli Netcool Performance Manager on page 4 2. In the reporting interface, select Launch > Report Studio. After you select a report package that you want to use, the Report Studio opens. Note: The report charts have been updated in IBM Cognos Version 10.2 but are disabled in Report Studio by default. To activate the new charts for your package, in Report Studio go to Tools > Options and clear Use legacy chart authoring. 3. Use the menu controls to create a report or edit existing ones by formatting the layout and manipulating the data in the report. Tip: Use Tivoli Common Reporting template to ensure consistency among your reports. 4. Save your report, and run it anytime you must present its underlying data. What to do next Learn more about web-based report authoring in Report Studio Professional Authoring User Guide available on clicking F1 from the Report Studio. Related information: How IBM Cognos Business Intelligence Works Report Studio User Guide Using Tivoli Common Reporting template Tivoli Common Reporting report template contains a standard layout pattern that you can use to create your reports. Use the template to ensure consistency among your reports and give them a common look and feel. About this task The Tivoli Common Reporting template contains a prompt page and a proper report page. You can manage the pages in the Page Explorer pane. You can use the prompt page to add filters to your reports. By default, it allows you to specify the date range of the report but you can also customize the filters according to your needs. The proper report page contains page number, date and time when the report was created. Procedure 1. Log in to the relevant reporting interface in your environment. See Logging in to the reporting interface in Tivoli Netcool Performance Manager on page In the reporting interface, select Launch > Report Studio. After you select a report package that you want to use, the Report Studio opens. 6 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

15 3. Select Create new > TCR Template. 4. Customize the parameters to suit your needs. Open the Toolbox nd drag items onto the report pages. 5. Save your report to be able to run it anytime you need. Related information: Working with reports Report Specifications When authors create a report, they are actually creating a report specification. The report specification is an XML representation of the queries and prompts that are used to retrieve data, as well as the layouts and styles that are used to present the data. For simplicity, the report specification is called the report. Report specifications can be useful to report authors for troubleshooting. You can see the XML specification for a report at any time by selecting Tools > Show Specifications from Report Studio. In addition, you can view the specification for a selected object with the Show Specification (Selection) menu option. You can also programmatically create or modify reports by using an editing tool to work with report specifications. You then use the IBM Cognos Software Development Kit to implement the reports in your IBM Cognos Business Intelligence environment. Related information: Report Studio User Guide Creating Reporting Models and Packages A model serves as an insulating layer between IBM Cognos BI reporting users and the database. Packages are model subsets that ensure users are provided with data appropriate for the reporting they need to do, and that the data is structured in ways that make sense from a business perspective. A model structures, adds to, and manages data in ways that make sense to business users. For example, a model defines business rules, data descriptions, data relationships, business dimensions and hierarchies, and other administrative tasks. Report specifications Modeling Models can be based on the compatible query mode or the dynamic query mode. The compatible query mode supports legacy reports and is required for some data sources. The dynamic query mode is recommended for new applications of IBM Cognos Business Intelligence. The dynamic query mode provides the following benefits: v It is optimized for complex queries and larger data volumes. v It provides advanced query capabilities, such as in-memory caching, which can improve query planning, execution, and results. Chapter 1. Common Reporting on Tivoli Netcool Performance Manager 7

16 v It enables the use of IBM Cognos Dynamic Cubes as data sources, which allow low-latency, high-performance OLAP analytics over large relational data warehouses. Because stored data is typically designed for storage and not for reporting, a data modeler uses Framework Manager to create metadata models. Models structure, add to, and manage data in ways that make sense to business users. Models define business rules, data descriptions, data relationships, and business dimensions and hierarchies. Planning and creating a model is an important task that should be performed by a modeler or a modeling team familiar with both the database structure and the needs of the business users. Models and packages that are well-designed from the start ensure that user requirements are met, data is secure, and your IBM Cognos BI application can be easily administered. For IBM Cognos BI reporting, models and packages are created using Framework Manager. For more information, see the IBM Cognos Framework Manager User Guide. In Tivoli Netcool Performance Manager - Wireless Component, Tivoli Netcool Performance Manager - Application Studio can be used to create enhanced models. Model Maker is also supported for earlier models to define the metadata models from the technology packs. Modifications and other customization to the data model can be done by using the Framework Manager. Creating a model is an important task that should be planned and executed by a modeler or a modeling team familiar with both the database structure and the needs of your business users. When you create a model, you v Specify the metadata to import from data sources defined in the IBM Cognos BI content store v Refine the metadata by adding business names, descriptions, multilingual values, calculations, filters, and other components v Specify joins and relationships v Organize the data for presentation in ways that make sense to business users and add value to your databases v Add security to the metadata to determine who can use the metadata and for what purposes Packaging After a model is created, packages are published to locations on the IBM Cognos BI server where report authors can use them to create reports. A different package, containing only the necessary information, can be published for each group of users. Reports cannot contain data from more than one package. When publishing a package, it is important to ensure that the package contains all the data required to meet the needs of the intended users. The hierarchical structure of a package controls the way in which folders, reports, and other data objects are structured in the interface used by the report author. It also controls how security is applied to the objects, and how easy it is to deploy the package to other environments. As a result, it is important to ensure that the structure of a package makes sense from the perspective of a business user, and not just from an administrative perspective. 8 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

17 Related information: Installing and Using Tivoli Netcool Performance Manager - Application Studio Performing ad-hoc reporting Installing and Using Model Maker Create reports ad-hoc by using simple queries and formatting. Before you begin To perform ad-hoc reporting you have to have some report packages imported. Procedure 1. Log in to the reporting interface in your environment. See Logging in to the reporting interface in Tivoli Netcool Performance Manager on page In the reporting interface, select Launch > Query Studio. 3. Start Query Studio. 4. Select a package to work with. A New window opens in which you can create a report. 5. Select and insert items from the navigation tree to complete the report. Tip: Change the appearance of the data by using the menu icons. 6. When the report data and appearance is edited, save the report by specifying a Name, and optionally a Description, and a Screen tip. Results You have now created your ad-hoc report. What to do next Learn more about authoring the reports in the IBM Cognos Query Studio User Guide. Chapter 1. Common Reporting on Tivoli Netcool Performance Manager 9

18 10 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

19 Chapter 2. Reports containing both Wireless and Wireline data You can include both Wireless and Wireline data in the same report. You can use the following information for creating and using reports that contain both Wireline and Wireless data: Tivoli Netcool Performance Manager Data Provider It exposes the data sets from both Wireless and Wireline data sources, which are groups of data sets. The following diagram explains how this is implemented: Download the data_provider_1.1.zip file from Integrated Service Management Library (ISML) to use this solution. Copyright IBM Corp. 2011,

20 12 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

21 Chapter 3. Getting started with Wireline reports Wireline data source Creating a report This information can help you get started with Common Reporting on Wireline networks with Tivoli Netcool Performance Manager. The data source that is used in Cognos 10 is called TNPM.JDBC. The data source gives access to Technology pack resource set definition. The Cognos is integrated through new Cognos Dynamic Query Model engine with the support of Tivoli Netcool Performance Manager JDBC Driver. The Tivoli Netcool Performance Manager JDBC Driver exposes traffic data in the following virtual tables: v Group Summary Table (GST) v Resource Aggregated Time Series Table (RATS) v Resource Time Series Table (RTS) Virtual tables are conceptualized database tables that are virtualized by Tivoli Netcool Performance Manager JDBC Driver. These tables do not exist in the RDBMS database. You can achieve the following objectives by using Tivoli Netcool Performance Manager JDBC Driver: v Cognos integration for common reporting v Cognos data modeling by using Framework Manager for creating Tivoli Netcool Performance Manager data models v Optional: Third-party SQL Client connection for troubleshooting Related information: Installing and Configuring Common Packs To create a report, follow these steps: Procedure 1. In Common Reporting, select a package. In this example, select the ibm.tnpm.huawei.u2000 package. 2. On the toolbar, click Launch and select Report Studio. The Report Studio opens. 3. On the Welcome window, select Create a new report. A window opens. 4. On the New window, select List, and click OK. An empty report, containing a list (a single row table), opens. 5. Expand the package in the Source Pane on the left. Drag data items in to the list. For example: a. Expand ibm.tnpm.huawei.u2000 > Presentation Views > Tivoli Netcool Performance Manager (TNPM) > TNPM huawei u2000 (Presentation) > Card Raw. Copyright IBM Corp. 2011,

22 b. Drag the following data items to the list: v TIMESTAMP v DISPLAY_NAME v Memory Occupancy[100872][raw] v CPU Occupancy[100006][raw] c. Select TIMESTAMP in the list and sort it in ascending order. ing reports 6. Click Run > Run Report HTML to run the report. 7. Click File > Save As to save the report. your reports to share them with the group of people who do not have access to the reporting portal. Related information: ing Reports on Jazz for Service Management on IBM Knowledge Center 14 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

23 Scheduling reports You schedule a report to run it later or at a recurring date and time. You can create a schedule to run a report one time or repeatedly. Procedure 1. Log in to the reporting interface. See Logging in to the reporting interface in Tivoli Netcool Performance Manager on page 4 2. Click Reporting > Common Reporting to select a package. For example, select the ibm.tnpm.mib2 package. 3. Select a report that you want to run as scheduled report and click the Schedule icon ( ). 4. In the Schedule page, configure the following schedule options: a. Set the priority for the scheduled report. Select a lower number for higher priority. The default is 3. b. Under Frequency, select how often you want the schedule to run. The Frequency section is dynamic and changes with your selection. Wait until the page is updated before you select the frequency. c. Under Daily frequency, select how often you want the schedule to run each day. You can choose to schedule an entry either by the minute or by the hour. When you specify a daily frequency, you can select a time period when you want the entry to run during the day, for example, between 9:00 am and 5:00 pm. This way, you can restrict the running of entries to periods during the day when updates are needed. d. Under Start, select the date when you want the schedule to start. e. Under End, select when you want the schedule to end. If you want to create the schedule but not apply it right away, select the Disable the schedule check box. To later enable the schedule, clear the check box. f. Select formats, languages, delivery method as needed. g. Under Prompt values, select the Override the default values check box. h. Click Set > OK. A prompt page opens. 5. From the Run as list, select Scheduled Report. Note: To manually run a report, select One time Report. Edit the values as needed in the following screen: Chapter 3. Getting started with Wireline reports 15

24 6. Click Finish and click OK in the Schedule page to save the changes to the schedule. What to do next Click Edit link to modify the scheduling options or click Clear to reset all the values. Related information: Cognos Active Reports Schedule Management IBM Cognos Active Report is a report output type that provides a highly interactive and easy-to-use managed report. Active reports are built for business users, allowing them to explore their data and derive more insight. Cognos Active Reports contain the data that they present and are based on MHTML, a web archive format. Cognos Active Reports also comes with a new set of widgets that can be interconnected. When the host name changes, the charts are dynamically updated. The advantage is that a report encapsulating data is that it can be transported outside the Tivoli Common Reporting system. Existing reports can be converted and saved as Cognos Active Reports that are encapsulating the data. Active reports make business intelligence easier for the casual user. Report authors build reports that are targeted at their users' needs, keeping the user experience simple and engaging. Active reports can be consumed by users who are offline, making them an ideal solution for remote users such as the sales force. Active reports are an extension of the traditional IBM Cognos report. You can use existing reports and convert them to active reports by adding interactive behavior, 16 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

25 Dashboard reports providing users with an easy-to-consume interface. Like existing IBM Cognos reports, you can run active reports from IBM Cognos Connection and schedule and burst them to users. You build active reports with the same objects that you use to build other report types. However, there are objects that are specific to active reports. These objects fall into two categories: v Active report controls v Active report variables Note: Because Cognos Active Reports contain the data, it is not recommended to create such reports with large number of records for performance reasons. If the Cognos Mobile component is installed, it is essential to consider the potential communication costs that might be incurred loading Cognos Active Reports on mobile devices. Related information: Active Reports Business analytics proven practices Business analytics proven practices - Cognos Active Reports A dashboard is a visual display of the most important information that a user needs. The information is consolidated and arranged on a single screen so that it can be monitored at a glance. Dashboard reports display several different report objects in one report, but the information in the report is static. Workspaces that are created in Cognos Workspace are a collection of IBM Cognos content that you assemble into an interactive workspace. Content is displayed in widgets. You can also create dashboards within IBM Cognos Connection. In these dashboards, content is displayed in portlets within pages. Related information: Example - Create a Dashboard Report Pages and Dashboards Design considerations for Wireline report authors For best results when authoring reports for Common Reporting, keep in mind the following design considerations and limitations. Be aware of the following behavior: v If you include images in your reports, test them thoroughly with the Excel output. Chapter 3. Getting started with Wireline reports 17

26 Modifying timestamps in custom charts to round up to minutes instead of milliseconds By default, timestamps in reports created by using the wireline data models are rounded up to milliseconds. This task explains how to change the report to round the timestamps up to minutes instead. About this task This procedure assumes that time data item found on the Source is inserted into the chart or table in Report Studio as shown. Repeat these steps as required while creating custom charts or tables. Procedure 1. Double-click on a time data item. The Data Item Expression window opens. 2. In the Expression Definition window, enter the following expression: substring(cast( data_item_path,varchar(30)),1,16) where data_item_path is the path of the selected data item. This expression removes seconds and milliseconds, resulting in the display of year-month-day hour:minute only. 3. Save the expression by clicking OK. Conforming to Cognos reporting guidelines To conform to the Cognos reporting guidelines, leave table cells with no data blank rather than using a dash (-) to indicate no data. In Wireline reports for previous Wireline versions, dashes were used (-) in table cells where there is no data. Microsoft Excel formatting limitations When authoring reports, be aware that wireline users can still experience some formatting problems with charts that have a decimal number on the y-axis. These issues are due to formatting limitations in Microsoft Excel If this problem occurs, use Report Studio to modify the chart and change the data format property of the y-axis to the Number with 2 decimal places option. Also, be aware that for best results when exporting reports to Excel, users are directed to always select Microsoft Excel Due to formatting limitations in older versions of Excel, exporting in versions such as 2000 or 2002 can produce incompatible charts. Always ensure that you test your reports in Microsoft Excel If you include icons in your reports, test them thoroughly with the Excel export option. 18 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

27 Chapter 4. Getting started with Wireless reports This information can help you get started with Common Reporting on Wireless networks with Tivoli Netcool Performance Manager. Related information: Authoring a simple report Reporting Best Practices Best practices and reporting recipes by using Tivoli Netcool Performance Manager - Application Studio Report Studio User Guide Query Studio User Guide You can follow these basic steps to create a simple report. This example uses the package that is created when the Huawei GSM BSS common pack is published. Procedure 1. In Common Reporting, select a package. In this example, select the Huawei GSM BSS package. 2. On the toolbar, click Launch and select Report Studio. Report Studio opens. 3. On the Welcome window, select Create a new report or template. 4. On the New window, select List, and click OK. An empty report opens containing a list (a single row table). 5. Select a Time attribute from the Insertable Objects window and drag it into the list. For best results, use the keys where possible. In this example, drag the TCR Time (Presentation) > Time > Keys > DATE_KEY_HOUR key into the list. 6. Select a primary key or an entity ID and drag it into the list right beside the DATE_KEY_HOUR key. Ensure that your selection is in the list, if a singleton is created, click Undo and try again. In this example, drag TNPM Mobile GSM (Presentation) > TNPM GSMCell > TNPM GSMCell > CELL_ID into the list. 7. Select metrics and drag them into the list next to the CELL_ID column. In this example, drag TNPM Huawei GSM BSS V900 Measurements (Presentation) > TNPM Huawei GSM BSS V900 Measurements Cell Measurements > Cell.AMR_calls > Cell.Huawei.GSM.AMR_calls > CALL_DROP_AMRFR_CAll_FAIL_TIMES. 8. Create a prompt page by highlighting CELL_ID and DATE_KEY_HOUR, and clicking the Build prompt page button is automatically generated. 9. Save the report as Simple_Report in My Folders. 10. Return to Common Reporting and click the My Folders tab. on the toolbar. The prompt page 11. Find Simple_Report in the list of reports and click the Run button to run the report. Related information: Copyright IBM Corp. 2011,

28 Creating report Authoring an efficient report The Tivoli Netcool Performance Manager database relies heavily on an Oracle feature called Partition Pruning to efficiently process data. Reports must be defined in a certain way to ensure that Oracle has enough information to identify data partitions. About this task You can build a prompt page to ensure that Oracle has the required information to identify data partitions. These steps assume that you have created a list report with 15-minute data by dragging the appropriate report items into the report. Procedure 1. As this data is 15-minute data, drag the DATE_KEY_15 key into the report. You remove this key later as it is used only as a quick method to build a prompt. 2. Select the DATE_KEY_15 column and click the Build Prompt page button on the toolbar. A prompt is created for the report. 20 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

29 3. Return to the report definition page and remove the DATE_KEY_15 column by right-clicking and selecting cut. You must remove the key or the report displays only the raw data with the drill up. 4. Save and run the report. Chapter 4. Getting started with Wireless reports 21

30 Authoring a drill-down report In this example, we edit the Simple_Report report to allow drill up and drill down levels for both time and resource (entity) in the report. Procedure 1. In Common Reporting, select the package used to create the simple report. In this example, select the Huawei GSM BSS package. 2. On the toolbar, click Launch and select Report Studio. Report Studio opens. 3. Select Open an existing report or template, select Simple_Report and Open. 4. Save the report as Drill_Down_Report. 5. Edit the report to use Cell Hierarchy and Time (Dimensional) by completing the following steps: a. Delete the CELL_ID and the DATE_KEY_HOUR columns. b. In the vertical toolbar beside the Insertable Objects window, point to the Query Explorer button to see Query Explorer and select Query1. c. Delete both filters. to remove the current prompt pages. With the removal of CELL_ID, and DATE_KEY_HOUR, these filters are no longer useful in the context of this report. d. Point to Page Explorer button to see the Page Explorer, right-click on Prompt Page1 and select Delete to delete the prompt page. e. In Page Explorer, click Page1 to return to the list. f. Drag the following elements into the list. You can navigate further into the file structure as required. v TCR Time (Presentation) > Time (Dimensional) > Year > Day v CDM Mobile GSM (Presentation) > CDM GSM > Cell Hierarchy > Network to Cell > Cell 6. From the main menu, select Data > Drill Behaviour. 7. On the Basic tab of the Drill Behaviour window, select the Allow drill-up and drill down option and click OK. You can now drill on entity and time when you run this report. If you want, you can also add a filter to restrict the time scope on which the report is displayed, the prompt page is not as useful in this scenario as it would restrict the drilling process. 8. Add a filter to limit the time scope of the report by completing the following steps: a. In the vertical toolbar beside the Insertable Objects window, point to the Query Explorer button to see Query Explorer and select Query1. b. In the Insertable Objects window, select the Toolbox tab. c. Drag a filter into the Detailed Filters pane from the Insertable Objects pane. In this example, the filter is set to report on the previous 7 days. In the dialog box for the calculation, insert the following calculation: [TCR Time (Presentation)].[Time].[DATE_KEY_DAY] > _add_days(current_date, -8) AND [TCR Time (Presentation)].[Time].[DATE_KEY_DAY] <= _add_days(current_date, -1) d. For this filter to work, the DATE_KEY_DAY key must be in the report. Drag DATE_KEY_DAY into the list. 22 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

31 Authoring a charting report e. The DATE_KEY_DAY key does not need to be displayed so you can hide it. Select the title of the column, and in the Properties window, set Box Type to none, Select the column body and in the Properties window, set Box Type to none. 9. Save the Drill_Down_Report report. 10. Return to Common Reporting and click the My Folders tab. 11. Find Drill_Down_Report in the list of reports and click the Run button to run the report. 12. When the report viewer has appeared, the entries under Cell and Day should be highlighted, you can click these entries to perform a drill down or you can right-click and select drill up to perform a drill up. Charts are a graphical representation of tabular data. They can be used to quickly identify large numeric data for different areas of business. They are commonly used in dashboard style reports. Procedure 1. In Common Reporting, select a package. 2. On the toolbar, click Launch and select Report Studio. Report Studio opens. 3. On the Welcome window, select Create a new report or template. 4. On the New window, select Chart, and click OK. The Insert Chart window is displayed. 5. In the Chart group list, select a group. For this example, select Column. 6. In the Chart Type pane, select a chart type. For this example, select Column with 3-D Visual Effect. 7. Click OK. A blank chart displays in the work area. 8. A column chart has three drop zones; Default measure (y-axis), Series, and Categories (x-axis). 9. From the Source tab in the Insertable Objects pane, drag a data item to the Series drop zone. In this example, we drag the Raw KPI to the Series drop zone. Chapter 4. Getting started with Wireless reports 23

32 10. From the Source tab in the Insertable Objects pane, drag a TCR data item to the Categories drop zone. In this example, we also include the CELL_ID measure from the Orders query subject in the Default measure drop zone. 11. From the Standard toolbar, click Run Report. The results are displayed. 24 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

33 Drill-through reports Creating drill-through access within a report makes it easier for you to navigate through large reports or to link separate reports containing related information. When you create drill-through access, you can create a bookmark that lets you navigate through a particular dimension of a report or pass a parameter from a source report to a target report. When the drill-through data item value in the source report is selected, the target report opens. The target report is filtered on the parameter that was passed from the source report. This filtering allows you to link separate reports with related information. For the following example, we set up drill-through access using two separate reports: a target report, and a source report. Authoring a drill-through target report A target report opens after you click a data item value in a source report. Typically, this report contains related or more detailed information about the source report. Setting up drill-through access gives the user quick access to detailed information without having to navigate through folders to run another report. About this task The MTP3_DSP_ID resource is set up as the drill-through text in the target report. When you click the MTP3_DSP_ID drill-through text, the target report opens, displaying raw data for KPIs for the MTP3_DSP_ID that was selected in the source report. The Date_Key_Hour key is added to the report and hidden; it is used in the drill through, but not required in the report. Procedure 1. Create or open a list report to use as the target report. 2. Add MTP3_DSP_ID, Date_Key_Hour, Date_Key_Hour and raw KPIs columns. 3. Hide the Date_Key_Hour key in the report: a. Click the list column body for the Date_Key_Hour data item and, in the Properties panel, set Box Type = None. b. Click the list column title for the Date_Key_Hour data item and, in the Properties panel, set Box Type = None. 4. Save the target report. For this example, save the target report as Test Target report. What to do next Create a source report that contains raw data for all resources. Chapter 4. Getting started with Wireless reports 25

34 Authoring a drill-through source report A source report contains the data item value that you can click to drill-through to the target report to view more detailed information. About this task To set up the source report to contain the drill-through definition, you need to know the name and location of the target report and the parameter used in the filter of the target report. Procedure 1. Create or open a list report to use as the target report. 2. Add MTP3_DSP_ID, Date_Key_Hour, and raw KPIs columns. 3. In the work area, select the item to be used as the drill-through. For this example, select MTP3_DSP_ID as the drill-through. Note: To activate the Drill-Through Definitions option, you must first make a selection in the work area. 4. Click Launch on the toolbar and select Drill-Through Definitions. The Drill-Through Definitions window is displayed. 5. Click the New Drill-Through Definition button. A new Drill-Through definition is created. 26 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

35 6. Under Report, choose the target report. 7. Select the target report and click the Open button. For this example, select Test Target report. 8. From the Action list, select how the target report renders during drill-through. v Run The Report, runs the report and displays the most recent data. v View Most Recent Report, displays the most recent saved output version of the report. v Default, uses the report action defined in Cognos Connection. 9. From the Format list, select the output format for the report when it runs. You can choose HTML, PDF, Excel 2007, Excel 2002, Excel 2000 Single Sheet, Delimited Text (CSV), XML, and Default, which uses the output format defined in Cognos Connection. 10. Optionally, select the Open In New Window check box to open the target report in a new window when it is accessed from the source report. If you do not select this check box, the target report replaces the source report in the Cognos Viewer. 11. Click Edit to display details the parameters from the target report. The Parameters window is displayed. 12. From the Method list, select the method for passing the parameter. You can choose from Do Not Use Parameter, which does not pass the parameter; Pass Data Item Value, which passes a value from a data item within the source report; Pass Parameter Value, which passes a parameter value from the source report; or Default, which does not pass the parameter. For this example, select Pass Data Item Value. 13. From the Value list, select the Data Item value from the source report. In this example, we use Date_Key_Day and MTP3_DSP_ID. Chapter 4. Getting started with Wireless reports 27

36 14. Click OK. The parameters to pass to the drill-through definition display in the Parameters pane on the Drill-Through Definitions window. 15. From the Display Prompt Pages list, select an option for when to display the prompt pages. The available options are Always, Based On The Default Prompt Settings Of The Target Report, and Only When Required Parameter Values Are Missing. For this example, select Only When Required Parameter Values Are Missing. 16. Click OK. Report Studio updates the report. The data item being used as a drill-through object becomes a hyperlink, and the drill-through icon is displayed. 17. Run the report to test the drill-through. The source report opens in Cognos Viewer and the data items containing the drill-through definition display as hyperlinks that allow you to drill-through to the target report. 18. From the column containing the drill-through definition links, click a hyperlink. The drill-through target report displays with detailed information about the selected item. In this example, the target report opens and displays detailed information about the raw KPIs for the selected resource and date range. 28 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

37 Including multiple granularity items in the same report You can include items of multiple granularity in the same report. Use this set of examples and information to help you with this feature. Displaying multiple granularity items with drill-down only This example task assumes that you want to display data of multiple granularities in the same report. You can drill up and drill down by time or by resource, in this example, the drill-down is by time. The lowest level of granularity is 5 minutes, the 5-minute timestamp value is displayed in the report. The other data is drilled down to this level. About this task Table 1. Granularity and KPI Granularity KPI 5 min BSCLOOP_FAIL_APPLY_TRSL_FAIL 10 min IMM_ASS_CH_ALLOC_REQ_SD 15 min PREFER_TCHH_IP_HDLC_TRANS 30 min IMM_ASS_CH_ALLOC_FAIL_SD 60 min TCH_CALL_DROP_TA The report definition is as follows: To report correctly, additional information needs to be added to the report: Procedure 1. From the Keys folder under the Times object, drop and drag the DATE keys of all the traffic data of a higher granularity. (As we are reporting at 5 minutes, we drop in the keys for 10, 15, 20, 30, and Hour) 2. Hide those keys in the report: a. Keeping the Ctrl key pressed, click the column headers and column of each of these keys. b. In the Properties pane, set Box Type property to None. Chapter 4. Getting started with Wireless reports 29

38 Note: To view these objects again, view the report definition in Page Structure mode: View > Page Structure. 3. Run the report. Results The 5-minute data is displayed. The other timestamps are drilled down. Due to the way Common Reporting displays reports, metrics that have a greater time granularity than the level at which the report is based can show duplicate results. You can avoid these duplicates by using the method detailed in the UDC calculations and drill downs on page 31 topic. The UDC is as follows: if (DATE_KEY_15 = DATE_KEY_HOUR) then ([TCH_CALL_DROP_TA]) else null Displaying multiple granularity items with drill up and drill down This example task assumes that you want to display data of multiple granularities in the same report. You can drill up and drill down by time or by resource. Here we are going to create a report with some counters drilled up and some drilled down by time. About this task Taking the example data in the table, you can create a report that reports data at 30-minute intervals. Hence, expect the 5, 10 and 15-minute data to drill up and the hourly data to drill down. Table 2. Granularity and KPI Granularity KPI 5 min BSCLOOP_FAIL_APPLY_TRSL_FAIL 10 min IMM_ASS_CH_ALLOC_REQ_SD 15 min PREFER_TCHH_IP_HDLC_TRANS 30 min IMM_ASS_CH_ALLOC_FAIL_SD 60 min TCH_CALL_DROP_TA Procedure 1. Drag all the KPIs, CELLID, and 30-minute object into the table. For each object that you want to drill down on, you must include the key for that granularity. Therefore, in this example, you can drag in the DATE_KEY_HOUR key. 30 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

39 2. Hide those keys in the report: a. Keeping the Ctrl key pressed, click the column headers and column of each of the keys. b. In the Properties menu, set Box Type to None. Note: To view these objects again, view the report definition in Page Structure mode: View > Page Structure. 3. Run the report. UDC calculations and drill downs This example partially replicates the functionality of Tivoli Netcool Performance Manager - Wireless Component. In a drill-down scenario, we create a User Defined Calculation (UDC) that is calculated at run time as the sum of two other calculations. However, one raw counter has a 5-minute granularity and the other has an hourly granularity. The expected result is that we add the counters together only when the timestamps match, that is, on the hour. The report result is as follows; we add the hourly column only when the timestamps are equal. Chapter 4. Getting started with Wireless reports 31

40 This result is achieved as follows, the method used here avoids problems with data corruption. Add the following columns to the report: [TNPM Huawei BSS Measurements (Consolidation)].[Cell.Huawei.Generic.Local_switch_call_drops]. [BSCLOOP_FAIL_APPLY_TRSL_FAIL] [TNPM Huawei BSS Measurements (Consolidation)].[Cell.Huawei.Generic.TCH_call_fail_per_cell]. [TCH_CALL_DROP_TA] When creating the UDC, use the column values rather than the database values. That is, when creating the expression in the Data Item Expression window, choose the metrics from the Data Items tab, rather than the Source tab. This method performs the calculation on the visible results in the existing columns, rather than the values taken from the database. Edit the UDC formula to be something as follows: IF ( [TCR Time (Presentation)].[Time].[DATE_KEY_5] = [TCR Time (Presentation)].[Time].[DATE_KEY_HOUR] ) THEN ( [BSCLOOP_FAIL_APPLY_TRSL_FAIL] +[TCH_CALL_DROP_TA] ) ELSE ([BSCLOOP_FAIL_APPLY_TRSL_FAIL] ) Now that the UDC is complete the two metrics you added can be hidden by setting the Box Type property to none in the Properties pane. If the timestamps match we add the counters together, otherwise we display only the counter from the 5 minute data. 32 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting