T l IBM Tivoli Monitoringpublib.boulder.ibm.com/tividd/td/ITM/SH19-4570-03/en_US/...v Appendix C, “MOF file properties,” on page 233 describes the MOF files used by the resource

Tivoli IBM

Tivoli

Monitoring

Resource

Model

Reference

Guide

Version

5.1.2

SH19-4570-03

Note

Before

using

this

information

and

the

product

it

supports,

be

sure

to

read

the

general

information

under

"Notices

in

the

back

matter

of

this

book.

Fourth

Edition

(March

2004)

This

edition

applies

to

version

5

release

1

modification

level

2

of

IBM

Tivoli

Monitoring

and

to

all

subsequent

releases

and

modifications

until

otherwise

indicated

in

new

editions.

This

edition

replaces

SH19-4570-02.

Copyright

IBM

Corporation

1999,

2004.

All

rights

reserved.

Note

to

U.S.

Government

Users

Restricted

RightsUse,

duplication

or

disclosure

restricted

by

GSA

ADP

Schedule

Contract

with

IBM

Corporation.

Contents

About

this

guide

.

.

.

.

.

.

.

.

.

. vii

Who

should

read

this

guide

.

.

.

.

.

.

.

.

. vii

What

this

reference

contains

.

.

.

.

.

.

.

.

. vii

Publications

.

.

.

.

.

.

.

.

.

.

.

.

.

. viii

IBM

Tivoli

Monitoring

library

.

.

.

.

.

.

. viii

Prerequisite

publications

.

.

.

.

.

.

.

.

. viii

Related

publications

.

.

.

.

.

.

.

.

.

. ix

Accessing

publications

online

.

.

.

.

.

.

.

. x

Ordering

publications

.

.

.

.

.

.

.

.

.

. x

Accessibility

.

.

.

.

.

.

.

.

.

.

.

.

.

. x

Contacting

IBM

Software

Support

.

.

.

.

.

.

. x

Conventions

used

in

this

guide

.

.

.

.

.

.

.

. xi

Typeface

conventions

.

.

.

.

.

.

.

.

.

. xi

Operating

system-dependent

variables

and

paths

xi

Tivoli

command

syntax

.

.

.

.

.

.

.

.

. xii

Chapter

1.

Introduction

.

.

.

.

.

.

.

. 1

Prerequisite

software

for

resource

models

.

.

.

.

. 1

Running

Tivoli

commands

.

.

.

.

.

.

.

.

.

. 2

Running

Tivoli

commands

on

UNIX

operating

systems

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 3

Running

Tivoli

commands

on

Windows

operating

systems

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 3

Where

to

find

additional

information

about

shells

4

Establishing

the

Tivoli

environment

within

a

shell

4

Establishing

the

Tivoli

environment

on

an

endpoint

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 5

Common

parameters

.

.

.

.

.

.

.

.

.

.

. 5

Chapter

2.

Windows

resource

models

.

. 7

Collect

Configuration

resource

model

.

.

.

.

.

. 7

Description

.

.

.

.

.

.

.

.

.

.

.

.

.

. 7

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 7

Event

Log

resource

model

.

.

.

.

.

.

.

.

.

. 8

Description

.

.

.

.

.

.

.

.

.

.

.

.

.

. 8

About

the

Windows

Event

Log

resource

model

.

. 8

Indications

and

events

.

.

.

.

.

.

.

.

.

. 9

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 13

Built-in

actions

.

.

.

.

.

.

.

.

.

.

.

. 13

Logical

Disk

resource

model

.

.

.

.

.

.

.

.

. 14

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 14

Prerequisites

.

.

.

.

.

.

.

.

.

.

.

.

. 15

Indications

and

events

.

.

.

.

.

.

.

.

.

. 15

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 21

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 21

Memory

resource

model

.

.

.

.

.

.

.

.

.

. 22

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 22

Indications

and

events

.

.

.

.

.

.

.

.

.

. 24

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 39

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 39

Network

Interface

Card

resource

model

.

.

.

.

. 40

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 40

Prerequisites

.

.

.

.

.

.

.

.

.

.

.

.

. 42

Indications

and

events

.

.

.

.

.

.

.

.

.

. 42

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 56

Built-in

actions

.

.

.

.

.

.

.

.

.

.

.

. 57

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 57

Parametric

Event

Log

resource

model

.

.

.

.

. 59

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 59

Indications

and

events

.

.

.

.

.

.

.

.

.

. 59

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 60

Parametric

Services

resource

model

.

.

.

.

.

. 62

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 62

Indications

and

events

.

.

.

.

.

.

.

.

.

. 62

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 64

Built-in

actions

.

.

.

.

.

.

.

.

.

.

.

. 64

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 64

Parametric

TCP/IP

Ports

resource

model

.

.

.

. 65

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 65

Prerequisites

.

.

.

.

.

.

.

.

.

.

.

.

. 65

Indications

and

events

.

.

.

.

.

.

.

.

.

. 66

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 66

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 66

Physical

Disk

resource

model

.

.

.

.

.

.

.

. 67

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 67

Indications

and

events

.

.

.

.

.

.

.

.

.

. 68

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 73

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 73

Printer

resource

model

.

.

.

.

.

.

.

.

.

. 74

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 74

Indications

and

events

.

.

.

.

.

.

.

.

.

. 74

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 79

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 80

Process

resource

model

.

.

.

.

.

.

.

.

.

. 80

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 80

Indications

and

events

.

.

.

.

.

.

.

.

.

. 80

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 82

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 82

Processor

resource

model

.

.

.

.

.

.

.

.

.

. 83

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 83

Indications

and

events

.

.

.

.

.

.

.

.

.

. 84

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 89

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 90

Server

Performance

Prediction

resource

model

.

.

. 91

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 91

Prerequisites

.

.

.

.

.

.

.

.

.

.

.

.

. 92

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 92

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 93

Services

resource

model

.

.

.

.

.

.

.

.

.

. 94

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 94

Indications

and

events

.

.

.

.

.

.

.

.

.

. 95

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 97

Built-in

actions

.

.

.

.

.

.

.

.

.

.

.

. 99

TCP/IP

resource

model

.

.

.

.

.

.

.

.

.

. 99

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 99

Prerequisites

.

.

.

.

.

.

.

.

.

.

.

.

. 100

Indications

and

events

.

.

.

.

.

.

.

.

. 100

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 102

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 103

iii

Chapter

3.

UNIX

and

Linux

resource

models

.

.

.

.

.

.

.

.

.

.

.

.

.

. 105

CPU

resource

model

.

.

.

.

.

.

.

.

.

.

. 105

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 105

Prerequisites

.

.

.

.

.

.

.

.

.

.

.

.

. 105

Indications

and

events

.

.

.

.

.

.

.

.

. 106

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 107

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 107

Description

of

the

MOF

file

properties

.

.

.

. 108

File

resource

model

.

.

.

.

.

.

.

.

.

.

. 109

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 109

Indications

and

events

.

.

.

.

.

.

.

.

. 109

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 111

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 111

Description

of

the

MOF

file

properties

.

.

.

. 111

File

System

resource

model

.

.

.

.

.

.

.

.

. 111

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 111

Indications

and

events

.

.

.

.

.

.

.

.

. 112

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 115

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 115

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 117

Description

of

the

MOF

file

properties

.

.

.

. 118

Memory

resource

model

.

.

.

.

.

.

.

.

.

. 118

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 118

Indications

and

events

.

.

.

.

.

.

.

.

. 119

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 121

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 121

Description

of

the

MOF

file

properties

.

.

.

. 122

Network

Interface

resource

model

.

.

.

.

.

. 122

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 122

Prerequisites

.

.

.

.

.

.

.

.

.

.

.

.

. 123

Indications

and

events

.

.

.

.

.

.

.

.

. 123

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 127

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 127

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 127

Description

of

the

MOF

file

properties

.

.

.

. 128

Network

RPC-NFS

resource

model

.

.

.

.

.

. 128

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 128

Indications

and

events

.

.

.

.

.

.

.

.

. 128

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 136

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 137

Description

of

the

MOF

file

properties

.

.

.

. 138

Process

resource

model

.

.

.

.

.

.

.

.

.

. 138

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 138

Indications

and

events

.

.

.

.

.

.

.

.

. 139

Thresholds

.

.

.

.

.

.

.

.

.

.

.

.

. 141

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 142

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 143

Description

of

the

MOF

file

properties

.

.

.

. 143

Security

resource

model

.

.

.

.

.

.

.

.

.

. 144

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 144

Indications

and

events

.

.

.

.

.

.

.

.

. 144

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 149

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 149

Description

of

the

MOF

file

properties

.

.

.

. 150

Server

Performance

Prediction

resource

model

.

. 150

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 150

Prerequisites

.

.

.

.

.

.

.

.

.

.

.

.

. 151

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 151

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 152

Description

of

the

MOF

file

properties

.

.

.

. 153

Chapter

4.

OS/400

resource

models

155

ASP

Disk

Mirroring

resource

model

.

.

.

.

.

. 155

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 155

Indications

and

events

.

.

.

.

.

.

.

.

. 155

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 157

ASP

Utilization

resource

model

.

.

.

.

.

.

. 158

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 158

Indications

and

events

.

.

.

.

.

.

.

.

. 158

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 161

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 161

Basic

Average

CPU

Utilization

resource

model

.

. 162

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 162

Indications

and

events

.

.

.

.

.

.

.

.

. 162

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 166

Basic

Interactive

CPU

Utilization

resource

model

167

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 167

Indications

and

events

.

.

.

.

.

.

.

.

. 167

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 171

Configuration

Objects

resource

model

.

.

.

.

. 173

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 173

Indications

and

events

.

.

.

.

.

.

.

.

. 173

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 174

Database

CPU

Utilization

resource

model

.

.

.

. 175

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 175

Indications

and

events

.

.

.

.

.

.

.

.

. 175

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 176

Distribution

Queues

resource

model

.

.

.

.

.

. 177

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 177

Indications

and

events

.

.

.

.

.

.

.

.

. 177

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 178

History

Log

resource

model

.

.

.

.

.

.

.

. 179

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 179

Indications

and

events

.

.

.

.

.

.

.

.

. 179

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 180

Interactive

Feature

CPU

Utilization

resource

model

181

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 181

Indications

and

events

.

.

.

.

.

.

.

.

. 181

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 182

Job

Log

resource

model

.

.

.

.

.

.

.

.

.

. 183

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 183

Indications

and

events

.

.

.

.

.

.

.

.

. 183

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 184

Job

Queue

resource

model

.

.

.

.

.

.

.

.

. 186

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 186

Indications

and

events

.

.

.

.

.

.

.

.

. 186

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 188

Job

Status

Events

resource

model

.

.

.

.

.

.

. 189

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 189

Indications

and

events

.

.

.

.

.

.

.

.

. 189

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 190

Management

Central

Events

resource

model

.

.

. 191

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 191

Indications

and

events

.

.

.

.

.

.

.

.

. 191

Network

Attributes

resource

model

.

.

.

.

.

. 194

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 194

Indications

and

events

.

.

.

.

.

.

.

.

. 194

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 195

Output

Queues

resource

model

.

.

.

.

.

.

. 196

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 196

Indications

and

events

.

.

.

.

.

.

.

.

. 196

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 197

iv

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide

Parametric

Object

and

Files

resource

model

.

.

. 198

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 198

Indications

and

events

.

.

.

.

.

.

.

.

. 198

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 200

Storage

Pools

resource

model

.

.

.

.

.

.

.

. 201

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 201

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 201

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 201

Subsystem

Status

resource

model

.

.

.

.

.

.

. 203

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 203

Indications

and

events

.

.

.

.

.

.

.

.

. 203

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 204

System

Disk

Resources

resource

model

.

.

.

.

. 205

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 205

Indications

and

events

.

.

.

.

.

.

.

.

. 205

Logging

.

.

.

.

.

.

.

.

.

.

.

.

.

. 207

System

Value

resource

model

.

.

.

.

.

.

.

. 208

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 208

Indications

and

events

.

.

.

.

.

.

.

.

. 208

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 209

TCP

Interface

resource

model

.

.

.

.

.

.

.

. 210

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 210

Indications

and

events

.

.

.

.

.

.

.

.

. 210

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 211

TCP

Service

resource

model

.

.

.

.

.

.

.

. 212

Description

.

.

.

.

.

.

.

.

.

.

.

.

. 212

Indications

and

events

.

.

.

.

.

.

.

.

. 212

Parameters

.

.

.

.

.

.

.

.

.

.

.

.

. 213

Appendix

A.

Windows

return

codes

for

built-in

actions

.

.

.

.

.

.

.

.

. 215

All

built-in

actions

.

.

.

.

.

.

.

.

.

.

.

. 215

Built-in

actions

of

the

event

log

resource

model

216

Enlarge

IRP

stack

size

action

.

.

.

.

.

.

. 216

Delete

registry

action

.

.

.

.

.

.

.

.

.

. 216

Raise

session

time

out

action

.

.

.

.

.

.

. 216

Built-in

actions

of

the

Network

Interface

Card

resource

model

.

.

.

.

.

.

.

.

.

.

.

.

. 217

Adjust

initial

work

items

action

.

.

.

.

.

. 217

Adjust

maximum

work

items

action

.

.

.

.

. 217

Built-in

actions

of

the

Service

resource

model

.

.

. 218

Restart

service

action

.

.

.

.

.

.

.

.

.

. 218

Appendix

B.

Windows

correlated

events

.

.

.

.

.

.

.

.

.

.

.

.

.

. 219

Busy

drive

from

high

paging

.

.

.

.

.

.

.

. 220

Busy

drive

from

low

avail

.

.

.

.

.

.

.

.

. 221

Congested

TCP

network

.

.

.

.

.

.

.

.

.

. 222

Critically

low

disk

space

.

.

.

.

.

.

.

.

. 223

Critical

memory

leak

.

.

.

.

.

.

.

.

.

.

. 224

Faulty

disk

subsystem

.

.

.

.

.

.

.

.

.

. 225

High

disk

read

bytes

per

second

.

.

.

.

.

.

. 226

High

disk

write

bytes

per

second

.

.

.

.

.

.

. 227

High

drive

transfer

rate

.

.

.

.

.

.

.

.

.

. 228

High

percent

disk

time

.

.

.

.

.

.

.

.

.

. 229

Possible

disk

fragmentation

.

.

.

.

.

.

.

. 230

Process

hogging

CPU

.

.

.

.

.

.

.

.

.

.

. 231

Slow

hard

drive

.

.

.

.

.

.

.

.

.

.

.

. 232

Appendix

C.

MOF

file

properties

.

.

. 233

DMXCpu.mof

.

.

.

.

.

.

.

.

.

.

.

.

. 233

DMXFile.mof

.

.

.

.

.

.

.

.

.

.

.

.

. 233

DMXFileSystem.mof

.

.

.

.

.

.

.

.

.

.

. 234

DMXMemory.mof

.

.

.

.

.

.

.

.

.

.

.

. 234

DMXNetworkInterface.mof

.

.

.

.

.

.

.

.

. 235

DMXNetworkRPCNFS.mof

.

.

.

.

.

.

.

.

. 235

DMXProcess.mof

.

.

.

.

.

.

.

.

.

.

.

. 236

DMXSecurity.mof

.

.

.

.

.

.

.

.

.

.

.

. 237

DMXSystem.mof

.

.

.

.

.

.

.

.

.

.

.

. 238

Notices

.

.

.

.

.

.

.

.

.

.

.

.

.

. 239

Trademarks

.

.

.

.

.

.

.

.

.

.

.

.

.

. 241

Glossary

.

.

.

.

.

.

.

.

.

.

.

.

. 243

Index

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 247

Contents

v

vi

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide

About

this

guide

The

IBM

Tivoli

Monitoring

product

enables

you

to

monitor

the

availability

and

performance

status

of

your

system

resources

to

identify

bottlenecks

and

potential

resource

problems.

The

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide

provides

key

information

about

the

resource

models

included

in

this

product.

Note:

The

IBM

Tivoli

Monitoring

product

was

formerly

known

as

Tivoli

Distributed

Monitoring

(Advanced

Edition).

Who

should

read

this

guide

The

target

audience

for

this

guide

is

system

administrators

responsible

for

the

installation

of

Tivoli

products

and

patches,

system

managers,

and

database

administrators

who

use

Tivoli

products

to

manage

resources.

Users

of

this

guide

should

be

familiar

with

the

following

topics:

v

Tivoli

management

software

v

System

administration

on

systems

where

you

plan

to

install

Tivoli

Monitoring

components,

and

systems

that

you

plan

to

monitor

using

the

product

v

UNIX

and

Linux

operating

systems

v

Windows

operating

systems

v

OS/400

operating

systems

v

Tivoli

Enterprise

Data

Warehouse

v

IBM

Tivoli

Enterprise

Console

v

IBM

Tivoli

Business

Systems

Manager

(optional)

What

this

reference

contains

This

reference

contains

the

following

chapters

and

appendixes:

v

About

this

guide

provides

information

about

the

IBM

Tivoli

Monitoring

publication

library,

prerequisite

and

related

publications,

and

IBM

Software

Support

information.

v

Chapter

1,

Introduction,

on

page

1

provides

an

introduction

to

using

IBM

Tivoli

Monitoring

resource

models,

resource

model

prerequisites,

and

instructions

on

setting

up

the

Tivoli

environment.

v

Chapter

2,

Windows

resource

models,

on

page

7

provides

an

alphabetical

listing

of

each

Windows

resource

model

with

a

detailed

description

of

the

resource

model.

v

Chapter

3,

UNIX

and

Linux

resource

models,

on

page

105

provides

an

alphabetical

listing

of

each

UNIX

and

Linux

resource

model

with

a

detailed

description

of

the

resource

model.

v

Chapter

4,

OS/400

resource

models,

on

page

155

provides

an

alphabetical

listing

of

each

OS/400

resource

model

with

a

detailed

description

of

the

resource

model.

v

Appendix

A,

Windows

return

codes

for

built-in

actions,

on

page

215

lists

return

codes

for

the

Windows

resource

models

that

have

built-in

actions.

v

Appendix

B,

Windows

correlated

events,

on

page

219

describes

correlated

events

and

the

indications

from

which

each

event

is

generated.

vii

v

Appendix

C,

MOF

file

properties,

on

page

233

describes

the

MOF

files

used

by

the

resource

models

and

the

CIM

classes

and

properties

which

they

define.

Publications

This

section

lists

publications

in

the

IBM

Tivoli

Monitoring

library

and

other

related

documents.

It

also

describes

how

to

access

Tivoli

publications

online,

and

how

to

order

Tivoli

publications.

IBM

Tivoli

Monitoring

library

The

following

documents

are

available

in

the

IBM

Tivoli

Monitoring

library:

v

IBM

Tivoli

Monitoring:

Users

Guide,

SH19-4569

Describes

how

to

install,

customize,

and

use

IBM

Tivoli

Monitoring

to

manage

system

and

application

resources.

v

IBM

Tivoli

Monitoring:

Resource

Model

Builder

Users

Guide,

SH32-1391

Describes

how

to

use

the

IBM

Tivoli

Monitoring

Resource

Model

Rule

Builder

(formerly

known

as

Workbench)

to

create

new

resource

models

or

to

modify

existing

ones.

v

IBM

Tivoli

Monitoring:

Problem

Determination

Guide,

SH19-8520

Provides

information

and

messages

to

assist

users

with

troubleshooting

problems

with

the

software.

v

IBM

Tivoli

Monitoring:

Resource

Model

Builder

Problem

Determination

Guide,

SC32-1392

Describes

the

tools

and

troubleshooting

techniques

for

doing

problem

determination

for

the

Resource

Model

Builder.

v

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide,

SH19-4570

Provides

information

about

using

and

customizing

resource

models

that

can

be

used

with

IBM

Tivoli

Monitoring.

v

IBM

Tivoli

Monitoring:

Release

Notes,

GI10-5797

Provides

the

most

current

information

about

IBM

Tivoli

Monitoring.

v

IBM

Tivoli

Monitoring:

Deployment

Supplement,

SC23-4799

Describes

how

to

use

the

deployment

wizard

for

a

custom

installation.

v

IBM

Tivoli

Monitoring:

Road

Map

for

a

Typical

Installation,

GI11-0938

Describes

typical

installation

scenarios.

Versions

of

these

documents

in

PDF

and

HTML

formats

can

be

found

on

the

IBM

Tivoli

Monitoring

product

CDs.

They

are

stored

in

the

Books

directory,

and

can

be

accessed

by

selecting

the

file

Books/infocenter.html

file

with

your

Web

browser.

This

displays

an

HTML

page

from

which

all

of

the

documents

can

be

accessed

in

either

format.

Any

updated

versions

of

these

documents

are

placed

on

the

Tivoli

Software

Information

Center

Web

site.

See

Accessing

publications

online

on

page

x

for

additional

information

about

updated

documentation.

Prerequisite

publications

To

use

the

information

in

this

guide

effectively,

you

must

have

some

prerequisite

knowledge,

which

you

can

get

from

the

following

guides:

v

Tivoli

Management

Framework:

Installation

Guide

Introduction:

What

this

reference

contains

viii

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide

Provides

information

about

installing

and

setting

up

the

Tivoli

Management

Framework

and

Tivoli

environment.

v

Tivoli

Management

Framework:

Planning

for

Deployment

Guide

Provides

information

about

the

architecture

provided

by

Tivoli

Management

Framework

and

the

choices

to

consider

when

planning

the

deployment

of

a

Tivoli

environment.

v

Tivoli

Management

Framework:

Users

Guide

Provides

the

concepts

and

procedures

for

using

Tivoli

Management

Framework

services.

v

Tivoli

Management

Framework:

Reference

Manual

Provides

detailed

information

about

Tivoli

Management

Framework

commands,

writing

scripts

that

are

later

run

as

Tivoli

tasks,

and

Tivoli-provided

tasks.

Related

publications

The

following

documents

also

provide

useful

information:

v

Tivoli

Distributed

Monitoring

(Classic

Edition)

Release

Notes

Provides

updated

information

about

the

Tivoli

Distributed

Monitoring

(Classic

Edition)

product

(formerly

known

as

Tivoli

Distributed

Monitoring).

v

Tivoli

Decision

Support

for

Server

Performance

Prediction:

Release

Notes

Provides

updated

information

about

the

integration

of

Tivoli

Decision

Support

for

Server

Performance

Prediction

with

Tivoli

Distributed

Monitoring

(Advanced

Edition).

v

Tivoli

Software

Installation

Service:

Users

Guide

Provides

task-oriented

information

on

how

to

import,

manage,

and

install

Tivoli

Management

Environment

software

on

selected

machines

and

managed

nodes

within

your

Tivoli

management

region.

v

Tivoli

Software

Installation

Service:

Release

Notes

Provides

important

information

about

using

and

installing

the

Tivoli

Software

Installation

Service

(SIS).

v

IBM

Tivoli

Enterprise

Console:

Rule

Builders

Guide

Provides

information

about

using

the

IBM

Tivoli

Enterprise

Console

rule

editor

and

graphical

rule

builder

to

modify

existing

rules

and

create

new

rules

to

match

your

specific

event

management

needs.

v

IBM

Tivoli

Enterprise

Console:

Release

Notes,

Version

3.7

or

later

Provides

the

most

current

information

about

IBM

Tivoli

Enterprise

Console.

v

Tivoli

Business

Systems

Management:

Distributed

Users

Guide,

Version

1.5

(if

you

intend

to

use

Tivoli

Business

Systems

Manager

to

monitor

IBM

Tivoli

Monitoring

events)

Describes

how

to

use

the

Tivoli

Business

Systems

Manager

product.

v

Tivoli

Business

Systems

Management:

Console

Users

Guide,

Version

1.5

(if

you

intend

to

use

Tivoli

Business

Systems

Manager

to

monitor

IBM

Tivoli

Monitoring

events)

Describes

how

to

use

the

Tivoli

Business

Systems

Manager

console.

The

Tivoli

Software

Glossary

includes

definitions

for

many

of

the

technical

terms

related

to

Tivoli

software.

The

Tivoli

Software

Glossary

is

available,

in

English

only,

at

the

following

Web

site:

http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm

About

this

guide:

Publications

About

this

guide

ix

http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm

Accessing

publications

online

The

documentation

CD

contains

the

publications

that

are

in

the

product

library.

The

format

of

the

publications

is

PDF,

HTML,

or

both.

Refer

to

the

readme

file

on

the

CD

for

instructions

on

how

to

access

the

documentation.

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

IBM

Tivoli

Monitoring

to

access

all

of

the

IBM

Tivoli

Monitoring

product

manuals.

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.

The

IBM

Software

Support

Web

site

provides

the

latest

information

about

known

product

limitations

and

workarounds

for

your

product.

You

can

view

this

information

at

the

following

Web

site:

http://www-3.ibm.com/software/support

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-3.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

most

features

of

the

graphical

user

interface.

For

additional

information,

see

the

Accessibility

Appendix

in

the

users

guide

for

this

product.

Contacting

IBM

Software

Support

If

you

have

a

problem

with

any

Tivoli

product,

see

the

following

IBM

Software

Support

Web

site:

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

About

this

guide:

Publications

x

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide

http://www.ibm.com/software/tivoli/libraryhttp://www-3.ibm.com/software/supporthttp://www.ibm.com/shop/publications/orderhttp://www.ibm.com/shop/publications/orderhttp://www-3.ibm.com/software/tivoli/order-lit/http://www-3.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:

v

Registration

and

eligibility

v

Telephone

numbers,

depending

on

the

country

in

which

you

are

located

v

Information

you

must

have

before

contacting

IBM

Software

Support

Conventions

used

in

this

guide

This

guide

uses

several

conventions

for

special

terms

and

actions,

and

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)

and

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)

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

The

publications

in

this

library

use

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.

About

this

guide:

Contacting

IBM

Software

Support

About

this

guide

xi

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

Note:

If

you

are

using

the

bash

shell

on

a

Windows

system,

you

can

use

the

UNIX

conventions.

Tivoli

command

syntax

The

following

special

characters

define

Tivoli

command

syntax:

[

]

Identifies

elements

that

are

optional.

Required

elements

do

not

have

brackets

around

them.

...

Indicates

that

you

can

specify

multiple

values

for

the

previous

element.

Separate

multiple

values

by

a

space,

unless

otherwise

directed

by

command

information.

If

the

ellipsis

for

an

element

follows

a

closing

bracket,

use

the

syntax

within

the

brackets

to

specify

multiple

values.

For

example,

to

specify

two

administrators

for

the

option

[a

admin]...,

use

a

admin1

a

admin2.

If

the

ellipsis

for

an

element

is

within

the

brackets,

use

the

syntax

of

the

last

element

to

specify

multiple

values.

For

example,

to

specify

two

hosts

for

the

option

[h

host...],

use

h

host1

host2.

|

Indicates

mutually

exclusive

information.

You

can

use

the

element

on

either

the

left

or

right

of

the

vertical

bar.

{

}

Delimits

a

set

of

mutually

exclusive

elements

when

a

command

requires

one

of

them.

Brackets

([

])

are

around

elements

that

are

optional.

In

addition

to

the

special

characters,

Tivoli

command

syntax

uses

the

typeface

conventions

described

in

the

Preface

of

this

document.

The

following

examples

illustrate

the

typeface

conventions

used

in

Tivoli

command

syntax:

v

wcrtpr

[a

admin]...

[s

region]

[m

resource]...

name

The

name

argument

is

the

only

required

element

for

the

wcrtpr

command.

The

brackets

around

the

options

indicate

they

are

optional.

The

ellipsis

after

the

a

admin

resource

option

means

that

you

can

specify

multiple

administrators

multiple

times.

The

ellipsis

after

the

m

resource

option

means

that

you

can

specify

multiple

resources

multiple

times.v

wchkdb

[o

outfile]

[u]

[x]

{f

infile

|

i

|

object...}

The

f,

i,

and

object

elements

are

mutually

exclusive.

Braces

that

surround

elements

indicate

that

you

are

including

a

required

element.

If

you

specify

the

object

argument,

you

can

specify

more

than

one

object.

About

this

guide:

Conventions

used

in

this

guide

xii

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide

Chapter

1.

Introduction

This

book

is

a

reference

guide

designed

for

use

with

the

procedures

described

in

the

IBM

Tivoli

Monitoring:

Users

Guide.

It

provides

alphabetical

listings

and

detailed

descriptions

of

the

following

software

functions:

v

Resource

models

v

Tasks

v

Server

commands

Prerequisite

software

for

resource

models

Information

about

prerequisite

software

required

to

run

IBM

Tivoli

Monitoring

resource

models

is

provided

in

the

individual

sections

for

each

resource

model.

The

following

tables

list

all

resource

models,

by

operating

system,

that

require

additional

steps

or

software

to

run

the

resource

model.

The

following

table

lists

the

resource

models

for

Windows

operating

systems

and

where

to

locate

prerequisite

information

required

to

run

the

resource

model.

Table

1.

Prerequisites

for

Windows

resource

models

Windows

resource

model

name

Location

of

prerequisite

information

Collect

Configuration

None

required.

Event

Log

None

required.

Logical

Disk

Prerequisites

on

page

15.

Memory

None

required.

Network

Interface

Card

Prerequisites

on

page

42.

Parametric

Event

Log

None

required.

Parametric

Services

None

required.

Parametric

TCP/IP

Ports

Prerequisites

on

page

65.

Physical

Disk

None

required.

Printer

None

required.

Process

None

required.

Processor

None

required.

Server

Performance

Prediction

Prerequisites

on

page

92.

Services

None

required.

TCP/IP

Prerequisites

on

page

100.

The

following

table

lists

the

resource

models

for

UNIX

and

Linux

operating

systems

and

where

to

locate

prerequisite

information

required

to

run

the

resource

model.

Table

2.

Prerequisites

for

UNIX

and

Linux

resource

models

UNIX

and

Linux

resource

model

name

Location

of

prerequisite

information

CPU

Prerequisites

on

page

105.

File

None

required.

1

Table

2.

Prerequisites

for

UNIX

and

Linux

resource

models

(continued)

UNIX

and

Linux

resource

model

name

Location

of

prerequisite

information

File

System

None

required.

Memory

None

required.

Network

Interface

Prerequisites

on

page

123.

Network

RPC-NFS

None

required.

Process

None

required.

Security

None

required.

Server

Performance

Prediction

Prerequisites

on

page

151.

The

following

table

lists

the

resource

models

for

OS/400

operating

systems

and

where

to

locate

prerequisite

information

required

to

run

the

resource

model.

Table

3.

Prerequisites

for

OS/400

resource

models

OS/400

resource

model

name

Location

of

prerequisite

information

ASP

Disk

Mirroring

None

required.

ASP

Utilization

None

required.

Basic

Average

CPU

Utilization

None

required.

Basic

Interactive

CPU

Utilization

None

required.

Configuration

Objects

None

required.

Database

CPU

Utilization

None

required.

Distribution

Queues

None

required.

History

Log

None

required.

Interactive

Feature

CPU

Utilization

None

required.

Job

Log

None

required.

Job

Queue

None

required.

Job

Status

Events

None

required.

Management

Central

Events

None

required.

Network

Attributes

None

required.

Output

Queues

None

required.

Parametric

Object

and

Files

None

required.

Storage

Pools

None

required.

Subsystem

Status

None

required.

System

Disk

Resources

None

required.

System

Value

None

required.

TCP

Interface

None

required.

TCP

Service

None

required.

Running

Tivoli

commands

You

can

perform

system

operations

from

a

UNIX

or

Windows

command-line

interface

(CLI)

in

addition

to

using

the

Tivoli

desktop.

Operations

that

you

run

from

the

command

line

are

referred

to

as

CLI

commands.

Introduction:

Prerequisites

for

resource

models

2

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide

Consider

using

the

command-line

interface

rather

than

the

graphical

user

interface

to

invoke

a

Tivoli

management

application

operation

in

the

following

circumstances:

v

You

do

not

have

access

to

a

graphical

user

interface,

such

as

when

you

dial

in

over

a

modem.

v

You

want

to

group

a

number

of

operations

together

inside

a

shell

script.

v

You

want

to

use

accessibility

tools

that

require

text-based

input

of

commands.

Most

Tivoli

CLI

commands

begin

with

the

letter

w

to

identify

them

as

Tivoli

commands.

Command

names

use

a

w+verb+object

syntax.

Example:

Use

the

wdmrm

command

to

add

or

remove

a

resource

model.

Most

Tivoli

commands

run

within

a

bash

shell

on

a

managed

node

or

on

a

Tivoli

management

region

server.

A

shell

is

a

command

interpreter

that

enables

the

operating

system

to

process

commands.

You

can

run

commands

from

a

shell

command

line

or

include

them

in

shell

scripts

on

UNIX

or

Windows

operating

systems.

A

Tivoli

management

region

server

is

a

Tivoli

server

and

the

set

of

clients

that

it

serves.

A

Tivoli

management

region

addresses

the

physical

connectivity

of

resources

whereas

a

policy

region

addresses

the

logical

organization

of

resources.

Before

running

Tivoli

commands,

you

must

set

the

Tivoli

environment

variables

for

the

shell.

The

managed

node

or

Tivoli

management

region

server

installation

process

supplies

the

scripts

to

set

the

Tivoli

environment

variables.

The

following

sections

of

this

guide

contain

descriptions

of

the

procedures

to

run

these

scripts:

Setting

the

Tivoli

environment

on

UNIX

operating

systems

on

page

4

and

Setting

the

Tivoli

environment

on

Windows

operating

systems

on

page

4.

You

must

also

have

the

appropriate

Tivoli

authorization

role

for

running

each

command.

Refer

to

the

reference

information

for

each

command

to

see

the

required

authorization

role.

Note:

Some

Tivoli

commands

can

run

on

an

endpoint.

To

set

the

Tivoli

environment

variables

on

an

endpoint,

see

Establishing

the

Tivoli

environment

on

an

endpoint

on

page

5.

Running

Tivoli

commands

on

UNIX

operating

systems

The

UNIX

operating

systems

contain

shells.

Tivoli

commands

can

run

in

the

Bourne,

Korn,

C,

and

bash

shells.

The

Bourne

shell

is

the

standard

UNIX

shell.

Every

UNIX

system

includes

the

Bourne

shell.

The

Korn

shell

supports

the

features

of

the

Bourne

shell

and

contains

extensions

applicable

only

to

the

Korn

shell.

The

C

shell

name

comes

from

the

C

programming

language

syntax.

The

bash

shell

supports

many

features

of

the

UNIX

shells.

Both

UNIX

and

Windows

systems

use

the

bash

shell.

Running

Tivoli

commands

on

Windows

operating

systems

When

you

install

a

Windows

managed

node

or

Windows

Tivoli

management

region

server,

the

installation

process

copies

the

bash

shell

executable

file

to

the

machine.

The

bash

shell

supports

many

UNIX

commands

and

UNIX

command

syntax.

An

example

is

the

forward

slash

(/)

for

the

directory

separator.

The

bash

shell

supports

the

features

of

the

Bourne

shell,

as

well

as

contains

extensions

applicable

only

to

the

bash

shell.

Note:

You

can

use

the

Windows

MS-DOS

shell

instead

of

the

bash

shell

to

run

most

Tivoli

commands

(after

you

set

the

Tivoli

environment

variables

with

Introduction:

Running

Tivoli

commands

Chapter

1.

Introduction

3

the

%SystemRoot%\system32\drivers\etc\Tivoli\setup_env

command).

However,

some

commands

and

Tivoli

tasks

require

a

bash

shell

to

run

successfully.

All

examples

of

Tivoli

commands

in

Tivoli

publications

use

bash

shell

syntax.

Where

to

find

additional

information

about

shells

The

following

lists

include

resources

where

you

can

find

additional

information

about

the

various

shells.

These

resources

were

available

at

the

time

the

lists

were

created.

The

lists

do

not

show

all

of

the

material

that

is

available,

and

Tivoli

does

not

provide

opinions

or

recommendations

about

any

of

these

resources.

UNIX

shells:

v

UNIX

in

a

Nutshell:

A

Desktop

Quick

Reference

for

System

V

Release

4

and

Solaris

7

(OReilly

Nutshell

handbook)

by

Arnold

Robbins.

ISBN:

1-56592-427-4.

v

Portable

Shell

Programming:

An

Extensive

Collection

of

Bourne

Shell

Examples

by

Bruce

Blinn.

ISBN:

0-13-451494-7.

v

Learning

the

Korn

Shell

(OReilly

Nutshell

handbook)

by

Bill

Rosenblatt

and

Mike

Loukides.

ISBN:

1-56592-054-6.

v

UNIX

C

Shell

Desk

Reference

by

Martin

Arick.

ISBN:

0-47-155680-7.

Bash

shell:

v

Learning

the

bash

Shell

(OReilly

Nutshell

handbook)

by

Cameron

Newham

and

Bill

Rosenblatt.

ISBN:

1-56592-347-2.

v

A

Brief

Introduction

to

the

bash

Shell

by

Jane

Anna

Langley.

http://www.cs.ups.edu/acl/unix_talk/bash.html

v

Bash

FAQ

(GNU

documentation).

http://www.delorie.com/gnu/docs/bash/FAQ

v

Bash

Reference

Manual

(GNU

documentation).

http://www.gnu.org/manual/bash/index.html

v

bash

command

reference

information

(GNU

documentation).

http://www.delorie.com/gnu/docs/bash/bash.1.html

Establishing

the

Tivoli

environment

within

a

shell

When

you

install

a

managed

node

or

Tivoli

management

region

server,

the

installation

process

supplies

shell

setup

scripts.

You

use

these

scripts

to

set

the

environment

variables

needed

for

running

Tivoli

commands.

Setting

the

Tivoli

environment

on

UNIX

operating

systems

The

following

steps

describe

how

to

set

the

Tivoli

environment

within

a

UNIX

shell:

1.

Log

in

to

a

UNIX

managed

node

or

Tivoli

management

region

server.

2.

Run

the

appropriate

setup

script

for

the

shell.

For

the

Bourne,

Korn,

or

bash

shell,

run

the

following

command:

.

/etc/Tivoli/setup_env.sh

For

the

C

shell,

run

the

following

command:

source

/etc/Tivoli/setup_env.csh

Setting

the

Tivoli

environment

on

Windows

operating

systems

The

following

steps

describe

how

to

set

the

Tivoli

environment

and

start

a

bash

shell

on

Windows.

1.

Log

in

to

a

Windows

managed

node

or

Tivoli

management

region

server.

2.

Open

a

command

window.

Introduction:

Running

Tivoli

commands

4

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide

3.

Run

the

following

command

in

the

command

window

to

set

Tivoli

environment

variables:

%SystemRoot%\system32\drivers\etc\Tivoli\setup_env.cmd

4.

Run

one

of

the

following

commands

in

the

command

window

to

start

the

bash

shell:

sh

OR

bash

Establishing

the

Tivoli

environment

on

an

endpoint

When

you

install

an

endpoint,

the

installation

process

supplies

setup

scripts.

Use

these

scripts

to

set

the

environment

variables

required

for

running

Tivoli

commands

on

an

endpoint.

The

following

steps

describe

how

to

set

the

Tivoli

environment

on

an

endpoint:

1.

Log

in

to

an

endpoint.

2.

Open

a

command

window.

3.

Run

the

appropriate

setup

script

in

the

command

window.

The

following

table

contains

setup

scripts

for

the

different

endpoint

operating

systems.

Table

4.

Setup

scripts

for

endpoint

operating

systems

Operating

System

Setup

Script

Location

Setup

Script

Name

AIX,

Solaris

/etc/Tivoli/lcf/endpoint_label

lcf_env.sh

(for

Bourne,

Korn,

and

bash

shells)

OR

lcf_env.csh

(for

C

shell)

Windows

%SystemRoot%\Tivoli\lcf\

endpoint_label

lcf_env.cmd

(for

MS-DOS)

or

lcf_env.sh

(for

bash

shell)

Common

parameters

This

section

describes

the

names

used

to

refer

to

Tivoli

endpoints

and

hosts.

For

detailed

information

about

IBM

Tivoli

Monitoring,

see

the

IBM

Tivoli

Monitoring

Users

Guide.

Endpoint

Name

The

Tivoli

Management

Framework

product

assigns

the

endpoint

label

when

creating

the

endpoint

within

the

Tivoli

environment.

Some

IBM

Tivoli

Monitoring

commands

use

this

label,

but

an

IBM

Tivoli

Monitoring

command

cannot

assign

or

modify

the

label.

This

label

is

usually

a

string,

such

as

Endpoint1.

The

variable

for

this

label

is

EndpointName.

Host

Name

The

host

name

is

the

name

that

is

assigned

to

the

server

within

the

network.

Some

IBM

Tivoli

Monitoring

commands

use

this

name,

but

an

IBM

Tivoli

Monitoring

command

cannot

assign

or

modify

the

name.

The

network

determines

the

format

of

this

name.

The

name

can

be

a

string,

such

as

acme.sp.dynamite.com,

or

an

IP

address,

such

as

123.123.123.1.

The

variable

for

this

label

is

HostName.

Type

hostname

at

the

command

line

to

determine

the

host

name.

Introduction:

Running

Tivoli

commands

Chapter

1.

Introduction

5

Note:

Some

attributes

are

denoted

as

key

attributes.

Key

attributes

to

allow

you

to

distinguish

one

attribute

from

another

when

there

is

more

than

one

instance

of

an

indication.

Introduction:

Common

parameters

6

IBM

Tivoli

Monitoring:

Resource

Model

Reference

Guide

Chapter

2.

Windows

resource

models

This

chapter

describes

resource

models

for

computers

that

run

on

Windows-based

operating

systems.

Collect

Configuration

resource

model

Description

Resource

model

distribution

Distribute

this

resource

model

to

Windows-based

operating

systems.

The

Collect

Configuration

resource

model

gathers

system

configuration

information

that

does

not

change,

or

changes

infrequently.

As

a

result,

it

should

have

a

very

large

cycle

time.

(The

default

value

is

one

day.)

This

resource

model

does

not

generate

any

events.

The

following

table

shows

the

key

characteristics

of

this

resource

model:

Resource

model

at

a

glance

Built-in

actions

No

Category

Windows

Clearing

events

No

Default

cycle

time

86,400

seconds

Internal

name

TMW_Configuration

Parameters

No

Thresholds

No

Logging

The

following

table

shows

the

resource,

context,

and

properties

for

which

data

can

be

logged:

Resource

Context

Properties

Memory

Configuration

Memory

Total

TotalVisiblePhysicalMemory

The

total

amount

of

physical

memory

available

to

the

operating

system,

in

megabytes.

This

value

does

not

necessarily

indicate

the

true

amount

of

physical

memory,

but

what

is

reported

to

the

operating

system

as

available

to

it.

7

Event

Log

resource

model

Description

Resource

model

distribution

Distribute

this

resource

model

to

Windows-based

operating

systems.

The

Event

Log

resource

model

examines

the

Windows

System

Event

Log

f