IBM Tivoli Service Level Advisorpublib.boulder.ibm.com/tividd/td/TSLA/SC32-0833-03/en_US/... ·...
Transcript of IBM Tivoli Service Level Advisorpublib.boulder.ibm.com/tividd/td/TSLA/SC32-0833-03/en_US/... ·...
-
IBM
Tivoli
Service
Level
Advisor
Command
Reference
Version
2.1
SC32-0833-03
���
-
IBM
Tivoli
Service
Level
Advisor
Command
Reference
Version
2.1
SC32-0833-03
���
-
Fourth
Edition
(September
2004)
This
edition
applies
to
Version
2.1
of
IBM
Tivoli
Service
Level
Advisor
(program
number
5724–C40)
and
to
all
subsequent
releases
and
modifications
until
otherwise
indicated
in
new
editions.
©
Copyright
International
Business
Machines
Corporation
2002,
2004.
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
guide
.
.
.
.
.
.
.
.
. vii
Publications
.
.
.
.
.
.
.
.
.
.
.
.
.
. vii
IBM
Tivoli
Service
Level
Advisor
library
.
.
. vii
IBM
DB2
Universal
Database
Enterprise
Edition
library
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. viii
Tivoli
Data
Warehouse
library
.
.
.
.
.
.
. viii
Warehouse
Enablement
Packs
.
.
.
.
.
.
. ix
IBM
WebSphere
Application
Server
library
.
.
. ix
SLM
Administration
Console
Information
.
.
. ix
Related
publications
.
.
.
.
.
.
.
.
.
. ix
Accessing
Publications
Online
.
.
.
.
.
.
.
. x
Ordering
publications
.
.
.
.
.
.
.
.
.
.
. x
Accessibility
.
.
.
.
.
.
.
.
.
.
.
.
.
. x
Tivoli
technical
training
.
.
.
.
.
.
.
.
.
.
. x
Contacting
IBM
Software
Support
.
.
.
.
.
.
. x
Determine
the
business
impact
of
your
problem
xi
Describe
your
problem
and
gather
background
information
.
.
.
.
.
.
.
.
.
.
.
.
. xi
Submit
your
problem
to
IBM
Software
Support
xii
Searching
knowledge
bases
.
.
.
.
.
.
.
. xii
Obtaining
fixes
.
.
.
.
.
.
.
.
.
.
.
. xiii
Updating
support
information
.
.
.
.
.
.
. xiii
Participating
in
newsgroups
.
.
.
.
.
.
.
. xiv
Conventions
used
in
this
guide
.
.
.
.
.
.
.
. xv
Typeface
conventions
.
.
.
.
.
.
.
.
.
. xv
Operating
system-dependent
variables
and
paths
xv
Chapter
1.
Command
Line
Interface
Overview
.
.
.
.
.
.
.
.
.
.
.
.
.
. 1
CLI
Service
Commands
.
.
.
.
.
.
.
.
.
.
. 1
Special
Characters
.
.
.
.
.
.
.
.
.
.
. 3
CLI
Service
Connections
.
.
.
.
.
.
.
.
. 4
Return
Codes
.
.
.
.
.
.
.
.
.
.
.
.
. 4
Non-CLI
Service
Commands
.
.
.
.
.
.
.
.
. 4
Using
the
Command
Line
Interface
.
.
.
.
.
.
. 4
Configuring
for
Telnet
Access
to
the
Command
Line
Interface
.
.
.
.
.
.
.
.
.
.
.
.
. 5
List
and
Help
Methods
.
.
.
.
.
.
.
.
.
.
. 5
Using
the
CLI
Service
.
.
.
.
.
.
.
.
.
.
. 6
Password
Protection
.
.
.
.
.
.
.
.
.
.
. 6
Additional
CLI
Service
Commands
.
.
.
.
.
. 7
Chapter
2.
CLI
Service
Commands
.
.
. 11
scmd
help
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 12
scmd
list
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 14
scmd
setPassword
.
.
.
.
.
.
.
.
.
.
.
. 16
scmd
setPasswordEnabled
.
.
.
.
.
.
.
.
. 18
Chapter
3.
Extract,
Transform,
and
Load
Process
Commands
.
.
.
.
.
. 21
scmd
etl
addApplicationData
.
.
.
.
.
.
.
. 22
scmd
etl
disable
.
.
.
.
.
.
.
.
.
.
.
.
. 24
scmd
etl
enable
.
.
.
.
.
.
.
.
.
.
.
.
. 26
scmd
etl
getApps
.
.
.
.
.
.
.
.
.
.
.
. 28
scmd
etl
getDataExpiration
.
.
.
.
.
.
.
.
. 29
scmd
etl
getDMVersion
.
.
.
.
.
.
.
.
.
. 31
scmd
etl
getIDInfo
.
.
.
.
.
.
.
.
.
.
.
. 32
scmd
etl
getMMVersion
.
.
.
.
.
.
.
.
.
. 35
scmd
etl
help
.
.
.
.
.
.
.
.
.
.
.
.
.
. 36
scmd
etl
list
.
.
.
.
.
.
.
.
.
.
.
.
.
. 37
scmd
etl
setDataExpiration
.
.
.
.
.
.
.
.
. 38
Chapter
4.
Escalation
Commands
.
.
. 41
scmd
escalate
checkCache
.
.
.
.
.
.
.
.
. 42
scmd
escalate
customize
.
.
.
.
.
.
.
.
.
. 43
scmd
escalate
disable
.
.
.
.
.
.
.
.
.
.
. 47
scmd
escalate
enable
.
.
.
.
.
.
.
.
.
.
. 48
scmd
escalate
help
.
.
.
.
.
.
.
.
.
.
.
. 51
scmd
escalate
list
.
.
.
.
.
.
.
.
.
.
.
. 52
scmd
escalate
parentSLAsEscalation
.
.
.
.
.
. 53
scmd
escalate
setCacheSize
.
.
.
.
.
.
.
.
. 55
scmd
escalate
snmp
FormatDateTime
.
.
.
.
.
. 56
scmd
escalate
TECLogging
.
.
.
.
.
.
.
.
. 57
scmd
escalate
test
.
.
.
.
.
.
.
.
.
.
.
. 58
scmd
escalate
update
email
.
.
.
.
.
.
.
.
. 59
scmd
escalate
view
.
.
.
.
.
.
.
.
.
.
.
. 61
Chapter
5.
Logging
and
Tracing
Commands
.
.
.
.
.
.
.
.
.
.
.
.
. 63
scmd
log
filter
.
.
.
.
.
.
.
.
.
.
.
.
. 64
scmd
log
handler
.
.
.
.
.
.
.
.
.
.
.
. 67
scmd
log
help
.
.
.
.
.
.
.
.
.
.
.
.
. 70
scmd
log
list
.
.
.
.
.
.
.
.
.
.
.
.
.
. 71
scmd
log
message
.
.
.
.
.
.
.
.
.
.
.
. 72
scmd
log
trace
.
.
.
.
.
.
.
.
.
.
.
.
. 75
Chapter
6.
Metric
Evaluator
Manager
Commands
.
.
.
.
.
.
.
.
.
.
.
.
. 79
scmd
mem
addSingleSchedulePeriod
.
.
.
.
.
. 80
scmd
mem
detectMissingAvailabilityData
.
.
.
. 82
scmd
mem
dumpData
.
.
.
.
.
.
.
.
.
.
. 87
scmd
mem
flushEvents
.
.
.
.
.
.
.
.
.
. 90
scmd
mem
help
.
.
.
.
.
.
.
.
.
.
.
.
. 91
scmd
mem
list
.
.
.
.
.
.
.
.
.
.
.
.
. 92
scmd
mem
reEval
.
.
.
.
.
.
.
.
.
.
.
. 93
scmd
mem
removeSingleSchedulePeriod
.
.
.
. 99
scmd
mem
removeStoppedRetryEntries
.
.
.
. 101
scmd
mem
retryMissedIntervals
.
.
.
.
.
.
. 103
scmd
mem
showAllSLAIDs
.
.
.
.
.
.
.
. 105
scmd
mem
showHourlyFrequencyIntervals
.
.
. 106
scmd
mem
showMetricEvaluators
.
.
.
.
.
. 108
scmd
mem
showRetrys
.
.
.
.
.
.
.
.
.
. 112
scmd
mem
skipHistoricSLAs
.
.
.
.
.
.
.
. 114
scmd
mem
trending
.
.
.
.
.
.
.
.
.
.
. 115
Chapter
7.
Offline
Commands
.
.
.
. 117
scmd
offline
createOfferinginXML
.
.
.
.
.
. 118
©
Copyright
IBM
Corp.
2002,
2004
iii
-
scmd
offline
help
.
.
.
.
.
.
.
.
.
.
.
. 120
scmd
offline
list
.
.
.
.
.
.
.
.
.
.
.
. 121
scmd
offline
migrateSLAs
.
.
.
.
.
.
.
.
. 122
scmd
offline
updateNames
.
.
.
.
.
.
.
.
. 124
scmd
offline
updateOffering
.
.
.
.
.
.
.
. 126
Chapter
8.
Order
Manager
Commands
127
scmd
om
help
.
.
.
.
.
.
.
.
.
.
.
.
. 128
scmd
om
list
.
.
.
.
.
.
.
.
.
.
.
.
. 129
scmd
om
redeployCompletedSLAs
.
.
.
.
.
. 130
scmd
om
submitSLA
.
.
.
.
.
.
.
.
.
.
. 132
Chapter
9.
Remote
Communication
Commands
.
.
.
.
.
.
.
.
.
.
.
. 133
scmd
rcc
getPort
.
.
.
.
.
.
.
.
.
.
.
. 134
scmd
rcc
help
.
.
.
.
.
.
.
.
.
.
.
.
. 135
scmd
rcc
list
.
.
.
.
.
.
.
.
.
.
.
.
.
. 136
scmd
rcc
setPort
.
.
.
.
.
.
.
.
.
.
.
. 137
Chapter
10.
Web
Report
User
Commands
.
.
.
.
.
.
.
.
.
.
.
. 139
scmd
report
addUser
.
.
.
.
.
.
.
.
.
.
. 140
scmd
report
changeUser
.
.
.
.
.
.
.
.
.
. 145
scmd
report
deleteUser
.
.
.
.
.
.
.
.
.
. 148
scmd
report
displayTimezones
.
.
.
.
.
.
. 149
scmd
report
help
.
.
.
.
.
.
.
.
.
.
.
. 151
scmd
report
list
.
.
.
.
.
.
.
.
.
.
.
.
. 152
scmd
report
listUser
.
.
.
.
.
.
.
.
.
.
. 153
Chapter
11.
Scheduler
Commands
155
scmd
scheduler
help
.
.
.
.
.
.
.
.
.
.
. 156
scmd
scheduler
list
.
.
.
.
.
.
.
.
.
.
. 157
scmd
scheduler
listSettings
.
.
.
.
.
.
.
.
. 158
scmd
scheduler
setMaxEvaluationThreads
.
.
.
. 159
scmd
scheduler
setMaxTimeForForcedScheduling
160
Chapter
12.
SLM
Database
Commands
161
scmd
sdc
adjustIDGenerator
.
.
.
.
.
.
.
. 163
scmd
sdc
createCustomer
.
.
.
.
.
.
.
.
. 164
scmd
sdc
createRealm
.
.
.
.
.
.
.
.
.
. 166
scmd
sdc
displayActiveServiceElements
.
.
.
. 168
scmd
sdc
displayAllCustomers
.
.
.
.
.
.
. 170
scmd
sdc
displayAllRealms
.
.
.
.
.
.
.
.
. 171
scmd
sdc
displayAllSchedules
.
.
.
.
.
.
.
. 172
scmd
sdc
displayAllServiceOfferings
.
.
.
.
. 174
scmd
sdc
displayAllSLAs
.
.
.
.
.
.
.
.
. 176
scmd
sdc
displayBaseSLAs
.
.
.
.
.
.
.
.
. 177
scmd
sdc
displayBusinessSchedules
.
.
.
.
.
. 179
scmd
sdc
displayCustomer
.
.
.
.
.
.
.
.
. 181
scmd
sdc
displayCustomerByID
.
.
.
.
.
.
. 182
scmd
sdc
displayCustomerFromSLAID
.
.
.
.
. 183
scmd
sdc
displayDataCollectorType
.
.
.
.
.
. 184
scmd
sdc
displayMilestoneSchedules
.
.
.
.
. 185
scmd
sdc
displayObsoleteServiceElements
.
.
.
. 186
scmd
sdc
displayOfferingElementList
.
.
.
.
. 187
scmd
sdc
displayOfferingScheduleName
.
.
.
. 188
scmd
sdc
displayOfferingState
.
.
.
.
.
.
.
. 189
scmd
sdc
displayRealm
.
.
.
.
.
.
.
.
.
. 190
scmd
sdc
displayScheduleByName
.
.
.
.
.
. 191
scmd
sdc
displayServiceOfferingByID
.
.
.
.
. 193
scmd
sdc
displayServiceOfferingID
.
.
.
.
.
. 195
scmd
sdc
displayServiceOfferingName
.
.
.
.
. 196
scmd
sdc
displayServiceOfferingsByState
.
.
.
. 197
scmd
sdc
displaySLAByID
.
.
.
.
.
.
.
.
. 199
scmd
sdc
displaySLAMetricPropertyID
.
.
.
.
. 200
scmd
sdc
displaySLAState
.
.
.
.
.
.
.
.
. 201
scmd
sdc
getAssociatedSLAID
.
.
.
.
.
.
.
. 202
scmd
sdc
help
.
.
.
.
.
.
.
.
.
.
.
.
. 203
scmd
sdc
list
.
.
.
.
.
.
.
.
.
.
.
.
. 204
scmd
sdc
purgeIntermediateResults
.
.
.
.
.
. 205
scmd
sdc
purgeOldData
.
.
.
.
.
.
.
.
.
. 206
scmd
sdc
registerWarehouseData
.
.
.
.
.
.
. 207
Chapter
13.
Component
Management
Commands
.
.
.
.
.
.
.
.
.
.
.
. 209
scmd
slm
getComponentStatus
.
.
.
.
.
.
. 210
scmd
slm
getStatus
.
.
.
.
.
.
.
.
.
.
. 212
scmd
slm
help
.
.
.
.
.
.
.
.
.
.
.
.
. 214
scmd
slm
list
.
.
.
.
.
.
.
.
.
.
.
.
. 215
scmd
slm
listComponents
.
.
.
.
.
.
.
.
. 216
scmd
slm
shutdown
.
.
.
.
.
.
.
.
.
.
. 217
scmd
slm
startComponent
.
.
.
.
.
.
.
.
. 218
scmd
slm
stopComponent
.
.
.
.
.
.
.
.
. 220
Chapter
14.
SLM
Object
Management
Commands
.
.
.
.
.
.
.
.
.
.
.
. 221
scmd
som
cancel
.
.
.
.
.
.
.
.
.
.
.
. 222
scmd
som
create
.
.
.
.
.
.
.
.
.
.
.
. 223
scmd
som
delete
.
.
.
.
.
.
.
.
.
.
.
. 225
scmd
som
displayAll
.
.
.
.
.
.
.
.
.
.
. 226
scmd
som
displayTimezones
.
.
.
.
.
.
.
. 227
scmd
som
export
.
.
.
.
.
.
.
.
.
.
.
. 228
scmd
som
help
.
.
.
.
.
.
.
.
.
.
.
.
. 229
scmd
som
list
.
.
.
.
.
.
.
.
.
.
.
.
. 230
Chapter
15.
Warehouse
Data
Collection
Commands
.
.
.
.
.
.
. 231
scmd
wdccli
connections
.
.
.
.
.
.
.
.
. 232
scmd
wdccli
help
.
.
.
.
.
.
.
.
.
.
.
. 233
scmd
wdccli
list
.
.
.
.
.
.
.
.
.
.
.
. 234
scmd
wdccli
listSettings
.
.
.
.
.
.
.
.
.
. 235
scmd
wdccli
setConRetries
.
.
.
.
.
.
.
.
. 236
scmd
wdccli
setConWait
.
.
.
.
.
.
.
.
.
. 237
scmd
wdccli
setETLPoll
.
.
.
.
.
.
.
.
.
. 238
scmd
wdccli
setLogStartEnd
.
.
.
.
.
.
.
. 239
Chapter
16.
Non-CLI
Service
Utilities
241
cliutil
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 242
diagutil
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 243
dsutil
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 245
logutil
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 248
rcomutil
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 251
slmbackup
.
.
.
.
.
.
.
.
.
.
.
.
.
. 253
slmenv
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 256
slmrestore
.
.
.
.
.
.
.
.
.
.
.
.
.
. 257
slmrestorerestart
.
.
.
.
.
.
.
.
.
.
.
. 260
userdump
.
.
.
.
.
.
.
.
.
.
.
.
.
. 262
verutil
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 263
iv
IBM
Tivoli
Service
Level
Advisor:
Command
Reference
-
viewer
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 265
wasutil
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 270
Appendix.
Notices
.
.
.
.
.
.
.
.
. 275
Trademarks
.
.
.
.
.
.
.
.
.
.
.
.
.
. 277
Index
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 279
Contents
v
-
vi
IBM
Tivoli
Service
Level
Advisor:
Command
Reference
-
Preface
The
Command
Reference
for
IBM®
Tivoli®
Service
Level
Advisor
provides
details
on
all
of
the
command
line
interface
(CLI)
commands
available
to
you
with
IBM
Tivoli
Service
Level
Advisor.
Who
should
read
this
guide
This
document
is
written
for
systems
administrators
and
Tivoli
Professional
Services
personnel
who
need
to
perform
various
tasks
using
the
command
line
interface
of
IBM
Tivoli
Service
Level
Advisor.
You
should
be
familiar
with
the
basic
operation
of
IBM
Tivoli
Service
Level
Advisor
and
its
individual
components.
Publications
This
section
lists
publications
in
the
IBM
Tivoli
Service
Level
Advisor
library
and
other
related
documents.
It
also
describes
how
to
access
Tivoli
publications
online,
and
how
to
order
Tivoli
publications.
IBM
Tivoli
Service
Level
Advisor
library
Product
information
for
using
IBM
Tivoli
Service
Level
Advisor
is
found
in
the
/tsladocs
directory
on
the
IBM
Tivoli
Service
Level
Advisor
Documentation
CD,
in
PDF
and
HTML
formats.
Inserting
the
Documentation
CD
into
a
machine
using
the
Windows®
operating
system
automatically
launches
the
Tivoli
Software
Information
Center,
from
which
you
can
access
any
of
the
available
documentation
in
softcopy
form.
The
following
documents
are
available
in
the
IBM
Tivoli
Service
Level
Advisor
library:
v
A
″Read
Me
First″
document
that
provides
a
starting
point
to
help
you
become
oriented
with
the
set
of
IBM
products
that
support
the
overall
SLM
solution,
and
some
quick
instructions
on
what
documentation
to
refer
to
as
you
begin
your
installation
of
IBM
Tivoli
Service
Level
Advisor
and
its
supporting
applications.
v
Release
Notes,
SC09-7777
This
document
provides
late-breaking
information,
such
as
problems
and
workarounds,
and
patch
availability.
v
Getting
Started,
SC32-0834
This
document
introduces
you
to
IBM
Tivoli
Service
Level
Advisor
and
provides
information
about
planning,
installing,
and
configuring
IBM
Tivoli
Service
Level
Advisor
to
run
in
your
Tivoli
enterprise
environment.
v
Managing
Service
Level
Agreements,
SC32-1247
This
document
provides
information
about
creating
and
managing
schedules,
offerings,
customers,
and
realms,
and
associating
these
elements
with
selected
resources
in
your
enterprise
environment
to
develop
service
level
agreements
(SLAs)
between
your
organization
and
customers
who
depend
on
your
enterprise
for
agreed
upon
levels
of
service.
This
document
is
designed
to
be
used
by
administrators,
service
offering
specialists,
and
service
level
agreement
specialists
who
are
responsible
for
creating
and
managing
SLAs.
v
SLM
Reports,
SC32-1248
©
Copyright
IBM
Corp.
2002,
2004
vii
-
This
document
provides
information
about
generating
and
viewing
Web-based
SLM
reports
for
IBM
Tivoli
Service
Level
Advisor,
based
on
the
evaluation
and
trend
analysis
results
of
the
data
that
is
extracted
from
the
Tivoli
Data
Warehouse
database.
Additional
information
is
provided
so
that
you
or
your
customer
can
integrate
SLM
reports
into
the
customer
Web
site,
including
examples
of
how
you
can
customize
various
display
features.
v
Administrator’s
Guide,
SC32-0835
This
document
provides
information
about
the
administrative
tasks
you
can
perform
using
IBM
Tivoli
Service
Level
Advisor
to
configure
your
SLM
environment,
and
perform
various
administrative
functions
that
support
IBM
Tivoli
Service
Level
Advisor,
such
as
backup
and
restore
operations,
and
user
definition
and
authorization.
v
Command
Reference,
SC32-0833
This
document
provides
information
on
command
line
interface
(CLI)
commands
available
for
displaying
certain
conditions
and
states
inside
IBM
Tivoli
Service
Level
Advisor,
and
for
performing
various
configuration
tasks
using
the
scmd
command.
Additional
utilities
that
provide
other
specific
functions
are
also
described.
v
Messages,
SC32-1250
This
document
provides
information
on
messages
that
might
be
displayed
while
using
the
IBM
Tivoli
Service
Level
Advisor
product.
It
provides
additional
explanations
for
messages
and
instructions
on
what
to
do
to
recover
from
errors.
v
Troubleshooting,
SC32-1249
This
document
provides
information
on
resolving
problems
that
you
might
encounter
during
installation
and
configuration,
as
well
as
resolving
administrative
problems
that
might
arise
during
typical
operation
of
the
product.
Information
about
message
and
trace
logging
is
also
provided.
v
Online
user
assistance
for
IBM
Tivoli
Service
Level
Advisor
The
online
user
assistance
provides
integrated
online
help
topics
for
all
IBM
Tivoli
Service
Level
Advisor
administrative
tasks
that
are
performed
using
the
SLM
Administration
Console.
Online
user
assistance
is
displayed
in
the
Task
Assistant
portion
of
the
SLM
Administration
Console.
Specific
information
about
performing
IBM
Tivoli
Service
Level
Advisor
tasks
is
documented
only
in
this
online
user
assistance.
When
new
products
are
installed
that
run
in
the
SLM
Administration
Console,
corresponding
online
help
topics
are
also
installed
and
integrated
into
the
existing
information
base.
In
addition,
refer
to
the
following
IBM
Tivoli
Service
Level
Advisor
Web
site
for
support
information
and
software
updates
on
IBM
Tivoli
Service
Level
Advisor
and
supported
warehouse
packs
and
downloadable
interim
fix
software:
http://www.ibm.com/software/sysmgmt/products/support
/IBMTivoliServiceLevelAdvisor.html
IBM
DB2
Universal
Database
Enterprise
Edition
library
The
publications
required
to
support
IBM
DB2®
Universal
Database™
Enterprise
Edition
are
available
on
the
IBM
DB2
Universal
Database
Enterprise
Edition
CD,
or
from
this
IBM
Web
site:
http://www.ibm.com/software/data/db2/udb
Tivoli
Data
Warehouse
library
IBM
Tivoli
Service
Level
Advisor
requires
Tivoli
Data
Warehouse
to
be
installed
in
your
enterprise,
to
serve
as
the
data
repository
for
Tivoli
performance
and
viii
IBM
Tivoli
Service
Level
Advisor:
Command
Reference
http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliServiceLevelAdvisor.htmlhttp://www.ibm.com/software/sysmgmt/products/support/IBMTivoliServiceLevelAdvisor.htmlhttp://www.ibm.com/software/data/db2/udb
-
availability
monitoring
applications
that
provide
data
for
service
level
management.
See
the
following
documentation
on
the
Tivoli
Data
Warehouse
Documentation
CD
included
with
IBM
Tivoli
Service
Level
Advisor:
v
Installing
and
Configuring
Tivoli
Data
Warehouse
v
Enabling
an
Application
for
Tivoli
Data
Warehouse
v
Tivoli
Data
Warehouse
Release
Notes
Warehouse
Enablement
Packs
Warehouse
enablement
packs
(also
referred
to
as
warehouse
packs)
are
the
interfaces
that
load
and
transform
data
collected
by
source
applications
into
Tivoli
Data
Warehouse,
and
from
Tivoli
Data
Warehouse
to
other
target
applications
that
use
the
data
to
generate
reports
and
perform
analyses.
Refer
to
the
Release
Notes
for
IBM
Tivoli
Service
Level
Advisor
for
the
online
location
of
the
latest
warehouse
pack
information.
IBM
WebSphere
Application
Server
library
IBM
Tivoli
Service
Level
Advisor
uses
IBM
WebSphere®
Application
Server
as
the
basis
for
the
SLM
Administration
Server
and
SLM
Reports
functions.
Getting
Started
provides
introductory
information
on
installing
IBM
WebSphere
Application
Server
and
integrating
it
with
IBM
Tivoli
Service
Level
Advisor.
See
the
official
documentation
provided
on
the
IBM
WebSphere
Application
Server
product
media
included
with
IBM
Tivoli
Service
Level
Advisor
for
additional
information,
and
also
refer
to
the
latest
IBM
WebSphere
Application
Server
product
information
online
at
the
following
Web
site:
http://www.ibm.com/software/webservers/appserv/was/library
SLM
Administration
Console
Information
IBM
Tivoli
Service
Level
Advisor
provides
the
SLM
Administration
Console,
a
Web-based
Administration
Server
graphical
user
interface
(GUI)
that
runs
in
the
IBM
WebSphere
environment,
from
which
you
can
create
and
manage
schedules,
offerings,
customers,
realms,
and
SLAs.
Information
on
the
use
of
the
SLM
Administration
Console
and
tasks
related
to
creating
and
managing
SLAs
are
described
in
detail
in
Managing
Service
Level
Agreements.
User
assistance
for
the
SLM
Administration
Console
is
available
in
the
Task
Assistant
online
help
function.
Related
publications
The
following
documents
also
provide
useful
information:
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
Access
the
glossary
by
clicking
the
Glossary
link
on
the
left
pane
of
the
Tivoli
software
library
window.
Preface
ix
http://www.ibm.com/software/webservers/appserv/was/libraryhttp://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm
-
Accessing
Publications
Online
In
addition
to
the
Documentation
CD
that
is
shipped
with
IBM
Tivoli
Service
Level
Advisor,
you
can
also
access
these
publications
online.
IBM
posts
publications
for
this
and
all
other
Tivoli
products,
as
they
become
available
and
whenever
they
are
updated,
to
the
Tivoli
software
information
center
Web
site.
Access
the
Tivoli
software
information
center
by
first
going
to
the
Tivoli
software
library
at
the
following
Web
address:
http://www.ibm.com/software/tivoli/library
Scroll
down
and
click
the
Product
manuals
link.
In
the
Tivoli
Technical
Product
Documents
Alphabetical
Listing
window,
click
the
IBM
Tivoli
Service
Level
Advisor
link
to
access
the
product
library
at
the
Tivoli
software
information
center.
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:
www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi
You
can
also
order
by
telephone
by
calling
one
of
these
numbers:
v
In
the
United
States:
800-879-2755
v
In
Canada:
800-426-4968
In
other
countries,
see
the
following
Web
site
for
a
list
of
telephone
numbers:
http://www.ibm.com/software/tivoli/order-lit/
Accessibility
Accessibility
features
help
users
with
a
physical
disability,
such
as
restricted
mobility
or
limited
vision,
to
use
software
products
successfully.
With
this
product,
you
can
use
assistive
technologies
to
hear
and
navigate
the
interface.You
can
also
use
the
keyboard
instead
of
the
mouse
to
operate
all
features
of
the
graphical
user
interface.
Tivoli
technical
training
For
Tivoli
technical
training
information,
refer
to
the
following
IBM
Tivoli
Education
Web
site:
www.ibm.com/software/tivoli/education
Contacting
IBM
Software
Support
IBM
Software
Support
provides
assistance
with
product
defects.
Before
contacting
IBM
Software
Support,
your
company
must
have
an
active
IBM
software
maintenance
contract,
and
you
must
be
authorized
to
submit
problems
to
IBM.
The
type
of
software
maintenance
contract
that
you
need
depends
on
the
type
of
product
you
have:
x
IBM
Tivoli
Service
Level
Advisor:
Command
Reference
http://www.ibm.com/software/tivoli/library/www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://www.ibm.com/software/tivoli/order-lit/http://www.ibm.com/software/tivoli/education
-
v
For
IBM
distributed
software
products
(including,
but
not
limited
to,
Tivoli,
Lotus®,
and
Rational®
products,
as
well
as
DB2
and
WebSphere
products
that
run
on
Windows
or
UNIX®
operating
systems),
enroll
in
Passport
Advantage®
in
one
of
the
following
ways:
–
Online:
Go
to
the
following
Passport
Advantage®
Web
page
and
click
How
to
Enroll:
www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Home
–
By
phone:
For
the
phone
number
to
call
in
your
country,
go
to
the
following
IBM
Software
Support
Web
site
and
click
the
name
of
your
geographic
region:
techsupport.services.ibm.com/guides/contacts.html
v
For
IBM
eServer™
software
products
(including,
but
not
limited
to,
DB2
and
WebSphere
products
that
run
in
zSeries®,
pSeries®,
and
iSeries™
environments),
you
can
purchase
a
software
maintenance
agreement
by
working
directly
with
an
IBM
sales
representative
or
an
IBM
Business
Partner.
For
more
information
about
support
for
eServer
software
products,
go
to
the
IBM
Technical
Support
Advantage
Web
page:
www.ibm.com/servers/eserver/techsupport.html
If
you
are
not
sure
what
type
of
software
maintenance
contract
you
need,
call
1-800-IBMSERV
(1-800-426-7378)
in
the
United
States
or,
from
other
countries,
go
to
the
contacts
page
of
the
following
IBM
Software
Support
Handbook
on
the
Web
and
click
the
name
of
your
geographic
region
for
phone
numbers
of
people
who
provide
support
for
your
location:
techsupport.services.ibm.com/guides/contacts.html
Follow
the
steps
in
this
topic
to
contact
IBM
Software
Support:
1.
Determine
the
business
impact
of
your
problem.
2.
Describe
your
problem
and
gather
background
information.
3.
Submit
your
problem
to
IBM
Software
Support.
Determine
the
business
impact
of
your
problem
When
you
report
a
problem
to
IBM,
you
are
asked
to
supply
a
severity
level.
Therefore,
you
need
to
understand
and
assess
the
business
impact
of
the
problem
you
are
reporting.
Use
the
following
criteria
to
decide
on
an
appropriate
severity
level
for
your
problem:
Severity
1
Critical
business
impact:
You
are
unable
to
use
the
program,
resulting
in
a
critical
impact
on
operations.
This
condition
requires
an
immediate
solution.
Severity
2
Significant
business
impact:
The
program
is
usable
but
is
severely
limited.
Severity
3
Some
business
impact:
The
program
is
usable
with
less
significant
features
(not
critical
to
operations)
unavailable.
Severity
4
Minimal
business
impact:
The
problem
causes
little
impact
on
operations,
or
a
reasonable
circumvention
to
the
problem
has
been
implemented.
Describe
your
problem
and
gather
background
information
When
explaining
a
problem
to
IBM,
be
as
specific
as
possible.
Include
all
relevant
background
information
so
that
IBM
Software
Support
specialists
can
help
you
solve
the
problem
efficiently.
To
save
time,
know
the
answers
to
these
questions:
Preface
xi
http://www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Homehttp://techsupport.services.ibm.com/guides/contacts.htmlhttp://www.ibm.com/servers/eserver/techsupport.htmlhttp://techsupport.services.ibm.com/guides/contacts.html
-
v
What
software
versions
were
you
running
when
the
problem
occurred?
v
Do
you
have
logs,
traces,
and
messages
that
are
related
to
the
problem
symptoms?
IBM
Software
Support
is
likely
to
ask
for
this
information.
v
Can
the
problem
be
recreated?
If
so,
what
steps
led
to
the
failure?
v
Have
any
changes
been
made
to
the
system?
(For
example,
hardware,
operating
system,
networking
software,
and
so
on.)
v
Are
you
currently
using
a
workaround
for
this
problem?
If
so,
please
be
prepared
to
explain
it
when
you
report
the
problem.
Submit
your
problem
to
IBM
Software
Support
You
can
submit
your
problem
in
one
of
two
ways:
v
Online:
Go
to
the
″Submit
and
track
problems″
page
on
the
IBM
Software
Support
site
(http://www.ibm.com/software/support/probsub.html).
Enter
your
information
into
the
appropriate
problem
submission
tool.
v
Do
you
have
logs,
traces,
and
messages
that
are
related
to
the
problem
symptoms?
IBM
Software
Support
is
likely
to
ask
for
this
information.
v
Can
the
problem
be
recreated?
If
so,
what
steps
led
to
the
failure?
v
Have
any
changes
been
made
to
the
system?
(For
example,
hardware,
operating
system,
networking
software,
and
so
on.)
v
Are
you
currently
using
a
workaround
for
this
problem?
If
so,
please
be
prepared
to
explain
it
when
you
report
the
problem.
If
the
problem
you
submit
is
for
a
software
defect
or
for
missing
or
inaccurate
documentation,
IBM
Software
Support
creates
an
Authorized
Program
Analysis
Report
(APAR).
The
APAR
describes
the
problem
in
detail.
Whenever
possible,
IBM
Software
Support
provides
a
workaround
for
you
to
implement
until
the
APAR
is
resolved
and
a
fix
is
delivered.
IBM
publishes
resolved
APARs
on
the
IBM
product
support
Web
pages
daily,
so
that
other
users
who
experience
the
same
problem
can
benefit
from
the
same
resolutions.
For
more
information
about
problem
resolution,
see
“Searching
knowledge
bases”
and
“Obtaining
fixes”
on
page
xiii.
Searching
knowledge
bases
If
you
have
a
problem
with
your
IBM
software,
you
want
it
resolved
quickly.
Begin
by
searching
the
available
knowledge
bases
to
determine
whether
the
resolution
to
your
problem
is
already
documented.
Search
the
information
center
on
your
local
system
or
network
IBM
provides
extensive
documentation
that
can
be
installed
on
your
local
machine
or
on
an
intranet
server.
You
can
use
the
search
function
of
this
information
center
to
query
conceptual
information,
instructions
for
completing
tasks,
reference
information,
and
support
documents.
Tip:
Update
your
information
center
with
the
latest
support
information.
Search
the
Internet
If
you
cannot
find
an
answer
to
your
question
in
the
information
center,
search
the
Internet
for
the
latest,
most
complete
information
that
might
help
you
resolve
your
problem.
To
search
multiple
Internet
resources
for
your
product,
expand
the
product
folder
in
the
navigation
frame
to
the
left
and
select
Support
on
the
Web.
From
this
topic,
you
can
search
a
variety
of
resources
including:
v
IBM
technotes
xii
IBM
Tivoli
Service
Level
Advisor:
Command
Reference
http://www.ibm.com/software/support/probsub.html
-
v
IBM
downloads
v
IBM
Redbooks™
v
IBM
DeveloperWorks
v
Forums
and
newsgroups
v
Google
Obtaining
fixes
A
product
fix
might
be
available
to
resolve
your
problem.
You
can
determine
what
fixes
are
available
for
your
IBM
software
product
by
checking
the
product
support
Web
site:
1.
Go
to
the
IBM
Software
Support
Web
site
(http://www.ibm.com/software/support).
2.
Under
Products
A
-
Z,
select
your
product
name.
This
opens
a
product-specific
support
site.
3.
Under
Self
help,
follow
the
link
to
All
Updates,
where
you
find
a
list
of
fixes,
fix
packs,
and
other
service
updates
for
your
product.
For
tips
on
refining
your
search,
click
Search
tips.
4.
Click
the
name
of
a
fix
to
read
the
description
and
optionally
download
the
fix.
To
receive
weekly
e-mail
notifications
about
fixes
and
other
news
about
IBM
products,
follow
these
steps:
1.
From
the
support
page
for
any
IBM
product,
click
My
support
in
the
upper-right
corner
of
the
page.
2.
If
you
have
already
registered,
skip
to
the
next
step.
If
you
have
not
registered,
click
register
in
the
upper-right
corner
of
the
support
page
to
establish
your
user
ID
and
password.
3.
Sign
in
to
My
support.
4.
On
the
My
support
page,
click
Edit
profiles
in
the
left
navigation
pane,
and
scroll
to
Select
Mail
Preferences.
Select
a
product
family
and
select
the
appropriate
boxes
for
the
type
of
information
you
want.
5.
Click
Submit.
6.
For
e-mail
notification
for
other
products,
repeat
Steps
4
and
5.
For
more
information
about
types
of
fixes,
see
the
Software
Support
Handbook
(http://techsupport.services.ibm.com/guides/handbook.html).
Updating
support
information
Information
centers
typically
include
one
or
more
support
information
plug-ins.
These
plug-ins
add
IBM
technotes
and
other
support
documents
to
the
information
center.
The
following
steps
describe
how
to
update
your
support
information
plug-ins:
1.
Go
to
the
IBM
Software
Support
Web
site
(www.ibm.com/software/support).
2.
Under
Products
A
-
Z,
select
your
product
name.
This
opens
a
product-specific
support
site.
3.
Under
Search
support
for
this
product,
type
the
keyword
phrase:
com.ibm.support.
Select
the
Download
check
box,
and
click
Submit.
4.
Check
the
search
results
for
updates
to
support
information
plug-ins.
All
support
information
plug-ins
follow
the
naming
convention,
″com.ibm.support.product.doc.″
If
an
update
is
available,
select
it
from
the
list
and
view
the
download
instructions.
5.
Save
the
attached
zip
file
to
a
temporary
location
on
your
hard
drive.
Preface
xiii
http://www.ibm.com/software/supporthttp://techsupport.services.ibm.com/guides/handbook.htmlhttp://www.ibm.com/software/support
-
6.
Unzip
the
downloaded
file,
making
sure
that
you
retain
the
subfolders.
7.
From
the
location
where
you
unzipped
the
file,
copy
the
support
information
plug-in
folder
to
your
Eclipse
plug-ins
folder.
For
example,
if
your
IBM
software
product
is
installed
at
c:\IBM\WebSphere\,
copy
the
updated
plug-in
folder
(com.ibm.support.product.doc)
to
c:\IBM\WebSphere\eclipse\plugins.
8.
To
see
the
updated
support
information,
start
the
information
center
(or
shut
it
down
and
restart
it),
and
expand
the
Support
information
node
in
the
navigation
tree.
Participating
in
newsgroups
User
groups
provide
software
professionals
with
a
forum
for
communicating
ideas,
technical
expertise,
and
experiences
related
to
the
product.
They
are
located
on
the
Internet,
and
are
available
using
standard
news
reader
programs.
These
groups
are
primarily
intended
for
user-to-user
communication,
and
are
not
a
replacement
for
formal
support.
If
you
use
Mozilla
as
your
browser,
complete
the
following
instructions
to
access
a
newsgroup:
1.
Open
a
Mozilla
browser
window.
2.
From
the
Edit
menu,
click
Preferences.
The
Preferences
window
is
displayed.
3.
In
the
Category
view,
click
Mail
&
Newsgroups
to
display
the
Mail
&
Newsgroups
settings.
4.
Select
the
Use
Mozilla
mail
as
the
default
mail
application
check
box.
5.
Click
OK.
6.
Close
your
Mozilla
browser
and
then
open
it
again.
7.
Cut
and
paste
the
newsgroup
address
of
a
product
into
the
browser
Address
field,
and
press
Enter
to
open
the
newsgroup.
If
you
use
Microsoft®
Internet
Explorer
as
your
browser,
complete
the
following
instructions
to
access
a
newsgroup:
1.
Open
an
Internet
Explorer
browser.
2.
From
the
Tools
menu,
click
Internet
Options.
3.
On
the
Internet
Options
window,
click
the
Programs
tab.
4.
In
the
Newsgroups
list,
click
the
Down
Arrow
and
then
click
Outlook
Express.
5.
Click
OK.
6.
Close
your
Internet
Explorer
browser
and
then
open
it
again.
7.
Cut
and
paste
the
newsgroup
address
of
a
product
into
the
browser
Address
field,
and
press
Enter
to
open
the
newsgroup.
You
can
find
information
on
Tivoli
Data
Warehouse
by
accessing
the
following
newsgroup:
news://news.software.ibm.com/ibm.software.tivoli.enterprise-data-warehouse
You
can
find
information
on
IBM
Tivoli
Service
Level
Advisor
by
accessing
the
following
newsgroup:
news://news.software.ibm.com/ibm.software.tivoli.service-level-advisor
You
can
find
information
on
IBM
DB2
by
accessing
the
following
newsgroup:
news://news.software.ibm.com/ibm.software.db2
xiv
IBM
Tivoli
Service
Level
Advisor:
Command
Reference
news://news.software.ibm.com/ibm.software.tivoli.enterprise-data-warehousenews://news.software.ibm.com/ibm.software.tivoli.service-level-advisornews://news.software.ibm.com/ibm.software.db2
-
You
can
find
information
on
IBM
WebSphere
Application
Server
by
accessing
the
following
newsgroup:
news://news.software.ibm.com/ibm.software.websphere.application-server
Conventions
used
in
this
guide
This
guide
uses
several
conventions
for
special
terms
and
actions,
operating
system-dependent
commands
and
paths,
and
margin
graphics.
Typeface
conventions
This
guide
uses
the
following
typeface
conventions:
Bold
v
Lowercase
commands
and
mixed
case
commands
that
are
otherwise
difficult
to
distinguish
from
surrounding
text
v
Interface
controls
(check
boxes,
push
buttons,
radio
buttons,
spin
buttons,
fields,
folders,
icons,
list
boxes,
items
inside
list
boxes,
multicolumn
lists,
containers,
menu
choices,
menu
names,
tabs,
property
sheets),
labels
(such
as
Tip:,
and
Operating
system
considerations:)
v
Keywords
and
parameters
in
text
Italic
v
Citations
(titles
of
books,
diskettes,
and
CDs)
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
This
guide
uses
the
UNIX
convention
for
specifying
environment
variables
and
for
directory
notation.
When
using
the
Windows
command
line,
replace
$variable
with
%
variable%
for
environment
variables
and
replace
each
forward
slash
(/)
with
a
backslash
(
\)
in
directory
paths.
The
names
of
environment
variables
are
not
always
the
same
in
Windows
and
UNIX.
For
example,
%TEMP%
in
Windows
is
equivalent
to
$tmp
in
UNIX.
Note:
If
you
are
using
the
bash
shell
on
a
Windows
system,
you
can
use
the
UNIX
conventions.
Preface
xv
news://news.software.ibm.com/ibm.software.websphere.application-server
-
xvi
IBM
Tivoli
Service
Level
Advisor:
Command
Reference
-
Chapter
1.
Command
Line
Interface
Overview
IBM
Tivoli
Service
Level
Advisor
provides
a
Command
Line
Interface
(CLI)
used
to
communicate
with
the
SLM
Server,
SLM
Administration
Server,
and
the
SLM
Reports
options
of
IBM
Tivoli
Service
Level
Advisor.
An
extensive
set
of
CLI
commands
are
provided
with
IBM
Tivoli
Service
Level
Advisor
to
obtain
information
about
the
service
level
management
(SLM)
environment,
and
to
initiate
actions
through
the
SLM
Server,
SLM
Administration
Server,
and
SLM
Reports.
CLI
commands
are
logically
divided
into
the
following
two
areas:
v
Administrative
commands
v
Error
recovery
and
additional
information
commands
The
administrative
commands
are
typically
used
in
daily
operations,
and
help
the
IBM
Tivoli
Service
Level
Advisor
administrator
monitor
and
configure
the
product.
The
error
recovery
and
additional
information
commands
provide
more
function
for
use
in
problem
determination
and
error
recovery
situations.
Error
recovery
commands
should
be
used
with
caution,
because
some
commands
might
alter
the
state
of
the
system.
The
complete
description
of
each
command
and
its
intended
purpose
should
be
understood
before
issuing
error
recovery
commands.
Tivoli
support
might
need
to
be
consulted
before
attempting
to
use
an
error
recovery
command.
See
the
Administrator’s
Guide
for
additional
information
on
the
intended
use
of
some
of
these
commands.
CLI
commands
interact
with
IBM
Tivoli
Service
Level
Advisor
by
either
communicating
through
the
CLI
Service,
or,
in
the
case
of
non-CLI
Service
commands,
directly
with
the
SLM
Server,
SLM
Reports,
and
SLM
Administrative
Console.
CLI
Service
Commands
The
CLI
service
is
started
as
part
of
the
SLM
Server
startup,
and
is
available
while
the
SLM
Server
is
active.
The
CLI
scmd
commands
are
specific
to
the
CLI
service
and
only
available
on
the
SLM
Server.
The
format
of
the
CLI
scmd
is
as
follows:
scmd
[–p
]
[]
[]
The
parts
of
the
command
are
defined
as
follows:
–p
Specifies
the
–p
option
which
passes
along
the
current
password
that
must
be
supplied
if
password
protection
is
enabled.
See
“Password
Protection”
on
page
6
for
more
information.
is
a
means
of
grouping
similar
scmd
commands
that
are
used
with
a
particular
function
of
IBM
Tivoli
Service
Level
Advisor.
See
Table
2
on
page
8
for
a
list
of
available
bundle
names.
In
the
case
of
the
basic
CLI
Service
commands
such
as
list,
help,
setPassword
and
setPasswordEnabled,
bundle
names
are
not
used.
See
“Using
the
CLI
Service”
on
page
6
for
more
information.
©
Copyright
IBM
Corp.
2002,
2004
1
-
Specifies
the
particular
action
to
be
taken.
Methods
are
typically
grouped
into
bundles
and
some
may
pass
along
one
or
more
options
and
associated
arguments.
Specifies
one
or
more
additional
options
and
associated
arguments
along
with
the
specified
method.
For
example,
an
scmd
command
in
the
sdc
bundle
that
uses
the
readAllCustomers
method
to
display
the
names
of
all
customers
would
be
issued
as
follows:
scmd
sdc
readAllCustomers
Another
example
is
an
scmd
in
the
log
bundle
that
uses
the
trace
method
with
an
option
of
list
to
determine
what
trace
loggers
are
available.
This
command
would
be
issued
as
follows:
scmd
log
trace
-list
Table
1
describes
the
command
syntax
in
more
detail.
Table
1.
Syntax
description
for
CLI
Service
commands
Syntax
Description
Example
Brackets
(
[
]
)
The
information
enclosed
in
brackets
(
[
]
)
is
optional.
Anything
not
enclosed
in
brackets
must
be
specified.
[–p
]
Braces
(
{
}
)
Braces
(
{
}
)
identify
a
set
of
mutually
exclusive
options,
when
one
option
is
required.
{
true
|
false}
Pipe
(
|
)
Mutually
exclusive
options
are
separated
by
a
pipe
(
|
).You
can
enter
one
of
the
options
separated
by
the
pipe,
but
you
cannot
enter
multiple
options
in
a
single
use
of
the
command.A
pipe
can
be
used
to
separate
optional
or
required
options.
{true
|
false}
Left/Right
arrow
brackets
(
<
>
)
Text
enclosed
in
<
>
represent
variables
that
must
be
replaced
by
whatever
it
represents.
In
the
example,
replace
with
the
name
of
the
specific
file.
2
IBM
Tivoli
Service
Level
Advisor:
Command
Reference
-
Table
1.
Syntax
description
for
CLI
Service
commands
(continued)
Syntax
Description
Example
Ellipsis
(
...
)
An
ellipsis
(...)
indicates
that
the
previous
option
can
be
repeated
multiple
times
with
different
values.
1.
[–x
]...
Ellipsis
outside
brackets
indicates
that
–x
is
optional
and
may
be
repeated
as
follows:
–x
–x
–x
2.
[–x
...]
Ellipsis
inside
brackets
indicates
–x
is
optional,
and
the
file
variable
can
be
repeated
as
follows:
–x
<
file3>
3.
–x
[–x
]...
Indicates
that
you
must
specify
–x
at
least
once.
Special
Characters
Certain
special
characters
that
are
passed
as
parts
of
parameters,
such
as
%,
&,
!,
[,
],
:,
+,
or
blank
spaces
must
be
surrounded
by
double
quotes
to
be
passed
correctly.
For
example,
you
might
choose
to
create
a
customer
name
such
as
Omni
Bank
This
customer
name
has
a
blank
space
included
in
the
name,
so
it
must
be
specified
in
the
CLI
command
surrounded
with
double
quotes,
such
as
the
following
example:
scmd
sdc
createCustomer
-name
"Omni
Bank"
-realmList
America
Some
characters
have
a
special
meaning
to
the
DOS
command
processor
that
handles
these
commands
before
they
are
processed
by
the
CLI
command
processor.
Surrounding
these
special
characters
in
double
quotes
tells
DOS
that
they
are
to
be
passed
in
as
part
of
the
parameter
and
not
take
special
action
on
them.
Caution
When
Using
Backslash
(\)
Characters
If
you
use
a
backslash
(\)
character
as
the
last
character
of
a
parameter
passed
to
an
scmd
command,
you
must
specify
it
as
\\
(use
two
backslash
characters)
in
the
string.
For
example,
the
following
command
attempts
to
create
a
customer
with
a
name
ending
in
a
backslash
character:
scmd
sdc
createCustomer
-name
"ABC\"
-realmList
XYZ
This
command
fails
with
a
parsing
error
because
the
-realmList
parameter
is
not
recognized.
The
command
is
not
processed
correctly
due
to
the
ending
backslash
in
the
customer
name
ABC\.
To
correct
this,
the
customer
name
must
be
specified
with
two
backslash
characters:
scmd
sdc
createCustomer
-name
"ABC\\"
-realmList
XYZ
This
command
is
processed
correctly,
and
the
customer
named
ABC\
is
created.
Chapter
1.
Command
Line
Interface
Overview
3
-
Caution
When
Using
Quotation
Marks
When
using
quotation
marks
to
surround
parameters
in
scmd
command
strings,
if
the
string
contains
any
unmatched
quotation
characters,
the
resulting
parameters
passed
to
the
scmd
command
processor
might
be
handled
incorrectly.
In
the
following
example,
the
command
is
issued
to
create
a
new
customer
named
″John
Smith,″
but
the
leading
quotation
mark
does
not
have
a
matching
trailing
quotation
mark:
scmd
sdc
createcustomer
-realmlist
aa
-name
"John
Smith
-desc
Executive
As
a
result,
a
customer
named
John
Smith
-desc
Executive
is
created,
and
the
-desc
parameter
is
ignored.
Be
sure
to
include
matching
quotation
marks
around
your
parameters.
CLI
Service
Connections
CLI
Service
commands
operate
in
real
time
on
the
SLM
Server,
requiring
the
SLM
Server
to
be
running
for
proper
communication.
If
a
connection
to
the
CLI
Service
cannot
be
obtained,
the
following
error
is
displayed:
DYKAL2030E
Unable
to
Connect
to
the
CLI
Service
on
port
Additional
information
on
configuring,
troubleshooting,
and
general
use
of
the
CLI
Service
is
available
elsewhere
in
this
document
and
in
the
Administrator’s
Guide
and
Getting
Started.
Return
Codes
If
you
execute
CLI
commands
from
a
batchfile
or
shell
script,
the
CLI
service
provides
a
return
code
to
indicate
success
or
failure
of
the
scmd
invocation.
The
return
codes
are
as
follows:
v
ICLIBundle.RETURN_SUCCESS
=
0
v
ICLIBundle.RETURN_FAILURE
=
1
You
might
find
these
return
codes
useful
if
you
write
scripts
to
issue
various
scmd
commands,
in
deciding
what
to
do
next
based
on
a
successful
or
failed
invocation.
These
return
codes
are
not
displayed
when
you
issue
CLI
commands
from
a
screen
command
prompt.
Non-CLI
Service
Commands
Commands
that
are
not
performed
using
the
CLI
Service
(that
is,
that
are
not
issued
as
scmd
commands)
are
available
regardless
of
whether
or
not
the
IBM
Tivoli
Service
Level
Advisor
servers
are
running,
but
they
require
the
respective
server
to
be
started
for
their
actions
to
take
effect.
Consult
the
command
descriptions
in
this
document
for
information
on
which
commands
are
available
on
each
server,
and
their
intended
usage.
Using
the
Command
Line
Interface
Before
using
the
command
line
interface,
you
must
initialize
the
IBM
Tivoli
Service
Level
Advisor
command
line
environment.
This
is
accomplished
by
navigating
to
the
directory,
where
one
or
more
IBM
Tivoli
Service
Level
Advisor
installation
options
were
installed
on
the
local
machine,
and
issuing
the
following
command
at
a
command
prompt:
v
For
Windows:
4
IBM
Tivoli
Service
Level
A