You are on page 1of 8

First Release Category

6.1.0
6.1.0
6.1.0
6.1.0
6.1.0
6.1.0
6.1.0
6.1.0
6.2.0
6.2.0
Calculation Functions
6.2.0
Config file setting related to
Calculation scripts
6.2.0 Calculation Commands
6.2.0 Custom Defined Calculation Functions
6.5.0
Calculation improvements
6.5.0
6.5.0
Feature
Essbase calculation languagge / engine can be extended through CDF (Custom Defined Functions and Macros)
Existing calculation functions can be combined as a Macro.
Custom defined functions will enable you to build your own custom calculator functions as part of calculation
engine. These functions are defined in Java. With these CDF's, the doors are open for unlimited capabilities of
how robust and scalable Essbase is
New Calculator Functions
Member Set Functions
@IRDESCENDENTS Returns all descendants of the specified member (optionally up to the specified generation
or level), including the specified member and the descendants of shared members.
@RDESCENDENTS Returns all descendants of the specified member (optionally up to the specified generation
or level), including descendants of shared members, but not the specified member.
@MEMBER Given a character string, the function returns the member with the name specified by that character
string.
New Calculator Functions (continued)
Mathematical Functions
@EXP Returns the value of e (the base of natural logarithms) raised to the power of the specified expression.
@LN Returns the natural logarithm of a specified expression.
@LOG Returns the logarithm to a specified base of a specified expression.
@MAXS Returns the maximum value among the expressions in the specified member list, with the ability to skip
zero and #MISSING values, or skip zero or #MISSING values.
@MINS Returns the minimum value among the expressions in the specified member list, with the ability to skip
zero and #MISSING values, or skip zero or #MISSING values.
New Calculator Functions (continued)
Range and Financial Functions
@MAXSRANGE Returns the maximum value of a member across a range of members, with the ability to skip
zero and #MISSING values, or skip zero or #MISSING values.
@MINSRANGE Returns the minimum value of a member across a range of members, with the ability to skip zero
and #MISSING values, or skip zero or #MISSING values.
Relationship Functions
@ATTRIBUTEBVAL Returns the value (TRUE or FALSE) of the attribute from the specified Boolean attribute
dimension associated with the current member.
@ATTRIBUTESVAL Returns the text value of the attribute from the specified text attribute dimension associated
with the current member.
New Calculator Functions (continued)
String Functions
@CONCATENATE Returns a character string that is the result of appending a member name or specified
character string to another member name or character string.
@SUBSTRING Returns a substring of characters from another character string or from a member name.
Calculation Method Function
@CALCMODE Override the execution mode chosen by Hyperion Essbase for a formula in order to maximize
performance. For example, you can use this function to change the execution of sparse member formulas that
run more slowly in top-down mode to run in a faster bottom-up mode.
You can also use @CALCMODE to change the execution of formulas that calculate correctly without cell mode to
run in the faster block mode.
Dynamic Calculator Cache
Essbase Release 6.1 includes a new dynamic calculator cache. The dynamic calculator cache helps manage
memory usage for calculations involving Dynamic Calc members. Managing data blocks in the dynamic
calculator cache also reduces the overall memory space requirement and can improve performance by reducing
the number of calls to the operating system to do memory allocations. Release 6.1 includes five new essbase.cfg
settings that you can use to establish the size of this cache and define how it is used.
Release 6.1 Configuration Settings (essbase.cfg)
AGENTLOGMESSAGELEVEL Specifies the level of messages written to the Agent Event Log.
LOGMESSAGELEVEL Specifies the level of messages written to the Application Event Log.
DYNCALCCACHEMAXSIZE Specifies the maximum size Essbase can allocate to each dynamic calculator cache
on the server.
DYNCALCCACHEONLY Specifies whether Essbase performs Dynamic Calc calculations in memory outside the
dynamic calculator cache. Used when the dynamic calculator cache has no more room.
DYNCALCCACHEWAITFORBLK Specifies whether Essbase waits until space becomes available in the dynamic
calculator cache or immediately writes and calculates the data blocks in memory outside the dynamic calculator
cache.
DYNCALCCACHEBLKTIMEOUT Specifies how long Essbase waits for available space in the dynamic calculator
cache.
Release 6.1 Configuration Settings (essbase.cfg - continued)
DYNCALCCACHEBLKRELEASE Specifies whether Essbase writes and calculates the blocks immediately
outside the dynamic calculator cache or uses space in the dynamic calculator cache that it makes available by
swapping out blocks and temporarily compressing them in a dynamic calculator cache compressed-block buffer.
DYNCALCCACHECOMPRBLKBUFSIZE Specifies the size of the dynamic calculator cache compressed-block
buffer.
EXPORTTHREADS Enables the user to set the number of export threads that can be used to export data.
JVMMODULELOCATION Specifies the Java Virtual Machine library to be used by Essbase.
Updated
EXCEPTIONLOGOVERWRITE Default values is now FALSE.
introduction of essbase administration services
New Calculation Functions
Essbase provides three new calculation functions in this release:
Use @PRIORS and @NEXTS to skip #MISSING values, zero (0) values, or both, or neither during a calculation.
@PRIOR and @NEXT, which do not skip, are still available.
Use @NAME to pass a member name, as a string, to another function.
Use @ALIAS to pass a member alias, as a string, to another function.
New CALCMODE Configuration Setting
You can now set CALCMODE to BLOCK or BOTTOMUP using the configuration setting CALCMODE in the
server configuration file essbase.cfg, and give it server, application, or database scope instead of using the
@CALCMODE function. For more information, see the configuration settings in Technical Reference in the docs
directory.
Member Set Function Support in FIX
All functions that return a member or set of members are now supported when they occur within FIX statements.
Member and member set functions in FIX is also supported for partition definitions and security filters. For a list of
member functions, follow these links from the Technical Reference in the docs directory:
Essbase Functions -- List --> Types of Functions --> Member Set
Custom-Defined Functions and Macros
Several changes have been made to custom-defined functions (CDF) and custom-defined macros (CDM):
You no longer need to install the Java Virtual Machine (JVM) to create or use CDMs. CDFs still require the
JVM.
Essbase no longer validates function records before completing the creation process. Errors are detected only
when an application loads the CDF. Typically, this occurs during server startup and when the MaxL Refresh
Custom Definitions statement is executed. The Essbase Agent checks the function for a valid name but does no
other validation. This means that there is no longer a need to start an application in order to
create a function.
Calculation, Load and Retrieval Improvements
Parallel Calculation
In addition to the standard means of performing a calculation, where each task is performed in sequence or
serially, Essbase now supports parallel calculation. If you enable parallel calculation, Essbase analyzes all the
tasks in a calculation pass and breaks them down into subtasks. The subtasks that can run independently of
each other are scheduled to run simultaneously on up to four threads, each on a separate CPU.
For information about when to use parallel calculation, and how it interacts with other Essbase features, see
the chapter on optimizing calculations in the Essbase Database Administrators Guide.
Calculation, Load and Retrieval Improvements (continued)
The Technical Reference in the docs directory contains entries in the configuration setting and calculation
commands sections. You can enable and adjust parallel calculation by adding CALCPARALLEL (and optionally
CALCTASKDIMS) to your essbase.cfg configuration file, or you can issue the calculation commands SET
CALCPARALLEL and SET CALCTASKDIMS.
Simulated Calculation
Use the calculation command SET MSG ONLY to perform simulated calculations. A simulated calculation
estimates the amount of time needed to perform a default calculation. The simulated calculation can also help
you to select dense and sparse settings for the dimensions in your outline.
See the Technical Reference in the docs directory for instructions about how to add the command to a
calculation script. See the Essbase Database Administrators Guide for information about how to use the results
from SET MSG ONLY.

You might also like