getting started with common reporting guide · ibmtivoli netcool performance manager,version 1.3.2...

IBM Tivoli Netcool Performance Manager, Version 1.3.2Model Maker 1.2.0Document Revision R2E1

Getting Started with CommonReporting Guide

��

NoteBefore using this information and the product it supports, read the information in “Notices” on page 31.

© Copyright IBM Corporation 2011, 2012.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

About this information . . . . . . . . v

Getting started with Common Reporting 1Common Reporting on Tivoli Netcool PerformanceManager . . . . . . . . . . . . . . . . 1

Accessing Common Reporting in Tivoli NetcoolPerformance Manager . . . . . . . . . . 1Common Reporting . . . . . . . . . . . 2Web-based report authoring . . . . . . . . 3Performing ad-hoc reporting . . . . . . . . 4

TCR Time contents . . . . . . . . . . . . 4Reports containing both wireless and wireline data . 7Getting started with wireline reports . . . . . . 7

Limitation on selecting resources in wirelinereports . . . . . . . . . . . . . . . 7Optimizing the common pack attribute datasource to improve report performance . . . . . 7Wireline data sources . . . . . . . . . . 8Wireline Report Templates . . . . . . . . . 8

Using the wireline report template . . . . . . 9Design considerations for wireline report authors 13

Getting started with wireless reports . . . . . . 15Authoring a simple report . . . . . . . . 15Authoring an efficient report . . . . . . . 16Authoring a drill-down report . . . . . . . 18Authoring a charting report . . . . . . . . 19Drill-through reports . . . . . . . . . . 21Including multiple granularity items in the samereport . . . . . . . . . . . . . . . 25

Known Common Reporting issues. . . . . . . 29Additional resources . . . . . . . . . . . 29

Books . . . . . . . . . . . . . . . 30Web Resources . . . . . . . . . . . . 30

Notices . . . . . . . . . . . . . . 31Trademarks . . . . . . . . . . . . . . 33Additional copyright notices. . . . . . . . . 33

© Copyright IBM Corp. 2011, 2012 iii

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

About this information

The IBM Tivoli Netcool® Performance Manager: Getting Started with Common ReportingGuide describes how to get started with Common Reporting in Tivoli NetcoolPerformance Manager.

© Copyright IBM Corp. 2011, 2012 v

vi IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

Getting started with Common Reporting

This information explains how users of Tivoli Netcool Performance Managerwireless and wireline components can get started with Tivoli Common Reportingfor network performance management. You are guided through the basic reportingtasks, with particular emphasis on techniques that are unique to performancemanagement.

Tivoli Common Reporting is based on IBM Cognos Business Intelligence, anenterprise reporting solution. It delivers a subset of IBM Cognos BusinessIntelligence functionality as a common reporting platform across the Tivoliportfolio. By using Model Maker IBM Cognos Edition, you can extend thedomain-specific reporting capabilities of technology packs to Common Reportingby deploying common packs on your system.

This information is not a comprehensive guide to Tivoli Common Reporting orIBM Cognos, or a substitute for their respective documentation sets. Rather, it iscomplementary information that focuses on specific reporting issues forperformance management reporting on telecommunications technology.

Common Reporting on Tivoli Netcool Performance ManagerAn overview of Tivoli Common Reporting for Tivoli Netcool Performance Managerusers.

Accessing Common Reporting in Tivoli Netcool PerformanceManager

Wireless users access Common Reporting from a separately installed TivoliCommon Reporting interface. Wireline users access Common Reporting in theTivoli Netcool Performance Manager console. As both applications share the TivoliIntegrated Portal user interface, the basic steps are the same.

Before you begin

Ensure that you have the appropriate login credentials from your administrator.

Procedure1. Log in to the Tivoli Integrated Portal.2. In the left navigation, expand Reporting > Common Reporting. The Common

Reporting tab opens showing you the Working with reports page.

© Copyright IBM Corp. 2011, 2012 1

Common ReportingUse the Common Reporting task to publish, find, manage, organize, and view yourorganization’s Business Intelligence content, such as reports, scorecards, andagents. If you have the necessary permissions, you can access the Report Studioand Query Studio or access the administration functions for contentadministration, including scheduling and distributing reports, and creating jobs.

You view reports in Cognos Viewer.

System administrators also use the portal to administer servers, optimizeperformance, and set access permissions.

Users of Cognos Connection will be familiar with the Common Reporting task.Cognos Connection is the Web portal for IBM Cognos Business Intelligence 8. It isthe starting point to access Business Intelligence information and the functionalityof IBM Cognos 8.

For more information, see the IBM® Cognos® 8 Business Intelligence Getting StartedGuide at http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/topic/com.ibm.swg.im.cognos.wig_cr.8.4.0.doc/wig_cr.html

Report StudioReport Studio is a Web-based tool that professional report authors use to buildsophisticated, multiple-page, multiple-query reports against multiple databases.With Report Studio, you can create any report that your company requires, such asinvoices, statements, and weekly sales and inventory reports.

For more information about Report Studio, see the Report Studio ProfessionalAuthoring User Guide at http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/topic/com.ibm.swg.im.cognos.ug_cr_rptstd.8.4.1.doc/ug_cr_rptstd.html.

Query StudioQuery Studio is the reporting tool for creating simple queries and reports in TivoliCommon Reporting.

For more information about Query Studio, see the Query Studio User Guide athttp://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/index.jsp?topic=/com.ibm.swg.im.cognos.ug_cr_qstd.8.4.0.doc/ug_cr_qstd.html.

AdministrationFrom the Administration component, you can perform server administration, datamanagement, security and content administration, activities management, andportal services administration.

For more information about the Administration component, see the IBM Cognos 8Administration and Security Guide at http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/index.jsp?topic=/com.ibm.swg.im.cognos.ug_cra.8.4.1.doc/ug_cra.html.

2 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/topic/com.ibm.swg.im.cognos.wig_cr.8.4.0.doc/wig_cr.html

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/topic/com.ibm.swg.im.cognos.wig_cr.8.4.0.doc/wig_cr.html

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/topic/com.ibm.swg.im.cognos.ug_cr_rptstd.8.4.1.doc/ug_cr_rptstd.html

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/topic/com.ibm.swg.im.cognos.ug_cr_rptstd.8.4.1.doc/ug_cr_rptstd.html

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/index.jsp?topic=/com.ibm.swg.im.cognos.ug_cr_qstd.8.4.0.doc/ug_cr_qstd.html

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/index.jsp?topic=/com.ibm.swg.im.cognos.ug_cr_qstd.8.4.0.doc/ug_cr_qstd.html

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/index.jsp?topic=/com.ibm.swg.im.cognos.ug_cra.8.4.1.doc/ug_cra.html



Web-based report authoringCreate reports in a Web-based tool that professional report authors use to buildsophisticated, 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.

Procedure1. Log in to the Tivoli® Common Reporting interface, and go to Common

Reporting.2. In the Work with reports window on the right choose Report Studio from the

Launch drop-down list. This opens up the Report Studio, a Web-basedapplication.

3. Use the menu controls to create a report or edit existing ones by formatting thelayout and manipulating the data that appears in the report.

4. Save your report, and run it at any time.

What to do next

Learn more about Web-based report authoring in Report Studio ProfessionalAuthoring User Guide available on clicking F1 from the Report Studio.

Report SpecificationsWhen you author a report, you actually create a report specification. The reportspecification is an XML representation of the queries and prompts that are used toretrieve data, as well as the layouts and styles used to present the data. Forsimplicity, the report specification is called the report.

Report specifications can be useful to report authors for troubleshooting. You cansee the XML specification for a report at any time by selecting Tools > ShowSpecifications from Report Studio.

For information about working with report specifications, see the Report StudioProfessional Authoring User Guide.

Models and packagesBecause stored data is typically designed for storage and not for reporting, a datamodeler uses Framework Manager to create metadata models. A model structures,adds to, and manages data in ways that make sense to business users. Forexample, a model defines business rules, data descriptions, data relationships,business dimensions and hierarchies, and other administrative tasks.

Planning and creating a model is an important task that should be performed by amodeler or a modeling team familiar with both the database structure and theneeds of the users.

After the metadata model is defined, modelers create a package to make metadataavailable to report authors. Each package must contain all the information that aspecific user or group of users needs to create reports. The Model Maker tooling inTivoli Netcool Performance Manager simplifies the creation of packages for TivoliNetcool Performance Manager users.

Generally, each report can contain data from only one package. However, usingModel Maker, modelers can combine models and create a single package frommultiple models to allow reporting across multiple dimensions.

Getting started with Common Reporting 3

Performing ad-hoc reportingCreate 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.

Procedure1. Log in to the Tivoli Common Reporting interface, and go to Common

Reporting.2. In the Work with reports window on the right choose the Query Studio from

the Launch drop-down list.3. Select a package to work with. This opens a New window where you can

create the new report.4. From the navigation on the left drag and drop data items you want to include

in your report.

Tip: Change the appearance of the data by using the menu icons at the top.5. Once your 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 UserGuide.

TCR Time contentsThe following timestamp items are available in the TCR Time base common pack.

Day, Hour, Minute

Presentation View Description Oracle Type Oracle function used when populatingcolumn

Standard Timestamp Timestamp representing thestart of the time period beingreported on. Aligns with thegranularity of the calendar.

TIMESTAMP loaddate where loaddate is thetimestamp for the interval we arepopulating the table with. 01/01/201100:00:00

Date Date of the associatedcalendar entry (that is,midnight of that day).

DATE trunc(loaddate ,'DD')

Year-Month-Day (2012-03-27) VARCHAR(10) to_char(loaddate, 'YYYY-MM-DD')

Day Day in the month (1-31). SMALLINT to_char(loaddate,'DD')

YMD-H 2012-03-27 16:00 VARCHAR(16) to_char(trunc(loaddate, 'HH24'),'YYYY-MM-DD HH24')

Hour Hour of the day (0-23). SMALLINT to_char(loaddate,'HH24')


http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/topic/com.ibm.swg.im.cognos.ug_cr_qstd.8.4.0.doc/ug_cr_qstd.html

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/topic/com.ibm.swg.im.cognos.ug_cr_qstd.8.4.0.doc/ug_cr_qstd.html

YMD-H 30 Min String representation of the30 minute interval timestampcolumn for example,01/01/2011 00:30:00

VARCHAR(16) to_char(ts30, 'YYYY-MM-DDHH24:MI') where ts30 is the loaddatetimestamp truncated to a 30 minuteinterval

30 Minute Current minute integer valueof the 30 minute intervaltimestamp.

SMALLINT to_char(ts30, 'MI')

YMD-H 15 Min String representation of the15 minute interval timestampcolumn for example,01/01/2011 00:15:00


15 Minute Current minute integer valueof the 15 minute intervaltimestamp


YMD-H 10 Min Current minute integer valueof the 10 minute intervaltimestamp.


10 Minute Current 30 minute value ofthe timestamp (50).


YMD-H 5 Min String representation of the 5minute interval timestampcolumn for example,01/01/2011 00:05:00

VARCHAR(16) to_char(ts5, 'YYYY-MM-DD HH24:MI')where ts5 is the loaddate timestamptruncated to a 5 minute interval

5 Minute Current minute integer valueof the 5 minute intervaltimestamp.


Minute Current single minute value(59).

SMALLINT to_char(loaddate,'MI')

Year, Quarter, Month, Day

Presentation View Description Oracle Type Oracle function used when populatingcolumn

Year Year in 4-digit formatfor example, 2012.

SMALLINT to_char(loaddate,'yyyy')

Quarter Quarter of the year (1,2, 3 or 4).

SMALLINT to_char(loaddate,'Q')

Year-Quarter 2010-1 VARCHAR(7) to_char(loaddate, 'YYYY-Q')

Month (Numeric) Month (01-12). SMALLINT to_char(loaddate,'mm')

Month Name of the Month. VARCHAR trim(to_char(loaddate,'MONTH'))

Year-Month 2010-03 VARCHAR(7) to_char(loaddate, 'YYYY-MM')

Days in Month Number of days in themonth (31).

SMALLINT ADD_MONTHS(to_date(TO_CHAR(loaddate,'yyyy-mm')||'-01', 'yyyy-mm-dd'),1) -to_date(TO_CHAR(loaddate,'yyyy-mm')||'-01', 'yyyy-mm-dd')

Week of Year Week of year (1-53)where week 1 startson the first day of theyear and continues tothe seventh day of theyear.

SMALLINT to_char(loaddate,'ww')


Week of Quarter Week of Quarter (1-13)13 weeks per quarter.

SMALLINT to_char(loaddate,'ww') -(to_char(loaddate,'Q') - 1)*13

Week of Month Week of month (1-5)where week 1 startson the first day of themonth and ends onthe seventh.

SMALLINT round(to_char(loaddate,'dd')/7 + 1)

where loaddate is the timestamp interval weare populating.

Weekday Name of the Day. VARCHAR trim(to_char(loaddate,'DAY'))

Day of Year Day of year (1-366). SMALLINT to_char(loaddate,'DDD')

Day of Week Day of week (1-7). SMALLINT to_char(loaddate,'D')

ISO Year and Week

Presentation View Description Oracle Type Oracle function used whenpopulating column

Year (ISO) 4-digit year based on ISOstandard.

SMALLINT to_char(loaddate, 'IYYY')

Week (ISO) Week of year (1-52 or 1-53) basedon ISO standard.

SMALLINT to_char(loaddate, 'IW')

Year-Week-Day (ISO) Year, week, and Day based onISO standard for example,2012-W13-2.

VARCHAR(10) to_char(loaddate,'IYYY-"W"IW-') ||to_char(floor(loaddate -trunc(loaddate, 'IW')) + 1)

Keys

Presentation View Oracle Type

TIMESTAMP_KEY_5 TIMESTAMP




HOUR_KEY TIMESTAMP

DAY_KEY TIMESTAMP

WEEK_KEY TIMESTAMP

WEEK_KEY_ISO TIMESTAMP

MONTH_KEY TIMESTAMP

QUARTER_KEY TIMESTAMP

YEAR_KEY TIMESTAMP

YEAR_KEY_ISO TIMESTAMP

DATE_KEY_5 DATE

DATE_KEY_10 DATE

DATE_KEY_15 DATE

DATE_KEY_30 DATE

DATE_KEY_HOUR DATE

DATE_KEY_DAY DATE

DATE_KEY_WEEK DATE


DATE_KEY_WEEK_ISO DATE

DATE_KEY_MONTH DATE

DATE_KEY_QUARTER DATE

DATE_KEY_YEAR DATE

DATE_KEY_YEAR_ISO DATE

TIME_RANGE_END DATE

CANDLETIMESTAMP CHAR(16)

END_CANDLETIMESTAMP CHAR(16)

Reports containing both wireless and wireline dataYou have the option to install the Common Pack Service so that you can includedata from both the wireless and wireline databases in reports.

While you can include both wireless and wireline data in the same report, there iscurrently no relationship between the data.

Getting started with wireline reportsThis information can help you get started with Common Reporting on wirelinenetworks with Tivoli Netcool Performance Manager.

Limitation on selecting resources in wireline reportsA limitation in Tivoli Common Reporting affects the number of resources that youcan select in wireline reports. You must not directly select more than 180 resourceswhen authoring reports from Tivoli Netcool Performance Manager models inReport Studio or Query Studio.

Directly selecting more than 180 resources can push the number of characters inyour query over a known limit, and cause the report to fail with an error.

However, this limitation does not apply when selecting the resources in a group.To select large numbers of resources, use the select all option on the report promptpage to select all the resources in a group. Then use filtering to select the resourcesyou want.

Alternatively, you can design reports to limit your selection to less than 180resources.

Optimizing the common pack attribute data source to improvereport performance

For improved performance, it is recommended that you review the common packattribute data source ibm.tivoli.tnpm.packname.resourceType.attribute attributeto see if all the properties are required. If some properties are not needed, you canremove them from the data source file.

Removing data sources improves the overall query time for all data sources thatrequire properties. Removing data sources also reduces the amount of temporaryspace that Tivoli Common Reporting requires to merge the data.


Wireline data sourcesWireline reports use two types of data source, a raw data source or a summarydata source.

Raw data source

Raw data is collected on the collection-time interval as configured in thewireline component.v Snapshot of the value of a metric for a particular timestamp based on

collection interval (example 15 minutes).v Used to display the detail raw value of a metric for a particular resource

based on the collection interval.v Timestamp return will be adjusted based on selected time zone in the

prompt page.

Summary data source

The summary data source collects 24-hour-data pre-aggregated by Provisobased on the timezone configured on Proviso. There are 5 types ofaggregation available in the summary-datasource, that is:- sum, count,max, min and average.v Raw Data is pre-aggregated into daily (24 hours) based on the time zone

configured in the wireline componentv Metric value is aggregated into 5 values, MIN, MAX, AVERAGE,

COUNT and SUM.v Data are always aggregated based on timezone configured in the

wireline component and are not affected by the time zone selected in theprompt page.

Wireline Report TemplatesYou can use the provided templates to quickly get started with creating reports,without having to build the prompt pages from scratch.

TNPM Wireline Raw Report Template

These report templates replace an older template called TNPM Wireline ReportTemplate, so if you have this older version on your system, do not use it.

The default prompt page in this template allows you to select a date and timewhen generating a report, making it suitable for use with the raw data source. Thistemplate is not suitable for the summary data source because summary data sourceis pre-aggregated into 24 hours so the time do not have any impact to the reportand it create confusion.

TNPM Wireline Summary Report Template

The default prompt page in this template allows you to select a date, but not atime, when generating a report and is suitable for the following types of report:v Raw data source reports that do not need a time selection. For example, the

"Device Health Summary Report" report in ALU 5529 SDC to show raw metricsfor a full day in 24 hours.

v Summary data source reports, as the summary data source does not supporttime selection.

v Reports with a mixture of raw data source and summary data source. In thisscenario, ensure that no time is selected so data is always in 24 hours blocks,


which is how summary data sources are aggregated. This avoids the issue wherethe raw data source and summary data source results do not match. Forexample, the "All KPI Report" mixes both raw and summary data sources.

The default prompt page

The default prompt page in this template allows you to select a date, but not atime, when generating a report and is suitable for the following types of report:v Raw data source reports that do not need a time selection. For example, the

"Device Health Summary Report" report in ALU 5529 SDC to show raw metricsfor a full day in 24 hours.

v Summary data source reports, as the summary data source does not supporttime selection.

v Reports with a mixture of raw data source and summary data source. In thisscenario, ensure that no time is selected so data is always in 24 hours blocks,which is how summary data sources are aggregated. This avoids the issue wherethe raw data source and summary data source results do not match. Forexample, the "All KPI Report" mixes both raw and summary data sources.

Using the wireline report templateThe following procedure explains how to use the TNPM Wireline Report Templateto create a report. In the example procedure, we use the Alcatel 5529 SDC commonpack to illustrate the steps. You can modify the charts or tables you need, anddelete the rest.

About this task

This task assumes that the Alcatel 5529 SDC common pack package has beenpublished, and that the TNPM Wireline Raw Report Template is available inCommon Reporting.

Procedure1. In the Tivoli Integrated Portal, select Reporting > Common Reporting.2. On the toolbar, click Launch and select Report Studio.3. On the Select a package window, under Public Folders, select the

ibm.tnpm.wireline.common package. Report Studio opens.4. On the Welcome window, select Open an existing report or template.5. On the Open page, select the TNPM Wireline Raw Report Template and click

Open.6. For this example, we use the Alcatel 5529 SDC package. Select File > Report

Package.7. On the Report Package window, Select the ibm.tnpm.alcatel.5529.sdc package

and click OK. A prompt window opens. When you open a wireline datamodel, you are prompted for the values normally provided in the defaultreport prompt screens.

8. On the prompt window, click Cancel and on the next window, click OK. AllAlcatel 5529 SDC objects are now available in the Insertable Objects pane.

9. Save the report as Wireline_Test_Report in My Folders.The report template contains a Chart Type section containing charts like thefollowing charts.


The template contains a Table section containing lists (tables) like thefollowing lists.


The Insertable Objects pane contains the available Alcatel 5529 SDC KeyPerformance Indicators (KPIs). Expand TNPM alcatel_5529_sdc (Presentation)to show the KPIs.

There are 10 different groups of metrics, divided into raw and summarymetrics. Because of the frequency of data collection, raw metrics are suitablefor both charts and tables, while summary metrics are best suited for tables.

10. Start by modifying the time series chart. To create a time series report, selectone or more raw metrics and drag them to the Series drop box, and select a


time object and drag it to the x-axis drop box. You can also drag an object topopulate the y-axis or populate the other annotation fields, such as the x- andy-axis titles.

11. The Tivoli Netcool Performance Manager collection interval can be up to 1minute, so reduce the time granularity for plotting the chart from HH:MM:SSto HH:MM. This results in better plotting of results in the chart and avoidsoverlapping data points caused by the longer collection frequency.a. Double-click the time object. The Data Item Expresssion - time window

opens.b. In the Expression Definition pane, replace the existing definition with the

following definition.substring(cast([TNPM alcatel_5529_sdc (Presentation)].[ibm.tnpm.alcatel_5529_sdc.Card.Raw].[time],varchar(30)),1,16)+IF(extract(hour,[TNPM alcatel_5529_sdc (Presentation)].[ibm.tnpm.alcatel_5529_sdc.Card.Raw].[time]) < 12) THEN( ' AM ' ) else ( ' PM ')

Note: There are separate time objects for both Interface and Device, ensurethat they are correctly mapped. For example,ibm.tnpm.alcatel_5529_sdc.Card.Raw andibm.tnpm.alcatel_5529_sdc.Ethernet LAG.Raw.

12. You must add a repeater to the chart so that the chart query runs for eachresource that you select.a. Drag a repeater object to the chart box.b. Modify the repeater properties.

c. Link the repeater to the appropriate query. In this example, we are settingChartQuery1 to repeat for the resource name.

13. The Table section contains list items that you can update. From the InsertableObjects pane, drag insertable objects into the list . For example, to create aCard Summary report:a. Expand TNPM alcatel_5529_sdc (Presentation) >

ibm.tnpm.alcaltel_5529_sdc.Card.Summary to show the KPIs.


b. Drag resourceName into the first column.c. Drag CPU Utilization (max) into the next column.d. Drag Memory Utilization (max) into the next column

14. Return to Common Reporting and click the My Folders tab.

15. Find Wireline_Test_Report in the list of reports and click the Run buttonto run the report.

16. The template contains a prompt page, that prompts for the time range, thereport group, and the resources when running the report. Complete each stepin the prompt page, and run the report.There is a limitation on the number of resources that you can include in areport. Ensure that you do not select more than 180 resources.

Design considerations for wireline report authorsFor best results when authoring reports for Common Reporting, keep in mind thefollowing design considerations and limitations.

Be aware of the following behavior:v The data source test in Tivoli Common Reporting always fails for attribute data

sources, but that does not mean that there is a problem with the data source.The test fails because there is no value for the ??group?? parameter. The CognosServlet indicates that an invalid group name was provided. The ??group??parameter value is normally provided at a prompt page when running thereport so is not present when running the data source test function.

v The TCR Time dimension in wireline common packs supports only a datagranularity of 15 minutes. Therefore, although they are in the data model, do notuse the TCR Time insertable objects for 10 minute and 5 minute granularity.

v If you include images in your reports, test them thoroughly with the Exceloutput.

Time zone limitation for pre-1.3D common packsThis limitation occurs if you develop reports using the report templates, with thenew prompt page, delivered in wireline common 1.0.1 BCP for common packsdeveloped prior to 1.3D.

Regardless of what time zone is selected in the new default prompt page, it doesnot affect the report result. The report still works in GMT, not the time zoneselected in the prompt page.

Modifying timestamps in custom charts to round up to minutesinstead of millisecondsBy default, timestamps in reports created by using the wireline data models arerounded up to milliseconds. This task explains how to change the report to roundthe timestamps up to minutes instead.

About this task

This procedure assumes that time data item found on the Source is inserted intothe chart or table in Report Studio as shown. Repeat these steps as required whilecreating custom charts or tables.

Procedure1. 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 expressionremoves seconds and milliseconds, resulting in the display of year-month-dayhour:minute only.

3. Save the expression by clicking OK.

Limitations on selecting time ranges for summary dataThere are two limitations on how you can select time ranges for summary data.

You must use the default start time for summary data

Wireline reports containing summary data must use the default start time in theprompt page or no summary data is displayed in the report.

To display reports containing summary data for the same start and end date, youmust use the default start time of 12:00 AM in the prompt page. If you modify thestart time to a value other than 12:00 AM, then no summary data is returned.

For example, the following filtering condition on a table or graph containingsummary data returns no data.Start date= April 28Start time > 1:00AM

End date=April 28End time = > any

You must select time ranges in multiples of one day

SymptomsSummary data is aggregated for one day (24 hours) even if the selectedtime range is less than one day. Summary data for periods of more thanone day, but not a multiple of 24, is aggregated up to the next 24-hourperiod.

CausesSummary data cannot show data aggregated for a partial day.

Example: Less than 24 hoursFor example, if you select a time range of 10 hours as follows:

Start Time: 1:00 AM

End Time: 11:00 AM

Raw data is returned for the specified time range of 10 hours. Summarydata should be also aggregated for this 10-hour period. However, thesummary data is aggregated for one day (24 hours).

Example: More than 24 hoursFor example, if you select a time period of 32 hours, the data is aggregatedfor 48 hours (2 x 24 hours).

Conforming to Cognos reporting guidelinesTo conform to the Cognos reporting guidelines, leave table cells with no data blankrather than using a dash (-) to indicate no data.

In wireline reports for previous wireline versions, dashes were used (-) in tablecells where there is no data.


Microsoft Excel formatting limitationsWhen authoring reports, be aware that wireline users can still experience someformatting problems with charts that have a decimal number on the y-axis. Theseissues are due to formatting limitations in Microsoft Excel 2007.

If this problem occurs, use Report Studio to modify the chart and change the dataformat 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 aredirected to always select Microsoft Excel 2007. Due to formatting limitations inolder versions of Excel, exporting in versions such as 2000 or 2002 can produceincompatible charts. Always ensure that you test your reports in Microsoft Excel2007.

If you include icons in your reports, test them thoroughly with the Excel exportoption.

Report titles and labels are displayed in ASCII formatCertain technology packs do not automatically convert the resourceAlias attributefrom ASCII format to text. If you are working with reports on one of these packs,titles and labels are displayed as a long ASCII string.

If you are creating Common Reporting reports for one of these technology packs,open Report Studio and modify the affected titles or labels to use resourceNameinstead of resourceAlias.

Getting started with wireless reportsThis information can help you get started with Common Reporting on wirelessnetworks with Tivoli Netcool Performance Manager.

Authoring a simple reportYou can follow these basic steps to create a simple report. This example uses thepackage created when the Huawei GSM BSS common pack is published.

Procedure1. 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 theTCR Time (Presentation) > Time > Keys > DATE_KEY_HOUR key into thelist.

6. Select a primary key or an entity ID and drag it into the list right beside theDATE_KEY_HOUR key. Ensure that your selection is in the list, if a singletonis created, click Undo and try again. In this example, drag TNPM MobileGSM (Presentation) -> TNPM GSMCell -> CELL_ID into the list.

7. Select metrics and drag them into the list next to the CELL_ID column. In thisexample, 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 on the toolbar. The prompt pageis automatically generated.

9. Save the report as Simple_Report in My Folders.10. Return to Common Reporting and click the My Folders tab.

11. Find Simple_Report in the list of reports and click the Run button to runthe report.

Authoring an efficient reportThe Tivoli Netcool Performance Manager database relies heavily on an Oraclefeature called Partition Pruning to efficiently process data. Reports must be definedin a certain way to ensure that Oracle has enough information to identify datapartitions.

About this task

You can build a prompt page to ensure that Oracle has the required information toidentify data partitions. These steps assume that you have created a list report with15-minute data by dragging the appropriate report items into the report.

Procedure1. 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 aprompt.

2. Select the DATE_KEY_15 column and click the Build Prompt page button on thetoolbar. A prompt is created for the report.


3. Return to the report definition page and remove the DATE_KEY_15 column byright-clicking and selecting cut. You must remove the key or the report displaysonly the raw data with the drill up.

4. Save and run the report.


Authoring a drill-down reportIn this example, we edit the Simple_Report report to allow drill up and drill downlevels for both time and resource (entity) in the report.

Procedure1. 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 inthe context of this report.

d. Point to Page Explorer button to see the Page Explorer, right-click onPrompt 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 whenyou run this report. If you want, you can also add a filter to restrict the timescope on which the report is displayed, the prompt page is not as useful inthis scenario as it would restrict the drilling process.

8. Add a filter to limit the time scope of the report by completing the followingsteps: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 thedialog 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.


e. The DATE_KEY_DAY key does not need to be displayed so you can hideit. Select the title of the column, and in the Properties window, set BoxType to none, Select the column body and in the Properties window, setBox 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 torun the report.

12. When the report viewer has appeared, the entries under Cell and Day shouldbe highlighted, you can click these entries to perform a drill down or you canright-click and select drill up to perform a drill up.

Authoring a charting reportCharts are a graphical representation of tabular data. They can be used to quicklyidentify large numeric data for different areas of business. They are commonlyused in dashboard style reports.

Procedure1. 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, andCategories (x-axis).

9. From the Source tab in the Insertable Objects pane, drag a data item to theSeries drop zone. In this example, we drag the Raw KPI to the Series dropzone.


10. From the Source tab in the Insertable Objects pane, drag a TCR data item tothe Categories drop zone. In this example, we also include the CELL_IDmeasure from the Orders query subject in the Default measure drop zone.

11. From the Standard toolbar, click Run Report. The results are displayed.


Drill-through reportsCreating drill-through access within a report makes it easier for you to navigatethrough large reports or to link separate reports containing related information.

When you create drill-through access, you can create a bookmark that lets younavigate through a particular dimension of a report or pass a parameter from asource report to a target report. When the drill-through data item value in thesource report is selected, the target report opens. The target report is filtered on theparameter that was passed from the source report. This filtering allows you to linkseparate reports with related information. For the following example, we set updrill-through access using two separate reports: a target report, and a sourcereport.

Authoring a drill-through target reportA 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 informationwithout 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 thesource report.

The Date_Key_Hour key is added to the report and hidden; it is used in the drillthrough, but not required in the report.

Procedure1. 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 theProperties panel, set Box Type = None.

b. Click the list column title for the Date_Key_Hour data item and, in theProperties panel, set Box Type = None.

4. Save the target report. For this example, save the target report as Test Targetreport.

What to do next

Create a source report that contains raw data for all resources.

Authoring a drill-through source reportA source report contains the data item value that you can click to drill-through tothe target report to view more detailed information.

About this task

To set up the source report to contain the drill-through definition, you need toknow the name and location of the target report and the parameter used in thefilter of the target report.


Procedure1. 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 aselection in the work area.

4. Click Launch on the toolbar and select Drill-Through Definitions. TheDrill-Through Definitions window is displayed.

5. Click the New Drill-Through Definition button. A new Drill-Throughdefinition is created.


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. Youcan choose HTML, PDF, Excel 2007, Excel 2002, Excel 2000 Single Sheet,Delimited Text (CSV), XML, and Default, which uses the output formatdefined in Cognos Connection.

10. Optionally, select the Open In New Window check box to open the targetreport in a new window when it is accessed from the source report. If you donot select this check box, the target report replaces the source report in theCognos Viewer.

11. Click Edit to display details the parameters from the target report. TheParameters window is displayed.

12. From the Method list, select the method for passing the parameter. You canchoose from Do Not Use Parameter, which does not pass the parameter; PassData Item Value, which passes a value from a data item within the sourcereport; Pass Parameter Value, which passes a parameter value from the sourcereport; or Default, which does not pass the parameter. For this example, selectPass Data Item Value.

13. From the Value list, select the Data Item value from the source report. In thisexample, we use Date_Key_Day and MTP3_DSP_ID.


14. Click OK. The parameters to pass to the drill-through definition display in theParameters pane on the Drill-Through Definitions window.

15. From the Display Prompt Pages list, select an option for when to display theprompt pages. The available options are Always, Based On The DefaultPrompt Settings Of The Target Report, and Only When Required ParameterValues Are Missing. For this example, select Only When Required ParameterValues Are Missing.

16. Click OK. Report Studio updates the report. The data item being used as adrill-through object becomes a hyperlink, and the drill-through icon isdisplayed.

17. Run the report to test the drill-through. The source report opens in CognosViewer and the data items containing the drill-through definition display ashyperlinks that allow you to drill-through to the target report.

18. From the column containing the drill-through definition links, click ahyperlink. The drill-through target report displays with detailed informationabout the selected item. In this example, the target report opens and displaysdetailed information about the raw KPIs for the selected resource and daterange.


Including multiple granularity items in the same reportYou can include items of multiple granularity in the same report. Use this set ofexamples and information to help you with this feature.

Displaying multiple granularity items with drill-down onlyThis example task assumes that you want to display data of multiple granularitiesin the same report. You can drill up and drill down by time or by resource, in thisexample, 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 drilleddown to this level.

About this task

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:

Procedure1. 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, andHour)

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.

Note: To view these objects again, view the report definition in Page Structuremode: 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 greatertime granularity than the level at which the report is based can show duplicateresults. You can avoid these duplicates by using the method detailed in the “UDCcalculations and drill downs” on page 27 topic. The UDC is as follows:if (DATE_KEY_15 = DATE_KEY_HOUR) then([TCH_CALL_DROP_TA])elsenull

Displaying multiple granularity items with drill up and drill downThis example task assumes that you want to display data of multiple granularitiesin the same report. You can drill up and drill down by time or by resource. Herewe are going to create a report with some counters drilled up and some drilleddown by time.

About this task

Taking the example data in the table, we create a report that reports data at30-minute intervals. Hence we expect the 5, 10 and 15 minute data to drill up andthe hourly data to drill down.

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

Procedure1. Drag all the KPIs, CELLID, and 30 minute object into the table. For each object

that we want to drill down on, we must include the key for that granularity.Therefore, in this example, we drag in the DATE_KEY_HOUR key.


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 object again, view the report definition in Page Structuremode: View > Page Structure.

3. Run the report.

UDC calculations and drill downsThis example partially replicates the functionality of Tivoli Netcool PerformanceManager - Wireless Component. In a drill-down scenario, we create a User DefinedCalculation (UDC) that is calculated at run time as the sum of two othercalculations. However, one raw counter has a 5-minute granularity and the otherhas an hourly granularity. The expected result is that we add the counters togetheronly when the timestamps match, that is, on the hour.

The report result is as follows; we add the hourly column only when thetimestamps are equal.


This result is achieved as follows, the method used here avoids problems with datacorruption.

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, choosethe 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 bysetting the Box Type property to none in the Properties pane.

If the timestamps match we add the counters together, otherwise we display onlythe counter from the 5 minute data.


Known Common Reporting issuesCommon Reporting in Tivoli Netcool Performance Manager 1.3.2 is based on IBMTivoli Common Reporting 2.1, which delivers a subset of IBM Cognos BusinessIntelligence 8.4.1 functionality.

When working with performance management reports in Common Reporting, youmight encounter some of the following known limitations or issues. These issues orlimitations can be caused by Tivoli Netcool Performance Manager, or by theunderlying IBM Tivoli Common Reporting or IBM Cognos BI products.

Known issues are documented in the Known Issues with Tivoli Netcool PerformanceManager 1.3.2 technote in the Support knowledge base at http://www-01.ibm.com/support/docview.wss?uid=swg21574017.

This technote contains known issues with Model Maker IBM Cognos Edition andCommon Reporting on Tivoli Netcool Performance Manager, including installation,Model Maker and Common Pack Service issues, and Common Reporting issues.

Other known Common Reporting issues are listed in the Tivoli Common Reporting2.1 documentation at http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp?topic=/com.ibm.tivoli.tcr.doc_21/ctcr_troubleshooting.html.

Additional resourcesUse the following resources to find more information about IBM Tivoli CommonReporting and IBM Cognos Business Intelligence 8.

Community

Service Management Connect (SMC) is a new Integrated Service Managementtechnical community on developerWorks, which connects developers and productexperts with clients and partners through blogs, forums, and wikis. Check outSMC for reporting best practices and other useful information.

To access SMC, join the Register and create a developerWorks profile:https://www.ibm.com/developerworks/dwwi/jsp/Register.jsp

Join the Network and Service Assurance group at:https://www.ibm.com/developerworks/servicemanagement/nsa/index.html

Monitor the Tivoli Netcool Performance Manager Best Practices page for CommonReporting best practices:https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?lang=en#/wiki/Tivoli%20Netcool%20Performance%20Manager/page/Best%20Practices


http://www-01.ibm.com/support/docview.wss?uid=swg21574017

http://www-01.ibm.com/support/docview.wss?uid=swg21574017

http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp?topic=/com.ibm.tivoli.tcr.doc_21/ctcr_troubleshooting.html

http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp?topic=/com.ibm.tivoli.tcr.doc_21/ctcr_troubleshooting.html

https://www.ibm.com/developerworks/dwwi/jsp/Register.jsp

https://www.ibm.com/developerworks/servicemanagement/nsa/index.html

https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?lang=en#/wiki/Tivoli%20Netcool%20Performance%20Manager/page/Best%20Practices



BooksThe following books are available:v IBM Cognos 8 Business Intelligence: The Official Guide by Dan Volitich.v IBM Cognos 8 Report Studio Cookbook by Abhishek Sanghani.

Web ResourcesCheck out other useful Web resources for Tivoli Common Reporting.

The Cognos Proven Practices documentation

Created by Cognos experts from real-life customer experiences, Cognos ProvenPractices is your source for rich technical information that is tried, tested, andproven to help you succeed with Cognos products in your specific technologyenvironment.

http://www.ibm.com/developerworks/data/library/cognos/cognosprovenpractices.html

Common Reporting

For more information about using the product or for technical assistance, visit theIBM® Cognos® Resource Center at http://www.ibm.com/software/data/support/cognos_crc.html. This site provides information about support, professionalservices, and education.

See the Cognos 8 BI at the information center at http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/index.jsp




http://www.ibm.com/software/data/support/cognos_crc.html

http://www.ibm.com/software/data/support/cognos_crc.html

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/index.jsp

http://publib.boulder.ibm.com/infocenter/c8bi/v8r4m0/index.jsp

Notices

This information was developed for products and services offered in the U.S.A.IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not give youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan, Ltd.1623-14, Shimotsuruma, Yamato-shiKanagawa 242-8502 Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certaintransactions, therefore, this statement might not apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.

© Copyright IBM Corp. 2011, 2012 31

IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Corporation2Z4A/10111400 Burnet RoadAustin, TX 78758 U.S.A.

Such information may be available, subject to appropriate terms and conditions,including in some cases payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurement may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. You may copy,modify, and distribute these sample programs in any form without payment toIBM for the purposes of developing, using, marketing, or distributing applicationprograms conforming to IBM‘s application programming interfaces.


If you are viewing this information in softcopy form, the photographs and colorillustrations might not be displayed.

TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks ofInternational Business Machines Corp., registered in many jurisdictions worldwide.Other product and service names might be trademarks of IBM or other companies.A current list of IBM trademarks is available on the Web at “Copyright andtrademark information” at http://www.ibm.com/legal/copytrade.shtml.

Other company, product, and service names may be trademarks or service marksof others.

Additional copyright noticesThe following copyright information is for software used by Tivoli NetcoolPerformance Manager Wireline Component.

Tcl 8.3.3, Combat/TCL 0.7.3, Combat/TCL 0.7.5, TclX 8.3, TK 8.3.3

This software is copyrighted by the Regents of the University of California, SunMicrosystems, Inc., Scriptics Corporation, and other parties. The following termsapply to all files associated with the software unless explicitly disclaimed inindividual files.

The authors hereby grant permission to use, copy, modify, distribute, and licensethis software and its documentation for any purpose, provided that existingcopyright notices are retained in all copies and that this notice is included verbatimin any distributions. No written agreement, license, or royalty fee is required forany of the authorized uses. Modifications to this software may be copyrighted bytheir authors and need not follow the licensing terms described here, provided thatthe new terms are clearly indicated on the first page of each file where they apply.

IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANYPARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIALDAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE, ITSDOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN IF THEAUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANYWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN"AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NOOBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,ENHANCEMENTS, OR MODIFICATIONS.

GOVERNMENT USE: If you are acquiring this software on behalf of the U.S.government, the Government shall have only "Restricted Rights" in the softwareand related documentation as defined in the Federal Acquisition Regulations(FARs) in Clause 52.227.19 (c) (2). If you are acquiring the software on behalf of theDepartment of Defense, the software shall be classified as "Commercial ComputerSoftware" and the Government shall have only "Restricted Rights" as defined inClause 252.227-7013 (c) (1) of DFARs. Notwithstanding the foregoing, the authorsgrant the U.S. Government and others acting in its behalf permission to use and

Notices 33

http://www.ibm.com/legal/copytrade.shtml

distribute the software in accordance with the terms specified in this license.

SCOTTY Stack

This software is copyrighted by Juergen Schoenwaelder, the Technical University ofBraunschweig, the University of Twente, and other parties. The following termsapply to all files associated with the software unless explicitly disclaimed inindividual files.



THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANYWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN“AS IS” BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NOOBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,ENHANCEMENTS, OR MODIFICATIONS.

Various copyrights apply to this package, listed in 3 separate parts below. Pleasemake sure that you include all the parts. Up until 2001, the project was based atUC Davis, and the first part covers all code written during this time. From 2001onwards, the project has been based at SourceForge, and Networks AssociatesTechnology, Inc hold the copyright on behalf of the wider Net-SNMP community,covering all derivative work done since then. An additional copyright section hasbeen added as Part 3 below also under a BSD license for the work contributed byCambridge Broadband Ltd. to the project since 2001.

Part 1: CMU/UCD copyright notice: (BSD like)

Copyright © 1989, 1991, 1992 by Carnegie Mellon University

Derivative Work - 1996, 1998-2000

Copyright © 1996, 1998-2000 The Regents of the University of California

All Rights Reserved

Permission to use, copy, modify and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appears in all copies and that both that copyright notice and thispermission notice appear in supporting documentation, and that the name of CMU


and The Regents of the University of California not be used in advertising orpublicity pertaining to distribution of the software without specific writtenpermission.

CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIMALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALLIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENTSHALL CMU OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BELIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES ORANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATAOR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OROTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITHTHE USE OR PERFORMANCE OF THIS SOFTWARE.

Part 2: Networks Associates Technology, Inc copyright notice (BSD)

Copyright © 2001, Networks Associates Technology, Inc

All rights reserved.

Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met:v Redistributions of source code must retain the above copyright notice, this list of

conditions and the following disclaimer.v Redistributions in binary form must reproduce the above copyright notice, this

list of conditions and the following disclaimer in the documentation and/orother materials provided with the distribution.

v Neither the name of the NAI Labs nor the names of its contributors may be usedto endorse or promote products derived from this software without specificprior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ANDCONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS ORCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUTNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVERCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Part 3: Cambridge Broadband Ltd. copyright notice (BSD)

Portions of this code are copyright © 2001, Cambridge Broadband Ltd.


Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met:v Redistributions of source code must retain the above copyright notice, this list of

conditions and the following disclaimer.

Notices 35

v Redistributions in binary form must reproduce the above copyright notice, thislist of conditions and the following disclaimer in the documentation and/orother materials provided with the distribution.

v The name of Cambridge Broadband Ltd. may not be used to endorse or promoteproducts derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER “AS IS” ANDANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITEDTO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FORA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THECOPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUTNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVERCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

BLT 2.4u

Portions (c) 1993 AT&T, (c) 1993 - 1998 Lucent Technologies, (c) 1994-1998 SunMicrosystems, Inc., and (c) 1987-1993 The Regents of the University of California.

Permission to use, copy, modify and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appears in all copies and that both that copyright notice and thispermission notice appear in supporting documentation, and that the names ofAT&T, Lucent Technologies Inc., Sun Microsystems, Inc. and The Regents of theUniversity of California not be used in advertising or publicity pertaining todistribution of the software without specific written permission.

THE COPYRIGHT HOLDERS AND OTHER CONTRIBUTORS DISCLAIM ALLWARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALLIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENTSHALL THE COPYRIGHT HOLDERS OR OTHER CONTRIBUTORS BE LIABLEFOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANYDAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA ORPROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OROTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITHTHE USE OR PERFORMANCE OF THIS SOFTWARE.

CMU-SNMP 1.14

CMU/UCD copyright notice: (BSD like)

Copyright 1989, 1991, 1992 by Carnegie Mellon University

Derivative Work - 1996, 1998-2000 Copyright 1996, 1998-2000 The Regents of theUniversity of California

All Rights Reserved

Permission to use, copy, modify and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appears in all copies and that both that copyright notice and this


permission notice appear in supporting documentation, and that the name of CMUand The Regents of the University of California not be used in advertising orpublicity pertaining to distribution of the software without specific writtenpermission.


Scotty 2.8, incrTCL 3.0, [incr TCL] 3.2

Portions Copyright (c) 1987-1994 The Regents of the University of California.Copyright (c) 1994-1995 Sun Microsystems, Inc.

This software is copyrighted by the Regents of the University of California, SunMicrosystems, Inc., and other parties. The following terms apply to all filesassociated with the software unless explicitly disclaimed in individual files.



THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANYWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN"AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NOOBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,ENHANCEMENTS, OR MODIFICATIONS.

RESTRICTED RIGHTS: Use, duplication or disclosure by the government is subjectto the restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in TechnicalData and Computer Software Clause as DFARS 252.227-7013 and FAR 52.227-19.

Portions Copyright (c) 1993-1998 Lucent Technologies, Inc.

Permission to use, copy, modify, and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appear in all copies and that both that the copyright notice andwarranty disclaimer appear in supporting documentation, and that the names of

Notices 37

Lucent Technologies any of their entities not be used in advertising or publicitypertaining to distribution of the software without specific, written priorpermission.

Lucent disclaims all warranties with regard to this software, including all impliedwarranties of merchantability and fitness. In no event shall Lucent be liable for anyspecial, indirect or consequential damages or any damages whatsoever resultingfrom loss of use, data or profits, whether in an action of contract, negligence orother tortuous action, arising out of or in connection with the use or performanceof this software.

UCD SNMP 4.2.5

Portions Copyright 1989, 1991, 1992 by Carnegie Mellon University. DerivativeWork - 1996, 1998-2000, Copyright 1996, 1998-2000 The Regents of the University ofCalifornia All Rights Reserved

Permission to use, copy, modify and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appears in all copies and that both that copyright notice and thispermission notice appear in supporting documentation, and that the name of CMUand The Regents of the University of California not be used in advertising orpublicity pertaining to distribution of the software without specific writtenpermission.


Portions Copyright: (c) 2001-2003, Networks Associates Technology, Inc, (c)2001-2003, Cambridge Broadband Ltd, (c) 2003-2005, Sparta, Inc., (c) 2004, Cisco,Inc and Information Network Center of Beijing University of Posts andTelecommunications, (c) Fabasoft R&D Software GmbH & Co KG, [email protected].


Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list ofconditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, thislist of conditions and the following disclaimer in the documentation and/or othermaterials provided with the distribution.

3. Neither the names of Networks Associates Technology, Inc, CambridgeBroadband Ltd., Sparta, Inc., Cisco, Inc, Beijing University of Posts andTelecommunications, Fabasoft R&D Software GmbH & Co KG or any of its


subsidiaries, brand or product names, nor the names of their contributors may beused to endorse or promote products derived from this software without specificprior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ANDCONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS ORCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUTNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVERCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

JDOM 1.0

Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin. All rights reserved.

Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list ofconditions, and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, thislist of conditions, and the disclaimer that follows these conditions in thedocumentation and/or other materials provided with the distribution.

3. The name "JDOM" must not be used to endorse or promote products derivedfrom this software without prior written permission. For written permission, pleasecontact <request_AT_jdom_DOT_org>.

4. Products derived from this software may not be called "JDOM", nor may"JDOM" appear in their name, without prior written permission from the JDOMProject Management <request_AT_jdom_DOT_org>.

In addition, we request (but do not require) that you include in the end-userdocumentation provided with the redistribution and/or in the software itself anacknowledgement equivalent to the following:

"This product includes software developed by the JDOM Project(http://www.jdom.org/)." Alternatively, the acknowledgment may be graphicalusing the logos available at http://www.jdom.org/images/logos.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULARPURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS ORTHE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS

Notices 39

INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OFTHIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCHDAMAGE.

This software consists of voluntary contributions made by many individuals onbehalf of the JDOM Project and was originally created by Jason Hunter<jhunter_AT_jdom_DOT_org> and Brett McLaughlin <brett_AT_jdom_DOT_org>.For more information on the JDOM Project, please see <http://www.jdom.org/>.

Regex 1.1a

Copyright (C) 1996, 1999 Vassili Bykov. It is provided to the Smalltalk communityin hope it will be useful.

1. This license applies to the package as a whole, as well as to any component of it.By performing any of the activities described below, you accept the terms of thisagreement.

2. The software is provided free of charge, and ``as is'', in hope that it will beuseful, with ABSOLUTELY NO WARRANTY. The entire risk and all responsibilityfor the use of the software is with you. Under no circumstances the author may beheld responsible for loss of data, loss of profit, or any other damage resultingdirectly or indirectly from the use of the software, even if the damage is caused bydefects in the software.

3. You may use this software in any applications you build.

4. You may distribute this software provided that the software documentation andcopyright notices are included and intact.

5. You may create and distribute modified versions of the software, such as portsto other Smalltalk dialects or derived work, provided that:

a. any modified version is expressly marked as such and is not misrepresented asthe original software;

b. credit is given to the original software in the source code and documentation ofthe derived work;

c. the copyright notice at the top of this document accompanies copyright noticesof any modified version.


��

Printed in USA

getting started with common reporting guide · ibmtivoli netcool performance manager,version 1.3.2...

Documents