bmc analytics for bsm 7.6.04 reference guide
TRANSCRIPT
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
1/68
www.bmc.com
BMC Analytics for Business Service Management 7.6.04
Reference Guide
April 2011
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
2/68
If you have comments or suggestions about this documentation, contact Information Design and Development by email at
Contacting BMC Software
You can access the BMC Software website at http://www.bmc.com. From this website, you can obtain informationabout the company, its products, corporate offices, special events, and career opportunities.
United States and Canada
Address BMC SOFTWARE INC2101 CITYWEST BLVDHOUSTON TX 77042-2827USA
Telephone 713 918 8800 or800 841 2031
Fax 713 918 8000
Outside United States and Canada
Telephone (01) 713 918 8800 Fax (01) 713 918 8000
Copyright 2003 - 2011 BMC Software, Inc.
BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent
and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, andlogos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are theproperty of their respective owners.
IT Infrastructure Library is a registered trademark of the Office of Government Commerce and is used here by BMC Software, Inc.,
under license from and with the permission of OGC.
ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in theU.S. Patent and Trademark Office, and is used here by BMC Software, Inc., under license from and with the permission of OGC.
UNIX is the registered trademark of The Open Group in the US and other countries.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
SAP and BusinessObjects are trademarks or registered trademarks of SAP AG in Germany and in several other countries.
BMC Software considers information included in this documentation to be proprietary and confidential. Your use of this information issubject to the terms and conditions of the applicable End User License Agreement for the product and the proprietary and restricted
rights notices included in this documentation.
Restricted rights legend
U.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OFTHE UNITED STATES. Use, duplication, or disclosure of any data and computer software by the U.S. Government is subject to
restrictions, as applicable, set forth in FAR Section 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, andDFARS 252.227-7025, as amended from time to time. Contractor/Manufacturer is BMC Software, Inc., 2101 CityWest Blvd., Houston, TX77042-2827, USA. Any contract notices should be sent to this address.
mailto:[email protected]://www.bmc.com/mailto:[email protected]://www.bmc.com/ -
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
3/68
Customer Support
You can obtain technical support by using the Support page on the BMC Software website or by contacting CustomerSupport by telephone or email. To expedite your inquiry, please see Before Contacting BMC Software.
Support website
You can obtain technical support from BMC Software 24 hours a day, 7 days a week athttp://www.bmc.com/support_home. From this website, you can:
Read overviews about support services and programs that BMC Software offers. Find the most current information about BMC Software products. Search a database for problems similar to yours and possible solutions. Order or download product documentation. Report a problem or ask a question. Subscribe to receive email notices when new product versions are released. Find worldwide BMC Software support center locations and contact information, including email addresses, fax
numbers, and telephone numbers.
Support by telephone or email
In the United States and Canada, if you need technical support and do not have access to the Web, call 800 537 1813 orsend an email message to [email protected]. (In the Subject line, enterSupID:, such as SupID:12345.) Outside the United States and Canada, contactyour local support center for assistance.
Before contacting BMC Software
Have the following information available so that Customer Support can begin working on your issue immediately:
Product information
Product name Product version (release number) License number and password (trial or permanent)
Operating system and environment information
Machine type Operating system type, version, and service pack System hardware configuration Serial numbers Related software (database, application, and communication) including type, version, and service pack or
maintenance level
Sequence of events leading to the problem
Commands and options that you used
Messages received (and the time and date that you received them)
Product error messages Messages from the operating system, such as file system full Messages from related software
http://www.bmc.com/support_homemailto:[email protected]:[email protected]://www.bmc.com/support_home -
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
4/68
License key and password information
If you have a question about your license key or password, contact Customer Support through one of the followingmethods:
E-mail [email protected]. (In the Subject line, enter SupID:,such as SupID:12345.)
In the United States and Canada, call 800 537 1813. Outside the United States and Canada, contact your local supportcenter for assistance.
Submit a new issue athttp://www.bmc.com/support_home.
mailto:[email protected]://www.bmc.com/support_homehttp://www.bmc.com/support_homemailto:[email protected] -
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
5/68
Contents 1
BMC Software, Inc., Confidential
Contents
Chapter 1 Universe characteristics and related information 3
About the ITSM Universe and installed objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4ITSM universe characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Fields for reporting on multitenancy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Stored procedures, functions, and tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Using business service models in BMC Analytics for BSM . . . . . . . . . . . . . . . . . . 13
About the ProactiveNet universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Stored procedures, functions, and tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19ANA_EVENT_OP_HISTORY_VIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
About the ImpactPortal universe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Stored procedure, table, and view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
About the PortalCDE universe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Stored procedures, functions, and tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Fiscal calendar data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28ANA:Fiscal_Calendar form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28ANA_FISCAL_CALENDAR view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Date conversion functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30FN_ADJUSTED_DATE function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30FN_GET_EPOCH_DATE function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Timezone table and supported timezones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32ANA_TIMEZONE_INFO table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Timezone support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Chapter 2 Universe and report customization templates 41
Universe customization templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Report customizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Section 1: Report Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Section 2: Data Selection/Grouping/Sorting/Parameters . . . . . . . . . . . . . . . . . . . 44New and Changed parameter description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Section 3: Report Presentation Changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Chart Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Field Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Variable additions and Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Chapter 3 Report conditions and default views 47
Report conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Default views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
6/68
2 Reference Guide
BMC Software, Inc., Confidential
BMC Analytics for BSM default views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Cloud Lifecycle Management default views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Event Management default views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53CMDB default views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Change Management default views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Service Request Management default views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Asset Management default views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Service Level Management default views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Service Desk default views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Configuration Drift Management default views. . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Index 61
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
7/68
Chapter 1 Universe characteristics and related information 3
Chapter
BMC Software, Inc., Confidential
1Universe characteristics andrelated information
This appendix contains the following topics:
About the ITSM Universe and installed objects (page 4)
About the ProactiveNet universe (page 18) About the ImpactPortal universe (page 25)
About the PortalCDE universe (page 26)
Fiscal calendar data (page 28)
Date conversion functions (page 30)
Timezone table and supported timezones (page 32)
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
8/68
4 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
About the ITSM Universe and installed objects
This section contains information about the ITSM universe and about the objectsthat are installed by BMC Analytics for BSM for reporting on the BMC Remedy IT
Service Management applications, BMC Atrium CMDB, and BMC Cloud LifecycleManagement.
ITSM universe characteristics
Table 1-1contains the characteristics of the ITSM universe.
Table 1-1: Characteristics of the ITSM universe
Name Value Description
Name ITSM Name of the universe
Description BMC Analytics for BSM 7.6.04 universe for
reporting on BMC Remedy ITSM
Description of the universe
Connection ITSM Name of the connection used toconnect to the BMC Remedy ARSystem database
Classes and Objects See Self Help Document ID KA345616 in theBMC Knowledge Base for a complete list ofclasses and objects.
Description of the formulas for theclasses and objects in the universe.See Self Help Document ID:KA345616 in the BMC KnowledgeBase for a complete list of classesand objects.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
9/68
Chapter 1 Universe characteristics and related information 5
BMC Software, Inc., Confidential
About the ITSM Universe and installed objects
Statistics SAP BusinessObjects XI R 3.1 SP3 and BMCRemedy AR System Server version 7.1:
438 classes
4166 objects
815 conditions
539 tables
298 alias
808 joins
0 contexts
27 hierarchies
SAP BusinessObjects XI R2 SP5 and BMCRemedy AR System Server version 7.1:
434 classes
4098 objects
815 conditions
524 tables
296 alias
802 joins
0 contexts
27 hierarchies
SAP BusinessObjects XI R3.1 SP3 and BMCRemedy AR System Server version 7.5 and 7.6:
558 classes5459 objects
951 conditions
713 tables
481 alias
1189 joins
0 contexts
27 hierarchies
SAP BusinessObjects XI R2 SP5 and BMCRemedy AR System Server version 7.5 and 7.6:
482 classes4699 objects
848 conditions
621 tables
359 alias
966 joins
0 contexts
27 hierarchies
Universe metrics
Table 1-1: Characteristics of the ITSM universe
Name Value Description
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
10/68
6 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Fields for reporting on multitenancy
BMC Analytics for BSM uses the data stored in the BMC Remedy ITSM applicationform fields that are listed in this topic.
For more information about multitenancy in the ITSM universe, seeBMC Analyticsfor Business Service Management Installation and Administration Guide.
Controls Limit size of long text objects to: 4000 characters
Limit execution time to: 10 minutes
Warn if Cost Estimate Exceeds 300 seconds
Limits the amount of data and thetime used to retrieve the data
SQL Query Multiple SQL Statements for each Context: true
Multiple SQL Statements for each Measure: false
Allow Use of Union,Intersect and MinusOperators: true
Cartesian Products: warn
Allow Selection of Multiple Contexts: false
Allow Use of Subqueries: true
Allow Complex Operands in Query Panel: true
These are the settings used byBusinessObjects to generate SQLqueries. Based on the specifiedvalues, you can restrict the types ofoperations that the SQL generationengine can do.
Table 1-1: Characteristics of the ITSM universe
Name Value Description
Table 1-2:
Application Version Application view Fields Database column name
AssetManagement
7.0.x, 7.5.x,7.6x
BMC_CORE_BMC_BASEELEMENT
Company 1 1 Company
IncidentManagement
7.0.x HPD_HELP_DESK Contact_Company
Direct_Contact_Company
Company
Contact_Company
Direct_Contact_Company
Company
IncidentManagement
7.5.x, 7.6.x HPD_HELP_DESK Contact_Company
Direct_Contact_Company
Company
Assigned SupportCompany
Owner SupportCompany
Contact_Company
Direct_Contact_Company
Company
Assigned_Support_Company
Owner_Support_Company
ProblemManagement
7.0.x PBM_PROBLEM_INVESTIGATION
Company
Contact_Company
Company
Contact_Company
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
11/68
Chapter 1 Universe characteristics and related information 7
BMC Software, Inc., Confidential
About the ITSM Universe and installed objects
ProblemManagement
7.5.x and7.6.x
PBM_PROBLEM_INVESTIGATION
Company
Contact_Company
Problem Manager
Assignment SupportCompany
Manager AssignmentSupport Company
Company
Contact_Company
Support_Company_Pbl
m_Mgr
Assigned_Support_Company
ProblemManagement(KnownError)
7.0.x PBM_KNOWN_ERROR
Company Company
ProblemManagement
(KnownError)
7.5.x and7.6.x
PBM_KNOWN_ERROR
Company
Problem Manager
Assignment SupportCompany
Company
Support_Company_Pbl
m_Mgr
ProblemManagement(SolutionDatabase)
7.0.x PBM_SOLUTION_DATABASE
Company Company
ProblemManagement(SolutionDatabase)
7.5.x and7.6.x
PBM_SOLUTION_DATABASE
Company
Solution AssignmentSupport Company
Company
Assigned_Support_Company
ChangeManagement
7.0.x CHG_INFRASTRUCTURE_CHANGE
Location Company Location_company
ChangeManagement
7.5.x and7.6.x
CHG_INFRASTRUCTURE_CHANGE
Location Company
Change ManagerSupport Company
Change AssigneeSupport Company
Change ImplementerSupport Company
Location_company
Company3
ASCPY
ChgImpCpy
ChangeManagement
(ReleaseManagement)
7.0.x not applicable not applicable not applicable
ChangeManagement(ReleaseManagement)
7.5.x and7.6.x
RMS_Release Location_Company
Release ManagerSupport Company
Location_Company
Company3
Table 1-2:
Application Version Application view Fields Database column name
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
12/68
8 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Stored procedures, functions, and tables
This section lists and describes the stored procedures, functions, and tables that areinstalled by BMC Analytics for BSM. The objects that are installed vary according
to whether your BMC Remedy AR System Server uses an Oracle database or aMicrosoft SQL Server database.
Oracle stored procedures, functions, packages, tables,and views
ServiceRequestManagement
2.0.x and2.2.x
SRM_REQUEST Location_Company
Customer_Company
Location_Company
Customer_Company
Service LevelManagement
7.1.x, 7.5.x,and 7.6.x
SLM_Contract SharedServicesGroups SharedServicesGroups
1. Though BMC Remedy Asset Management also uses the field CMDBRowLevelSecurity in itsmultitenancy implementation, BMC Analytics for BSM does not use the field in its multitenancyimplementation.
Table 1-2:
Application Version Application view Fields Database column name
Category Name Description
Function FN_ADJUSTED_DATE
Invoked as required by IT Service Managementclass and object formulas. The script that insertsthe function isFN_ADJUSTED_DATE_ORA.SQL.
BMC Analytics for BSM uses these converteddates for reporting and trending metrics. Thefunction supports Daylight Saving Time formultiple time zones. For more information, seethe BMC Analytics for Business ServiceManagement Reference Guide.
Package PKG_BSM_RELATIO
NSHIPS
Populates theDENORMALIZE_BSM_RELATIONSHIPStable. The following scripts are run to install the
package:
PKG_BSM_RELATIONSHIPS_SPEC_ORA.SQL
PKG_BSM_RELATIONSHIPS_BODY_ORA.sql
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
13/68
Chapter 1 Universe characteristics and related information 9
BMC Software, Inc., Confidential
About the ITSM Universe and installed objects
Storedprocedure
POPULATE_FISCAL_CALENDAR
Populates the ANA_FISCAL_CALENDARview. This stored procedure is invoked by ARWorkflow on the ANA:Fiscal Calendar Formwhen the form is updated in BMC Remedy Mid
Tier. The script that inserts the storedprocedure isPC_POPULATE_FISCAL_CALENDAR_ORA.SQL
Storedprocedure(Package
body)
ANA_POPULATE_T
IMEZONE_DST
The procedure queries ANA_TZ_DST_VIEWand inserts data into the TABLEANA_TZ_DSTTIME.
Storedprocedure(Package
specifications)
PKG_ANA_TZ_DST The procedure queries ANA_TZ_DST_VIEWand inserts data into the TABLEANA_TZ_DSTTIME
Table DENORMALIZE_BS
M_REL
ATIONSHIPS
A database procedure reads the businessservice models and the relationships in BMCAtrium CMDB and populates the businessservice model relationships in theDENORMALIZE_BSM_RELATIONSHIPStable. The table must be created before theprocedure is executed. The scriptANA_DENORMALIZE_BSM_RELATIONSHIPS_DDL_ORA.SQL is run to install the table.
For more information, see BMC Analytics forBusiness Service Management Installation and
Administration Guide.
Table ANA_TIMEZONE_INFO
Lists the timezones used in the reports and therelated information. This table is created by thefollowing scripts:
ANA_TIMEZONE_INFO_DDL_ORA.SQL
ANA_TIMEZONE_INFO_DML_ORA.SQL
For more information about the supportedtimezones, see BMC Analytics for BusinessService Management Reference Guide.
Table ANA_REPORT_LOCALE
Stores the user-specified locale settings for thereports. This table is created by the followingscripts:
ANA_REPORT_LOCALE_DDL_ORA.SQL
ANA_REPORT_LOCALE_DML_ORA.SQL
Table ANA_REPORT_STRING
Stores the text that appears on the reports. Thistable is created by the following script:
ANA_REPORT_STRING_DDL_ORA.SQL
Category Name Description
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
14/68
10 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Table ANA_REPORT_TRA
NSLATION
Stores the report definition settings for thereports in various languages. This table iscreated by the following scripts:
ANA_REPORT_TRANSLATION_DDL_ORA.SQL
ANA_REPORT_TRANSLATION_EN_DML_ORA.SQL (English)
ANA_REPORT_TRANSLATION_JA_DML_ORA.SQL (Japanese)
(This script will not get executed, but it will bestored in the installation directory.)
Table ANA_TZ_DSTTIME Stores the precalculated data for the DST starttime and end time of the preferred time region,which is used for converting Epoch time to the
preferred time in the date conversion function.This table requires theANA_TIMEZONE_INFO table, which is alsocreated during installation and contains thetimezone code.
View ANA_TZ_DST_VIE
W
This view is used to populate the tableANA_TZ_DSTTIME. The view query reads thedata from table ANA_TIMEZONE_INFO andprecalculates the DST start time and end time.
This view requires theANA_TIMEZONE_INFO table, also created
during installation, that stores the timezoneregion code.
View ANA_FISCAL_CAL
ENDAR
Used by the Populate_Fiscal_Calendarprocedure, invoked by workflow on theANA:Fiscal Calendar form.
Category Name Description
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
15/68
Chapter 1 Universe characteristics and related information 11
BMC Software, Inc., Confidential
About the ITSM Universe and installed objects
Microsoft SQL Server stored procedures, functions,packages, tables, and views
Category Name DescriptionFunction FN_ADJUSTED_DA
TEInvoked as required by IT ServiceManagement class and object formulas. Thescripts that insert the function are:
FN_ADJUSTED_DATE_MSSQL.SQL
DROP_FN_ADJUSTED_DATE_MSSQL.SQL
BMC Analytics for BSM uses these converteddates for reporting and trending metrics. Thefunction supports Daylight Saving Time formultiple timezones. For more information,
see Supported timezones for BMC RemedyAR System server data source on page 35.
StoredProcedure
ANA_POPULATE_T
IMEZONE_DST
Populates the table ANA_TZ_DSTTIME.This procedure reads the data from tableANA_TIMEZONE_INFO and precalculatesthe DST start time and end time for thepreferred time region, which is used forconverting Epoch time to the preferred timein the date conversion function. This storedprocedure requires theANA_TIMEZONE_INFO table, which storesthe time region code.
StoredProcedure
PC_POPULATE_FIS
CAL_CALENDAR
Populates the ANA_FISCAL_CALENDARview. This stored procedure is invoked byAR Workflow on the ANA:Fiscal CalendarForm when updated in BMC Remedy ARSystem. The script that inserts the storedprocedure isPC_POPULATE_FISCAL_CALENDAR_MSSQL.SQL
StoredProcedure
PC_DENORMALIZE
_BSM_RELATIONS
HIPS
A database procedure reads the businessservice models and the relationships in BMCAtrium CMDB from theBMC_CORE_BMC_BASERELATIONSHIPtable and populates theDENORMALIZE_BSM_RELATIONSHIPStable. The scripts that install the storedprocedure are
DROP_PC_DENORMALIZE_BSM_RELATIONSHIPS_MSSQL.SQL
PC_DENORMALIZE_BSM_RELATIONSHIPS_MSSQL.SQL
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
16/68
12 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
StoredProcedure
PC_BSM_RELATIO
NSHIPS_TRAVERSA
L
A database procedure called fromPC_DENORMALIZE_BSM_RELATIONSHIPS that traverses one business service at atime in a recursive mode. The scripts that are
run to install the procedure are
DROP_PC_BSM_RELATIONSHIPS_TRAVERSAL_MSSQL.SQL
PC_BSM_RELATIONSHIPS_TRAVERSAL_MSSQL.SQL
Table ANA_TZ_DSTTIME Stores the precalculated data for the DSTstart time and end time of the preferred timeregion; used for converting Epoch time to thepreferred time in the date conversionfunction.
This table requires theANA_TIMEZONE_INFO table, which isalso created during installation and containsthe timezone code.
Table ANA_TIMEZONE_INFO
Lists the timezones used in the reports andthe related information. This table is created
by the following scripts:
DROP_TABLE_ANA_TIMEZONE_INFO_MSSQL.SQL
ANA_TIMEZONE_INFO_DDL_MSSQL.SQL
ANA_TIMEZONE_INFO_DML_MSSQL.SQL
For more information about the supportedtimezones, see Supported timezones forBMC Remedy AR System server datasource on page 35.
Table DENORMALIZE_BS
M_RELATIONSHIPS
A database procedure reads the businessservice models and the relationships in BMCAtrium CMDB from theBMC_CORE_BMC_BASERELATIONSHIPtable and populates theDENORMALIZE_BSM_RELATIONSHIPS
table. The table must be created before theprocedure is executed. The following scriptsare run to install the table:
DROP_TABLE_DENORMALIZE_BSM_RELATIONSHIPS_MSSQL.SQL
ANA_DENORMALIZE_BSM_RELATIONSHIPS_DDL_MSSQL.SQL
Category Name Description
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
17/68
Chapter 1 Universe characteristics and related information 13
BMC Software, Inc., Confidential
About the ITSM Universe and installed objects
Using business service models in BMC Analytics for BSM
Because the BMC _CORE_BMC_BASERELATIONSHIP table used by BMCAtrium CMDB to store CI relationship date is not suitable for the reportingrequirements of BMC Analytics for BSM, a new table is created that prepares the
operational data for use in the reports.The procedure, installed by BMC Analytics for BSM, retrieves BMC BusinessService Class CI data from the BMC _CORE_BMC_BASERELATIONSHIP tableand recursively traverses the table following the relationships that identify aservice model, then stores the CI, Relationship and other denormalized data in theDENORMALIZE_BSM_RELATIONSHIPS table
In BMC Atrium CMDB, the relationships that are created directly are dependencyrelationships, and the relationships that come from the import of Service Modelsfrom BMC SIM are impact relationships. The current solution only works for thedependency relationships that are created in BMC Atrium CMDB. The BMC SIM
relationship is a future enhancement.
Table ANA_REPORT_LOCALE
Stores the user-specified locale settings forthe reports. This table is created by thefollowing scripts:
DROP_TABLE_ANA_REPORT_LOCALE_MSSQL.SQL
ANA_REPORT_LOCALE_DDL_MSSQL.SQL
ANA_REPORT_LOCALE_DML_MSSQL.SQL
Table ANA_REPORT_STRING
Stores the text that appears on the reports.This table is created by the following scripts:
DROP_TABLE_ANA_REPORT_STRING_MSSQL.SQL
ANA_REPORT_STRING_DDL_MSSQL.S
QLTable ANA_REPORT_TRA
NSLATION
Stores the report definition settings for thereports in various languages. This table iscreated by the following scripts:
DROP_TABLE_ANA_REPORT_TRANSLATION_MSSQL.SQL
ANA_REPORT_TRANSLATION_DDL_MSSQL.SQL
ANA_REPORT_TRANSLATION_EN_DML_MSSQL.SQL (English)
ANA_REPORT_TRANSLATION_JA_DM
L_MSSQL.SQL (Japanese)
View ANA_Fiscal_Calendar
Used by the Populate_Fiscal_Calendarprocedure, invoked by workflow on theANA:Fiscal Calendar form.
Category Name Description
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
18/68
14 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
The following BMC_BaseRelationship types are supported:
BMC_Component
BMC_Dependency
BMC_MemberOfCollection
The following table shows the detailed structure of theDENORMALIZE_BSM_RELATIONSHIPS table.
Table 1-3: DENORMALIZE_BSM_RELATIONSHIPS table
Column Name Type Description
NODEID VARCHAR2(38 BYTE) The reconciliation id of the CI in the business servicemodel that is representing the current row
LEVELNUMBER NUMBER This will be the distance in terms of number of hops,at which the current CI is from the top of the tree.
NODEORDER NUMBER The asset type and would typically have values like"BMC_COMPUTERSYSTEM","BMC_BUSINESSSERVICE" etc.
RELATIONSHIPNAME
VARCHAR2(254 BYTE) The name of the relationship like "member of", "hosts","hosted by" that the current CI forms with the CI at thenext level.
UPARENT VARCHAR2(254 BYTE) The reconciliation id of The Business Service CI at theroot of the business service model.
REQUESTID VARCHAR2(38 BYTE) The request ID of the row which belongs to the CI inthe baserelationship table.
INSTANCEID VARCHAR2(38 BYTE) The Instance ID of the row which belongs to the CI inthe baserelationship table.
UPARENTNAME VARCHAR2(254 BYTE) The name of the business service at the root of thebusiness service model.
IPARENT VARCHAR2(38 BYTE) The reconciliationid of the CI which is the immediateparent of the current CI for which this row belongs.
IPARENTNAME VARCHAR2(254 BYTE) The name of the CI which is the immediate parent ofthe CI which the current row represents.
RELATIONSHIP VARCHAR2(4000 BYTE) The name of the relationship (dependency,component etc) for the current node.
NODENAME VARCHAR2(254BYTE) The name of the current node
NODEDISPLAY VARCHAR2(4000 BYTE) The name of the current node along with the displayoffset for the purpose of reporting.
DATASETID VARCHAR2(254BYTE) The datasetid of the CI from the base relationship tablewhich the CI represents.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
19/68
Chapter 1 Universe characteristics and related information 15
BMC Software, Inc., Confidential
About the ITSM Universe and installed objects
Populating the DENORMALIZE_BSM_RELATIONSHIPStable
This table is populated by the PC_DENORMALIZE_BSM_RELATIONSHIPSprocedure. For information about running this procedure to populate the table, see
the BMC Analytics for Business Service Management Installation and AdministrationGuide.
Business service models in the ITSM universe
The ITSM universe has all the data elements that are related to the business servicemodels exposed as part of the classes, objects and conditions. This will enable thebusiness user to perform ad hoc analysis on the business service models in tandemwith the data coming from other modules. Specifically, the business user will beable to do cross-functional reporting from the business service model to BMCRemedy Incident Manager, BMC Remedy Change Manager and other modules in
the ITSM universe.
The screenshots in the figures below show the details of where the related objectsand conditions exist in the universe. They primarily are hosted in the BMC AtriumCMDB module under the class with the name Business Service Model.
Figure 1-1: Universe Logical Model:
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
20/68
16 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Figure 1-2: Universe Objects for Business service model
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
21/68
Chapter 1 Universe characteristics and related information 17
BMC Software, Inc., Confidential
About the ITSM Universe and installed objects
Figure 1-3: Universe conditions for Business service model
Reports based on Business Service Model
There are two predefined reports that are part of the BMC Analytics for BSMproduct that report on the business service models. The reports follow.
C02 - Business Services Supported By a CI: This report provides the bottom upanalysis capability for the business service model. The user can enter/select alist of CIs, and the report will display a list of all the business services that aresupported by each of the CIs.
C03 - Business Service Profile: This report provides the top down analysiscapability for the business service model. The user can enter/select a list ofbusiness service models from a drop down and the report will decompose eachof them to the lowest level in terms of the CIs that are supporting it.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
22/68
18 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
About the ProactiveNet universe
The following table summarizes the characteristics of the ProactiveNet universe.
Table 1-4: Characteristics of the ProactiveNet universe
Name Value Description
Name ProactiveNet Name of the universeDescription BMC Analytics for BSM universe 7.6.04
for reporting on BMC ProactiveNet 8.5Description of the universe.
Connection ProactiveNet Name of the connection used to connect tothe BMC ProactiveNet PerformanceManagement server database
Classes and Objects See Self Help Document ID: KA345616 inthe BMC Knowledge Base for a completelist of classes and objects.
Description of the formulas for the classesand objects in the universe.
Statistics 24 classes
421 objects
42 conditions
14 tables
12 alias
24 joins
0 contexts
0 hierarchies
Universe metrics.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
23/68
Chapter 1 Universe characteristics and related information 19
BMC Software, Inc., Confidential
About the ProactiveNet universe
Stored procedures, functions, and tables
This section lists and describes the stored procedures, functions, and tables that areinstalled by BMC Analytics for BSM.
Controls Limit size of result set: 5000 rows
Limit size of long text objects to: 4000
characters
Limit execution time to: 10 minutes
Limits the amount of data and the timeused to retrieve the data.
SQL Query Allow use of subqueries: yes
Allow use of union, intersect and minusoperators: yes
Allow complex conditions in QueryPanel: yes
Cartesian products: warn
These are the settings used byBusinessObjects to generate SQL queries.Based on the specified values, you canrestrict the types of operations that the SQLgeneration engine can do.
Multiple paths Generate several SQL statements foreach context: yes
Generate several SQL statements foreach measure: yes
Allow selection of multiple contexts: no
These are the settings used by SAPBusinessObjects to generate SQL queries.Based on the specified values, you canrestrict the types of operations that the SQL
generation engine can do.
Name Value Description
Category Name Description
Event ANA_OP_HISTORY_SYNC
Invokes the event operation history procedurePC_PROCESS_EVENT_DATA daily.
Function FN_ADJUSTED_DATE
A function that converts an epoch value into areadable data and time format, according totimezone information stored in the tableANA_TIMEZONE_INFO..
Function FN_GET_EPOCH_D
ATE
A function that converts an epoch value into areadable data and time format, according totimezone information stored in the tableANA_TIMEZONE_INFO. Used to boost queryperformance.
Procedure PC_CLEANUP_OP_HISTORY
Deletes any existing history tables and cleansthe partition and prune control tables.
Procedure ANA_LASTRUN_CNTL
Initially populates the tableANA_LASTRUN_CNTL with a null value.
Procedure PC_EVENT_OP_HISTORY_TRAVERSAL
Invoked by procedurePC_PROCESS_EVENT_DATA; retrieves newdata from an event table; calls procedurePC_POPULATE_EVENT_STATUS_HISTORYto populate the related event operation historytable with the event data.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
24/68
20 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Procedure PC_POPULATE_EVENT_OP_HISTORY
Invoked by procedurePC_EVENT_STATUS_HISTORY_TRAVERSAL; populates the event operation history tablewith new event data.
Procedure PC_POPULATE_FISCAL_CALENDAR
Populates the ANA_FISCAL_CALENDARtable with dates according to the fiscal period.
Procedure PC_PROCESS_EVEN
T_DATA
Main procedure that identifies updated eventdata and calls additional procedures to updatethe event operation history tables.
Procedure PC_REFRESH_VIEW
_STRUCTURE
Recreates the viewANA_EVENT_OP_HISTORY_VIEW toincorporate newly created event operationhistory tables. Invoked by procedurePC_PROCESS_EVENT_DATA
Procedure DROP_ANA_OBJEC
TS_SYBASE
Removes all the installed objects from thedatabase during an uninstallation.
Table ANA_EVENT_OP_H
ISTORY
An event operation history table thatcorresponds to each EG_EVENT table;populated by the procedurePC_POPULATE_EVENT_STATUS_HISTORY.For more information about this table see theBMC Analytics for Business ServiceManagement Reference Guide
Table ANA_FISCAL_CAL
ENDAR
A fiscal calendar table that is populated
depending upon the start year, start month,and the duration of the fiscal calendar;populated by procedurePC_POPULATE_FISCAL_CALENDAR
Table ANA_LASTRUN_C
NTL
Stores the Last Run date of the procedurePC_PROCESS_EVENT_DATA in epochformat; initially populated with a null value bythe procedure ANA_LASTRUN_CNTL.
Table ANA_FIELD_ENUM
_VALUES
Stores all of the values for the enumerated BMCRemedy AR System fields.
Table ANA_TIMEZONE_INFO
Stores all of the timezones and Daylight SavingTime (DST) values.
View ANA_EVENT_OP_H
ISTORY_VIEW
Aggregates all of theANA_EVENT_OP_HISTORY tables.
Category Name Description
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
25/68
Chapter 1 Universe characteristics and related information 21
BMC Software, Inc., Confidential
About the ProactiveNet universe
ANA_EVENT_OP_HISTORY_VIEW
The history table ANA_EVENT_OP_HISTORY_VIEW contains the operationalhistory of an event life cycle. Because the EG_EVENT tables used by BMCProactiveNet Performance Management to store operational history are not
suitable for the reporting requirements of BMC Analytics for BSM, a new table iscreated that prepares the operational data for use in the reports. The proceduresinstalled by BMC Analytics for BSM retrieve comma-separated event data from theMC_OPERATIONS column of the BMC ProactiveNet Performance Managementtable (EG_EVENT), separate the data, then store it in theANA_EVENT_OP_HISTORY_VIEW table, along with the event ID, creation dateof the event, modification date of the event, and other data.
The following table shows the detailed structure of theANA_EVENT_OP_HISTORY_VIEW table.
Table 1-5: ANA_EVENT_OP_HISTORY_VIEW
Column name Data type Description
MC_UEID (primary key) Varchar (64) Event ID
OPERATION_SEQ_NUM(primary key)
Integer The sequence of operationsin descending order
EVENT_DATE_RECEPTION Integer Event create date
EVENT_DATE_MODIFICATION Integer Event modification date
OPERATION_DATE Integer The time at which anoperation was performedon the event. This is a HEXvalue converted to an
integer.USER_NAME Varchar (128) User who changed the
event.
ARG1 Varchar (128) Can contain any string asdefined by the user in theBMC ProactiveNetPerformance Managementapplication.
OPERATION_STATE Varchar (128) Operation that wasperformed on the event
ARG3 Varchar (128) Can contain any string as
defined by the user in theBMC ProactiveNetPerformance Managementapplication.
LAST_PROCESSED_DATE Datetime Date when the record in theHistory Table was lastprocessed by theprocedures.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
26/68
22 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Populating the history table
The history table is populated by the main procedurePC_PROCESS_EVENT_DATA_SYBASE.sql which runs nightly and is initiated bythe event ANA_EVENT_OP_HISTORY_SCHEDULE_SYBASE.sql. This
procedure performs the following steps: Checks for newly created event tables, and creates a history table
ANA_EVENT_STATUS_HISTORY for each new event table.
Calls the procedure PC_EVENT_STATUS_HISTORY_TRAVERSAL to populatethe new history table
Checks for updated event tables.
Calls the procedure PC_EVENT_STATUS_HISTORY_TRAVERSAL to updatethe history table for any event table that has been updated.
Updates the BMC ProactiveNet Performance Management Partition Control
table with the same entry that was included in the new history table. Updates the BMC ProactiveNet Performance Management Prune Control table
with the same value that was included in the new history table.
Recreates the history view to include any new history tables.
Updates the Last Run value in the ANA_LASTRUN_CNTL table.
History procedure pseudocode
This section contains the pseudocode for the history procedurePC_PROCESS_EVENT_DATA_SYBASE.sql.
BEGINIF LastRun_date IS NULLLastRun_date := MIN(START_TIME) FROM PARTITION_CNTL WHERETABLENAME = 'EG_EVENT'Create a History Table if 1 already does not existDetermine whether any old history tables exist.If not then capture all existing history-tables and update thempart_num:=MAX(PART_NUM) FROM PARTITION_CNTL WHERE TABLENAME =ANA_EVENT_OP_HISTORY'index := 0WHILE index
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
27/68
Chapter 1 Universe characteristics and related information 23
BMC Software, Inc., Confidential
About the ProactiveNet universe
ENDEXECUTE('SELECT @Last_modification_date =MAX(MC_DATE_MODIFICATION) FROM ' || event_table)IF last_modification_date > LastRun_dateNote: Process old tables that have been updated
BEGINEXEC PC_EVENT_OP_HISTORY_TRAVERSAL @event_table, @history_table
ENDINCREMENT indexENDUsing MaxEnd_date := MAX(END_TIME) FROM PARTITION_CNTL WHERETABLENAME = 'EG_EVENT' find any newly created history tables.
While all history tables not createdBEGIN EXECUTE ('CREATE TABLE DBA.' || @history_table || '
(MC_UEID VARCHAR(64),OPERATION_SEQ_NUM INTEGER,EVENT_DATE_RECEPTION INTEGER,EVENT_DATE_MODIFICATION INTEGER,OPERATION_DATE INTEGER,USER_NAME VARCHAR(128),ARG1 VARCHAR(128),OPERATION_STATE VARCHAR(128),ARG3 VARCHAR(128),LAST_PROCESSED_DATE DATETIME,PRIMARY KEY CLUSTERED (MC_UEID, OPERATION_SEQ_NUM))')
EXECUTE ('SELECT tabletype = TABLETYPE,s_time = START_TIME,e_time = END_TIME,c_time = CREATION_TIME
FROM PARTITION_CNTL WHERE TABLENAME = ''EG_EVENT''AND PART_NUM = ' || @part_num)
Note: We need to copy values for Event Table fromPartition_CNTL and paste same values for the History Table. Thisis needed for the Pruning engine to work correctly
Motypeid:= TABLE_ID FROM SYSTABLE WHERETABLE_NAME='ANA_EVENT_OP_HISTORY'
IF NOT EXISTS (SELECT * FROM PARTITION_CNTL WHERE TABLENAME ='ANA_EVENT_OP_HISTORY' AND PART_NUM = @part_num)BEGIN
INSERT INTO PARTITION_CNTL VALUES(
motypeid,tabletype,'ANA_EVENT_OP_HISTORY',part_num,s_time,e_time,c_time,
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
28/68
24 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
s_trace)
COMMITEND
EXEC PC_EVENT_OP_HISTORY_TRAVERSAL @event_table,
@history_tableENDUpdate PRUNE_CNTL table with an entry for the History table ifnot already exists.SELECT timecolumn = TIMECOLUMN, deltahours = DELTAHOURS, minitimestamp = MINTIMESTAMP, lastpruned = LASTPRUNEDFROM PRUNE_CNTL WHERE TABLENAME = 'EG_EVENT'Note: We need to populate Prune_CNTL table with appropriatevalues that is the same data as of Event Table for the pruningengine to work correctly
IF NOT EXISTS (SELECT * FROM PRUNE_CNTL WHERE TABLENAME ='ANA_EVENT_OP_HISTORY')BEGIN INSERT INTO PRUNE_CNTL VALUES
('ANA_EVENT_OP_HISTORY',timecolumn,deltahours,minitimestamp,lastpruned
) COMMIT ENDUPDATE ANA_LASTRUN_CNTL with Current Date valueNote: The view structure will not be consistent after creation ofadditional history tables. We need to build the History View againdependingpart_num:=MAX(PART_NUM) FROM PARTITION_CNTL WHERETABLENAME='ANA_EVENT_OP_HISTORY'
Call PC_REFRESH_VIEW_STRUCTURE part_numEND
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
29/68
Chapter 1 Universe characteristics and related information 25
BMC Software, Inc., Confidential
About the ImpactPortal universe
About the ImpactPortal universe
Table 1-6contains the characteristics of the ImpactPortal universe.
Table 1-6: Characteristics of the ImpactPortal universe
Stored procedure, table, and view
This section contains information about the stored procedure, table, and view thatis installed by BMC Analytics for BSM.
Name Value Description
Name ImpactPortal Name of the universe
Description BMC Analytics for BSM universe 7.6.04for reporting on BMC Impact Portal
Description of the universe.
Connection ImpactPortal Name of the connection used to connect tothe BMC Impact Portal database
Classes and Objects See Self Help Document ID: KA345616 inthe BMC Knowledge Base for a completelist of classes and objects.
Description of the formulas for the classesand objects in the universe.
Statistics 51 classes639 objects
126 conditions
21 tables
15 alias
33 joins
0 contexts
14 hierarchies
Universe metrics.
Controls Limit size of long text objects to: 1000
characters
Limit execution time to: 10 minutes
Limits the amount of data and the timeused to retrieve the data.
SQL Query Multiple SQL Statements for eachContext: true
Multiple SQL Statements for eachMeasure: true
Allow Use of Union,Intersect and MinusOperators: true
Cartesian Products: warn
Allow Selection of Multiple Contexts:false
Allow Use of Subqueries: trueAllow Complex Operands in QueryPanel: true
These are the settings used byBusinessObjects to generate SQL queries.Based on the specified values, you canrestrict the types of operations that the SQLgeneration engine can do.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
30/68
26 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
About the PortalCDE universe
Table 1-7contains the characteristics of the PortalCDE universe.
Table 1-7: Characteristics of the PortalCDE universe
Category Name Description
Storedprocedure
POPULATE_FISCAL_CALENDAR
Populates the ANA_FISCAL_CALENDARview. This stored procedure is invoked
through the command line interface followingthe installation. The script that inserts thestored procedure isPC_POPULATE_FISCAL_CALENDAR_ORA.SQL.
Table CDE_FISCAL_CALENDAR
A fiscal calendar table that is populateddepending upon the start year, start month,and the duration of the fiscal calendar; thistable is populated by the procedurePC_POPULATE_FISCAL_CALENDAR
View ANA_FISCAL_CAL
ENDAR
Used by the Populate_Fiscal_Calendar
procedure
Name Value Description
Name PortalCDE Name of the universe
Description BMC Analytics for BSM universe 7.6.04for reporting on BMC PerformanceManager Portal
Description of the universe.
Connection PortalCDE Name of the connection used to connect tothe BMC Performance Manager Portaldatabase
Classes and Objects See Self Help Document ID: KA345616 inthe BMC Knowledge Base for a completelist of classes and objects.
Description of the formulas for the classesand objects in the universe.
Statistics 29 classes
127 objects67 conditions
9 tables
2 alias
6 joins
0 contexts
0 hierarchies
Universe metrics.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
31/68
Chapter 1 Universe characteristics and related information 27
BMC Software, Inc., Confidential
About the PortalCDE universe
Stored procedures, functions, and tables
This section lists and describes the stored procedures, functions, and tables that areinstalled by BMC Analytics for BSM.
Controls Limit size of long text objects to: 1000
characters
Limit execution time to: 10 minutes
Limits the amount of data and the timeused to retrieve the data.
SQL Query Multiple SQL Statements for eachContext: true
Multiple SQL Statements for eachMeasure: true
Allow Use of Union,Intersect and MinusOperators: true
Cartesian Products: warn
Allow Selection of Multiple Contexts:false
Allow Use of Subqueries: true
Allow Complex Operands in Query
Panel: true
These are the settings used byBusinessObjects to generate SQL queries.Based on the specified values, you canrestrict the types of operations that the SQLgeneration engine can do.
Name Value Description
Category Name Description
Stored
procedure
POPULATE_FISCAL
_CALENDAR
Populates the ANA_FISCAL_CALENDAR
view. This stored procedure is invokedthrough the command line interface followingthe installation. The script that inserts thestored procedure isPC_POPULATE_FISCAL_CALENDAR_ORA.SQL.
Table CDE_FISCAL_CALENDAR
A fiscal calendar table that is populateddepending upon the start year, start month,and the duration of the fiscal calendar; thistable is populated by the procedurePC_POPULATE_FISCAL_CALENDAR
View ANA_FISCAL_CALENDAR
Used by the Populate_Fiscal_Calendarprocedure
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
32/68
28 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Fiscal calendar data
BMC Analytics for BSM provides a custom table calledANA_FISCAL_CALENDAR that provides fiscal calendar data. The fiscal calendar
data consists of day, week, month, quarter, year, and their derived values (such asrunning day, running week, and so on). The BMC Analytics for BSM fiscalcalendar year can start on the first day of any month and end one year from thestart date. For example, if you specify April 1, 2009 as the beginning of the fiscalcalendar, the end date occurs March 31, 2010.
If you report on BMC IT Service Management applications, the product alsoprovides a BMC Remedy AR System form called ANA:Fiscal_Calendar. This formmust be loaded into the BMC Remedy AR System database and then populated.
If you report on BMC ProactiveNet Performance Management, BMC ImpactPortal, or BMC Performance Manager Portal, the installation loads the table into
the BMC product database, but you must manually populate it by running theprocedure PC_POPULATE_FISCAL_CALENDAR following the installation. Formore information about running this procedure, see BMC Analytics for BusinessService Management Installation and Administration Guide.
ANA:Fiscal_Calendar form
This form must be loaded into the BMC Remedy AR System database using theBMC Remedy Mid Tier. The ANA:Fiscal_Calendar form enables you to analyzetrends based on fiscal calendar data. To support trend analysis, each date object inthe BMC_CORE_BMC_BASEELEMENT table is joined with the corresponding
date value object in the ANA_FISCAL_CALENDAR view.
Following the installation of BMC Analytics for BSM, you use BMC Remedy MidTier to specify the start month, start year, and number of years of the fiscal calendarusing the BMC Remedy AR System ANA:Fiscal_Calendar form. The workflow forthe ANA:Fiscal_Calendar uses the Populate_Fiscal_Calendar stored procedure toload the ANA_FISCAL_CALENDAR table, and the results are displayed at thebottom of the ANA:Fiscal_Calendar form.
ANA_FISCAL_CALENDAR view
Transaction dates (for example, Base_element_create_date) are stored in the BMCRemedy AR System and BMC ProactiveNet Performance Management databasein UNIX Epoch Time (number of seconds since January 1, 1970). They are notabsolute dates, and there is a time component attached to each of them. When joinsare created with the ANA_FISCAL_CALENDAR view (which has absolute dates),the fn_adusted_date() function is used to convert into the local Time Zone andtruncated to absolute dates to make trend analysis meaningful.
For example, the conversion formula used for a report showing the Purchase Datedimension on a computer running Microsoft SQL Server is as follows:
dbo.fn_adjusted_date(AM_BMC_CORE_BMC_BASEELEMENT.PurchaseDate)
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
33/68
Chapter 1 Universe characteristics and related information 29
BMC Software, Inc., Confidential
Fiscal calendar data
The conversion formula used for a report showing the Purchase Date dimensionon a computer running Oracle is:
fn_adjusted_date(AM_BMC_CORE_BMC_BASEELEMENT.PurchaseDate)
The join definition used for Purchase Order.Date_Ordered on a computer runningMicrosoft SQL Server is:
isnull(datediff(ss,'01-01-1970',CAST(CONVERT(VARCHAR(10),dbo.fn_adjusted_date(AM_BMC_CORE_BMC_BASEELEMENT.PurchaseDate),111) ASDATETIME)),-99)=ASSET_AGE_CALENDAR.Date_Value
The join definition used for Purchase Order.Date_Ordered on a computer runningOracle follows.
nvl((trunc(fn_adjusted_date(AM_BMC_CORE_BMC_BASEELEMENT.PURCHASEDATE)) - to_date('01-JAN-1970','DD-MON-YYYY'))*86400,-99) =ASSET_AGE_CALENDAR.Date_Value
Table 1-8shows the detailed structure of the ANA_FISCAL_CALENDAR view.Each row in the view represents a date, and each column represents a separatecomponent of the date.
Table 1-8: ANA_FISCAL_CALENDAR view structure
Column name Data type Description
Assigned_to Varchar The name of the product.
Example: BMC Analytics
Create_date Integer Epoch value for the day on which the fiscal table wascreated.
Example: 1252886400
Day_name Varchar Name of the corresponding week day
Example: Friday
Day_of_Year Integer Day of Fiscal Year
Epoch_value Integer Epoch value of the corresponding date
Example: 1199404800
Last_modified_by Varchar Modified user name
Example: BMC Analytics
Month_of_Year Integer Month of Fiscal Year
Month_of_Quarter Integer Month of Quarter
Month_Name Varchar Name of Month
Example: January
Quarter_of_Year Integer Quarter of Fiscal Year
Quarter_Name Varchar Quarter of Fiscal Year Combined With Year
Example: 2005Q2
Modified_date Integer Day on which fiscal table was last modified
Example: 1252886400
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
34/68
30 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Date conversion functions
If you use BMC Analytics for BSM to report on BMC Remedy ITSM applications,the function FN_ADJUSTED_DATE performs the task of converting databaseEPOCH dates to human-readable date formats.
If you use BMC Analytics for BSM to report on BMC ProactiveNet PerformanceManagement, BMC Performance Manager Portal, and BMC Impact Manager, bothfunctions FN_GET_EPOCH_DATE and FN_ADJUSTED_DATE are used, basedon reporting needs. Both functions are used to boost performance while querying
for reports on high volume data.
FN_ADJUSTED_DATE function
All the date objects in the universe have a formula embedded which looks like thefollowing example for the reported_date from the HPD_HELP_DESK form:
Fn_adjusted_date(HPD_HELP_DESK.Reported_Date)
The fn_adjusted_date function performs the following tasks:
Converts the date from the UNIX Epoch format to a normal date format.
Request_id (primarykey)
Varchar The actual date value in string format yyyymmdd
Example: 20080104
Running_Day Integer Running dayRunning_Week Integer Running week
Running_Month Integer Running month
Running_Quarter Integer Running quarter
Running_Year Integer Running year
Short_description Varchar The product name
Example: BMC Analytics
Start_Month Integer Currently not in use
Status Integer Currently not in use
Submitter Varchar The name of the product.
Example: BMC Analytics
Type_of_day Varchar Whether the day is a work day or a holiday
Example: Workday
Week_of_Year Integer Week of Fiscal Year
Week_Name Varchar Week of year combined with year
Example: Week 7 of 2005
YEAR Integer range (1900 -2100)
The year value for the corresponding day
Example: 2008
Table 1-8: ANA_FISCAL_CALENDAR view structure
Column name Data type Description
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
35/68
Chapter 1 Universe characteristics and related information 31
BMC Software, Inc., Confidential
Date conversion functions
Offsets the date from GMT for the time zone of the BMC Analytics for BSMinstance (as defined in the ANA_TIMEZONE_INFO table)
Returns the result in the date format instead of the Epoch format
The pseudo code for the function fn_adjusted_date follows. Note that the syntax
may vary if you are reporting on the BMC ProactiveNet Performance Managementdatabase.
Function Name:fn_adjusted_date
Parameters: InputDate, number, date in the UNIX Epoch format
Pseudo Code:
FUNCTION Fn_Adjusted_date (Parameters: Input Date Number)BEGIN Function
Input_GMT_datetime = Parameter input date converted to date format;Input_Year = Fetch the Year value from the Input_GMT_datetime
IF REGION_FLAG is not set to 'Y' for any region in ANA_TIMEZONE_INFOtableTHEN OutPut_Date = Input_GMT_datetime (default to GMT format)
IF REGION_FLAG='Y',Fetch DST Start time, DST End time, DST flag,Offsetfrom ANA_TIMEZONE_INFO table for a regioncode for which flag='Y'
Note: DST_Flag='Y' indicates that this region observes Daylight savingtime
IF DST_Flag='Y' THEN
-- IF Input Date falls into DST, add one hour to input gmt time andoffset valueIF Input_GMT_datetime between DST Start time and DST End time
THENOutPut_Date := Input_GMT_datetime + (offset
+ 1 hour);-- Else add offset value to input gmt time ELSE OutPut_Date := Input_GMT_datetime + offset;
END IF;ELSE -- IF DST_Flag='N'
OutPut_Date := Input_GMT_datetime + offset; END IF;END IF;
Return Output Date;END Function;
FN_GET_EPOCH_DATE function
The FN_GET_EPOCH_DATE function performs the following tasks:
Converts the date from the normal date format to UNIX Epoch format.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
36/68
32 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Offsets the date from GMT for the time zone of the BMC Analytics for BSMinstance (as defined in the ANA_TIMEZONE_INFO table)
Returns the result in the date format instead of the Epoch format
Function Name:fn_get_epoch_date
Parameters: InputDate, DateTime, date in yyyy/mm/dd hh:mm:ss am format.
The pseudo code for the FN_GET_EPOCH_DATE function follows:
FUNCTION FN_GET_EPOCH_DATE (Parameters: Input Date DateTime)BEGIN FunctionInput_GMT_datetime = Parameter input dateInput_Year = Fetch the Year value from the Input_GMT_datetime
IF REGION_FLAG is not set to 'Y' for any region inANA_TIMEZONE_INFO tableTHEN OutPut_Date = Input_GMT_datetime (default to GMT format)
IF REGION_FLAG='Y',Fetch DST Start time, DST End time, DST flag,Offsetfrom ANA_TIMEZONE_INFO table for a regioncode for which flag='Y'
Note: DST_Flag='Y' indicates that this region observes Daylightsaving timeIF DST_Flag='Y' THEN
-- IF Input Date falls into DST, add one hour to input gmt timeandoffset valueIF Input_GMT_datetime between DST Start time and DST End timeTHENOutPut_Date := Convert (Input_GMT_datetime) to Epoch + (offset+ 1hour);
-- Else add offset value to input gmt timeELSEOutPut_Date := Convert( Input_GMT_datetime) to Epoch + offset;END IF
ELSE -- IF DST_Flag='N'OutPut_Date := Conver( Input_GMT_datetime) to Epoch + offset;
END IF;END IF;Return Output Date;END Function;
Timezone table and supported timezones
This section contains information about the timezone table and the supportedtimezones.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
37/68
Chapter 1 Universe characteristics and related information 33
BMC Software, Inc., Confidential
Timezone table and supported timezones
ANA_TIMEZONE_INFO table
A custom table is maintained in the BMC product databases with the nameANA_TIMEZONE_INFO. This table is created during the installation process ofBMC Analytics for BSM.
The ANA_TIMEZONE_INFO table is used by the function FN_ADJUSTED_DATEto convert epoch time values to human-readable date and time values, dependingupon the preferred time zone selected by customer during installation. The table isalso used by the function FN_GET_EPOCH_DATE to convert a given date andtime value to epoch format.
During the installation, you select the preferred timezone for the reports, and theREGION_FLAG for that timezone is set to Y for the selected timezone.
Column name Data type Description
TIMEZONE_LOC_ID
NUMBER Timezone ID
COUNTRY VARCHAR2(50 BYTE) Country Name
COUNTRY_CODE VARCHAR2(50 BYTE) Country Code
REGION VARCHAR2(50 BYTE) Specific Region in a Country basedon Timezone
REGION_CODE VARCHAR2(50 BYTE) Region Code
DST_FLAG VARCHAR2(1 BYTE) Flag indicates whether the regionobserves DST 'Y' or not 'N'
REGION_FLAG VARCHAR2(1 BYTE) Set 'Y' for the region which clientinterested in
START_YEAR VARCHAR2(50 BYTE) Daylight saving Time (DST)Starting Year
START_MONTH_LAST_DT
VARCHAR2(50 BYTE) DST Starting Month Last Date(Ifstart month is April then 31-APRILetc)
START_WEEK_DAY
VARCHAR2(50 BYTE) DST Starting Week Day Name in aweek
START_WEEK VARCHAR2(10 BYTE) DST Starting Week Number (First/
Second/Third/Fourth/Last) in aMonth
END_YEAR VARCHAR2(50 BYTE) Daylight saving Time (DST) EndingYear
END_MONTH_LAST_DT
VARCHAR2(50 BYTE) DST Ending Month Last Date(If Endmonth is September then 30-SEPTEMBER etc)
END_WEEK_DAY VARCHAR2(50 BYTE) DST Ending Week Day Name in aweek
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
38/68
34 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
END_WEEK VARCHAR2(10 BYTE) DST Ending Week Number in aMonth
START_MONTH_
LAST_NUM
VARCHAR2(50 BYTE) DST Starting Month Last Date
Number (31-04 for April etc)START_WEEK_DAY_NUM
NUMBER DST Starting Week Day Number ina week (01 for Sunday, 02 forMonday etc)
START_WEEK_NUM
NUMBER DST Starting Week Number in amonth (01 for Firststart_week_day_number etc)
END_MONTH_LAST_NUM
VARCHAR2(50 BYTE) DST Starting Month Last DateNumber ( 30-09 for September etc)
END_WEEK_DAY
_NUM
NUMBER DST Ending Week Day Number in a
week (01 for Sunday, 02 for Mondayetc)
END_WEEK_NUM
NUMBER DST Ending Week Number in amonth (02 for Secondstart_week_day_number etc)
DST_START_TIME VARCHAR2(20 BYTE) When the DST Starts for this region
DST_END_TIME VARCHAR2(20 BYTE) When the DST Ends for this region
GMT_START_TIME
VARCHAR2(20 BYTE) Equivalent GMT Start time for thisRegion (DST_Start_Time +GMT_TimeDifference)
(ProactiveNetuniverse only)GMT_SEC_DIFFERENCE
FLOAT Contains the GMT adjustmentvalue in seconds. Example: -5.30GMT adjustments will be -19800;used by the functionFN_GET_EPOCH_DATE
GMT_END_TIME VARCHAR2(20 BYTE) Equivalent GMT End time for thisRegion (DST_End_Time +GMT_TimeDifference)
GMT_TIMEDIFFERENCE
VARCHAR2(10 BYTE) Time difference(offset) from GMTfor this Region
GMT_HRS_Mins NUMBER Time difference(offset) in Numberfrom GMT for this Region
Column name Data type Description
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
39/68
Chapter 1 Universe characteristics and related information 35
BMC Software, Inc., Confidential
Timezone table and supported timezones
Timezone support
The Populate_Fiscal_Calendar stored procedure that populates theANA_FISCAL_CALENDAR table supports multiple timezones. During the BMCAnalytics for BSM installation, you were prompted for the timezone that you
wanted to use in the reports. You can also change the timezone that is used at anytime. The region code for the timezone in use is stored in theANA_TIMEZONE_INFO table. See ANA_TIMEZONE_INFO table on page 33for more information.
Table 1-9contains a list of timezones that are supported by theANA_FISCAL_CALENDAR table if you report using BMC Remedy AR Systemserver. Table 1-10 on page 38contains a list of timezones that are supported by theANA_FISCAL_CALENDAR table if you report using BMC ProactiveNetPerformance Manager.
Table 1-9: Supported timezones for BMC Remedy AR System server data source (Sheet 1 of 4)
Country Region Region Code GMT time difference
GMT GMT +00.00
Africa/Casablanca Morocco WET +00.00
Africa/Harare Zimbabwe CAT +02.00
Africa/Johannesburg South Africa SAST +02.00
Africa/Monrovia Liberia GMT +00.00
Africa/Nairobi Kenya EAT +03.00
America/Anchorage United States of America AKST -09.00
America/Argentina/
Buenos_Aires
Argentina ART -03.00
America/Bogota Colombia COT -05.00
America/Caracas Venezuela VET -04.30
America/Chicago United States of America CST -06.00
America/Denver United States of America MST -07.00
America/Georgetown Guyana GYT -04.00
America/Godthab Greenland WGT -03.00
America/Halifax Canada AST -04.00
America/Hermosillo Mexico MST -07.00
America/Inuvik Canada MST -07.00America/La Paz Bolivia BOT -04.00
America/Lima Peru PET -05.00
America/Los_Angeles United States of America PST -08.00
America/Mazatlan Mexico MST -07.00
America/Mexico_City Mexico CST -06.00
America/Midway Islands United States of America SST -11.00
America/New_York United States of America EST -05.00
America/Noronha Brazil FNT -02.00
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
40/68
36 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
America/Phoenix United States of America MST -07.00
America/Puerto Rico Puerto Rico (San Juan) AST -04.00
America/Quito Ecuador ECT -05.00America/Rankin_Inlet Canada CST -06.00
America/Regina Canada CST -06.00
America/Santiago Chile CLT -04.00
America/Sao_Paulo Brazil BRT -03.00
America/St_Johns Canada NST -03.30
America/Tijuana Mexico PST -08.00
America/Toronto Canada EST -05.00
America/Vancouver Canada PST -08.00
Asia/AbuDhabi UAE GST +04.00Asia/Almaty Kazakstan ALMT +06.00
Asia/Baghdad Iraq AST +03.00
Asia/Bangkok Thailand ICT +07.00
Asia/Colombo Sri Lanka IST +05.30
Asia/Hanoi Vietnam ICT +07.00
Asia/Hong_Kong Hong Kong HKT +08.00
Asia/Irkutsk Russia IRKT +08.00
Asia/Jakarta Indonesia WIB +07.00
Asia/Jerusalem Israel IST +02.00Asia/Karachi Pakistan PKT +05.00
Asia/Katmandu Nepal NPT +05.45
Asia/Kolkata INDIA IST +05.30
Asia/Krasnoyarsk Russia KRAT +07.00
Asia/Kuala Lumpur Malaysia MYT +08.00
Asia/Novosibirsk Russia NOVT +06.00
Asia/Pyongyang North Korea KST +09.00
Asia/Riyadh Saudi Arab AST +03.00
Asia/Seoul South Korea KST +09.00Asia/Shanghai CHINA CST +08.00
Asia/Singapore Singapore SGT +08.00
Asia/Taipei Taiwan CST +08.00
Asia/Tbilisi Georgia GET +04.00
Asia/Tokyo Japan JST +09.00
Asia/UlaanBataar Mongolia ULAT +08.00
Asia/Yakutsk Russia YAKT +09.00
Atlantic/Azores Portugal AZOT -01.00
Table 1-9: Supported timezones for BMC Remedy AR System server data source (Sheet 2 of 4)
Country Region Region Code GMT time difference
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
41/68
Chapter 1 Universe characteristics and related information 37
BMC Software, Inc., Confidential
Timezone table and supported timezones
Atlantic/Cape_Verde Cape Verde CVT -01.00
Australia/Adelaide Australia CST +09.30
Australia/Brisbane Australia EST +10.00Australia/Canberra,Melbourne,Sydney
Australia EST +10.00
Australia/Darwin Australia ACST +09.30
Australia/Hobart Australia EST +10.00
Australia/Perth Australia WST +08.00
Europe/Amsterdam Netherlands CET +01.00
Europe/Baku Azerbaijan AZT +04.00
Europe/Belgrade Serbia CET +01.00
Europe/Berlin Germany CET +01.00
Europe/Bern Switzerland CET +01.00
Europe/Bratislava Slovak Republic CET +01.00
Europe/Brussels Belgium CET +01.00
Europe/Bucharest Romania EET +02.00
Europe/Budapest Hungary CET +01.00
Europe/Copenhagen Denmark CET +01.00
Europe/Dublin Ireland IST +00.00
Europe/Edinburgh Scotland BST +00.00
Europe/Ekaterinburg/Yekaterinburg
Russian Federation YEKT +05.00
Europe/Helsinki Finland EET +02.00
Europe/Istanbul Turkey EET +02.00
Europe/Kamchatka Russian Federation PETT +11.00
Europe/Lisbon Portugal WET 00.00
Europe/Ljubljana Slovenia CET +01.00
Europe/London Britain (UK) BST -00.00
Europe/Madrid Spain CET +01.00
Europe/Magadan Russian Federation MAGT +11.00Europe/Moscow Russian Federation MSK +03.00
Europe/New Caledonia France NCT +11.00
Europe/Novosibirsk Russian Federation NOVT +06.00
Europe/Paris France CET +01.00
Europe/Prague Czech Republic CET +01.00
Europe/Riga Latvia EET +02.00
Europe/Rome Italy CET +01.00
Europe/Sarajevo Bosnia and Herzegovina CET +01.00
Table 1-9: Supported timezones for BMC Remedy AR System server data source (Sheet 3 of 4)
Country Region Region Code GMT time difference
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
42/68
38 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Europe/Skopje Macedonia CET +01.00
Europe/Sofija/Sofia Bulgaria EET +02.00
Europe/St. Petersburgh/Saint Petersburg Russian Federation MSK +03.00
Europe/Stockholm Sweden CET +01.00
Europe/Tallinn Estonia EET +02.00
Europe/Tashkent Uzbekistan UZT +05.00
Europe/Vienna Austria CET +01.00
Europe/Vilnius Lithuania EET +02.00
Europe/Vladivostok Russian Federation VLAT +10.00
Europe/Volgograd Russian Federation MSK +03.00
Europe/Warsaw Poland CET +01.00
Europe/Yerevan Armenia AMT +04.00
Europe/Zagreb Croatia CET +01.00
Oceania/Solomon Islands Solomon Islands (Honiara) SBT +11.00
Pacific/Auckland,Wellington
New Zealand NZST +12.00
Pacific/Fiji Fiji FJT +12.00
Pacific/Guam Guam ChST +10.00
Pacific/Honolulu United States of America HST -10.00
Pacific/Majuro Majuro MHT +12.00
Pacific/Pago_Pago Samoa SST -11.00
Pacific/Port_Moresby Papua New Guinea PGT +10.00
Pacific/Samoa/Apia Samoa WST -11.00
Pacific/Tongatapu Tonga TOT +13.00
Table 1-10: Supported timezones for BMC ProactiveNet Performance Manager data source (Sheet 1 of 3)
Region Country Region code GMT time difference
GMT (null) GMT 0.00
America/New_York United States of America EST -5.00
America/Chicago United States of America CST -6.00
America/Denver United States of America MST -7.00
America/Phoenix United States of America MST -7.00
America/Los_Angeles United States of America PST -8.00
America/Anchorage United States of America AKST -9.00
Pacific/Honolulu United States of America HST -10.00
America/St_Johns Canada NST -3.30
America/Halifax Canada AST -4.00
America/Toronto Canada EST -5.00
Table 1-9: Supported timezones for BMC Remedy AR System server data source (Sheet 4 of 4)
Country Region Region Code GMT time difference
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
43/68
Chapter 1 Universe characteristics and related information 39
BMC Software, Inc., Confidential
Timezone table and supported timezones
America/Rankin_Inlet Canada CST -6.00
America/Regina Canada CST -6.00
America/Inuvik Canada MST -7.00America/Vancouver Canada PST -8.00
America/Mexico_City Mexico CST -6.00
America/Mazatlan Mexico MST -7.00
America/Hermosillo Mexico MST -7.00
America/Tijuana Mexico PST -8.00
Asia/Shanghai China CST 8.00
Asia/Kolkata India IST 5.30
Asia/Tokyo Japan JST 9.00
Europe/London Britain (UK) BST 0.00Europe/Paris France CET 1.00
Europe/Berlin Germany CET 1.00
Europe/Copenhagen Denmark CET 1.00
Europe/Belgrade Serbia CET 1.00
Europe/Sarajevo Bosnia and Herzegovina CET 1.00
Europe/Istanbul Turkey EET 2.00
Africa/Johannesburg South Africa SAST 2.00
Asia/Riyadh Saudi Arab AST 3.00
Africa/Nairobi Kenya EAT 3.00Asia/AbuDhabi UAE GST 4.00
Asia/Katmandu Nepal NPT 5.45
Asia/Novosibirsk Russia NOVT 6.00
Asia/Krasnoyarsk Russia KRAT 7.00
Asia/Irkutsk Russia IRKT 8.00
Asia/Yakutsk Russia YAKT 9.00
Asia/Bangkok Thailand ICT 7.00
Asia/Hong_Kong Hong Kong HKT 8.00
Asia/Singapore Singapore SGT 8.00America/Bogota Colombia COT -5.00
Atlantic/Cape_Verde Cape Verde CVT -1.00
Europe/Madrid Spain CET 1.00
Europe/Rome Italy CET 1.00
Europe/Stockholm Sweden CET 1.00
Europe/Warsaw Poland CET 1.00
America/Lima Peru PET -5.00
Table 1-10: Supported timezones for BMC ProactiveNet Performance Manager data source (Sheet 2 of 3)
Region Country Region code GMT time difference
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
44/68
40 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Asia/Seoul South Korea KST 9.00
Asia/Pyongyang North Korea KST 9.00
Table 1-10: Supported timezones for BMC ProactiveNet Performance Manager data source (Sheet 3 of 3)
Region Country Region code GMT time difference
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
45/68
Chapter 2 Universe and report customization templates 41
Chapter
BMC Software, Inc., Confidential
2Universe and report customizationtemplates
This section contains procedures and best practices for customizing the ITSMuniverse and reports, as well as templates for recording your customizations.
This section contains the following topics: Universe customization templates on page 42
Report customizations on page 43
Variable additions and Changes on page 46
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
46/68
42 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Universe customization templates
Use the table in this section to record customizations that you make to any of theuniverses. Compare the parameter values in the Old Value column with the values
in your environment and record the new value in the New Value column.The table below provides the old value from the ITSM universe. You can create atable for any of the installed universes, however, by recording the universeparameters and appropriate values.
IMPORTANT
Adding new classes and objects to the universe is subject to the BMC Softwarecustomization policy, available at http://www.bmc.com/support/customization-policy.html. If you modify the BMC Remedy AR System database structure byadding, removing, or changing ITSM application forms, before you can use them,you must import the universe by selecting File => Import using the
BusinessObjects Designer tool. You must then refresh the universe structure, byselecting View => Refresh Structure in the BusinessObjects Designer tool. Anytime you modify the ITSM universe or reports, you should export the universe byselecting File > Export using the SAP BusinessObjects Designer tool.
Table 2-11: Universe customization values
Parameter Name Old Value New Value
ANSI92 Yes
AUTO_UPDATE_QUERY No
BLOB_COMPARISON NoBOUNDARY_WEIGHT_TABLE -1
COLUMNS_SORT No
COMBINED_WITH_SYNCHRO No
COMBINE_WITHOUT_PARENTHESIS No
COMPARE_CONTEXTS_WITH_JOINS Yes
CORE_ORDER_PRIORITY No
CORRECT_AGGREGATED_CONDITIONS_IF_DRILL
No
CUMULATIVE_OBJECT_WHERE No
DECIMAL_COMMA No
DISTINCT_VALUES DISTINCT
END_SQL
EVAL_WITHOUT_PARENTHESIS No
FILTER_IN_FROM No
FIRST_LOCAL_CLASS_PRIORITY No
FORCE_SORTED_LOV No
JOIN_BY_SQL No
MAX_INLIST_VALUES -1
http://www.bmc.com/support/customization-policy.htmlhttp://www.bmc.com/support/customization-policy.htmlhttp://www.bmc.com/support/customization-policy.htmlhttp://www.bmc.com/support/customization-policy.html -
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
47/68
Chapter 2 Universe and report customization templates 43
BMC Software, Inc., Confidential
Report customizations
Report customizations
Before performing any modifications to a report, create a backup of the originalreport and store the backup in a designated backup folder. The following exampleshows a suggested naming convention for the backup folder:
_Backup
Use the template provided in this section as a guide for recording modifications tothe BMC Analytics for BSM reports.
REPLACE_COMMA_BY_CONCAT No
SHORTCUT_BEHAVIOR Successive
THOROUGH_PARSE No
UNICODE_STRINGS No
Sql Name Value
Multiple SQL Statements for each Context TRUE
Multiple SQL Statements for eachMeasure
FALSE
Allow Use of Union,Intersect and MinusOperators
TRUE
Cartesian Products Warn
Allow Selection of Multiple Contexts FALSE
Allow Use of Subqueries TRUE
Allow Complex Operands in Query Panel TRUE
Control Name Value
Limit Execution Time Value 600
Limit Size of Long Text Object Value 4000
Limit Size of ResultSet Value 5000
Universe Details Value
Universe Name ITSM
Universe Full Path C:\Documents andSettings\satish.mallavolu\Desktop\ITSM25-Unv\ITSM.unv
Universe Connection shared-conn
Universe Current Owner
Universe Creation Date 20/03/2007
Universe Modified Date 13/10/2008
Parameter Name Old Value New Value
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
48/68
44 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
IMPORTANT
Any time you modify the ITSM universe or reports, you should export theuniverse by selecting File > Export using the BusinessObjects Designer tool.
Section 1: Report Identification
Section 2: Data Selection/Grouping/Sorting/Parameters
New and Changed parameter description
NOTE
All parameters should be used in an 'AND' fashion.
Report Name
BSA
Business JustificationFor Customization
Request Type New Report? Modification? Scheduled? On-Demand?
New Objects Included in the
reportObjects Modified with old andnew formulae
Objects Deleted from thereport
Change in Sort Order , .
Change in Grouping
New/Modified Formulae
Other Description
Field Name Field Type Selection Type Initial Values Data Source Other Requirements
Time Period toAnalyze
Integer Entry 24 This parameter willbe in hours
Drop Down List MultipleSelection
* = All
A blank parameterin this field indicatesthat it should not beincluded in thequery/filter
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
49/68
Chapter 2 Universe and report customization templates 45
BMC Software, Inc., Confidential
Report customizations
Section 3: Report Presentation Changes
Chart Requirements
Field Description
Format PDF: __ (Y/N) Excel: __ (Y/N)
Cover Page Company Logo (left-hand corner)
Report title (centered)
Report Information - an overview of the report's contentReport Selection Criteria - an overview of the report's query
Contact Information - who to contact with data questions
Page Header Report Title
"Jump to Top of Data" link
Page Footer Last Run Date/Time
Page number
Group Header
Group Footer
Other specialrequirements
The Chart will be presented after the Cover Page but before the actual data.
The Report will use all of the default colors of the Analytics tool except in the chartwhich will follow colors as supplied
The Report will be presented in Landscape Page Format
Display None? Per Report? Per Group? If Yes, describedetails:
Chart Titles "First Call Resolution (" + Count of all Incidents in report + ")"
Chart Type with
Details
This report will utilize a bar chart
The X Axis will show the Initials of each Associate included in the report:
The Y Axis will indicate the number of incidents for each Associate
Drill Down:
When the Total in the report is clicked, the user will be taken to the first page of the dataarea of the report
When any of the bars or initials are clicked, the user will be taken to the group in thereport of the selected Associate.
Please note that the Total bar should NOT be included
Field Name onReport
Field Name ofView
Form Name /DB TableName
Field Nameof DB
Field Type& Lengthon Report
Special Formatting or OtherNotes
Incident ID+ Incident ID HPD:Help Desk
HPD_Help_Desk
Incident_ID
Priority Priority HPD:Help Desk
HPD_Help_Desk
Priority Selection60
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
50/68
46 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
Variable additions and Changes
Summary Summary HPD:Help Desk
HPD_Help_Desk
Summary Character100
Product Name ProductName
HPD:Help Desk
HPD_Help_Desk
ProductName
Character254
Product Name will be pulledfrom Resolution ProductClassification if ticket is in a'Resolved,' 'Closed,' or'Cancelled' status otherwiseuse Product Classification
Status Status HPD:Help Desk
HPD_Help_Desk
Status Selection
60
AssignedGroup
AssignedGroup
HPD:Help Desk
HPD_Help_Desk
AssignedGroup
Character254
Assignee ID Assignee ID HPD:Help DeskHPD_Help_Desk
Assignee Selection69
Reported Date ReportedDate
HPD:Help Desk
HPD_Help_Desk
Reported_Date
Date
Field Name onData Provider
Field Nameof Form
Form Name /DB TableName
Field Nameof DB
Field Type& Lengthon Report
Special Formatting or OtherNotes
Incident ID+ Incident ID HPD:Help Desk
HPD_Help_Desk
Incident_ID
Character
15
Priority Priority HPD:Help Desk
HPD_Help_Desk
Priority Selection
60
Summary Summary HPD:Help Desk
HPD_Help_Desk
Summary Character
100
Product Name ProductName
HPD:Help Desk
HPD_Help_Desk
ProductName
Character
254
Status Status HPD:Help Desk
HPD_Help_Desk
Status Selection
60
AssignedGroup
AssignedGroup
HPD:Help Desk
HPD_Help_Desk
AssignedGroup
Character
254
Assignee ID Assignee ID HPD:Help Desk
HPD_Help_Desk
Assignee Selection
69
Reported Date ReportedDate
HPD:Help Desk
HPD_Help_Desk
Reported_Date
Date
Field Name onReport
Field Name ofView
Form Name /DB TableName
Field Nameof DB
Field Type& Lengthon Report
Special Formatting or OtherNotes
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
51/68
Chapter 3 Report conditions and default views 47
Chapter
BMC Software, Inc., Confidential
3Report conditions and default views
Report conditions
This section contains the list of conditions for each report, by application. For a listof all of the conditions available in the universes, see the Self Help Document IDKA345616in the BMC Knowledge Base.
For more information about report conditions and the procedure to add acondition to a hyperlinked report, see BMC Analytics for Business ServiceManagement Installation and Administration Guide.
-
7/23/2019 BMC Analytics for BSM 7.6.04 Reference Guide
52/68
48 Reference Guide
BMC Analytics for BSM 7.6.04
BMC Software, Inc., Confidential
The following two tables contain the list of reports that contain predefinedconditions. The first table shows the predefined reports that have hyperlinks, thereport that is shown when the hyperlinks are traversed, and the conditions used tofilter the parameter information for the report shown. The second table contains al