Tivoli Business

Systems

Manager

Troubleshooting

Guide

Version

3.1

SC32-9084-00

Tivoli Business

Systems

Manager

Troubleshooting

Guide

Version

3.1

SC32-9084-00

Note

Before

using

this

information

and

the

product

it

supports,

read

the

information

in

Notices

on

page

249.

October

2004

This

edition

applies

to

Version

3,

Release

1

of

IBM

Tivoli

Business

Systems

Manager

and

to

all

subsequent

releases

and

modifications

until

otherwise

indicated

in

new

editions.

Copyright

International

Business

Machines

Corporation

2000,

2004.

All

rights

reserved.

US

Government

Users

Restricted

Rights

Use,

duplication

or

disclosure

restricted

by

GSA

ADP

Schedule

Contract

with

IBM

Corp.

Contents

About

this

guide

.

.

.

.

.

.

.

.

.

.

. ix

Publications

.

.

.

.

.

.

.

.

.

.

.

.

.

. ix

IBM

Tivoli

Business

Systems

Manager

library

.

. ix

Related

publications

.

.

.

.

.

.

.

.

.

.

. x

Accessing

publications

online

.

.

.

.

.

.

.

. x

Ordering

publications

.

.

.

.

.

.

.

.

.

. xi

Accessibility

.

.

.

.

.

.

.

.

.

.

.

.

.

. xi

Tivoli

technical

training

.

.

.

.

.

.

.

.

.

. xi

Support

information

.

.

.

.

.

.

.

.

.

.

. xi

Participating

in

newsgroups

.

.

.

.

.

.

.

.

. xii

Conventions

used

in

this

guide

.

.

.

.

.

.

.

. xii

Typeface

conventions

.

.

.

.

.

.

.

.

.

. xii

Operating

system-dependent

variables

and

paths

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xiii

Terminology

.

.

.

.

.

.

.

.

.

.

.

.

.

. xiii

Chapter

1.

Getting

Started

with

Diagnosis

.

.

.

.

.

.

.

.

.

.

.

.

.

. 1

Finding

Solutions

.

.

.

.

.

.

.

.

.

.

.

.

. 1

Working

with

IBM

Software

Support

.

.

.

.

.

. 1

Using

Keywords

.

.

.

.

.

.

.

.

.

.

.

.

. 1

Building

a

Keyword

String

.

.

.

.

.

.

.

.

. 2

Uninstalling

and

Reinstalling

Issues

.

.

.

.

.

. 3

Chapter

2.

Troubleshooting

Source/390

Problems

.

.

.

.

.

.

.

.

.

.

.

.

.

. 5

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 5

z/OS

Components

.

.

.

.

.

.

.

.

.

.

. 5

The

Source/390

Object

Pump

.

.

.

.

.

.

. 5

The

Source/390

Object

Server

.

.

.

.

.

.

. 6

The

Source/390

Data

Space

.

.

.

.

.

.

. 6

Stopping

a

Component

.

.

.

.

.

.

.

.

.

. 7

Source/390

Object

Pump

Problems

.

.

.

.

.

.

. 8

Viewing

Traps

and

Global

Variables

.

.

.

.

. 8

How

to

specify

the

maximum

number

of

concurrent

commands

.

.

.

.

.

.

.

.

.

. 10

Source/390

Object

Server

Problems

.

.

.

.

.

. 10

TCP/IP

Connectivity

Problems

.

.

.

.

.

.

. 11

Enabling

Event

Tracing

for

TCP/IP

.

.

.

. 12

ASIMVSIPOSListenerSvc

.

.

.

.

.

.

. 12

ASIMVSIPListenerSvc

.

.

.

.

.

.

.

. 12

LU

6.2

Connectivity

Problems

.

.

.

.

.

.

. 12

Enabling

Event

Tracing

for

LU

6.2

.

.

.

.

. 14

Viewing

the

Source/390

Object

Server

Data

Transmission

Logs

.

.

.

.

.

.

.

.

.

.

. 14

Source/390

Dataspace

Problems

.

.

.

.

.

.

. 15

Full

Queues

.

.

.

.

.

.

.

.

.

.

.

.

. 16

Increasing

Queue

Capacity

.

.

.

.

.

.

.

. 16

Diagnostic

Tools

.

.

.

.

.

.

.

.

.

.

.

.

. 16

Using

Generalized

Trace

Facility

(GTF)

Trace

.

. 16

Generalized

Trace

Facility

.

.

.

.

.

.

. 16

GTF

Parameters

.

.

.

.

.

.

.

.

.

. 17

Trace

Points

.

.

.

.

.

.

.

.

.

.

.

. 17

Modify

Command

Interface

.

.

.

.

.

.

. 17

Troubleshooting

With

the

GTMAOPE0

Utility

.

. 17

Using

the

File

Receiver

Components

to

Simulate

z/OS

Event

Streams

.

.

.

.

.

.

.

.

.

. 18

Chapter

3.

Diagnostic

Tools

for

Services

and

Processes

.

.

.

.

.

.

. 19

Servers

Diagnostic

Overview

.

.

.

.

.

.

.

. 19

Tivoli

Business

Systems

Manager

Services

.

.

.

. 20

Message

Logging

and

Trace

Logging

.

.

.

.

.

. 23

Message

and

Trace

Logging

Support

.

.

.

.

. 23

Message

Logging

.

.

.

.

.

.

.

.

.

. 23

Trace

Logging

.

.

.

.

.

.

.

.

.

.

. 23

Logging

Levels

for

Message

and

Trace

Logging

.

.

.

.

.

.

.

.

.

.

.

.

. 24

Message

and

Trace

Logging

Configuration

.

.

. 24

Message

Logging

Configuration

.

.

.

.

. 24

Trace

Logging

Configuration

.

.

.

.

.

. 26

Setting

Server

Log

Levels

.

.

.

.

.

.

.

.

.

. 28

Log

Level

Description

.

.

.

.

.

.

.

.

.

. 28

Setting

the

Log

Level

.

.

.

.

.

.

.

.

.

. 28

Log

Format

.

.

.

.

.

.

.

.

.

.

.

.

. 29

Required

Vendor

Services

.

.

.

.

.

.

.

.

.

. 29

Utility

Programs

.

.

.

.

.

.

.

.

.

.

.

.

. 31

Third-Party

Command

Line

Utilities

.

.

.

.

.

. 32

Third-Party

Graphical

Utilities

.

.

.

.

.

.

.

. 33

Additional

Diagnostic

Tools

.

.

.

.

.

.

.

.

. 34

Using

the

Which

Command

.

.

.

.

.

.

.

. 34

Help

(for

Windows

and

MKS

Commands)

.

.

. 34

Getting

Help

on

a

Windows

Error

.

.

.

.

.

. 35

Getting

Help

on

an

Error

in

the

Windows

Event

Log

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 35

Connecting

to

a

Host

or

Drive

.

.

.

.

.

.

. 35

Executing

SQL

Stored

Procedures

.

.

.

.

.

. 35

Running

SQL

Scheduled

Tasks

.

.

.

.

.

.

. 36

Dumping

a

TBSMFileQueue

.

.

.

.

.

.

.

. 37

Removing

an

Entry

From

a

TBSMFileQueue

.

. 37

Deleting

a

TBSMFileQueue

.

.

.

.

.

.

.

. 37

Determining

the

Log

File

Name

For

a

Tivoli

Business

Systems

Manager

Component

.

.

.

. 37

Tailing

a

Text

File

.

.

.

.

.

.

.

.

.

.

. 38

Cat

a

Text

File

.

.

.

.

.

.

.

.

.

.

.

. 38

Using

Grep

to

Navigate

Through

a

Text

File

.

. 38

Verifying

that

the

Host

is

Active

.

.

.

.

.

. 39

Examining

the

Windows

Event

Log

(Application)

40

Checking

for

a

Process

.

.

.

.

.

.

.

.

. 40

Stopping

a

Process

.

.

.

.

.

.

.

.

.

.

. 40

Determining

the

Name

of

a

Service

.

.

.

.

. 41

Stopping

a

Service

.

.

.

.

.

.

.

.

.

.

. 42

Starting

a

Service

.

.

.

.

.

.

.

.

.

.

. 42

Pausing

a

Service

.

.

.

.

.

.

.

.

.

.

. 43

Continuing

a

Paused

Service

.

.

.

.

.

.

. 44

Recycling

a

Service

.

.

.

.

.

.

.

.

.

.

. 45

Setting

and

Displaying

the

Windows

Clock

Remotely

.

.

.

.

.

.

.

.

.

.

.

.

.

. 45

Using

SUM

to

Compare

Modules

.

.

.

.

.

. 46

Copyright

IBM

Corp.

2000,

2004

iii

Using

FILEVER

to

Obtain

the

Tivoli

Business

Systems

Manager

Release

Level

.

.

.

.

.

. 46

Writing

BAT

Files

.

.

.

.

.

.

.

.

.

.

. 46

Performance

Monitoring

.

.

.

.

.

.

.

.

.

. 47

Checking

a

Performance

Counter

.

.

.

.

.

. 47

Logging

a

Performance

Counter

.

.

.

.

.

. 49

Using

AutoTrace

.

.

.

.

.

.

.

.

.

.

.

.

. 50

Using

Dr.

Watson

to

Debug

.

.

.

.

.

.

.

.

. 51

Enabling

Dr.

Watson

.

.

.

.

.

.

.

.

.

. 51

Chapter

4.

Troubleshooting

Services

and

Processes

.

.

.

.

.

.

.

.

.

.

. 53

Communication

Services

.

.

.

.

.

.

.

.

.

. 54

SNA

Connectivity

Problems

.

.

.

.

.

.

.

. 54

makemvscomponents

.

.

.

.

.

.

.

.

. 55

Microsoft

Host

Integration

Server

Security

Issues

.

.

.

.

.

.

.

.

.

.

.

.

.

. 55

TPSTART

.

.

.

.

.

.

.

.

.

.

.

.

. 55

Registry

Entries

and

Microsoft

Host

Integration

Server

.

.

.

.

.

.

.

.

.

. 55

SNA

Tivoli

Business

Systems

Manager

MVSSenderSvc

Service

.

.

.

.

.

.

. 56

IP

Connectivity

Problems

.

.

.

.

.

.

.

.

. 57

IPOSListener

Service

.

.

.

.

.

.

.

.

. 57

IPListener

Service

.

.

.

.

.

.

.

.

.

. 58

IPSender

Service

.

.

.

.

.

.

.

.

.

.

. 58

TECListener

Service

.

.

.

.

.

.

.

.

. 59

MVSUpload

Rule

Service

.

.

.

.

.

.

.

.

.

. 59

Upload

Registration

EnqueueProxy

Client

Trace

.

. 61

MVSEventHandlerSvc

Service

.

.

.

.

.

.

.

. 62

Staged

Event

Loader

.

.

.

.

.

.

.

.

.

.

. 63

Database

Validater

.

.

.

.

.

.

.

.

.

.

.

. 65

Notification

and

Propagation

.

.

.

.

.

.

.

. 66

Determining

Which

Process

is

Causing

the

Problem

.

.

.

.

.

.

.

.

.

.

.

.

.

. 66

Notification

Problems

.

.

.

.

.

.

.

.

.

. 66

Propagation

Problems

.

.

.

.

.

.

.

.

.

. 67

Agent

Listener

.

.

.

.

.

.

.

.

.

.

.

.

. 68

Events

Sent

to

Agent

Listener

But

Not

Displayed

in

Tivoli

Business

Systems

Manager

.

.

.

.

. 68

Table

Definitions

in

the

Agent

Listener

.

.

.

. 70

EIF

Sender

Service

.

.

.

.

.

.

.

.

.

.

.

. 71

Missing

or

Incorrect

Tivoli

Service

Level

Advisor

Events

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 73

SLA

Event

Database

Tables

.

.

.

.

.

.

.

. 76

Task

Server

.

.

.

.

.

.

.

.

.

.

.

.

.

. 79

Host

Not

Available

.

.

.

.

.

.

.

.

.

.

. 79

Corrupted

Data

.

.

.

.

.

.

.

.

.

.

.

. 79

User

or

Password

is

Not

Valid

.

.

.

.

.

.

. 79

Task

Reply

Is

Not

Displayed

.

.

.

.

.

.

.

. 80

Health

Monitor

Service

.

.

.

.

.

.

.

.

.

. 80

Client

Workspace

Not

Displayed

Properly

.

.

. 80

Database

Queues

and

States

Other

Than

Green

81

Browsing

Log

and

Data

Files

.

.

.

.

.

.

.

. 82

Using

the

Log

File

Browser

Utility

.

.

.

.

.

. 82

Starting

The

Log

File

Browser

Application

.

. 82

Using

the

Data

File

Browser

Utility

.

.

.

.

. 82

Starting

The

Data

File

Browser

Application

.

.

. 83

Console

Server

.

.

.

.

.

.

.

.

.

.

.

.

. 83

Configuring

WebSphere

.

.

.

.

.

.

.

.

. 83

Server

Preferences

Pages

.

.

.

.

.

.

.

.

. 83

Using

the

Server

Status

Page

.

.

.

.

.

. 84

Using

Server

Statistics

.

.

.

.

.

.

.

.

. 84

Server

Statistic

Values

.

.

.

.

.

.

.

. 84

Using

the

Server

Trace

.

.

.

.

.

.

.

.

. 86

Console

Logs

.

.

.

.

.

.

.

.

.

.

.

.

. 87

Using

Console

Logging

.

.

.

.

.

.

.

. 87

Understanding

the

Console

Log

Format

.

. 87

Viewing

Logs

.

.

.

.

.

.

.

.

.

.

. 91

Excessive

Growth

of

Log

Files

.

.

.

.

.

. 93

Troubleshooting

Percentage

Based

Thresholds

.

.

. 93

PBTs

at

the

System

Level

.

.

.

.

.

.

.

.

. 93

PBTs

at

the

Object

Level

.

.

.

.

.

.

.

.

. 94

Troubleshooting

PBTs

at

the

System

Level

.

.

. 94

Auto

Ticketing

.

.

.

.

.

.

.

.

.

.

.

.

. 94

Auto

Ticketing

Rules

.

.

.

.

.

.

.

.

.

. 95

Viewing

the

Log

File

.

.

.

.

.

.

.

.

.

. 95

Problems

Processing

Events

.

.

.

.

.

.

.

. 95

Auto

Ticketing

Queues

.

.

.

.

.

.

.

.

. 96

AutoTicketEvent

Queue

.

.

.

.

.

.

.

. 96

AutoTicketFilteredEvent

Queue

.

.

.

.

.

. 97

Messages

.

.

.

.

.

.

.

.

.

.

.

.

. 98

Chapter

5.

Troubleshooting

Console

Problems

.

.

.

.

.

.

.

.

.

.

.

.

.

. 99

Installation

.

.

.

.

.

.

.

.

.

.

.

.

.

. 99

Windows

.

.

.

.

.

.

.

.

.

.

.

.

.

. 99

UNIX

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 99

Enabling

Console

Debugging

Mode

.

.

.

.

.

. 99

Enabling

Console

Tracing

.

.

.

.

.

.

.

.

. 100

Image

Manager

and

Image

Problems

.

.

.

.

. 100

Displaying

Default

Icons

.

.

.

.

.

.

.

. 100

Displaying

a

Visual

Indication

on

Business

System

Shortcuts

.

.

.

.

.

.

.

.

.

.

. 101

Launch

Problems

.

.

.

.

.

.

.

.

.

.

.

. 101

Menu

Item

Problem

.

.

.

.

.

.

.

.

.

. 101

Menu

Item

Does

Not

Appear

on

the

Context

Menu

of

the

Expected

Resource

Type

.

.

. 101

No

Menu

Items

or

Just

the

Copy

Menu

Item

102

Attributes

are

not

Replaced

.

.

.

.

.

.

. 103

Defining

Callers

of

the

Method

.

.

.

.

. 103

Defining

Methods

.

.

.

.

.

.

.

.

.

. 103

Terminating

Method

Definition

.

.

.

.

. 104

Defining

the

Parameter

Type

.

.

.

.

.

. 104

Defining

Callers

of

the

Method

.

.

.

.

. 104

Launch

Succeeds,

but

Launch

Failed

Message

Issued

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 105

URL

Launch

Replaces

Executive

Dashboard

.

. 105

Using

the

Import/Export

Utility

.

.

.

.

.

.

. 105

Resources

and

the

Maintenance

State

.

.

.

.

. 105

Maintenance

Window

Messages

.

.

.

.

.

. 108

Note

Ownership

Customization

Issues

.

.

.

.

. 111

Chapter

6.

Troubleshooting

Data

Source

Problems

.

.

.

.

.

.

.

.

.

. 113

Abend

Codes

.

.

.

.

.

.

.

.

.

.

.

.

. 114

Automated

Business

Systems

.

.

.

.

.

.

.

. 115

Event

Enablement

.

.

.

.

.

.

.

.

.

.

.

. 115

Tivoli

Enterprise

Console

Events

Do

Not

Appear

on

Tivoli

Business

Systems

Manager

.

.

.

.

. 115

Setting

TZ

Environment

Variable

on

Windows

116

iv

IBM

Tivoli

Business

Systems

Manager:

Troubleshooting

Guide

Event

Enablement

Does

Not

Start

.

.

.

.

. 116

Common

Listener

Problems

.

.

.

.

.

.

.

. 116

Distributed

Data

Source

Problems

.

.

.

.

.

. 123

AppManager

Suite

.

.

.

.

.

.

.

.

.

. 124

HP

OpenView

.

.

.

.

.

.

.

.

.

.

.

. 124

Logging

Support

.

.

.

.

.

.

.

.

.

. 124

Tracing

Support

.

.

.

.

.

.

.

.

.

. 124

PATROL

.

.

.

.

.

.

.

.

.

.

.

.

.

. 125

wimpgethosts

.

.

.

.

.

.

.

.

.

.

. 125

BulkDiscovery

.

.

.

.

.

.

.

.

.

.

. 125

DeltaDiscovery

.

.

.

.

.

.

.

.

.

.

. 125

Tivoli

NetView

.

.

.

.

.

.

.

.

.

.

.

. 125

Logging

Support

.

.

.

.

.

.

.

.

.

. 126

Tracing

Support

.

.

.

.

.

.

.

.

.

. 126

Unicenter

TNG

.

.

.

.

.

.

.

.

.

.

.

. 126

ObjectDiscovery

.

.

.

.

.

.

.

.

.

. 126

EventDiscovery

.

.

.

.

.

.

.

.

.

.

. 127

External

Data

Interface

(EDI)

.

.

.

.

.

.

.

. 127

MVS

Subsystems

.

.

.

.

.

.

.

.

.

.

.

. 129

Resource

Management

Facility

.

.

.

.

.

. 129

Source/390

RMF

Exceptions

.

.

.

.

.

. 129

RODM

feed

problems

.

.

.

.

.

.

.

.

. 130

RODM

Connections

.

.

.

.

.

.

.

.

. 131

Registration

of

RODM

Objects

.

.

.

.

.

. 131

File

Transfer

Utility

GTMAOPE0

.

.

.

.

.

. 131

ASIMVSIPListenerSvc

.

.

.

.

.

.

.

. 132

MAINVIEW

for

OS/390

.

.

.

.

.

.

.

.

. 132

ASG-TMON

for

MVS

.

.

.

.

.

.

.

.

.

. 135

CICS

Subsystems

.

.

.

.

.

.

.

.

.

.

.

. 137

CICSPlex

SM

.

.

.

.

.

.

.

.

.

.

.

. 137

CICS

Diagnostic

Activities

.

.

.

.

.

.

. 137

CICS

Problem

Determination

.

.

.

.

.

. 138

MAINVIEW

for

CICS

.

.

.

.

.

.

.

.

. 139

ASG-TMON

for

CICS

.

.

.

.

.

.

.

.

. 142

Base

CICS

Discovery

.

.

.

.

.

.

.

.

.

.

. 144

DB2

Subsystems

.

.

.

.

.

.

.

.

.

.

.

. 146

DB2

and

DB2

Performance

Monitor

.

.

.

.

. 146

DB2

and

DB2

PM

Subsystems

.

.

.

.

.

. 146

DB2

and

DB2

Performance

Monitor

Diagnostic

Activities

.

.

.

.

.

.

.

.

. 146

DB2

and

DB2

Performance

Monitor

Problem

Determination

.

.

.

.

.

.

.

.

.

.

. 149

MAINVIEW

for

DB2

.

.

.

.

.

.

.

.

.

. 151

ASG-TMON

for

DB2

.

.

.

.

.

.

.

.

.

. 153

IMS

Subsystems

.

.

.

.

.

.

.

.

.

.

.

. 155

Data

Flow

of

an

IMS

Problem

Condition

.

.

. 155

IMS

Diagnostic

Activities

.

.

.

.

.

.

.

. 155

IMS

Problem

Determination

.

.

.

.

.

.

. 158

MAINVIEW

for

IMS

.

.

.

.

.

.

.

.

.

. 161

Tivoli

OMEGAMON

.

.

.

.

.

.

.

.

.

.

. 163

Tivoli

OMEGAMON

Screen

Logging

.

.

.

. 165

Scheduling

.

.

.

.

.

.

.

.

.

.

.

.

.

. 165

Tivoli

Workload

Scheduler

for

z/OS

.

.

.

.

. 165

Ensuring

that

Traps

are

Set

.

.

.

.

.

.

. 165

Confirming

that

Events

are

Being

Processed

166

Ensuring

that

the

TWS

Daily

Plan

Date

Format

is

Correct

.

.

.

.

.

.

.

.

.

. 167

Computer

Associates

CA-7

.

.

.

.

.

.

.

. 167

Ensuring

that

Traps

are

Set

.

.

.

.

.

.

. 168

ASG-Zeke

.

.

.

.

.

.

.

.

.

.

.

.

. 169

Ensuring

that

Traps

are

Set

.

.

.

.

.

.

. 169

Confirming

that

Events

are

Being

Processed

170

Automation

.

.

.

.

.

.

.

.

.

.

.

.

.

. 171

System

Automation

for

OS/390

V2.1

or

Later

171

Specify

the

Problem

.

.

.

.

.

.

.

.

. 171

Host

Problems

.

.

.

.

.

.

.

.

.

.

. 172

Tivoli

Business

Systems

Manager

Console

Command

Line

Interface

Problems

.

.

.

. 172

Tivoli

NetView

for

z/OS

.

.

.

.

.

.

.

. 172

IBM

Tivoli

AF/Operator

.

.

.

.

.

.

.

.

. 173

OPS/MVS

.

.

.

.

.

.

.

.

.

.

.

.

. 174

MAINVIEW

Auto

Operator

.

.

.

.

.

.

. 175

WebSphere

for

z/OS

.

.

.

.

.

.

.

.

.

.

. 175

Discovery

Problems

.

.

.

.

.

.

.

.

.

. 175

Event

Processing

Problems

.

.

.

.

.

.

.

. 176

Storage

Management

Resources

.

.

.

.

.

.

. 177

System

Managed

Storage

Base

Resources

.

.

. 177

Systems

Management

Storage

XRC

Resources

180

XRC

Resources

Do

Not

Appear

on

the

Tivoli

Business

Systems

Manager

Console

.

.

.

. 181

Tivoli

Business

Systems

Manager

Alerts

Not

Generated

for

z/OS

Console

Messages

.

.

. 182

Message

Traps

Not

Registered

on

z/OS

System

.

.

.

.

.

.

.

.

.

.

.

.

. 182

DFSMShsm

Resources

.

.

.

.

.

.

.

.

. 182

Alerts

Not

Generated

for

z/OS

Console

Messages

.

.

.

.

.

.

.

.

.

.

.

.

. 183

Message

Traps

Not

Registered

on

z/OS

System

.

.

.

.

.

.

.

.

.

.

.

.

. 183

HSM

Alerts

Not

Registered

on

z/OS

System

183

HMT

Monitor

Launch

Failed

.

.

.

.

.

. 184

Tracing

Operational

Tasks

in

Tivoli

Management

Framework

with

a

Software

Component

.

.

.

. 184

Chapter

7.

Diagnostic

Tools

and

Techniques

for

Tivoli

Business

Systems

Manager

Database

Problems

. 187

Using

SQL

Tools

.

.

.

.

.

.

.

.

.

.

.

. 187

Getting

Help

for

SQL

.

.

.

.

.

.

.

.

.

.

. 188

SQL

Queries

.

.

.

.

.

.

.

.

.

.

.

.

.

. 188

Determining

SQL

Service

Pack

Levels

.

.

.

.

. 188

Viewing

Database

Information

.

.

.

.

.

.

.

. 189

Obtaining

the

SID

.

.

.

.

.

.

.

.

.

.

. 189

Obtaining

the

Class

ID

(CID)

.

.

.

.

.

.

. 189

Obtaining

the

ID

.

.

.

.

.

.

.

.

.

.

. 189

Converting

a

Native

Key

to

a

CID

and

ID

.

.

. 190

Displaying

the

Properties

of

Objects

Using

SQL

190

Getting

the

Fully

Qualified

Path

of

a

Resource

.

. 191

Getting

Threshold

Settings

for

a

Class

.

.

.

.

. 191

Determining

the

Tivoli

Business

Systems

Manager

Release

Number

.

.

.

.

.

.

.

.

.

.

.

. 192

Getting

Messages

and

Exceptions

for

a

Given

CID

192

Getting

Resources

of

a

CID

That

Have

Not

Received

Messages

.

.

.

.

.

.

.

.

.

.

. 193

Getting

Resources

of

a

CID

with

Messages

Between

Two

Specific

Times

.

.

.

.

.

.

.

. 193

Issuing

DOS

commands

from

SQL

.

.

.

.

.

. 194

Checking

the

Progress

of

the

Staged

Event

Loader

Tables

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 194

Checking

the

Progress

of

the

Database

Queues

.

. 195

Viewing

the

Automation

Map

Table

.

.

.

.

.

. 195

Contents

v

Updating

the

MVSSenderSvcMap

Table

.

.

.

. 196

Diagnosing

the

Event

Viewer

.

.

.

.

.

.

.

. 196

Database

Tables

Used

by

the

Event

Viewer

.

. 196

ObjPathCache

.

.

.

.

.

.

.

.

.

.

. 196

EvtViewSignature

.

.

.

.

.

.

.

.

.

. 196

EvtViewResultCache

.

.

.

.

.

.

.

.

. 197

EvtViewResultCacheTimeout

.

.

.

.

.

. 197

StartingPathCache

.

.

.

.

.

.

.

.

.

. 197

StartingPathCacheDetail

.

.

.

.

.

.

.

. 197

Changing

the

Non-Valid

Alert

State

of

an

Object

197

Using

the

Bulk

Copy

Program

to

Dump

Database

Table

Information

.

.

.

.

.

.

.

.

.

.

.

. 199

Checking

Exception

Counters

.

.

.

.

.

.

.

. 199

Determining

When

Exception

Counters

Are

Inaccurate

.

.

.

.

.

.

.

.

.

.

.

.

. 199

Diagnosing

Problems

With

Exception

Counters

200

Diagnosing

Mismatched

Exception

Counts

.

. 200

Looking

at

the

trackpropagation

Output

.

.

. 201

Using

the

TBSMHealthCheck

Procedure

.

.

.

. 201

TBSM_Diagnostics

.

.

.

.

.

.

.

.

.

.

.

. 204

Resetting

the

Database

.

.

.

.

.

.

.

.

.

. 211

Database

Blocking

and

Deadlocks

.

.

.

.

.

. 211

Listing

DB2

Related

SQL

Jobs

.

.

.

.

.

.

.

. 214

Checking

Database

Integrity

.

.

.

.

.

.

.

. 214

Listing

the

Largest

Tables

in

the

Database

.

.

.

. 215

Diagnosing

and

Correcting

tempdb

LOG

Growth

Problems

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 216

Identifying

and

Correcting

the

Problem

.

.

. 216

Shrinking

a

Database

.

.

.

.

.

.

.

.

. 217

SQLDiag

tool

.

.

.

.

.

.

.

.

.

.

.

.

. 218

Running

an

SQL

Trace

.

.

.

.

.

.

.

.

.

. 218

Verifying

That

Tivoli

Business

Systems

Manager

Databases

Are

Properly

Attached

.

.

.

.

.

.

. 220

Sending

Database

Backups

to

IBM

Software

Support

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 220

Chapter

8.

Monitoring

and

Recovering

Failover

Processing

.

.

.

.

.

.

.

. 223

Critical

Activities

for

Failover

.

.

.

.

.

.

.

. 223

Resist

Constantly

Monitoring

the

Process

.

.

. 223

Maintain

Configuration

and

Patches

on

Secondary

Site

.

.

.

.

.

.

.

.

.

.

.

. 223

Check

SQL

Processes

on

Secondary

Site

.

.

. 223

Refresh

Views

in

SQL

Enterprise

Manager

.

.

. 224

Failover

Configuration

.

.

.

.

.

.

.

.

.

. 224

Transaction

Log

Forwarding

.

.

.

.

.

.

.

. 224

Overview

of

Transaction

Log

Forwarding

Initialization

.

.

.

.

.

.

.

.

.

.

.

.

. 225

Checking

the

Log

for

Transaction

Log

Forwarding

.

.

.

.

.

.

.

.

.

.

.

.

. 225

Monitoring

Initialization

of

Transaction

Log

Forwarding

.

.

.

.

.

.

.

.

.

.

.

.

. 225

Useful

Commands

for

Monitoring

Transaction

Log

Forwarding

Initialization

.

.

.

.

.

.

. 226

Difficulties

Monitoring

Key

Steps

in

Transaction

Log

Forwarding

Initialization

.

.

.

.

.

.

. 227

Recovering

from

Interrupted

Initialization

of

Transaction

Log

Forwarding

.

.

.

.

.

.

. 228

Re-Initializing

Transaction

Log

Forwarding

in

the

Same

Direction

.

.

.

.

.

.

.

.

.

. 228

Monitoring

Transaction

Log

Forwarding

After

Initialization

.

.

.

.

.

.

.

.

.

.

.

.

. 229

Tivoli

Business

Systems

Manager

Log

Shipping

Out

of

Synch

Check

SQL

Job

.

.

. 229

Monitoring

Failover

.

.

.

.

.

.

.

.

.

.

. 229

Checking

the

Failover

Log

.

.

.

.

.

.

.

. 230

Troubleshooting

and

Monitoring

Failover

.

.

. 230

Recovery

from

Failed

or

Aborted

Failover

.

.

. 231

Re-Activation

of

the

Old

Source

(Primary)

Site

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 231

Re-Running

the

Failover

Process

.

.

.

.

. 231

Resume

the

Failover

Process

.

.

.

.

.

. 231

Chapter

9.

Troubleshooting

the

History

Server

and

Reporting

System

. 233

Problems

During

Configuration

of

History

Database

Server

.

.

.

.

.

.

.

.

.

.

.

. 233

Problems

During

Execution

of

historyserversetup.ksh

.

.

.

.

.

.

.

.

.

. 233

Problems

During

History

Server

Maintenance

.

. 235

Troubleshooting

the

Reporting

System

.

.

.

.

. 235

Problems

Starting

a

Reporting

System

Session

235

Index

Does

Not

Refresh

.

.

.

.

.

.

.

.

. 235

Event

Report

Selection

Screen

Does

Not

Display

235

Parent

Path

Not

Resolving

.

.

.

.

.

.

.

. 236

Problems

with

New

Object

Reports

.

.

.

.

. 237

Access

Problems

.

.

.

.

.

.

.

.

.

.

. 237

Time

Out

Problems

.

.

.

.

.

.

.

.

.

. 237

Report

Request

Takes

Too

Long

.

.

.

.

.

. 238

Moving

Events

to

History

Database

SQL

Job

Fails

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 239

Appendix.

Problem

Worksheet

.

.

.

. 241

General

Information

.

.

.

.

.

.

.

.

.

.

. 241

System

Related

Information

.

.

.

.

.

.

.

. 241

Installation

Exits

.

.

.

.

.

.

.

.

.

.

.

. 241

Problem

Description

.

.

.

.

.

.

.

.

.

.

. 241

Problem

Classification

.

.

.

.

.

.

.

.

.

. 242

Abend

Problems

.

.

.

.

.

.

.

.

.

.

. 242

Message

Problems

.

.

.

.

.

.

.

.

.

.

. 242

Loop

Problems

.

.

.

.

.

.

.

.

.

.

.

. 243

Wait

Problems

.

.

.

.

.

.

.

.

.

.

.

. 243

Incorrect

Output

Problems

.

.

.

.

.

.

.

. 243

Performance

Problems

.

.

.

.

.

.

.

.

. 244

Documentation

Problems

.

.

.

.

.

.

.

. 244

Support

information

.

.

.

.

.

.

.

. 245

Searching

knowledge

bases

.

.

.

.

.

.

.

.

. 245

Search

the

information

center

on

your

local

system

or

network

.

.

.

.

.

.

.

.

.

.

. 245

Search

the

Internet

.

.

.

.

.

.

.

.

.

. 245

Obtaining

fixes

.

.

.

.

.

.

.

.

.

.

.

.

. 245

Contacting

IBM

Software

Support

.

.

.

.

.

. 246

Determine

the

business

impact

of

your

problem

247

Describe

your

problem

and

gather

background

information

.

.

.

.

.

.

.

.

.

.

.

.

. 247

Submit

your

problem

to

IBM

Software

Support

247

Notices

.

.

.

.

.

.

.

.

.

.

.

.

.

. 249

Trademarks

.

.

.

.

.

.

.

.

.

.

.

.

.

. 250

vi

IBM

Tivoli

Business

Systems

Manager:

Troubleshooting

Guide

Index

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 253

Contents

vii

viii

IBM

Tivoli

Business

Systems

Manager:

Troubleshooting

Guide

About

this

guide

IBM

Tivoli

Business

Systems

Manager

is

an

enterprise

management

product

that

monitors

the

data

processing

resources

that

are

critical

to

a

business

application.

It

enables

end-to-end

monitoring

of

systems,

subsystems,

applications,

and

other

resources

in

your

enterprise,

from

z/OS

systems

to

distributed

systems.

Tivoli

Business

Systems

Manager

provides

your

operations

and

support

organizations,

application

owners,

and

management

with

a

view

of

the

system

components

as

they

relate

to

your

overall

business.

Publications

This

section

lists

publications

in

the

Tivoli

Business

Systems

Manager

library

and

related

documents.

It

also

describes

how

to

access

Tivoli

publications

online

and

how

to

order

Tivoli

publications.

IBM

Tivoli

Business

Systems

Manager

library

This

following

publications

are

in

the

IBM

Tivoli

Business

Systems

Manager

library:

v

IBM

Tivoli

Business

Systems

Manager

Planning

Guide,

SC32-9088,

provides

an

introduction

to

the

Tivoli

Business

Systems

Manager

product.

It

also

contains

planning

and

design

information

to

consider

when

implementing

a

Tivoli

Business

Systems

Manager

solution.

This

document

is

written

for

network

planners,

system

designers,

systems

administrators,

and

others

who

are

responsible

for

planning

and

implementing

the

product.

v

IBM

Tivoli

Business

Systems

Manager

Installation

and

Configuration

Guide,

SC32-9089,

provides

the

installation

and

configuration

tasks

necessary

for

the

implementation

of

Tivoli

Business

Systems

Manager.

This

document

is

written

for

system

administrators

and

others

who

are

responsible

for

installing

and

configuring

Tivoli

Business

Systems

Manager.

v

IBM

Tivoli

Business

Systems

Manager

Introducing

the

Consoles,

SC32-9086,

provides

an

introduction

to

the

Tivoli

Business

Systems

Manager

console,

Web

console,

executive

dashboard,

and

the

reporting

system.

This

document

is

written

for

operators

and

administrators.

v

IBM

Tivoli

Business

Systems

Manager

Administrators

Guide,

SC32-9085,

describes

administrative

tasks

for

Tivoli

Business

Systems

Manager.

This

document

is

written

for

system

administrators

and

others

who

perform

administrative

tasks

for

Tivoli

Business

Systems

Manager.

v

IBM

Tivoli

Business

Systems

Manager

Problem

and

Change

Management

Integration

Guide,

SC32-9130,

describes

how

to

write

request

processors

to

enable

the

problem,

change,

and

automatic

ticket

integration

function

provided

with

Tivoli

Business

Systems

Manager

to

work

with

problem

and

change

management

applications.

This

document

is

written

for

system

programmers.

v

IBM

Tivoli

Business

Systems

Manager

Command

Reference,

SC32-1243,

describes

the

commands

available

for

use

with

Tivoli

Business

Systems

Manager.

This

document

is

written

for

system

administrators

and

others

who

run

commands

and

scripts

for

Tivoli

Business

Systems

Manager.

Copyright

IBM

Corp.

2000,

2004

ix

v

IBM

Tivoli

Business

Systems

Manager

Message

Reference,

SC32-9087,

describes

the

messages

for

Tivoli

Business

Systems

Manager.

This

document

is

written

for

system

programmers,

network

planners,

operations

managers,

system

designers,

system

administrators,

network

operators,

and

others

who

need

message

information

for

Tivoli

Business

Systems

Manager.

v

IBM

Tivoli

Business

Systems

Manager

Troubleshooting

Guide,

SC32-9084,

describes

troubleshooting

tasks

to

diagnose

problems

with

Tivoli

Business

Systems

Manager.

This

document

is

written

for

system

administrators

and

others

who

perform

diagnostic

tasks

for

Tivoli

Business

Systems

Manager.

v

IBM

Tivoli

Business

Systems

Manager

Release

Notes,

GI11-4029,

describes

what

is

new

for

this

release

of

the

Tivoli

Business

Systems

Manager

product.

v

IBM

Tivoli

Business

Systems

Manager

Guide

for

Warehouse

Pack,

Version

3.1.0.0,

using

Tivoli

Data

Warehouse,

Version

1.2,

SC32-9114,

describes

how

to

use

the

warehouse

enablement

pack

to

extract

data

from

the

Tivoli

Business

Systems

Manager

database

and

load

it

into

the

Tivoli

Data

Warehouse

database,

where

it

can

be

accessed

using

reporting

and

data

analysis

tools.

This

document

is

written

for

administrators

and

others

who

plan

for

and

install

the

warehouse

pack,

use

and

maintain

the

warehouse

pack

and

its

reports,

or

create

new

reports.

An

index

is

provided

for

searching

the

Tivoli

Business

Systems

Manager

library.

If

you

have

Adobe

Acrobat

on

your

system,

you

can

use

the

Search

command

to

locate

specific

text

in

the

library.

For

more

information

about

using

the

index

to

search

the

library,

see

the

online

help

for

Acrobat.

Related

publications

The

Tivoli

Software

Glossary

includes

definitions

for

many

of

the

technical

terms

related

to

Tivoli

software.

The

Tivoli

Software

Glossary

is

available

at

the

following

Tivoli

software

library

Web

site:

http://www.ibm.com/software/tivoli/library/

Access

the

glossary

by

clicking

the

Glossary

link

on

the

left

pane

of

the

Tivoli

software

library

window.

Accessing

publications

online

The

documentation

CD

contains

the

publications

that

are

in

the

product

library.

The

format

of

the

publications

is

PDF

and

HTML.

IBM

posts

publications

for

this

and

all

other

Tivoli

products,

as

they

become

available

and

whenever

they

are

updated,

to

the

Tivoli

software

information

center

Web

site.

Access

the

Tivoli

software

information

center

by

first

going

to

the

Tivoli

software

library

at

the

following

Web

address:

http://www.ibm.com/software/tivoli/library/

Scroll

down

and

click

the

Product

manuals

link.

In

the

Tivoli

Technical

Product

Documents

Alphabetical

Listing

window,

click

the

Tivoli

Business

Systems

Manager

link

to

access

the

product

library

at

the

Tivoli

software

information

center.

x

IBM

Tivoli

Business

Systems

Manager:

Troubleshooting

Guide

http://www.ibm.com/software/tivoli/library/http://www.ibm.com/software/tivoli/library/

Note:

If

you

print

PDF

documents

on

other

than

letter-sized

paper,

set

the

option

in

the

File

Print

window

that

allows

Adobe

Reader

to

print

letter-sized

pages

on

your

local

paper.

Ordering

publications

You

can

order

many

Tivoli

publications

online

at

the

following

Web

site:

http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi

You

can

also

order

by

telephone

by

calling

one

of

these

numbers:

v

In

the

United

States:

800-879-2755

v

In

Canada:

800-426-4968

In

other

countries,

see

the

following

Web

site

for

a

list

of

telephone

numbers:

http://www.ibm.com/software/tivoli/order-lit/

Accessibility

Accessibility

features

help

users

with

a

physical

disability,

such

as

restricted

mobility

or

limited

vision,

to

use

software

products

successfully.

With

this

product,

you

can

use

assistive

technologies

to

hear

and

navigate

the

interface.

You

can

also

use

the

keyboard

instead

of

the

mouse

to

operate

all

features

of

the

graphical

user

interface.

For

information

about

installing

the

Tivoli

Business

Systems

Manager

product

using

the

built-in

screen

reader,

see

the

IBM

Tivoli

Business

Systems

Manager

Installation

and

Configuration

Guide.

For

information

about

the

shortcut

keys

that

can

be

used

with

the

Tivoli

Business

Systems

Manager

console,

see

the

Accessibility

appendix

in

IBM

Tivoli

Business

Systems

Manager

Introducing

the

Consoles.

Tivoli

technical

training

For

Tivoli

technical

training

information,

refer

to

the

following

IBM

Tivoli

Education

Web

site:

http://www.ibm.com/software/tivoli/education

Support

information

If

you

have

a

problem

with

your

IBM

software,

you

want

to

resolve

it

quickly.

IBM

provides

the

following

ways

for

you

to

obtain

the

support

you

need:

v

Searching

knowledge

bases:

You

can

search

across

a

large

collection

of

known

problems

and

workarounds,

Technotes,

and

other

information.

v

Obtaining

fixes:

You

can

locate

the

latest

fixes

that

are

already

available

for

your

product.

v

Contacting

IBM

Software

Support:

If

you

still

cannot

solve

your

problem,

and

you

need

to

work

with

someone

from

IBM,

you

can

use

a

variety

of

ways

to

contact

IBM

Software

Support.

For

more

information

about

these

three

ways

of

resolving

problems,

see

Support

information

on

page

245.

About

this

guide

xi

http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://www.ibm.com/software/tivoli/order-lit/http://www.ibm.com/software/tivoli/education

Participating

in

newsgroups

User

groups

provide

software

professionals

with

a

forum

for

communicating

ideas,

technical

expertise,

and

experiences

related

to

the

product.

They

are

located

on

the

Internet

and

are

available

using

standard

news

reader

programs.

These

groups

are

primarily

intended

for

user-to-user

communication

and

are

not

a

replacement

for

formal

support.

To

access

a

newsgroup,

use

the

instructions

appropriate

for

your

browser.

IBM

Tivoli

Business

Systems

Manager:

news://news.software.ibm.com/ibm.software.tivoli.business-systems-manager

IBM

Tivoli

Enterprise

Console:

news://news.software.ibm.com/ibm.software.tivoli.enterprise-console

IBM

Tivoli

Service

Level

Advisor:

news://news.software.ibm.com/ibm.software.tivoli.service-level-advisor

IBM

Tivoli

Switch

Analyzer:

news://news.software.ibm.com/ibm.software.tivoli.switch-analyzer

IBM

Tivoli

NetView

for

UNIX

and

IBM

Tivoli

NetView

for

Windows:

news://news.software.ibm.com/ibm.software.tivoli.netview-unix-windows

IBM

Tivoli

NetView

for

z/OS:

news://news.software.ibm.com/ibm.software.netview

Conventions

used

in

this

guide

This

guide

uses

several

conventions

for

special

terms

and

actions

and

for

operating

system-dependent

commands

and

paths

Typeface

conventions

This

guide

uses

the

following

typeface

conventions:

Bold

v

Lowercase

commands

and

mixed

case

commands

that

are

otherwise

difficult

to

distinguish

from

surrounding

text

v

Interface

controls

(check

boxes,

push

buttons,

radio

buttons,

spin

buttons,

fields,

folders,

icons,

list

boxes,

items

inside

list

boxes,

multicolumn

lists,

containers,

menu

choices,

menu

names,

tabs,

property

sheets),

labels

(such

as

Tip:,

and

Operating

system

considerations:)

v

Keywords

and

parameters

in

text

Italic

v

Words

defined

in

text

v

Emphasis

of

words

(words

as

words)

v

New

terms

in

text

(except

in

a

definition

list)

xii

IBM

Tivoli

Business

Systems

Manager:

Troubleshooting

Guide

news://news.software.ibm.com/ibm.software.tivoli.business-systems-managernews://news.software.ibm.com/ibm.software.tivoli.enterprise-consolenews://news.software.ibm.com/ibm.software.tivoli.service-level-advisornews://news.software.ibm.com/ibm.software.tivoli.switch-analyzernews://news.software.ibm.com/ibm.software.tivoli.netview-unix-windowsnews://news.software.ibm.com/ibm.software.netview

v

Variables

and

values

you

must

provide

Monospace

v

Examples

and

code

examples

v

File

names,

programming

keywords,

and

other

elements

that

are

difficult

to

distinguish

from

surrounding

text

v

Message

text

and

prompts

addressed

to

the

user

v

Text

that

the

user

must

type

v

Values

for

arguments

or

command

options

Operating

system-dependent

variables

and

paths

This

guide

uses

the

UNIX

convention

for

specifying

environment

variables

and

for

directory

notation.

When

using

the

Windows

command

line,

replace

$variable

with

%variable%

for

environment

variables

and

replace

each

forward

slash

(/)

with

a

backslash

(\)

in

directory

paths.

The

names

of

environment

variables

are

not

always

the

same

in

Windows

and

UNIX.

For

example,

%TEMP%

in

Windows

is

equivalent

to

$tmp

in

UNIX.

Note:

If

you

are

using

the

bash

shell

on

a

Windows

system,

you

can

use

the

UNIX

conventions.

Terminology

For

a

list

of

terms

and

definitions

for

Tivoli

and

other

IBM

products,

refer

to

the

IBM

terminology

Web

site:

http://www.ibm.com/ibm/terminology/

For

brevity

and

readability,

the

term

Tivoli

NetView

for

z/OS

refers

to

both

the

Tivoli

NetView

for

z/OS

product

and

the

Tivoli

NetView

for

OS/390

product.

About

this

guide

xiii

http://http://www.ibm.com/ibm/terminology/

xiv

IBM

Tivoli

Business

Systems

Manager:

Troubleshooting

Guide

Chapter

1.

Getting

Started

with

Diagnosis

This

document

contains

information

about

troubleshooting

problems

with

the

Tivoli

Business

Systems

Manager

product.

For

an

overview

of

the

product

components

and

how

they

work

together,

refer

to

the

IBM

Tivoli

Business

Systems

Manager

Planning

Guide.

To

begin

diagnostic

procedures

for

problems

that

might

occur

in

the

Tivoli

Business

Systems

Manager

program

or

any

of

its

components,

you

must

first

understand

the

methods

that

can

help

you

define

and

solve

a

problem

or

document

and

report

the

problem

to

IBM

Software

Support.

Refer

to

the

following

sections

for

specific

component

troubleshooting

techniques:

v

Chapter

2,

Troubleshooting

Source/390

Problems,

on

page

5

v

Chapter

3,

Diagnostic

Tools

for

Services

and

Processes,

on

page

19

v

Chapter

4,

Troubleshooting

Services

and

Processes,

on

page

53

v

Chapter

5,

Troubleshooting

Console

Problems,

on

page

99

v

Chapter

6,

Troubleshooting

Data

Source

Problems,

on

page

113

v

Chapter

7,

Diagnostic

Tools

and

Techniques

for

Tivoli

Business

Systems

Manager

Database

Problems,

on

page

187

v

Chapter

8,

Monitoring

and

Recovering

Failover

Processing,

on

page

223

v

Chapter

9,

Troubleshooting

the

History

Server

and

Reporting

System,

on

page

233

If

these

sections

do

not

provide

enough

information

to

solve

your

problem,

see

Finding

Solutions.

Finding

Solutions

If

you

have

the

IBM

Information/Access

program,

you

can

search

the

RETAIN

database,

on

the

basis

of

a

keyword

string,

to

find

similar

problems

and

their

solutions.

Working

with

IBM

Software

Support

If

it

is

necessary

to

call

IBM

Software

Support,

first

collect

the

appropriate

information.

See

Problem

Worksheet,

on

page

241

and

Support

information

on

page

245.

Using

Keywords

Each

problem

type

has

an

associated

keyword.

The

keyword

is

used

as

a

general

identifier

and

to

search

the

RETAIN

database.

If

you

have

access

to

the

RETAIN

database,

you

can

search

it.

Otherwise,

you

can

provide

IBM

Software

Support

with

the

keyword

and

they

will

do

the

search.

You

can

search

the

RETAIN

database

to

determine

these

items:

v

Whether

your

particular

problem

has

already

been

reported

v

Whether

there

is

a

bypass

for

your

problem

v

Whether

your

problem

has

been

solved

v

Whether

a

solution

already

exists

for

your

problem

Copyright

IBM

Corp.

2000,

2004

1

An

accurate

and

precise

search

string

produces

usable

results.

These

are

components

that

can

be

part

of

a

string

search:

v

The

keyword

that

represents

your

problem

type

v

The

level

of

the

Tivoli

Business

Systems

Manager

product.

v

Additional

symptoms

of

the

problem

Building

a

Keyword

String

A

keyword

string

is

a

set

of

descriptive

words

that

you

use

to

identify

a

problem.

A

keyword

is

a

word

or

abbreviation

that

describes

one

part

of

a

program

failure.

These

keywords

can

be

used

to

search

for

solutions

in

the

IBM

Software

Support

database.

Use

keywords

in

a

string

to

completely

describe

the

problem.

A

search

string

can

contain

any

keyword

that

represents

your

problem

type,

information

about

the

level

of

Tivoli

Business

Systems

Manager

you

are

using,

and

additional

symptoms

of

the

problem.

For

example,

if

the

failure

is

an

abnormal

end

(abend)

of

a

task,

the

keyword

used

is

ABEND.

Other

problems

have

the

following

keywords:

v

DOC

v

INCORROUT

v

LOOP

v

MSG

v

PERFM

v

WAIT

Table

1

describes

how

to

develop

a

keyword

string:

Table

1.

How

to

Develop

a

Keyword

String

Type

of

Keyword

Description

or

Value

Function

Example

of

a

Keyword

String

Component

identification

The

component

identification

number

for

the

product.

The

component

ID

number

for

Tivoli

Business

Systems

Manager

is

5698BSM00.

Find

all

reported

problems

with

the

Tivoli

Business

Systems

Manager

product

or

one

of

its

components.

xxxxxxxxx

5698BSM00

Failure

v

ABEND

v

DOC

v

INCORROUT

v

LOOP

v

MSG

v

PERFM

v

WAIT

Refine

your

search

to

just

that

type

of

failure

for

Tivoli

Business

Systems

Manager

or

one

of

its

components.

MSGGTMxxxx,

where

xxxx

is

the

message

number

(for

example,

1835E).

Symptom

Details

about

the

failure.

Refine

your

search

gradually

(combining

the

symptom

keywords

in

various

ways)

so

that

you

receive

all

problem

descriptions

that

might

match

your

problem.

GTMyyyyy

identifies

the

name

of

the

Tivoli

Business

Systems

Manager

module

that

issued

the

abend.

2

IBM

Tivoli

Business

Systems

Manager:

Troubleshooting

Guide

Table

1.

How

to

Develop

a

Keyword

String

(continued)

Type

of

Keyword

Description

or

Value

Function

Example

of

a

Keyword

String

Dependency

Program

or

device

dependent

keywords

that

define

the

environment

in

which

the

problem

occurred.

Help

reduce

the

number

of

problem

descriptions

you

need

to

examine.

CICS

For

example,

if

there

is

an

abend

in

a

GTM

Tivoli

Business

Systems

Manager

module,

enter

the

following

keyword

string:

5698BSM00

ABENDnnn

GTMyyyyy

5698BSM00

Component

ID

for

the

program

ABEND

Type

of

problem

nnn

Abend

code

number

GTMyyyyy

Tivoli

Business

Systems

Manager

module

that

issued

the

abend

failure

message.

Uninstalling

and

Reinstalling

Issues

If

you

uninstall

the

Tivoli

Business

Systems

Manager

product

and

then

reinstall

(a

later

version,

for

example)

you

might

encounter

difficulty

with

the

data

sources

(or

service

packs).

This

occurs

if

you

did

not

uninstall

them

prior

to

uninstalling

the

base

Tivoli

Business

Systems

Manager

product.

The

Tivoli

Business

Systems

Manager

uninstallation

process

does

not

uninstall

these

data

sources.

For

information

about

the

uninstallation

process,

refer

to

the

IBM

Tivoli

Business

Systems

Manager

Installation

and

Configuration

Guide.

If

you

have

uninstalled

the

Tivoli

Business

Systems

Manager

product

without

first

uninstalling

the

Tivoli

Business

Systems

Manager

services,

you

can

run

the

following

command

from

a

korn

shell

prompt:

sclist

|

awk

/ASI/

{

system("sc

delete

"

$2)

}

This

command

removes

the

Tivoli

Business

Systems

Manager

services

so

that

you

can

cleanly

reinstall

the

Tivoli

Business

Systems

Manager

product.

Chapter

1.

Getting

Started

with

Diagnosis

3

4

IBM

Tivoli

Business

Systems

Manager:

Troubleshooting

Guide

Chapter

2.

Troubleshooting

Source/390

Problems

Use

Table

2

to

locate

examples

of

problems

you

might

encounter

with

Tivoli

Business

Systems

Manager

source/390

components.

Table

2.

Problem

Categories

and

Scenarios

Category

Problem

Page

Object

Pump

Events

not

being

correctly

generated

8

Object

Server

TCP/IP

Connectivity

11

LU

6.2

Connectivity

12

Dataspace

Queue

full

15

Diagnostic

tools

are

also

described

in

this

chapter.

Overview

When

diagnosing

the

Tivoli

Business

Systems

Manager

mainframe

environment,

you

need

to

know

where

on

the

host

the

failure

occurred.

To

do

that,

note

the

function

of

each

component

as

described

in

z/OS

Components.

Besides

the

Tivoli

Business

Systems

Manager

source/390

components,

Tivoli

NetView

for

z/OS

also

plays

a

large

role

in

providing

events

to

Tivoli

Business

Systems

Manager.

Events

are

captured

by

the

NetView

Automation

Table

and

are

then

sent

to

the

NetView

program-to-program

interface

within

the

object

pump.

The

object

pump

adds

the

time,

date,

and

sequence

information

to

the

pre-formatted

record

and

moves

it

to

the

source/390

data

space

for

transport

to

the

Tivoli

Business

Systems

Manager

servers.

Resource

Object

Data

Manager

(RODM)

can

also

send

data

to

the

source/390

object

pump

using

a

notify

method.

If

you

are

not

sure

which

task

is

encountering

the

problem,

begin

diagnosis

from

the

source/390

object

server.

z/OS

Components

The

Tivoli

Business

Systems

Manager

source/390

program

enables

the

monitoring

and

management

of

z/OS

systems.

The

source/390

components

are:

v

The

Source/390

Object

Pump

v

The

Source/390

Object

Server

on

page

6

v

The

Source/390

Data

Space

on

page

6

v

The

external

data

interface

(EDI),

which

passes

messages

and

exceptions

that

reside

on

the

same

MVS

host

to

the

source/390

object

pump.

v

The

automation

EDI,

which

provides

an

interface

between

certain

automation

products

and

the

EDI.

The

Source/390

Object

Pump

The

source/390

object

pump

is

an

address

space

that

captures

and

processes

event

data

from

the

following

sources:

v

The

MVS

console

v

EDI

sources

(for

example,

automation

products)

Copyright

IBM

Corp.

2000,

2004

5

v

Tivoli

NetView

for

z/OS

RODM

v

Tivoli

OMEGAMON

products

v

NetView

PPI

The

event

data

captured

is

based

on

the

startup

parameters

of

the

source/390

object

pump

and

on

resource

registration

data

received

from

the

Tivoli

Business

Systems

Manager

Windows

server.

The

event

data

is

placed

into

internal

queues

within

the

source/390

dataspace.

The

source/390

object

pump

formats

this

data,

places

it

on

the

source/390

dataspace,

and

notifies

the

source/390

object