Tivoli

Data

Warehouse

Release

Notes

Version

1.2

SC32-1399-00

���

Tivoli

Data

Warehouse

Release

Notes

Version

1.2

SC32-1399-00

���

Note

Before

using

this

information

and

the

product

it

supports,

read

the

information

in

“Notices,”

on

page

19.

Second

Edition

(December

2003)

This

edition

applies

to

Tivoli

Data

Warehouse,

Version

1.2

and

to

all

subsequent

releases

and

modifications

until

otherwise

indicated

in

new

editions.

This

edition

replaces

GI11–0857–00.

©

Copyright

International

Business

Machines

Corporation

2002,

2003.

All

rights

reserved.

US

Government

Users

Restricted

Rights

–

Use,

duplication

or

disclosure

restricted

by

GSA

ADP

Schedule

Contract

with

IBM

Corp.

Contents

Chapter

1.

About

this

release

.

.

.

.

. 1

New

in

this

release

.

.

.

.

.

.

.

.

.

.

.

. 1

Product

fix

history

.

.

.

.

.

.

.

.

.

.

.

. 1

Backward

compatibility

.

.

.

.

.

.

.

.

.

.

. 2

Product

compatibility

.

.

.

.

.

.

.

.

.

.

. 2

Chapter

2.

Installation

information

.

.

. 3

Hardware

requirements

.

.

.

.

.

.

.

.

.

.

. 3

Software

requirements

.

.

.

.

.

.

.

.

.

.

. 4

Database

requirements

.

.

.

.

.

.

.

.

.

. 4

Report

interface

requirements

.

.

.

.

.

.

.

. 6

Installation

and

upgrade

notes

.

.

.

.

.

.

.

. 6

Chapter

3.

Known

limitations,

problems,

and

workarounds

.

.

.

.

.

.

.

.

.

.

. 9

Limitations

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 9

Known

problems

and

workarounds

.

.

.

.

.

. 10

Installation

or

uninstallation

problems

.

.

.

. 10

Report

interface

problem

.

.

.

.

.

.

.

.

. 11

Miscellaneous

problems

.

.

.

.

.

.

.

.

. 11

Internationalization

problems

.

.

.

.

.

.

.

. 11

Chapter

4.

Documentation

updates

.

. 13

Additional

troubleshooting

scenarios

.

.

.

.

.

. 13

Upgrades

from

version

1.1

to

version

1.2

.

.

.

. 14

Multiple

customer

environments

.

.

.

.

.

.

. 14

List

commands

.

.

.

.

.

.

.

.

.

.

.

.

. 14

Messages

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 15

Chapter

5.

Contacting

customer

support

.

.

.

.

.

.

.

.

.

.

.

.

.

. 17

Appendix.

Notices

.

.

.

.

.

.

.

.

.

. 19

Trademarks

.

.

.

.

.

.

.

.

.

.

.

.

.

. 21

©

Copyright

IBM

Corp.

2002,

2003

iii

iv

Release

Notes

Chapter

1.

About

this

release

This

document

provides

important

information

about

Tivoli®

Data

Warehouse,

Version

1.2.

This

information

is

the

most

current

information

for

the

product

and

takes

precedence

over

all

other

documentation.

Read

the

information

in

this

document

before

installing

or

using

Tivoli

Data

Warehouse.

New

in

this

release

Tivoli

Data

Warehouse,

Version

1.2

has

the

following

new

and

changed

features:

Note:

Functionality

is

dependent

upon

features

provided

by

individual

warehouse

enablement

packs.

v

Improved

ease

of

installation,

upgrade,

and

uninstallation.

v

An

installation

registry

that

contains

the

location

and

connection

information

for

each

system

in

your

deployment.

This

means

that

you

do

not

have

to

provide

connection

information

when

installing

a

warehouse

enablement

pack,

hereafter

referred

to

as

warehouse

pack.

v

Support

for

viewing

reports

with

Crystal

Enterprise.

v

Support

for

multiple

central

data

warehouse

databases.

v

Support

for

multiple

instances

of

an

operational

data

source.

A

warehouse

pack

can

extract

operational

data

from

multiple

instances

of

the

same

data

source.

v

For

z/OS®

systems,

Tivoli

Data

Warehouse

supports

one

central

data

warehouse

and

multiple

data

mart

databases,

one

data

mart

per

each

DB2®

location.

v

Capability

to

grow

your

deployment

over

time

by

adding

central

data

warehouses

and

data

marts

after

initial

installation.

v

Warehouse

packs

are

configured

during

installation.

v

New

command

utilities

to

expedite

common

DB2

procedures

in

the

DB2

Data

Warehouse

Center.

v

Improved

troubleshooting

tools,

logs,

and

message

documentation

in

the

new

Tivoli

Data

Warehouse

Messages,

SC09-7776.

v

Bash

after

scripts

are

deprecated

in

this

release

and

will

not

be

available

in

future

releases.

Use

Perl

to

create

after

scripts

for

warehouse

packs.

Product

fix

history

The

following

defects

were

fixed

for

Version

1.2

of

Tivoli

Data

Warehouse:

v

APAR

IY46244:

During

the

installation

of

fix

packs

for

warehouse

packs,

changes

made

in

central

data

warehouse

and

data

mart

data

definition

language

(DDL)

and

data

manipulation

language

(DML)

SQL

scripts

that

are

surrounded

by

delta-based

tags

to

preserve

information

of

earlier

fix

packs

are

no

longer

erased

by

the

patching

utility

when

two

or

more

digits

are

used

for

fix

pack

version

numbers.

v

APAR

IY43104:

In

the

DB2

Data

Warehouse

Center,

the

IBM®

Tivoli

Enterprise

Console®,

Version

3.8

warehouse

pack

process,

ECO_c05_ETL1,

step

ECO_c05_s010_Extract,

no

longer

fails

with

the

following

message:

Disallowed

implicit

conversion

from

data

type

datetime

to

data

type

int

©

Copyright

IBM

Corp.

2002,

2003

1

This

was

a

spurious

ODBC

error

that

was

produced

by

the

execsql

SQL

execution

engine

program.

v

APAR

IY34584:

A

failure

no

longer

occurs

during

the

operation

of

warehouse

packs

when

they

extract

data

from

the

central

data

warehouse

and

transform

and

load

that

data

into

data

marts.

The

error

information

that

was

displayed

or

logged

when

this

failure

occurred

might

have

indicated

an

attempt

to

find

or

retrieve

an

expired

or

nonexistent

component

or

other

database

object.

Backward

compatibility

You

can

install

warehouse

packs

for

Version

1.1

on

Tivoli

Data

Warehouse,

Version

1.2.

See

Installing

and

Configuring

Tivoli

Data

Warehouse,

GC32-0744

for

additional

details.

Product

compatibility

Tivoli

Data

Warehouse,

Version

1.2

works

with

IBM

DB2

Universal

Database™

Enterprise

Edition,

Version

7.2

and

Crystal

Enterprise

9.

For

compatibility

of

warehouse

packs

with

Tivoli

Data

Warehouse,

Version

1.2,

see

the

documentation

for

each

applicable

warehouse

pack.

2

Release

Notes

Chapter

2.

Installation

information

This

chapter

provides

hardware

and

software

requirements.

Note:

If

your

systems

do

not

meet

the

hardware

and

software

requirements

listed

in

this

section,

you

might

receive

confusing

error

messages

and

have

problems

installing

and

using

Tivoli

Data

Warehouse.

Hardware

requirements

This

section

provides

information

about

the

hardware

requirements

for

installing

Tivoli

Data

Warehouse.

See

the

planning

chapter

in

Installing

and

Configuring

Tivoli

Data

Warehouse

for

database

sizing

formulas

and

considerations.

As

the

warehouse

pack

for

each

Tivoli

software

product

is

added

to

the

Tivoli

Data

Warehouse

installation,

additional

hard

disk

space

is

required.

See

the

documentation

for

each

warehouse

pack

for

application

planning

information

and

hard

disk

space

requirements.

Table

1

lists

the

minimum

and

recommended

hardware

requirements

for

Tivoli

Data

Warehouse.

Table

1.

Hardware

requirements

Deployment

type

Component

Minimum

requirements

Recommended

size

Temporary

hard

disk

space

Quick

start

All

v

512

MB

RAM

v

1

GB

hard

disk

space

v

933

MHz

processor

v

1

GB

RAM

v

3

GB

hard

disk

space

1

GB

Distributed

Control

server

v

512

MB

RAM

v

800

MB

hard

disk

space

v

933

MHz

processor

v

1

GB

RAM

v

1

GB

hard

disk

space

1

GB

Central

data

warehouse

v

512

MB

RAM

v

10

GB

hard

disk

space

v

933

MHz

processor

v

1

GB

RAM

v

20

GB

hard

disk

space

1

GB

Data

mart

v

512

MB

RAM

v

1

GB

hard

disk

space

v

933

MHz

processor

v

1

GB

RAM

v

3

GB

hard

disk

space

1

GB

Note:

The

quick

start

deployment

is

convenient

for

small

installations;

thus,

it

requires

less

space.

©

Copyright

IBM

Corp.

2002,

2003

3

Software

requirements

This

section

provides

information

about

the

software

requirements

for

Tivoli

Data

Warehouse.

The

following

table

lists

the

operating

systems

supported

by

Tivoli

Data

Warehouse.

Table

2.

Supported

operating

systems

Operating

system

Data

source1

Warehouse

agents

Control

server

Central

data

warehouse

Data

mart

Microsoft®

Windows

NT®,

service

pack

6

or

higher

and

Microsoft

Data

Access

Components

(MDAC)

2.7

service

pack

1

Windows®

2000

Server,

service

pack

2

or

higher

Windows

2000

Advanced

Server,

service

pack

2

or

higher

Windows

Server

2003

Yes

Yes

Yes

Yes

Yes

IBM

AIX®,

Versions

4.3.3,

5.1,

and

5.2

Yes

Yes

No

Yes

Yes

Sun

Solaris,

Versions

2.8

and

2.9

Yes

Yes

No

Yes

Yes

RedHat

Linux,

Versions

7.2,

7.3,

and

Advanced

Server

2.1

Yes

No

No

No

No

SuSE

Linux,

Versions

7.2,

7.3,

and

8.0

Yes

No

No

No

No

Turbo

Linux

7

Yes

No

No

No

No

z/OS,

V1R2,

V1R3,

and

V1R4

Yes

No

No

Yes

Yes

1

Data

source

support

is

determined

by

ODBC

support

in

DB2

releases.

Database

requirements

Table

3

lists

the

databases

that

are

supported

by

the

Tivoli

Data

Warehouse

components.

In

addition,

Tivoli

Data

Warehouse

supports

file

imports

from

the

Merant

driver

as

a

data

source.

Table

3.

Supported

relational

database

management

systems

Database

systems

Data

sources1

Control

database

Central

data

warehouse

Data

mart

DB2

Universal

Database

Enterprise

Edition,

Version

8.1

on

Windows,

AIX,

and

Solaris

Yes

No

No

No

4

Release

Notes

Table

3.

Supported

relational

database

management

systems

(continued)

Database

systems

Data

sources1

Control

database

Central

data

warehouse

Data

mart

DB2

Universal

Database

Enterprise

Edition,

Version

7.2

on

Windows

Yes

Yes2

Yes2

Yes2

DB2

Universal

Database

Enterprise

Edition,

Version

7.2

on

AIX

and

Solaris

Yes

No

Yes2

Yes2

DB2

Universal

Database

for

z/OS

and

OS/390®,

Version

7

with

IBM

Data

Management

Tools,

Management

Tools

Package

for

DB2

V7

on

z/OS;

FMID

JDB771D

Yes

No

Yes

Yes

DB2

Universal

Database,

Version

6

or

higher

on

Windows,

AIX,

and

Solaris

Yes

No

No

No

Oracle

client,

Version

8.1.7

and

either:

v

Oracle,

Version

8.1.7

on

Windows,

AIX,

and

Solaris

v

Oracle,

Version

9i

on

Windows,

AIX,

and

Solaris

Yes

No

No

No

Microsoft

SQL

Server,

Version

7.0

on

Windows

NT

Microsoft

SQL

Server

2000

on

Windows

2000

Yes

No

No

No

Sybase,

Version

12.0.0.8

and

12.5

Yes

No

No

No

Informix®

Dynamic

Server

2000

Yes

No

No

No

1

Data

source

support

is

determined

by

ODBC

support

in

DB2

releases.

2

Fix

pack

8

with

its

eFix,

fix

pack

9,

fix

pack

10,

or

fix

pack

10a

for

DB2

Universal

Database,

Version

7.2

is

required.

Fix

pack

10a

is

shipped

with

Tivoli

Data

Warehouse,

Version

1.2.

See

page

6

for

fix

pack

10

and

10a

limitations.

Table

4

on

page

6

lists

the

DB2

requirements

for

each

Tivoli

Data

Warehouse

component.

Chapter

2.

Installation

information

5

Table

4.

DB2

requirements

Deployment

type

Component

DB2

requirement

Quick

start

All

DB2

server

Distributed

Control

server

DB2

server

Central

data

warehouse

DB2

server

Data

mart

DB2

server

Crystal

Enterprise

server

DB2

client

Report

interface

requirements

To

view

and

publish

reports,

Tivoli

Data

Warehouse

requires

Crystal

Enterprise

9.

Crystal

Enterprise

Professional

v.9

is

shipped

with

Tivoli

Data

Warehouse.

For

information

about

Crystal

Enterprise

requirements,

see

the

documentation

on

the

Crystal

Enterprise

CD.

Installation

and

upgrade

notes

This

section

provides

information

about

the

Tivoli

Data

Warehouse

installation.

Review

the

information

in

this

section

before

you

begin

your

installation.

v

The

fully

qualified

host

name

must

appear

first

in

the

/etc/hosts

list.

For

example,

the

entry

should

look

like

this:

7.23.29.160

gomez.lab.ibm.com

gomez

The

following

is

an

incorrect

configuration:

7.23.29.160

gomez

gomez.lab.ibm.com

v

APAR

JR19393:

Due

to

a

problem

with

DB2

Version

7.2

fix

pack

10

and

10a,

you

must

run

additional

SQL

manually

for

this

installation

scenario

(order

is

significant):

1.

Warehouse

packs

for

Tivoli

Enterprise™

Data

Warehouse,

Version

1.1

that

contain

data

mart

ETLs

are

installed.

2.

Tivoli

Data

Warehouse,

Version

1.2

is

installed.

3.

You

plan

to

install

fix

pack

10

or

10a

after

Tivoli

Data

Warehouse,

Version

1.2

is

installed.

Or,

you

use

DB2

Warehouse

Control

Database

Management

to

migrate

and

initialize

the

control

database.

Immediately

after

step

3

from

the

preceding

scenario,

you

must

run

the

following

SQL

against

the

TWH_MD

database

on

the

control

server.

Use

the

DB2

ID

and

password

you

specified

when

you

installed

Tivoli

Data

Warehouse.

insert

into

iwh.attributelink

(iwhid,updated_by,update_ts,name,

short_desciption,type,operatorexp,useandsep,orderno,operexp2)

(select

source_iwhid,’db2admin’,’2003-11-20-19.13.48.000000’,

’’,’’,’JOIN’,’’,1,0,’=’

from

iwh.relationship

where

relation_name=’StarSchema_TO_AttLnk’

and

source_iwhid

not

in

(select

iwhid

from

iwh.attributelink))

Note:

The

update_by

and

update_ts

values,

which

are

hardcoded

above,

can

be

changed

to

other

values.Do

not

attempt

to

install

the

fix

pack

a

second

time.

The

rebuilding

of

the

metadata

will

not

work.

For

more

information

about

this

problem,

refer

to

the

DB2

documentation.

v

If

the

core

installation

of

Tivoli

Data

Warehouse

fails,

the

control

server

installs

successfully,

and

you

rerun

the

installation

wizard,

you

must

manually

reboot

6

Release

Notes

the

computer

where

the

control

server

is

created

before

you

can

use

the

control

server,

central

data

warehouses,

or

data

marts.

v

When

installing

or

upgrading

a

warehouse

pack,

you

might

receive

one

of

the

following

error

messages:

CDWIW0066W,

CDWIW0067E,

CDWIS0043W,

or

CDWIS0044E.

In

these

situations,

refer

to

the

IBM

Software

Support

Web

site

and

the

support

flashes

for

each

appropriate

application

for

warehouse

pack

fixes.

v

To

uninstall

warehouse

packs

for

IBM

Tivoli

Monitoring,

you

must

remove

the

base

warehouse

pack

with

the

product

code

AMY

first

and

separately

before

removing

any

other

warehouse

packs

for

IBM

Tivoli

Monitoring.

See

the

documentation

for

IBM

Tivoli

Monitoring

for

additional

information.

Chapter

2.

Installation

information

7

8

Release

Notes

Chapter

3.

Known

limitations,

problems,

and

workarounds

This

section

provides

information

about

known

software

limitations

and

defects

for

Tivoli

Data

Warehouse,

Version

1.2.

The

problem

determination

chapter

of

Installing

and

Configuring

Tivoli

Data

Warehouse,

GC32-0744

provides

debugging

information

for

installation,

configuration,

and

other

problems.

It

also

describes

how

to

obtain

information

to

debug

problems.

Limitations

This

section

describes

the

limitations

of

Tivoli

Data

Warehouse.

v

On

some

windows

of

the

installation

wizards,

the

button

text

might

be

truncated.

This

is

a

limitation

of

the

InstallShield

Multiplatform

product

used

for

the

installation

process.

Even

if

button

text

is

truncated,

the

button

action

works

correctly.

v

After

the

initial

installation

of

Tivoli

Data

Warehouse,

adding

central

data

warehouses

and

data

marts

to

the

control

server

can

fail

if

the

port

for

the

DB2

server

is

not

set

to

the

default

50000.

In

the

Tivoli

Data

Warehouse

installation

wizard,

you

must

set

the

Host

Location

in

the

Central

Data

Warehouse

Properties

window

to

be

remote

and

specify

the

port

number

to

use.

v

When

you

change

to

a

new

Crystal

Enterprise

server,

the

Everyone

group

privileges

are

affected

by

the

import

Tivoli

process.

After

running

the

twh_update_rptsrv

command,

reset

the

permissions

as

required.

v

Some

migrated

reports

with

specific

sets

of

data

might

cause

X-axis

labels

to

be

truncated

or

overwritten.

This

is

due

to

the

Crystal

Enterprise

limitation

that

a

graph

must

fit

on

a

physical

page.

v

When

viewing

reports

with

the

ePortfolio,

if

you

select

the

drop-down

box

to

choose

a

specific

time

frame,

the

date

and

time

values

are

reset

to

their

default

value.

v

If

Information

Catalog

Manager

(ICM)

Version

7

is

installed

on

the

same

Windows

NT

or

Windows

2000

system

as

Sybase

Open

Client,

an

error

occurs

and

the

Sybase

Utilities

stops.

An

error

message

similar

to

the

following

is

displayed:

Fail

to

initialize

LIBTCL.DLL.

Please

make

sure

the

SYBASE

environment

variable

is

set

correctly.

Remove

the

LC_ALL

environment

parameter

from

the

Windows

environment

parameters

to

correct

this

problem.

Note

that

if

you

remove

the

LC_ALL

environment,

the

following

ICM

functions

are

disabled:

–

Information

Catalog

User

–

Information

Catalog

Administrator

–

Information

Catalog

Manager

LC_ALL

is

a

locale

category

parameter.

Locale

categories

are

manifest

constants

used

by

the

localization

routines

to

specify

which

portion

of

the

locale

information

a

program

should

use.

The

locale

refers

to

the

locality

(country

or

region)

for

which

certain

aspects

of

a

program

can

be

customized.

©

Copyright

IBM

Corp.

2002,

2003

9

Locale-dependent

areas

include,

for

example,

the

formatting

of

dates,

or

the

display

format

for

monetary

values.

LC_ALL

affects

all

categories

of

locale-specific

behavior.

Use

the

following

procedure

to

remove

the

LC_

ALL

environment

parameter:

1.

On

the

task

bar,

select

the

Start

button

→

Settings

→

Control

Panel

→

System.

The

System

Properties

window

is

displayed.

2.

Select

the

Environment

tab.

3.

Select

LC_ALL.

4.

Click

Delete.v

When

using

Sybase,

the

following

error

message

might

be

displayed:

The

’CREATE

TABLE’

command

is

not

allowed

within

a

multi-statement

transaction

in

the

’database_name’

database

Workaround:

1.

From

the

ISQL

command

line,

enter

use

master.

2.

Enter

go.

3.

Enter

sp_dboption

dbname,"ddl

in

tran",true,

where

dbname

is

the

name

of

the

database.

4.

Enter

go.

The

following

message

is

displayed:

Database

option

’ddl

in

tran’

turned

ON

for

database

’dbname’

Run

the

CHECKPOINT

command

in

the

database

that

was

changed.

(return

status

=

0)

5.

Enter

use

dbname.

6.

Enter

go.

7.

Enter

checkpoint.

8.

Enter

go.

9.

Enter

quit.

Known

problems

and

workarounds

This

section

provides

information

about

known

problems

with

Tivoli

Data

Warehouse.

Workarounds

are

provided

for

some

problems.

Defects

listed

here

apply

to

all

languages.

For

information

about

defects

associated

with

specific

languages,

see

“Internationalization

problems”

on

page

11.

Installation

or

uninstallation

problems

v

On

AIX

and

Solaris,

the

vwdaemon

process

does

not

always

restart

after

the

installation

of

the

DB2

Warehouse

Manager.

Workaround:

Reboot

the

AIX

or

Solaris

system

after

the

installation

of

the

DB2

Warehouse

Manager.

v

Defect

164948:

On

z/OS,

the

installation

of

Tivoli

Data

Warehouse

might

fail

if

the

values

provided

in

the

installation

wizard

are

not

valid.

Also,

the

resources

specified

in

the

installation

wizard

must

be

available

at

the

time

of

installation.

The

following

error

might

be

displayed:

CDWIC0022E

The

installation

program

cannot

run

SQL

script

sql_script.

Workaround:

Ensure

that

the

values

provided

in

the

installation

wizard

are

valid

and

that

the

resources

specified

in

the

installation

wizard

are

available

at

the

time

of

installation.

Review

the

execsql2_message_log.log

to

determine

where

the

failure

occurred

in

the

database

script.

10

Release

Notes

v

Defect

167717:

When

you

install

a

warehouse

pack

and

use

the

default

schedule

to

run

the

extract,

transform,

and

load

(ETL)

processes,

the

default

start

date

is

December

15,

2002

(12/15/2002).

Nonetheless,

your

scheduled

ETLs

will

run

successfully

after

installation.

Report

interface

problem

v

Defect

163415:

Extreme

case

reports

that

had

an

ascending

output

in

Tivoli

Enterprise

Data

Warehouse,

Version

1.1

can

only

run

with

a

descending

output

after

migration

to

Tivoli

Data

Warehouse,

Version

1.2.

Miscellaneous

problems

v

PMR

17980

br499:

Steps

of

an

ETL

process

might

fail

randomly

in

the

DB2

Data

Warehouse

Center.

Refer

to

IBM

Software

Support

for

DB2

Universal

Database

for

more

information.

v

Defect

167862:

When

incorrect

command

line

parameters

are

entered

for

the

administrative

utilities,

a

response

similar

to

the

following

is

generated:

twh_core_admin.pl

:

unrecognized

option

’-r’

Try

’twh_core_admin.pl

--help’

for

more

information.

Workaround:

You

must

omit

the

text

.pl

from

the

statement.

For

example,

use

the

following

statement:

twh_core_admin

--help

v

Defect

157941:

In

the

DB2

Data

Warehouse

Center,

the

Processing

Options

tab

of

the

Step

Properties

window

displays

this

message:

The

selected

agent

site

is

invalid

This

message

can

be

safely

ignored.

v

Defect

153132:

In

some

cases

when

you

use

the

DB2

Data

Warehouse

Center

to

run

steps,

the

characters

&LT

and

&GT

appear

in

pop-up

messages.

The

DB2

Data

Warehouse

Center

has

a

limitation

of

not

displaying

the

greater

than

symbol

(>)

and

the

less

than

symbol

(<).

Internationalization

problems

This

section

provides

information

about

known

problems

with

the

non-English

language

versions

of

Tivoli

Data

Warehouse.

Note:

Some

defects

described

in

“Known

problems

and

workarounds”

on

page

10

might

affect

translated

versions

of

Tivoli

Data

Warehouse.

v

Tivoli

Data

Warehouse

cannot

be

installed

in

directories

that

are

named

using

the

double-byte

character

set

(DBCS).

Workaround:

Install

Tivoli

Data

Warehouse

in

a

directory

that

is

named

using

the

single-byte

character

set

(SBCS).

v

InstallShield

Multiplatform

and

its

Java™

Virtual

Machine

(JVM)

have

documented

issues

regarding

DBCS

locales.

Examples

of

problems

that

might

occur

in

this

product

are

extra

spaces

between

characters,

truncation

of

characters,

and

unreadable

default

fonts.

Chapter

3.

Known

limitations,

problems,

and

workarounds

11

12

Release

Notes

Chapter

4.

Documentation

updates

This

section

contains

updates

to

the

Tivoli

Data

Warehouse

library.

Additional

troubleshooting

scenarios

In

addition

to

the

common

problems

described

in

Installing

and

Configuring

Tivoli

Data

Warehouse,

the

following

are

other

troubleshooting

scenarios:

v

Possible

problem:

Reports

might

not

run

from

the

schedule

in

the

ePortfolio

or

Crystal

Management

Console.

Or,

you

cannot

view

reports.

Solutions:

–

Ensure

that

the

ODBC

name

defined

on

the

Crystal

Enterprise

server

matches

the

name

specified

on

the

report

database

tab

in

the

Crystal

Management

Console.

The

case

of

the

name

must

match.

If

you

cannot

resolve

the

issue,

select

DB2

as

the

database

driver

on

the

report

database

tab

rather

than

ODBC.

–

After

installing

Tivoli

Data

Warehouse,

you

must

create

a

connection

from

the

Crystal

Enterprise

server

to

any

data

mart

you

created

during

the

installation.

The

first

ODBC

data

source

is

named

TWH_MART

for

the

data

mart

named

TWH_MART

and

subsequent

ODBC

data

sources

are

named

TWH_MARTn

for

data

marts

named

TMARTn,

where

n

indicates

the

data

mart

number

starting

with

″1″.

When

you

install

a

warehouse

pack,

this

connection

allows

you

to

publish

reports

to

the

Crystal

Enterprise

server.

When

the

ODBC

data

source

name

and

the

database

name

do

not

match,

complete

the

following

steps

after

installing

the

warehouse

pack

to

be

able

to

view

the

reports:

1.

In

the

Crystal

Management

Console,

click

Manage

Objects.

2.

In

Objects,

click

the

report

you

installed

and

then

click

the

Database

tab.

3.

In

the

Data

Source(s)

list,

select

the

ODBC

data

source.

4.

Select

Use

custom

database

logon

information

specified

here

and

select

ODBC

from

the

Select

a

database

driver

pull-down

list.

5.

Click

Update.

You

can

now

view

the

report

in

ePortfolio.v

Possible

problem:

ETL

processes

fail.

The

processes

ran

successfully

before

upgrading

to

version

1.2.

You

might

see

this

error

message:

DWC08410E

The

agent

was

unable

to

execute

a

Data

Warehouse

Center

Program.

Solution:

Ensure

that

the

user

ID

for

the

DB2

Data

Warehouse

Center

source

defined

under

Warehouse

Sources

matches

the

schema

name

in

the

source

database.

v

Possible

problem:

Traditional

Chinese

is

not

selected

for

View

on

Demand

reports

when

the

browser

settings

specify

traditional

Chinese.

Solution:

Schedule

the

report

and

select

traditional

Chinese

from

the

language

list.

©

Copyright

IBM

Corp.

2002,

2003

13

Upgrades

from

version

1.1

to

version

1.2

Installing

and

Configuring

Tivoli

Data

Warehouse

states

you

must

apply

fix

pack

1.1-TDW-FP02

before

you

upgrade

from

Tivoli

Enterprise

Data

Warehouse,

Version

1.1

to

Tivoli

Data

Warehouse,

Version

1.2.

In

fact,

you

can

apply

either

fix

pack

1.1-TDW-FP02

or

fix

pack

1.1-TDW-FP03

before

upgrading.

Multiple

customer

environments

There

is

an

important

security

aspect

to

consider

for

star

schemas

in

the

multiple

customer

environment.

Tivoli

Data

Warehouse

requires

customers

to

create

database

users

that

include

specific

grants

to

only

their

applicable

views.

When

views

are

created

for

specific

customers,

the

users

give

access

to

the

views

by

database

ID

and

their

access

to

views

is

separated

between

different

customer

users.

In

addition

to

the

steps

in

the

warehouse

pack

installation

chapter

of

Installing

and

Configuring

Tivoli

Data

Warehouse,

you

must

perform

this

step

when

configuring

multiple

customer

environments:

v

Update

the

customer

views

in

the

data

mart.

Placeholder

views

are

created

for

each

fact

and

dimension

table

when

the

warehouse

pack

is

installed,

but

you

must

customize

the

views

with

an

entry

for

each

of

your

customers.

The

implementation

guide

for

the

warehouse

pack

should

list

the

views

you

need

to

update.

If

it

does

not,

you

can

look

at

the

definition

of

the

views

in

the

file

%TWH_TOPDIR\apps\productCode\version\mart\ddl\

productCode_mart_schema.generic

script.

For

example,

the

following

SQL

statements

create

a

customer

view

for

the

fact

and

dimension

table

XYZ.F_DM_hour

and

XYZ.D_DM_host

of

the

warehouse

pack

with

product

code

XYZ.

#Run

this

set

of

inserts

to

create

views

for

each

customer.

#You

must

replace

cust_id

with

your

valid

customer

ID,

#and

code

inserts

for

each

customer.

Create

view

XYZ.F_V_DM_cust_id_hour

as

(select

*

from

XYZ.F_DM_hour

where

host_id

in

(select

host_id

from

d_dm_host

where

cust_id

=

cust_id));

Create

view

XYZ.D_V_DM_host_cust_id

as

(select

*

from

XYZ.D_DM_host

where

cust_id

=

cust_id);

For

maintenance

of

multiple

customer

environments,

you

need

to

regularly

reexamine

your

configuration

and

update

it

as

necessary.

List

commands

The

following

information

replaces

the

log

and

output

documentation

for

the

twh_list_agentsites,

twh_list_cdws,

twh_list_cs,

and

twh_list_marts

commands

in

Installing

and

Configuring

Tivoli

Data

Warehouse.

The

messages

for

the

list

commands

are

logged

to

%TIVOLI_COMMON_DIR%\cdw\logs\tools\TWHListCmds_message_log.log.

Additionally,

the

trace

messages

are

logged

to

%TIVOLI_COMMON_DIR%\cdw\logs\tools\TWHListCmds_trace_log.

The

output

for

the

list

commands

does

not

contain

the

following

line:

Press

any

key

to

continue...

14

Release

Notes

Messages

The

following

are

changes

and

additions

to

the

Tivoli

Data

Warehouse

messages:

CDWIC0007E

An

argument

argument

that

is

not

valid

was

found

in

the

configuration

file

file_name.

Or,

the

computer

is

not

set

up

to

use

fully

qualified

host

names.

Explanation:

The

installation

program

attempted

to

validate

the

configuration

file

and

found

the

specified

argument

is

not

valid.

If

the

parameter

listed

is

LOCAL

HOST,

the

installation

program

might

have

attempted

to

install

to

a

computer

that

does

not

use

fully

qualified

host

names.

Administrator

Response:

Ensure

that

fully

qualified

host

names

are

configured.

If

the

host

name

is

fully

qualified,

run

FFDC

and

contact

IBM

Customer

Support.

CDWLS0003E

The

program

that

runs

list

commands

failed

with

an

error.

Explanation:

The

list

commands

program

failed.

Administrator

Response:

Run

FFDC

and

contact

IBM

Customer

Support.

CDWIS0026E

The

program

cannot

open

port

port

on

remote

host

host.

Explanation:

The

program

attempted

to

open

the

specified

port

on

the

specified

host

and

failed.

Administrator

Response:

Verify

that

the

host

name

and

port

number

are

correct.

Also,

verify

that

the

port

is

active

on

the

host.

Chapter

4.

Documentation

updates

15

16

Release

Notes

Chapter

5.

Contacting

customer

support

If

you

have

a

problem

with

any

Tivoli

product,

refer

to

the

following

IBM

Software

Support

Web

site:

http://www.ibm.com/software/sysmgmt/products/support/

If

you

have

a

problem

with

Tivoli

Data

Warehouse,

refer

to

the

following

IBM

Support

Web

site:

http://www-3.ibm.com/software/sysmgmt/products/support/TivoliDataWarehouse.html

If

you

have

a

problem

with

a

DB2

product,

refer

to

the

following

IBM

Software

Support

Web

site:

http://www.ibm.com/software/data/db2

If

you

want

to

contact

customer

support,

see

the

IBM

Software

Support

Guide

at

the

following

Web

site:

http://techsupport.services.ibm.com/guides/handbook.html

The

guide

provides

information

about

how

to

contact

IBM

Software

Support,

depending

on

the

severity

of

your

problem,

and

the

following

information:

v

Registration

and

eligibility

v

Telephone

numbers

and

e-mail

addresses,

depending

on

the

country

in

which

you

are

located

v

Information

you

must

have

before

contacting

IBM

Software

Support

©

Copyright

IBM

Corp.

2002,

2003

17

18

Release

Notes

Appendix.

Notices

This

information

was

developed

for

products

and

services

offered

in

the

U.S.A.

IBM

may

not

offer

the

products,

services,

or

features

discussed

in

this

document

in

other

countries.

Consult

your

local

IBM

representative

for

information

on

the

products

and

services

currently

available

in

your

area.

Any

reference

to

an

IBM

product,

program,

or

service

is

not

intended

to

state

or

imply

that

only

that

IBM

product,

program,

or

service

may

be

used.

Any

functionally

equivalent

product,

program,

or

service

that

does

not

infringe

any

IBM

intellectual

property

right

may

be

used

instead.

However,

it

is

the

user’s

responsibility

to

evaluate

and

verify

the

operation

of

any

non-IBM

product,

program,

or

service.

IBM

may

have

patents

or

pending

patent

applications

covering

subject

matter

described

in

this

document.

The

furnishing

of

this

document

does

not

give

you

any

license

to

these

patents.

You

can

send

license

inquiries,

in

writing,

to:

IBM

Director

of

Licensing

IBM

Corporation

North

Castle

Drive

Armonk,

NY

10504-1785

U.S.A.

For

license

inquiries

regarding

double-byte

(DBCS)

information,

contact

the

IBM

Intellectual

Property

Department

in

your

country

or

send

inquiries,

in

writing,

to:

IBM

World

Trade

Asia

Corporation

Licensing

2-31

Roppongi

3-chome,

Minato-ku

Tokyo

106,

Japan

The

following

paragraph

does

not

apply

to

the

United

Kingdom

or

any

other

country

where

such

provisions

are

inconsistent

with

local

law:

INTERNATIONAL

BUSINESS

MACHINES

CORPORATION

PROVIDES

THIS

PUBLICATION

″AS

IS″

WITHOUT

WARRANTY

OF

ANY

KIND,

EITHER

EXPRESS

OR

IMPLIED,

INCLUDING,

BUT

NOT

LIMITED

TO,

THE

IMPLIED

WARRANTIES

OF

NON-INFRINGEMENT,

MERCHANTABILITY

OR

FITNESS

FOR

A

PARTICULAR

PURPOSE.

Some

states

do

not

allow

disclaimer

of

express

or

implied

warranties

in

certain

transactions,

therefore,

this

statement

might

not

apply

to

you.

This

information

could

include

technical

inaccuracies

or

typographical

errors.

Changes

are

periodically

made

to

the

information

herein;

these

changes

will

be

incorporated

in

new

editions

of

the

publication.

IBM

may

make

improvements

and/or

changes

in

the

product(s)

and/or

the

program(s)

described

in

this

publication

at

any

time

without

notice.

Any

references

in

this

information

to

non-IBM

Web

sites

are

provided

for

convenience

only

and

do

not

in

any

manner

serve

as

an

endorsement

of

those

Web

sites.

The

materials

at

those

Web

sites

are

not

part

of

the

materials

for

this

IBM

product

and

use

of

those

Web

sites

is

at

your

own

risk.

©

Copyright

IBM

Corp.

2002,

2003

19

IBM

may

use

or

distribute

any

of

the

information

you

supply

in

any

way

it

believes

appropriate

without

incurring

any

obligation

to

you.

Licensees

of

this

program

who

wish

to

have

information

about

it

for

the

purpose

of

enabling:

(i)

the

exchange

of

information

between

independently

created

programs

and

other

programs

(including

this

one)

and

(ii)

the

mutual

use

of

the

information

which

has

been

exchanged,

should

contact:

IBM

Corporation

2Z4A/101

11400

Burnet

Road

Austin,

TX

78758

U.S.A.

Such

information

may

be

available,

subject

to

appropriate

terms

and

conditions,

including

in

some

cases

payment

of

a

fee.

The

licensed

program

described

in

this

document

and

all

licensed

material

available

for

it

are

provided

by

IBM

under

terms

of

the

IBM

Customer

Agreement,

IBM

International

Program

License

Agreement

or

any

equivalent

agreement

between

us.

Any

performance

data

contained

herein

was

determined

in

a

controlled

environment.

Therefore,

the

results

obtained

in

other

operating

environments

may

vary

significantly.

Some

measurements

may

have

been

made

on

development-level

systems

and

there

is

no

guarantee

that

these

measurements

will

be

the

same

on

generally

available

systems.

Furthermore,

some

measurement

may

have

been

estimated

through

extrapolation.

Actual

results

may

vary.

Users

of

this

document

should

verify

the

applicable

data

for

their

specific

environment.

Information

concerning

non-IBM

products

was

obtained

from

the

suppliers

of

those

products,

their

published

announcements

or

other

publicly

available

sources.

IBM

has

not

tested

those

products

and

cannot

confirm

the

accuracy

of

performance,

compatibility

or

any

other

claims

related

to

non-IBM

products.

Questions

on

the

capabilities

of

non-IBM

products

should

be

addressed

to

the

suppliers

of

those

products.

All

statements

regarding

IBM’s

future

direction

or

intent

are

subject

to

change

or

withdrawal

without

notice,

and

represent

goals

and

objectives

only.

This

information

is

for

planning

purposes

only.

The

information

herein

is

subject

to

change

before

the

products

described

become

available.

This

information

contains

examples

of

data

and

reports

used

in

daily

business

operations.

To

illustrate

them

as

completely

as

possible,

the

examples

include

the

names

of

individuals,

companies,

brands,

and

products.

All

of

these

names

are

fictitious

and

any

similarity

to

the

names

and

addresses

used

by

an

actual

business

enterprise

is

entirely

coincidental.

COPYRIGHT

LICENSE:

This

information

contains

sample

application

programs

in

source

language,

which

illustrate

programming

techniques

on

various

operating

platforms.

You

may

copy,

modify,

and

distribute

these

sample

programs

in

any

form

without

payment

to

IBM,

for

the

purposes

of

developing,

using,

marketing

or

distributing

application

programs

conforming

to

the

application

programming

interface

for

the

operating

platform

for

which

the

sample

programs

are

written.

These

examples

have

not

20

Release

Notes

been

thoroughly

tested

under

all

conditions.

IBM,

therefore,

cannot

guarantee

or

imply

reliability,

serviceability,

or

function

of

these

programs.

You

may

copy,

modify,

and

distribute

these

sample

programs

in

any

form

without

payment

to

IBM

for

the

purposes

of

developing,

using,

marketing,

or

distributing

application

programs

conforming

to

IBM‘s

application

programming

interfaces.

If

you

are

viewing

this

information

in

softcopy

form,

the

photographs

and

color

illustrations

might

not

display.

Trademarks

IBM,

the

IBM

logo,

AIX,

DB2,

DB2

Universal

Database,

Informix,

Tivoli,

Tivoli

Enterprise,

Tivoli

Enterprise

Console,

OS/390,

and

z/OS

are

trademarks

or

registered

trademarks

of

International

Business

Machines

Corporation

in

the

United

States,

other

countries,

or

both.

Microsoft

and

Windows

NT

are

registered

trademarks

of

Microsoft

Corporation

in

the

United

States,

other

countries,

or

both.

Java

and

all

Java-based

trademarks

and

logos

are

trademarks

or

registered

trademarks

of

Sun

Microsystems,

Inc.

in

the

United

States

and

other

countries.

UNIX®

is

a

registered

trademark

of

The

Open

Group

in

the

United

States

and

other

countries.

Other

company,

product,

and

service

names

may

be

trademarks

or

service

marks

of

others.

Appendix.

Notices

21

22

Release

Notes

����

Printed

in

USA

SC32-1399-00