Tivoli®

Decision

Support

for

OS/390®

Distributed

Systems

Performance

Feature

Guide

and

Reference

Version

1.6,

December

2003

SH19-4018-07

���

Tivoli®

Decision

Support

for

OS/390®

Distributed

Systems

Performance

Feature

Guide

and

Reference

Version

1.6,

December

2003

SH19-4018-07

���

Note

Before

using

this

information

and

the

product

it

supports,

read

the

information

in

“Notices”

on

page

187.

Eighth

Edition

(July

2003)

This

edition

applies

to

version

1,

release

6

of

Tivoli

Decision

Support

for

OS/390

(product

number

5695-101)

and

to

all

subsequent

releases

and

modifications

until

otherwise

indicated

in

new

editions.

This

edition

replaces

SH19-4018-06.

©

Copyright

International

Business

Machines

Corporation

1994,

2003.

All

rights

reserved.

Note

to

U.S.

Government

Users

Restricted

Rights—Use,

duplication

or

disclosure

restricted

by

GSA

ADP

Schedule

Contract

with

IBM

Corporation.

Contents

Figures

.

.

.

.

.

.

.

.

.

.

.

.

.

. vii

Preface

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. ix

Who

Should

Read

This

Book

.

.

.

.

.

.

.

.

. ix

What

This

Book

Contains

.

.

.

.

.

.

.

.

.

. ix

Publications

.

.

.

.

.

.

.

.

.

.

.

.

.

. xi

Tivoli

Decision

Support

for

OS/390

Library

.

.

. xi

Using

LookAt

to

look

up

message

explanations

xii

Accessing

Publications

Online

.

.

.

.

.

.

. xiii

Ordering

Publications

.

.

.

.

.

.

.

.

.

. xiii

Accessibility

.

.

.

.

.

.

.

.

.

.

.

.

.

. xiii

Contacting

software

support

.

.

.

.

.

.

.

. xiii

Conventions

Used

in

This

Book

.

.

.

.

.

.

. xiv

Typeface

conventions

.

.

.

.

.

.

.

.

.

. xiv

Changes

in

This

Edition

.

.

.

.

.

.

.

.

.

. xv

Part

1.

UNIX

Guide

.

.

.

.

.

.

.

.

. 1

Chapter

1.

Introducing

the

UNIX

Performance

component

.

.

.

.

.

.

. 3

Gathering

and

collecting

performance

data

.

.

.

. 3

Report

Groups

.

.

.

.

.

.

.

.

.

.

.

.

. 4

Chapter

2.

Installing

and

configuring

the

UNIX

and

LINUX

Performance

components

.

.

.

.

.

.

.

.

.

.

.

.

. 7

Planning

the

implementation

process

.

.

.

.

.

. 7

Considering

which

UNIX

subcomponents

to

install

. 8

Installing

the

UNIX

Performance

component

on

your

UNIX

nodes

.

.

.

.

.

.

.

.

.

.

.

.

.

. 9

Step

1:

Check

UNIX

requirements

.

.

.

.

.

. 9

Disk

space

requirements

.

.

.

.

.

.

.

. 9

Software

requirements

.

.

.

.

.

.

.

.

. 9

Step

2:

Transfer

Tivoli

Decision

Support

for

OS/390

feature

code

to

UNIX

.

.

.

.

.

.

. 10

Capturing

UNIX

Performance

component

data

and

transmitting

to

OS/390

.

.

.

.

.

.

.

.

.

. 13

Step

1:

Set

up

UNIX

accounting

.

.

.

.

.

. 13

Setting

up

accounting

for

AIX

.

.

.

.

.

. 13

Setting

up

accounting

for

HP

.

.

.

.

.

. 15

Setting

up

accounting

for

Sun

Solaris

.

.

.

. 16

Step

2:

Create

log

files

.

.

.

.

.

.

.

.

. 16

Step

3:

Define

the

receiver

of

UNIX

Performance

component

data

.

.

.

.

.

.

.

.

.

.

.

. 17

Step

4:

Customize

UNIX

Performance

component

parameters

.

.

.

.

.

.

.

.

. 18

Parameter

file

values

for

all

subcomponents

18

Parameter

file

values

for

performance

component

.

.

.

.

.

.

.

.

.

.

.

. 19

Step

5:

Start

the

drlperfd

daemon

.

.

.

.

.

. 20

Step

6:

Invoke

drlperfd

at

boot

time

.

.

.

.

. 21

Description

of

daily

tasks

performed

by

UNIX

Performance

component

.

.

.

.

.

.

.

.

. 21

Operating

the

UNIX

Performance

component

on

UNIX

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 22

Description

of

UNIX

Performance

component

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 23

AIX

commands

to

use

if

UNIX

Performance

component

installed

.

.

.

.

.

.

.

.

.

. 24

drlpsperfd

.

.

.

.

.

.

.

.

.

.

.

.

. 24

drlactperfd

.

.

.

.

.

.

.

.

.

.

.

. 24

drldeactperfd

.

.

.

.

.

.

.

.

.

.

.

. 24

drlsend

.

.

.

.

.

.

.

.

.

.

.

.

.

. 24

Installing

UNIX

Performance

component

on

the

OS/390

system

.

.

.

.

.

.

.

.

.

.

.

.

. 24

Updating

the

lookup

tables

.

.

.

.

.

.

.

.

. 26

Updating

XACCT_CONNECT_TYPE

.

.

.

.

. 26

Updating

X_NODE_NAME

.

.

.

.

.

.

.

. 27

Updating

XACCT_PRINT_TYPE

.

.

.

.

.

. 27

Collecting

data

under

Tivoli

Decision

Support

for

OS/390

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 27

Creating

your

Generation

Data

Groups

.

.

.

. 27

Renaming

files

sets

sent

from

UNIX

for

use

with

a

GDG

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 28

Example

of

renaming

UNIX

files

.

.

.

.

. 28

General

collect

job

.

.

.

.

.

.

.

.

.

.

. 29

Collect

job

with

specified

Tivoli

Decision

Support

for

OS/390

tables

.

.

.

.

.

.

.

.

.

.

. 29

Backup

and

delete

of

generation

data

sets

.

.

. 30

Testing

the

installation

.

.

.

.

.

.

.

.

.

.

. 30

Putting

the

feature

into

production

.

.

.

.

.

. 30

Considering

which

LINUX

subcomponents

to

install

31

Installing

the

LINUX

Performance

component

on

your

LINUX

nodes

.

.

.

.

.

.

.

.

.

.

.

. 31

Step

1:

Check

LINUX

requirements

.

.

.

.

. 31

Software

requirements

.

.

.

.

.

.

.

.

. 31

Step

2:

Transfer

Tivoli

Decision

Support

for

OS/390

feature

code

to

LINUX

.

.

.

.

.

.

. 31

Capturing

LINUX

Performance

component

data

and

transmitting

to

OS/390

.

.

.

.

.

.

.

.

.

. 33

Step

1:

Create

log

files

.

.

.

.

.

.

.

.

. 33

Step

3:

Define

the

receiver

of

LINUX

Performance

component

data

.

.

.

.

.

.

. 34

Step

4:

Customize

LINUX

Performance

component

parameters

.

.

.

.

.

.

.

.

. 34

Parameter

file

values

for

all

subcomponents

34

Parameter

file

values

for

performance

component

.

.

.

.

.

.

.

.

.

.

.

. 35

Step

5:

Start

the

drlperfd

daemon

.

.

.

.

.

. 35

Commands

to

use

if

LINUX

Performance

component

installed

.

.

.

.

.

.

.

.

.

.

. 36

drlpsperfd

.

.

.

.

.

.

.

.

.

.

.

.

.

. 36

drlactperfd

.

.

.

.

.

.

.

.

.

.

.

.

. 36

drldeactperfd

.

.

.

.

.

.

.

.

.

.

.

.

. 36

drlsend

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 36

Collecting

data

under

Tivoli

Decision

Support

for

OS/390

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 37

General

collect

job

.

.

.

.

.

.

.

.

.

.

. 37

iii

||

||

||

Part

2.

UNIX

and

LINUX

Reference

39

Chapter

3.

Data

flow

and

Tivoli

Decision

Support

for

OS/390

Objects

. 41

UNIX

Performance

component

general

data

flow

.

. 41

Description

of

log

files,

record

and

log

definitions

43

UNIX

Accounting

subcomponent

data

flow

.

.

.

. 44

Where

to

look

for

further

information

.

.

.

. 45

UNIX

Configuration

subcomponent

data

flow

.

.

. 46

Where

to

look

for

further

information

.

.

.

. 47

UNIX

Error

subcomponent

data

flow

.

.

.

.

.

. 48

Where

to

look

for

further

information

.

.

.

. 49

UNIX

Performance

subcomponent

data

flow

.

.

. 50

Where

to

look

for

further

information

.

.

.

. 51

Chapter

4.

Data,

Lookup,

and

Control

Tables

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 53

Naming

standard

for

tables

.

.

.

.

.

.

.

.

. 53

Table

descriptions

.

.

.

.

.

.

.

.

.

.

.

. 53

Tables

in

the

accounting

subcomponent

.

.

.

.

. 54

XACCT_COMMAND_D,

_M

.

.

.

.

.

.

. 54

XACCT_DISK_D,

_M

.

.

.

.

.

.

.

.

.

. 56

XACCT_PRINT_D,

_M

.

.

.

.

.

.

.

.

. 56

XACCT_CONNECT_D,

_M

.

.

.

.

.

.

.

. 57

XACCT_DISK_MV

.

.

.

.

.

.

.

.

.

.

. 57

Tables

in

the

configuration

subcomponent

.

.

.

. 57

XCONFIG_HW

.

.

.

.

.

.

.

.

.

.

.

. 57

XCONFIG_SW

.

.

.

.

.

.

.

.

.

.

.

. 58

Tables

in

the

error

subcomponent

.

.

.

.

.

.

. 58

XERROR_D,

_M

.

.

.

.

.

.

.

.

.

.

.

. 58

Tables

in

the

performance

subcomponent

.

.

.

. 59

XPERF_CPU_H,

_D,

_M

.

.

.

.

.

.

.

.

. 59

XPERF_DISK_D,

_M

.

.

.

.

.

.

.

.

.

. 61

XPERF_DISKIO_H,

_D,

_M

.

.

.

.

.

.

.

. 61

XPERF_PAGING_H,

_D,

_M

.

.

.

.

.

.

.

. 62

XPERF_PS_INFO

.

.

.

.

.

.

.

.

.

.

. 63

XPERF_VM_INFO

.

.

.

.

.

.

.

.

.

.

. 63

Lookup

tables

.

.

.

.

.

.

.

.

.

.

.

.

. 64

XACCT_CONNECT_TYPE

.

.

.

.

.

.

.

. 64

Example

of

table

contents

.

.

.

.

.

.

. 64

X_NODE_NAME

.

.

.

.

.

.

.

.

.

.

. 64

Example

of

table

contents

.

.

.

.

.

.

. 64

XACCT_PRINT_TYPE

.

.

.

.

.

.

.

.

.

. 65

Example

of

table

contents

.

.

.

.

.

.

. 65

Chapter

5.

LINUX

data

tables

.

.

.

.

. 67

XCONF_HARDWARE

.

.

.

.

.

.

.

.

.

.

. 67

XCONF_SOFTWARE

.

.

.

.

.

.

.

.

.

.

. 67

XDISK_INFOR

.

.

.

.

.

.

.

.

.

.

.

.

. 67

XDTMP_INFOR

.

.

.

.

.

.

.

.

.

.

.

.

. 68

XPERF_PS_INFO

.

.

.

.

.

.

.

.

.

.

.

. 68

XPERF_VM_INFO

.

.

.

.

.

.

.

.

.

.

.

. 68

XWTMP_INFOR

.

.

.

.

.

.

.

.

.

.

.

.

. 69

Chapter

6.

Reports

.

.

.

.

.

.

.

.

. 71

Report

format

and

general

description

.

.

.

.

. 71

Report

ID

.

.

.

.

.

.

.

.

.

.

.

.

.

. 71

Report

group

.

.

.

.

.

.

.

.

.

.

.

.

. 71

Source

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 72

Attributes

.

.

.

.

.

.

.

.

.

.

.

.

.

. 72

Variables

.

.

.

.

.

.

.

.

.

.

.

.

.

. 72

Reports

in

the

accounting

subcomponent

.

.

.

. 73

UNIX

Acct

Commands

by

User,

Daily

Overview

73

UNIX

Acct

Users

by

Command,

Daily

Overview

74

UNIX

Acct

Cmd

Resource

Consumption,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 76

UNIX

Acct

User

Resource

Usage,

Monthly

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 77

UNIX

Acct

Disk

Blocks

by

User,

Monthly

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 78

UNIX

Acct

Disk

Blocks

in

1000s,

Monthly

Trend

79

UNIX

Acct

Users

and

Connects,

Daily

Overview

79

UNIX

Acct

Printed

Pages

by

User,

Monthly

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 80

UNIX

Acct

Printed

Pages

by

System,

Monthly

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 81

Reports

in

the

configuration

subcomponent

.

.

. 82

UNIX

Configuration

of

HW

for

a

System,

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 82

UNIX

Configuration

of

HW

for

Device

Class,

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 84

UNIX

Configuration

of

SW

for

a

System,

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 84

UNIX

Configuration

of

SW

for

Object,

Overview

86

Reports

in

the

error

subcomponent

.

.

.

.

.

. 87

UNIX

Error

by

ID,

Daily

Overview

.

.

.

.

. 87

UNIX

Error

by

Type,

Daily

Overview

.

.

.

. 88

UNIX

Error

by

Class,

Daily

Overview

.

.

.

. 89

UNIX

Error

by

Resource,

Daily

Overview

.

.

. 90

UNIX

Error

by

Resource,

Monthly

Trend

.

.

. 91

Reports

in

the

performance

subcomponent

.

.

.

. 92

UNIX

Perf

CPU

Utilization

by

System,

Hourly

Trend

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 92

UNIX

Perf

CPU

Utilization

by

System,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 93

UNIX

Perf

Statistics

by

System,

Hourly

Trend

.

. 94

UNIX

Perf

Statistics

all

Systems,

Daily

Overview

95

UNIX

Perf

Vol

Group

and

File

Syst,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

.

.

.

. 96

UNIX

Perf

Disk

I/O

for

a

Disk,

Hourly

Trend

.

. 97

UNIX

Perf

Disk

I/O

for

System,

Daily

Overview

98

UNIX

Perf

Page

Space

Utilization,

Hourly

Trend

99

LINUX

Percentile

Work

Size

.

.

.

.

.

.

. 101

LINUX

Disk

Space

Allocation

.

.

.

.

.

.

. 102

LINUX

Performance

from

User

Memory

.

.

. 103

LINUX

Performance

’PS’

for

Volumes

Info

.

. 104

LINUX

Hardware

Configuration

.

.

.

.

.

. 105

LINUX

Software

Configuration

.

.

.

.

.

. 106

LINUX

User

Information

.

.

.

.

.

.

.

. 107

LINUX

Process

Information

.

.

.

.

.

.

. 108

LINUX

Performance

’VM’

for

Swap

Memory

109

LINUX

Performance

’VM’

for

CPU

.

.

.

.

. 110

Chapter

7.

Log

Record

Definitions

.

. 111

ACCT_COMMAND

.

.

.

.

.

.

.

.

.

.

. 111

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 111

ACCT_CONNECT

.

.

.

.

.

.

.

.

.

.

.

. 112

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 112

ACCT_DISK

.

.

.

.

.

.

.

.

.

.

.

.

.

. 112

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 112

iv

Tivoli

Decision

Support

for

OS/390:

Distributed

Systems

Performance

Feature

Guide

and

Reference

||||

||||

ACCT_PRINT

.

.

.

.

.

.

.

.

.

.

.

.

. 113

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 113

CONFIG_HW

.

.

.

.

.

.

.

.

.

.

.

.

. 113

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 113

CONFIG_SW

.

.

.

.

.

.

.

.

.

.

.

.

. 114

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 114

Record

section

SUBTYPE_H

.

.

.

.

.

.

. 114

Record

section

SUBTYPE_I

.

.

.

.

.

.

.

. 114

Record

section

SUBTYPE_L

.

.

.

.

.

.

.

. 114

Record

section

FILE_NAME

.

.

.

.

.

.

. 114

Record

section

PATH_NAME

.

.

.

.

.

.

. 115

Record

section

PRODUCT_DESC

.

.

.

.

.

. 115

ERROR

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 115

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 115

PERF_CPU

.

.

.

.

.

.

.

.

.

.

.

.

.

. 115

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 116

PERF_DISK_FS

.

.

.

.

.

.

.

.

.

.

.

.

. 116

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 116

Record

section

FILE_SYSTEM

.

.

.

.

.

.

. 116

Record

section

DEVICE_NAME

.

.

.

.

.

. 117

Record

section

SPACE_NAME

.

.

.

.

.

.

. 117

PERF_DISK_VG

.

.

.

.

.

.

.

.

.

.

.

. 117

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 117

Record

section

VOLUME_GROUP

.

.

.

.

. 117

Record

section

SPACE_NAME

.

.

.

.

.

.

. 118

PERF_DISK_IO

.

.

.

.

.

.

.

.

.

.

.

.

. 118

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 118

PERF_PAGING

.

.

.

.

.

.

.

.

.

.

.

.

. 119

Main

section

.

.

.

.

.

.

.

.

.

.

.

.

. 119

Part

3.

ARM

Guide

.

.

.

.

.

.

.

. 121

Chapter

8.

Introducing

the

ARM

component

.

.

.

.

.

.

.

.

.

.

.

. 123

Chapter

9.

Installing

and

Configuring

the

ARM

Component

.

.

.

.

.

.

.

. 125

Installing

the

ARM

component

on

OS/390

.

.

. 125

Updating

the

lookup

tables

.

.

.

.

.

.

.

.

. 125

Updating

X_NODE_NAME

.

.

.

.

.

.

.

. 125

Testing

the

installation

.

.

.

.

.

.

.

.

.

. 126

Putting

the

ARM

component

into

production

.

.

. 126

Part

4.

ARM

Reference

.

.

.

.

.

. 127

Chapter

10.

Data

Flow

and

Tivoli

Decision

Support

for

OS/390

Objects

. 129

ARM

Agents

general

data

flow

.

.

.

.

.

.

. 129

Chapter

11.

Data

Tables,

Lookup

Tables,

and

Control

tables

.

.

.

.

.

. 131

Naming

standard

for

tables

.

.

.

.

.

.

.

.

. 131

Table

descriptions

.

.

.

.

.

.

.

.

.

.

.

. 131

ARM_TABLE_H,_D,_M

.

.

.

.

.

.

.

.

. 131

Lookup

Tables

.

.

.

.

.

.

.

.

.

.

.

. 132

X_NODE_NAME

.

.

.

.

.

.

.

.

.

.

. 133

Example

of

table

contents

.

.

.

.

.

.

. 133

Chapter

12.

Reports

.

.

.

.

.

.

.

. 135

ARM

report

definitions

.

.

.

.

.

.

.

.

.

. 135

ARM

reports

.

.

.

.

.

.

.

.

.

.

.

.

. 135

UNIX

Application

Monitoring

Hourly

Response

Times

trend

report

.

.

.

.

.

.

.

.

.

.

. 135

UNIX

Application

Monitoring

Hourly

Service

Level

Summary

report

.

.

.

.

.

.

.

.

. 136

Chapter

13.

Log

Record

Definitions

139

ARM

log

collector

.

.

.

.

.

.

.

.

.

.

.

. 139

ARM

log

definitions

.

.

.

.

.

.

.

.

.

.

. 139

ARM

record

definitions

.

.

.

.

.

.

.

.

.

. 139

Part

5.

Distributed

Monitoring

Guide

.

.

.

.

.

.

.

.

.

.

.

.

.

. 141

Chapter

14.

Introducing

Distributed

Monitoring

.

.

.

.

.

.

.

.

.

.

.

. 143

Chapter

15.

Configuring

Distributed

Monitoring

.

.

.

.

.

.

.

.

.

.

.

. 145

Processing

Distributed

Monitoring

data

and

sending

it

to

OS/390

.

.

.

.

.

.

.

.

.

.

. 145

Create

the

task

from

a

UNIX

system

.

.

.

.

. 146

Create

the

task

from

an

OS/390

UNIX

system

service

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 147

Create

the

task

from

a

Windows

NT

system

.

. 147

Execute

the

task

.

.

.

.

.

.

.

.

.

.

. 148

Updating

the

lookup

tables

.

.

.

.

.

.

.

.

. 149

Updating

X_NODE_NAME

.

.

.

.

.

.

.

. 149

Updating

SENTRY_MONITOR_NT

.

.

.

.

. 150

Updating

SENTRY_MONITOR_UN

.

.

.

.

. 150

Testing

the

installation

.

.

.

.

.

.

.

.

.

. 150

Putting

the

Distributed

Monitoring

component

into

production

.

.

.

.

.

.

.

.

.

.

.

.

.

. 150

Part

6.

Distributed

Monitoring

Reference

.

.

.

.

.

.

.

.

.

.

.

. 151

Chapter

16.

Data

Flow

and

Tivoli

Decision

Support

for

OS/390

Objects

. 153

Tivoli

Distributed

Monitoring

general

data

flow

154

Chapter

17.

Data

Tables,

Lookup

Tables,

and

Control

Tables

.

.

.

.

. 157

Naming

standard

for

tables

.

.

.

.

.

.

.

.

. 157

Table

descriptions

.

.

.

.

.

.

.

.

.

.

.

. 157

SENTRY_N_NT_H,_D,_W

.

.

.

.

.

.

.

.

. 157

SENTRY_N_UN_H,_D,_W

.

.

.

.

.

.

.

.

. 158

Lookup

Tables

.

.

.

.

.

.

.

.

.

.

.

.

. 159

X_NODE_NAME

.

.

.

.

.

.

.

.

.

.

. 159

Example

of

table

contents

.

.

.

.

.

.

. 159

SENTRY_MONITOR_NT

.

.

.

.

.

.

.

. 159

Example

of

table

contents

.

.

.

.

.

.

. 159

SENTRY_MONITOR_UN

.

.

.

.

.

.

.

. 160

Example

of

table

contents

.

.

.

.

.

.

. 160

Contents

v

Chapter

18.

Reports

.

.

.

.

.

.

.

. 161

Distributed

Monitoring

report

definitions

.

.

.

. 161

Reports

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 161

DM

Service

Level

Details

Hourly

(UNIX)

.

.

. 161

DM

Service

Level

Details

Daily

(UNIX)

.

.

. 163

DM

Service

Level

Details

Weekly

(UNIX)

.

.

. 165

DM

System

Resources

Monitors

Daily

(UNIX)

167

DM

Network

Monitors

Daily

(UNIX)

.

.

.

. 168

DM

Disk

Resource

Monitors

Daily

(UNIX)

.

. 169

DM

Service

Level

Details

Hourly

(NT)

.

.

.

. 170

DM

Service

Level

Details

Daily

(NT)

.

.

.

. 172

DM

Service

Level

Details

Weekly

(NT)

.

.

.

. 175

DM

TCP

Monitors

Daily

(NT)

.

.

.

.

.

.

. 177

DM

System

Monitors

Daily

(NT)

.

.

.

.

.

. 178

DM

Server

Monitors

Daily

(NT)

.

.

.

.

.

. 179

DM

Processor

Monitors

Daily

(NT)

.

.

.

.

. 180

DM

Memory

Details

Daily

(NT)

.

.

.

.

.

. 181

Part

7.

Appendixes

.

.

.

.

.

.

.

. 183

Appendix.

Log

Record

Definitions

.

. 185

Distributed

Monitoring

log

collector

.

.

.

.

.

. 185

Distributed

Monitoring

log

definitions

.

.

.

.

. 185

Distributed

Monitoring

record

definitions

.

.

.

. 185

Notices

.

.

.

.

.

.

.

.

.

.

.

.

.

. 187

Trademarks

.

.

.

.

.

.

.

.

.

.

.

.

.

. 189

List

of

abbreviations

.

.

.

.

.

.

.

. 191

Glossary

.

.

.

.

.

.

.

.

.

.

.

.

. 193

Index

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 197

vi

Tivoli

Decision

Support

for

OS/390:

Distributed

Systems

Performance

Feature

Guide

and

Reference

Figures

1.

Organizing

and

presenting

system

performance

data

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 4

2.

Implementation

process

for

the

UNIX

Performance

component

.

.

.

.

.

.

.

.

. 8

3.

Tivoli

Decision

Support

for

OS/390

Administration

window

.

.

.

.

.

.

.

. 25

4.

Components

window

.

.

.

.

.

.

.

.

. 25

5.

Installation

Options

window

.

.

.

.

.

.

. 26

6.

General

COLLECT

job

.

.

.

.

.

.

.

.

. 29

7.

Sample

COLLECT

job

with

an

INCLUDE

clause

.

.

.

.

.

.

.

.

.

.

.

.

.

. 30

8.

Daily

steps

involved

in

using

Tivoli

Decision

Support

for

OS/390

.

.

.

.

.

.

.

.

.

. 31

9.

General

COLLECT

job

.

.

.

.

.

.

.

.

. 37

10.

General

UNIX

Performance

component

data

flow

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 41

11.

UNIX

Accounting

component

data

flow

44

12.

UNIX

Configuration

subcomponent

data

flow

46

13.

UNIX

Error

subcomponent

data

flow

.

.

.

. 48

14.

UNIX

Performance

subcomponent

data

flow

50

15.

Example

of

UNIX

Acct

Commands

by

User,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

. 74

16.

Example

of

UNIX

Acct

Users

by

Command,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

. 75

17.

Example

of

UNIX

Acct

Cmd

Resource

Consumption,

Daily

Overview

.

.

.

.

.

. 76

18.

Example

of

UNIX

Acct

User

Resource

Usage,

Monthly

Overview

.

.

.

.

.

.

.

.

.

. 77

19.

Example

of

UNIX

Acct

Disk

Blocks

by

User,

Monthly

Overview

.

.

.

.

.

.

.

.

.

. 78

20.

Example

of

UNIX

Acct

Disk

Blocks

in

1000s,

Monthly

Trend

.

.

.

.

.

.

.

.

.

.

. 79

21.

Example

of

UNIX

Acct

Users

and

Connects,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

. 80

22.

Example

of

UNIX

Acct

Printed

Pages

by

User,

Monthly

Overview

.

.

.

.

.

.

.

.

.

. 81

23.

Example

of

UNIX

Acct

Printed

Pages

by

System,

Monthly

Overview

.

.

.

.

.

.

. 82

24.

Example

of

UNIX

Configuration

of

HW

for

a

System,

Overview

.

.

.

.

.

.

.

.

.

. 83

25.

Example

of

UNIX

Configuration

of

HW

for

Device

Class,

Overview

.

.

.

.

.

.

.

. 84

26.

Example

of

UNIX

Configuration

of

SW

for

a

System,

Overview

.

.

.

.

.

.

.

.

.

. 85

27.

Example

of

UNIX

Configuration

of

SW

for

Object,

Overview

.

.

.

.

.

.

.

.

.

.

. 86

28.

Example

of

UNIX

Error

by

ID,

Daily

Overview

88

29.

Example

of

UNIX

Error

by

Type,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

.

.

. 89

30.

Example

of

UNIX

Error

by

Class,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

.

.

. 89

31.

Example

of

UNIX

Error

by

Resource,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

.

.

. 90

32.

Example

of

UNIX

Error

by

Resource,

Monthly

Trend

.

.

.

.

.

.

.

.

.

.

.

.

.

. 91

33.

Example

of

UNIX

Perf

CPU

Utilization

by

System,

Hourly

Trend

.

.

.

.

.

.

.

.

. 93

34.

Example

of

UNIX

Perf

CPU

Utilization

by

System,

Daily

Overview

.

.

.

.

.

.

.

. 94

35.

Example

of

UNIX

Perf

Statistics

by

System,

Hourly

Trend2

.

.

.

.

.

.

.

.

.

.

. 95

36.

Example

of

UNIX

Perf

Statistics

all

Systems,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

. 96

37.

Example

of

UNIX

Perf

Vol

Group

and

File

Syst,

Daily

Overview

.

.

.

.

.

.

.

.

. 97

38.

Example

of

UNIX

Perf

Disk

I/O

for

a

Disk,

Hourly

Trend

.

.

.

.

.

.

.

.

.

.

.

. 98

39.

Example

of

UNIX

Perf

Disk

I/O

for

System,

Daily

Overview

.

.

.

.

.

.

.

.

.

.

. 99

40.

Example

of

UNIX

Perf

Page

Space

Utilization,

Hourly

Trend

.

.

.

.

.

.

.

.

.

.

. 100

41.

Example

of

a

LINUX

-

Percentile

Work

Size

report

.

.

.

.

.

.

.

.

.

.

.

.

.

. 101

42.

Example

of

a

LINUX

-

Disk

Space

Allocation

report

.

.

.

.

.

.

.

.

.

.

.

.

.

. 102

43.

Example

of

a

LINUX

-

Performance

from

User

Memory

report

.

.

.

.

.

.

.

.

. 103

44.

Example

of

a

LINUX

-

Performance

’PS’

for

Volumes

Info

report

.

.

.

.

.

.

.

.

. 104

45.

Example

of

a

LINUX

-

Hardware

Configuration

report

.

.

.

.

.

.

.

.

. 105

46.

Example

of

a

LINUX

-

Software

Configuration

report

.

.

.

.

.

.

.

.

. 106

47.

Example

of

a

LINUX

-

User

Information

report

.

.

.

.

.

.

.

.

.

.

.

.

.

. 107

48.

Example

of

a

LINUX

-

Process

Information

report

.

.

.

.

.

.

.

.

.

.

.

.

.

. 108

49.

Example

of

a

LINUX

-

Performance

’VM’

for

Swap

Memory

report

.

.

.

.

.

.

.

.

. 109

50.

Example

of

a

LINUX

-

Performance

’VM’

for

CPU

report

.

.

.

.

.

.

.

.

.

.

.

. 110

51.

Daily

steps

involved

in

using

Tivoli

Decision

Support

for

OS/390

.

.

.

.

.

.

.

.

. 126

52.

General

ARM

data

flow

.

.

.

.

.

.

.

. 129

53.

UNIX

Application

Monitoring

Hourly

Response

Times

trend

report

.

.

.

.

.

. 135

54.

UNIX

Application

Monitoring

Hourly

Service

Level

Summary

report,

partial

view

.

.

.

. 136

55.

Daily

steps

involved

in

using

Tivoli

Decision

Support

for

OS/390

.

.

.

.

.

.

.

.

. 150

56.

General

Distributed

Monitoring

data

flow

154

57.

DM

Service

Level

Details

Hourly

Report

(UNIX)

.

.

.

.

.

.

.

.

.

.

.

.

.

. 162

58.

DM

Service

Level

Details

Daily

Report

(UNIX)

.

.

.

.

.

.

.

.

.

.

.

.

.

. 164

59.

DM

Service

Level

Details

Weekly

Report

(UNIX)

.

.

.

.

.

.

.

.

.

.

.

.

.

. 166

60.

DM

System

Resources

Monitors

Daily

Report

(UNIX)

.

.

.

.

.

.

.

.

.

.

.

.

.

. 168

61.

DM

Network

Monitors

Daily

Report

(UNIX)

169

vii

62.

DM

Disk

Resource

Monitors

Daily

Report

(UNIX)

.

.

.

.

.

.

.

.

.

.

.

.

.

. 170

63.

DM

Service

Level

Details

Hourly

Report

(NT)

171

64.

DM

Service

Level

Details

Daily

Report

(NT)

173

65.

DM

Service

Level

Details

Weekly

Report

(NT)

176

66.

DM

TCP

Monitors

Daily

Report

(NT)

178

67.

DM

System

Monitors

Daily

(DM)

.

.

.

.

. 179

68.

DM

Server

Monitors

Daily

(NT)

.

.

.

.

. 180

69.

DM

Processor

Monitors

Daily

Report

(NT)

181

70.

DM

Memory

Details

Daily

Report

(NT)

182

viii

Tivoli

Decision

Support

for

OS/390:

Distributed

Systems

Performance

Feature

Guide

and

Reference

Preface

This

book

describes

how

to

use

IBM®

Tivoli®

Decision

Support

for

OS/390®

(hereafter

referred

to

as

Tivoli

Decision

Support

for

OS/390)

to

collect

and

report

performance

data

generated

by

operating

systems

and

applications

running

on

a

workstation.

This

book:

v

Describes

performance

issues

and

how

they

affect

the

level

of

services

you

can

offer

users

v

Guides

you

through

the

component-selection,

installation,

and

implementation

processes

v

Explores

performance

characteristics

shown

in

Tivoli

Decision

Support

for

OS/390

reports

so

that

you

can

analyze

the

characteristics

of

your

system

Notes:

1.

Release

1

Modification

Level

1

of

this

feature

had

the

title

RISC

System/6000®

System

Performance

Feature.

2.

Release

2

of

this

feature

had

the

title

UNIX®

Performance

feature.

3.

Release

4

of

this

feature

had

the

title

Workstation

Performance

Feature.

4.

Release

5

of

this

feature

had

the

title

Distributed

Systems

Performance

Feature,

which

reflected

the

additional

functionality

that

had

been

incorporated.

5.

The

term

UNIX

used

in

this

book

covers

AIX®,

HP-UX,

and

Sun

Solaris

operating

systems.

When

AIX

is

used,

this

refers

only

to

the

IBM

operating

system

(and

not

to

HP-UX

or

Sun

Solaris).

Tivoli

Decision

Support

for

OS/390

was

previously

known

as

Tivoli

Performance

Reporter

for

OS/390.

The

terms

MVS™

and

OS/390

are

used

interchangeably

throughout

this

book.

Who

Should

Read

This

Book

The

Distributed

Systems

Performance

Feature

Guide

and

Reference

is

intended

for:

v

Anyone

who

analyzes

or

monitors

UNIX

performance

v

Anyone

responsible

for

establishing

or

meeting

service-level

objectives.

v

Tivoli

Decision

Support

for

OS/390

administrators

(primarily

as

a

guide

to

feature

installation

and

as

a

reference

to

table

and

report

definitions)

v

Users

with

various

backgrounds

who

are

interested

in

analyzing

workstation

performance

data

and

improving

workstation

performance.

What

This

Book

Contains

This

book

explains

how

to

collect

UNIX-generated

performance

data,

and

to

create

and

display

Tivoli

Decision

Support

for

OS/390

reports

to

both

monitor

and

understand

UNIX

performance.

This

book

contains

the

following

parts:

v

Use

Part

I

for

developing

and

implementing

your

performance

and

service-level

strategy:

–

Chapter

1,

“Introducing

the

UNIX

Performance

component,”

on

page

3

explains

basic

concepts

of

systems

management

and

offers

suggestions

on

ix

establishing

performance

objectives

and

service-level

agreements.

It

also

describes

the

UNIX

Performance

feature

role

in

the

Tivoli

Decision

Support

for

OS/390

environment.

–

Chapter

2,

“Installing

and

configuring

the

UNIX

and

LINUX

Performance

components,”

on

page

7

contains

a

task-oriented

description

of

how

to

plan

for

and

set

up

the

UNIX

Performance

feature

so

that

useful

reports

and

decision-support

information

are

available

immediately.v

Use

Part

II

for

a

detailed

description

of

the

UNIX

Performance

component:

–

Chapter

3,

“Data

flow

and

Tivoli

Decision

Support

for

OS/390

Objects,”

on

page

41

describes

the

flow

of

data

from

log

record

to

report,

showing

Tivoli

Decision

Support

for

OS/390

log

and

record

definitions,

tables,

and

reports.

–

Chapter

4,

“Data,

Lookup,

and

Control

Tables,”

on

page

53

describes

the

supplied

data

tables

and

updates,

including

columns

and

expressions.

It

contains

similar

descriptions

of

lookup

tables

and

control

tables.

–

Chapter

5,

“LINUX

data

tables,”

on

page

67

describes

the

data

tables

used

by

the

UNIX

Performance

component.

–

Chapter

6,

“Reports,”

on

page

71

contains

examples

of

the

UNIX

Performance

component

reports

and

shows

where

the

data

comes

from.

–

Chapter

7,

“Log

Record

Definitions,”

on

page

111

describes

the

UNIX

Performance

component

record

definitions

and

lists

the

record

types

you

can

select

with

each

of

them.v

Use

Part

III

for

a

description

of

the

ARM

component

and

an

explanation

of

how

to

install

and

use

it.

–

Chapter

8,

“Introducing

the

ARM

component,”

on

page

123

gives

an

overview

of

the

ARM

component.

–

Chapter

9,

“Installing

and

Configuring

the

ARM

Component,”

on

page

125

explains

how

to

install

and

operate

ARM.v

Use

Part

IV

for

a

detailed

description

of

the

ARM

component:

–

Chapter

10,

“Data

Flow

and

Tivoli

Decision

Support

for

OS/390

Objects,”

on

page

129

explains

the

flow

of

data

from

log

report

to

record.

–

Chapter

11,

“Data

Tables,

Lookup

Tables,

and

Control

tables,”

on

page

131

describes

the

data

tables

that

are

supplied

with

the

product.

–

Chapter

12,

“Reports,”

on

page

135

explains

the

types

of

reports

and

where

the

data

contained

in

them

comes

from.

–

Chapter

13,

“Log

Record

Definitions,”

on

page

139

describes

the

ARM

component

record

definitions

and

lists

the

record

types

you

can

select

with

each

of

them.v

Use

Part

V

for

developing

and

implementing

your

performance

and

service-level

strategy:

–

Chapter

14,

“Introducing

Distributed

Monitoring,”

on

page

143

explains

the

gathering

and

collecting

of

Tivoli

Distributed

Monitoring

data.

–

Chapter

15,

“Configuring

Distributed

Monitoring,”

on

page

145

explains

how

to

plan

for

and

set

up

Tivoli

Distributed

Monitoring

data

collection.v

Use

Part

VI

for

a

detailed

description

of

the

Tivoli

Distributed

Monitoring

component:

–

Chapter

16,

“Data

Flow

and

Tivoli

Decision

Support

for

OS/390

Objects,”

on

page

153

explains

the

flow

of

data

from

log

record

to

report.

–

Chapter

17,

“Data

Tables,

Lookup

Tables,

and

Control

Tables,”

on

page

157

describes

the

data

tables

that

are

supplied

with

the

product.

x

Tivoli

Decision

Support

for

OS/390:

Distributed

Systems

Performance

Feature

Guide

and

Reference

–

Chapter

18,

“Reports,”

on

page

161

explains

the

types

of

reports

and

where

the

data

contained

in

them

comes

from.v

Part

VII.

Appendixes,

contains

a

list

of

abbreviations,

glossary

and

index.

–

Appendix

A,

on

page

185

describes

the

Tivoli

Distributed

Monitoring

component

record

definitions

and

lists

the

record

types

you

can

select

with

each

of

them.

Publications

This

section

lists

publications

in

the

Tivoli

Decision

Support

for

OS/390

library

and

any

other

related

documents.

It

also

describes

how

to

access

Tivoli

publications

online

and

how

to

order

Tivoli

publications.

Tivoli

Decision

Support

for

OS/390

Library

The

following

documents

are

available

in

the

Tivoli

Decision

Support

for

OS/390

library:

v

Administration

Guide,

SH19-6816

Provides

information

about

initializing

the

Tivoli

Decision

Support

for

OS/390

database

and

customizing

and

administering

Tivoli

Decision

Support

for

OS/390.

v

Guide

to

the

Reporting

Dialog,

SH19-6842

Provides

information

for

users

who

display

existing

reports,

for

users

who

create

and

modify

reports,

and

for

administrators

who

control

reporting

dialog

default

functions

and

capabilities.

v

Language

Guide

and

Reference,

SH19-6817

Provides

information

for

adminstrators,

performance

analysts,

and

programmers

who

are

responsible

for

maintaining

system

log

data

and

reports.

v

User’s

Guide

for

the

Viewer,

SH19-4517

Provides

information

about

how

use

the

graphical

interface

for

Tivoli

Decision

Support

for

OS/390.

v

Messages

and

Problem

Determination,

SH19-6902

Provides

information

to

help

operators

and

system

programmers

understand,

interpret,

and

respond

to

Tivoli

Decision

Support

for

OS/390

messages

and

codes.

v

Accounting

Feature

for

the

Host,

SH19-4495

Provides

information

for

users

who

want

to

use

Tivoli

Decision

Support

for

OS/390

to

collect

and

report

performance

data

generated

by

the

Accounting

feature.

v

Accounting

Feature

for

the

Workstation,

SH19-4516

Provides

information

for

users

who

want

to

use

the

Accounting

Workstation

Option

to

manage,

process,

and

analyze

financial

data

on

a

workstation.

v

AS/400

System

Performance

Feature

Guide

and

Reference,

SH19-4019

Provides

information

for

administrators

and

users

about

collecting

and

reporting

performance

data

generated

by

AS/400®

systems.

v

CICS

Performance

Feature

Guide

and

Reference,

SH19-6820

Provides

information

for

administrators

and

users

about

collecting

and

reporting

performance

data

generated

by

Customer

Information

and

Control

System

(CICS®).

v

Distributed

Systems

Performance

Feature

Guide

and

Reference,

SH19-4018

Preface

xi

Provides

information

for

administrators

and

users

about

collecting

and

reporting

performance

data

generated

byoperating

systems

and

applications

running

on

a

workstation.

v

IMS

Performance

Feature

Guide

and

Reference,

SH19-6825

Provides

information

for

administrators

and

users

about

collecting

and

reporting

performance

data

generated

byInformation

Management

System

(IMS™).

v

Network

Performance

Feature

Installation

and

Administration,

SH19-6901

Provides

information

for

network

analysts

or

programmers

who

are

responsible

for

setting

up

the

network

reporting

environment.

v

Network

Performance

Feature

Reference,

SH19-6822

Provides

information

for

network

analysts

or

programmers

who

are

responsible

for

setting

up

the

network

reporting

environment.

v

Network

Performance

Feature

Reports,

SH19-6821

Provides

information

for

network

analysts

or

programmers

who

use

the

Network

Performance

feature

reports.

v

System

Performance

Feature

Guide,

SH19-6818

Provides

information

for

performance

analysts

and

system

programmers

who

are

responsible

for

meeting

the

service-level

objectives

established

in

your

organization.

v

System

Performance

Feature

Reference,

Volume

I,

SH19-6819

Provides

information

for

administrators

and

users

with

a

variety

of

backgrounds

who

want

to

use

Tivoli

Decision

Support

for

OS/390

to

analyze

Multiple

Virtual

Storage

(MVS)

or

Virtual

Machine

(VM)

performance

data.

v

System

Performance

Feature

Reference,

Volume

II,

SH19-4494

Provides

information

for

administrators

and

users

with

a

variety

of

backgrounds

who

want

to

use

Tivoli

Decision

Support

for

OS/390

to

analyze

Multiple

Virtual

Storage

(MVS)

or

Virtual

Machine

(VM)

performance

data.

v

IBM

Online

Library

Omnibus

Edition

OS/390

Collection

Kit,

SK2T-6700

CD

containing

all

OS/390

documentation.

v

IBM

Online

Library

z/OS

Software

Products

Collection

Kit,

SK3T-4270

CD

containing

all

z/OS®

documentation.

Using

LookAt

to

look

up

message

explanations

LookAt

is

an

online

facility

that

lets

you

look

up

explanations

for

most

messages

you

encounter,

as

well

as

for

some

system

abends

and

codes.

Using

LookAt

to

find

information

is

faster

than

a

conventional

search

because

in

most

cases

LookAt

goes

directly

to

the

message

explanation.

You

can

access

LookAt

from

the

Internet

at:

http://www.ibm.com/eserver/zseries/zos/bkserv/lookat/

or

from

anywhere

in

z/OS

or

z/OS.e

where

you

can

access

a

TSO/E

command

line

(for

example,

TSO/E

prompt,

ISPF,

z/OS

UNIX

System

Services

running

OMVS).

The

LookAt

Web

site

also

features

a

mobile

edition

of

LookAt

for

devices

such

as

Pocket

PCs,

Palm

OS,

or

Linux-based

handhelds.

So,

if

you

have

a

handheld

device

with

wireless

access

and

an

Internet

browser,

you

can

now

access

LookAt

message

information

from

almost

anywhere.

xii

Tivoli

Decision

Support

for

OS/390:

Distributed

Systems

Performance

Feature

Guide

and

Reference

http://www.ibm.com/eserver/zseries/zos/bkserv/lookat/

Accessing

Publications

Online

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.

The

Tivoli

Software

Information

Center

is

located

at

the

following

Web

address:

http://www.tivoli.com/support/documents/

Click

the

Tivoli

Decision

Support

for

OS/390

link

to

access

the

product

library.

These

publications

are

available

in

PDF

or

HTML

format,

or

both.

Translated

documents

are

also

available

for

some

products.

Note:

If

you

print

PDF

documents

on

other

than

letter-sized

paper,

select

the

Fit

to

page

check

box

in

the

Adobe

Acrobat

Print

dialog.

This

option

is

available

when

you

click

File

”

Print.

Fit

to

page

ensures

that

the

full

dimensions

of

a

letter-sized

page

print

on

the

paper

that

you

are

using.

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

v

In

other

countries,

for

a

list

of

telephone

numbers,

see

the

following

Web

site:

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

additional

information,

see

the

Accessibility

Appendix

in

the

Administration

Guide.

Contacting

software

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

want

to

contact

software

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:

Preface

xiii

http://www.tivoli.com/support/documents/http://www.elink.ibmlink.ibm.com/public/applications/publications/http://www.elink.ibmlink.ibm.com/public/applications/publications/http://www.ibm.com/software/tivoli/order-lit/http://www.ibm.com/software/sysmgmt/products/support/http://techsupport.services.ibm.com/guides/handbook.html

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

Note:

For

Tivoli

NetView®

for

OS/390

customers

only,

additional

support

is

available

on

the

NETVIEW

CFORUM

(Customer

Forum)

through

the

IBMLink™

system.

This

forum

is

monitored

by

NetView

developers

who

answer

questions

and

provide

guidance.

When

a

problem

with

the

code

is

found,

you

are

asked

to

open

an

official

problem

management

record

(PMR)

to

obtain

resolution.

Conventions

Used

in

This

Book

This

guide

uses

several

conventions

for

special

terms

and

actions,

operating

system-dependent

commands

and

paths,

and

margin

graphics.

The

term

z/OS

is

used

in

this

book

to

mean

z/OS

and

OS/390

operating

systems.

Where

the

term

OS/390

does

appear,

the

related

information

applies

only

to

OS/390

operating

systems.

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

Column

headings

in

a

table

v

Keywords

and

parameters

in

text

Italic

v

Citations

(titles

of

books,

diskettes,

and

CDs)

v

Words

defined

in

text

v

Emphasis

of

words

(words

as

words)

v

Letters

as

letters

v

New

terms

in

text

(except

in

a

definition

list)

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

xiv

Tivoli

Decision

Support

for

OS/390:

Distributed

Systems

Performance

Feature

Guide

and

Reference

Changes

in

This

Edition

This

edition

is

an

updated

version

that

replaces

the

previous

edition

of

the

same

book.

The

changes

are:

v

Some

software

requirements

have

changed

in

Chapter

2,

“Installing

and

configuring

the

UNIX

and

LINUX

Performance

components.”

Except

for

editorial

changes,

updates

to

this

edition

are

marked

with

a

vertical

bar

to

the

left

of

the

change.

Preface

xv

xvi

Tivoli

Decision

Support

for

OS/390:

Distributed

Systems

Performance

Feature

Guide

and

Reference

Part

1.

UNIX

Guide

Chapter

1.

Introducing

the

UNIX

Performance

component

.

.

.

.

.

.

.

.

.

.

.

.

.

. 3

Gathering

and

collecting

performance

data

.

.

.

. 3

Report

Groups

.

.

.

.

.

.

.

.

.

.

.

.

. 4

Chapter

2.

Installing

and

configuring

the

UNIX

and

LINUX

Performance

components

.

.

.

.

.

.

. 7

Planning

the

implementation

process

.

.

.

.

.

. 7

Considering

which

UNIX

subcomponents

to

install

. 8

Installing

the

UNIX

Performance

component

on

your

UNIX

nodes

.

.

.

.

.

.

.

.

.

.

.

.

.

. 9

Step

1:

Check

UNIX

requirements

.

.

.

.

.

. 9

Disk

space

requirements

.

.

.

.

.

.

.

. 9

Software

requirements

.

.

.

.

.

.

.

.

. 9

Step

2:

Transfer

Tivoli

Decision

Support

for

OS/390

feature

code

to

UNIX

.

.

.

.

.

.

. 10

Capturing

UNIX

Performance

component

data

and

transmitting

to

OS/390

.

.

.

.

.

.

.

.

.

. 13

Step

1:

Set

up

UNIX

accounting

.

.

.

.

.

. 13

Setting

up

accounting

for

AIX

.

.

.

.

.

. 13

Setting

up

accounting

for

HP

.

.

.

.

.

. 15

Setting

up

accounting

for

Sun

Solaris

.

.

.

. 16

Step

2:

Create

log

files

.

.

.

.

.

.

.

.

. 16

Step

3:

Define

the

receiver

of

UNIX

Performance

component

data

.

.

.

.

.

.

.

.

.

.

.

. 17

Step

4:

Customize

UNIX

Performance

component

parameters

.

.

.

.

.

.

.

.

. 18

Parameter

file

values

for

all

subcomponents

18

Parameter

file

values

for

performance

component

.

.

.

.

.

.

.

.

.

.

.

. 19

Step

5:

Start

the

drlperfd

daemon

.

.

.

.

.

. 20

Step

6:

Invoke

drlperfd

at

boot

time

.

.

.

.

. 21

Description

of

daily

tasks

performed

by

UNIX

Performance

component

.

.

.

.

.

.

.

.

. 21

Operating

the

UNIX

Performance

component

on

UNIX

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 22

Description

of

UNIX

Performance

component

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 23

AIX

commands

to

use

if

UNIX

Performance

component

installed

.

.

.

.

.

.

.

.

.

. 24

drlpsperfd

.

.

.

.

.

.

.

.

.

.

.

.

. 24

drlactperfd

.

.

.

.

.

.

.

.

.

.

.

. 24

drldeactperfd

.

.

.

.

.

.

.

.

.

.

.

. 24

drlsend

.

.

.

.

.

.

.

.

.

.

.

.

.

. 24

Installing

UNIX

Performance

component

on

the

OS/390

system

.

.

.

.

.

.

.

.

.

.

.

.

. 24

Updating

the

lookup

tables

.

.

.

.

.

.

.

.

. 26

Updating

XACCT_CONNECT_TYPE

.

.

.

.

. 26

Updating

X_NODE_NAME

.

.

.

.

.

.

.

. 27

Updating

XACCT_PRINT_TYPE

.

.

.

.

.

. 27

Collecting

data

under

Tivoli

Decision

Support

for

OS/390

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 27

Creating

your

Generation

Data

Groups

.

.

.

. 27

Renaming

files

sets

sent

from

UNIX

for

use

with

a

GDG

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 28

Example

of

renaming

UNIX

files

.

.

.

.

. 28

General

collect

job

.

.

.

.

.

.

.

.

.

.

. 29

Collect

job

with

specified

Tivoli

Decision

Support

for

OS/390

tables

.

.

.

.

.

.

.

.

.

.

. 29

Backup

and

delete

of

generation

data

sets

.

.

. 30

Testing

the

installation

.

.

.

.

.

.

.

.

.

.

. 30

Putting

the

feature

into

production

.

.

.

.

.

. 30

Considering

which

LINUX

subcomponents

to

install

31

Installing

the

LINUX

Performance

component

on

your

LINUX

nodes

.

.

.

.

.

.

.

.

.

.

.

. 31

Step

1:

Check

LINUX

requirements

.

.

.

.

. 31

Software

requirements

.