IBM Cognos Controller Version 10.2.0. New Features Guide

IBM Cognos Controller Version 10.2.0 New Features Guide

Note Before using this information and the product it supports, read the information in Notices on page 9. Product Information This document applies to IBM Cognos Controller Version 10.2.0 and may also apply to subsequent releases. Licensed Materials - Property of IBM Copyright IBM Corporation 2004, 2014. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents Introduction.................................. v Chapter 1. New features in IBM Cognos Controller version 10.2............ 1 Command Center.................................. 1 New advanced formula calculations........................... 1 Expanded audit trail information............................ 1 Improved accounts and journals............................. 1 Additional UDBR features............................... 2 New control table E411 for deferred taxes.......................... 2 FAP user groups.................................. 2 One source definition for each Controller database...................... 3 Greater FAP performance and stability........................... 3 64-bit Server (.NET)................................. 3 New multi-threaded batch engine............................ 4 Installation and configuration.............................. 4 Interoperability and conformance additions......................... 4 IBM Cognos BI - import external data from a Cognos BI report.................. 5 New server preferences................................ 5 Enhanced fexpval and fgetval functions.......................... 5 Chapter 2. Deprecated features in version 10.2................... 7 Interoperability and conformance deprecations........................ 7 Old consolidation model............................... 7 Segment reporting (IC and IP): IC_INCLUDE_ADJ_DIM=YES................... 7 Notices.................................... 9 Index.................................... 13 Copyright IBM Corp. 2004, 2014 iii

iv IBM Cognos Controller Version 10.2.0: New Features Guide

Introduction This guide describes the features that are new in IBM Cognos Controller. IBM Cognos Controller is a Web-based financial consolidation tool that provides standard reports to support both statutory and management reporting. IBM Cognos Controller is integrated with various IBM Cognos products to provide a complete solution for analysis and reporting. Finding information To find product documentation on the web, including all translated documentation, access IBM Knowledge Center (http://www.ibm.com/support/ knowledgecenter). Release Notes are published directly to IBM Knowledge Center and include links to the latest technotes and APARs. You can also read PDF versions of the product release notes and installation guides directly from IBM Cognos product disks. Forward-looking statements This documentation describes the current functionality of the product. References to items that are not currently available may be included. No implication of any future availability should be inferred. Any such references are not a commitment, promise, or legal obligation to deliver any material, code, or functionality. The development, release, and timing of features or functionality remain at the sole discretion of IBM. Accessibility features Accessibility features help users who have a physical disability, such as restricted mobility or limited vision, to use information technology products. IBM Cognos Controller has accessibility features. For information on these features, see the accessibility section in the IBM Cognos Controller User Guide. IBM Cognos HTML documentation has accessibility features. PDF documents are supplemental and, as such, include no added accessibility features. Copyright IBM Corp. 2004, 2014 v

vi IBM Cognos Controller Version 10.2.0: New Features Guide

Chapter 1. New features in IBM Cognos Controller version 10.2 Command Center This section describes the new features of IBM Cognos Controller. The group Command Center window is simplified and you can perform more tasks from the Command Center menu. The changes to the group and vompany Command Center provide the following benefits: v The chart gives a better overview (group). v Form details can be excluded (group). v You can select multiple submissions (group). v You can lock and unlock companies or submissions (company/group). v You can open intercompany reports and send an email (company/group). New advanced formula calculations The new COMPANY_YTD function allows you to retrieve data from a specific company that can be used for all companies in an Advanced Formula Calculation job. For example, you can now specify in one entry the number of banking days to be used for all companies in a calculation. In previous versions, you had to enter this information for each company individually. The syntax of the AVERPER functions is now improved so that you can create dynamic intervals for average calculations. You do this by specifying a start period, instead of a fixed number of periods, in the calculation formula. When you run the calculation, the number of periods to include in the average calculation is determined for each period that is calculated. Expanded audit trail information The System Audit Log is expanded with new audit trail information. All changes in the General Configuration are now logged. Improved accounts and journals As of IBM Cognos Controller version 10.2, you can prevent users from selecting accounts that belong to a locked submission. When you add a new company journal, you can then select only the available accounts that are displayed in the pop-up menu. If an existing company journal is open for updates, you can add or change only the available accounts. This is handled through the account validation pop-up. Copyright IBM Corp. 2004, 2014 1

Additional UDBR features When you open a journal with at least one locked account, the journal is opened in read-only mode. You can activate this feature by specifying the server preference DEJOURNAL_SUBMLOCK = TRUE Note: The check for available or locked accounts is applicable to data entry of Company Journals only. You can perform additional tasks using UDBR. UDBR now includes the following features: v You can use the IF ELSE function to set rules for transfer between accounts. v You can define the specific members of the four extended dimensions as the source of the business rule. v You can indicate that the target extended dimension must be the same as the source extended dimension. New control table E411 for deferred taxes FAP user groups You use control table E411 when the deferred tax calculation should apply only for companies and not for consolidated values at the group level. Control table E411 is similar to control table E410. You can assign permission levels to a Financial Analytics Publisher (FAP) user by adding them to one or more of the following user groups: 1) IBM Cognos Controller User, 2) IBM TM1 User, or 3) User Group Administrator. You specify the permissions levels in Controller using Maintain > Rights > User. The access restrictions that you define in Controller also apply in TM1. The access to one or more dimensions is determined by the Security Group limitations. If an Initial Publish was performed in a previous Controller release, all users from the previous release will still exist on the TM1 server. If it is no longer required that some of those users be active in the TM1 server, the TM1 administrator must delete them. Note: If any unwanted users/clients were not deleted from TM1, those users' rights are removed after a publish from FAP 10.2. However, the users remain visible when you view Client Security. The IBM Cognos Controller User group IBM Cognos Controller User group members can use Controller and the Excel Link Add-in. Note: If a user is assigned only to the IBM Controller User group, they cannot use IBM Cognos TM1. The IBM TM1 User group IBM Cognos TM1 User group members can use TM1. 2 IBM Cognos Controller Version 10.2.0: New Features Guide

Note: If a user is assigned only to the IBM TM1 User group, they cannot use IBM Cognos Controller or the Excel Link Add-in. User names assigned to the IBM Cognos TM1 User group are copied over when you publish to the IBM Cognos Controller Financial Analytics Publisher. IBM Cognos TM1 User group members can access Controller data in a published FAP cube in TM1 if they were granted access to the cube. An Initial Publish transfers all active TM1 users to the TM1 server. Inactive TM1 Users and inactive IBM Cognos Controller Users are not transferred to the TM1 Server. The User Group Administrator group User Group Administrator group members can use both Controller and TM1. A member of the User Group Administrator group can change permissions for other users in his group, but not for the group itself. This type of user cannot change permissions for users on a higher level in the hierarchy than his own group. This option is not available for users who are assigned only to the IBM Cognos TM1 User group. Note: After you upgrade a Controller database from an earlier version of IBM Cognos Controller, all users are members of the User Group Administrator group by default. Therefore, if you do not want certain users to access FAP cubes, you must move them to the IBM Controller User group before you run an Initial Publish. One source definition for each Controller database In release 10.2 of IBM Cognos Controller and IBM Cognos Controller Financial Analytics Publisher, a Controller database can be referenced by only one source definition. If you try to reference a Controller database by more than one source definition, the following message appears: Cannot add source. Source with this Controller database already exists. Please choose another Controller database. Greater FAP performance and stability 64-bit Server (.NET) In IBM Cognos Controller 10.2, the trickle table for Financial Analytics Publisher (FAP) is separated from the Audit Trail Log. You can separate and automate the purge schedules with optimal indexation, resulting in better overall performance and stability. Note: After the installation, database conversion can take several minutes while tables are created and data is copied. The 64-bit technology (Microsoft.NET) on the Cognos Controller server in version 10.2 allows for better stability because of the lower risk of out-of-memory problems. In addition, more simultaneous users can use the Cognos Controller 10.2 server. Chapter 1. New features in IBM Cognos Controller version 10.2 3

FoxPro components will continue to run in 32 bit (in COM+). In IBM Cognos Controller 10.2, you must perform these configuration tasks: v Set the application pool to 64-bit mode (enable 32 bit applications=false). v Set the process model identity to LocalSystem. v Ensure that the application pool is still set to use.net Framework 2.0. New multi-threaded batch engine Installation and configuration When the server technology was converted to Microsoft.NET, the batch engine was improved. The batch engine in IBM Cognos Controller version 10.2 has the following benefits: v There is no system limitation on the number of parallel batch processes. The only limits are the amount of memory and the CPU. v The single service for all batch processes removes the risk of synchronization issues. v Jobs run more quickly after scheduling because you can modify the batch queue polling frequency. IBM Cognos Controller 10.2 has an improved installation and configuration experience. The number of steps for the system administrator has been reduced. Important: Before you install Cognos Controller 10.2, you must completely uninstall earlier versions of Cognos Controller. Interoperability and conformance additions IBM Cognos Controller 10.2 interoperates with additional products and supports additional applications. Controller 10.2 now interoperates with these products: v TM1 10.2.2 v CDM 10.2.2 v DB2 10.5 Controller 10.2 now supports these applications: v Microsoft Excel 2013 (Requires latest Windows updates) v Microsoft Windows 8.1 (client only) 64-bit v Microsoft SQL Server 2012 v Microsoft Windows Server 2012 (Standard Edition and higher) 64-bit v ORA 11G R2_3 v Microsoft Internet Explorer (IE) 11 v Adobe Reader XI v Microsoft.NET 3.5 SP1 v Microsoft.NET 4.0 v IBM JRE 1.7 v Microsoft IIS8 4 IBM Cognos Controller Version 10.2.0: New Features Guide

Note: To review an up-to-date list of environments supported by IBM Cognos Controller 10.2, such as operating systems, patches, browsers, web servers, directory servers, database servers, and application servers, see the IBM Cognos Controller 10.2 Supported Software Environments site(http://www.ibm.com/ support/docview.wss?uid=swg27041444). IBM Cognos BI - import external data from a Cognos BI report New server preferences You can use filters that were set up in an IBM Cognos Business Intelligence (BI) report, eliminating the transmission of rows that are not needed. To filter the rows within Cognos BI, add one or more filter expressions to the report that is developed as part of the Cognos Controller import specification. The integration between a filter in BI and the Import specification is done by creating variables in the Import specification. These variables need to follow a predefined naming convention for the proper interaction. The ETYPE_EXCLUDE2, CONTRVER_EXCLUDE, and CONTRVER_EXCLUDE server preferences have been added. ETYPE_EXCLUDE2 The server preference ETYPE_EXCLUDE2 is a complement to ETYPE_EXCLUDE. For more information, see the IBM Cognos Controller User Guide. CONTRVER_EXCLUDE The server preference CONTRVER_EXCLUDE is introduced to allow the definition of a Contribution Version in IBM Cognos Controller to include the automatic journal types to be handled as ETYPE_EXCLUDE where ETYPE_EXCLUDE would have otherwise required more than 50 characters. CONTRVER_EXCLUDE2 The server preference CONTRVER_EXCLUDE2 is introduced to allow the definition of a Contribution Version in Cognos Controller to include the automatic journal types to be handled as ETYPE_EXCLUDE2 where ETYPE_EXCLUDE2 would have otherwise required more than 50 characters. Enhanced fexpval and fgetval functions The fexpval and fgetval functions have been enhanced. Access rights to accounts in the Controller Excel link have been modified. When a user logs into the Controller Excel link, the user's access to accounts is now based on the permissions identified in the Security Group "Forms". Chapter 1. New features in IBM Cognos Controller version 10.2 5

6 IBM Cognos Controller Version 10.2.0: New Features Guide

Chapter 2. Deprecated features in version 10.2 A deprecated feature is one that is being replaced by a newer version or a better implementation. The intention is to discontinue the use of the feature and provide recommendations for adapting to this change over multiple releases. Listed below are deprecated features. Interoperability and conformance deprecations Old consolidation model The software environments below are not supported as of IBM Cognos Controller 10.2. v Microsoft Windows Server 2003 (32-bit) v Microsoft Windows Vista v Microsoft Windows XP v Microsoft Excel 2003 v Microsoft Excel XP 2002 SP3 Note: To review an up-to-date list of environments supported by IBM Cognos Controller 10.2, such as operating systems, patches, browsers, web servers, directory servers, database servers, and application servers, see the IBM Cognos Controller 10.2 Supported Software Environments site(http://www.ibm.com/ support/docview.wss?uid=swg27041444). IBM Cognos Controller 10.1.1.x was the last release to support the consolidation model that was the default before the 8.1 release. The old consolidation model is not available as of Controller 10.2. The CONS_BY_LEVEL server preference is no longer supported. Note: Even though it is not possible to consolidate data using the old consolidation model, it is still possible to view consolidated values on periods run with the old consolidation model by using the OLKOREP_AC and CONS_BY_LEVELSTART server preferences. Even though you can upgrade to the new consolidation model in Cognos Controller 10.2, we recommend that you upgrade to the new consolidation model before upgrading to Controller 10.2. We recommend that you use the latest version of Controller version 10.1.1 FP3 to perform the upgrade. For more information, see your IBM Cognos consultant. Segment reporting (IC and IP): IC_INCLUDE_ADJ_DIM=YES The Server preference IC_INCLUDE_ADJ_DIM=YES is no longer needed. The functionality to use or not use counter dimensions and adjustment dimensions is activated through existing check boxes. Copyright IBM Corp. 2004, 2014 7

8 IBM Cognos Controller Version 10.2.0: New Features Guide

Notices This information was developed for products and services offered worldwide. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. This document may describe products, services, or features that are not included in the Program or license entitlement that you have purchased. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. Copyright IBM Corp. 2004, 2014 9

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Software Group Attention: Licensing 3755 Riverside Dr. Ottawa, ON K1V 1B7 Canada 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 material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information softcopy, the photographs and color illustrations may not appear. This Software Offering does not use cookies or other technologies to collect personally identifiable information. 10 IBM Cognos Controller Version 10.2.0: New Features Guide

Trademarks IBM, the IBM logo and ibm.com are trademarks or registered trademarks of International 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 and trademark information at www.ibm.com/legal/copytrade.shtml. The following terms are trademarks or registered trademarks of other companies: v Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Notices 11

12 IBM Cognos Controller Version 10.2.0: New Features Guide

Index Special characters.net 4 Numerics 64-bit server 4 A Advanced Formula Calculations 1 Audit trail 1 Available accounts and journals 1 B batch engine 4 BI filters 5 C Command Center 1 consolidation model 7 control table for deferred taxes 2 filters in BI reports 5 I installation and configuration 4 interoperability and conformance 4, 7 M multi-threaded batch engine 4 P permission levels for a FAP user 2 S segment reporting 7 source definition 3 U udbr 2 user groups 2 E E411 control table 2 F FAP performance and stability 3 fexpval 5 fgetval 5 Copyright IBM Corp. 2004, 2014 13