Tivoli

Management

Framework

Reference

Manual

Version

4.1.1

SC32-0806-01

���

Tivoli

Management

Framework

Reference

Manual

Version

4.1.1

SC32-0806-01

���

Note

Before

using

this

information

and

the

product

it

supports,

read

the

information

in

“Notices,”

on

page

479.

Tivoli

Management

Framework

Reference

Manual

©

Copyright

International

Business

Machines

Corporation

2003.

All

rights

reserved.

US

Government

Users

Restricted

Rights

–

Use,

duplication

or

disclosure

restricted

by

GSA

ADP

Schedule

Contract

with

IBM

Corp.

Contents

Preface

.

.

.

.

.

.

.

.

.

.

.

.

.

. vii

Who

should

read

this

document

.

.

.

.

.

.

. vii

Prerequisite

and

related

documents

.

.

.

.

.

. vii

What

this

manual

contains

.

.

.

.

.

.

.

.

. viii

Accessing

publications

online

.

.

.

.

.

.

.

. viii

Ordering

publications

.

.

.

.

.

.

.

.

.

.

. ix

Accessibility

.

.

.

.

.

.

.

.

.

.

.

.

.

. ix

Contacting

software

support

.

.

.

.

.

.

.

.

. ix

Conventions

used

in

this

guide

.

.

.

.

.

.

.

. ix

Part

1.

Platform

commands

.

.

.

.

. 1

Chapter

1.

Introduction

to

Tivoli

commands

.

.

.

.

.

.

.

.

.

.

.

.

. 3

Establishing

the

Tivoli

environment

.

.

.

.

.

.

. 3

Command

syntax

.

.

.

.

.

.

.

.

.

.

.

.

. 4

Object

references

.

.

.

.

.

.

.

.

.

.

.

.

. 4

Registered

names

.

.

.

.

.

.

.

.

.

.

.

. 5

Object

paths

.

.

.

.

.

.

.

.

.

.

.

.

. 5

Tivoli

transactions

.

.

.

.

.

.

.

.

.

.

.

. 6

Chapter

2.

Commands

by

component

.

. 7

Administrator

commands

.

.

.

.

.

.

.

.

.

. 7

Configuration

management

commands

.

.

.

.

. 7

Endpoint

and

gateway

commands

.

.

.

.

.

.

. 7

httpd

commands

.

.

.

.

.

.

.

.

.

.

.

.

. 8

Installation

commands

.

.

.

.

.

.

.

.

.

.

. 9

Interregion

commands

.

.

.

.

.

.

.

.

.

.

. 9

Low-level

maintenance

commands

.

.

.

.

.

.

. 9

Managed

node

commands

.

.

.

.

.

.

.

.

. 10

Multiplexed

distribution

commands

.

.

.

.

.

. 10

Notification

commands

.

.

.

.

.

.

.

.

.

. 11

Policy

commands

.

.

.

.

.

.

.

.

.

.

.

. 11

Query

commands

.

.

.

.

.

.

.

.

.

.

.

. 12

RDBMS

interface

module

(RIM)

commands

.

.

.

. 12

Revision

control

system

(RCS)

commands

.

.

.

. 12

Scheduler

commands

.

.

.

.

.

.

.

.

.

.

. 12

Task

library

commands

.

.

.

.

.

.

.

.

.

. 13

Miscellaneous

commands

.

.

.

.

.

.

.

.

.

. 13

Chapter

3.

Commands

alphabetically

15

idlarg

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 16

idlattr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 17

idlcall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 19

idlexception

.

.

.

.

.

.

.

.

.

.

.

.

.

. 21

idlinput

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 23

idlresult

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 24

lcfd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 25

lcfd.sh

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 35

logls

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 36

objcall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 38

odadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 41

odbls

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 54

odstat

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 56

oinstall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 61

oserv

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 63

tivoli

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 67

tmcmd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 69

tmstat

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 70

vdisp

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 72

w4inslcf.pl

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 73

waddicon

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 76

waddpath

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 78

wadminep

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 79

wauthadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

. 80

wbkupdb

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 82

wbindmsg

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 86

wbroadcast

.

.

.

.

.

.

.

.

.

.

.

.

.

. 87

wcatcher

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 88

wcd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 90

wchdep

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 91

wchkdb

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 92

wchknode

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 94

wchkpol

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 96

wci

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 97

wclient

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 103

wclrblk

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 108

wclrline

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 109

wco

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 110

wconnect

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 115

wcpcdrom

.

.

.

.

.

.

.

.

.

.

.

.

.

. 118

wcpyfile

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 120

wcrtadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

. 121

wcrtgate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 123

wcrtjob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 125

wcrtpol

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 127

wcrtpr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 128

wcrtprf

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 129

wcrtprfmgr

.

.

.

.

.

.

.

.

.

.

.

.

.

. 131

wcrtqlib

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 132

wcrtquery

.

.

.

.

.

.

.

.

.

.

.

.

.

. 133

wcrtrim

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 135

wcrttask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 139

wcrttlib

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 141

wdate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 142

wdel

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 143

wdelep

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 145

wdelgate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 146

wdeljob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 147

wdelpol

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 148

wdelpr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 149

wdelsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 150

wdeltask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 151

wdepot

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 152

wdepset

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 155

wdisconn

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 158

wdiskspace

.

.

.

.

.

.

.

.

.

.

.

.

.

. 159

wdistrib

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 160

wdisttask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 162

wdskspc

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 164

©

Copyright

IBM

Corp.

2003

iii

wdtmsg

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 165

weditini

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 166

wedsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 167

wenblsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 170

wep

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 171

wepmgr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 181

wepstatus

.

.

.

.

.

.

.

.

.

.

.

.

.

. 186

wepupgd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 189

wexpnotif

.

.

.

.

.

.

.

.

.

.

.

.

.

. 191

wgateway

.

.

.

.

.

.

.

.

.

.

.

.

.

. 192

wgetadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

. 202

wgetallinst

.

.

.

.

.

.

.

.

.

.

.

.

.

. 204

wgetdfpol

.

.

.

.

.

.

.

.

.

.

.

.

.

. 205

wgeteppol

.

.

.

.

.

.

.

.

.

.

.

.

.

. 206

wgetjob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 208

wgetkey

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 209

wgetpolm

.

.

.

.

.

.

.

.

.

.

.

.

.

. 210

wgetpr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 212

wgetprf

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 213

wgetquery

.

.

.

.

.

.

.

.

.

.

.

.

.

. 214

wgetrim

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 215

wgetsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 216

wgetsub

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 218

wgettask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 219

wgetval

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 220

whostid

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 221

whttpd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 222

wiconv

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 224

wident

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 225

widmap

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 226

wifconfig

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 228

winsblk

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 230

winsline

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 232

winstall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 234

winstdir

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 236

winstendpt

.

.

.

.

.

.

.

.

.

.

.

.

.

. 237

winstlcf

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 238

winterp

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 244

wlcftap

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 245

wln

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 247

wlocalhost

.

.

.

.

.

.

.

.

.

.

.

.

.

. 249

wlocktmr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 250

wlocpath

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 251

wlookup

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 252

wls

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 254

wlsconn

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 255

wlsendpts

.

.

.

.

.

.

.

.

.

.

.

.

.

. 257

wlsinst

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 258

wlsnotif

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 260

wlspol

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 262

wlspolm

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 263

wlssub

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 265

wlstlib

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 266

wmailhost

.

.

.

.

.

.

.

.

.

.

.

.

.

. 267

wmannode

.

.

.

.

.

.

.

.

.

.

.

.

.

. 268

wmcast

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 269

wmdist

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 272

wmdistgui

.

.

.

.

.

.

.

.

.

.

.

.

.

. 281

wmemsize

.

.

.

.

.

.

.

.

.

.

.

.

.

. 282

wmerge

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 283

wmrgaef

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 284

wmrgini

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 285

wmv

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 286

wmvrim

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 287

wpatch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 289

wping

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 290

wpopulate

.

.

.

.

.

.

.

.

.

.

.

.

.

. 291

wputeppol

.

.

.

.

.

.

.

.

.

.

.

.

.

. 292

wputpolm

.

.

.

.

.

.

.

.

.

.

.

.

.

. 293

wpwd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 296

wrcs

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 297

wrcsdiff

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 301

wrcsmerge

.

.

.

.

.

.

.

.

.

.

.

.

.

. 303

wrefresh

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 305

wregister

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 306

wrestart

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 308

wrimtest

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 309

wrimtrace

.

.

.

.

.

.

.

.

.

.

.

.

.

. 310

wrlog

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 312

wrm

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 315

wrmnode

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 316

wrplblk

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 318

wrplline

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 319

wrpt

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 320

wrunas

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 326

wruninvquery

.

.

.

.

.

.

.

.

.

.

.

.

. 327

wrunjob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 329

wrunquery

.

.

.

.

.

.

.

.

.

.

.

.

.

. 331

wruntask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 333

wschedjob

.

.

.

.

.

.

.

.

.

.

.

.

.

. 336

wserver

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 339

wsetadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

. 345

wsetdfpol

.

.

.

.

.

.

.

.

.

.

.

.

.

. 347

wseterr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 348

wsetjob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 349

wsetlang

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 351

wsetpkey

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 353

wsetpm

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 354

wsetpr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 355

wsetquery

.

.

.

.

.

.

.

.

.

.

.

.

.

. 356

wsetrim

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 358

wsetrimpw

.

.

.

.

.

.

.

.

.

.

.

.

.

. 360

wsettap

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 361

wsettask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 363

wsetval

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 364

wsndnotif

.

.

.

.

.

.

.

.

.

.

.

.

.

. 365

wstandalone

.

.

.

.

.

.

.

.

.

.

.

.

.

. 367

wstartsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 369

wsub

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 370

wsupport

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 371

wtailnotif

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 373

wtaskabort

.

.

.

.

.

.

.

.

.

.

.

.

.

. 374

wtimezone

.

.

.

.

.

.

.

.

.

.

.

.

.

. 376

wtemp

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 377

wtll

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 378

wtmrname

.

.

.

.

.

.

.

.

.

.

.

.

.

. 380

wtrace

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 381

wuname

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 384

wuninst

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 385

wunstmn

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 387

wunsub

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 389

wupdate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 391

iv

Tivoli

Management

Framework:

Reference

Manual

wvalidate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 392

wxterm

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 393

Part

2.

Policy

methods

.

.

.

.

.

. 395

Chapter

4.

Endpoint

policy

scripts

397

Endpoint

policy

methods

.

.

.

.

.

.

.

.

. 397

allow_install_policy

.

.

.

.

.

.

.

.

.

.

. 398

after_install_policy

.

.

.

.

.

.

.

.

.

.

. 402

login_policy

.

.

.

.

.

.

.

.

.

.

.

.

.

. 405

select_gateway_policy

.

.

.

.

.

.

.

.

.

. 407

Chapter

5.

Profile

manager

policy

scripts

.

.

.

.

.

.

.

.

.

.

.

.

.

. 411

Default

policy

methods

for

profile

managers

.

.

. 411

Validation

policy

methods

for

profile

managers

.

. 411

Profile

manager

policy

methods

.

.

.

.

.

.

. 411

pm_def_profile_managers

.

.

.

.

.

.

.

.

. 412

pm_def_profile_types

.

.

.

.

.

.

.

.

.

.

. 413

pm_def_subscribers

.

.

.

.

.

.

.

.

.

.

. 414

pm_val_remove_subscribers

.

.

.

.

.

.

.

. 415

pm_val_remove_subscription

.

.

.

.

.

.

.

. 416

pm_val_subscribers

.

.

.

.

.

.

.

.

.

.

. 417

pm_val_subscription

.

.

.

.

.

.

.

.

.

.

. 418

Chapter

6.

Task

library

policy

scripts

419

Default

policy

methods

for

task

libraries

.

.

.

. 419

Validation

policy

methods

for

task

libraries

.

.

. 419

Task

library

policy

methods

.

.

.

.

.

.

.

. 419

tl_def_dist_mode

.

.

.

.

.

.

.

.

.

.

.

. 420

tl_def_man_nodes

.

.

.

.

.

.

.

.

.

.

.

. 421

tl_def_prof_mgrs

.

.

.

.

.

.

.

.

.

.

.

. 422

tl_def_set_gid

.

.

.

.

.

.

.

.

.

.

.

.

. 423

tl_def_set_uid

.

.

.

.

.

.

.

.

.

.

.

.

. 424

tl_val_man_nodes

.

.

.

.

.

.

.

.

.

.

.

. 425

tl_val_prof_mgrs

.

.

.

.

.

.

.

.

.

.

.

. 426

tl_val_set_gid

.

.

.

.

.

.

.

.

.

.

.

.

. 427

tl_val_set_uid

.

.

.

.

.

.

.

.

.

.

.

.

. 428

Chapter

7.

Editing

policy

scripts

.

.

. 429

Editing

endpoint

policy

scripts

.

.

.

.

.

.

. 429

Editing

profile

manager

and

task

library

policy

scripts

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 429

Part

3.

Task

library

language

.

.

. 433

Chapter

8.

Task

library

language

overview

.

.

.

.

.

.

.

.

.

.

.

.

. 435

Using

the

wtll

command

.

.

.

.

.

.

.

.

. 435

Using

message

catalogs

with

a

task

library

.

.

. 436

Enabling

tasks

to

be

run

on

endpoints

.

.

.

.

. 437

Chapter

9.

Syntax

for

the

task

library

language

.

.

.

.

.

.

.

.

.

.

.

.

. 439

Setting

library

characteristics

.

.

.

.

.

.

.

. 439

Defining

Argument

layouts

.

.

.

.

.

.

.

.

. 441

Text

and

CryptoText

.

.

.

.

.

.

.

.

.

. 441

Choice

and

TextChoice

.

.

.

.

.

.

.

.

. 443

Example—Choice

layout

with

the

Resource

keyword

.

.

.

.

.

.

.

.

.

.

.

.

. 444

Example—TextChoice

layout

with

the

File

keyword

.

.

.

.

.

.

.

.

.

.

.

.

. 446

Example—TextChoice

layout

with

an

embedded

Choice

List

.

.

.

.

.

.

.

. 447

ChoiceButton

.

.

.

.

.

.

.

.

.

.

.

. 447

Example—Program

keyword

.

.

.

.

.

. 448

Example—Resource

keyword

.

.

.

.

.

. 448

RadioButton

.

.

.

.

.

.

.

.

.

.

.

.

. 449

Example—File

keyword

.

.

.

.

.

.

.

. 450

Example—embedded

list

of

radio

buttons

450

Creating

task

definitions

.

.

.

.

.

.

.

.

.

. 451

Defining

a

task

header

.

.

.

.

.

.

.

.

. 451

Defining

an

Implementation

clause

.

.

.

.

. 452

Defining

Argument

clauses

.

.

.

.

.

.

.

. 454

Adding

comments

to

a

task

library

.

.

.

.

.

. 456

Editing

the

TLL

configuration

files

.

.

.

.

.

. 456

Chapter

10.

Sample

Task

Library

.

.

. 459

Appendix.

Notices

.

.

.

.

.

.

.

.

. 479

Trademarks

.

.

.

.

.

.

.

.

.

.

.

.

.

. 480

Index

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 483

Contents

v

vi

Tivoli

Management

Framework:

Reference

Manual

Preface

Tivoli®

Management

Framework

is

the

base

component

for

the

Tivoli

product

line.

Using

Tivoli

Management

Framework

and

a

combination

of

Tivoli

Enterprise

applications,

you

can

manage

large

distributed

networks

with

multiple

operating

systems,

various

network

services,

diverse

system

tasks,

and

constantly

changing

nodes

and

users.

Tivoli

Management

Framework

provides

a

set

of

common

services

or

features

that

are

used

by

the

Tivoli

Enterprise

applications

installed

on

Tivoli

Management

Framework.

The

services

provided

by

Tivoli

Management

Framework

include,

but

are

not

limited

to,

the

following:

v

A

Dynamic

Host

Configuration

Protocol

(DHCP)

service

that

enables

dynamic

IP

addressing

for

installations

that

use

DHCP

v

A

task

library

through

which

you

can

create

tasks

and

execute

the

tasks

on

multiple

Tivoli

resources

v

A

scheduler

that

enables

you

to

schedule

all

Tivoli

operations,

including

the

execution

of

tasks

created

in

the

Tivoli

task

library

v

A

RDBMS

Interface

Module

(RIM)

that

enables

some

Tivoli

Enterprise

applications

to

write

application-specific

information

to

relational

databases

v

A

query

facility

that

enables

you

to

search

and

retrieve

information

from

a

relational

database

Tivoli

applications

installed

on

Tivoli

Management

Framework

are

enabled

to

use

the

services

provided

by

Tivoli

Management

Framework.

This

manual

provides

in-depth

information

about

Tivoli

Management

Framework

commands.

This

manual

is

helpful

when

writing

scripts

that

are

later

run

as

Tivoli

tasks.

This

manual

also

documents

Tivoli-provided

policy

scripts.

References

to

the

interpreter

type

for

a

particular

client

are

located

throughout

this

guide.

Interpreter

types

for

each

machine

type

are

located

in

the

Tivoli

Management

Framework

Release

Notes.

Who

should

read

this

document

This

document

is

intended

for

use

by

system

administrators

who

use

the

command

line

to

perform

Tivoli

operations.

It

is

also

helpful

in

writing

scripts

that

are

later

run

as

Tivoli

tasks.

Users

of

this

manual

should

have

some

knowledge

of

the

following:

v

The

UNIX®

or

Microsoft®

Windows®

operating

systems

v

Shell

programming

v

The

Motif

or

Windows

environment

Prerequisite

and

related

documents

Tivoli

provides

the

following

related

documentation:

v

Tivoli

Management

Framework

Planning

for

Deployment

Guide

Explains

how

to

plan

for

deploying

your

Tivoli

environment.

It

also

describes

Tivoli

Management

Framework

and

its

services.

©

Copyright

IBM

Corp.

2003

vii

v

Tivoli

Enterprise

Installation

Guide

Explains

how

to

install

and

upgrade

Tivoli

Enterprise™

software

within

your

Tivoli

region

using

the

available

installation

mechansims

provided

by

Tivoli

Software

Installation

Service

and

Tivoli

Management

Framework.

Tivoli

Enterprise

software

includes

the

Tivoli

server,

managed

nodes,

gateways,

endpoints,

and

RDBMS

Interface

Module

(RIM)

objects.

This

guide

also

provides

information

about

troubleshooting

installation

problems.

v

Tivoli

Management

Framework

User’s

Guide

Describes

the

concepts

and

procedures

for

using

Tivoli

Management

Framework

services.

It

provides

instructions

for

performing

tasks

from

the

Tivoli

desktop

and

from

the

command

line.

v

Tivoli

Management

Framework

Maintenance

and

Troubleshooting

Guide

Explains

how

to

maintain

a

Tivoli

environment

and

troubleshoot

problems

that

can

arise

during

normal

operations.

What

this

manual

contains

The

Tivoli

Management

Framework

Reference

Manual

contains

the

following

sections:

v

Part

1,

“Platform

commands,”

on

page

1

Provides

in-depth

information

about

Tivoli

commands

provided

by

Tivoli

Management

Framework.

Tivoli

commands

enable

you

to

perform

system

operations

from

a

UNIX

command

line

instead

of

using

the

Tivoli

desktop.

This

is

often

useful

when

you

do

not

have

access

to

a

graphical

display

such

as

when

logging

in

over

a

modem

line.

v

Part

2,

“Policy

methods,”

on

page

395

Provides

in-depth

information

about

the

default

and

validation

policy

scripts

and

methods

provided

by

Tivoli

Management

Framework.

Tivoli

Management

Framework

uses

default

and

validation

policy

in

the

task

library

and

profile

manager.

These

services

use

default

and

validation

methods

that

call

shell

scripts

to

set

or

validate

data.

You

can

edit

any

of

the

shell

scripts

to

create

custom

policies

for

your

organization.

Tivoli

gateways

and

endpoint

managers

also

use

policy

scripts.

The

endpoint

scripts

differ

from

the

default

and

validation

policy

in

that

policy

objects

are

associated

with

the

endpoint

scripts.

v

Part

3,

“Task

library

language,”

on

page

433

Provides

in-depth

information

about

creating

task

libraries

using

the

Tivoli

Task

Library

Language.

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.

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://publib.boulder.ibm.com/tividd/td/tdprodlist.html

viii

Tivoli

Management

Framework:

Reference

Manual

http://publib.boulder.ibm.com/tividd/td/tdprodlist.html

Note:

If

you

print

PDF

documents

on

other

than

letter-sized

paper,

set

the

option

in

the

File

→

Print

window

that

allows

Adobe

Reader

to

print

letter-sized

pages

on

your

local

paper.

Ordering

publications

You

can

order

many

Tivoli

publications

online

at

the

following

Web

site:

http://www.elink.ibmlink.ibm.com

From

this

Web

page,

select

Publications

and

follow

the

instructions.

You

can

also

order

by

telephone

by

calling

one

of

these

numbers:

v

In

the

United

States:

800-879-2755

v

In

Canada:

800-426-4968

In

other

countries,

see

the

following

Web

site

for

a

list

of

telephone

numbers:

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

Accessibility

Accessibility

features

help

users

with

a

physical

disability,

such

as

restricted

mobility

or

limited

vision,

to

use

software

products

successfully.

With

this

product,

you

can

use

assistive

technologies

to

hear

and

navigate

the

interface.

You

can

also

use

the

keyboard

instead

of

the

mouse

to

operate

all

features

of

the

graphical

user

interface.

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:

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

the

following

typeface

conventions:

Bold

v

Lowercase

commands

and

mixed

case

commands

that

are

otherwise

difficult

to

distinguish

from

surrounding

text

v

Interface

controls

Preface

ix

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

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

Message

text

and

prompts

addressed

to

the

user

v

Text

that

the

user

must

type

v

Values

for

arguments

or

command

options

This

guide

uses

the

UNIX

convention

for

specifying

environment

variables

and

for

directory

notation:

v

When

using

the

Windows

command

line,

replace

$variable

with

%variable%

for

environment

variables

and

replace

each

forward

slash

(/)

with

a

backslash

(\)

in

directory

paths.

v

When

using

the

bash

shell

on

Windows

operating

systems,

use

the

UNIX

conventions.

x

Tivoli

Management

Framework:

Reference

Manual

Part

1.

Platform

commands

Chapter

1.

Introduction

to

Tivoli

commands

.

.

. 3

Establishing

the

Tivoli

environment

.

.

.

.

.

.

. 3

Command

syntax

.

.

.

.

.

.

.

.

.

.

.

.

. 4

Object

references

.

.

.

.

.

.

.

.

.

.

.

.

. 4

Registered

names

.

.

.

.

.

.

.

.

.

.

.

. 5

Object

paths

.

.

.

.

.

.

.

.

.

.

.

.

. 5

Tivoli

transactions

.

.

.

.

.

.

.

.

.

.

.

. 6

Chapter

2.

Commands

by

component

.

.

.

.

. 7

Administrator

commands

.

.

.

.

.

.

.

.

.

. 7

Configuration

management

commands

.

.

.

.

. 7

Endpoint

and

gateway

commands

.

.

.

.

.

.

. 7

httpd

commands

.

.

.

.

.

.

.

.

.

.

.

.

. 8

Installation

commands

.

.

.

.

.

.

.

.

.

.

. 9

Interregion

commands

.

.

.

.

.

.

.

.

.

.

. 9

Low-level

maintenance

commands

.

.

.

.

.

.

. 9

Managed

node

commands

.

.

.

.

.

.

.

.

. 10

Multiplexed

distribution

commands

.

.

.

.

.

. 10

Notification

commands

.

.

.

.

.

.

.

.

.

. 11

Policy

commands

.

.

.

.

.

.

.

.

.

.

.

. 11

Query

commands

.

.

.

.

.

.

.

.

.

.

.

. 12

RDBMS

interface

module

(RIM)

commands

.

.

.

. 12

Revision

control

system

(RCS)

commands

.

.

.

. 12

Scheduler

commands

.

.

.

.

.

.

.

.

.

.

. 12

Task

library

commands

.

.

.

.

.

.

.

.

.

. 13

Miscellaneous

commands

.

.

.

.

.

.

.

.

.

. 13

Chapter

3.

Commands

alphabetically

.

.

.

.

. 15

idlarg

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 16

idlattr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 17

idlcall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 19

idlexception

.

.

.

.

.

.

.

.

.

.

.

.

.

. 21

idlinput

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 23

idlresult

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 24

lcfd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 25

lcfd.sh

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 35

logls

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 36

objcall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 38

odadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 41

odbls

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 54

odstat

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 56

oinstall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 61

oserv

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 63

tivoli

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 67

tmcmd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 69

tmstat

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 70

vdisp

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 72

w4inslcf.pl

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 73

waddicon

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 76

waddpath

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 78

wadminep

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 79

wauthadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

. 80

wbkupdb

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 82

wbindmsg

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 86

wbroadcast

.

.

.

.

.

.

.

.

.

.

.

.

.

. 87

wcatcher

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 88

wcd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 90

wchdep

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 91

wchkdb

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 92

wchknode

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 94

wchkpol

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 96

wci

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 97

wclient

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 103

wclrblk

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 108

wclrline

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 109

wco

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 110

wconnect

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 115

wcpcdrom

.

.

.

.

.

.

.

.

.

.

.

.

.

. 118

wcpyfile

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 120

wcrtadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

. 121

wcrtgate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 123

wcrtjob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 125

wcrtpol

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 127

wcrtpr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 128

wcrtprf

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 129

wcrtprfmgr

.

.

.

.

.

.

.

.

.

.

.

.

.

. 131

wcrtqlib

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 132

wcrtquery

.

.

.

.

.

.

.

.

.

.

.

.

.

. 133

wcrtrim

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 135

wcrttask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 139

wcrttlib

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 141

wdate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 142

wdel

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 143

wdelep

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 145

wdelgate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 146

wdeljob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 147

wdelpol

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 148

wdelpr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 149

wdelsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 150

wdeltask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 151

wdepot

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 152

wdepset

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 155

wdisconn

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 158

wdiskspace

.

.

.

.

.

.

.

.

.

.

.

.

.

. 159

wdistrib

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 160

wdisttask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 162

wdskspc

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 164

wdtmsg

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 165

weditini

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 166

wedsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 167

wenblsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 170

wep

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 171

wepmgr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 181

wepstatus

.

.

.

.

.

.

.

.

.

.

.

.

.

. 186

wepupgd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 189

wexpnotif

.

.

.

.

.

.

.

.

.

.

.

.

.

. 191

wgateway

.

.

.

.

.

.

.

.

.

.

.

.

.

. 192

wgetadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

. 202

wgetallinst

.

.

.

.

.

.

.

.

.

.

.

.

.

. 204

wgetdfpol

.

.

.

.

.

.

.

.

.

.

.

.

.

. 205

wgeteppol

.

.

.

.

.

.

.

.

.

.

.

.

.

. 206

wgetjob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 208

©

Copyright

IBM

Corp.

2003

1

wgetkey

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 209

wgetpolm

.

.

.

.

.

.

.

.

.

.

.

.

.

. 210

wgetpr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 212

wgetprf

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 213

wgetquery

.

.

.

.

.

.

.

.

.

.

.

.

.

. 214

wgetrim

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 215

wgetsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 216

wgetsub

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 218

wgettask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 219

wgetval

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 220

whostid

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 221

whttpd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 222

wiconv

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 224

wident

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 225

widmap

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 226

wifconfig

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 228

winsblk

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 230

winsline

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 232

winstall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 234

winstdir

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 236

winstendpt

.

.

.

.

.

.

.

.

.

.

.

.

.

. 237

winstlcf

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 238

winterp

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 244

wlcftap

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 245

wln

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 247

wlocalhost

.

.

.

.

.

.

.

.

.

.

.

.

.

. 249

wlocktmr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 250

wlocpath

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 251

wlookup

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 252

wls

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 254

wlsconn

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 255

wlsendpts

.

.

.

.

.

.

.

.

.

.

.

.

.

. 257

wlsinst

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 258

wlsnotif

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 260

wlspol

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 262

wlspolm

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 263

wlssub

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 265

wlstlib

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 266

wmailhost

.

.

.

.

.

.

.

.

.

.

.

.

.

. 267

wmannode

.

.

.

.

.

.

.

.

.

.

.

.

.

. 268

wmcast

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 269

wmdist

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 272

wmdistgui

.

.

.

.

.

.

.

.

.

.

.

.

.

. 281

wmemsize

.

.

.

.

.

.

.

.

.

.

.

.

.

. 282

wmerge

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 283

wmrgaef

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 284

wmrgini

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 285

wmv

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 286

wmvrim

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 287

wpatch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 289

wping

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 290

wpopulate

.

.

.

.

.

.

.

.

.

.

.

.

.

. 291

wputeppol

.

.

.

.

.

.

.

.

.

.

.

.

.

. 292

wputpolm

.

.

.

.

.

.

.

.

.

.

.

.

.

. 293

wpwd

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 296

wrcs

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 297

wrcsdiff

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 301

wrcsmerge

.

.

.

.

.

.

.

.

.

.

.

.

.

. 303

wrefresh

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 305

wregister

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 306

wrestart

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 308

wrimtest

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 309

wrimtrace

.

.

.

.

.

.

.

.

.

.

.

.

.

. 310

wrlog

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 312

wrm

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 315

wrmnode

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 316

wrplblk

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 318

wrplline

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 319

wrpt

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 320

wrunas

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 326

wruninvquery

.

.

.

.

.

.

.

.

.

.

.

.

. 327

wrunjob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 329

wrunquery

.

.

.

.

.

.

.

.

.

.

.

.

.

. 331

wruntask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 333

wschedjob

.

.

.

.

.

.

.

.

.

.

.

.

.

. 336

wserver

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 339

wsetadmin

.

.

.

.

.

.

.

.

.

.

.

.

.

. 345

wsetdfpol

.

.

.

.

.

.

.

.

.

.

.

.

.

. 347

wseterr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 348

wsetjob

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 349

wsetlang

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 351

wsetpkey

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 353

wsetpm

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 354

wsetpr

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 355

wsetquery

.

.

.

.

.

.

.

.

.

.

.

.

.

. 356

wsetrim

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 358

wsetrimpw

.

.

.

.

.

.

.

.

.

.

.

.

.

. 360

wsettap

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 361

wsettask

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 363

wsetval

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 364

wsndnotif

.

.

.

.

.

.

.

.

.

.

.

.

.

. 365

wstandalone

.

.

.

.

.

.

.

.

.

.

.

.

.

. 367

wstartsched

.

.

.

.

.

.

.

.

.

.

.

.

.

. 369

wsub

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 370

wsupport

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 371

wtailnotif

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 373

wtaskabort

.

.

.

.

.

.

.

.

.

.

.

.

.

. 374

wtimezone

.

.

.

.

.

.

.

.

.

.

.

.

.

. 376

wtemp

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 377

wtll

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 378

wtmrname

.

.

.

.

.

.

.

.

.

.

.

.

.

. 380

wtrace

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 381

wuname

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 384

wuninst

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 385

wunstmn

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 387

wunsub

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 389

wupdate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 391

wvalidate

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 392

wxterm

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 393

2

Tivoli

Management

Framework:

Reference

Manual

Chapter

1.

Introduction

to

Tivoli

commands

Tivoli

commands

enable

you

to

perform

system

operations

from

a

UNIX

command

line

instead

of

using

the

Tivoli

desktop.

This

is

often

useful

when

you

do

not

have

access

to

a

graphical

display

such

as

when

logging

in

over

a

modem

line.

All

Tivoli

end-user

commands

begin

with

a

w

to

identify

them

as

Tivoli

commands.

Commands

are

also

developed

with

a

w+verb+object

syntax,

which

matches

the

way

you

would

think

of

the

action.

For

example,

if

you

want

to

create

a

task,

use

the

wcrttask

command.

To

delete

a

job,

use

the

wdeljob

command.

It

is

often

convenient

or

more

appropriate

to

invoke

a

Tivoli

management

application

operation

from

the

command

line

than

from

the

graphical

user

interface.

For

example:

v

You

may

not

have

access

to

a

graphical

user

interface,

perhaps

because

you

dialed

in

over

a

modem

v

A

number

of

operations

are

going

to

be

grouped

together

inside

a

shell

script

v

You

would

rather

invoke

a

command

from

a

shell

Establishing

the

Tivoli

environment

Tivoli

Management

Framework

includes

the

setup_env.sh

and

setup_env.csh

scripts,

which

enable

you

to

establish

the

correct

search

paths

and

environment

variables.

These

setup

scripts

are

available

on

any

server

or

managed

node

in

the

Tivoli

region.

To

set

up

the

Tivoli

environment

variables,

follow

these

steps:

1.

Log

in

to

a

managed

node

or

the

Tivoli

server.

2.

Do

one

of

the

following:

On

UNIX

operating

systems

only,

do

one

of

the

following:

v

If

you

are

using

the

Bourne

shell,

enter

the

following

script:

.

/etc/Tivoli/setup_env.sh

v

If

you

are

using

the

C

shell,

enter

the

following

script:

source

/etc/Tivoli/setup_env.csh

On

Windows

operating

systems

only,

do

one

of

the

following:

v

From

a

bash

shell,

enter

the

following

command:

%SystemRoot%/system32/drivers/etc/Tivoli/setup_env.sh

v

From

a

command

prompt,

enter

the

following

command:

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

v

To

configure

the

Windows

command

line

to

automatically

source

the

Tivoli

environment,

follow

these

steps:

a.

Right-click

the

Command

Prompt

(MS-DOS)

shortcut

to

the

Tivoli

desktop.

b.

Click

Properties.

c.

Click

the

Shortcut

tab.

d.

In

the

Target

text

box,

enter

the

following

commands

on

a

single

line:

©

Copyright

IBM

Corp.

2003

3

%SystemRoot%\system32\cmd.exe

/k

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

You

now

have

an

environment

ready

to

perform

Tivoli

maintenance

operations.

Command

syntax

The

commands

in

this

book

use

the

following

special

characters

to

define

the

command

syntax:

[

]

Identifies

optional

options.

Options

not