*****************************************************************

IBM DB2 OLAP Server 7.1
and DB2 OLAP Integration Server 7.1

FixPak 9
Release Notes

*****************************************************************

FixPak Date:  July 2002

Service Levels:


Important:

FixPak 9 for DB2 OLAP Server Version 7.1 is the equivalent of Maintenance Level 2 (patch 2) for Hyperion Essbase OLAP Server Release 6.2 and Maintenance Level 1 (patch 1) for Essbase Integration Services 6.2..

The DB2 OLAP Server and DB2 OLAP Integration Server clients no longer support Windows 95.  The clients support Windows 98, Windows NT 4.0 SP5 and later, and Windows 2000.

If your current service level is FixPak 6 or earlier, and if you installed the DB2 OLAP Integration Server (OIS) sample application, then you should back up your existing OIS sample database, OLAP Metadata Catalog, and the OLAP models and metaoutlines that you want to preserve before installing this FixPak.  After backing up your samples, you can upgrade your existing catalog to be compatible with this FixPak (see Upgrading the OLAP Metadata Catalog). You cannot, however, store new sample OLAP models and metaoutlines in your previous catalog.  Nor can you roll back to the previous release after migrating your metadata catalog to FixPak 7 or later, which is not compatible with previous FixPaks.  Do not attempt to use the FixPak 7 or later catalog with previous levels of DB2 OLAP Integration Server software. Doing so could result in corrupted OLAP Metadata Catalog data.

If you are installing client products from a DB2 OLAP Server FixPak, you must install server products to the same FixPak level. For example, if you install a FixPak 9 client, you must also install the FixPak 9 server. Using older server versions with newer client versions is not recommended and is not supported.

IBM DB2 OLAP Server offers a feature exclusive to IBM called DB2 OLAP Server Miner.  See DB2 OLAP Server Miner combines OLAP and data mining technologies for more information about what OLAP Miner can do for you.


Contents:


FixPak installation overview

This document describes how to install FixPak 9 for DB2 OLAP Server 7.1.  It also includes additional documentation and a list of problems corrected by the FixPak.  Even if you have only one of the problems listed in this document, you need to perform a full FixPak installation.

For instructions on downloading and installing the files in this FixPak, see Installing on UNIX or Installing on Windows, depending on your operating system. FixPak 4 and later adds additional function that requires Java; see Setting Up Java on Windows and Setting up Java on UNIX for instructions.  For more detailed information about installation, see the OLAP Setup and User's Guide.

FixPak 9 for DB2 OLAP Server Version 7.1 is the equivalent of maintenance level 2 (patch 2) for Hyperion Essbase Release 6.2 and maintenance level 1 (patch 1) for Hyperion Integration Server 6.2.  Hyperion maintenance levels are cumulative; each level contains new fixes and all the fixes for the previous maintenance levels.


Before you install the FixPak

To install this FixPak, make sure your system has enough memory.  Then download the files that match your operating system and language, or copy the files from a CD, and begin the installation.  For complete installation instructions, see the OLAP Setup and User's Guide.

Known problem with installation program

If you have OLAP Miner installed, back up our OMClient.cfg configuration file before installing installing FixPak 9.  FixPak 9 overwrites OMClient.cfg with a default copy, and if you have more than one OLAP Miner server specified, that information is lost.  OMClient.cfg is located in the $ARBORPATH/bin directory.  Create a backup copy of OMClient.cfg before installing FixPak 9.  After installing FixPak 9, replace the copy in $ARBORPATH/bin with the backup. (IBM5892)

See Known problems for information about problems you need to know about after the installation.

Changes to supported software

FixPak 7 and later changes the levels of software supported by DB2 OLAP Integration Server: Also, FixPak 7 withdraws the Business Intelligence Tutorial because the interface it describes has been withdrawn from Essbase Integration Services 6.1.  DB2 OLAP Integration Server now offers Intelligent Help instead.

FixPak 4 and later changes the levels of software supported by DB2 OLAP Server:

If you use DB2 OLAP Server on UNIX, you might encounter problems with DB2 OLAP Server after you install FixPak 2a of DB2 Universal Database V7.  FixPak 2a and later FixPaks install new ODBC drivers that support UNICODE, but DB2 OLAP Server does not support these new drivers.  The workaround is to switch your ODBC files to point to the non-UNICODE ODBC drivers.

The non-UNICODE drivers have been renamed to add "_36" in their names.  For example, for Solaris, the driver libdb2.so was renamed to libdb2_36.so, and for AIX,  the driver db2.o was renamed to db2_36.o.  For more information about changing ODBC drivers, see Configuration tips in this document, and also see "Loading and Configuring ODBC for the SQL Interface" in Chapter 4, "Installing on AIX, Solaris Operating Environment, and HP-UX," of the OLAP Setup and User's Guide.

Future FixPaks of DB2 Universal Database will continue to have this same restriction until the DB2 OLAP Server ODBC program is changed to accept UNICODE drivers.  See the OLAP Setup and User's Guide for more information about supported software.

Physical memory and disk requirements

When installing DB2 OLAP Server, remember the following memory recommendations:
Minimum RAM 64 MB or greater (128 MB or greater for UNIX platform) base recommendation:

The base recommendation for running DB2 OLAP Server and its sample applications is a 64 MB minimum. On UNIX platforms, base requirement is 128 MB of physical memory (256 MB recommended), and at least twice the MB of physical memory for swap space (when physical memory is less than .5 GB). Contact your system administrator or hardware vendor for optimum swap configuration. Start with the base amount of RAM for your platform, and then allocate additional memory to accommodate your applications.

Basic amount of RAM needed for most applications

Starting in FixPak 4, you should consider starting with 0.5-1.0 GB of physical memory on the server per processor or per 50-75 concurrent users. This number can vary depending on number of users, number of concurrent batch processes, and use of memory-intensive features. See the Database Administrator's Guide; Volume I, Chapter 15, "Estimating Disk and Memory Requirements for a Database."

Memory limitations

The following memory limits for DB2 OLAP Server apply to code, work areas, and caches on Windows:

Memory problems

If memory is low, the following unpredictable problems can occur:

When one of the above situations occur: HP-UX has memory management issues, and HP is working on a patch to resolve them. To avoid memory leaks, as a temporary work around set_M_ARENA_OPTS to 1:32.

Stopping services on Windows before installation

The installation program on Windows NT and Windows 2000 automatically stops the Windows services for DB2 OLAP Server and its features before copying files.  In rare circumstances the install program might appear to freeze after displaying the message that it is stopping the services.  If this occurs, exit the installation and manually stop any DB2 OLAP Server services that are running.

To stop Windows NT and Windows 2000 services:

  1. Select Services from the Control Panel.
  2. From the Service list, select the service for DB2 OLAP Server and, if present, the service for DB2 OLAP Integration Server.
  3. Click Stop.

Workaround for bug on Windows

On Windows, DB2 OLAP Server experiences problems if the TMP User Variable or the TEMP Environment Variable is longer than seven characters.  The temporary workaround is to created a directory called temp (if it does not already exist) and set both variables to the following value:
c:\temp
To change your Windows 2000 TMP User Variable and TEMP Environment Variable, take these steps:
  1. On your Windows 2000 workstation, click Start -> Settings -> Control Panel -> System.
  2. Select the Advanced tab of the System Properties dialog.
  3. Click Environment Variables.
  4. In the User variables box, scroll down to the TEMP variable, highlight it, and click Edit....
  5. On the Edit User Variable dialog, change the Variable Value to c:\temp and click OK.
  6. In the System  variables box, scroll down to the TMP variable, highlight it, and click Edit....
  7. On the Edit System Variable dialog, change the Variable Value to c:\temp and keep clicking OK until you close the Environment Variables dialog.
OLAP Miner experiences similar problems on Windows 95 and Windows 98. To change your Windows 95 or Windows 98  TMP User Variable or the TEMP Environment Variable, take these steps:
  1. Edit the Autoexec.bat file located in C:\ root.
  2. Enter these two lines:

Migrating applications to FixPak 4 and later

The installation program does not reinstall the sample applications, databases, and data files. Your existing applications and databases are not affected in any way. However, it is always a good idea to back up your applications and databases before an installation.

Your applications are automatically migrated to the latest FixPak level when you open them.


Installing the FixPak

This section describes how to install servers on UNIX, clients and servers on Windows, and how to configure Java on UNIX and Windows.

Starting in FixPak 4, DB2 OLAP Server requires Java to enable new function; starting in FixPak 7, DB2 OLAP Server also requires Java.  See Setting Up Java on Windows and Setting up Java on UNIX for more information.

Installing on UNIX

This FixPak for DB2 OLAP Server on UNIX consists of two files. The first file is for your UNIX computer and it contains upgrades for the server, SQL Interface, and API components. The second file is for your Window client computer and it contains upgrades for the Application Manager, Spreadsheet Add-in, and other client components for your language.

You can also install OLAP Miner in this FixPak.  The server component of OLAP Miner is available only on AIX 4.3.3 and later.

The OLAP Setup and User's Guide incorrectly states that you must be logged on with a user ID that has root privileges when you install DB2 OLAP Server on UNIX systems.  You do not need root privileges to install the product.

Installing fixes for the UNIX server

Download one of the following files, depending on which UNIX operating system you use, to a temporary directory on the UNIX computer on which you installed the server.  If you are installing from a CD, copy the file to the temporary directory.
Filename Server Components
aix.tar  AIX OLAP Server 
AIX OLAP Integration Server
AIX SQL Interface 
AIX Application Programming Interface
AIX OLAP Miner
solaris.tar  Solaris Operating Environment OLAP Server 
Solaris Operating Environment OLAP Integration Server
Solaris Operating Environment SQL Interface
Solaris Operating Environment Application Programming Interface
hpux.tar HP-UX OLAP Server 
HP-UX OLAP Integration Server
HP-UX SQL Interface 
HP-UX Application Programming Interface

To start the server installation:

  1. On your UNIX system, extract the installation files by entering the following command from the temporary directory containing the installation .tar file:
    1. tar -xf filename.tar


    This command extracts the files necessary to perform a complete installation.
     

  2. Run setup.sh to launch the installation program.  Follow the installation instructions in the OLAP Setup and User's Guide.   (On AIX, if you get a segment fault or a core dump when you install or use DB2 OLAP Server, then the current AIX stack size on the computer is not large enough.  To increase the stack size, run the AIX command "ulimit -s unlimited".  For more information about the ulimit command, see the AIX Commands Reference.)

  3.  
  4. After the files are expanded, you can delete the .tar file.

Using scripts to update environment settings on UNIX

When you run DB2 OLAP Server and DB2 OLAP Integration Server on UNIX operating systems, you must specify certain environment variables, including variables for Java.

Starting in FixPak 4, DB2 OLAP Server requires Java, and scripts are included with DB2 OLAP Server that you can use to set the required environment variables for Java.  FixPak 7 updates the scripts with new settings.  The scripts are stored in the main installation directory for DB2 OLAP Server. An explanation of the scripts is provided in the file essbaseenv.doc, which is also located in the main installation directory.  The following scripts are provided:

Starting in FixPak 7, DB2 OLAP Integration Server also requires Java, but not the same level used by DB2 OLAP Server.  Scripts are included with DB2 OLAP Integration Server that you can use to set the required environment variable for Java.  The scripts are in the  /is  subdirectory of the main installation directory.  The following scripts are provided: The scripts can be called directly by the .profile file.   The installation program backs up existing variable script files before installing the new ones.
 
See Setting up Java on UNIX for more information about setting variables.

Installing fixes for the Windows clients

Download one of the following files, depending on your language, to a temporary directory on the Windows computer on which you have installed the clients.  If you are installing from a CD, copy the file to the temporary directory.  If you have installed clients on other computers, you need to download the file to those computers, too.
Filename
Languages
Client Components
wincd1.zip Japanese
Korean
Simplified Chinese
Traditional Chinese 
Application Manager
Spreadsheet Add-in for Excel
Spreadsheet Add-in for 1-2-3
Integration Server desktop
OLAP Miner (English only)
wincd2.zip English
French
German
Italian
Spanish
Brazilian Portuguese
Application Manager 
Spreadsheet Add-in for Excel
Spreadsheet Add-in for 1-2-3
Integration Server desktop
OLAP Miner (English only)
wincd3.zip Danish
Finnish
Norwegian
Swedish
Czech
Hungarian
Russian
Application Manager 
Spreadsheet Add-in for Excel
Spreadsheet Add-in for 1-2-3
Integration Server desktop
OLAP Miner (English only)

To start the installation:

  1. Expand the executable file by typing the name of the file (without the extension) from a command prompt, or by double-clicking the file.
  2. Run SETUP.EXE to launch the installation program.  Follow the installation instructions in the OLAP Setup and User's Guide.
  3. On one of the installation prompts, you can choose to install the OLAP Miner documentation along with the client.  Installing the documentation is recommended.
  4. After the files are expanded, you can delete the zip file.
Starting in FixPak 4, DB2 OLAP Server requires Java on the server computer; starting in FixPak 7, DB2 OLAP Integration Server also requires Java.  To complete your installation, follow the steps in Setting Up Java on UNIX.

Installing on Windows

This FixPak for DB2 OLAP Server on Windows consists of one file that contains upgrades for the server and client components.  If you run your servers and clients on different computers, you can download the same file to each computer.

You can also install OLAP Miner in this FixPak.  OLAP Miner supports the following levels of Windows operating systems:

Installing fixes for the Windows server and clients

Download one of the following files, depending on your language, to a temporary directory on the Windows computer on which you have installed the server.  If you are installing from a CD, copy the file to the temporary directory.  If you have installed clients on other computers, you need to download the file to those computers, too.
Filename
Languages
Server Components
Client Components
wincd1.zip Japanese
Korean
Simplified Chinese
Traditional Chinese
OLAP Server 
OLAP Integration Server
SQL Interface
Application Programming Interface
OLAP Miner
Application Manager 
Spreadsheet Add-in for Excel
Spreadsheet Add-in for 1-2-3
Integration Server desktop 
OLAP Miner (English only)
wincd2.zip English
French
German
Italian
Spanish
Brazilian Portuguese
OLAP Server 
OLAP Integration Server
SQL Interface
Application Programming Interface
OLAP Miner
Application Manager 
Spreadsheet Add-in for Excel
Spreadsheet Add-in for 1-2-3
Integration Server desktop 
OLAP Miner (English only)
wincd3.zip Danish
Finnish
Norwegian
Swedish
Czech
Hungarian
Russian
OLAP Server 
OLAP Integration Server
SQL Interface
Application Programming Interface
OLAP Miner
Application Manager 
Spreadsheet Add-in for Excel
Spreadsheet Add-in for 1-2-3
Integration Server desktop 
OLAP Miner (English only)

Starting the installation

  1. Expand the executable file by typing the name of the file (without the extension) from a command prompt, or by double-clicking the file.
  2. Run SETUP.EXE to launch the installation program.  Follow the installation instructions in the OLAP Setup and User's Guide.
  3. On one of the installation prompts, you can choose to install the OLAP Miner documentation along with the server and client.  Installing the documentation is recommended.
  4. After the files are expanded, you can delete the zip file.
Starting in FixPak 4, DB2 OLAP Server requires Java on the server computer; starting in FixPak 7, DB2 OLAP Integration Server also requires Java.  To complete your installation, follow the steps in the next section, Setting Up Java on Windows.

Starting in FixPak 8, DB2 OLAP Server changes how the CLASSPATH variable is set.  See Setting Java environment variables on Windows for more information.


Setting up Java

This section describes how to enable DB2 OLAP Server and DB2 OLAP Integration Server to work with the JavaTMRuntime Environment (JRE) and the Java API for XML Parsing (JAXP).

Starting with FixPak 4, DB2 OLAP Server requires Java for custom-defined macros and custom-defined functions.  The Java Runtime Environment and the Java API for XML Parsing must be installed on computers running the server component.  This includes the Java Virtual Machine (JVM), which is a component of the JRE. If you have already installed a supported version of the Java Runtime Environment, you do not have to reinstall the JRE. However, you must verify that the JAXP component is installed, set the JVMMODULELOCATION parameter, and set environment variables.

Starting with FixPak 7, DB2 OLAP Integration Server also requires Java.

After the Java components are installed on your system, you can use a Java development kit (JDK) of your choosing to create your own custom-defined macros and custom-defined functions.  A JDK is not supplied with DB2 OLAP Server or DB2 OLAP Integration Server.

Setting up Java on UNIX

Starting with FixPak 4, DB2 OLAP Server requires Java for custom-defined macros and custom-defined functions.  The Java Runtime Environment and the Java API for XML Parsing must be installed on computers running the server component.  This includes the Java Virtual Machine (JVM), which is a component of the JRE.

Starting with FixPak 7, DB2 OLAP Integration Server also requires Java, but not the same level used by DB2 OLAP Server. The following table lists the levels of Java you need:
 
Product
Operating system
Java Runtime Environment level
DB2 OLAP Server AIX 1.2.2
Solaris 1.3.0
HP-UX 1.2.2
DB2 OLAP Integration Server AIX 1.3.0
Solaris 1.3.0_02
HP-UX 1.3.0.01

If you have already installed a supported version of the Java Runtime Environment, you do not have to reinstall the JRE. However, you must verify that the JAXP component is installed, set the JVMMODULELOCATION parameter, and set environment variables.

These are the major steps to enable Java to work with DB2 OLAP Server and DB2 OLAP Integration Server on UNIX:

  1. Install the Java Runtime Environment (JRE) and the Java API for XML Parsing (JAXP).
  2. Set the Java environment variables for DB2 OLAP Server.
  3. Set the JVMMODULELOCATION parameter to give DB2 OLAP Server access to JAXP.  This parameter is set in the essbase.cfg file so you can designate a specific installation of the Java Runtime Environment for use with DB2 OLAP Server. This setting is particularly useful if you have multiple versions of Java installed on the computer running the OLAP server component.
  4. Set advanced configuration options for Java, if necessary.
  5. If you use DB2 OLAP Integration Server (OIS), set the Java environment variables for it.
The Java Runtime Environment installation packages and installation procedures for each of the supported platforms are substantially different. Readme files and installation instructions from the JRE providers are included in .txt or .htm files with each package. Review these instructions carefully. You may need to refer to the web site of the JRE provider for additional information about installing the JRE.

This section also includes tips on finding out which shell you are using.

After following the instructions in this section, if you are still having difficulties getting DB2 OLAP Server to work with Java, it may be necessary to set start-up options for the Java Virtual Machine (JVM). You can make DB2 OLAP Server use specific JVM start-up options when it loads the JVM by setting the environment variables ESS_JVM_OPTION1 through ESS_JVM_OPTION9.

Installing Java on UNIX

These are the major steps you must following to install the Java Runtime Environment code, regardless of which UNIX operating system you use:
  1. Log in using an account that has root privileges.
  2. Copy the ARBORPATH/bin/jrte_<platform>_ess.tar file into the /tmp directory.
  3. Extract the Java package using tar xvf jrte_<platform>_ess.tar. On AIX, a .gz file is extracted from the jrte tar file, which can then be opened using gunzip on UNIX, or Winzip or PKZip on Windows to extract the .rte package to be installed below.
  4. If you use DB2 OLAP Integration Server:
    1. Copy the ISHOME/bin/jrte_<platform>_is.tar file into the /tmp directory.
    2. Extract the Java package using tar xvf jrte_<platform>_is.tar. On AIX, a .gz file is extracted from the jrte tar file, which can then be opened using gunzip on UNIX, or Winzip or PKZip on Windows.  For example, enter:

    3.   gzip -dv jre130.tar.gz
      which makes jre130-20010330.tar available.
  5. Install the extracted package as described in the following sections.
After following the instructions in this section, if you are still having difficulties getting DB2 OLAP Server to work with Java, it may be necessary to set start-up options for the Java Virtual Machine (JVM). You can make DB2 OLAP Server use specific JVM start-up options when it loads the JVM by setting the environment variables ESS_JVM_OPTION1 through ESS_JVM_OPTION9. For Solaris and HP-UX, you must set one of these options so that DB2 OLAP Server can work with the JVM.
Installing Java on AIX:
AIX requires that the following packages are installed prior to installing this package.  You must have root privileges to install these packages: For DB2 OLAP Server:  To install JRE, install the java_devX.rte fileset by using the installp command or SMIT.

For DB2 OLAP Integration Server:  Copy the file jre130-20010330.tar to ISHOME.  Then type:   tar xvf jre130-20010330.tar   to de-compress the JRE directory and its associated files.

The next step is to set the Java environment variables for your operating system.

Installing Java on Solaris:
Update the permissions on the .bin file:

 chmod +x jXrel_XXXXX-solsparc.bin

where XXXXX represents the specific version number.  Then run the self-extracting binary:

For DB2 OLAP Server, type:   jXrel_XXXXX-solsparc.bin

For DB2 OLAP Integration Server:  Copy the file jre130-20010330.tar to ISHOME.  Then type:   tar xvf jre130-20010330.tar   to de-compress the JRE directory and its associated files.

The next step is to set the Java environment variables for your operating system.

Installing Java on HP-UX:
For DB2 OLAP Server, run the following command:

 swinstall rte_XXXXX.depot

where XXXXX represents the specific version number.

For DB2 OLAP Integration Server:  Copy the file jre130-20010330.tar to ISHOME.  Then type:   tar xvf jre130-20010330.tar   to de-compress the JRE directory and its associated files.

The next step is to set the Java environment variables for your operating system.

Updating Java environment variables for DB2 OLAP Server on UNIX

On UNIX operating systems, you must update environment variables to enable DB2 OLAP Server to use the Java Runtime Environment. JREHOME represents the installation directory for the Java Runtime Environment.

After setting the environment variables below, log out of the system and back on to activate the new settings. Run the following command to verify that the correct version of Java is set before starting Essbase:

> java –fullversion
For DB2 OLAP Server, you will see this: Scripts are provided to set up the environment variables to match the correct level of JRE.  The following table shows which script to use with which product:
 
Product Shell Script
DB2 OLAP Server Korn or Bourne essjava.sh
DB2 OLAP Server CShell essjava.csh
Updating environment variables for DB2 OLAP Server on AIX
On AIX, you must update the LIBPATH setting to include the JREHOME/bin/ and the JREHOME/bin/classic/ directories. These LIBPATH directory entries must be added to the beginning of the LIBPATH environment variable.

Important: If you are using a DB2 instance ID, then you need to add the variables into the .profile BEFORE the DB2 instance profile is invoked.

If you use the C shell, add the following text to the .cshrc file:

setenv JREHOME "/usr/java_dev2/jre"
setenv LIBPATH "${JREHOME}/bin:${JREHOME}/bin/classic:${LIBPATH}"
setenv LD_LIBRARY_PATH "${JREHOME}/bin:${JREHOME}/bin/classic:${LD_LIBRARY_PATH}"
set path=( ${JREHOME}/sh /usr/java_dev2/sh $path )
setenv CLASSPATH "${ARBORPATH}/java/jaxp.jar:${ARBORPATH}/java/parser.jar:${CLASSPATH}"
Note that $JREHOME/bin must be added to the beginning of LIBPATH.

If you use the Bourne or Korn shell, add the following text to the .profile file:

export JREHOME=/usr/java_dev2/jre
export LIBPATH=$JREHOME/bin:$JREHOME/bin/classic:$LIBPATH
export LD_LIBRARY_PATH=$JREHOME/bin:$JREHOME/bin/classic:$LD_LIBRARY_PATH
export PATH=$JREHOME/sh:/usr/java_dev2/sh:$PATH
export CLASSPATH=$ARBORPATH/java/jaxp.jar:$ARBORPATH/java/parser.jar:$CLASSPATH
Note that $JREHOME/bin must be added to the beginning of LIBPATH.
Updating environment variables for DB2 OLAP Server for Solaris
On Solaris, you must set the ESS_JVM_OPTION option.

NOTE that JREHOME must be at the beginning of the PATH statement, before /usr/bin.

If you use the C shell, add the following text to the .cshrc file:

setenv ESS_JVM_OPTION1 "-XX:+AllowUserSignalHandlers"
setenv JREHOME "${ARBORPATH}/bin/j2re1_3_0"
set path=( ${JREHOME}/bin $path )
setenv CLASSPATH "${ARBORPATH}/java/jaxp.jar:${ARBORPATH}/java/parser.jar:${CLASSPATH}"
setenv LD_LIBRARY_PATH "${JREHOME}/bin:${LD_LIBRARY_PATH}"
If you use the Bourne or Korn shell, add the following text to the .profile file:
ESS_JVM_OPTION1=-XX:+AllowUserSignalHandlers
export ESS_JVM_OPTION1
JREHOME=$ARBORPATH/bin/j2re1_3_0
export JREHOME
PATH=$JREHOME/bin:$PATH
export PATH
export CLASSPATH=$ARBORPATH/java/jaxp.jar:$ARBORPATH/java/parser.jar:$CLASSPATH
export LD_LIBRARY_PATH=$JREHOME/bin:$LD_LIBRARY_PATH
Updating environment variables for DB2 OLAP Server on HP-UX
On HP-UX, you must update the SHLIB_PATH setting to include the JREHOME/lib/PA_RISC/ and the JREHOME/lib/PA_RISC/classic/ directories.

Note: The directory, PA_RISC, may be PA_RISC2.0, depending on the processor used by the computer running HP-UX.  In addition, due to a problem with the Just In Time compiler in release 1.2.2 of the JRE for HP-UX, you must also set an ESS_JVM_OPTION.

Note: Some of these environment variable settings are coded assuming the variables are already set on your HP-UX system, and they add new values to your existing settings.  HP-UX does not automatically create these variables if they do not exist.  If you receive an error message about environment variables not being set, you must manually create the variables.  See your HP-UX documentation for more information about setting environment variables.

If you use the C shell, add the following text to the .cshrc file:

setenv JREHOME "/opt/java1.2/jre"
setenv SHLIB_PATH "${JREHOME}/lib/PA_RISC:${JREHOME}/lib/PA_RISC/classic:${SHLIB_PATH}"
set path=( $path ${JREHOME}/bin  )
setenv ESS_JVM_OPTION1 "-Djava.compiler=NONE"
setenv CLASSPATH "${ARBORPATH}/java/jaxp.jar:${ARBORPATH}/java/parser.jar:${CLASSPATH}"
If you use the Bourne or Korn shell, add the following text to the .profile file:
JREHOME=/opt/java1.2/jre
export JREHOME
SHLIB_PATH=$JREHOME/lib/PA_RISC:$JREHOME/lib/PA_RISC/classic:$SHLIB_PATH;
export SHLIB_PATH
PATH=$PATH:$JREHOME/bin;
export PATH
ESS_JVM_OPTION1=-Djava.compiler=NONE;
export ESS_JVM_OPTION1
CLASSPATH=$CLASSPATH:$ARBORPATH/java/jaxp.jar:$ARBORPATH/java/parser.jar;
export CLASSPATH

Giving the OLAP server access to JAXP on UNIX

The Java API JAXP for XML parsing is required by DB2 OLAP Server to enable Java-based features such as custom-defined macros and custom-defined functions.  JAXP is installed on your system when you install the JRE.  In most situations, installation and configuration of the JRE for DB2 OLAP Server is complete.  However, if you have installed the JRE but your server cannot detect JAXP, make sure the following files have been copied to JREHOME/lib/ext:
/ARBORPATH/java/*.jar
Then set the JVMMODULELOCATION to enable Hyperion Essbase to find and load Java.  JVMMODULELOCATION is a setting in the essbase.cfg file that enables you to designate a specific installation of the Java Runtime Environment for use with DB2 OLAP Server. This setting is particularly useful if you have multiple versions of Java installed on the computer running the OLAP server component.  To set the JVMMODULELOCATION parameters, you must specify the full path and filename of the Java Virtual Machine (JVM) library. The location and name of this library varies, depending on the JRE version and the operating system you are using.  To set JVMMODULELOCATION:
  1. On the computer that runs the OLAP server, change to the ARBORPATH/bin directory.
  2. In the essbase.cfg file, add a new line to the end of the file and type the following text:
    1. JVMMODULELOCATION FullpathAndFilenameOfJvmLibraryFile
The following examples show how to set JVMMODULELOCATION on the UNIX systems supported by DB2 OLAP Server.  Do not include spaces in the path and filename. Do not enclose the parameter in quotation marks. A semicolon is not required at the end of the line.

On AIX (JRE 1.2.2): Make sure you enter this setting in mixed case, as follows:

JvmModuleLocation /usr/java_dev2/jre/bin/classic/libjvm.a
On Solaris (JRE 1.3): The path of the JVM library file is:
/usr/j2se/jre/lib/sparc/client/libjvm.so

CAUTION: On Solaris, do not set the JVMMODULELOCATION to point directly to the libjvm.so file, or the JVM will crash when DB2 OLAP Server attempts to load it. Set JVMMODULELOCATION to the symbolic link for this file. The default location for the symbolic link is:\

/olaptest/essbase7/bin/j2re1_3_0/lib/sparc/libjvm.so

where /olaptest/essbase7/bin/ is the ARBORPATH in this example.


On HP-UX (JRE 1.2): Make sure you enter this setting in mixed case, as follows:

JvmModuleLocation /opt/java1.2/jre/lib/PA_RISC/classic/libjvm.sl

The directory, PA_RISC, might be PA_RISC2.0, depending on the processor used by the computer running HP-UX.
 

Updating Java environment variables for OIS on UNIX

On UNIX operating systems, you must update environment variables to enable DB2 OLAP Integration Server to use the Java Runtime Environment. JREHOME represents the installation directory for the Java Runtime Environment.

After setting the environment variables below, log out of the system and back on to activate the new settings. Run the following command to verify that the correct version of Java is set before starting Essbase:

> java –fullversion
For DB2 OLAP Integration Server, you will see this: Scripts are provided to set up the environment variables to match the correct level of JRE.  The following table shows which script to use with which product:
 
Product Shell Script
DB2 OLAP Integration Server Korn or Bourne hisjava.sh
DB2 OLAP Integration Server CShell hisjava.csh
Updating environment variables for OIS on AIX
On AIX, you must update the LIBPATH setting to include the JREHOME/bin/ and the JREHOME/bin/classic/ directories. These LIBPATH directory entries must be added to the beginning of the LIBPATH environment variable.

Important: If you are using a DB2 instance ID, then you need to add the variables into the .profile BEFORE the DB2 instance profile is invoked.

If you use Bourne or Korn C shell, add the following additional variables from the hisjava.sh file:

export TEMP=/tmp
export JAVA_HOME=$ISHOME/jre
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=$JAVA_HOME/lib:$CLASSPATH
export LIBPATH=$JAVA_HOME/lib:$LIBPATH
If you use C shell, add the following additional variables from the hisjava.sh file:
setenv TEMP  " /tmp"
setenv JAVA_HOME "{ARBORPATH}/is"
setenv PATH "${JAVA_HOME}/bin:${PATH}"
setenv CLASSPATH "${JAVA_HOME}/lib:${CLASSPATH}"
setenv LIBPATH "${JAVA_HOME}/lib:${LIBPATH}"
Updating environment variables for OIS on Solaris
On Solaris, you must set the ESS_JVM_OPTION option.

NOTE that JREHOME must be at the beginning of the PATH statement, before /usr/bin.

If you use Bourne or Korn C shell, add the following additional variables from the hisjava.sh file:

export TEMP=/tmp
export JAVA_HOME $ARBORPATH/is/bin/j2re1_3_0_02
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=$JAVA_HOME/lib:$CLASSPATH
export LD_LIBRARY_PATH=$JAVA_HOME/lib:$LD_LIBRARY_PATH
If you use C shell, add the following additional variables from the hisjava.sh file:
setenv TEMP "/tmp"
setenv JAVA_HOME "${ARBORPATH}/is"
setenv PATH "${JAVA_HOME}/bin:${PATH}"
setenv CLASSPATH "${JAVA_HOME}/lib:${CLASSPATH}"
setenv LD_LIBRARY_PATH "${JAVA_HOME}/lib:${LD_LIBRARY_PATH}"
Updating environment variables for OIS on HP-UX
On HP-UX, you must update the SHLIB_PATH setting to include the JREHOME/lib/PA_RISC/ and the JREHOME/lib/PA_RISC/classic/ directories.

Note: The directory, PA_RISC, may be PA_RISC2.0, depending on the processor used by the computer running HP-UX.  In addition, due to a problem with the Just In Time compiler in release 1.2.2 of the JRE for HP-UX, you must also set an ESS_JVM_OPTION.

Note: Some of these environment variable settings are coded assuming the variables are already set on your HP-UX system, and they add new values to your existing settings.  HP-UX does not automatically create these variables if they do not exist.  If you receive an error message about environment variables not being set, you must manually create the variables.  See your HP-UX documentation for more information about setting environment variables.

If you use Bourne or Korn C shell, add the following additional variables from the hisjava.sh file:

export TEMP =/tmp
export JAVA_HOME=/opt/java1.3/jre
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=$JAVA_HOME/lib:$CLASSPATH
export SHLIB_PATH=$JAVA_HOME/lib$SHLIB_PATH
If you use C shell, add the following additional variables from the hisjava.sh file:
setenv TEMP  " /tmp"
setenv JAVA_HOME "${ARBORPATH}/is"
setenv PATH "${JAVA_HOME}/bin:${PATH}"
setenv CLASSPATH "${JAVA_HOME}/lib:${CLASSPATH}"
setenv SHLIB_PATH "${JAVA_HOME}/lib:${ISHOME}/esslib:${ISHOME}/islib;${SHLIB_PATH}"

Finding which shell you are using

To find out which shell is currently running on your UNIX system, you can run this command:

> echo $SHELL

Which gives this result:

/usr/bin/ksh

This indicates you're using the Korn Shell.  Here is a list of other responses you might get:

/usr/bin/sh  Bourne Shell
/usr/bin/rsh  Restricted Bourne Shell
/usr/bin/jsh  Bourne Shell, with job control
/usr/bin/ksh  Korn Shell
/usr/bin/rksh Restricted Korn Shell
/usr/bin/csh  C Shell

Another way is to examine the file called etc/passwd, which you can see by running the cat command, as follows:

cat /etc/passwd
 


Setting up Java on Windows

On Windows, both DB2 OLAP Server and DB2 OLAP Integration Server require JRE 1.3.  To enable Java to work with DB2 OLAP Server and DB2 OLAP Integration Server, take the following steps:
  1. Set up environment variables for the Java Runtime Environment (JRE).
  2. Set the JVMMODULELOCATION parameter in the essbase.cfg file so you can designate a specific installation of the Java Runtime Environment for use with DB2 OLAP Server . This setting is particularly useful if you have multiple versions of Java installed on the computer running the OLAP server component.
After the Java components are installed on your system, you can use a Java development kit (JDK) of your choosing to create your own custom-defined macros and custom-defined functions.  A JDK is not supplied with DB2 OLAP Server or DB2 OLAP Integration Server.

Setting Java environment variables on Windows

The Java Runtime Environment (JRE) is required by DB2 OLAP Server to enable Java-based features, such as custom-defined macros and custom-defined functions. The JRE must be installed on the computer running the OLAP server component.

The DB2 OLAP Server installation program copies the Java files to your workstation.  However, to avoid interfering with any existing Java environments you might have on that workstation, the installation program does not set up the environment variables that DB2 OLAP Server needs to access the Java files.  To complete the installation of Java, make sure the following environment variables are set up on Window NT and Windows 2000:

    JREHOME=%ARBORPATH%\java\jre
    CLASSPATH=%ARBORPATH%\is\jar\jaxp.jar;
            %ARBORPATH%\is\jar\parser.jar;%CLASSPATH%

Please note that, starting in FixPak 8, DB2 OLAP Server changes how the CLASSPATH variable is set.

On Windows 2000, make sure this variable is in your PATH statement:

%JREHOME%\bin

For example, you can set your PATH to the following value:

PATH=%JREHOME%\bin;%PATH%

On Windows NT, make sure this variable is in your PATH statement:
C:\Program Files\IBM\DB2 OLAP Server\java\jre\bin

For example, you can set your PATH to the following value:

PATH= C:\Program Files\IBM\DB2 OLAP Server\java\jre\bin;%PATH%

If you have already installed a supported version of the Java Runtime Environment, you do not have to reinstall the JRE. However, you must verify that the JAXP component is installed and set the JVMMODULELOCATION parameter to enable DB2 OLAP Server to find and load Java.

Setting JVMMODULELOCATION on Windows

JVMMODULELOCATION is a setting in the essbase.cfg file that enables you to designate a specific installation of the Java Runtime Environment for use with DB2 OLAP Server . This setting is particularly useful if you have multiple versions of Java installed on the computer running the OLAP server component.
 
To set the JVMMODULELOCATION parameters, you must specify the full path and filename of the Java Virtual Machine (JVM) library. On Windows systems (JRE 1.3), the default location and the name of the JVM Library File is:
c:\Program Files\IBM\DB2 OLAP Server\java\jre\bin\hotspot\jvm.dll
where c:\Program Files\IBM\DB2 OLAP Server\  is %ARBORPATH% in this example.

To set JVMMODULELOCATION:

  1. On the computer that runs the OLAP server component, change to the ARBORPATH\bin directory.
  2. Locate the essbase.cfg file in this directory and open the file in a text editor. If the file does not exist, create and open a new text file named essbase.cfg .
  3. In the essbase.cfg file, add a new line to the end of the file and type JVMMODULELOCATION followed by the full path and file name of the JVM library file.  For example:
  4. JVMMODULELOCATION c:\Program Files\IBM\DB2 OLAP Server\java\jre\bin\hotspot\jvm.dll
  5. Save the changed text file as essbase.cfg .
  6. Close the file and exit the text editor.

Additional setup instructions for OLAP Integration Server

This section contains the following topics:

ODBC requirements

DB2 OLAP Integration Server requires an ODBC.ini file for operation of Open Database Connectivity (ODBC) connections from OLAP Integration Server to the relational data source and to the OLAP Metadata Catalog.

On Windows systems, this file is in the Registry under HKEY_LOCAL_MACHINE/SOFTWARE/ODBC. Use ODBC Data Source Administrator to store information about how to connect to a relational data source.

On UNIX systems, DB2 OLAP Integration Server installation creates a model odbc.ini file. To store information about how to connect to a relational data source, edit the file using your preferred editor.

The ODBC.ini file is available in ODBC software packages and is included with Microsoft Office software. For more information about applications that install ODBC drivers or the ODBC Administrator, visit the following web site:

http://support.microsoft.com/directory/default.asp

For Windows NT or Windows 2000 users:  you must upgrade to Version 3.6 if you have not already done so.

For Oracle users on AIX and HP-UX computers: To configure ODBC for Oracle, you must update the ODBC.ini file to point to the MERANT 3.6 drivers.

Operating system requirements:

With Fixpak 2, DB2 OLAP Integration Server manages ODBC connections to the relational data source and to the OLAP Metadata Catalog.  To accommodate these ODBC connections, DB2 OLAP Integration Server software uses ODBC drivers on Windows NT 4.0, Windows 2000, AIX, HP-UX, and Solaris.

Supported ODBC drivers matrix:

The following table lists ODBC drivers that are supported by DB2 OLAP Integration Server, sorted by database and operating system:.
 
Database Server 
(Client)
AIX 4.3.3
HP-UX 11.0 (1)
Solaris 2.6, 2.7, 2.8 (Sun OS 5.6, 5.7, 5.8)
Windows
NT 4.0 , 2000
DB2 UDB 6.1


(DB2 UDB 6.1)

DB2 6.1 ODBC
DB2 6.1 ODBC
DB2 6.1 ODBC
DB2 6.1 ODBC 
DB2 UDB 7.1


(DB2 UDB 7.1)

DB2 7.1 ODBC
DB2 7.1 ODBC
DB2 7.1 ODBC
DB2 7.1 ODBC 
Informix 9. 2


(Connect 2.4)

Not currently supported
MERANT 3.6
MERANT 3.6
MERANT 3.6 (2)
MS SQL Server 6.5.201


(no client required)

Not currently supported
Not currently supported
Not currently supported
MS SQL Server 3.
6 ODBC (included in MDAC 2.5) (3)
MS SQL Server 7.0 


(no client required)

Not currently supported
Not currently supported
Not currently supported
MS SQL Server 3.6 ODBC (included in MDAC 2.5) (3)
MS SQL Server 2000 (no client required)
Not currently supported
Not currently supported
Not currently supported
MS SQL Server 3.6 ODBC (included in MDAC 2.5) (3)
Oracle 8.04


(SQL*Net 8.0)

MERANT 3.6
MERANT 3.6
MERANT 3.6
MERANT 3.6 (2)
Oracle 8i


(SQL*Net 8.0)

MERANT 3.6
MERANT 3.6
MERANT 3.6
MERANT 3.6 (2)
Sybase 12


(UNIX: Open Client 11.1, Windows: No client required)

Not currently supported
Not currently supported
MERANT 3.6
MERANT 3.6 (2)
  1. MERANT 3.6 ODBC drivers are supported only on HP-UX 11.0 computers using 32-bit relational database client software.
  2. If you are using MERANT 3.6 ODBC drivers with Informix, Oracle, or Sybase, you must have Microsoft Data Access Components 2.5 (MDAC) installed. The MDAC installation file, installed when you install ODBC drivers, is located in    ishome\odbc\merant36\mdac on Windows and $ISHOME/odbc/merant36/mdac on UNIX..
  3. The Microsoft Data Access Components 2.5 (MDAC) installation file, installed when you install ODBC drivers, is located in:   ishome\odbc\merant36\mdac on Windows.
ODBC drivers used with DB2 OLAP Integration Server must be thread-safe. All drivers in the matrix are thread-safe. HP-UX requires kernel-threads, Solaris requires Solaris threads, and AIX requires kernel-threads with pthread API.
 

JDBC Requirements

DB2 OLAP Integration Server requires JDBC drivers to support the XML Import/Export function.

Configuration tips

This supplements the OLAP Setup and User's Guide for DB2 OLAP Integration Server 7.1.

Configuring data sources on UNIX systems

On AIX, HP-UX and Solaris, you must manually set environment variables for ODBC and edit the odbc.ini file to configure the relational data source and OLAP Metadata Catalog.  Note: Edit the odbc.ini file if you add a new driver or data source or if you change the driver or data source.
Configuring ODBC environment variables
On UNIX systems, you must set environment variables to enable access to ODBC core components. The hisjava.sh and
hisjava.csh shell scripts that set the required variables are provided in the DB2 OLAP Integration Server home directory. You must run one of these scripts before using ODBC to connect to data sources. You should include these scripts in the login script for the user name you use to run OLAP Integration Server.
Editing the odbc.ini file
To configure a data source in an odbc.ini file, you must add a name and description for the ODBC data source and provide the ODBC driver path, file name, and other driver settings in a separate section that you create for the data source name. The DB2 OLAP Integration Server installation program installs a sample odbc.ini file in the ISHOME directory. The file contains generic ODBC connection and configuration information for supported ODBC drivers. Use the file as a starting point to map the ODBC drivers that you use to the relational data source and OLAP Metadata Catalog.

Note: If you use a different file than the odbc.ini file, be sure to set the ODBCINI environment variable to the name of the file you use.

To add a data source to an odbc.ini file:
  1. On the computer running OLAP Integration Server, open the odbc.ini file by using a text editor such as vi.
  2. Find the section starting with [ODBC Data Sources] and add a new line with the data source name and description; for example:  mydata=data source for analysis.  To minimize confusion, the name of the data source should match the name of the database in the RDBMS.
  3. Add a new section to the file by creating a new line with the name of the new data source enclosed in brackets; for example:   [mydata]
  4. On the lines following the data source name, add the full path and file name for the ODBC driver required for this data source and any other required ODBC driver information. Use the examples shown in the following sections as a guideline to map to the data source on your RDBMS.  Note: Make sure that the ODBC driver file actually exists in the location you specify for the Driver= setting.
  5. When you have finished editing odbc.ini, save the file and exit the text editor. For more information about the odbc.ini file and the ODBC driver settings for each RDBMS, see the MERANT DataDirect Connect ODBC Reference in PDF format and the related Readme files in the ODBCDocs directory. For more information about native ODBC driver settings, refer to the installation documentation for your RDBMS native ODBC drivers.
Example of ODBC Settings for DB2
Following is an example of how you might edit odbc.ini to connect to a relational data source, db2data, on DB2 Version 6.1 (on AIX), using an IBM DB2 native ODBC driver.

Use the vi $ODBCINI command to edit the odbc.ini file and insert the following statements:

[ODBC Data Sources]
db2data=DB2 Source Data on AIX
...
[db2data]
Driver=/home/db2inst1/sqllib/lib/db2.o
Description=DB2 Data Source - AIX, native
Example of ODBC Settings for Oracle
Here is an example of how you might edit odbc.ini to connect to a relational data source, oradata, on Oracle Version 8 (on Solaris), using a MERANT Version 3.6 ODBC driver.  Note: LogonID and Password in this example are overridden with the actual values used in the Hyperion Integration Server user name and password.
[ODBC Data Sources]
oradata=Oracle8 Source Data on Solaris
...
[myoracle] Driver=
/export/home/users/dkendric/is200/odbclib/ARor815.so
Description=my oracle source
Note: ServerName=mytnsServerName must refer to the name of an Oracle database defined in the tnsnames.ora file. For more information, see the Oracle installation documentation.

Tip: Run ivtestlib to verify that the environment is set to run the correct odbc driver file. For example, run ivtestlib and paste the path and file name that follow Driver= in the odbc.ini file that you have edited.

Configuring the OLAP metadata catalog on UNIX Systems

Configuring an OLAP Metadata Catalog on AIX, HP-UX, and Solaris is similar to configuring a data source. For the OLAP Metadata Catalog database, add a data source name and section to the odbc.ini file. No other changes are required.

You must create an OLAP Metadata Catalog database in a supported RDBMS before configuring it as an ODBC data source.

Here is an example how you might edit odbc.ini to connect to the OLAP Metadata Catalog, TBC_MD, on DB2 Version 6.1 (on Solaris), using a native ODBC driver:

[ODBC Data Sources]
ocd6a5a=db2 v6
...
[ocd6a5a]
Driver=/home/db2instl/sqllib/lib/db2.0
Description=db2
Using ODBC drivers coded in Unicode on Solaris:
On Solaris, the OLAP Integration Server (OIS) Desktop does not support ODBC drivers coded in Unicode.  If you use a Unicode ODBC driver, you might experience problems connecting to the server component.  To enable the connection, update your odbc.ini file and specify a non-Unicode driver, such as libdb2_36.so, under the $ISHOME/odbclib directory.  For example:
[ODBC Data Sources]
TBC_MD=IBM DB2 ODBC DRIVER
TBC=IBM DB2 ODBC DRIVER

[TBC_MD]
Driver=/export/home/arbor7fp/sqllib/lib/libdb2_36.so
Description=Sample DB2 ODBC Database

[TBC]
Driver=/export/home/arbor7fp/sqllib/lib/libdb2_36.so
Description=Sample DB2 ODBC Database

[ODBC]
Trace=0
TraceFile=odbctrace.out
InstallDir=/export/home/arbor7fp/sqllib/lib

Configuring data sources on Windows systems

To configure a relational data source on Windows NT or Windows 2000 systems, you must start ODBC Administrator and then create a connection to the data source that you will use for creating OLAP models and metaoutlines. Run the ODBC Administrator utility from the Windows Control Panel. Note: This example creates a DB2 data source. The dialog boxes for other RDBMSs will differ.

To configure a relational data source with ODBC Administrator, complete the following steps:

  1. On the Windows desktop, select Start > Settings > Control Panel to open the Control Panel window.
  2. In the Control Panel window, perform one of the following steps:
  3. In the ODBC Data Source Administrator dialog box, click the System DSN tab.
  4. Click Add to open the Create New Data Source dialog box.
  5. In the driver list box of the Create New Data Source dialog box of ODBC Administrator, select an appropriate driver-for example, IBM DB2 ODBC Driver-and click Finish to open the ODBC IBMDB2 Driver - Add dialog box.
  6. In the ODBC IBM DB2 Driver - Add dialog box Database alias drop-down list, select the name of the database for your relational source data (for example, TBC in the sample application). The name of the selected database is automatically displayed in the Data Source Name text box.
  7. If you want to change the name of the data source, select the name displayed in the Data Source Name text box, press Enter, and type the name you want to use for the data source.
  8. In the Description text box, type an optional description that indicates how you use this driver and click Add. For example, type the following words to describe the My Business database:Customers, products, markets You might type the following words to describe the sample application database: Sample relational data source The descriptions help to identify the available data sources for your selection when you connect from Hyperion Integration Server Desktop.
  9. Click OK to return to the ODBC Data Source Administrator dialog box. The data source name you entered and the driver you mapped to it are displayed in the System Data Sources list box on the System DSN tab.
To edit configuration information for a data source:
  1. Select the data source name and click Configure to open the ODBC IBM DB2 - Add dialog box.
  2. Correct any information you want to change.
  3. Click OK twice to exit.

Configuring the OLAP metadata catalog on Windows systems

To configure an OLAP Metadata Catalog on Windows NT or Windows 2000, start ODBC Administrator and then create a connection to the data source that contains the OLAP Metadata Catalog database.

Note: This example creates a DB2 data source. Dialog boxes for other RDBMSs will differ.

To create a data source for the OLAP Metadata Catalog, complete the following steps:

  1. On the desktop, select Start > Settings > Control Panel to open the Control Panel window.
  2. In the Control Panel window, perform one of the following steps:
  3. In the ODBC Data Source Administrator dialog box, click the System DSN tab.
  4. Click Add to open the Create New Data Source dialog box.
  5. In the Create New Data Source dialog box of ODBC Administrator, select an appropriate driver-for example, IBM DB2 Driver-in the list box, and click Finish to open the ODBC IBM DB2 Driver - Add dialog box.
  6. In the Database alias drop-down list, select the name of the database for your OLAP Metadata Catalog  (for example, TBC_MD in the sample application).  The name of the selected database is automatically displayed in the Data Source Name text box.
  7. If you want to change the name of the data source, select the name displayed in the Data Source Name text box, type a new name to indicate how you use this driver, and click Add.  For example, you might type the following name to indicate that you are using the driver to connect to the first OLAP Metadata Catalog:  OLAP Catalog #1   You would type the following name to indicate that you are connecting to the sample application OLAP Metadata Catalog database: TBC_MD

  8.  
  9. In the Description text box, enter a description that indicates how you use this driver. For example, you might type the following words to describe the OLAP Metadata Catalog: My first models and metaoutlines.  You might type the following words to describe the sample application OLAP Metadata Catalog database: Sample models and metaoutlines.  The descriptions help you to identify the catalog that you want to select when you connect to the OLAP Metadata Catalog from Hyperion Integration Server Desktop.

  10.  
  11. Click OK to return to the ODBC Data Source Administrator dialog box. The data source name you entered and the driver you mapped to it are displayed in the System Data Sources list box on the System DSN tab.
To edit configuration information for a data source:

1. Click Configure to open the ODBC IBM DB2 - Add dialog box.
2. Correct any information you want to change.
3. Click OK twice to exit.

After you configure a data source

After you configure the relational data source and OLAP Metadata Catalog, you can connect to them from DB2 OLAP Server. You can then create, modify, and save OLAP models and metaoutlines.

Note: The SQL Server ODBC driver may time out during a call to an SQL Server database. Try again when the database is not busy. Increasing the driver time-out period may avoid this problem. For more information, see the ODBC documentation for the driver you are using.

For more information on ODBC connection problems and solutions, see the DB2 OLAP Integration Server OLAP System Administrator’s Guide.

Migrating to OLAP Integration Server 7.1

If you are migrating to IBM DB2 OLAP Integration Server 7.1, FixPak 2 or higher, from an earlier release of the Hyperion Solutions product Hyperion Integration Server, you should assess several system environment and data migration issues before installing the new software.

Read the following topics carefully to assess migration issues that may affect your OLAP Integration Server installation. Note that the following tasks cannot be completed until after you have installed OLAP Integration Server:

Preserving and existing ODBC driver
Starting with Fixpak 2, OLAP Integration Server 7.1 has a new architecture that concentrates ODBC driver configuration solely on the computer that runs the server component of OLAP Integration Server. With this new architecture, you do not have to configure ODBC drivers for client computers that run OLAP Integration Server Desktop or worry about upgrading ODBC drivers on clients.

If you use the INTERSOLV (now MERANT) Version 3.10 or Version 3.11 ODBC drivers supplied with previous versions of Hyperion Integration Server, you might want to preserve the older drivers for compatibility with the other applications. In general, however, you should upgrade the ODBC drivers to the versions provided with the latest release of OLAP Integration Server.

DB2 OLAP Integration Server 7.1 Fixpak 2 and later supports MERANT Version 3.6 ODBC drivers; it does not operate with MERANT Version 3.10 or Version 3.11 ODBC drivers.

Install the new MERANT Version 3.6 ODBC drivers and preserve the older drivers by installing OLAP Integration Server to a new location. Be sure that you do not update the ODBC register settings when prompted to do so by the installation program. You can continue to use the previous ODBC definitions.

Choosing an installation directory
If you are upgrading to DB2 OLAP Integration Server from Hyperion Integration Server, you should install the software to the same directory as the Hyperion product to take advantage of the previous environment settings. However, if you want to preserve older ODBC driver settings for other applications, you should install Hyperion Integration Server to a different directory.
Verifying path variable settings
If you are upgrading to the current release of OLAP Integration Server from an earlier release of Hyperion Integration Server, allow the setup program to update the environment variables for you. After installation is complete, however, you should check that the path variables are set properly for the system configuration:
Operating System Path Variable Settings (1)
Windows NT or 
Windows 2000 (2)
PATH=CURRENT_PATH;%ISHOME%\Bin;
             %ISHOME%\odbc\merant36\lib
AIX (3) LIBPATH=$LIBPATH:$ISHOME/odbc/merant36/lib:$ISHOME/esslib
PATH=$PATH:$ISHOME/bin
HP-UX (3) SHLIB_PATH  $SHLIB_PATH:$ISHOME/odbc/merant36/lib:$ISHOME/esslib
PATH=$PATH:$ISHOME/bin
Solaris (3)  LD_LIBRARY_PATH=
  $LD_LIBRARY_PATH:$ISHOME/odbc/merant36/lib:$ISHOME/esslib
PATH=$PATH:$ISHOME/bin

Table Notes:

  1. %ISHOME% represents the main installation directory of OLAP Integration Server on Windows systems. $ISHOME represents the main installation directory of OLAP Integration Server on UNIX systems.
  2. For Windows systems, check to make sure that the setup program did not add duplicate path entries for the OLAP Integration Server directories.
  3. If you are using MERANT (formerly INTERSOLV) ODBC drivers, place the MERANT library at the beginning of the library path; for example:   LIBPATH=$ISHOME/odbc/merant36/lib: $LIBPATH:$ISHOME/esslib

Migrating existing OLAP metadata catalogs

If you have an existing OLAP Metadata Catalog from Hyperion Integration Server product, you must upgrade it before using the OLAP Metadata Catalog with the current release of the software.

You cannot upgrade an existing OLAP Metadata Catalog until after you have completed the installation process.  The Hyperion Integration Server setup program installs the scripts that you need for the upgrade.

CAUTION:  If you have installed the sample application from Hyperion Integration Server, you should back up your existing sample database, OLAP Metadata Catalog, and the OLAP models and metaoutlines stored in the catalog. You can then upgrade your existing catalog to be compatible with the current release of the software. You cannot, however, store new sample OLAP models and metaoutlines in your previous catalog.

To upgrade an existing OLAP Metadata Catalog, perform the following tasks:

Upgrading the OLAP metadata catalog
If you have OLAP Metadata Catalogs from a earlier releases of Hyperion Integration Server, you need to upgrade the OLAP Metadata Catalogs before you can use them with this FixPak.

Upgrade the tables of an OLAP Metadata Catalog with the same utility program you normally use to create tables running SQL scripts. The SQL scripts to upgrade tables for the OLAP Metadata Catalog are in the ocscript directory where you installed OLAP Integration Server. The upgrade scripts are named ocdatabase_name_upgrd20.sql and are listed the following table, along with the utility programs with which they have been tested.
 
Database DBMS SQL Script  Utility Program
DB2 ocdb2.sql
ocdrop_db2.sql
ocdb2_upgrd20.sql
DB2 Command Center, or:
>DB2 -tvf
Oracle ocoracle.sql
ocdrop_oracle.sql
ocoracle_upgrd20.sql
SQL*Plus
MS SQL Server ocsqlsrv.sql
ocdrop_sqlsrv.sql
ocsqlsrv_upgrd20.sql
ISQL (MS SQL Server 6.5) 
Query Analyzer (MS SQL Server 7.0)

To upgrade tables for the OLAP Metadata Catalog database, perform the following tasks:

  1. Start the utility program.
  2. Connect to the database you created for the OLAP Metadata Catalog as the user who created the original OLAP Metadata Catalog tables.
  3. Open the appropriate SQL script file in the ocscript directory.
  4. Run the SQL script to upgrade the tables. On SQL Server, you receive a message that you did not create data or rows. This message is normal because you created only tables and columns.
  5. Verify that you have created the additional OLAP Metadata Catalog tables.  For example, type the following command:     SELECT * FROM OM_DESCRIPTION      or start the RDBMS and verify that the OLAP Metadata Catalog has the new tables.
  6. Close the utility program.
 
The OLAP Metadata Catalog Setup dialog box is displayed at the initial logon to Essbase Integration Services Console. You can use this dialog box to upgrade an existing OLAP Metadata Catalog automatically.
After you have updated an OLAP Metadata Catalog, you cannot roll back to the previous release. The new release of OLAP Metadata Catalog is not compatible with previous releases of Essbase Integration Services. In addition, do not attempt to use the FixPak 7 catalog with previous levels of DB2 OLAP Integration Server software. Doing so could result in corrupted OLAP Metadata Catalog data.

Connecting OIS to Oracle on Solaris

On Solaris, if you try to connect the OIS server to Oracle data, but the ODBC driver does not load successfully, you might get an error message about the server not being able to find a file called libclntch.so.  If you receive this message, search for the file on your system and add its path to the $LD_LIBRARY_PATH variable.

To test whether the ODBC driver loaded successfully, run the $ISHOME/bin/ivtestlib command followed by the path to the ODBC driver.

Additional setup instructions for Excel XP

Starting in FixPak 7, DB2 OLAP Server supports Excel XP.  If you use Microsoft Excel XP, make sure you have completed the following step to enable Excel XP for OLAP analysis:
  1. In Excel XP, Select the Tools menu.
  2. Click Add-Ins.
  3. Click the Browse button.
  4. In the Look-in field, select the essexcln.xll file and save your selection.
These steps add Hyperion Essbase Server to the Add-in panel in Excel XP.


Changes in this FixPak

FixPak 9 fixes the problems listed in the Problem Summary.

FixPak 8 added the following new upgrades in DB2 OLAP Server:

Application and database migration across OLAP Servers
You can migrate applications and databases from one server to another, regardless of platform. When you migrate, you can also migrate user/group security, including filter associations.
User and group migration across OLAP Servers
You can migrate DB2 OLAP Server users and groups from one server to another, regardless of platform. You can migrate individual users and groups, or you can migrate multiple users or multiple groups at one time.
Password propagation
You can change a password and then propagate that password to other OLAP Servers.
Single sign-on to DB2 OLAP Server enterprise environment
When you log in to Administration Services, the Administration Server handles your connections to OLAP Servers, applications, and databases.
Log analysis
Using Log Analyzer, you can filter, search, and analyze OLAP Server logs and application logs.
New MaxL Script Editor
A new MaxL Script Editor is integrated with the Administration Services Console. From this editor, you can create, edit, save, and execute MaxL statements and scripts. You can also use the editor to type and execute MaxL statements interactively, or to perform one DB2 OLAP Server operation at a time. Results from MaxL statements are displayed within the editor.
Background processing
You can execute calculations in the background while performing other tasks. You can also exit the console while the process continues to run. A message panel in the console window notifies you when the process has completed.
Multiple platform support
Both the middle tier Administration Server and the client console are Java products that run on multiple platforms. You can now manage DB2 OLAP Server with a user interface that runs on any platform supported by DB2 OLAP Server.
Printing DB2 OLAP Server information
You can print the contents of many windows in the console. For example, you can print the contents of the Database Properties window or the Log Analyzer window.
Graphical view of DB2 OLAP Server
You can use the Graphical Enterprise view in the console to operate directly on DB2 OLAP Server objects and to create custom views of the DB2 OLAP Server environment.
Parallel data load
DB2 OLAP Server now supports parallel data loading. You can specify the number of data processing threads to be used in parallel in different stages of data load processing. Allocating processing threads across processors on multiple CPUs provides the performance advantages of true parallel operation.
Limits on query duration and time
When users create and execute a report or spreadsheet add-in query, they may unintentionally create a very large query. Some large queries may require too much time to execute or may access too many blocks to run efficiently.

To help administrators, DB2 OLAP Server now provides these new features: This new ability is available using new essbase.cfgfile settings.
New control of agent-server threads and user logins
Two new configuration settings provide more control over agent activity:
Use these settings to match resources to load patterns:
Log delimiters
If you need to use external reporting tools or import log data into an OLAP database, DB2 OLAP Server now provides the ability to specify a delimiter between fields in DB2 OLAP Server log files:
New calculation functions
DB2 OLAP Server provides three new calculation functions in this release:
See the Technical Reference in the docs directory of your DB2 OLAP Server installation for details.
New API functions
DB2 OLAP Server FixPak 8 has two new API functions. One is a list of native and custom-defined calculation functions, and the other is a new function to create a filter.
External authentication
DB2 OLAP Server now supports external authentication of users against a non-DB2 OLAP server. For this release, DB2 OLAP Server installs a protocol that can authenticate users for an LDAP V3 server.

To enable external authentication, administrators use this procedure:
  1. Set the AUTHENTICATIONMODULE configuration setting in the server and client configuration file essbase.cfg.
  2. Restart OLAP Server.
  3. Create the user in DB2 OLAP Server with a reference to the LDAP protocol by using either Application Manager or DB2 OLAP Server Administration Services.
For instructions about how to set the configuration parameter, see the Technical Reference in the docs directory of your DB2 OLAP Server installation.
Export/Import LROs
The ability to export and re-import linked reporting object (LRO) information from a database has been added to improve backup capabilities and calculation performance.

You can use export LRO and import LRO (MaxL) to perform these tasks:
Export of databases larger than 2 GB
Some file management systems do not support ASCII files larger than 2 GB. To avoid exceeding this limit, if DB2 OLAP Server anticipates that an export file will be larger than 2 GB, it breaks the file into two or more export files, as needed. Use the ESSCMD commands, EXPORT and PAREXPORT, and the MaxL statement, export to export databases. This new feature works the same on all operating systems.
New CALCMODE configuration setting
You can now set CALCMODE to BLOCK or BOTTOMUP by 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 of your DB2 OLAP Server installation.
Improved functionality
This FixPak provides these improvements to existing functionality:
Improved handling of sessions and requests
System administrators can log out all users of a particular application or database, or log out instances of particular users from a selected scope: an application, a database, or the entire OLAP server system. If a user request is active when the administrator tries to log off the user, the administrator can force the user off. Using force safely terminates the request, and then logs the user off.

Additionally, administrators may terminate specific requests that have become problematic. For example, if a user loses the connection to the OLAP Server during a request (for example, a calculation), the abandoned request may cause the application to stop responding to subsequent requests.
Each user session has a unique ID number, which can be displayed and used by the administrator to terminate the current request associated with that session. When the administrator terminates a request, the user session remains active. The improved handling of sessions and requests can be found in any of these areas: The improved handling of sessions and requests is also available to API programmers, who can incorporate the following request management functions:
Multiple DB2 OLAP Server agents on a single server computer
Three new settings in the DB2 OLAP Server configuration file enable a single computer to run multiple DB2 OLAP Server agents at the same time. These settings provide two important improvements:
The new configuration settings are: AGENTPORT, SERVERPORTBEGIN, SERVERPORTEND, and PORTINC.
Case sensitivity improvement
Previous releases of DB2 OLAP Server automatically changed the case of application and database names when they were created: the first letter was converted to uppercase, and other letters were all lowercase. With this release, DB2 OLAP Server creates the database name exactly as it is entered. Some backward compatibility with previous clients is provided:
Some error messages have been rewritten to provide clarity. With this release, behavior on NT and UNIX platforms is identical.
Improved add-in support of of Excel in browsers
DB2 OLAP Serverr supports the ability access the Spreadsheet Add-in features when Microsoft Excel is invoked from Internet Explorer. If you drill down in an Excel spreadsheet accessed using Internet Explorer, Excel refreshes the browser and displays the requested data automatically. Users need not perform any additional steps to refresh the browser view.
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.
New dimensions sparse by default
When you add a dimension to an existing outline, DB2 OLAP Server makes it a sparse dimension. Prior to FixPak 8, DB2 OLAP Server made new dimensions dense by default.
Custom defined functions and macros
Several changes have been made to custom-defined functions (CDF) and custom-defined macros (CDM):
Attribute association memory use
DB2 OLAP Server has improved memory management for processing attributes requiring less memory. This improvement is most noticeable for applications using many attributes.
Buffered I/O default
FixPak 8 and later includes buffered I/O as the default. If you want to use direct I/O, as was the default for earlier service levels (Essbase Release 6.0 and 6.1), you can use the configuration setting DIRECTIO TRUE.Because buffered I/O may affect some DB2 OLAP Server caches, you may need to adjust cache size as well as change the DIRECTIO configuration setting.
Clients not available for Windows 95
Clients such as Application Manager and the Spreadsheet Add-in are not available for Windows 95.
The following changes are specific to Release 6.2 of Hyperion Essbase Integration Services:
New Client Console with Dynamic Intelligent Help Window
DB2 OLAP Integration Server introduces the new Essbase Integration Services Console and companion Intelligent Help window. The new dockable Intelligent Help window contains dynamic links to key program functions to automate the major operations necessary for moving data from a relational database to online analytical processing (OLAP). This convenient new feature provides the following enhanced installation and client component functionality:
OLAP Metadata Catalog and Sample Application Creation
When you first start DB2 OLAP Integration Server Console after installing DB2 OLAP Integration Server, the system displays a new OLAP Metadata Catalog Setup dialog box. For first-time installations, you can click a button in this dialog box to create the OLAP Metadata Catalog. For existing users, if the system detects a previous version of the catalog, your existing catalog is updated to the current version. With FixPak 8 and later, no other migration procedures are required, other than to update your existing OLAP Metadata Catalog. You must have an open database connectivity (ODBC) connection defined for the OLAP metadata catalog before you begin the automatic catalog creation process.

To create the OLAP Metadata Catalog, you first enter the DB2 OLAP Integration Server name and then enter the ODBC Data Source Name (DSN) for the catalog that you want to create. The DSN defines the database where you want to create the catalog. You then enter your user name and password for the DSN and click the OK button. You can choose not to show the OLAP Metadata Catalog Setup dialog box at each startup by clicking a check box. If you disable the option to view the OLAP Metadata Catalog Setup dialog box each time that you open a new session of Integration Services Console, you can select Tools > Create Catalog to view the dialog box again.

After the OLAP Metadata Catalog has been automatically created or updated from a previous version, you can access a new Sample Application Setup dialog box by selecting Tools > Create Sample. This dialog box enables automatic loading of the TBC sample application, including the sample data, sample OLAP model, and sample metaoutline. You must define an ODBC connection for the TBC sample application before you begin the automatic creation process.

To create the sample application, you must first connect to the OLAP Metadata Catalog where you want to store the sample data source, OLAP model, and metaoutline. You then enter the appropriate ODBC Data Source Name and password for the DSN user name TBC (tbc for Informix). DB2 OLAP Integration Server then creates the sample application automatically. The system displays a warning message if it detects that duplicate tables exist from a previous sample application. If a previous sample application is detected, the system will delete and replace the existing tables, or you must provide a new data source name before continuing.

After the OLAP Metadata Catalog has been created and, optionally, the sample TBC application has been created, the system displays the current Login dialog box.

Automatic Detection of Fact Table and Dimensions
After you click the OLAP Model icon for first-time model creation and log in to the appropriate data source, you can choose to have the OLAP model fact table and all related dimensions created automatically.

A quick-access link to the automatic detection option for creating a fact table is provided in the inline text of the Intelligent Help window). In addition, a Tools menu option Tools > Create Fact Table) is available from the OLAP Model main window.

When you select the fact table automatic-detection option using either method, the system displays a Create Fact Table dialog box. This dialog box shows the fact tables detected in the current data source to which you are connected, along with any existing fact tables in the OLAP Metadata Catalog that are present in the current data source. You can select either from a list of fact tables in existing OLAP models or from a list of potential fact table candidates to define the fact table to use. Check boxes in the Create Fact Table dialog box enable you to create the Time and Accounts dimensions automatically. If you prefer, you can create the Time or Accounts dimensions manually at a later time.

For automatic detection of dimensions, you can choose the automatic-detection link in the Intelligent Help window or select Tools > Create Dimensions to initiate the dimension-creation process. The system begins by looking for all tables joined to the fact table with primary-foreign key relationships. Next, it searches for all tables joined to the previously detected tables and adds them to the OLAP model schema. In a database where no primary-foreign key relationships are defined, the system begins by searching for all tables joined to the fact table and then uses the column name and type to determine join keys. If two tables have the same column name and type, the system assumes that the two tables are joined on that column. To reduce the possibility of creating invalid dimensions, the system does not search for join keys in any tables that are not joined to the fact table.

Automatic Detection of Hierarchies
Like the Create Fact Table and Create Dimensions options, a new option for automatic detection of hierarchies is provided. Use the automatic-detection link to this option provided in the text of the Intelligent Help window. Menu commands on the Tools menu in the OLAP Model and OLAP Metaoutline main windows also provide access to this option. From the OLAP Model main window, select Tools > Create Hierarchies; from the OLAP Metaoutline main window, select Tools > Get Existing Hierarchies. You can choose to create a single hierarchy or multiple hierarchies.

When you select the automatic hierarchy detection option, using either method, DB2 OLAP Integration Server searches for and detects hierarchies that exist in the OLAP Metadata Catalog. The system then displays the detected hierarchies in a hierarchical tree format that includes the dimension name, the hierarchy names, and the associated member names.

Automatic hierarchy detection does not detect any filters contained within the hierarchies. In addition, the system compares the hierarchical structure of the data source with that of the OLAP model dimensions and deletes any invalid columns from the detected hierarchies. For example, if the OLAP model Product dimension contains Category, Family, and SKU columns, but the data source does not contain a Category column, the hierarchy that is returned contains only Family and SKU columns.

Intelligent Help
This feature enhances user convenience and ease of operation. When you open the OLAP Model or OLAP Metaoutline main window to create or modify an OLAP model or a metaoutline, DB2 OLAP Integration Server Console provides a new option known as Intelligent Help to guide you through the process. Intelligent Help is displayed in a separate window that provides numbered procedures, along with links to new automatic detection options and frequently used functions.

Process buttons along the top of the window contain labels for each main group of related tasks. For example, the process buttons for the OLAP Model tasks groups contain the following labels: The operations that you need to perform to create an OLAP model fall into these main groupings.

Below the task-group process buttons, the Intelligent Help window consists of a right and left frame:

The Intelligent Help window is a dockable, relocatable window that you can move and resize as you prefer. Integration Services Console displays the Intelligent Help window automatically the first time that you create or open an OLAP model or metaoutline. You can click an icon to undock the Intelligent Help window and move it away from the console. You can click a check box to show or hide the Intelligent Help window at startup, and you can click a Close icon to close the window at any time during a console session.

Both the toolbar and the Tools menu in the OLAP Model and OLAP Metaoutline main windows provide options for selecting Intelligent Help. The system remembers whether the Intelligent Help window was open or closed during your last work session. If the Intelligent Help window is open when you close an OLAP model, the window is displayed automatically when you reopen the model to work on it at a later time.

As always, online help is available to provide in-depth conceptual information and dialog box entry details.

Load optimization
Five dynamic new load optimization options for improving member and data load performance:
Member load options
Data load options
Sort on alternate column
This feature enables you to sort on a column that resides in the relational data source, but which is not used in the OLAP metaoutline. Sorting on a nondisplayed column is enabled in both recursive builds and generation builds. The dialog boxes that you use to specify ordering and filtering display identical column lists for selection. To prevent multiple selections of the same column, a column that has been selected at any generation of ordering is no longer available for sort selection.
Loading of DB2 OLAP Server Properties from Database Columns
This new feature enables the following DB2 OLAP Server properties to be loaded from database columns in the same way that Consolidation Attributes and UDAs currently are loaded from DB2 OLAP Integration Server into DB2 OLAP Server:
Inclusion of this feature follows the DB2 OLAP Server Administration Services Console model, enabling you to define major DB2 OLAP Server settings from within DB2 OLAP Integration Server. You define these member settings using the metaoutline Member Properties dialog box, Member Info tab. When property values are combined in one database column, you can separate them with a comma or a space (for example: +, Expense, Last, Both). When you use a word to define a property, only the first letter is used during a member load; for example, (O)nly or (E)xpense or (T)wo Pass Calc.

For details on allowable values for properties loaded from database columns, click the Help button in the Member Info tab of the metaoutline Member Properties dialog box.

XML Import/Export
XML Import/Export enables you to import data into and export data from the OLAP Metadata Catalog. You can now quickly transfer OLAP models and metaoutlines from one OLAP Metadata Catalog to another through use of this feature. You can also use an XML-based editor to rename the OLAP model associated with a metaoutline and import the revised data into the OLAP Metadata Catalog. Be sure to use an XML editor that supports UTF 8 UNICODE.

Extensible Markup Language (XML) consists of two parts: To use the new XML Import/Export feature, DB2 OLAP Integration Server provides a new dialog box named the XML Import/Export dialog box. Select the File > XML Import/Export command from the OLAP Model or OLAP Metaoutline main window to access the dialog box.

You can then select the Import tab and enter the necessary information to open either an OLAP model or metaoutline from an XML file. You can also select the Export tab to save an OLAP model or metaoutline as an XML file. Click the Save As XML File button, enter an XML file name, and navigate to the directory where you want to save the file.

Incremental Update to Data
This feature enables you to add to and subtract from DB2 OLAP Server data during member loads and data loads. By default, DB2 OLAP Integration Server updates all dimensions and members. Incremental updating of an existing DB2 OLAP Server outline is faster than updating all dimensions and members. The Essbase Integration Services Console includes an Incremental Update dialog box to use for selecting update options.

For member load, you have the following options: For data load, you have the following options: For both member and data loads, you have the following Attribute Dimension Restriction options:
Member Load and Data Load Filter Options
This feature enables you to limit filters to a member load or a data load, or to apply filters to both member and data loads.

The Essbase Integration Services Console includes a revised DB2 OLAP Server Application and Database dialog box with a simple drop-down list from which to select or deselect filters.
Improved SQL Drill-Through
This feature takes advantage of the new data load optimizations by including join key optimization in the SQL for drill-through. In join key optimization, the join between a fact table and a dimension table is removed if the join column is the same as the column selected. This results in faster drill-through queries.
Windows Service Utility Support
This new utility adds the Windows NT and Windows 2000 service for DB2 OLAP Integration Server, accepting parameters supported by the olapisvr command. These parameters enable you to:
Improved Access to the Server Log File
To assist users in analyzing and debugging member and data loads, DB2 OLAP Integration Server now provides two methods of accessing the Server log file:
In both cases, DB2 OLAP Integration Server retrieves the log data and displays it in the Server Log File window with a date and time stamp for each activity that has occurred during the load. For very large member or data loads, the server retrieves only the last 1 MB of the log file. You can copy the log file and paste it to any text editor, such as Notepad, to print it out for review and analysis.
New Sample Application
DB2 OLAP Integration Server provides a new sample application based on a fictitious company named The Beverage Company (TBC). The TBC sample application demonstrates creating a Measures dimension recursively, using a sort on an alternate column in the relational data source, and loading metadata from database columns. Additionally, the sample application includes UDAs and Date Time Series data, additional years, new drill-through paths, and a new Time table to demonstrate data load incremental updates.

The TBC sample application includes the following components: For the first time, the sample application OLAP model and OLAP metaoutline are provided in Java-supported XML format.

The Essbase Integration Services Console provides a new Sample Application Setup dialog box that is displayed automatically after installation of DB2 OLAP Integration Server. With the completion of a few simple entries in the dialog box, you can now load the sample application automatically.

This automated feature enables you to create a functional sample application that is ready to use within minutes. You must set up the database for the OLAP Metadata Catalog and the TBC data source, and define open database connectivity (ODBC) connections beforehand. When setting up ODBC connections, the user name that you use when defining the Data Source Name (DSN) for the data source must be TBC (tbc for Informix) because the sample tables were created using this name.

UNIX ODBC Configuration Utility
DB2 OLAP Integration Server provides a new utility for UNIX users to verify, add, or delete ODBC connections. The odbcconfig utility enables you to edit ODBC configuration information in the odbc.ini file. This new utility also displays current environment settings related to relational database management system (RDBMS) access. You can use the odbcconfig utility for diagnostic testing of environment settings.

The odbcconfig utility provides the following menu options to aid you in configuring and troubleshooting ODBC connections:
FixPak 7 includes the following new upgrades:

DB2 OLAP Server Miner combines OLAP and data mining technologies

OLAP Miner is a new no-cost feature that brings together IBM's data mining and OLAP technologies.  OLAP Miner applies a sophisticated data mining algorithm called Deviation Detection to the data stored in OLAP cubes. The algorithm scans slices of cubes, identifying values that deviate from the norm. The results of a data mining run can be used by the business analyst to focus on the interesting or surprising values in context of the source OLAP cube. You can still use the usual slice, dice, and drill operations to explore the data, but now you let the values discovered by OLAP Miner drive your analysis.

The OLAP Miner client component includes a graphical user interface that guides the user through the process of setting up a deviation detection definition. This involves selecting:

OLAP Miner supports the following operating systems: For more information about OLAP Miner, see the OLAP Miner User's Guide, a new book in FixPak 6 and later.

IBM DB2 OLAP Server Miner is licensed for use only with IBM DB2 OLAP Server.

DB2 OLAP Integration Server now upgraded to Essbase Integration Services 6.1

In FixPak 7, DB2 OLAP Integration Server (OIS) upgrades to Hyperion's next level of Hyperion Integration Server, which is now called Essbase Integration Services 6.1. This section summarizes the new features of OIS:

New client console with dynamic Intelligent Help window

In FixPak 7, DB2 OLAP Integration Server (OIS) introduces the new Essbase Integration Services Console and companion Intelligent Help window. The new dockable Intelligent Help window contains dynamic links to key program functions to automate the major operations necessary for moving from a relational database to online analytical processing. This convenient new feature provides the following enhanced installation and client component functionality:
OLAP metadata catalog and sample application creation
When you first start Console, the system displays a new OLAP Metadata Catalog Setup dialog box. For first-time installations, you can click a button in this dialog box to create the OLAP Metadata Catalog. For existing users, if the system detects a previous version of the catalog, your existing catalog is updated to the current version. With FixPak 7, no other migration procedures for OLAP Integration Server are required, other than to update your existing OLAP Metadata Catalog.
To create the OLAP Metadata Catalog, you first enter the OIS server name and then enter the ODBC Data Source Name (DSN) for the catalog that you want to create. The DSN defines the database where you want to create the catalog. You then enter your user name and password for the DSN and click the OK button. You can choose not to show the Catalog Setup dialog box at each startup by clicking a check box. If you disable the option to view the OLAP Metadata Catalog Setup dialog box each time that you open a new session of Integration Services Console, you can select Tools > Create Catalog to view the dialog box.
After the OLAP Metadata Catalog has been automatically created or updated from a previous version, you can access a new Sample Application Setup dialog box by selecting Tools > Create Sample. This dialog box enables automatic loading of the TBC sample application, including the sample data, sample OLAP model, and sample metaoutline (see New sample application).
To create the sample application, you must first connect to the OLAP Metadata Catalog where you want to store the sample data source, OLAP model, and metaoutline. You then enter the appropriate ODBC Data Source Name and password for the DSN user name TBC ( tbc for Informix). OIS then creates the sample application automatically. The system displays a warning message if it detects that duplicate tables exist from a previous sample application. If a previous sample application is detected, the system will delete and replace the existing tables, or you must provide a new data source name before continuing.
After the OLAP Metadata Catalog has been created and, optionally, the sample TBC application has been created, the system displays the current Login dialog box. No changes have been made to the previous version of the Login dialog box or login procedures.
Automatic detection of fact table and dimensions
After you click the OLAP Model icon for first-time model creation and log in to the appropriate data source, you can choose to have the OLAP model fact table and all related dimensions created automatically.
A quick-access link to the automatic detection option for creating a fact table is provided in the inline text of the Intelligent Help window (see Intelligent Help). In addition, a Tools menu option (Tools > Create Fact Table) is available from the OLAP Model main window.
When you select the fact table automatic-detection option using either method, the system displays a new Create Fact Table dialog box. This dialog box shows the fact tables detected in the current data source to which you are connected, along with any existing fact tables in the OLAP Metadata Catalog that are present in the current data source. You can select either from a list of fact tables in existing OLAP models or from a list of potential fact table candidates to define the fact table to use. Check boxes in the Create Fact Table dialog box enable you to create the Time and Accounts dimensions automatically. If you prefer, you can create the Time or Accounts dimensions manually at a later time.
For automatic detection of dimensions, you can choose the automatic-detection link in the Intelligent Help window or select Tools > Create Dimensions to initiate the dimension-creation process. The system begins by looking for all tables joined to the fact table with primary-foreign key relationships. Next, it searches for all tables joined to the previously detected tables and adds them to the OLAP model schema. In a database where no primary-foreign key relationships are defined, the system begins by searching for all tables joined to the fact table and then uses the column name and type to determine join keys. If two tables have the same column name and type, the system assumes that the two tables are joined on that column. To reduce the possibility of creating invalid dimensions, the system does not search for join keys in any tables that are not joined to the fact table.
Automatic detection of hierarchies
Like the Create Fact Table and Create Dimensions options, a new option for automatic detection of hierarchies is provided with Release 6.1. Use the automatic-detection link to this option provided in the text of the Intelligent Help window (see Intelligent Help). Menu commands on the Tools menu in the OLAP Model and OLAP Metaoutline main windows also provide access to this option. From the OLAP Model main window, select Tools > Create Hierarchies; from the OLAP Metaoutline main window, select Tools > Get Existing Hierarchies. You can choose to create a single hierarchy or multiple hierarchies.
When you select the automatic hierarchy detection option, using either method, Essbase Integration Services searches for and detects hierarchies that exist in the OLAP Metadata Catalog. The system then displays the detected hierarchies in a hierarchical tree format that includes the dimension name, the hierarchy names, and the associated member names.
Automatic hierarchy detection does not detect any filters contained within the hierarchies. In addition, the system compares the hierarchical structure of the data source with that of the OLAP model dimensions and deletes any invalid columns from the detected hierarchies. For example, if the OLAP model Product dimension contains Category, Family, and SKU columns, but the data source does not contain a Category column, the hierarchy that is returned contains only Family and SKU columns.

Intelligent Help

This feature adds a new dimension in user convenience and ease of operation. When you open the OLAP Model or OLAP Metaoutline main window to create or modify an OLAP model or a metaoutline, Essbase Integration Services Console provides a new option known as Intelligent Help to guide you through the process. Intelligent Help is displayed in a separate window that provides numbered procedures, along with links to new automatic detection options and frequently used functions.
Process buttons along the top of the window contain labels for each main group of related tasks. For example, the process buttons for the OLAP Model tasks groups contain the following labels:
The operations that you need to perform to create an OLAP model fall into these main groupings.
Below the task-group process buttons, the Intelligent Help window consists of a right and left frame:
The Intelligent Help window is a dockable, relocatable window that you can move and resize as you prefer. Integration Services Console displays the Intelligent Help window automatically the first time that you create or open an OLAP model or metaoutline. You can click an icon to undock the Intelligent Help window and move it away from the console. You can click a check box to show or hide the Intelligent Help window at startup, and you can click a Close icon to close the window at any time during a console session.
Both the toolbar and the Tools menu in the OLAP Model and OLAP Metaoutline main windows provide options for selecting Intelligent Help. The system remembers whether the Intelligent Help window was open or closed during your last work session. If the Intelligent Help window is open when you close an OLAP model, the window is displayed automatically when you reopen the model to work on it at a later time.
As always, online help is available to provide in-depth conceptual information and dialog box entry details.

Load optimization

Release 6.1 provides six dynamic new load optimization options for improving member and data load performance:
Member load options
The result of a natural (inner) join between two tables includes records where the joined columns match. In any row from Table A in which a join column does not exist in Table B, that row is dropped when data is loaded. In an outer join, however, when an unmatched column is encountered during a data load, the unmatched row is included in the results. The column data of the unmatched portion is replaced with a <NULL > value.
Data load options
A new OLAP metaoutline SQL Override dialog box displays standard data load Select statements. You can select the statements that you want to edit. The two-frame dialog box shows the current metaoutline in the left frame and three windows in the right frame. The top right-frame window lists the Current Selected SQL and is the window in which you edit Select statements. The center window displays the User-Defined SQL List that you create. The bottom window displays the Standard Data Load SQL generated by Essbase Integration Server.
When you have completed editing of standard SQL statements, you can direct the system to use the edited version for a data load by checking the Use User-defined SQL for Data Load option in the OLAP Metaoutline Properties dialog box, Load Optimization tab. For rules and guidelines related to editing the standard data load SQL generated by Essbase Integration Server, click the Help button in the OLAP Metaoutline SQL Override dialog box.

Sort on alternate column

This feature enables you to sort on a column that resides in the relational data source, but which is not used in the OLAP metaoutline. Sorting on a nondisplayed column is enabled in both recursive builds and generation builds. The dialog boxes that you use to specify ordering and filtering display identical column lists for selection. To prevent multiple selections of the same column, a column that has been selected at any generation of ordering is no longer available for sort selection.

Loading of Essbase properties from database columns

This new feature enables the following Essbase properties to be loaded from database columns in the same way that Consolidation Attributes and UDAs currently are loaded from OIS into DB2 OLAP Server:
Inclusion of this feature follows the Essbase Administration Services Console model, enabling you to define major Essbase settings from within Essbase Integration Services. You define these member settings using the metaoutline Member Properties dialog box, Member Info tab. When property values are combined in one database column, you can separate them with a comma or a space (for example, "+, Expense, Last, Both"). When you use a word to define a property, only the first letter is used during a member load; for example, (O)nly or (E)xpense or (T)wo Pass Calc.
For details on allowable values for properties loaded from database columns, click the Help button in the Member Info tab of the metaoutline member Properties dialog box.

XML import/export

Release 6.1 XML import/export enables you to import data into and export data from the OLAP Metadata Catalog. You can now quickly transfer OLAP models and metaoutlines from one OLAP Metadata Catalog to another through use of this feature. You can also use an XML-based editor to rename the OLAP model associated with a metaoutline and import the revised data into the OLAP Metadata Catalog. Be sure to use an XML editor that supports UTF 8 UNICODE.
Extended Markup Language (XML) consists of two parts:
To use the new XML Import/Export feature, Essbase Integration Services provides a new dialog box named the XML Import/Export dialog box. Select the File > XML Import/Export command from the OLAP Model or OLAP Metaoutline main window to access the dialog box.
You can then select the Import tab and enter the necessary information to open either an OLAP model or metaoutline from an XML file. You can also select the Export tab to save an OLAP model or metaoutline as an XML file. Click the Save As XML File button, enter an XML file name, and navigate to the directory where you want to save the file.

Improved access to the server log file

To assist users in analyzing and debugging member and data loads, Essbase Integration Services now provides two methods of accessing the Server log file:
In both cases, Essbase Integration Server retrieves the log data and displays it in the Server Log File window with a date and time stamp for each activity that has occurred during the load. For very large member or data loads, the server retrieves only the last 1 MB of the log file. You can copy the log file and paste it to any text editor, such as Notepad, to print it out for review and analysis.

New sample application

Release 6.1 provides a new sample application based on a fictitious company named The Beverage Company (TBC). The TBC sample application demonstrates creating a Measures dimension recursively, using a sort on an alternate column in the relational data source, and loading metadata from database columns. Additionally, the sample application includes UDAs and Date Time Series data, and new drill-through paths.
The TBC sample application includes the following components:
For the first time, the sample application OLAP model and OLAP metaoutline are provided in XML format (see XML import/export), supported by Java.
Essbase Integration Services Console provides a new Sample Application Setup dialog box that is displayed automatically after installation of Essbase Integration Services (see New client console with dynamic intelligent help window). With the completion of a few simple entries in the dialog box, you can now load the sample application automatically.
This automated feature enables you to create a functional sample application that is ready to use within minutes. You must set up the database for the OLAP Metadata Catalog and the TBC data source, and define open database connectivity (ODBC) connections beforehand. When setting up ODBC connections, the user name that you use when defining the Data Source Name (DSN) for the data source must be TBC ( tbc for Informix), because the sample tables were created using this name.
The samples have moved to different directories, too.

UNIX ODBC configuration utility

Release 6.1 provides a new utility for UNIX users to verify, add, or delete ODBC connections. The odbcconfig utility enables you to edit ODBC configuration information in the odbc.ini file. This new utility also displays current environment settings related to RDBMS access. You can use the odbcconfig utility for diagnostic testing of environment settings.
The odbcconfig utility provides the following menu options to aid you in configuring and troubleshooting ODBC connections:
For detailed information, refer to the OIS System Administrator's Guide .


FixPak 6 and later introduces a new OLAP component called DB2 OLAP Server Miner.

FixPak 5 and later fixes defects listed in the Problem Summary.  FixPak 5 does not introduce any new function.

FixPak 4 and later upgrades DB2 OLAP Server to Essbase 6.1, and adds the following features and changes to DB2 OLAP Server V7.1:
 

Custom-Defined Macros and Functions:

The Hyperion Essbase calculator language can now be extended through the creation of custom-defined macros and functions.

Concering Java in this FixPak:

The Java runtime environment included this FixPak is not set up for general use by other Java applications on your system.  This FixPak does not define a path to the Java JRE in either your system environment variables or user environment variables; the JRE will not interfere with other Java environments already on your system.

New Calculator functions:
 

The following Calculator functions are new starting in FixPak 4:
Member Set Functions:
Mathematical Functions:
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.
FixPaks 4 and later add five new ESSBASE.CFG settings that you can use to establish the size of this cache and define how it is used.
 
MaxL administration language:
 
MaxL is the multi-dimensional access language for DB2 OLAP Server. MaxL is a practical, expressive interface for administering Hyperion Essbase system administration in the following ways:
Improved Diagnostics:
 
Two performance statistics commands, GETPERFSTATS and RESETPERFSTATS, have been updated in Hyperion Essbase Release 6.1. The GETPERFSTATS command returns short, medium, and long performance statistics for the thread, database, and application. The statistics appear as tables in the ESSCMD window.
 
The RESETPERFSTATS command resets statistics gathering for a specified persistence and scope.
 
Improved Password Protection:
 
FixPaks 4 and later provide an enhanced encryption algorithm for transferring login information over the network. The encryption takes place at the API level, so all of the tools should be compatible with this change. Hyperion Essbase Release 6.1 uses the Blowfish algorithm from Counterpane Internet Security, Inc. For more information, see http://www.counterpane.com/blowfish.html .
 
Parallel Export:
 
In previous versions of DB2 OLAP Server, export for the multidimensional storage manager was a single-threaded process. Starting in Fixpak 4, the PAREXPORT command enables administrators to export OLAP databases natively using multiple threads. The export process is therefore multithreaded and allows users to leverage the full power of their hardware investment.

The parallel export process works only with the multidimensional storage manager, not the relational storage manager.
 

New Formula Validation Options:
Through new menu options in Outline Editor and Formula Editor, users can choose whether Hyperion Essbase validates formulas on the client or on the server.
 
Release 6.1 ESSCMD Commands:
New ESSCMD Command --
Updated ESSCMD Commands --
Release 6.1 ESSBASE.CFG Settings:
 
New ESSBASE.CFG Settings --
Updated ESSBASE.CFG Setting --
MERANT ODBC Drivers:
 
MERANT ODBC drivers version 3.6 are provided with the FixPak 4 and later SQL Interface.
 
New Spreadsheet Add-in Platform:
The Spreadsheet Add-in clients now support Lotus 1-2-3 Millennium R9.5.


FixPak 3 and later fixes defects listed in the Problem Summary. This FixPak does not introduce any new function.

FixPak 2 and later fixes defects listed in the Problem Summary. This FixPak does not introduce any new function.

FixPak 1 and later fixes defects listed in the Problem Summary. This FixPak does not introduce any new function.


Additional documentation

Although the following additional documentation refers to Hyperion Essbase, it applies to DB2 OLAP Server as well.

Updated books

All of the latest books are also available on our Web site:

www.ibm.com/software/data/db2/db2olap/library.html

In FixPak 9:  The following updates were applied to the documentation:

Negative values for DLTHREADSPREPARE and DLTHREADSWRITE essbase.cfg settings.  If the number of threads in the DLTHREADSPREPARE and DLTHREADSWRITE essbase.cfg settings are specified as negative values, Essbase uses the maximum value, 16.

DISKVOLUMES Still Available.  You can still use the configuration setting DISKVOLUMES, in the configuration file essbase.cfg, instead of the database-specific settings available via Application Manager. Use DISKVOLUMES only if you need backward compatibility with earlier releases, or if you are setting up a large number of databases with the same DISKVOLUMES value at the same time.

Sample Application Versus Example Application.  A section of the Essbase Database Administrator's Guide uses an example application called TCC, The Car Company.  This is not a sample application supplied with the software but is an example used to illustrate how you can quickly create your own first application. The sample application supplied with Essbase is TBC, The Beverage Company.

Cross-Dimensional Operator Works with Member Set Functions.  Expressions such as ("1998":"2001" -> @Levmbrs (Year, 0)), using the cross-dimensional operator with a member set should now function. This operator is associative (x -> y) -> z=x -> (y -> z), but not commutative because x -> y = y -> x is a set, but the order of elements is different. (21505)

CLEARDATA Does Not Work in an IF Block.  The calculation script CLEARDATA command does not work in an IF block. This is not documented. (20949)

Moving Members and Attribute Associations.  In an outline, moving base members with attribute associations now keeps the attribute associations.  The documentation incorrectly states that it does not.

DB2 OLAP Server Does not Generate Trace Files.  DB2 OLAP Server does not generate trace files, but some documentation still indicates that it does. (014112)

Unclear Spreadsheet Example.  The example in Spreadsheet Add-In User's Guide for Excel, chapter 3, pages 3-28 through 3-31, is unclear.  It will be improved for next release. (25511)

Calculation Results Difference.  Small differences in the precision of cell values may occur between calculations run on different platforms, due to operating system math library differences.(007598)

Null processing in Dimension Build.  Documentation should state that in the dimension building setting for a Product dimension, you must select the Allow moves check box, or null processing with a generation reference will fail. (020022)

EssListCalcFunctions() Requires Supervisor Privilege And Database Access.  The documentation is missing information about the privileges required to use EssListCalcFunctions(). You must have supervisor privilege (usually granted to the administrator), and you must have database access privileges to receive this list, or an error may occur. This means, for example, if you run a program with EssListCalcFunctions() when logged in as a user who does not have both supervisor privilege and access to the database, an error will occur.

Reserved words that Require Quotation Marks.  The documentation may not contain a complete list of reserved words that must be enclosed in quotation marks to be used for member names. The list will be updated in a future release.

Missing Configuration Parameter for Data Load Errors.  The documentation does not include information about NOMSGLOGGINGONDATAERRORLIMIT, a configuration setting you can add to your server essbase.cfg file to prevent data load errors from being written to the application event log file after the limit described by the value of DATAERRORLIMIT is reached.  Add this item to your server configuration file essbase.cfg:

NOMSGLOGGINGONDATAERRORLIMIT TRUE
The default is false. (22146)

API Client Message Change.  Client messages are messages sent to the user-defined Callback function, passed to DB2 OLAP Server in EssInit. Previous to FixPak 8, if a message contained NLS characters (non-English characters, such as accented characters), DB2 OLAP Server provided them in OEM (DOS) format. In FixPak 8, the client messages are completely in character (Windows) format, to avoid the misinterpretation of certain characters.  This only affects languages other than English.

API Error for ESSG_INIT_T.  ulMaxRows has a limit of 65535 rows, and ulMaxColumns has a limit of 256 columns. The API documentation for ESSG_INIT_T is currently incorrect on these two issues (18435).

Missing Grid Expansion Configuration Settings  (14987, 18987, 20709, 22585).  If Essbase returns incorrect results from a calculation using both two-pass calculation dynamic members and you are aggregating across partitions, enter this configuration setting in your server essbase.cfg file, then restart OLAP Server: GRIDEXPANSION FALSE.   The default is TRUE.
If Spreadsheet Add-In retrievals involving partitions generate many instances of this message: "grid expansion enabled for this query," you can turn off the messages by adding this entry to your server configuration file essbase.cfg, and then restarting OLAP Server: GRIDEXPANSIONMESSAGES OFF.   The default is "ON."

Missing Parameter for Functions @NEXTS, @PRIORS.  Both these functions accept these parameters:

SKIPNONE | SKIPMISSING | SKIPZERO | SKIPBOTH, mbrName [,n, rangeList])
The documentation currently omits SKIPBOTH. (28642)

Functions to Help Performance on Dense Ranges.  Consider using these functions instead of prior and next if your calculation operates on dense ranges - i.e., Both crossmbr and range are along dense dimension:

@SHIFTPLUS(Mbr, CrossMbr, ShiftAmt, Range)
Instead of: Mbr + @SHIFT(CrossMbr, ShiftAmt, Range)
@SHIFTMINUS(Mbr, CrossMbr, ShiftAmt, Range)
Instead of: Mbr - @SHIFT(CrossMbr, ShiftAmt, Range)
 

Incorrect essbase.cfg MAXLOGINS.  The configuration setting MAXLOGINS is incorrectly listed as MAXLOGIN in the Technical Reference and Database Administrator's Guide.

-------------

In FixPak 8 and later:  The following books for DB2 OLAP Server have been updated to Essbase 6.2 and Essbase Intetration Services 6.2 and are shipped in this FixPak.

New Error Messages Document:

FixPak 8 provides an HTML document that describes what to do when you receive certain error messages.  Each documented error message includes the message number, message text, potential problems that caused the error, and potential solutions. For Release 6.2, messages involve data loading, calculation, data cache, networking, and the agent. In future releases, more functional areas will be explained.

Database Administrator’s Guide improvement:  FixPak 8 reorganizes the Database Administrator's Guide into three volumes to provide better access to the information. The updated version is available in English only.

Technical Reference now available online only:    The complete Technical Reference is now available only in HTML format.  The Quick Technical Reference is no longer being produced.
 

In FixPak 7 and later:  The following books for DB2 OLAP Server have been updated to the Hyperion Essbase Integration Services 6.1 level and are shipped in this FixPak:

The OLAP Miner User's Guide has been refreshed.

Also, FixPak 7 withdraws the Business Intelligence Tutorial because the interface it describes has been withdrawn from Essbase Integration Services 6.1.  DB2 OLAP Integration Server now offers Intelligent Help instead.

In FixPak 6 and later:  A new book, the OLAP Miner User's Guide, is provided to describe DB2 OLAP Server Miner, a new feature of DB2 OLAP Server.

In FixPak 4 and later:  The following books for DB2 OLAP Server have been updated to the Hyperion Essbase 6.1 level and are shipped in this FixPak:

In FixPak 2 and later:  The following books for the DB2 OLAP Integration Server have been updated to the Hyperion Integration Server 2.0 level and are shipped in this FixPak:

Excel XP

If you have a custom installation of Excel XP, the Spreadsheet Add-in may not be visible in Excel XP, or the Essbase System Login box may fail to appear when you choose Essbase > Connect. Choose the complete Excel XP installation instead, or, if you have already installed Excel XP using a custom installation, go back and install Office Shared Features and Office Tools from the Excel XP installation program. If you choose the option to install the Office Shared Features on first use, you must pre-install Visual Basic for Applications before running the Spreadsheet Add-in.

New Config Setting for Formula Execution Level Limit

A new configuration setting (CalcLimitFormulaRecursion) has been added that, when set to True, prevents the server from going beyond 31 formula execution levels. By default, Essbase no longer limits the number of formula execution levels. It should be noted that formulas with excessive execution levels may crash the server. In a previous maintenance release (6.1.4), Essbase began imposing a limit on the number of formula execution levels; if you installed 6.1.4 to fix problems with server crashes due to certain spreadsheet retrievals containing member formulas and dynamic calcs, you need to re-enable the formula execution limit. To do this, add the CalcLimitFormulaRecursion True setting to your essbase.cfg file.

Change in Solaris Command Line

Attempting to compile and link C program in Solaris returns errors. (30328)
The contents of the command line for building applications on Solaris has changed for Solaris 2.7 and 2.8. The new command line for building Essbase applications should be:
cc sampapp.c -I$ARBORPATH/api/include -L$ARBORPATH/api/lib -D_REENTRANT -o esstest.out 
-lm -ldl -lposix4 -lsocket -lnsl -lpthread -lglobalc -lessotl -lessglob -lessapi  
-lessnet -lessshr -lessutl -lesssd -lesssec
Refer to the Essbase API documentation for more information.

Change in Persistence of Allow Settings

Disabling connections in the application settings (Allow Connects option) is no longer session-dependent. If an administrator disables connections for databases in an application, connections remain disabled until the application is restarted or until connections are re-enabled by the administrator using the application settings. In summary, disabling of the following application settings has the following persistence:

Port settings and application limits

Starting with Maintenance Release 6.2.1, the default port settings for the ServerPortEnd, ServerPortBegin, PortInc, and AgtSvrConnections configuration-file settings, when combined, yield an available number of ports to be 100. Prior to this release, the default port settings yielded an available number of ports to be 200.

Specifically, the number of available ports is equal to:

ServerPortEnd - ServerPortBegin
------------------------------- + 1
PortInc x (ports needed per app)
 

Prior to Release 6.2, the number of ports needed per application was 1. In Release 6.2, that number was increased to (1 + AgtSvrConnections), where AgtSvrConnections is the number of connection channels between the agent and the application server, and defaults to 1. If you need more than 100 ports, then use appropriate values for these settings.

Root.sh information

The OLAP Setup and User's Guide incorrectly states that you must be logged on with a user ID that has root privileges when you install DB2 OLAP Server on UNIX systems.  You do not need root privileges to install the product.

Solaris and HP-UX SQL interface users should not run the file root.sh unless they want to turn on the "Cache Memory Locking" feature. Furthermore, if they want to use Cache Memory Locking, they need to have root privileges to run root.sh.

HP-UX settings

For optimal use of memory, we recommend setting _M_ARENA_OPTS to 4:8. For more information on this setting, consult the HP-UX documentation on malloc.

Agent log messages

Previously, the agent log message, Last Login on Date/Time, displayed the following format:

   Last Login on Fri Apr 20 21:52:16 2001

Now the agent log message displays the following Date/Time format:

   Last Login on Friday, April 20, 2001 10:57:29 AM

However, all other date and time formats remain the same.

Buffered I/O Default

The index and page file sizes will grow only if direct I/O is turned on. If you migrate directly from DB2 OLAP Server V1.1 to V7.1 FixPak 8, then the file sizes should remain the same because buffered I/O is the default in FixPak 8. But if you migrate from V1.1 to any level of V7.1 prior to FixPak 8 in preparation for migration to FixPak 8, or migrate from any level of V7.1 prior to FixPak 8, then direct I/O is the default and the file sizes will grow.  Previous cache settings will be maintained. You can add DIRECTIO TRUE to the essbase.cfg file, and maintain your previous settings. If you wish to keep the buffered I/O default, you may want to adjust caches (Index Cache, Data Cache) if you previously changed them for direct I/O.

MaxL installation update

MaxL and the files necessary to install MaxL Perl Module (Essbase.pm) are installed with the Essbase OLAP Server on all platforms and with Application Manager on Windows platforms.  MaxL files are added to your /bin and /api directories of your installation. You do not have to install the API to use MaxL.

New configuration file settings (essbase.cfg)

This section lists new configuration file settings:

SQLFetchErrorPopup TRUE | FALSE

Specifies whether an Essbase error is generated when fetching data from a SQL database during a data load or a dimension build. The error will provide a popup error message in Application Manager and will enable the use of the IFERROR in Esscmd.

Known problems and limitations

----------- For DB2 OLAP Server:

Temporary Directory Path Issues:  On UNIX, if you have an environment variable called TMPDIR set, then unset this environment variable so Essbase can create temporary files in /tmp directory. If you want to use the TMPDIR environment variable, ensure that its path name is no longer than 15 characters.  If the full path to the temporary file is greater than 15 characters, some DB2 OLAP Server functions may fail.

A new essbase.cfg setting has been added.  The new setting addresses problems with the GetDbStats command (Esscmd) crashing the OLAP server during calculations or heavy usage. If you are experiencing this problem, add the setting SamplingNumBlocks to the essbase.cfg configuration file and set it 1 to indicate the number of blocks for GetDbStats to sample. Accepted values are 1 - 100. We recommend 1 for this particular issue; however, setting to a larger number provides for better statistics.

In DB2 OLAP Server Miner, the Linked Reporting Object functions do not work.  (n/a)
When you select either the 'Create LRO' or  'Delete LRO' options in OLAP Miner, an error message occurs.

Online HTML books might not display properly in Netscape Navigator (n/a)
When you use Netscape Navigator to display HTML books that are intended for a three-frame layout, Netscape might not load the book completely, displaying only one page of information and not displaying the table of contents in the navigation pane on the left. If this occurs, click the Reload button on the Netscape Navigator browser to display the book in three-frame format.

On AIX, a core dump or segment fault error during installation or use of DB2 OLAP Server is caused by inadequate memory. (n/a)
On AIX, if you get a core dump or a segment fault error when you install or use DB2 OLAP Server, then the memory allocated to DB2 OLAP Server on your AIX machine needs to be increased.  The default ulimit value on AIX is 1G, but DB2 OLAP Server files require 2G.   You can increase the memory by using the AIX command called ulimit.  For example, to increase the stack size, enter the following command:

ulimit -s unlimited

For more information about the ulimit command, see the AIX Commands Reference.

Starting in DB2 OLAP Server FixPak 4, the outline import/export function is no longer included in the Application Manager. (n/a)
The outline import/export function has been removed from the Application Manager from FixPak 4 (Hyperion Essbase 6.1 Patch 2).  This function continues to be available in the Spreadsheet Add-in.

On Windows, directory names greater than 8 characters cannot include spaces.  (n/a)
On Windows, when loading data from a directory, if the name of the directory includes spaces and is longer than 8 characters, an error occurs.   Either rename the directory to remove the spaces, or shorten the directory name to 8 characters or less.

Server Rejects: @AVG("SKIP_Param", expList) the Following Client Is out of Synchronization. (19340)
The server does not accept quotations marks around the following skip parameters: SKIPNONE, SKIPMISSING, SKIPZERO, SKIPBOTH. The Calc Script Editor and client outline verification will not detect this error. When a calculation is run with this syntax error, the application log has the following error message output:
Error parsing formula for member (line <no>): invalid skip instruction in function .
Note that the server validation will catch this error in the Formula Editor.

Calc Script Editor Does Not Generate an Error Message When Reserved Words Are Not Quoted. (20343)
When validating a calculation script, the client may not generate an error message for the incorrect usage of a non-quoted reserved word used for a dimension or member name.
Calculation script reserved words include calc script commands, operators, report script commands, function names, and function arguments in addition to the basic terms, such as AND, BEGIN, MEMBER, FUNCTION, IF, THEN, and so on. For a list of these terms, see the Hyperion Essbase Database Administrator's Guide. It is better not to use these reserved words as dimension names, member names, and aliases. If you do use them as names or aliases in calculation scripts, you must enclose them in quotation marks.

The ESSCMD Batch Job Is Canceled When Regular User Logs out by the Supervisor CONSOLE. (20434)
When running the nightly batch job, the application log appears and can be logged out via CONSOLE because the Essbase script files are not locked, the user has no firewall connections, and has read-only access to the Essbase script files.

In the Japanese Version, Header and Footer Strings that Are Set in Cascade Menu Item Are Preceded by Incorrect Characters. (21011)
With Japanese Hyperion Essbase Spreadsheet Add-in for Excel, header and footer strings that are set in the Cascade menu item are preceded by incorrect characters when printing and previewing.
Work around: Go into Print Preview > Setup to the Header/Footer tab and specify a custom header/footer that does not contain the incorrect characters.

Set Member Filter in Essbase Query Designer (EQD) Value with MBCS Displays Broken Character. (21012)
From within the Essbase Query Designer, attempting to create a member filter using multi-byte characters and an IME mode causes a data entry problem in both Excel and the Essbase Query Designer.
Work around: Launch the Notepad (or any other text editor that accepts multi-byte input), enter the multi-byte text, copy, and paste the text into the Essbase Query Designer.

If "Allow Application to Start" Setting Is Disabled When the ESSCMD, Call BEGINARCHIVE, Is Used, the Application and Database Cannot Restart. (21247)
If "Allow Application to Start" setting is disabled and a database is placed in the archive mode with ESSCMD, BEGINARCHIVE, after stopping the application, the application and database may not restart.

Installer overwrites UDF.Policy file (27367)
Essbase installation for both base product and patches replaces the udf.policy file, which is used in conjunction with Custom-Defined Functions. This file could have previously been updated by an Essbase administrator to give access to specific JAR files. Administrators who have updated the udf.policy file should backup their udf.policy file prior to installing Essbase and patches.

After reverting to direct I/O on HP-UX 11.0, Essbase applications may fail to load. (29017)
On HP-UX 11.0, Essbase applications may fail to load if you attempt to swich from direct to buffered I/O and then back to direct I/O.

Parallel export may fail when the path name contains a dot. (29604)
When the path name for a parallel export contains a dot ".", it may fail.

GetDbStats command (Esscmd) may crash the OLAP Server during calculations or heavy usage. (32219)
A new essbase.cfg setting has been added to address problems with the GetDbStats command (Esscmd) crashing the OLAP Server during calculations or heavy usage. If you are experiencing this problem, add the setting SamplingNumBlocks to the essbase.cfg configuration file and set it 1 to indicate the number of blocks for GetDbStats to sample. Accepted values are 1 - 100. We recommend 1 for this particular issue; however, setting to a larger number provides for better statistics.

----------- For OLAP Integration Server:

Workaround for creating OIS sample on Windows NT.  (IBM5514)
To create the OIS sample using the OIS Desktop on with Windows NT, set the TEMP and TMP environment variables as system environment variables rather than user environment variables.  Set both TEMP and TMP to C:\TEMP.

ODBCCONFIG utility sometimes fails to update oddb.ini file. (n/a)
Starting in FixPak 7, the odbcconfig utility sometimes does not fully update the odbc.ini file as expected.  To make sure the odbc driver and the path to the driver is correct, edit the odbc.ini file and update it if necessary.

In some cases, Essbase Integration Services displays Hyperion Essbase error numbers without the corresponding error message.  (10715)
WORKAROUND: View the message.txt file located in the ISHOME/esslib/bin directory or check the Essbase Integration  Services log file.

In the Metaoutline main window, if you select the toolbar to not display, the Filters toolbar and Filters icons are not displayed either. (10815)

Essbase Integration Services Release 6.1.0 software does not support Pass-through (Database Specific) transformations using SQL functions. (15131)
Specifying a built-in RDBMS function, such as Substring, or Left, causes Essbase Integration Server to generate invalid SQL.

Essbase Integration Services does not support Relational Database Management System (RDBMS) table and column names that have imbedded blanks.  (15454)
If Essbase Integration Services encounters blanks, it generates invalid SQL statements.

(Sybase databases) An incorrect error message is displayed when the user TBC does not exist in the Sybase database.  (23793)
The error message "user 3 does not exist" is displayed; the error message should read, "user TBC does not exist."

If you are using Excel and you drill down on Accounts, all the account members are highlighted as having an attached report even though you have selected only one member. (23923)

If you use tab characters to tell Essbase to use the same member name that appears in a previous record, the Essbase streaming data load does not provide the complete path of any rejected members.   (24705, 24706)
Essbase Integration Services cannot build a text file for loading rejected records.

Languages that use a comma as a decimal separator must run DB2 OLAP Server and DB2 OLAP Integration Server in the same language; for example, both products should be run in French. (25839)
Languages employing a decimal point do not have this problem.

If Essbase Integration Services encounters a NULL value during a data load, it automatically loads the data into the parent member of the NULL. However, if the NULL is at Generation 2, Essbase Integration Services cannot load the data to the parent member because the parent member is the dimension level member. In this case, Essbase Integration Services records an error in the log file.  WORKAROUND: Do not include NULLs at Generation 2.

If Oracle 8.0.x on Solaris or HP-UX fails due to the unresolved symbol, slpmprodstab, change directories to ishome/odbc/merant36/src/oracle and run ./genclntsh8.

If your Operating System file system does not allow more than eight-character names, the member load and view sample functions may fail.  The workaround is to start Essbase Integration Services in a directory that is in a file system that supports longer names.
 


Problem summary

The following problems are fixed in FixPak 9.

Updating a database may take longer than expected when ssauditr is specified in the essbase.cfg file. 21819 (25402)
Locking and sending data from a spreadsheet may take longer than expected if the essbase.cfg file contains the entry ssauditr and the spreadsheet contains dynamically calculated cells.

Large calc scripts take a long time to start. 25016 (29321)
Large calc scripts may take a minute or longer from the time the calc script is executed until it begins calculating the database.

Dynamic calc members on the target of a transparent partition may not be calculated correctly. 25031 (29341)
Retrieving from the target of a transparent partition may give incorrect results when some of the target members are tagged as dynamic calc.

SQL fetch error does not generate Essbase error. 25036 (29346)
When a SQL fetch error occurs when loading data or building an outline through SQL Interface, neither Application Manager nor ESSCMD indicate that an error has occured, though the error is indicated in the application log. To enable the error-handling fix, place the following line in the essbase.cfg configuration file: SQLFetchErrorPopup TRUE

Locking and sending data when Update Mode is selected may result in data being sent to the wrong cells. 25115 (29450)
In the Spreadsheet Add-in, selecting Update Mode (in Essbase > Options > Mode tab, under the Mode heading), and locking and sending data, may cause the data to be sent to the wrong members.

Outline Synchrozization may fail to update the currency category. 25143 (29842)
Changing the Currency Conversion from None (Use Ancestor) to Category on a member and trying to synchronize it through a transparent partition may not amend the currency category even though it recognizes that the outline is not synchronized.

Calculation on a transparent partition runs continually and creates a large number of empty data blocks. 25296 (29679)
Calculating the target database in a transparent partition takes an excessively long time and occupies a lot of disk space with empty data blocks.

In the Essbase Query Designer, the Find menu selection does not find shared members. 25412 (29826), 25356 (29757)
The Find menu selection in the Essbase Query Designer does not find shared members that fit the search criteria.

Entering a level or generation name fails in advanced interpretation retrieval mode. 25941 (30488)
Spreadsheet retrievals that use a level or generation name in the free form retrieval mode work, but those that use a level or generation name in the advanced interpretation retrieval mode fail and result in error messages.

Calc script using @MATCH with @SUBSTRING may cause the OLAP Server to crash 26095 (30689)
Using a calculation script that contains the @MATCH function with the @SUBSTRING function may cause the OLAP Server to crash. The following is an example of a calculation script that contains both these functions:

sales

(IF(@MATCH(MARKET, "@SUBSTRING(utah,0,1)*")==1)

sales=24;

ENDIF)
API function to get attribute information on a parent incorrectly returns information associated with child member. 26167 (30780)
Using the GetAssociatedAttributesInfo API function on a parent base-dimension member incorrectly returns attribute information associated with its single child member.

Results of spreadsheet retrievals may be incorrect if the retrieval includes members with the @XREF function. 26212 (30840)
Spreadsheet retrievals that include members with the @XREF function in member formulas may have incorrect results.

Some attribute retrievals may return incorrect results. 25612 [30069], 26447 (31148)
When a Two-Pass Calculation member formula contains another dynamic Two-Pass Calculation member, the attribute calculation may return incorrect results.

After a spreadsheet retrieval that uses the EssCell function, subsequent retrievals from different databases may fail. 26462 (31168)
Certain spreadsheet retrievals may fail if you complete a retrieval using a spreadsheet with the EssCell function, connect to a different database using a different worksheet in the same workbook, and then retrieve from the second database. At this point, the retrieval fails and Essbase displays error messages.

Numbers to the right of the decimal point may not be displayed in some retrievals. 26642, (31380), 32521 (27531)
When the regional setting is set to a language other than English, and the report is in free form mode (in the Spreadsheet Add-in, EQD, or Report Writer), numbers to the right of the decimal point may not be displayed.

Unable to load alias table using Esscmd. 26751 (31510)
Using the Esscmd LoadAlias to load an alias table may fail to load the alias table correctly resulting in some aliases being missing or truncated.

Drilling down on an attribute dimension may cause the OLAP server to hang. 26761 (31525), 26762, (31526), 26647, (31385)
Drilling down on certain attribute dimensions may cause the OLAP server to hang.

Certain retrievals may not return correct results. 26896 (31695), 26895 (31694), 25789 (30290), 25448 (29869)
Retrievals with Time Balance members may not return correct results if the report contains upper-level Time dimension members which are dynamically calculated and contain member formulas.

ESSLOGIN performance is slow. 26966 (31792)
The ESSLOGIN C API function is logging in users more slowly than expected.

Dimbuilds may fail if excessive sorting is required 27016 (31861)
Dimension builds sometimes fail on AIX 4.3.3 when a large number of items need to be sorted.

Calculations that aggregate missing values and use the CALC DIM or AGG commands may have incorrect results. 27090 (31954)
A calculation that has SET AGGMISSG ON and uses the CALC DIM or AGG command may fail to roll up some values.

The OLAP Server may crash when the disk volume partition size is set to Unlimited. 27092 (31954), 27094 (31958), 27092 (31956)
When the index of a database (ess0000x.ind) spans more than one volume and the disk volume partition size is set to Unlimited, the OLAP Server may crash.

Calculating the target database in a transparent partition may take much longer than expected. 27095 (31959)
A calculation on the target of a transparent partition may take much longer than expected if the calculation fixes on an area outside of the partition.

Printing from the Application Manager may fail if the printer name is long. 27147 (32033), 26884 (31676)
Printing with NetWare Distributed Printer Service may fail and may cause the Application Manager to crash if the printer name is long.

<LINK report command may result in an incorrect syntax error. 27170 (32059), 26023 (30591), 21888 (25494)
Report scripts that contain the <LINK command with nested parentheses may result in an incorrect syntax error.

The SET FRMLBOTTOMUP calculation command may give incorrect results. 27192 (32089)
Calculations that use the SET FRMLBOTTOMUP calculation command may have incorrect results.

Cutting and pasting members in the Outline Editor may result in lost data. 27254 (32180)
When you cut and paste members in the Outline Editor, the members are copied but the data associated with the members is not copied.

A spreadsheet retrieval that includes attribute dimensions may return incorrect results. 27480 (32457), 27498 (32479)
Certain spreadsheet retrievals that include multiple attribute dimensions and members that are ancestors of shared base members may return incorrect results.

A linked partition that is governed by filter access fails to link to the source database. 27485 (32463), 26871 (31656)
When you select View/Launch in the Linked Objects Browser to link to the source database in a linked partition that is governed by filter access, Essbase displays an error message and fails to make the link.

Some data cells may not be copied when you use the DATACOPY calculation command. 27486 (32464)
When you copy data using the DATACOPY calculation command, some data cells may fail to be copied.

The <ASYM report script command copies all data from the first column to all subsequent columns. 27493 (32473), 27384 (32346)
A report script that uses the <ASYM command may copy data from the first column into subsequent columns.

Currency conversion is taking longer than expected. 27530 (32519)
It may take longer than expected to convert currencies using the Currency Conversion module.

Certain spreadsheet retrievals that include a sparse member with @PRIOR and SKIPMISSING in a member formula may fail. 27568 (32567), 27769 (32830)
Spreadsheet retrievals may hang and it may be impossible to terminate them normally if they include sparse members that have @PRIOR and SKIPMISSING in member formulas.

The essbase.secure script (used for securing a password) causes the OLAP Server to incorrectly write an error message to the Essbase.log. 27662 (32692)
In response to the essbase.secure script, the OLAP Server generates the error message "Unknown application name -secure -ignored" to the Essbase.log.

A data load takes much more memory in 6.2.2 than it does in 6.1p3a. 27676 (32707)
Under certain conditions, data loads under 6.2.2 may use ten times more memory than they do under 6.1p3a.

Spreadsheet retrievals that contain unknown members in row headers may cause the Essbase application to crash. 27684 (32718), 27616 (32628)
If a spreadsheet retrieval contains an unknown member in a row header, Essbase may display the following error message: "You must have a row header in order to perform this retrieval" and the Essbase application may crash.

Calculation results under 6.2.2 may be different from those under 6.1p3a. 27760 (32820)
A calculation under 6.2.2 results in some missing values that are not missing when you run the same calculation under 6.1p3a.

A retrieval that requests a non-existent subset of data may cause the Essbase application to crash. 27767 (32828)
A retrieval that requests a non-existent subset of data, such as requesting (Gen4, year) when the year dimension only has three generations, may cause the Essbase application to crash.

Dimension build may fail to move a member in an attribute dimension. 27768 (32829)
A dimension build that should move a member in an attribute dimension to a different parent fails to move the member.

A retrieval takes longer to run with an optimal size retrieval buffer than it does with a much smaller retrieval buffer. 27779 (32841)
A retrieval runs faster with a small retrieval buffer size than it does with larger retrieval buffer that is the optimal size. A retrieval buffer is at optimal size when it is large enough to do the entire query in one chunk.

Retrievals that include attributes may return incorrect results. 27784 (32848)
Retrievals that contain attributes, more than one Two-Pass calc member, and more than one base member may have incorrect results.

Data load may hang if the data file contains unknown members. 27799 (32865)
The OLAP Server may hang and fail to display an error message when it encounters an unknown member during a data load.

Running several dimension builds in succession may result in a memory leak. 27849 (32932)
Running several dimension builds in succession may result in excessive memory usage that is not released when the dimension builds finish running.

A large data load via Essbase API may not generate a rejected records file. 28192 (33325)
When running a data load via the API that updates more than 3000 blocks, using a data file that contains some errors, the OLAP Server may fail to create a rejected records file.

Memory leak with calculations that use the @XREF function. 28277 (33425)
Memory used in calculations that use the @XREF function may not be released until the Essbase application is stopped and restarted.

Some calculations that use the @XREF function may fail to finish running. 28335 (33492)
Calculations that use the @XREF function may hang.

Essbase applications may crash during periods of heavy usage. 28393 (33556), 28420 (33589), 27432 (32401)
Essbase applications may crash during periods of heavy usage such as concurrent calculations or concurrent data replication operations through partitions.

Spreadsheet Add-In on French systems may drop decimal point and following numbers from drill-through reports. 28420 (33589)
On systems localized to French, the Spreadsheet Add-In may drop the decimal point and following digits from numbers displayed in drill-through reports, if the variable type of the corresponding column in the relational database fact table is floating point.

Using the Escape key to cancel calculations in Esscmd may cause the OLAP Server to crash. 28433 (33606)
Canceling calculations in Esscmd using the Escape key may cause the OLAP Server to crash.

Certain expressions in calc scripts may cause the OLAP Server to crash. 28661
Calc scripts that contain certain complex nested expressions such as FIX statements may cause the OLAP Server to crash.

View sample and member load SQL are different when sorting on a column.  When a recursive hierarchy was created and then a sort was performed on an alternate column in the hierarchy, the SQL generated for a view sample and a member load were different. SQL.  (30035)

Deleting table in OLAP model deletes two dimensions in the metaoutline.
In OLAP models, the dimension IDs were not being saved properly causing multiple dimensions to be deleted. (31101)

Calc scripts defined at application level not available.  In the Essbase Application and Database dialog box, choosing an Essbase Application for which a calc script had been defined at the application level caused the incorrect message, "No Calc Script for this database."  (31285)

Messages missing from message.txt file.  In the message.txt file, two error messages were missing. (31691)

ESSCMD script cannot be run during data loads.  If I$ISHOME contained blank, the ESSCMD script could not be run during a data load.  (31916)

When attempting to run multiple ESSCMD scripts, only the last script runs.  If multiple ESSCMD scripts were created and then added to a member or data load, only the last ESSCMD script would run. (32015)

Job scheduler not working for daily member and data loads.  The Job Scheduler did not run scheduled daily member and data loads because the year was not retained correctly in the date.  (32016)

Incorrect character set for messages.  The character set for messages pointed to Japanese characters because of an error in the message file. (32627)

During dataload, error message is displayed indicating "Unable to allocate memory".  The message displayed despite adequate memory being available. (23487)

Formulas exceeding 240 characters in length are truncated.   Any formula greater than 240 characters in length was truncated causing all characters following the 240th to be eliminated. (26619)

Intelligent Help missing in Tools menu. There was no Intelligent Help in the Tools menu. (32631)

Essbase Integration Services does not load more than one SQL query at a time.  During dataloads in the metaoutline, only the data for the first SQL statement was loaded although the remaining SQL statements were sent to Oracle for execution. (33041)

OLAP Models do not save months as a sort order.  When a "Year_Quarter_Month" hierarchy was used in an OLAP model and a sort was performed on the month, the model would not save the member MonthMM as a sort item. (33054)
 


The following problems are fixed in FixPak 8.

(n/a) On Windows NT, after you apply Fixpak 8,  the Integration Services Desktop might return an error when you create the TBC sample database.  To work around the problem, select one of the following procedures: Then you can create TBC successfully using the Desktop. (5514)

(n/a) In MaxL, although the limit for stored calculations is 64 KB, calculation scripts created in MaxL that have multi-byte characters cannot exceed 40 KB. MaxL does not support outline synchronization in this FixPak.

(n/a) In the LRO example for DB2 OLAP Server Objects 7.1, the RetrieveLO method of dataserver control does not function properly.

(29210) When you attempt to kill a restructuring process, a "command not accepted" error is returned, and the restructure process is not terminated.

(16674) A formula calculated top down may not create all blocks when calculated. To correct, you can either set Create Blocks on Equation to ON, or run the calculation with update-calc off.

(18188) DB2 OLAP Server allows two instances of the an outline to be open at the same time by the same login ID. This means it is possible to have two versions of the same outline open at the same time. If you do this, each Save overwrites the changes of the other instance.  Therefore, this practice is not recommended.

(18529) In Excel, from the Query Designer, the server location radio button may not be active in the "Hyperion Essbase Query Designer Save As Query" window when you try to save a query. This occurs because a selected cell is in Edit mode.

(18745) If all the children of a dense parent are label only, you may not be able to make that parent label only. However, you can if the parent is sparse.

(19278) If a member name contains the ampersand (&), even if it is surrounded with quotation marks, and if the member name is in a calculation script, the script may fail validation if the user has Application Designer permission. DB2 OLAP Server incorrectly interprets the ampersand as the signal for a substitution variable. If you run the script without validation, it performs the calculation correctly. Users with supervisor privilege do not receive this validation error.

(19593) DB2 OLAP Server does not support discontinuous selection in Lotus, although it does in Excel.

(19614) For Lotus, after a calculation, the Controls on Calculation box may not be selectable.

(20451) DB2 OLAP Server does not warn you if you request that export results be placed in essbase/bin when there is an export results file with the same name already in that location.

(20488) If you create a dimension build rule that uses "Create Using Text" on the last column, and if the last true field in the input file is an "Alias" column that has some blank records, the text generated by the "Create Using Text" feature will not be placed into the last column, but will be placed in any record where the "Alias" column is blank. The rule, which passes validation, will fail during the build. To correct it, delimit the blank fields.

(20562) Long idle time with Spreadsheet Add-in may cause extra "Please Log In" messages. Click OK until the message stops appearing.

(20600) If you create a data file with blanks in the file name, such as My Documents, Essbase may display an error message. If you encounter this error, change the file name so that it contains no blanks.

(20606) When logged in with database designer privilege, the entire list of users is displayed in Security > Database, even though only the list of users that the database designer has privileges to modify should appear. Attempts to modify users for whom database designer should not have privileges will not be successful.

(21012) If you use Set Member Filter in EQD, any MBCS values may display as broken characters. Type the values into Notepad, and then copy and paste them over the broken characters.

(21300) Using the calculator hash table optimization to speed up calculations can negatively impact performance on some outlines.

(21332) @MOD may fail validation on the client but pass validation on the server. If your attempts to save an outline on the client fail, and the outline is associated with a calculation script containing @MOD, try saving it on the server.

(21616) Incompatibilities exist between the filtering feature in Microsoft Excel and the Spreadsheet Add-in.

(22235) Using Dynamic Time Series (DTS) members on a partitioned database may cause a server crash if ALL of the following criteria are true:

-Partitions are of the type Replicated or Transparent
-DTS member or members are on the target partition
-The Time dimension is sparse on the target partition and/or the source partition
Workaround: Remove the DTS members from the target partition.

If you have this situation there is another workaround:

-The outline has DTS members defined in Time dimension and
-The partition definition doesn't mention Time dimension, indicating it should include all members.
Then you should mention time dimension explicitly, for example,  Idesc("Time-dimension-name").
(22370) Running root.sh on Solaris to enable cache memory locking, which runs only under direct I/O, not buffered I/O, will disable SQL Interface. Workaround: run chmod 555 ESSSVR. SQL Interface works again, however, cache memory locking is disabled.

(22545) When compiling client API programs on NT, with MS VC ++ version 6.0 and higher, you may experience random API program crashes because when a workspace file is created a bug in MS VC++ causes the API program to crash.  Workaround: compile the program on the command line by using the compiler "cl" directly, after verifying that there are no problems with the API program itself.

(22636) @member does not validate on the client if it is used with a function. Syntax checking on the client fails; however, on the server it returns no errors.

(22678) Valid calculation scripts with a FIX command and nested parentheses within the FIX command may not validate in the Calc Script Editor of the Application Manager and may report spurious errors. The same script will run without problems on the server.

(22716) If a member name contains an embedded space, &, ? or ^, you may not be able to create a security filter for the member unless you surround the member name in quotation marks, such as "Year to Date."

(22782) If you edit a custom-defined function or macro, the application may shut down and restart. If you are creating a new custom-defined function or macro, consider clicking New instead of Edit.

(22784) You may not be able to delete a custom-defined macro or a custom-defined function using Application Manager if the name is longer than 59 characters.

(22847 closed) Lack of memory during database restructure may crash server. This is an HP issue. If you encounter a problem, use this setting: set _M_ARENA_OPTS 1:32.  Consult your HP documentation for more information.

(24037) Even though only one member of a dimension has an attached report, all the members in a dimension may be highlighted as if they had a report attached.

(24106) If you use the Query Designer to change members in a spreadsheet, then select a dimension and choose Essbase > Cascade, and then in the Destination Options tab, select the option "One Workbook, Separate Sheets," you may receive the Microsoft Visual C++ Runtime Library error:
Runtime Error! C:\Program Files\Microsoft Office\Office\Excel.exe....abnormal program termination! error.

(24981 closed) DB2 OLAP Server calculator functions that take strings as arguments (for example, @ISUDA, @UDA, @CONCATENATE, @SUBSTRING, @MATCH, @NAME) may not perform correctly if there is a member alias that is the same as the string. In this case, use the function @ALIAS, described in the Technical Reference.

(25511) Step 15 of "Preserving Formulas When Retrieving Data" in the Spreadsheet Add-In User's Guide is technically correct but somewhat confusing. It will be improved for a future release.

(25717) Using @ISIDESC in a dynamic calculation, that is nested inside a dynamic calculation with a two-pass calculation tag may cause OLAP Server to freeze.

(26130 closed) Calculator function @RANGE and the cross-dimensional operator (->) cannot be used inside a FIX/ENDFIX statement.

(26931) If, during outline revision, you delete a member with a particular alias name, and then create a new member with the same alias name, the alias will fail to register and DB2 OLAP Server creates the new member without an alias.  Workaround: Either delete the alias from the Outline Editor and save, or use a different alias name when revising.

(27034) Due to a Microsoft bug, you may not be able to display the Spreadsheet Add-in in IE 5.0 if you are running on operating system NT4.0. If you try to open an .xls file from IE 5.0 on NT4.0, the spreadsheet may open in a separate window.

(27370) The application view event log, when displayed via Application Manager, may incorrectly fail to show log entries because it evaluates "today" as GMT. To view log entries, select "All Dates."

(27417) If calculation times slow greatly from V1.1 to V7.1 FixPak 8, and your time dimension is dense, try changing it to sparse.

(27865) Running too many concurrent reports may overwhelm DB2 OLAP Server or operating system resources, especially against partitioned databases. If this occurs, the report processes do not ever finish.

(27927) Whenever one process is logged out by another process (such as Application Manager running on another machine), the process is logged off, and trying to access the server produces an error message even though Application Manager controls appear to still be active. Workaround: log in again.

(28064) Trying to associate an attribute with an implied shared member that has an implied shared child causes the association to be ignored, and DB2 OLAP Server writes a message to the application event log. An implied shared member is a member with only one child.

(28140) EssOtlQueryMembers: On UNIX, the currency conversion type returned is incorrect. Workaround: Use EssOtlFindMember instead.

(28208, 23213) When attempting to logout all users with Application Manager, the request is honored but additionally the user making the request is also disconnected. Workaround: Login again after such a request.

(28254) Excessively large outlines (greater than 400 Mb) may fail to open.

(28339) If you export an LRO attached to a shared member, then import it again, the LRO attaches to the original member (the member that actually stores the data referenced by the shared member), not the shared member.

(28506) When the installation program for SQL Interface asks you to specify a driver, if you specify MERANT, you won't be able to use DB2 Native drivers, and if you specify DB2 Native drivers, you won't be able to use Merant drivers.

(28507) Some characters, such as those using umlaut or accent marks, cannot be typed in ESSCMD interactive mode.

(28646) If a supervisor logs out a Spreadsheet Add-In user, and that user performs a drill-down, they will not see any error, but the retrieval will be empty. If they try to reconnect to server, then they will see a dialog box informing them of disconnect, and if they click OK the log in dialog screen appears.

(29311) If you have created the sample application Demo without direct IO, then add the direct IO configuration parameter to essbase.cfg (DIRECTIO TRUE), you may not be able to start the Demo application.

Viewing certain application logs crashes the server. (22465)
When an application log contains information starting with a bracket, viewing that log may cause the OLAP Server to crash.

When using @ISMBR(@ATTRIBUTE) with a Two-Pass Calc member in an IF statement, calculation results are inconsistent. (24102)
If the Two-Pass Calc member formula has IF without the matching ELSE, the attribute calculation on that member may return inconsistent results. The bug is that values calculated on members which match the IF condition may be carried over to members that do not match the IF condition.

Calc script crashes with "Unable to Allocate Memory" messages. (24553)
Some calc scripts return the error message "Unable to Reallocate Memory for [] in []. Refer to the Application Log for details" and may also crash the application.

SHUTDOWNSERVER command intermittently hangs the OLAP Server. (25204)
If you issue the SHUTDOWNSERVER command (ESSCMD) at the same time a user is starting an application, both ESSCMD and the OLAP Server may hang intermittently.

EQD queries return "command too long" errors. (26462)
Long Essbase Query Designer (EQD) queries may return the following error messages:

Network timeout errors during new logon requests. (26536)
When processing a large number of logon requests at one moment, Essbase may fail to process some of the logons and may display network timeout errors because of overloaded Essbase and TCP/IP resources.

Essbase Query Designer (EQD) does not provide a visual focus indicator. (27132)
When you open EQD, the focus is shown on "book1" but the keyboard is unresponsive. Focus is now set properly on the tree view.

Outline members in Member Selection dialog box are invisible. (27154)
When the Windows appearance scheme is High Contrast Black, outline members are invisible in the Member Selection dialog box in the Spreadsheet Add-in.

Search in Report Editor finds all Kanji characters for one double-byte search. (28436)
In Report Editor in Application Manager, when you do a search for one double-byte character in a report that contains double-byte Kanji characters, the search finds all the double-byte characters in the script. However, the search works properly when the search string has more than 3 bytes.

Attribute calculation results may be incorrect. (28907)
When a spreadsheet retrieval includes only the upper-level member from an attribute dimension, and the base dimension has Dynamic Calc members, the attribute calculation result may be incorrect.

Change in persistence of Allow Connects setting. (28929)
Disabling connections in the application settings (Allow Connects option) is now persistent (i.e., is no longer session-dependent). If an administrator disables connections for databases in an application, connections remain disabled until re-enabled by the administrator, using the application settings. Note, however, that the Allow Updates and Allow Commands settings are still session-dependent. More info ...

Formula preservation is not working. (29140)
When "Preserve Formulas" is selected in the Spreadsheet Add-in (Essbase > Options > Mode tab under Formula Preservation), and you retrieve in a spreadsheet that contains formulas, some formulas may not be preserved.

Drilling down on a member in a spreadsheet may cause the error "Maximum number of columns exceeded". (29142)
When you drill down in a spreadsheet on a member that should not return more than 256 columns, Essbase may display the following error message: "Maximum number of columns [256] exceeded [312]"

Cannot insert column(s) after a drill-down in spreadsheet. (29178)
After drilling down in a spreadsheet and then attempting to insert a column, the following error message is returned:

"To prevent possible loss of data ... move the data to a new location and try again"
Esb/EssOtlRenameMember fails when member has more than one shared member. (29288)
The Esb/EssOtlRenameMember Outline API functions intermittently fail when the member to rename has more than one shared member.

Applications that contain LROs and have Direct I/O enabled may fail to start. (29311)
If an application contains Linked Reporting Objects (LROs), and the essbase.cfg file for the server includes the DIRECTIO TRUE setting, the application does not start.

Attribute member and shared member in spreadsheet return incorrect values. (29425, 29503)
When an attribute member and a shared member are present in a spreadsheet, and the shared member is part of an outline that contains two or more levels of shared members, incorrect values may be returned after retrieval.

Attribute drill-down retrieves only partial base member list. (29436)
When drilling down on a level 0 attribute member in a spreadsheet to retrieve a list of base dimension members associated with that attribute, the retrieval returns only a partial member list.

LROs not listed correctly after dimension build. (29531)
When more than two linked reporting objects (LROs) are assigned to the same cell, and a dimension build deletes two of these members (using "remove unspecified" option), attempting to view the remaining LROs via the Linked Objects Browser results in a network error and exception file.

Retrieving in certain spreadsheets crashes server. (29630)
When a spreadsheet has members from different dimensions in the same column in the row header, retrieving in the sheet may crash the OLAP Server. Essbase should detect that this is an invalid grid and should return an error instead.

Spreadsheet retrieval from transparent partition may crash application. (29808)
When a spreadsheet contains repeated members, and at least one of the repeated members has a formula and is part of a transparent partition, the Essbase application may crash when you attempt a retrieval.

The EssOtlQueryMembersEx Outline API function returns incorrect results. (29817)
The EssOtlQueryMembersEx Outline API function does not return all correct members.

LINK report command returns incomplete member set. (29890)
The report command <LINK does not return all the members it should if the result of the command needs to be ordered by alias names.

Replicated partitions may fail to send data. (29912)
When running a script that clears, loads, and calculates the source, and replicates data from the source to the target, Essbase may fail to replicate data.

The Essbase Agent may crash when login or logout requests are issued from clients. (30084)
Under certain conditions, the Essbase agent may crash when login or logout requests are issued from clients. Those conditions are as follows:

Memory leak when running sequence of queries. (30380)
Running a series of queries against Essbase results in a memory leak.

Multiple simultaneous calcs hang or crash the OLAP Server. (30421, 30499)
Multiple simultaneous calculations may hang or crash the OLAP Server.

Spreadsheet retrieval involving formulas with sparse Dynamic Calc members may crash OLAP Server. (30514)
A spreadsheet retrieval that includes a member with a formula referencing a sparse Dynamic Calc member may crash the OLAP Server.

Error produced when starting Essbase with -secure option. (30604, 16856, 17954)
When starting Essbase with the -security option, the following error messages are generated:

Cannot get terminal ioCannot set terminal io********Cannot restore terminal io
Essbase may terminate queries or calculations involving several formula execution levels. (30643, 30228)
When Essbase is processing queries or calculations involving several formula execution levels, it may terminate the operation with the error message "Error executing formula ... Recursion limit [31] reached". Multiple formula execution levels may be needed when formulas on dense Dynamic Calc members refer to several sparse members.

Retrieving from a database with many Dynamic Calc members may use much more memory than expected. (30707, 30825)
A retrieval from a database with many Dynamic Calc members may cause Essbase to use much more memory than expected.

Attribute retrieval with Two-Pass Calc member doubles value. (30796)
When an attribute member and a Two-Pass Calc member are present in a spreadsheet, and the upper level members in the base dimension are shared members, a retrieval returns incorrect values (double what the result should be).

Attribute retrieval rolls up incorrect values unless all children are present in retrieval. (30868)
Retrieving attribute members in a spreadsheet when all children of the member are not yet present in the sheet returns incorrect values. This problem occurs when upper level members in the base dimension are shared members.

EIS not listed in component list when valid license is used to install. (30940, 30941)
After installing Essbase Release 6.2 with a license key that includes Essbase Integration Services (EIS), EIS is not listed as a component, either on the install screen "list of options to install" or within Application Manager. However, EIS is installed and works properly.

Partition definition that validates in Essbase Release 6.1.4 does not validate in Release 6.2. (30989)
A partition definition containing the @Match command that validates in Essbase Release 6.1.4 returns the following error and does not validate in Release 6.2.

"Partition definition for slice [1] does not parse"
Users unable to view list of other users in their groups. (31001)
Starting with Essbase Release 6.2 (contrary to prior releases), users with sufficient permissions are unable to view a list of other users in their group. This problem is causing Hyperion Enterprise Reporting to function improperly.

Long filenames error when loading data from client file. (31004, 30257, 30764)
When loading a data file from a client machine using a long pathname, an error is returned saying that long filenames are not supported.

Dataload that worked properly in Release 6.1.x fails with Release 6.2. (31523, 31411)
A dataload that worked properly in Release 6.1.x fails with Release 6.2 due to a memory over-usage issue.


The following problems are fixed in FixPak 7.

Formulas containing the @PARENT or @ANCEST functions with two parameters may generate syntax errors. (20851, R614)
@PARENT and @ANCEST functions work as expected only if the first argument is a member of the first dimension in the outline. If you request a second parameter that is not from the first dimension in the outline, DB2 OLAP Server may display formula syntax errors such as: "Error: Invalid number of parameters for this function."

Incorrect results from the member formula A=B/-C. (21993, R614)
When DB2 OLAP Server calculates the member formula A=B/-C, it may multiply B and -C instead of dividing B by -C.

Increase in retrieval times between 5.0.2p13 and 6.1.0p3a. (22494, R614)
Retrievals from the same spreadsheet view may take longer on 6.1.0p3a than they do on 5.0.2p13.

A Partition validates in 5.0.2p13 but does not validate in 6.1.0. (23360, 26108, R614)
When you validate a correctly defined partition in 6.1.0, the following error may be returned: "Cell count mismatch: area for slice [1] members per dimension." The same partition validates without errors on 5.0.2p13.

ESSCMD scripts that contain ENABLELOGIN/DISABLELOGIN commands prevent subsequent scripts from processing. (23763, 26101, R614)
When an Esscmd script contains the ENABLELOGIN/DISABLELOGIN commands, actions specified in the script are processed, but the Esscmd process may be left running; therefore, if another script is scheduled to run after it, the second script will not be started.

Selecting a linked partition in the Linked Object Browser brings up a blank spreadsheet. (23921, 26098, R614)
After you select a linked partition from the Linked Objects Browser, Essbase may display an empty spreadsheet that is not connected to the source database.

Running a calculation that uses the @XREF function may crash the application. (24198, R614)
While running a calculation that uses the @XREF function, the Essbase application may crash.

Certain spreadsheet retrievals cause application errors. (24413, 26102, R614)
Certain spreadsheet retrievals containing member formulas and dynamic calcs may cause application errors and crashes.

The @CALCMODE function causes application crash during a calculation on Microsoft Windows 2000. (24745, R614)
On Microsoft Windows 2000, when you run a calculation that uses the @CALCMODE function, the OLAP application may crash and Essbase may create an .xcp log.

Retrieval from a partitioned database may cause the OLAP application to crash. (25091, R614)
A retrieval from the target of a transparent partition may cause the OLAP application to crash if the spreadsheet includes a sparse dynamic calc member that has a self referencing member formula.

Error when drilling down in a spreadsheet if the outline has two or more attribute dimensions. (25212, 26104, R614)
Drilling down in a spreadsheet that is connected to an outline with two or more attribute dimensions may cause Essbase to display an attribute dimension in the wrong position and to display the error message "currently, multiple reports per retrieval is not supported."

Error when validating a correctly defined partition if a previous validation attempt resulted in an error. (25215, R614)
When validating a correctly defined partition definition, DB2 OLAP Server may display the following error message: "Unable to open file (C:\Docume\Admini\Locals\Temp\Ess00000.tmp)." This occurs after the following sequence of events:

Certain retrievals may hang the OLAP server. (25717, 26110, R614)
When sparse dynamic calc members are tagged as two pass, retrievals that include those members may hang the OLAP server component.

Data retrieval times may be much longer on Version 7 FixPak 4 (and later) than on Version 1.1. (25735, R614)
On outlines that contain many dense dynamic calcs, spreadsheet retrievals that take a few minutes on Version 1.1  may take several hours on Version 7, FixPak 4 and later.

A temporary Excel book file is not erased after the Spreadsheet Add-in is closed. (25764, R614)
When the Essbase Cascade feature is used to create multiple worksheets with the Spreadsheet Add-in, a temporary Excel book file remains after the Add-in is closed.

"Retrieve and Lock" incorrectly displays non-missing data as #Missing. (26105, 25214, R614)
When a retrieval contains errors and "Retrieve and Lock" is selected from the Essbase drop down menu in the Excel Add-in, DB2 OLAP Server may display #Missing in non-missing data cells.

A report takes 24 hours to run after adding an attribute dimension to the outline. (26451, R614)
When the outline is modified to add an attribute dimension with one attribute, a report that previously took only 4 minutes to run now takes 24 hours to run. The attributes are not being referenced at all in the report script.

The Essbase agent and clients may hang after repeated unsuccessful attempts to load applications. (26726, 24506, R614)
After repeated unsuccessful attempts to load applications, and when the number of file descriptors is too low, the Essbase agent may display the error "Network error [24]" repeatedly until the Essbase agent and clients hang.

DB2 OLAP Server may skip some disk drives specified in the DISKVOLUME settings. (26808, R614)
If Essbase is using buffered I/O, it may not use the order specified in the DISKVOLUME settings when spanning disk drives.

Certain calculations take much longer to run in Version 7 FixPak 4 (and later) compared to Version 1.1. (26932, R614)
Some calculation times may be much longer on Version 4 FixPak 4 and later than on Version 1.1.

Updating a database after a database copy may cause an application crash. (26984, R614)
An application may crash with the error message "1080021 (Invalid transaction handle [0x120017] passed to the Storage Manager for database [V_ini])" after the following sequence of events:

When two different types of LROs are added to the same cell in a spreadsheet, the LRO style is not applied to the cell. (27168, R614)
When two LROs of different types are added to the same data cell, and the data cell contains #Missing, selecting Linked Objects on the Essbase Options>Style tab, does not result in the LRO style being applied to the cell.

Essbase completes the processing of a dimension build with 100 attribute dimensions, but it does not allow the resulting outline to be saved. (27424, R614)
After completing a dimension build with 100 attribute dimensions, DB2 OLAP Server fails to save the resulting outline. It displays the error message "Unable to read information from [ARBORPATH\App\AppName\DbName\DbName.otn]" and and the outline is not saved.

The PATH statement may be invalid after the Spreadsheet Add-in is installed. (27523, 27916, R614)
If the last character is the PATH statement is a space, the PATH may become invalid when the Spreadsheet Add-in is installed.

DB2 OLAP Server incorrectly interprets certain distinct Japanese characters as the same character. (27568, R614)
DB2 OLAP Server may fail to recognize that certain Japanese characters are different, resulting in error messages during some operations. For example, when two distinct characters are added as member aliases, DB2 OLAP Server may return the error "Record #1 - Alias already used as a member name (3314)."

OLAP Server may crash during calculation that includes the @WITHATTR function. (27572, 23691, R614)
When a calculation includes the @WITHATTR function and specifies the "IN" operator, the calculation may cause the OLAP Server to crash.

EsbQueryDatabaseMembers does not display alias names for shared members. (27667, R614)
The EsbQueryDatabaseMembers VB API function does not display alias names for shared members.

Creating many LROs and then listing them using the API or ESSCMD causes the application server to crash. (27698, R614)
Creating 84 LROs and using EssLROListObjects or ESSCMD to list all of the LROs in the database may crash the application server.

MaxL may fail to build a partition correctly. (27700, R614)
When you build a partition using MaxL, the partition validation may fail with the error "area 1 overlaps area 2." When you build an identical partition using the Application Manager, it validates without errors.

Memory leak while running a recursive retrieval macro. (27779, 28142, 26730, R614)
Memory usage steadily increases during a recursive retrieval macro. After about 150 retrievals, the application may crash with the error "unable to allocate aligned memory."

Access violation error when using EssGPerformOperation. (27844, 28314, R614)
When using the EssGPerformOperation Grid API function within the EssBeginDrillOrLink function, an access violation error is returned.

Results of a report script that uses D-T-S are incorrect. (27848, R614)
Report may contain incorrect data values when the report script uses dynamic time series (D-T-S) members.

Retrieving data from a large outline with attribute dimensions may crash the database. (27851, 27494, R614)
Retrieving data from a large outline with attributes may crash the database when the spreadsheet retrieval includes attribute dimensions and a two pass calc member with a cross dimensional dependency. When the spreadsheet retrieval does not include the attributes, retrieving from the same outline does not cause a crash.

A dimension build may corrupt the Essbase outline if the "EVENT 29" parameter is in the .cfg file. (27991, 22819, R614)
If the "EVENT 29" parameter is in the Essbase .cfg file, a dimension build may corrupt the outline.

DB2 OLAP Server may not release memory after a retrieval. (27992, 27365, R614)
In certain cases, DB2 OLAP Server allocates a large amount of memory for a retrieval and it may not release the allocated memory after the retrieval is finished. The OLAP application must be unloaded and reloaded to free the memory.

Limit of 512 applications per OLAP server. (28061, R614)
The limit of 512 applications per OLAP server has been lifted in FixPak 7.

Certain retrievals may incorrectly report #Missing values. (28084, 28076, R614)
When all of the following conditions are met, retrievals incorrectly result in #Missing values:

DB2 OLAP Server incorrectly displays an error message when @LEVMBRS is used to create a partition. (28114, R614)
When @LEVMBRS is used to create a partition, DB2 OLAP Server may incorrectly display the error "cell count mismatch in area ( )" when the partition is validated.

DB2 OLAP Server incorrectly displays an error message when @UDA is used to create a partition. (28115, R614)
When the @UDA function is used to create a partition, DB2 OLAP Server may incorrectly display the error "cell count mismatch in area ( )" when the partition is validated.

The EnableLogin Esscmd script fails periodically with errors 1054021 and 1019031. (28138, 17980, R614)
The EnableLogin Esscmd, when it is part of an Esscmd script, may fail periodically with errors "1054021 cannot modify settings for application" and "1019031 Unable to write to [c:\ARBBORPATH\APP\AppName\AppName.app]; database is in read only mode for backup." The second error is displayed even when the database should not be in read only mode.

A report displays the alias on the first member of a dimension, but it does not display the aliases on the other members of that dimension. (28144, 27099, R614)
After running a report script, only the alias on the first member of the dimension is displayed in the report. The aliases on subsequent members are not displayed.

EssGConnect may not return ESS_STS_CANCEL when it should. (28188, R614)
The EssGConnect Grid API function does not return the value of ESS_STS_CANCEL if you press the Cancel button or the Esc key in the Essbase System Login dialog box. An error value is returned instead.

A dimension build that associates attributes may corrupt aliases on other attributes. (28447, R614)
Aliases on existing attributes may be corrupt after a dimension build that associates attributes.

Large spreadsheet retrieval from a partitioned database with attributes crashes the application. (28489, R614)
The Essbase application may crash during a large spreadsheet retrieval when the database is the target of a transparent partition and the outline contains attributes.

Outline API functions may fail on Windows 95. (28614, 24218, R614)
On Microsoft Windows 95, when you use Outline API functions, the function may fail and Essbase may display the error message: "1060044 cannot create temporary file name."

Results of some queries that include dynamic calcs and certain functions may not be correct. (28621, 26809, R614)
When dynamic calc formulas involve certain functions, such as @CURRMBR, @PARENT, @SPARENT, @ANCEST, @SANCEST, results from queries that reference those formulas may not be correct because some dynamic calcs may not be triggered properly.

Dimension build may crash the OLAP server if set ESSLANG=Japanese_Japan.MS932@binary. (28651, 28553, R614)
The OLAP server may crash during a dimension build if
set ESSLANG =Japanese_Japan.MS932@binary.

Formulas that reference dynamic calcs and contain cross dimensional operators may produce incorrect results. (28838, 24117, R614)
When a formula references one or more dynamic calcs and contains one or more cross dimensional operators, results may be incorrect. The fix for this problem requires that you have the following entry in your essbase.cfg file: EVENT 28.

Deleting members from an outline may produce an internal logic error. (28883, 27225, R614)
Deleting members from an outline and saving the changes may cause Essbase to display the following error: "internal logic error 1178."

Undefined symbols adBarrGet and adGetStat when linking with libesssql on Solaris. (29007, R614)
When linking a program with with libesssql on Solaris, the compiler may give one or both of the following errors:

The MaxL Shell (essmsh) may crash when executing lengthy MaxL statements. (29031, R614)
When executing MaxL statements longer than approximately 20k, the MaxL Shell (essmsh) may crash.

The OLAP server may hang when you run EssGetApplicationInfoEx. (29064, R614)
The Essbase OLAP Server may hang when you run the EssGetApplicationInfoEx() API function before using the CREATEAPP or COPYAPP Esscmds.

Essbase attempts to bind a port that is out of the allowed range when it runs out of available ports within this range. (29294, R614)
When Essbase runs out of available network ports within the allowed range of 32768 to 33678 (incremented by 5), it may attempt to bind a port outside of this range, resulting in the following error message: "Error(1042010) Network Error [125]: Unable to Bind Host Server Socket On Port [0]." Essbase should not attempt to bind the unavailable port.

Spreadsheet retrievals from a database that is the target of a transparent partition may cause the Essbase application to crash. (29533, 29483, 28548)
When retrieving data from the target of a transparent partition, the Essbase application may crash and an .xcp log may be created.

Memory leak during some spreadsheet retrievals. (29565)
During spreadsheet retrievals, the esssvr process may fail to release memory after the retrievals have completed. The OLAP server may run out of memory after running successive retrievals.


FixPak 6 contains all the fixes from FixPak 5, but no additional fixes.  FixPak 6 introduces an early version of a new feature called DB2 OLAP Server Miner, and FixPak 7 enhances it.  See Introducing DB2 OLAP Server Miner with enhanced LRO support for more information about what OLAP Miner can do for you.


The following problems are fixed in FixPak 5.

A report takes 24 hours to run after adding an attribute dimension to the outline. (23423, P3A)
When the outline is modified to add an attribute dimension with one attribute, a report that previously took only 4 minutes to run now takes 24 hours to run. The attributes are not being referenced at all in the report script.

When using cache memory locking on Solaris, the warning #1008133 appears: "Unable to allocate memory, permission denied." (24604, P3A)
The root.sh file distributed with Hyperion Essbase OLAP Server for Solaris is incorrect and does not provide adequate access to use cache memory locking. With this fix, the root.sh is corrected.

In Hyperion Essbase Spreadsheet Add-in for Excel, the "Retain on Keep and Remove Only" and "Retain on Zooms" options do not work. (24910, P3A)
The Formula Preservation options on the Mode tab of the Hyperion Essbase Spreadsheet Add-in for Excel Options dialog box are not working. If you select "Retain on Keep and Remove Only," the formula is not preserved after removing the members. If you select "Retain on Zooms," the formula does not jump down to the proper member when zooming. If you select "Retain on Zooms, with Formula Fill," the formula is not properly replicated to the child members.

Using SSAUDITR in the Essbase.CFG file causes long update times if dynamically calculated cells are present in the update. (25402, P3A)
When an Essbase audit file is associated with an application to track updates, any write operation from the Spreadsheet Add-in to the server takes an extremely long time. For example, an update that takes 45 seconds without an audit log may take 16 to 45 minutes with an audit file. This occurs when dynamically calculated cells are included in the group of cells being sent to the server.

The Hyperion Essbase API does not properly support cancelling retrievals. (25411, P3A)
CancelRetrieve does not call the user-defined cancel retrieve callback function when the user attempts to cancel a retrieval.

The @IRR Calculator function returns 15% when all values are zero. (26388, 23884, P3A)
If a range of values is all set to zero, when using the @IRR function on this range, the result is 15%. With this bug fix, to indicate that @IRR on a range of zero values is ambiguous, the function will now return #Missing.

Data load into the target partition does not work. (26686, P3A)
Loading data into the target when the final location for the data is in a source does not work in some circumstances. The server indicates that data successfully loaded, but no data was actually sent to the source.

Saving the modified outline of a Source database in a Transparent Partition crashes the application. (26798, P3A)
When using Transparent Partitions, if you save the modified outline of the Source database, the application crashes. This behavior occurs only when adding a group of shared children members to each of the new members.

In Hyperion Essbase Spreadsheet Add-in for Excel, locking and sending a zero value to the database does not update the database. (26805, P3A)
If you lock and send a zero value to the database, the database is not correctly updated to reflect the zero value. Other values sent to the database are correctly updated, however.

If you repeatedly do dimension-build and delete-member operations, the system may run out of memory. (26852, 25205, P3A)
On HP-UX 11.00, if you perform a dimension build operation, then manually edit the outline and delete all children in a dimension, then repeat the dimension build operation, memory utilization will consistently grow.

Certain formulas on two-pass calculation members cause the server to crash when retrieving with an attribute member. (26865, P3A)
When querying on attributes, if one or more members in the attribute query is tagged as two-pass calculation, and the formula involves one or more of the following functions -- @CURRMBR, @(S)PARENT, @(S)ANCEST, @(S)(MD)PARENTVAL, or @(S)(MD)ANCESTVAL -- the server crashes. With this bug fix, the formula is ignored during an attribute calculation. This is an Essbase limitation.

Memory is not regained by the operating system after running a long calculation and then exiting from Hyperion Essbase Application Manager, resulting in a system crash. (26898, P3A)
When a calculation runs for longer than 15 minutes, memory resources gradually diminish until eventually the operating system crashes. This occurs with Windows 95 or on Windows NT/2000 systems with low memory.

When drilling in on attribute members, the result may be displayed incorrectly. (26930, P3A)
When drilling in from upper-level attribute members, the retrieval results are placed in the wrong position. This occurs when attribute members from different levels appear in the same report.

When retrieving data into the target of a transparent partition, where the target database contains an attribute dimension, the data fails to come across to the target, and an error appears after a zoom in. (26978, 24256, P3A)
The following sequence of events causes a data retrieval to the target to fail: - Add an attribute dimension to an outline - Associate the attributes with a dimension - Create a transparent partition - Make sure the attribute dimension is mapped to void - Validate the partition - Load data into the source cube and run a default calculation - Retrieve from the target

Additionally, if you zoom in on an unrelated dimension, you see error #1023046: "Incorrect number of dimensions in request from remote site 6 sent 5 required." To get the correct result, you need to map all the attribute calculation members and the attribute dimension to void. This will solve the problem if the source database and the target database are under different applications. If the two database are created within one application, then you need to add "EVENT 5" to your essbase.cfg file.

Using the lev0 function the retrieval results are erroneous. (9340, P3)
In Hyperion Essbase Spreadsheet Add-in, if you attempt to retrieve all level 0 members using the lev0 function, the Retrieve option may not return data for the level 0 members but instead considers all members at the same generation as the first level 0 member and then retrieves their data.

If you have filtered access to a linked partition database, then you may encounter a server crash while launching the partition. (13907, P3)
If you have Read-only privilege to a filter on a linked partition database, attempting to launch the partition may result in an exception file and a server crash.

Attempting to validate a linked partition fails. (19115, P3)
If you create a linked partition database and map the source outline to the target outline, attempting to validate the partition may generate the error message, "Target dimension count mismatches in Area One."

When you perform a default calculation containing FIX( @IDESCENDANTS(COMPANY,-1)), the database restructure fails. (19284, P3)
When you are performing default calculation containing FIX( @IDESCENDANTS(COMPANY,-1)) for a database, the settings in the Set Default Calc dialog box may change from the Use Calc Script Object option to the Use String option, and the statement FIX(@IDESCENDANTS(COMPANY, -1) may be truncated. As a result, your attempt to perform a database restructure may fail.

If dimension names are similar but not duplicate, the Essbase Member Selection dialog box displays an incorrect dimension. (19413, P3)
If an outline has similar dimension names, the Essbase Member Selection dialog box may ignore the dimension that is selected on a spreadsheet and display an incorrect dimension and its members.

In Hyperion Essbase OLAP Server, the Agent messages are mistranslated. (19476, 19937, P3)
In Hyperion Essbase OLAP Server, the following messages may be mistranslated: "port," "ports available," "connections in use," and "ports in use."

The Linked Objects Browser dialog box does not display the scroll bar. (19500, P3)
When you open the Linked Objects Browser dialog box, the scroll bar may not be visible at the bottom of the dialog box. The scroll bar may be displayed when you enlarge the dialog box or try to resize the columns.

In Hyperion Essbase Spreadsheet Add-in for Lotus 1-2-3, the context-sensitive help is mistranslated. (19508, P3)
In Hyperion Essbase Spreadsheet Add-in for Lotus 1-2-3, the context-sensitive helps may not be translated.

The default query name is not translated in the Hyperion Essbase Query Designer dialog box. (19510, P3)
In the Hyperion Essbase Query Designer dialog box of Hyperion Essbase Spreadsheet Add-in for Excel, the default name assigned to a new query may not be translated.

In the Hyperion Essbase Query Designer dialog box, the drop-down list box name is truncated. (19532, P3)
In the Hyperion Essbase Query Designer dialog box, the Data Sort panel drop-down list box name, Ordering, may be truncated. The problem may be noticeable in non-English versions of Hyperion Essbase Spreadsheet Add-in.

The short cut key to select Enable Secondary Button does not function properly. (19595, P3)
In Hyperion Essbase Spreadsheet Add-in, in the Global tab section of the Essbase Options dialog box, the short cut key for selecting Enable Secondary Button fails.

After retrieving data for a new query, the mouse pointer does not change back to an arrow. (19697, P3)
In Hyperion Essbase Spreadsheet Add-in for Lotus 1-2-3, after retrieving data for a new query in the Hyperion Essbase Query Designer dialog box, the mouse pointer may not change back to an arrow.

F1 key does not consistently display help in Hyperion Essbase Spreadsheet Add-in. (19918, P3)
In Hyperion Essbase Spreadsheet Add-in, the F1 key does not consistently display Essbase Help.

In non-English versions of Hyperion Essbase OLAP Server, while initializing Essbase.exe, the server requires the English characters. (19988, P3)
In non-English versions of Hyperion Essbase OLAP Server, such as on German NT, while initializing Essbase.exe, the confirmation message accepts the English alphabet "Y" instead of a language-independent value.

The Find option in the Edit menu of the Member Selection dialog box does not function properly. (20266, P3)
In Hyperion Essbase Spreadsheet Add-in, when you use the Find option to locate a value for a member that is selected in the Member Selection dialog box and using a Windows Server, the Find option may search for the value incorrectly.

Cannot delete the Server log if the Application Server is running on Windows 95/98. (20630, P3)
In Hyperion Essbase Application Manager, You cannot delete the Server log if the Application Server is running on Windows 95/98.

Attempting to rename a Boolean attribute member corrupts the outline. (20901, P3)
In Hyperion Essbase Application Manager, if you attempt to rename a Boolean attribute member directly on the outline and then enter the changes in the Boolean Member Names fields of the Attribute Member Names dialog box, when you reopen the outline, you may find the outline is corrupted.

If a dimension consists of more than 32 members with a single non-consolidated child, the attribute association with that dimension is erroneous. (21933, 23982, 25014 P3)
If there are more than 32 members in one dimension, and that dimension contains a parent with exactly one child that does not consolidate to its parent, an attempt to associate attributes to that dimension may result in a corrupt outline, with no error message.

Attribute query with sparse Two-Pass calculation members returns incorrect values. (22752, P3)
If the attribute query contains a sparse Two-Pass Dynamic Calc member, and the calculation formula refers to some blocks that are not included in the query, the result of the attribute query may not include the missing blocks.

The retrieval time increases compared to the previous releases of Hyperion Essbase OLAP Server. (22836, 24397 P3)
When retrieving data on a large number of sparse member combinations, the retrieval process is slower than the previous releases of Hyperion Essbase OLAP Server.

Calculation script does not set cells to #MISSING. (22961, 25168 P3)
In a calculation script, if a formula on a sparse member results in #MISSING, cells may not be updated.

While importing an outline from a rules file, you receive a segmentation fault. (23115, P3)
In MaxL, while importing an outline from a rules file, you may notice a segmentation fault.

The application crashes while retrieving data on an attribute dimension. (23211, P3)
In Hyperion Essbase Spreadsheet Add-in, an attempt to retrieve data on an attribute dimension may crash the application.

On UNIX, you cannot run the Grid API with more than 16383 rows, but on Windows NT, you can run more than 65000 rows. (23520, P3)
On the UNIX platform, when you are using the Grid API function, EssGlnit with the number of rows larger than 16383, the Grid API program returns an error code.

The "Allow" settings may fail if a supervisor attempts to log in. (23657, P3)
If you disallow commands, connects, or updates through Application Manager in the Application Settings dialog box, through the SETAPPSTATE command in Esscmd, or using the "alter application" command in MaxL, the settings may change if another supervisor simultaneously attempts to log in.

Shared members of a sparse Dynamic Calc member are not aggregated. (23865, P3)
Batch calculations involving shared members that are shared members of sparse Dynamic Calc members may produce incorrect results.

An EQD (Essbase Query Designer) query for more than 65536 rows crashes a spreadsheet. (23871, P3)
Using Hyperion Essbase Query Designer, attempting to create queries for more than the limit of 65536 rows crashes the spreadsheet.

When attribute dimensions are added, calculations are performed incorrectly during data retrieval. (23881, P3)
In Hyperion Essbase Spreadsheet Add-in or Report Writer, when attribute dimensions are added, calculations may be performed incorrectly on Two-Pass member formulas during data retrieval.

Queries involving attributes and Two-Pass calculation members may sometimes yield incorrect results. (23903, P3)
If a query involving attributes references a Two-Pass member and that two-pass member is dependent in turn on other two pass member(s) the query results may sometimes be incorrect.

The Visual Basic API function, EsbGetApplicationInfoEx, returns incorrect number of users connected. (23911, P3)
Although the user is connected to an application and a database, the Visual Basic API function, EsbGetApplicationInfoEx, may return zero users connected with no error code.

When performing a replicated partition on a large amount of data, an exception file is generated. (24051, P3)
In Hyperion Essbase Application Manager, when you perform a replicated partition on a large amount of data, the replicated partition may fail, resulting in a network error and an exception file.

The Visual Basic API function, EsbLROAddObject(), generates an application error. (24116, P3)
When the Visual Basic Main API function, EsbLROAddObject, is applied to associate linked reporting objects to a cell, the error message, "Cell: EXCEL.EXE - Application Error" may occur.

In an outline, the dimension order affects XREF results. (24281, P3)
XREF may return incorrect results if the dimension order in the source cube differs from the dimension order in the target cube.

Calculation never finishes across a transparent partition database. (24292, P3)
Transparent partitions may cause the database calculation to run infinitely.

Retrieving data on a spreadsheet containing a generation name produces an exception log and crashes the application. (24384, P3)
If you attempt to retrieve data on a spreadsheet containing a generation name, you may encounter an exception log and application crash.

While loading data, if the data file consists of attribute members, some data are skipped. (24477, P3)
While loading data, if the data file consists of attribute members, Hyperion Essbase OLAP Server may skip the remaining records after the first attribute member.

Using the Grid API function, BeginConditionalZoomIn, with the report specification, {UCHARACTERS}, causes a crash. (24521, P3)
If using the BeginConditionalZoomin function with the report specification, {UCHARACTERS}, results in an underlined character string longer than 127 characters, the Grid API program may crash.

During multiple bitmap mode calculation, excessive memory is allocated. (24552, P3)
When there are many shared members in the last sparse dimension, multiple bitmap mode calculation may use too much memory. Set the configuration parameter MultipleBitmapMemCheck to TRUE to prevent the excessive use of memory.

Attempting to validate an outline while performing incremental building generates an error message. (24557, P3)
While performing incremental dimension building, if you try to validate the outline, the incremental dimension building process fails and generates an error message.

If a query involving too many dynamic calculations with complex formulas fails to execute because of insufficient memory on the server, the application crashes instead of the query failing. (24669, P3)
If a query involving too many dynamic calculations with complex formulas fails to execute because of insufficient memory on the server, the application crashes instead of the query failing.

An attribute calculation with Two-Pass calculation returns inconsistent results. (24786, P3)
If you attempt to perform attribute calculations with Two-Pass calculation repeatedly, you may encounter inconsistent results.

Programs with multiple calls to EsbOtlGetAssociatedAttributes and EsbOtlGetMemberInfo result in a crash. (24807, P3)
Using the Visual Basic Main API functions, EsbOtlGetAssociatedAttributes and EsbOtlGetMemberInfo repeatedly may crash the Visual Basic program.

Registering more than 20,000 Essbase users to Hyperion Essbase OLAP Server gives fatal error when restarting. (24875, P3)
After registering 20,000 users to Hyperion Essbase OLAP Server, if you terminate Essbase and then restart, you may encounter the error message, "Fatal Error: Error reading security file [22]."

Retrieving data on a blank cell results in an application crash. (24895, P3)
If you try to retrieve data on a blank cell, the application may crash with an exception file.

In Hyperion Essbase Application Manager Japanese version, the Dynamic Time Series (DTS) settings cannot be saved. (24905, P3)
Hyperion Essbase Application Manager Japanese version may not retain the DTS settings.

While retrieving data on sparse dynamic calculation members, you may receive incorrect results. (24976, P3)
If the formula is executed in a cell mode, attempting to retrieve data on sparse dynamic calculation members may result in incorrect #MISSING values.

The Grid API function, EssGetApplicationInfoEx(), generates the error 1051030 when you pass a Null parameter to it. (24982, P3)
The use of a Null value as the second parameter in the Grid API function, EssGetApplicationInfoEx(), generates the error message 1051030, "Application does not exist."

The Agent hangs when another user attempts to access the same application while filters are being verified. (25089, P3)
Hyperion Essbase OLAP Agent may hang if one user attempts to verify a filter, while another user attempts to access the same application.

Attempting to perform a zoom in on attribute members may result in the Spreadsheet Extractor error 1130001. (25127, P3)
If you attempt to expand attribute members, you may receive the Spreadsheet Extractor error 1130001.

Attempting to retrieve data on attribute members crashes the server. (25278, P3)
Attempting to retrieve data on specific attribute members results in an exception log and application crash.

Creating 60,000 filters causes the server to crash and corrupt security files. (25298, P3)
If you try to create 60,000 filters using the ESSCMD, copy filter command, the server may crash with an exception segmentation violation. Moreover, if you attempt to restart Hyperion Essbase OLAP Server, you may receive an error message, "The security file is corrupted."

A database may lose its currency link upon stopping the Essbase Agent. (25364, P3)
If you shutdown Hyperon Essbase OLAP Server, the currency link to your database may disappear.

Deleting a shared member removes all data from the actual member. (25376, P3)
If you delete a shared member, all data from the actual member may be deleted.

Attempting to retrieve data on attribute members across transparent partitions results in incorrect values. (25585, P3)
If you perform a retrieval on attribute members from a target database of a transparent partition, you may receive incorrect results.

Using the ESSCMD command, ENDARCHIVE, the .cfg setting _SM__BUFFERED_IO TRUE results in a crash. (25715, P3)
With the .cfg setting __SM__BUFFERED_IO TRUE, if you attempt to complete archiving of data using the ESSCMD command, ENDARCHIVE, or the MaxL command END ARCHIVE, the application may crash.

The .cfg setting, __SM__BUFFER_IO TRUE, erroneously returns zero values. (25789, P3)
If the buffered IO setting is set to True, the calculated values may erroneously return zeros.

Sub-optimal performance for formulas executed in top-down mode. (26003, P3)
If a formula attached to a member is executed in a top-down mode as indicated in the application log file, performance may be sub-optimal.


The following problems are fixed in FixPak 4.

----------- For DB2 OLAP Server:

Some ESSBASE.CFG settings are not displayed in the Essbase Configuration panel of the Server Information in Application Manager. (7381, P2)
Some dialog box settings in ESSBASE.CFG are not displayed in Hyperion Essbase Application Manager Server > Information > Essbase configuration.

Locking and sending data to the target of a transparent partition may not work. (12008, P2)
When using either Spreadsheet Add-in with Free-Form interpretation or the C or Visual Basic API, an attempt to lock and send data to the target of a transparent partition may fail and generate the following error message: Error the 1014004 - Unable to update members which have not been locked.

Syntax checker does not move to the problematic line. (14020, 15997 P2)
When the syntax checker is run in the Calc Script Editor, and if an error is found, the window may not scroll to show the problematic line. To locate the line, you may have to scroll through the calculation script text to find the highlighted information.

Performing an Edit > Replace on a large calculation script will delete some portions from the calculation script. (18490, P2)
In Application Manager, performing an Edit > Replace on a large calculation script may stop the replace process or delete the replaced text and may subsequently generate the following message, "Text is not found. Do you want to start at the beginning of the file?"

If an Excel spreadsheet consists of unknown members, retrieving with Repeat Member Labels selected may result in a corrupted spreadsheet. (18733, P2)
In the Spreadsheet Add-in, retrieving for unknown members with Repeat Member Labels selected may return scrambled data.

Column shifts to the left after a Keep Only. (18973, P2)
In the Spreadsheet Add-in, an attempt to perform a Keep Only may shift the first column to the left.

Database state does not get updated when the data load is partially successful. (19176, P2)
If a data load is partially successful when you select Database > Calculate, you may encounter the message, "the database does not contain any data" even if the database contains data.

NLS characters get corrupted for object name when viewed in the server console. (19546, P2)
User, Database, and Application names containing non-English European characters are not displayed correctly in the server console.

In Lotus 1-2-3, NLS characters in cascading filenames are displayed incorrectly. (19833, P2)
In the Spreadsheet Add-in for Lotus 1-2-3, non-English European characters are incorrectly displayed in the filename when specifying them in the prefix, suffix, or workbook text box in the Cascade Options dialog box.

Incorrect SSAUDITR setting in .CFG corrupts database. (19844, P2)
An incorrect SSAUDITR setting in the Essbase.CFG may give the error message, "unable to connect to database" when you attempt to connect to the database in any client program.

In the Application Manager Japanese version, Field Properties dialog box contains mangled characters. (19953, P2)
In the Application Manager Japanese version, in the Data Prep Editor, you may find some mangled characters in the Data Load Properties and the Dimension Building Properties tabs of the Field Properties dialog box.

When searching for a string, the Calc Script Editor does not scroll through to locate it. (20492, P2)
When updating a calculation script, the Edit > Find function does not cause the window to scroll to the next occurrence and locate the string that you are searching for.

The first part of the formula disappears when you use Flashback. (20589, P2)
When using the Spreadsheet Add-in with Lotus 1-2-3, an attempt to retrieve data on a formula that has an error followed by a Flashback may cause the first part of the formula to disappear.

EsbGetDatabaseState does not return default or modified values. (20626, P2)
The VB API routine, EsbGetDatabaseState, does not return correct values in the ESB_DBSTATE_T structure. In particular, the default values for Retrieval Buffer Size and Sort Buffer Size are either 0 or incorrect. Additionally, any new values that you enter through Hyperion Essbase Application Manager are ignored.

@SUM function does not work correctly with User Defined Attribute (UDA). (20758, P2)
@SUM function may not work correctly with more than one macro as its expList.

Incorrect handling of operators, such as AND and OR inside a FIX statement. (20766, P2)
FIX command involving member functions used with AND, OR operators may generate incorrect member sets.

While using the @CHILDREN function, you cannot put space between the parentheses and the member name. (21174, P2)
While using the @CHILDREN function within a FIX statement, inserting a blank space between the parentheses and the member name may yield an error message.

Zoom In results in an error message if maximum number of rows exceeds 8,192. (21242, 23210 P2)
In the Spreadsheet Add-in with Lotus 1-2-3, an attempt to zoom into more than 8,192 rows may result in an error message.

Generating an exception log file, while synchronizing outlines causes the application to crash. (21293, P2)
While synchronizing outlines, a crash may occur and an exception error log is generated when using an alias in the partition definition.

Error in outline synchronization with transparent partition on a shared member. (21620, P2)
During outline synchronization, an attempt to add both shared and regular members in the same dimension to a target database may not add the shared member, and it may give the error message, "There is 1 Message in the application log identifying a change that was not applied during the outline synch."

Calculation on a transparent partition seems to run indefinitely. (21651, P2)
Two types of formulas, Constant Assignment and Forward References, when attached to a sparse member, trigger top-down execution. But the application log may not contain messages indicating top-down execution.

Unable to restructure data on an HP-UX 64-bit machine if the directory name exceeds 8 characters. (21656, P2)
Creating directory names with more than eight characters may generate an exception error log file and hinder the data restructure process.

Translation for Member Selection is incorrect. (21744, P2)
In the Spreadsheet Add-in with Excel, Essbase Member Selection features are erroneously translated. For example, "insert list before active cell" translation is misleading. Also, the message at the bottom of the Member Preview dialog box is mistranslated. This problem is noticed in Spreadsheet Add-in (Essbase Release 6.0 P1) Japanese version.

Text type attribute member having only numeric values does not get associated. (21748, P2)
While using a rules file to associate the attribute members with the base member, a text type attribute member that contains only numeric values and begins with the 0 may not get associated with the base member.

Zoom In may cause incorrect results if Essbase Options are checked. (21785, P2)
In Hyperion Essbase Spreadsheet Add-in, when the options, Display > Cell > Repeat Member Labels and Zoom > Member Retention > Remove Unselected Groups are selected, an attempt to zoom in may cause incorrect results.

When the row header has invalid alias name, the Excel spreadsheet shows incorrect values. (21804, P2)
In the Spreadsheet Add-in, if the option Use Both Member Names and Aliases for Row Dimensions is selected, retrieving may result in incorrect values when row members contain invalid alias names.

Case sensitivity does not work correctly during dimension building. (21906, P2)
Case sensitivity may not function correctly and may cause the server to freeze during dimension building.

Zoom Out does not function correctly if Formula Preservation is checked. (21949, P2)
When Formula Preservation is selected in the Spreadsheet Add-in, zoom out may give erroneous results.

Attribute dimension building corrupts the outline. (22020, 22325, P2)
When a user tries to build and associate an attribute dimension on the base dimension, Application Manager randomly associates attributes at all levels and corrupts the outline.

Internal Rate of Return (@IRR) function produces incorrect results. (22163, P2)
Using @IRR in a calculation script may produce incorrect Retrieve results.

Database restructure causes the application to crash. (22206, P2)
If a member is renamed after another member that is deleted, the new member may map to both previous and existing members and cause the server to crash.

"Invalid Block Header" error following a calculation script or other long running update operation. (22256, P2)
Error 1006010 or 1006016 appears following a calculation script or other long-running update operation. Although the problem has been corrected by this patch, the error message indicates that the database was corrupted. This patch will not fix corruption that has already occurred. You must therefore restore the most recent clean backup of the database or start over with an empty database.

Lotus 1-2-3 results in an error message if #MISSING is set to 0. (22333, P2)
In Spreadsheet Add-in with Lotus 1-2-3, if the #MISSING label is set to zero and there is no data, an error message is produced stating, "The sheet contains an unknown member 0."

Dimension building for base member hierarchy does not work properly. (22350, 22695 P2)
Dimension building for a base member hierarchy may not work properly when using the generation build method. The rules file does not contain attribute member associations, but when the rules file updates the outline, it assigns attributes to members of different levels.

A crash may occur when verifying an outline containing lengthy date and numeric attribute member names. (22395, P2)
If a full name of a date or numeric attribute member, including parents and ancestors when applicable, is larger than 80 characters, an attempt to save or validate the outline may cause a crash.

Loading and unloading data for a 250 GB database may result in a memory leak. (22412, P2)
When starting DB2 OLAP Server, when you build dimensions by Dynamic Dimension Build, upload data by Dynamic Data Load, or calculate and then shutting down the product, allocated memory may not be released and the operating system may crash.

Passwords visible on UNIX when using the secure mode. (22491, P2)
When DB2 OLAP Server is installed on UNIX in secure mode, passwords may still be visible.

The C API routine, ESSCMD EssOtlOpenOutlineQuery, leads to a memory leak. (22543, P2)
The C API function, EssOtlOpenOutlineQuery, allocates memory that is not released in EssOtlFreeMembers as it should be, which eventually seriously hinders system performance.

After default calculation lower level data may override upper level data. (22742, P2)
When Aggregate Missing is off, lower level consolidation that results in #Missing may override upper level data.

Data not rolling up properly when using an attribute dimension. (22756, P2)
When an attribute dimension is used, the Spreadsheet Add-in may not generate correct data roll-up.

The ESSCMD GETDBSTATS fails when executed. (22816, P2)
Then ESSCMD GETDBSTATS may not function if it is executed on a cube whose dimension name consists of a particular character, such as '%n.'

The ESSCMD EssOtlQueryMembers returns wrong result when outline exceeds 16K members. (22853, P2)
The outline API, routine EssOtlQueryMembers, does not return the correct number of outline members when the outline contains more than 16K members.

Sparse restructure causes Linked Reporting Object (LRO) counter to be reset. (22926, P2)
When adding a new LRO immediately after a sparse restructure, the following error occurs: "Object # already exists".

Unable to initialize GRID API when Regional Setting is German (Austrian). (22962, P2).
The GRID API will fail to initialize when the Regional Setting in the Control Panel is set to German (Austrian).

Memory leak in EssVSetSheetOption and EssVSetGlobalOption. (22998, P2)
The VBA routines, EssVSetSheetOption and EssVSetGlobalOption, leak memory on Windows 95/98 clients, causing degraded performance when they are used repeatedly.

"Cannot access object: Ess00000.TMP" error when running 4 batch jobs. (23034, P2)
When running concurrent programs that use the Outline API, Hyperion Essbase OLAP Server occasionally cannot create temporary file names and displays the error message, "Cannot access object: Ess00000.TMP."

Hyperion Essbase Application Manager is not displaying the Disk Volume. (23059, P2)
The Storage tab on the Database Settings dialog box in Application Manager contains a table that is not always in synchronization with the Disk Volume edit field or updated when changes are made to the disk volumes.

EssCell may not work for Dynamic Time Series. (23119, P2)
In Hyperion Essbase Spreadsheet Add-in, running EssCell (Y-T-D) on an outline with attributes may return #MISSING instead of the Y-T-D value.

EssVGetDataPoint returns incorrect values for Dynamic Time Series. (23130, P2)
When using Dynamic Time Series in a spreadsheet to return a specific H-T-D (April), the EssVGetDataPoint mistakenly returns "H-T-D" instead of "H-T-D(April)."

Sparse Dynamic Calc fails in a calculation script. (23156, P2)
If a calculation of a stored member depends on a virtual block, either through parent-child relationship or through formula, calculation of the virtual block may not be triggered correctly, causing incorrect results for the stored member.

GRID API crashes with multiple concurrent logins and logouts on a multiprocessor machine. (23175, P2)
The GRID API may crash on connect or disconnect when using multiple threads on a multiprocessor machine.

Data is incorrect when aggregated with Create Block on Equation and from bottom-up. (23274, P2)
When using SET FRMLBOTTOMUP ON, the dependencies of top-down formulas may be processed incorrectly, causing some blocks to be missed during calculation.

EssVGetDataPoint function does not return correct data for a first page header. (23275, P2)
EssVGetDataPoint function may not work properly for the first page header of a query unless the cell being inquired is in the first column.

Division by values between .000000000000004 and -.000000000000004 results in a #MISSING. (23375, P2)
In FixPak 4, the division with denominator values between .000000000000004 and -.000000000000004 may result in a #MISSING.

While ignoring the TimeStamp parameter, EsbGetLogFile returns the entire log. (23396, P2)
The Visual Basic API routine, EsbGetLogFile, ignores the TimeStamp parameter and returns the entire log file rather than the entries of the log file produced after the date and time specified by the TimeStamp parameter.

@XREF triggered by a query will not automatically log off the source database. (23470, P2)
Queries involving Dynamic Calculations with @XREF leave users logged into the remote sources of @XREF references.

The server produces incorrect results if the number of blocks to be locked exceeds the LOCKBLOCK setting. (23656, P2)
When using formulas on sparse members for which the number of blocks to be locked exceeds the LOCKBLOCK setting, the current LOCKBLOCK setting may not return correct values.

After moving members of a sparse dimension, the server crashes while doing a base level restructure (23925, P2)
After moving a sparse dimension member, an attempt to restructure at the base level may result in a network error, 10054, or may even cause the data to disappear.

----------- For OLAP Integration Server:

Cannot Tag a Parent and Child Dynamic Calc and Store with Dimension Build (14688, 15277)
In Hyperion Application Manager, a parent with a single child cannot be tagged with Dynamic Calc and Store using Dimension Build.

Drill-Through Reports May Not Work if Level Build is Done with Null Value in the First Column (21388, 22041)
If doing a level build with a null value in the first column (GEN2) and a drill-through report is defined on the lower level of the hierarchy, the drill-through reports do not appear when drilling down on all the lower level members in Excel. If, however, you add an upper-level drill-through report, the lower-level report is accessible.

Workaround for 21388 and 22041:
Set the following configuration parameter in essbase.cfg:

HISLEVELDRILLTHROUGH appname
This parameter sets the Hyperion Integration Server drill-through mode for the application specified in appname.

Shared Members Not Added if Data is Sequential (21706)
When metaoutline members are created from columns with sequential data, the "Add as shared members" option is not applied.

Base Dimension Name Not Automatically Updated After Renaming Attribute Member (21795)
When renaming an attribute member, the base dimension name is not updated onscreen without first performing a refresh (F5).

DB2 OLAP Integration Server Fails on Metaoutlines when Missing Corresponding Items in OLAP Model (21803)
In a Metaoutline, attempting to view the Properties on an attribute dimension column that does not have the corresponding dimension in the OLAP Model causes Hyperion Integration Server to fail.

Columns Added to Drill-Through Reports are Sometimes Not Saved (21859)
On occasion, columns added to Drill-Through reports are not saved. This sometimes occurs after adding both intersections and columns to a Drill-Through report.

Columns in Drill-Through Reports are Sometimes Displayed Incorrectly (21860)
On occasion, after editing a Drill-Through report, columns set to be sorted in a descending order are listed instead in an ascending order.

Member and Data Loads Sometimes Report Zero Members Loaded (21865)
Following a member and data load, Hyperion Integration Server Desktop may sometimes report that zero members are loaded and some of the data is rejected. This may occur after adding a dimension and a filter to an OLAP model and then previewing the results before performing a member and data load.

Renaming an Attribute Dimension as a Standard Dimension May Cause Server Crash (21928)
If an attribute dimension is renamed as any of the standard dimensions in an OLAP model, the validation will pass but during a member load, the server may crash.

A Problem Occurs if Applying a Boolean Condition when Creating Metaoutline with a Boolean Attribute Dimension (21975)
The Boolean condition of "not case sensitive" is not applied when creating a metaoutline with a Boolean Attribute dimension.

Data Loads Containing a Large Number of Duplicate Members Cause DB2 OLAP Server and DB2 OLAP Integration Server to Freeze (21998, 22147)
Performing a data load using data that contains thousands of duplicate members causes DB2 OLAP Server and DB2 OLAP Integration Server to freeze.

Workarounds for 21998 and 22147:
Set the following configuration parameters in essbase.cfg:

NoMsgLogginOnDataErrorLimit = TRUE

DataErrorLimit = 1
Then, restart the Essbase server.

An alternate workaround is to start the OLAP Server component (olapisvr.exe) from the DOS prompt with the -C parameter set to 3100 or less.

Incorrect Null Promotion in Outlines Built with Aliases (22232)
In an OLAP Metaoutline, if a null value occurs where a value for a GENERATION or LEVEL field is expected, the child value is promoted in its place. A problem occurs when adding aliases to dimension members in an OLAP Metaoutline, causing incorrect null promotion in the resulting Essbase outline.

Using ODBC Version 3.6x Instead of Version 3.7x with SQL Server 7 Causes Catalog Access Problems in Some Cases (22388)
You may experience ODBC errors if you are using Microsoft SQL Server version 7 with version 3.6x of the ODBC drivers, included in version 2.5 of the Microsoft Data Access Components (MDAC). The type of problem encountered involves user access to catalogs other than their own residing on the server. If you are experiencing this problem, please visit the Microsoft web site for information on obtaining the latest MDAC.

Installation Script Links esslib to lib when Installing Over Existing OLAP Integration Server (23191)
When installing over an existing DB2 OLAP Integration Server, the installation script creates a symbolic link from esslib to lib, placing all ess* shared library files in the wrong directory.

Query Does Not Properly Group By Parent for Data Loads of Parent/Child Dimensions (23377)
When performing an attribute load for parent/child dimensions, the SELECT statement used by OLAP Integration Server does not contain the correct "GROUP BY" clause. This causes incorrect results when there are shared dimension members.

Important Note: The fix included in this patch, a modification to the GROUP BY clause of the SELECT statement, is not supported on Informix databases and is a limitation for this patch.

Query for Attribute Loads Does Not Use the Keyword, "DISTINCT" (23382)
The SELECT statement used by OLAP Integration Server when performing an attribute load does not contain the keyword "DISTINCT". For some databases, this omission can result in a large number of rejected records in the log file, slow load times, and, occassionally, an Essbase server failure.


The following problems are fixed in FixPak 3.

DB2 OLAP Integration Server Is Unable to Obtain a Read Lock Using Oracle (23433)
A date format problem occurs when using certain combinations of the MERANT ODBC driver and the Oracle relational database management system (RDBMS). In this circumstance, DB2 OLAP Integration Server is unable to lock a model ormetaoutline in the OLAP Metadata Catalog, thus preventing access to OLAP models or metaoutlines.

Error message "Cannot access object: Ess00000.TMP" when using the Outline API. (23034, P3)
When running concurrent programs that use the Outline API, DB2 OLAP Server occasionally cannot create temporary file names and displays the error message "Cannot access object: Ess00000.TMP".

HP-UX and AIX only: correct header file versions required. (23460 P3)
FixPak 2 contained incorrect versions of API header files for the HP-UX and AIX platforms. If you installed the FixPak 2 C API for these platforms, you should install FixPak 3 over your FixPak 2 installation.

Database fails to load with buffered I/O in effect and an Index Page size less than 8K. (21733, P3)
When buffered I/O is in effect (see the information message in the application log) and the user specifies an Index Page size less than 8K, DB2 OLAP Server over-allocates memory to the Index cache during database startup. If the user then specifices a large Index cache (for example 500M), the Index cache memory allocation might consume most or all of the available memory, in which case the database fails to load.


The following problems are fixed in FixPak 2.

Cannot Tag a Parent and a Child Dynamic Calc and Store with Dimension Build. (14688, P2)
In the Application Manager, a parent with a single child cannot be tagged with Dynamic Calc and Store using Dimension Build.

EsbLROAddObject() May Give Error 1030718. (17507, P2)
If the usOption parameter of EsbLROAddObject is set to ESB_STORE_OBJECT_API, the API may produce error 1030718: Invalid object option for cell not entered.

The Server May Not Be Able to Create Database Whose Names Contain Certain Foreign Characters. (18532, P2)
If a database name contains certain foreign characters, like Kanji or Katakana, the Application Manager may produce an error 1019002: Failed to create database.

An Attempt to Create and Delete a Chart on Lotus 1-2-3, Release 9.0 May Disable the Double-Click Drilling Function of the Mouse. (18719, P2)
When creating and deleting a chart on the spreadsheet using DB2 OLAP Server V1.1 FixPak 7 (Essbase 5.0.2 P7) with Lotus 1-2-3 Release 9, may disable the double-click drilling function.

Server Crashes During Extremely Heavy Concurrent Update Workload. (19397, P2)
Server crashes during extremely heavy concurrent update workload.

Excel Does Not Prompt to Save When Essbase Cascade Is Performed. (19431, P2)
In the Spreadsheet Add-in, if a cascade is performed the users are not prompted to save the file on exit.

Database Setting "Create block on equation" Behaves Differently After Release 5.0.2 P9. (19496, P2)
When "Create blocks on equation" is enabled, execution of certain formulas during calculations may clear contents of some data blocks.

Essbase EssRetrieve Macro Lock Option for 2 and 3 No Longer Works for Lotus 9.1. (19522, P2)
The lock options 2 and 3 available for the EssRetrieve macro may no longer work for Lotus 9.1. When EssRetrieve macro is run with EssSend macro, the following error message appears in Lotus: "Unable to Update Members Which Have Not Been Locked."

5.0.2 P10 Locale Files and ESSBASE.MDB Are Not Replaced in a New Patch Installation. (19775, P2)
Patch installation does not update <ARBORPATH> /bin/essbase.mdb or locale files because they are read/only.

Long Member Formula Gets Truncated with Member Load Using Rules File. (19902, P2)
An attempt to load members using rules file fails when long member formulas are truncated in the member load rules file field. But if the same member formula is entered manually using the member formula editor text box, then it works fine.

ESBGetLogFile Will Not Get the Server Log File Unless Application Name Is Undefined. (19936, P2)
The VB API routine EsbGetLogFile will not get the server log and will return a non-zero value when the AppName parameter is explicitly set to null. It only works properly when the AppName parameter is undefined.

EssVRetrieve (Empty, Empty, 1) and EssVFlash (Empty) Use 100 % of CPU. (19946, P2)
EssVRetrieve or EssRetrieve with the range parameter is set to empty it may use close to 100% of the CPU for 2-3 minutes. Furthermore, after the retrieve, EssVFlash may use close to 100% of the CPU.

Volume Spanning Has Been Set but Index File Creation Is Not Rolling Over to the Next Volume. (19973, P2)
The error 1019028: "Out of disk space, unable to write information to file," appears when a new page file is created and the current disk volume has less than 1024 bytes of available space.

Retrieve Returns Invalid Values on Certain Databases with Circular Dependencies Between Blocks. (20158, P2)
If a circular dependency between blocks exists, retrieval of Dynamic Calc values may produce incorrect results.

Retrieval Through C API Renders Incorrect Results When Compared to Excel. (20283, P2)
An Essbase report containing a member name in quotes immediately followed by an '!' without any space in between may not get recognized. This may result in a row with the unrecognized members to repeat the value from the row above.

EssOtlFreeMembers() Is Declared Twice in ESSOTL.H. (20409, P2)
API programs that include the file ESSOTL.H do not compile because EssOtlFreeMembers() is declared twice.

Calc Never Finishes Across a Transparent Partition. (20579, P2)
Transparent partitions may cause database calculation to run infinitely.

Renaming a Member with Shared Attribute Incorrectly Causes Complete Restructure. (20764, P2)
In a time dimension, an attempt to add, rename, and categorize members as shared members in the data storage may rapidly reduce the page size indicating that complete data restructuring has taken place. But upon each time, if a shared member is deleted or added to the outline, and the outline is saved, the page file does not change, thus, indicating that data restructure is not taking place.

Attributes with Lengthy Text Names May Crash the Application. (20795, P2)
In a Hyperion Essbase outline, if the sum of all the text characters for attribute member names exceed 80 characters, saving or verifying the outline may crash the application.

Spreadsheet Retrieval Causes the Application to Crash and Core Dump on HP-UX. (20813, P2)
In the Spreadsheet Add-in, when using a specific spreadsheet view where the Essbase option Use Both Alias and Member Name is enabled and where some dimensions are not represented, performing a Zoom In will cause the application to crash. A core dump may also be created as a result of the application crash.

EssVSetOption Does Not Work. (20866, P2)
In the Spreadsheet Add-in, the use of EssVSetOption may not work if the focus is on any of the VB controls at the time of the calls.

Unable to Synchronize an Outline After the Outline Is Revised for Transparent Partition. (20904, P2)
An attempt to re-synchronize outlines of transparent partitioned databases may disable the Edit and Apply option buttons on the Synchronize Outline dialog box.

Sample Report Generates Error. (20913, P2)
Running Sample report asym.rep generates an error message: "incorrect asymmetric report [8] records processed." This has been fixed only in the Japanese version.

Right Click of the Mouse to Collapse Member Values Displays Irregular Layout with Spreadsheet Add-in. (20916, P2)
In the Spreadsheet Add-in, if Repeat Member Labels and Use Both Member Names and Aliases for Row Dimension settings are enabled, an attempt to collapse data to higher levels may display irregular layout for member names.

When Substitution Variables Are Set to Validate a Calc Script an Error "Unknown Member" Is Generated. (20927, P2)
When running a calc script that is associated with an outline, the application generates an error message: "unknown variable or member name," if the substitution variables are a substring of another.

VB API Crashes on EsbOtlGetMemberInfo. (20941, P2)
VB API crashes when the API call EsbOtlGetMemberInfo is used for a text attribute that returns a null string value.

Report Script with a Substitution Variable May Result in an Error Message in Double-Byte Platforms. (20945, P2)
An attempt to run a report script repeatedly on a double byte platform with a substitution variable added to may result the following error message: "10001070 UNKNOWN LAST MEMBER FOR _uY-T-D_v IN REPORT."

Performance Problem with Dimension Build for Aliases on Shared Members. (20997, P2)
When doing a Dimension Build on an outline where a large number of shared members that have aliases are being added, the dimension build may become slow.

If There Is More than One Substitution Variable, Changing One Value May Cause Some of the Previous Substitution Variable to Disappear. (20999, P2)
If more than 1 substitution variable is defined, changing the value of any one substitution variable may cause the first or the previous substitution variable to disappear.

Record #65536 Is Missed When Doing a File/Update Outline. (21000, P2)
Record #65536 is missed when doing a File/Update Outline with a large data file (having more than 65535 records).

In the Japanese Application Manager, Except for the Active Application, No other Application Names Are Listed for Copying. (21001, P2)
Unlike the Application Manager English version, the Japanese Beta of DB2 OLAP Server 7.1 (Essbase Release 6.0 Japanese Beta) does not provide any choices of application names to be listed for copying to the database.

Some Items Are Truncated and Misaligned in Server Information Dialog Box and Database Information Dialog. (21002, 21035, P2)
Some items are truncated and misaligned in the Application Manager Server Information dialog box and Database Information dialog box.

Attribute Query with Shared Members and Two-Pass Calc Members May Cause Server to Crash. (21099, P2)
On AIX 4.3.3 server, in ESSBASE. CFG file, if the setting is OUTLINECHANELOG TRUE, an attempt to add a member and save the outline may generate an exception log.

In the Japanese Spreadsheet Add-in One of the Error Messages Is Not Correctly Translated. (21135, P2)
In the Spreadsheet Add-in, if Essbase Member Selection menu is selected then an attempt to select a member will give the incorrectly translated message "1 no 22 sentak saremashita."

Clicking a Member Cell May Clear the Spreadsheet. (21159, P2)
In the Spreadsheet Add-in, when dimensions listed in the column heading appear in only one row, double-clicking a data cell may clear the spreadsheet.

Renaming a Logical Column Name in a Model Causes Member Load to Abort. (21184, P2)
When the contents of a FIX statement results in an empty list, the OLAP server ignores the FIX statement and performs the calculation on the whole database.

In the Japanese Application Manager, Event Log Displays Overwrapping Characters When Scrolled to Left. (21188, P2)
In the Application Manager, event log displays overwrapping 2-byte characters when the window scrolls to right and then scrolls back to left.

Escape Characters ("\) Do Not Work Properly in DB2 OLAP Server V1.1 FixPak 7 (Essbase 5.0.2 P11). (21189, P2)
The Escape characters used in ESSCMD to update substitution variables fail when used with FixPak 11, but work fine for FixPak 7.

Adding Members to Outline with OUTLINECHANGELOG TRUE Crashes the Database. (21190, P2)
On AIX 4.3.3 server, in ESSBASE. CFG file if the setting is OUTLINECHANELOG TRUE, an attempt to add a member and save the outline may generate an exception log.

Drill-Through May Not Work When Outline Has Attribute Dimensions. (21202, P2)
In the Spreadsheet Add-in, invoking Server Drill-Through may generate an error message.

The Multiple UPDATEVARIABLE Command Updates the First Variable. (21207, P2)
In DB2 OLAP Server V1.1 FixPak 11, when running the calc script, multiple UPDATEVARIABLE commands only update the first variable.

Dynamic Calc May Generate Inconsistent Results. (21215, P2)
In the Spreadsheet Add-in, retrieval may generate inconsistent results for the same member combination depending on the view and order of retrievals.

Loading Data by Using an Excel Workbook with Formulas or Custom Text After the First Sheet Crashes the Application. (21219, P2)
In the Spreadsheet Add-in DB2 OLAP Server Version 7, loading data using an Excel spreadsheet as a source, if there are formulas or custom texts on the sheets after reading the first sheet the application crashes.

Loading Data with Rules File Set with "Add to existing value" with #MISSING After 0 Value, Gives #MISSING. (21272, P2)
In a rules file when loading data is set with "Adding to the existing value" and if you load data with #MISSING after a value of 0 is loaded, the Retrieve instead of returning 0 returns #MISSING.

The Option CALCOPTCALCHASHTBL TRUE Causes Inconsistent Results. (21300, P2)
In some cases when the CALCOPTCALCHASHTBL is set to TRUE in the ESSBASE.CFG file, incorrect data values may be calculated.

Report Script Produces Different Results from Release 5.0.2 P11 to 6.0 P1. (21305, P2)
In the Application Manager, a report script with more than one MASK command produces different output from Release 5.0.2 P11 to 6.0. P1. The file output in 6.0 P1 is larger than 5.0.2 P11.

Esssvr Crashes When Performing Dense Restructure. (21501, P2)
Essbase server generates a general protection fault while doing dense restructure for level 0 data.

Application Manager Crashes When Viewing a Member with a User-Defined Attribute (UDA) List Display Larger than 4k. (21534, P2)
If a member has a UDA that is greater than 4K, when the outline is expanded in the Outline Editor where such a member with a UDA exists, Application Manager crashes.

Wording of Grandparent and Parent option of Member Name Format in Application Manager Is Incorrect (21574, P2)
In the member name format panel of the attribute member names dialog of Application Manager, the member name format grandparent and parent is not correct. It should read grandparent.

Retrieval on a Dynamic Calc Member Across Transparent Partitions May Be Slow on 5.0.2 P11. (21636, P2)
In the Spreadsheet Add-in, retrieval on a Dynamic calc member in a transparent partition may be slower in 5.0.2 P11 than in 5.0.2 P7.

In the API EsbSetUser, if the PwdChgNow Option Is Set to True, then the User Is Prompted to Change the Password Only One Time. (21683, P2)
If the Application Manager Global Server Setting for the "Number of days before user needs to change password" is set to greater than 0, and the EsbSetUser option PwdChgNow is set to True, then the user is requested to Change Password only once upon the first login.

Attribute Calc Does Not Aggregate Values from Upper Level Shared Members. (21684, P2)
Attribute calc does not aggregate values to the parent of a shared member, if the shared member is related to an upper level member that has base members as its children.

Retrievals on a Transparent Target Database Take Longer on 5.0.2 P11 than on 5.0.2 P7. (21692, P2)
A retrieval on a target database with three source databases takes approximately 35 seconds with FixPaks 11 and 12 for DB2 OLAP Server V1.1 (5.0.2 P11 and 5.0.2 P12) compared to approximately 6 seconds with FixPak 7 for DB2 OLAP Server V1.1 (5.0.2 P7).

No libglobalc.so in Essbase\api\lib. (21768, P2)
FixPak 11 for DB2 OLAP Server V1.1 (5.0.2 P11) UNIX installation does not put libglobalc.so into the Essbase\api\lib directory. This may result in compiler errors when using the API.

Calc Time Degrades from FixPak 10 to FixPak 12 for DB2 OLAP Server V1.1. (21772, P2)
Calc script time increases from FixPak 10 of DB2 OLAP Server V1.1 (5.0.2 P10) to FixPak 12 (5.0.2 P12).

User with Create/Delete Permissions Cannot Edit Users. (21810, P2)
Two users have been provided with Create/Delete user permissions and without Create/Delete user permissions respectively. If you attempt to edit the second user while logged in as a first user who has Create/Delete permissions, the check boxes are grayed out.

Huge Formulas with Many Member References Can Cause an Essbase Internal error. (21821, P2)
If a formula (attached to a member in an outline or in a calculation script) involves references to more than a 1000 members, Hyperion Essbase server can report an internal error "Calculator Stack Contains a NULL Object."

Not All Data Returned When Buffer Size Is 32K. (21838, P2)
When the API call EsbGetStringBuf is used on a particular report with a buffer size of 32767, records are skipped in the report. The report is correct with the buffer size is 32766.

Retrieval on a Target Database Crashes the Target Application. (21876, P2)
Retrieval across transparent partitions with attributes could cause crashes in certain cases.

Data Load Causes Error on the UNIX Server. (21884, P2)
On UNIX platform, loading data with text file and rules file may generate error message, " unknown member[...] found while processing string [...]."

In the Application Manager, the RUN Button in the Calc Script Editor or Report Writer Dialog Box Is Enabled When the Database Is (all dbs). (21901, P2)
When a calc script or a report file is created and saved in the (all dbs) database dialog box in Hyperion Essbase Application Manager, the RUN button is enabled which actually should not be enabled.

Unable to Set Calc Scripts as Default Calc with FIX, LOOP, and IF Statements. (21909, P2)
If a calc script containing FIX/LOOP/IF statement is set to serve as default calculation, Essbase crashes. The same calc script can be executed as a non-default calculation without any problem. It is the "Set Default Calc" operation that causes Essbase to crash.

Security Files May Get Corrupted When Installing Version 1 FixPak 1. (21924, P2)
When migrating from DB2 OLAP Server Version 1.1 to Version 7, additional copies of the of the database may get created each time the server is stopped and started.

Cannot Delete Server Log if Application Server Is Running. (22035, P2)
In the Application Manager, an attempt to delete event log may fail if application server is running. This is fixed in all server platforms except Windows 95/98.

EssVCascade Ignores Suppress #MISSING Option. (22044, P2)
The Spreadsheet Add-in VBA function EssVCascade ignores the suppress #MISSING flag set in Essbase options.

Changes to Original and Shared Members on Source Do Not Synchronize Properly to Target. (22048, P2)
Changes to original and shared members on the source outline do not properly synchronize at the target outline and produce an error message in application log, "There is 1 message in the application log identifying a change that was not applied during outline synchronization."

Calc Works in FixPak 11 of DB2 OLAP Server V1.1 (5.0.2 P11) but Causes Exception Log in Version 7.1 (6.0 P1) (Only with Data). (22142, P2)
In Version 7.1 (6.0 P1) execution of formulas that contain lists of numbers mixed with member names may cause the application to crash.

EssCell May Not Work with Dynamic Time Series. (22184, P2)
#MISSING is returned instead of the Dynamic Calc member value when EssCell is used on a Dynamic Time Series member (for example, EssCell ("Q-T-D") ).

@AVG Member Formula in 6.0 P1 Causes the Server to Crash. (22189, P2)
If a Dynamic Calc member has an @AVG member formula attached, upon retrieval, zooming in the parent of this member causes the server to crash and generate an exception log file.

Loading Data with Rules File May Cause Memory Leak. (22349, P2)
Data Load with 4-GB rules file errors after loading 10 million records.

Unloading and Loading a Database in Read-Only Mode, Does Not Start the dbwriter. (22411, P2)
When a database is unloaded, while in read-only mode and loaded back again, the dbwriter is not started. So the data operations following this sequence crash the application when it tries to initiate the dbwriter.


The following problems are fixed in FixPak 1.

Server Ignores Formulas With Members which Contain a Dot in Their Names. (15758, P1)
The application log gives error 1200324, if you use a "." in the member name. Furthermore in Application Manager the Dimension Specification dialog box shows the error: "!!FORMULA NOT LOADED!!"

No Error Is Generated for Invalid Formulas. (15815, P1)
No Error Message is generated if member names with a dot are not quoted.

In a Calc Script, no Error Is Generated When there Is no Statement After an IF Clause. (17654, P1)
An IF statement not containing a semicolon is erroneous and the error should be reported.

Insufficient Rights to Various Essbase Tasks After Running "root.sh." (17830, P1)
After running the root.sh file, the ownership of many files are changed from "arbor" to "root." Also, some files cannot be opened; for example, the outline file.

If Multiple Threads Attempt to Use Essbase APIs Concurrently, the API May Become Unstable. (18117, P1)
Concurrent API calls may cause instability or crashes because the API is not thread safe.

In Spreadsheet Add-in, Repeat Member Labels Option May Cause Incorrect Retrieval. (18734, P1)
During retrievals the Repeat Member Labels Option, if set to true may change some of the column headers and retrieve incorrect data.

Cannot Pivot on Certain Members When Repeat Member Labels Option Is Set to True. (18738, P1)
When Repeat Member Labels option is set to true in the Spreadsheet Add-in, the pivot operation works only if mouse points to a specific cell in the target row. It gives an error for all other cells in the target row.

Incorrect Behavior if Repeat Member Labels Option Is Set to True. (18740, P1)
When the Repeat Member Labels option is set to true in the Spreadsheet Add-in, the Remove Only or Keep Only operations may not function correctly.

Status Is Returned to Cell on a Wrong Sheet After Flashback Is Called. (18802, P1)
The return value of Lotus Spreadsheet macro may be displayed on the wrong sheet after the Spreadsheet Add-in Flashback command is called.

Year-To-Date (Y-T-D) Changes When Order of Months Changes. (19073, P1)
In some cases, the Y-T-D data shown in the Spreadsheet Add-in retrieval differs when the presentation order of month columns is changed. This bug is a duplicate of 18147, Patch 11.

The Set Substitution Variable Scope Option in the Formula Editor Shows a Problem. (19160, P1)
An attempt to reconnect to the server after choosing set Substitution Variable Scope may result in an error message: "Invalid Login ID - request [List Applications] failed."

EssOtlQueryMembersEx Does not Handle Label Only Members Properly. (19207, P1)
The EssOtlQueryMembersEx API command does not return shared or label only members.

If a Member Name Is 0 in the Outline, Error: "Data item found before member" May be Displayed. (19291, P1)
While using the Spreadsheet Lock & Send feature with data set to 0 or #MISSING the error: "Data item found before member" occurs.

No Result When Member Has a Calc Script Formula that Contains Dynamic Member and Cross-Dimensional Operator. (19393, P1)
#MISSING is returned upon retrieval of a member if the value of the member is "fixed" by a calc script that contains a Dynamic Calc member. This bug is a duplicate of 17946, Patch 11.

Users who Are not Logged Into Application Manager Are not Logged Off. (19469, P1)
Users who log on to the Application Manager but do not log on to any applications are not automatically logged off after some timeout. This bug is a duplicate of bug 18482, P11.

Certain Foreign Characters May Cause the Spreadsheet Add-in to Freeze. (19479, P1)
If certain foreign characters are used in the worksheet or file name, the Spreadsheet Add-in freezes.

Using the Down Arrow Key in the Linked Reporting Objects (LRO) Causes the System to Crash. (19489, P1)
In the Spreadsheet Add-in, using the down arrow key in the LRO browser may cause the system to crash. This problem is specific to Lotus 1-2-3 R9.0 on Windows NT.

Running Currency Conversion Calc Script Crashes the Application. (19892, P1)
The Application Manager may crash when running a currency conversion calc script on a database that has attribute dimensions.

A Rules File that May Be Saved in Application Manager In DB2 OLAP Server 7.1 May not Work. (19950, P1)
When saved in DB2 OLAP Server Application Manager Release 7.1, rules file for SQL import failed.

Migrating the Database Index from DB2 OLAP Server Version 1 Format to Version 7 Format Failed with the Version 1 .PAG File Size Between 2 GB and 2 GB Minus 8 Kb. (20008, P1)
This is a boundary case that affected .pag files whose size is 2 Gb minus 8 Kb when being migrated from Version 1. Note that part of this fix imposes a maximum file size of 2147475456 bytes (2 Gb minus 8 Kb) for index and .pag files in Version 7.  Files migrated from Version 1 can be a full 2 Gb on NT and 2147483647 bytes (2 Gb - 1 byte) on UNIX.

Database Without Data May Take Long Time to Restructure. (20063, P1)
With the fix, if the database does not have data, Link Reporting Objects (LRO), or partitions defined on it, DB2 OLAP Server  will take no time to restructure.

CopyApp Command May not Function Correctly With Multibyte Characters. (20228, P1)
CopyApp command functions incorrectly if the source application name contains multibyte characters; for example, Japanese character sets such as Kanji.

If Advanced Online JFS Is not Installed, DB2 OLAP Server Will not Start on HPUX. (20319, P1)
If Essbase is using vxfs as its disk volumes and if advanced online JFS is not installed, then direct I/O will not be used, buffered I/O will be used instead. Otherwise, Direct I/O is used. This is a new behavior of DB2 OLAP Server Version 7.

Error 1200420 and 1200324: Compiler Errors on Member Formulas. (20325, P1)
Member formulas with IF, ELSEIF, and ENDIF statements may generate compilation errors and be ignored.

Performance Fixes for Formula Calculation Using Certain @IS* Functions. (20679, P1)
Fixed problem which caused performance degradation in formula calculator on cubes with large blocks; optimized @ISLev(dimName, levName | levNum),@ISGen(mbrName) functions and also, other functions from this family.

DB2 OLAP Server 7.1 May Freeze on UNIX Platforms. (20684, P1)
DB2 OLAP Server 7.1 may freeze on some faster UNIX platforms.

When the Spreadsheet Add-in Is Installed in Excel, Excel Is Unusable from Within Internet Explorer (IE) V5. (20688, P1)
When the Spreadsheet Add-in is not installed, Excel works fine within IE V5; but if the Spreadsheet Add-in is installed, basic Excel functionality does not work.

Occasionally the Server Crashes When Users Logout After Outline Synchronization. (20717, P1)
The server may occasionally crash with a "not responding" error when users logout after outline synchronization.

DB2 OLAP Server May Crash Doing CALC ALL on an Outline with Attribute Dimensions. (20727, P1)
CALC ALL on an outline with attribute dimensions may cause Hyperion Essbase to crash.


Tips

On Solaris, if you want to use cache memory locking, you must run the root.sh file. Note: cache memory locking is only available with direct I/O. Caution: Using root.sh may interfere with SQL Interface. You may need to choose between SQL Interface and cache memory locking.

If you receive compilation errors in your calculation scripts, check the errors to be sure that variable names are not enclosed in quotation marks. The first character of variable names must be a letter (a through z). Variable names may contain letters, numbers (0 through 9), and these special characters:  $ (dollar sign), # (number sign), and _ (underscore).

For Japanese versions of DB2 OLAP Server to work properly on AIX and Solaris, you must install additional locales not shipped with Essbase. These are included on the setup CD of each operating system.  The locale needed for Solaris is ja_JP.PCK, and the locale needed for AIX is IBM-943. (21012)

The essbase.jar file should always reside in the /java directory of your installation if you intend to use the samples provided.

When migrating from V1.1 to V7.1 FixPak 8, if you notice a degradation in calculation performance and your outline has several formulas on dynamic calculation members, add a line with EVENT 28, and a line with CALCMODE BLOCK to your essbase.cfg file. Restart Essbase, then rerun the same calculation to see if it improves performance.

Java adds a startup memory requirement of approximately 10MB per application. If you install Java but are not using custom-defined macros or functions, you can reduce your startup memory requirement by disabling Java. To disable Java, remove all parameters from the JVMMODULELOCATION setting in the ESSBASE.CFG file. For more information about this setting, see the online Technical Reference.

On HP-UX platforms, if you observe DB2 OLAP Server using an inordinate amount of memory, it could a bug in the HP-UX operating system with respect to memory management for multi-threaded programs. Consider installing the following HP-UX operating system patch:

XSWGR1100 B.11.00.48 HP-UX General Release Patches, March 2000
and the following library patch:
PHCO_22314 1.0 libc cumulative patch



Copyright information

(c) Copyright International Business Machines Corporation 1998, 2002. All Rights Reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
(c) Copyright 1991-2001 Hyperion Solutions Corporation. All Rights Reserved.