publib.boulder.ibm.compublib.boulder.ibm.com/tividd/td/TSLA/SC32-0833-02/en_US/... · 2005-04-01 · scmd sdc displayAllCustomers ........96 scmd sdc displayAllRealms .........97

IBM Tivoli Service Level Advisor

Command Reference for IBM TivoliService Level AdvisorVersion 1.2.1

SC32-0833-02

��

IBM Tivoli Service Level Advisor

Command Reference for IBM TivoliService Level AdvisorVersion 1.2.1

SC32-0833-02

��

Third Edition (April 2003)

©This edition applies to Version 1.2.1 of IBM Tivoli Service Level Advisor (product number 5724–C40) and to allsubsequent releases and modifications until otherwise indicated in new editions.

© Copyright International Business Machines Corporation 2003. All rights reserved.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Preface . . . . . . . . . . . . . . . vWho should read this guide . . . . . . . . . vPublications . . . . . . . . . . . . . . v

IBM Tivoli Service Level Advisor library . . . . vIBM DB2 Universal Database Enterprise Editionlibrary . . . . . . . . . . . . . . . viTivoli Enterprise Data Warehouse library . . . viWarehouse Packs . . . . . . . . . . . viIBM Console Information . . . . . . . . . viIBM WebSphere Application Server library . . . viRelated publications . . . . . . . . . . vii

Accessing Publications Online . . . . . . . . viiOrdering publications . . . . . . . . . . . viiAccessibility . . . . . . . . . . . . . . viiContacting software support . . . . . . . . viiiParticipating in newsgroups . . . . . . . . viiiConventions used in this guide . . . . . . . . ix

Typeface conventions . . . . . . . . . . ixOperating system-dependent variables and paths ix

Chapter 1. Command Line InterfaceOverview . . . . . . . . . . . . . . 1CLI Service Commands. . . . . . . . . . . 1

CLI Service Connections . . . . . . . . . 3Non-CLI Service Commands . . . . . . . . . 3Using the Command Line Interface . . . . . . . 3List and Help Methods . . . . . . . . . . . 4Using the CLI Service . . . . . . . . . . . 4

Password Protection . . . . . . . . . . . 5Additional CLI Service Commands . . . . . . 5

Chapter 2. CLI Service Commands . . . 9scmd help . . . . . . . . . . . . . . . 10scmd list . . . . . . . . . . . . . . . 13scmd setPassword . . . . . . . . . . . . 14scmd setPasswordEnabled . . . . . . . . . 16

Chapter 3. Escalation Commands . . . 19scmd escalate checkCache . . . . . . . . . 20scmd escalate customize . . . . . . . . . . 21scmd escalate disable . . . . . . . . . . . 25scmd escalate enable . . . . . . . . . . . 26scmd escalate flush . . . . . . . . . . . . 28scmd escalate help . . . . . . . . . . . . 29scmd escalate list . . . . . . . . . . . . 30scmd escalate setCacheSize . . . . . . . . . 31scmd escalate snmp FormatDateTime . . . . . . 32scmd escalate test . . . . . . . . . . . . 33scmd escalate view . . . . . . . . . . . . 34

Chapter 4. Extract, Transform, andLoad Process Commands . . . . . . 35scmd etl addApplicationData . . . . . . . . 36scmd etl disable . . . . . . . . . . . . . 37

scmd etl enable . . . . . . . . . . . . . 39scmd etl getApps . . . . . . . . . . . . 40scmd etl getDataExpiration . . . . . . . . . 41scmd etl getDMVersion . . . . . . . . . . 42scmd etl getMMVersion . . . . . . . . . . 43scmd etl help . . . . . . . . . . . . . . 44scmd etl list . . . . . . . . . . . . . . 45scmd etl setDataExpiration . . . . . . . . . 46

Chapter 5. Logging and TracingCommands . . . . . . . . . . . . . 47scmd log filter . . . . . . . . . . . . . 48scmd log handler . . . . . . . . . . . . 50scmd log help . . . . . . . . . . . . . 52scmd log list . . . . . . . . . . . . . . 53scmd log message . . . . . . . . . . . . 54scmd log trace . . . . . . . . . . . . . 56

Chapter 6. Metric Evaluator ManagerCommands . . . . . . . . . . . . . 59scmd mem flushEvents . . . . . . . . . . 60scmd mem help . . . . . . . . . . . . . 61scmd mem list . . . . . . . . . . . . . 62scmd mem removeStoppedRetryEntries . . . . . 63scmd mem retryMissedIntervals . . . . . . . 65scmd mem showAllOrderIDs . . . . . . . . 67scmd mem showMetricEvaluators . . . . . . . 68scmd mem showRetrys . . . . . . . . . . 70scmd mem trending . . . . . . . . . . . 72

Chapter 7. Order Manager Commands 73scmd om help . . . . . . . . . . . . . 74scmd om list . . . . . . . . . . . . . . 75scmd om redeployCompletedCustomerOrders . . . 76scmd om submitCustomerOrder . . . . . . . 78

Chapter 8. Remote CommunicationCommands . . . . . . . . . . . . . 79scmd rcc getPort. . . . . . . . . . . . . 80scmd rcc help. . . . . . . . . . . . . . 81scmd rcc list . . . . . . . . . . . . . . 82scmd rcc setPort . . . . . . . . . . . . . 83

Chapter 9. Scheduler Commands . . . 85scmd scheduler help . . . . . . . . . . . 86scmd scheduler list . . . . . . . . . . . . 87scmd scheduler listSettings . . . . . . . . . 88scmd scheduler setMaxEvaluationThreads . . . . 89scmd scheduler setMaxTimeForForcedScheduling. . 90

Chapter 10. SLM Database Commands 91scmd sdc adjustIDGenerator . . . . . . . . . 92scmd sdc displayActiveServiceElements . . . . . 93scmd sdc displayAllCustomerOrders . . . . . . 94

© Copyright IBM Corp. 2003 iii

scmd sdc displayAllCustomers . . . . . . . . 96scmd sdc displayAllRealms . . . . . . . . . 97scmd sdc displayAllSchedules . . . . . . . . 98scmd sdc displayAllServiceOfferings . . . . . . 99scmd sdc displayBaseCustomerOrders . . . . . 102scmd sdc displayBusinessSchedules . . . . . . 104scmd sdc displayCustomerByID . . . . . . . 106scmd sdc displayCustomerFromOrderID . . . . 107scmd sdc displayCustomerOrderByID . . . . . 108scmd sdc displayCustomerOrderState . . . . . 109scmd sdc displayDataCollectorType . . . . . . 110scmd sdc displayMilestoneSchedules . . . . . 111scmd sdc displayOfferingElementList . . . . . 112scmd sdc displayOfferingScheduleName . . . . 113scmd sdc displayOfferingState . . . . . . . . 114scmd sdc displayOrderMetricPropertyID . . . . 115scmd sdc displayScheduleByName . . . . . . 116scmd sdc displayServiceOfferingByID . . . . . 117scmd sdc displayServiceOfferingID . . . . . . 119scmd sdc displayServiceOfferingName . . . . . 120scmd sdc displayServiceOfferingsByState . . . . 121scmd sdc getAssociatedCustomerOrderID . . . . 122scmd sdc help . . . . . . . . . . . . . 123scmd sdc list . . . . . . . . . . . . . 124scmd sdc registerWarehouseData . . . . . . . 125

Chapter 11. Web Report UserCommands . . . . . . . . . . . . 127scmd sla addUser . . . . . . . . . . . . 128scmd sla changeUser . . . . . . . . . . . 131scmd sla deleteUser . . . . . . . . . . . 133scmd sla help . . . . . . . . . . . . . 134scmd sla list . . . . . . . . . . . . . . 135scmd sla listUser . . . . . . . . . . . . 136

Chapter 12. Component ManagementCommands . . . . . . . . . . . . 137scmd slm getComponentStatus . . . . . . . 138

scmd slm getStatus . . . . . . . . . . . 139scmd slm help . . . . . . . . . . . . . 141scmd slm list . . . . . . . . . . . . . 142scmd slm listComponents . . . . . . . . . 143scmd slm shutdown . . . . . . . . . . . 144scmd slm startComponent . . . . . . . . . 145scmd slm stopComponent . . . . . . . . . 146

Chapter 13. Warehouse DataCollection Commands . . . . . . . 147scmd wdccli connections . . . . . . . . . 148scmd wdccli help . . . . . . . . . . . . 149scmd wdccli list . . . . . . . . . . . . 150scmd wdccli listSettings . . . . . . . . . . 151scmd wdccli setConRetries . . . . . . . . . 152scmd wdccli setConWait. . . . . . . . . . 153scmd wdccli setETLPoll . . . . . . . . . . 154scmd wdccli setLogStartEnd . . . . . . . . 155

Chapter 14. Non-CLI Service Utilities 157cliutil . . . . . . . . . . . . . . . . 158diagutil . . . . . . . . . . . . . . . 159dsutil . . . . . . . . . . . . . . . . 161logutil . . . . . . . . . . . . . . . . 164rcomutil . . . . . . . . . . . . . . . 165slmbackup . . . . . . . . . . . . . . 167slmenv . . . . . . . . . . . . . . . 170slmrestore . . . . . . . . . . . . . . 171slmrestorerestart . . . . . . . . . . . . 174verutil . . . . . . . . . . . . . . . . 175viewer. . . . . . . . . . . . . . . . 177

Appendix. Notices . . . . . . . . . 183Trademarks . . . . . . . . . . . . . . 185

Index . . . . . . . . . . . . . . . 187

iv IBM Tivoli Service Level Advisor: Command Reference for IBM Tivoli Service Level Advisor

Preface

The Command Reference for IBM® Tivoli® Service Level Advisor provides details on allof the command line interface (CLI) commands available to you with IBM TivoliService Level Advisor.

Who should read this guideThis document is written for systems administrators and Tivoli ProfessionalServices personnel who need to perform various tasks using the command lineinterface of IBM Tivoli Service Level Advisor. You should be familiar with the basicoperation of IBM Tivoli Service Level Advisor and its individual components.

PublicationsThis section lists publications in the IBM Tivoli Service Level Advisor library andany other related documents. It also describes how to access Tivoli publicationsonline, how to order Tivoli publications, and how to submit comments on Tivolipublications.

IBM Tivoli Service Level Advisor libraryProduct information for using IBM Tivoli Service Level Advisor is found in the/tsladocs directory on the IBM Tivoli Service Level Advisor Documentation CD, inPDF and HTML format.

The following documents are available in the IBM Tivoli Service Level Advisorlibrary:v Getting Started with IBM Tivoli Service Level Advisor , SC32-0834

This document introduces you to IBM Tivoli Service Level Advisor and providesinformation about planning, installing, and configuring IBM Tivoli Service LevelAdvisor to run in your Tivoli enterprise environment.

v Administrator’s Guide for IBM Tivoli Service Level Advisor, SC32-0835This document provides information about the administrative tasks you canperform using IBM Tivoli Service Level Advisor to track and manage SLAsbetween your organization and customers who depend on your enterprise foragreed upon levels of service.

v Command Reference for IBM Tivoli Service Level Advisor, SC32-0833This document provides information on command line interface (CLI)commands available for displaying certain conditions and states inside IBMTivoli Service Level Advisor, and for performing various configuration tasksusing the scmd command.

v Messages for IBM Tivoli Service Level Advisor , SC32-1250This document provides information on messages that might be displayed whileusing the IBM Tivoli Service Level Advisor product. It provides additionalexplanations for messages and instructions on what to do to recover from errors.

v IBM Tivoli Service Level Advisor Release Notes, SC09-7777This document provides late-breaking information, such as problems andworkarounds, and patch availability. The most recent version of this file isalways available on the following Web site:

© Copyright IBM Corp. 2003 v

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

Click the Tivoli Service Level Advisor link to display the Tivoli softwareinformation center for this product.

v Online user assistance for IBM Tivoli Service Level AdvisorThe online user assistance provides integrated online help topics for all IBMTivoli Service Level Advisor administrative tasks that are performed using theIBM Console. Online user assistance is displayed in the Task Assistant portion ofthe IBM Console. Specific information about performing IBM Tivoli ServiceLevel Advisor tasks is documented only in this online user assistance. Whennew products are installed that run in the IBM Console, corresponding onlinehelp topics are also installed and integrated into the existing information base.

In addition, refer to the following IBM Tivoli Service Level Advisor Web site forsupport information and software updates on IBM Tivoli Service Level Advisorand supported warehouse packs and downloadable fix software:http://www.ibm.com/software/sysmgmt/products/support

/IBMTivoliServiceLevelAdvisor.html

IBM DB2 Universal Database Enterprise Edition libraryThe publications required to support IBM DB2 are available on the IBM DB2Universal Database Enterprise Edition CD, or from this IBM Web site:http://www.ibm.com/software/data/db2/udb

Tivoli Enterprise Data Warehouse libraryIBM Tivoli Service Level Advisor requires Tivoli Enterprise ™ Data Warehouse tobe installed in your enterprise, to serve as the data repository for Tivoliperformance and availability monitoring applications that provide data for servicelevel management. See the following documentation on the Tivoli Enterprise DataWarehouse Documentation CD included with IBM Tivoli Service Level Advisor:v Installing and Configuring Tivoli Enterprise Data Warehouse

v Enabling an Application for Tivoli Enterprise Data Warehouse

v Tivoli Enterprise Data Warehouse Release Notes

Warehouse PacksWarehouse packs are the interfaces that load and transform data collected bysource applications into Tivoli Enterprise Data Warehouse, and from TivoliEnterprise Data Warehouse to other target applications that use the data togenerate reports and perform analyses. Refer to the IBM Tivoli Service Level AdvisorRelease Notes for the online location of the latest warehouse pack information.

IBM Console InformationIBM Tivoli Service Level Advisor requires Tivoli Presentation Services to beinstalled in your enterprise, for use with the IBM Console, the Web-basedAdministration Server graphical user interface (GUI) portion of IBM Tivoli ServiceLevel Advisor. Information on the IBM Console is available in the Administrator’sGuide for IBM Tivoli Service Level Advisor. User assistance for the IBM Console isavailable online from the IBM Console Task Assistant.

IBM WebSphere Application Server libraryIBM Tivoli Service Level Advisor uses IBM WebSphere Application Server for itsWeb reporting function. See Getting Started with IBM Tivoli Service Level Advisor for

vi IBM Tivoli Service Level Advisor: Command Reference for IBM Tivoli Service Level Advisor

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

http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliServiceLevelAdvisor.html

http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliServiceLevelAdvisor.html

http://www.ibm.com/software/data/db2/udb

information on WebSphere for use with IBM Tivoli Service Level Advisor, and seethe official documentation provided on the WebSphere product CD included withIBM Tivoli Service Level Advisor for additional information. You can also find thelatest WebSphere product information online at the following Web site:http://www.ibm.com/software/webservers/appserv/doc/v40/aes/infocenter

Related publicationsThe following documents also provide useful information:

The Tivoli Software Glossary includes definitions for many of the technical termsrelated 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

Accessing Publications OnlineThe document CD contains the publications that are in the product library. Theformat of the publications is PDF, HTML, or both. To access the publications usinga Web browser, open the infocenter.html file. The file is in the appropriatepublications directory on the Documentation CD.

IBM posts publications for this and all other Tivoli products, as they becomeavailable and whenever they are updated, to the Tivoli Software InformationCenter Web site. The Tivoli Software Information Center is located at the followingWeb address:http://www.ibm.com/software/tivoli/library/

Click the IBM Tivoli Service Level Advisor link to access the product library.

Note: If you print PDF documents on other than letter-sized paper, select the Fit topage check box in the Adobe Acrobat Print dialog. This option is availablewhen you click File ” Print. Fit to page ensures that the full dimensions of aletter-sized page print on the paper that you are using.

Ordering publicationsYou 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-2755v 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/

AccessibilityAccessibility features help users with a physical disability, such as restrictedmobility or limited vision, to use software products successfully. With this product,you can use assistive technologies to hear and navigate the interface.You can alsouse the keyboard instead of the mouse to operate all features of the graphical userinterface.

Preface vii

http://www.ibm.com/software/webservers/appserv/doc/v40/aes/infocenter

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

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

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

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

Contacting software supportIf you have a problem with any Tivoli product, refer to the following IBM SoftwareSupport Web site:http://www.ibm.com/software/sysmgmt/products/support/

If you want to contact software support, see the IBM Software Support Guide at thefollowing 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 eligibilityv Telephone numbers and e-mail addresses, depending on the country in which

you are locatedv Information you must have before contacting IBM Software Support

Participating in newsgroupsUser groups provide software professionals with a forum for communicating ideas,technical expertise, and experiences related to the product. They are located on theInternet, and are available using standard news reader programs. These groups areprimarily intended for user-to-user communication, and are not a replacement forformal support.

To access a newsgroup use the following instructions.

If you use Netscape Navigator as your browser:1. Open a Netscape Navigator browser.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 Netscape mail as the default mail application check box.5. Click OK.6. Close your Netscape Navigator 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: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.

Tivoli Enterprise Data Warehousenews://news.software.ibm.com/ibm.software.tivoli.enterprise-data-warehouse

viii IBM Tivoli Service Level Advisor: Command Reference for IBM Tivoli Service Level Advisor

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

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

news://news.software.ibm.com/ibm.software.tivoli.enterprise-data-warehouse

IBM Tivoli Service Level Advisornews://news.software.ibm.com/ibm.software.tivoli.service-level-advisor

Conventions used in this guideThis guide uses several conventions for special terms and actions, operatingsystem-dependent commands and paths, and margin graphics.

Typeface conventionsThis guide uses the following IBM-style typeface conventions:

Bold

v Lowercase commands and mixed case commands that are otherwisedifficult to distinguish from surrounding text

v Interface controls (check boxes, push buttons, radio buttons, spinbuttons, fields, folders, icons, list boxes, items inside list boxes,multicolumn lists, containers, menu choices, menu names, tabs, propertysheets), labels (such as Tip:, and Operating system considerations:)

v Column headings in a tablev Keywords and parameters in text

Italic

v Citations (titles of books, diskettes, and CDs)v Words defined in textv Emphasis of words (words as words)v Letters as lettersv New terms in text (except in a definition list)v Variables and values you must provide

Monospace

v Examples and code examplesv File names, programming keywords, and other elements that are difficult

to distinguish from surrounding textv Message text and prompts addressed to the userv Text that the user must typev Values for arguments or command options

Operating system-dependent variables and pathsThis guide uses the UNIX convention for specifying environment variables and fordirectory notation.

When using the Windows command line, replace $variable with % variable% forenvironment variables and replace each forward slash (/) with a backslash ( \) indirectory paths.

Note: If you are using the bash shell on a Windows system, you can use the UNIXconventions.

Preface ix

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

x IBM Tivoli Service Level Advisor: Command Reference for IBM Tivoli Service Level Advisor

Chapter 1. Command Line Interface Overview

IBM Tivoli Service Level Advisor provides a Command Line Interface (CLI) usedto communicate with the SLM Server, SLM task drivers, and the SLM Reportsoptions of IBM Tivoli Service Level Advisor. An extensive set of CLI commands areprovided with IBM Tivoli Service Level Advisor to obtain information about theservice level management (SLM) environment, and to initiate actions through theSLM Server, SLM task drivers, and SLM Reports.

CLI commands are logically divided into the following two areas:v Administrative commandsv Error recovery and additional information commands

The administrative commands are typically used in daily operations, and help theIBM Tivoli Service Level Advisor administrator monitor and configure the product.The error recovery and additional information commands provide more functionfor use in problem determination and error recovery situations. Error recoverycommands should be used with caution, because some commands might alter thestate of the system. The complete description of each command and its intendedpurpose should be understood before issuing error recovery commands. Tivolisupport might need to be consulted before attempting to use an error recoverycommand. See the Administrator’s Guide for IBM Tivoli Service Level Advisor foradditional information on the intended use of some of these commands.

CLI commands interact with IBM Tivoli Service Level Advisor by eithercommunicating through the CLI Service, or, in the case of non-CLI Servicecommands, directly with the SLM Server, SLM Reports, and IBM Console (whichincludes the SLM task drivers).

CLI Service CommandsThe CLI service is started as part of the SLM Server startup, and is available whilethe SLM Server is active. The CLI scmd commands are specific to the CLI serviceand only available on the SLM Server. The format of the CLI scmd is as follows:scmd [–p <password>] [<bundle_name>] <method> [<options>]

The parts of the command are defined as follows:

–p <password>Specifies the –p option which passes along the current password that mustbe supplied if password protection is enabled. See “Password Protection”on page 5 for more information.

<bundle_name>is a means of grouping similar scmd commands that are used with aparticular function of IBM Tivoli Service Level Advisor. See Table 2 onpage 6 for a list of available bundle names. In the case of the basic CLIService commands such as list, help, setPassword andsetPasswordEnabled, bundle names are not used. See “Using the CLIService” on page 4 for more information.

© Copyright IBM Corp. 2003 1

<method>Specifies the particular action to be taken. Methods are typically groupedinto bundles and some may pass along one or more options and associatedarguments.

<options>Specifies one or more additional options and associated arguments alongwith the specified method.

For example, an scmd command in the sdc bundle that uses the readAllCustomersmethod 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 anoption of list to determine what trace loggers are available. This command wouldbe 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 inbrackets ( [ ] ) is optional.Anything not enclosed inbrackets must be specified.

[–p <password>]

Braces ( { } ) Braces ( { } ) identify a set ofmutually exclusive options,when one option is required.

{ true | false}

Pipe ( | ) Mutually exclusive optionsare separated by a pipe ( |).You can enter one of theoptions separated by thepipe, but you cannot entermultiple options in a singleuse of the command.A pipecan be used to separateoptional or required options.

{true | false}

Left/Right arrowbrackets ( < > )

Text enclosed in < >represent variables that mustbe replaced by whatever itrepresents. In the example,replace <file_name> with thename of the specific file.

<file_name>

2 IBM Tivoli Service Level Advisor: Command Reference for IBM Tivoli Service Level Advisor

Table 1. Syntax description for CLI Service commands (continued)

Syntax Description Example

Ellipsis ( ... ) An ellipsis (...) indicates thatthe previous option can berepeated multiple times withdifferent values.

1. [–x <file>]...

Ellipsis outside bracketsindicates that –x <file> isoptional and may be repeatedas follows:

–x <file1> –x <file2>

–x <file3>

2. [–x <file>...]

Ellipsis inside bracketsindicates –x <file> is optional,and the file variable can berepeated as follows:

–x <file1> <file2> < file3>3. –x <file> [–x <file>]...

Indicates that you must specify–x<file> at least once.

CLI Service ConnectionsCLI Service commands operate in real time on the SLM Server, requiring the SLMServer to be running for proper communication. If a connection to the CLI Servicecannot be obtained, the following error is displayed:DYKAL2030E Unable to Connect to the CLI Service on port <port_number>

Additional information on configuring, troubleshooting, and general use of the CLIService is available elsewhere in this document and in the Administrator’s Guide forIBM Tivoli Service Level Advisor and Getting Started with IBM Tivoli Service LevelAdvisor.

Non-CLI Service CommandsCommands that are not performed using the CLI Service (that is, that are notissued as scmd commands) are available regardless of whether or not the IBMTivoli Service Level Advisor servers are running, but they require the respectiveserver to be started for their actions to take effect. Consult the commanddescriptions in this document for information on which commands are available oneach server, and their intended usage.

Using the Command Line InterfaceBefore using the command line interface, you must initialize the IBM Tivoli ServiceLevel Advisor command line environment. This is accomplished by navigating tothe <SLM_Install_Dir> directory, where one or more IBM Tivoli Service LevelAdvisor install options were installed on the local machine, and issuing thefollowing command:v For Windows:

slmenv

v For UNIX:. ./slmenv

Chapter 1. Command Line Interface Overview 3

After the command line environment has been set up correctly, CLI commandsmay be issued from any location within the current shell by typing the commandname followed by any required parameters.

Note: The slmrestore command can only be issued from the /tools/restoredirectory on the IBM Tivoli Service Level Advisor product CD. See thedescription for the slmrestore utility in Chapter 14, “Non-CLI ServiceUtilities”, on page 157 for further details.

List and Help MethodsTo assist you in using CLI commands, each CLI Service scmd bundle and eachnon-CLI Service command provides two additional methods:

List Returns a list of acceptable arguments and basic command usage. Forexample, to list the available commands and options for the sdc bundle,you would issue the command:scmd sdc list

Help Returns detailed information on the meanings or possible values of thecommand arguments. For example, to display the command syntax,variables, options, and examples for the etl bundle, you would issue thefollowing command:scmd etl help

Both methods can be used as arguments with all non-CLI Service commands as inthe following generic commands:v For the CLI Service:

scmd list

scmd help

scmd <bundlename> list

scmd <bundlename> help

v For Non-CLI Service Commands:<command_name> list

<command_name> help

Using the CLI ServiceThe CLI service provides a library of commands used to interface with componentsof IBM Tivoli Service Level Advisor, including the CLI Service itself. A set of fourbasic commands used to configure the CLI Service and to obtain information onthe additional commands offered by the CLI Service, are as follows:v scmd helpv scmd listv scmd setPasswordv scmd setPasswordEnabled

These commands are separate from the rest of the scmd commands, and do notinclude a bundle name. These commands are described in more detail inChapter 2, “CLI Service Commands”, on page 9.


Password ProtectionPassword protection is an optional feature of the CLI Service. By default, passwordprotection is disabled. The methods setPassword and setPasswordEnabled enableyou to define and change the current password and turn on and off passwordprotection as desired. When password protection is enabled, all commands withthe exception of scmd help require the current password to be specified for thecommand to be successfully issued.

For example, with password protection disabled, you can issue the followingcommand to display all configured parameters for event escalation:scmd escalate view

With password protection enabled, you must specify this command with anadditional parameter, –p <current_password>, as follows:scmd -p <current_password> escalate view

When IBM Tivoli Service Level Advisor is first installed, you can choose to enablepassword protection and provide an initial password. If you choose to enablepassword protection for your CLI Service, you can use the scmd setPasswordcommand to change this initial password at any time.

Note: Even if password protection is disabled, you must still supply the currentpassword when issuing either the setPassword or the setPasswordEnabledcommand.

For example, to change the current password to a new password, issue thefollowing command:scmd -p <current_password> setPassword <new_password>

Although scmd help does not require a password, it will attempt to connect to theCLI service and return an error that the password is incorrect. This behavior is dueto the nature of the information that scmd help returns. In the event that aconnection cannot be established because the CLI Service cannot be reached or thepassword is incorrect or not specified, scmd help returns general help information.If a connection to the CLI Service can be established and authenticated, scmd helpreturns specific help information, including a list of all the actively available CLIbundles.

Forgot your CLI Password?The CLI password can be either defined by you or it will be set to a default valueduring installation of IBM Tivoli Service Level Advisor. If the CLI password hasbeen changed but is unknown, contact your IBM Tivoli Service Level Advisoradministrator. The Administrator’s Guide for IBM Tivoli Service Level Advisor providesdetails on resetting and retrieving the CLI password.

Additional CLI Service CommandsIn addition to the four basic CLI service commands is a large set of commands thatoperate on the components of IBM Tivoli Service Level Advisor. These commandbundles are available during the lifetime of the corresponding component and canbe obtained using the scmd list and scmd help commands.

For example, issuing the scmd list command (assuming password protection isdisabled) results in a display similar to the following:>scmd list


Usage:

scmd list

scmd help

scmd –p <password> setPassword <new password>

scmd –p <password> setPasswordEnabled { true | false }

scmd [–p <password>] [<bundlename>] <methodname> [args...]

scmd rcc <method name> [args...]

scmd sla <method name> [args...]

scmd escalate <method name> [args...]

scmd wdccli <method name> [args...]

scmd log <method name> [args...]

scmd scheduler <method name> [args...]

scmd om <method name> [args...]

scmd slm <method name> [args...]

scmd mem <method name> [args...]

scmd etl <method name> [args...]

scmd sdc <method name> [args...]

Note:

scmd help

- Provides further information on using the basic scmd commands.

scmd <bundle name> list

- Provides a list of methods for <bundle name>

In the above example output, rcc, slm, sdc and others represent the list of availablecommand bundle names that can be used in additional CLI commands. Forexample, issuing scmd rcc list returns a list of methods available in the rcc bundlesimilar to the following:>scmd rcc list

Usage:

scmd rcc help

scmd rcc list

scmd rcc getPort

scmd rcc setPort <port>

Note:

scmd rcc help

Provides further information on using the rcc commands.

In the above example, help, list, getPort and setPort are the available methods in thercc bundle.

Table 2 shows the list of available bundle names for use with scmd, along withtheir respective capabilities.

Table 2. Available bundle names and their respective capabilities

Bundle name Capability

(No bundlename specified)

CLI Service configuration and information. CLI Service is the defaultcommand set and does not have a bundle name.

escalate Configuration and troubleshooting capabilities for the event notification.

etl Configuration of and information on the extract, transform, and load(ETL) processes and retrieval of registration data from the SLM Database.


Table 2. Available bundle names and their respective capabilities (continued)

Bundle name Capability

log Configuration of the trace logging and message logging includinghandlers and filters.

mem Customer order configuration and information

om Error recovery of failed customer order processing

rcc Configuration of the Remote Communication Port used by the SLMServer to communicate with the SLM task drivers.

scheduler Configuration of the schedule for evaluation and trend analysis

sdc Provides information on the business objects stored in the SLM Database.

sla Configuration of Web report users

slm Status information and control of the SLM Server and components ofIBM Tivoli Service Level Advisor.

wdccli Status information and configuration and test capabilities for the datacollection interface to the Tivoli Enterprise Data Warehouse database.

The remaining chapters in this document provide more details on each of the CLIscmd commands, as well as non-CLI Service utility commands available for youruse. See the Administrator’s Guide for IBM Tivoli Service Level Advisor for moreinformation on using these commands.



Chapter 2. CLI Service Commands

This section describes general CLI commands you can use for the CLI Service, asshown in Table 3.

Table 3. General CLI Commands

CLI Command See page

scmd help 10

scmd list 13

scmd setPassword 14

scmd setPasswordEnabled 16

Note: For all scmd commands, the –p <password> option is required if the value ofpasswordEnabled for the CLI service is set to true. Otherwise, a password isnot required except in the case of scmd setPasswordEnabled and scmdsetPassword, which always require a password to be specified.


scmd helpReturns the help screen with information on using the scmd command.

Syntaxscmd help

DescriptionProvides a description of the scmd syntax and arguments, along with examples ofusing it in the command line interface. If the CLI service can be reached, scmdhelp returns information on the CLI bundles that are currently available. Theoutput is displayed in the Usage format, where the currently available CLI bundleswill replace the <bundlename> argument of:scmd <bundlename> <methodname> [args...]

In the following example output, the available bundle names are shown as rcc, sla,escalate, wdccli, log, scheduler, om, slm, mem, sdc, and etl:Usage:

scmd list

scmd help

scmd -p <password> setPassword <new password>

scmd -p <password> setPasswordEnabled {true|false}

scmd rcc <methodname> [args...]

scmd sla <methodname> [args...]

scmd escalate <methodname> [args...]

scmd wdccli <methodname> [args...]

scmd log <methodname> [args...]

scmd scheduler <methodname> [args...]

scmd om <methodname> [args...]

scmd slm <methodname> [args...]

scmd mem <methodname> [args...]

scmd sdc <methodname> [args...]

scmd etl <methodname> [args...]

Where:help Displays this help screen.list Displays a list of the available <bundlenames>.setPassword Modifies the password used to access the CLI service.

Requires the existing password in order to modify.setPasswordEnabled

Turns password requirement on and off.Requires the existing password.

<bundlename> Specifies the CLI bundle on which to call <methodname>.Use: scmd <bundlename> list for the available methods

for <bundlename>.Where <bundlename> is one of:rcc, sla, escalate, wdccli, log, om, slm, mem, sdc, etl.

<methodname> The method to invoke on <bundlename>.<password> Specifies the password required to process this scmd request.

Required if passwordEnabled is set to true.[args...] Specifies an argument for a specific method.

Requirement depends on the method.Use: scmd <bundlename> help for more details.

Examples:scmd slm list Returns a list of available methods for the SLM bundle.


scmd slm help Returns detailed information for using the SLM bundle methods.scmd -p currentPassword setPassword newPassword

Resets the CLI password from ’currentPassword’ to ’newPassword’.

The command scmd <bundlename> list or scmd <bundlename> help may be usedto determine the methods made available by each CLI bundle. In the exampleabove, scmd rcc list would return the list of methods and usage for the rcc bundlename.

If the CLI service cannot be reached, the available <bundlename> arguments cannotbe determined, and the general help screen is displayed in the following format:scmd [<bundlename>] <methodname> [args...]

The following is example output:Usage:

scmd list

scmd help

scmd -p <password> setPassword <new password>

scmd -p <password> setPasswordEnabled {true|false}scmd [-p <password>] [<bundlename>] <methodname> [args...]

Where:

help Displays this help screen.

list Displays a list of the available

<bundlenames>.

setPassword Modifies the password used to access the CLI service.

Requires the existing password in order to modify.

setPasswordEnabled

Turns password requirement on and off.

Requires the existing password.

<bundlename> Specifies the CLI bundle to call

<methodname> on.

Use: scmd <bundlename> list for the available

methods for <bundlename>

<methodname> The method to invoke on <bundlename>.

<password> Specifies the password required to process this

scmd request.

Required if passwordEnabled is set to true.

[args...] Specifies an argument for a specific method.

Requirement depends on the method.

Use: scmd <bundlename> help for more details.

Examples:

scmd slm list Returns a list of available methods for the SLM bundle.

scmd slm help Returns detailed information for using the SLM bundle methods.

scmd -p currentPassword setPassword newPassword

Resets the CLI password from ’currentPassword’ to ’newPassword’.

OptionsThere are no options for this command.

Chapter 2. CLI Service Commands 11

AuthorizationThis command requires no authorization.

See Alsoscmd<bundlename> help, where <bundlename> is an scmd command name, forexample, mem, or sdc.


scmd listReturns information on the usage of the scmd command, including the CLIbundles that are currently available.

Syntaxscmd list

DescriptionThis command returns a list of all of the CLI bundles that are currently available.If the CLI service can be reached, the output is displayed in the Usage format,where the currently available CLI bundles will replace the <bundlename> argumentin the following command format:scmd <bundlename> <methodname> [args...]

In the following example, the available bundles names are rcc, sla, escalate, wdccli,log, scheduler, om, slm, mem, sdc, and etl:Usage:

scmd listscmd helpscmd -p <password> setPassword <new password>

scmd -p <password> setPasswordEnabled {true|false}

scmd rcc <methodname> [args...]

scmd sla <methodname> [args...]

scmd escalate <methodname> [args...]

scmd wdccli <methodname> [args...]

scmd log <methodname> [args...]

scmd scheduler <methodname> [args...]

scmd om <methodname> [args...]

scmd slm <methodname> [args...]

scmd mem <methodname> [args...]

scmd sdc <methodname> [args...]

scmd etl <methodname> [args...]

Note:scmd help- Provides further information on using the basic scmd commands.scmd <bundlename> list-Provides a list of methods for <bundlename>.

The command scmd <bundlename> list or scmd <bundlename> help may be usedto determine the methods made available by each CLI bundle. In the exampleabove, scmd rcc list would return the list of methods and usage for the rcc bundle.

OptionsThere are no options for this command.


See Alsoscmd <bundlename> list, where <bundlename> is an scmd command name, forexample, mem or sdc.


scmd setPasswordSets the value of the CLI service password.

Syntaxscmd –p <current_password> setPassword <new_password>

DescriptionSets the value of the CLI service password that must be specified with other scmdcommands if password detection is enabled (see “scmd setPasswordEnabled” onpage 16 for details on enabling and disabling password protection).

When setting a new password, the current password must also be supplied for thenew password to be accepted. If the passwordEnabled value has been set to truein the configuration, then all other scmd commands must also include the – p<current_password>option to run the command.

The length of <new_password> is restricted from six to sixteen characters.

Options–p <current_password>

Specifies the current password used by the CLI service.

AuthorizationThis command requires <current_password> in order to change to a new password.

NotesThe –p <current_password>option is required for the setPassword andsetPasswordEnabledcommands, even if password protection is disabled. Bydefault, password protection is disabled. This CLI command may be used tochange the password.

If the current password is lost or forgotten, your IBM Tivoli Service Level Advisoradministrator should be contacted to retrieve or reset the CLI service password.

Return ValuesIf the password was set correctly the following message will be returned:DYKAL2040I The CLI password was changed successfully.

If the current password that is supplied by –p is incorrect, the following messagewill be returned:DYKAL2004E The password entered is incorrect.

The CLI password is required to complete the setPassword method.

If password supplied by the –p option is not within the allowable length range of6 to 16 characters, the following message will be returned:DYKAL2039E The password entered is not a valid password. CLI passwords must

be 6 to 16 characters in length. The password was not changed.


Examples1. The following example changes the current password from abcdefg to

z1y2x3w4scmd –p abcdefg setPassword z1y2x3w4

2. The following example illustrates the message that is returned when an invalidcurrent password is supplied:scmd –p wrongPassword setPassword z1y2x3w4

DYKAL2004E The password entered is incorrect.

3. The following example illustrates the message that is returned when the newpassword specified is either less than the minimum required length (sixcharacters) or greater than the maximum allowed length (sixteen characters):scmd –p current_password setPassword abc

DYKAL2039E The password entered is not a valid password.

CLI passwords must be 6 to 16 characters in length.

The password was not changed.

See Alsoscmd setPasswordEnabled


scmd setPasswordEnabledEnables or disables password protection for the CLI service scmd commands.

Syntaxscmd –p <current_password> setPasswordEnabled {true | false}

DescriptionThis command sets the passwordEnabled value for the CLI service to either true(password protection enabled) or false (password protection disabled). If passwordprotection is enabled, you must specify the –p <current_password> option withother scmd CLI commands in order to execute them.


Defines the current password used by the CLI service. Thepassword is set with the scmd setPassword command.

AuthorizationThis command requires <current_password> in order to change to a new password.

NotesThe –p <current_password> option is required for the setPassword andsetPasswordEnabled commands, even if password protection is disabled.

If password protection was not enabled during installation of IBM Tivoli ServiceLevel Advisor, it is disabled by default.

Return ValuesIf a value other than true or false is supplied, the following message will bereturned:DYKAL2026E The input value is not valid. This operation requires a value

of true or false.

Usage:scmd -p <password> setPasswordEnabled {true|false}

If the command completes successfully, one of the following message will bereturned:DYKAL2041I The CLI password was successfully enabled.

DYKAL2042I The CLI password was successfully disabled.

Examples1. This example enables password protection:

scmd –p <password> setPasswordEnabled true

2. This example disables password protection:scmd –p <password> setPasswordEnabled false

3. This example displays the error message returned if true or false is notsupplied:scmd –p <password> setPasswordEnabled tru

DYKAL2026E The input tru is not valid. This operation requires a value


of true or false.

Usage:scmd -p <password> setPasswordEnabled {true|false}

See Alsoscmd setPassword



Chapter 3. Escalation Commands

This section describes the CLI commands related to escalation of events to notifysupport personnel of violations, trends toward violations, trend cancellations, andapplication problem events. The available commands are listed in Table 4.

Table 4. CLI Commands for Escalation


scmd escalate checkCache 20

scmd escalate customize 21

scmd escalate disable 25

scmd escalate enable 26

scmd escalate flush 28

scmd escalate help 29

scmd escalate list 30

scmd escalate setCacheSize 31

scmd escalate snmp FormatDateTime 32

scmd escalate test 33

scmd escalate view 34

Note: For all scmd commands, the –p <password> option is required if the value ofpasswordEnabled for the CLI service is set to true. Otherwise, a password isnot required. See the CLI commands “scmd setPassword” on page 14 and“scmd setPasswordEnabled” on page 16 for more information about settingand enabling passwords.


scmd escalate checkCacheChecks any Tivoli Enterprise Console event saved in disk.

Syntaxscmd [–p <current_password>] escalate checkCache

DescriptionThe scmd escalate checkCache command checks for any events saved in disk dueto previous failure in sending to the Tivoli Enterprise Console server. If there is afailing Tivoli Enterprise Console server, running this command tells you if thereare events currently being queued for delivery. You should check the cache beforeand after running the scmd escalate flush command (TEC event type only).

You might want to use this command if you are servicing the Tivoli EnterpriseConsole server, or if you see the following message in the message log:DYKSL1102E Error occurred while forwarding the Tivoli Enterprise Console event

to the Tivoli Enterprise Console Server.

If events are not in the cache, the following message is displayed:No events cached in the disk. No action is necessary to send events to the server.

If events are in the cache, the following message is displayed:Events cached in the disk. Recommend to manually send events to the server.

After issuing the scmd escalate checkCache command to check for events, issuethe scmd escalate flush command to send events to the Tivoli Event Console.Because attempts are automatically made every hour to retry sending TivoliEnterprise Console events, the flushing may happen automatically.


Enables you to supply the current password if password protection hasbeen enabled. See the scmd setPassword and scmd setPasswordEnabledcommands for more information.


NotesThis command should only be used for error recovery. Use this command with thescmd escalate flush command.

ExamplesCheck for any TEC events saved to disk.scmd escalate checkCache

See Alsoscmd escalate flush


scmd escalate customizeEnables you to customize e-mail messages and subject lines for e-mail eventnotification of violations, trends, and trend cancel event types.

Syntaxscmd [–p <current_password>] escalate customize email –subject {default |″<subject>″}

scmd [–p <current_password>] escalate customize email –event {cancelled | trend| violation } –content { default | ″<message>″}

scmd [–p <current_password>] escalate customize email –reportLink enable–server <report_server> [–port <report_server_port>] [–page <report_page_name>]

scmd [–p <current_password>] escalate customize email –reportLink disable

DescriptionThe scmd escalate customize command enables you to specify the subject line andthe content of e-mail messages that are sent as a result of event escalation at theoccurrence of violation, trend, or trend cancel events. You can send a defaultmessage, or you can specify your own message. You can also configure the HTMLlink to be used to access the report details from the e-mail message.

Specifying the SubjectIf you select the default subject option instead of specifying your own subject text,then the following default subject line is used:SLO $EventType

The subject (either the default subject or a subject that you provide) can contain thefollowing keyword that will be replaced by its real value when the event isgenerated:

$EventTypeThe name of the event type. The event type will be one of the followingstrings:v Violationv Trendv Trend Cancelled

Specifying the MessageIf you select the default message option instead of specifying your own messagetext, then the following default message text is used:

Note: The substitution variables are prefaced with $ characters, and \n charactersare included to generate a new line.

ViolationNOTICE: A metric violation has been detected. The details are asfollows:\n\nCustomer Name: $CustomerName \nOrder Number:$CustomerOrderId \nOrder Name: $CustomerOrderName \nOtherAffected Orders: $AffectedOrders \nSchedule State: $ScheduleState\nResource: $ComponentName \nMetric Violated: $MetricName \nUnits:$Units \nEvaluation End Date: $ViolationEndDate \nViolationDetails:\n$ViolationDetail

Chapter 3. Escalation Commands 21

Trend NOTICE: A trend toward a potential metric violation has been detected.The details are as follows:\n\nCustomer Name: $CustomerName \nOrderNumber: $CustomerOrderId \nOrderName: $CustomerOrderName\nOther Affected Orders: $AffectedOrders \nSchedule State:$ScheduleState \nResource: $ComponentName \nMetric Predicted to beExceeded: $MetricName \nUnits: $Units \nTrendPrediction:\n$TrendProjectedDetail \nAnalysis Period:$TrendAnalysisPeriod \nTotal Samples: $TotalSamples

Trend CancelledNOTICE: A previously reported trend that had predicted a future metricviolation has been CANCELED. The metric associated with the followinginformation is no longer trending toward a violation:\n\nCustomerName:$CustomerName \nOrder Number: $CustomerOrderId \nOrder Name:$CustomerOrderName \nOther Affected Orders: $AffectedOrders\nSchedule State: $ScheduleState \nResource: $ComponentName \nMetricName: $MetricName

The message (either the default message or a message that you provide) cancontain the following keywords that will be replaced by their real values when theevent is generated:

$AffectedOrdersThe parent order list, or the orders further up in the multi-tiered hierarchy,that will be affected by the violation, trend, or trend cancelled event.

$ComponentNameThe name of the affected component.

$CustomerNameThe name of the affected customer.

$CustomerOrderIdThe customer order ID of the event.

$CustomerOrderNameThe customer order name of the event.

$MetricNameThe name of the metric that caused the event.

$RealmNameThe name of the affected realm.

$ScheduleStateThe schedule state from the business schedule.

$ServiceOfferingNameThe name of the affected offering.

$TrendProjectedDetailThe details of the project trend (only valid for trend event).

$TrendAnalysisPeriodThe period for the trending analysis (only valid for a trend event).

$TotalSamplesThe total samples used on the trending analysis (only valid for a trendevent).

$Units The units of the metric.


$ViolationDetailThe details of the violation (only valid for a violation event).

$ViolationEndDateThe end date of the violation (only valid for a violation event).


Enables you to supply the current password if password protectionhas been enabled. See the scmd setPassword and scmdsetPasswordEnabled commands for more information.

–event cancelledSpecifies the trend cancelled event as the event type.

–event trend Specifies the trend event as the event type.

–event violationSpecifies the violation event as the event type.

–subject default | ″<subject>″Specifies the e-mail subject for violation, trend, or trend cancelledevents. You can specify either the default subject or your ownsubject.

–content default | ″<message>″Specifies the e-mail message for violation, trend, or trend cancelledevents. You can specify either the default message or your ownmessage.

–page [<report_page_name>]Specifies the report page name of a customized page. Default isopCustReportDetail.jsp.

–port [<report_server_port>]Optionally specifies the HTTP port used by the report HTTPserver.

–reportLink enableInclude the HTML link to access report details in the e-mail.

–reportLink disableExclude the HTML link to access report details in the e-mail.

–server <report_server>Specifies the fully qualified host name where SLM Reports isinstalled.


NotesFor UNIX, precede the $ character with a backslash ″\″ character so the variablename can be recognized as a variable. For example:NOTICE: A metric violation has been detected. The details are as follows:

\n\nCustomer Name: \$CustomerName \nOrder Number: \$CustomerOrderId

\nSchedule State: \$ScheduleState \nResource: \$ComponentName

\nMetric Violated: \$MetricName \nViolation Details:\n\$ViolationDetail


FilesThe subject for the e-mail is added to the e-mail.properties file in the followingformat:<email_subject>=<subject>

The message for the e-mail is added to the e-mail.properties file in the followingformat:<event_type>=<message>

Examples1. Customize the e-mail subject line to be ″ABC Company is reporting Service

Level Objective: $EventType.″scmd escalate customize email -subject "ABC Company is reporting Service Level

Objective: $EventType"

2. Specify the default subject line to be used:scmd escalate customize -subject default

3. Specify a customized message for a trend event.scmd escalate customize email -event trend -content "Attention! A

trend event was detected."

4. Specify the default message for a trend cancelled event.scmd escalate customize email -event cancelled -content default

5. Include a customized report link in the e-mail for violation and trend events.

Note: The default report page name is opCustReportDetail.jsp. In this example,the report page has been customized and named ascustomizedReportDetail.jsp. You provide this name using the –pageoption.

scmd escalate customize email -reportLink enable -server \n

tslaReportServer.ibm.com -port 9080 -page customizedReportDetail.jsp


scmd escalate disableDisables a particular method of escalating events, or disables the escalation ofapplication problem events.

Syntaxscmd [–p <current_password>] escalate disable {email | SNMP | TEC |ApplicationEvent}

DescriptionThe scmd escalate disable command disables the specified method (e-mail, SNMPtrap, or Tivoli Enterprise Console events) of escalating trend, trend cancelled, andviolation events.

This command also disables the escalation of application problem events.



email Specifies the e-mail method of escalating events.

SNMP Specifies the SNMP trap method of escalating events.

TEC Specifies the Tivoli Enterprise Console event method of escalatingevents.

ApplicationEventSpecifies that escalation of application problem events is disabled.


Examples1. Disable the e-mail method.

scmd escalate disable email

2. Disable the SNMP trap method.scmd escalate disable SNMP

3. Disable the TEC event method.scmd escalate disable TEC

4. Disable the escalation of application problem events.scmd escalate disable ApplicationEvent

See Alsoscmd escalate enable, scmd escalate view


scmd escalate enableEnables a particular method for escalating events, or enables escalation ofapplication problem events.

Syntaxscmd [–p <current_password>] escalate enable email –to <email addresses> [–cc<email addresses>] –smtp <SMTP_server>

scmd [–p <current_password>] escalate enable TEC –server <server> [–port <port>][–cacheSize <file size in kilobytes>]

scmd [–p <current_password>] escalate enable SNMP –dest <trap destination> –port<port> [–community <community name>]

scmd [–p <current_password>] escalate enable ApplicationEvent

DescriptionThe scmd escalate enable command enables the specified method (e-mail, TivoliEnterprise Console events, or SNMP traps) of escalating events (trend, trendcancelled, and violation).

This command also enables escalation of critical application problem events usingthe configured escalation method (e-mail, SNMP trap, or TEC event).



–to <email addresses>(e-mail only) Specifies the e-mail address of the recipient. Tospecify multiple e-mail recipients, separate each e-mail addresswith a space.

–cc <email addresses>(e-mail only) Specifies the e-mail address of the carbon copyrecipient. To specify multiple carbon copy recipients, separate eache-mail address with a space.

–dest <trap destination>(SNMP only) Specifies the fully-qualified host name or the IPaddress of the destination machine on which the SNMP receiver isrunning.

–smtp <SMTP server>(e-mail only) Specifies the fully qualified host name of the SMTPserver through which the e-mail should be sent. The e-mail systemto which you send e-mail notifications must be capable of handlingcharacters in the UTF-8 character set.

–server <server>(TEC only) Specifies the fully qualified host name of the SMTPserver through which the e-mail should be sent.


–port <port> (SNMP only) Specifies the port on the receiver to which events aresent.

–community <community name>(SNMP only) Specifies the community name of the events.

–cacheSize <filesize in kilobytes>(TEC only) Specifies the maximum size, in kilobytes, of the file tostore events on disk when they cannot be sent to the server. Thedefault is 64Kb.


Examples1. Enable the e-mail method of escalating events, specifying the recipient to be

[email protected], the carbon copy recipient to [email protected], and the SMTP server to be smtp-server.nc.rr.com.scmd escalate enable email -to [email protected] -cc [email protected]

-smtp smtp-server.nc.rr.com

2. Enable the e-mail method of escalating events, specifying the list of recipientsto be [email protected] and [email protected], and the SMTPserver to be smtp-server.nc.rr.com.scmd escalate enable email -to [email protected] [email protected]

-smtp smtp-server.nc.rr.com

3. Enable the SNMP trap method of escalating events, specifying the destinationto be destABC.us.company.com and the port to be 162.scmd escalate enable SNMP -to destABC.us.company.com -port 162

4. Enable the SNMP trap method of escalating events, specifying the destinationto be 66.57.79.58, the port to be 162, the community name to becommunity_name.scmd escalate enable SNMP -dest 66.57.79.58 -port 162 -community community_name

5. Enable the Tivoli Enterprise Console event method of escalating events.scmd escalate enable TEC

6. Enable the Tivoli Enterprise Console event method of escalating events usingserver tecserver.raleigh.tivoli.com and using port 65535.scmd escalate enable TEC –server tecserver.raleigh.tivoli.com

-port 65535

7. Enable escalation of application problem events using the configured method(e-mail, SNMP trap, or TEC event):scmd escalate enable ApplicationEvent

See Alsoscmd escalate customize, scmd escalate disable, scmd escalate snmpFormatDateTime, scmd escalate view


scmd escalate flushFlushes events saved in disk to the server.

Syntaxscmd [–p <current_password>] escalate flush

DescriptionThe scmd escalate flush command flushes events that are saved to disk to theTivoli Enterprise Console server (TEC event type only).




NotesThis command should only be used for error recovery. Use this command with thescmd escalate checkCache command.

If the flush of events fails, the events remain cached on local disk, and thefollowing message is displayed:DYKSL1102E Error occurred while forwarding the Tivoli Enterprise Console event to

the Tivoli Enterprise Console Server.

An attempt is made every hour to flush these events, so the flushing may happenautomatically.

ExamplesStart flushing events saved in disk to the server when the Tivoli EnterpriseConsole server is operational.scmd escalate flush

See Alsoscmd escalate checkCache


scmd escalate helpDisplays command syntax and examples for the scmd escalate command bundle.

Syntaxscmd [–p <current_password>] escalate help [–verbose]

DescriptionThe scmd escalate help command displays the command syntax, variables,options, and examples for the scmd escalate command bundle.



–verbose You can specify this option to get additional help informationabout the command bundle.


ExamplesDisplay help for the escalate command bundle.scmd escalate help

Display additional help for the escalate command bundle.scmd escalate help -verbose


scmd escalate listLists all available commands and options for the scmd escalate command bundle.

Syntaxscmd [–p <current_password>] escalate list

DescriptionThe scmd escalate list command lists all available commands and options for thescmd escalate command bundle.




ExamplesList all available commands in the scmd escalate command bundle.scmd escalate list


scmd escalate setCacheSizeSpecifies the maximum size, in kilobytes, of the file to store events on disk whenthey cannot be sent to the server. The default is 64Kb.

Syntaxscmd [–p <current_password>] escalate setCacheSize <filesize_in_kilobytes>

DescriptionThe scmd escalate setCacheSize command specifies the maximum size, inkilobytes, of the file to store events on disk when they cannot be sent to the TivoliEnterprise Console server (TEC event type only). The default is 64Kb.




ExamplesSet the file size of the file to store events on disk to 128Kb:scmd escalate setCacheSize 128


scmd escalate snmp FormatDateTimeFormats the SNMP Trap DateTime value to a readable string.

Syntaxscmd [–p <current_password>] escalate snmp FormatDateTime {true | false}

DescriptionThe scmd escalate snmp FormatDateTime command formats the SNMP TrapDateTime value to a readable string. Instead of formatting the date as specified inRFC2579, the date will be formatted in the trap as a text string displaying date andtime.

For example, July 15, 2002 at 1:30:15 PM EDT would be displayed as:2002-07-15,13:30:15.0,-4:0

Note: The part of the information, -4:0, indicates the offset from Greenwich MeanTime with daylight savings time in the Eastern Daylight Time (EDT) timezone.



true | false Enables you to turn on or off the formatting of the SNMPDateTime value.


Examples1. Turn on formatting of the SNMP DateTime value:

scmd escalate snmp FormatDateTime true

2. Turn off formatting of the SNMP DateTime value:scmd escalate snmp FormatDateTime false


scmd escalate testSends a sample event to test the currently enabled escalation method.

Syntaxscmd [–p <current_password>] escalate test

DescriptionThe scmd escalate test command sends a sample event to test the currentlyenabled escalation method (e-mail, SNMP traps, or Tivoli Enterprise Consoleevents).




NotesThis command should be used during error recovery or during initial productinstall to verify your escalation method settings.

ExamplesTest all enabled escalation methods.scmd escalate test


scmd escalate viewDisplays all configured parameters and reports the escalation methods that areenabled or disabled.

Syntaxscmd [–p <current_password>] escalate view

DescriptionThe scmd escalate view command displays all configured parameters for theescalation methods (e-mail, SNMP trap, and Tivoli Enterprise Console events) andreports whether each of these methods is enabled or disabled.scmd escalate view

The following example show sample output:email is enabled.email recipients [email protected],[email protected] cc recipients:email SMTP server =smtp-server.ny.ca.comemail violation message:email trend message =The $MetricName in state $ScheduleState ispredicted to be exceeded at $TrendProjectedDate for customer$CustomerName from order $CustomerOrderId.The service componentthat will cause the violation is $ComponentName.email cancelled message:SNMP is enabled.SNMP destination =62.56.45.22SNMP port =162SNMP community name:tec is enabled.tec server=tec-server.raleigh.ibm.comtec port=65535




ExamplesDisplay all configured parameters for the escalation methods.scmd escalate view

See Alsoscmd escalate customize, scmd escalate disable, scmd escalate enable


Chapter 4. Extract, Transform, and Load Process Commands

This section describes the CLI commands you can use to help you manage thekind of data that is extracted from the Tivoli Enterprise Data Warehouse andloaded into the SLM Database and the SLM Application Data Mart by the extract,transform, and load (ETL) processes. The available commands are listed in Table 5:

Table 5. CLI Commands for ETL processes


scmd etl addApplicationData 36

scmd etl disable 37

scmd etl enable 39

scmd etl getApps 40

scmd etl getDataExpiration 41

scmd etl getDMVersion 42

scmd etl getMMVersion 43

scmd etl help 44

scmd etl list 45

scmd etl setDataExpiration 46



scmd etl addApplicationDataAdds the identified application to the SLM environment and enables it for usewith IBM Tivoli Service Level Advisor.

Syntaxscmd [–p <current_password>] etl addApplicationData <measurement_source_code>″<application_name>″

DescriptionThe scmd etl addApplicationData command adds the identified application to theSLM environment, and enables its data to be transferred from the Tivoli EnterpriseData Warehouse database to the SLM Database for use with IBM Tivoli ServiceLevel Advisor.

Note: To determine the measurement source code for an application that you wantto add to the SLM environment, refer to the Installation, Interface, and UsageGuide for Tivoli Enterprise Data Warehouse document for the particularapplication, located in the \doc directory on the application installationmedia, for example,/tedw_apps/apf/install/v210/doc/TAPM_for_TEDW.pdf

In this document, locate the MSrc_Cd column of the Measurement Source(MSrc) table. The measurement source code for the application is recordedthere.



<measurement_source_code>Specifies the code name for the source application that is to beadded.

<application_name>Specifies the name of the application to be added to the SLMEnvironment


Examples1. Add the XYZ Warehouse Application to the SLM environment, and enable it so

that data from that application can be transferred from the Tivoli EnterpriseData Warehouse database to the SLM Database. The documentation for theapplication specifies the measurement source code as XYZ.scmd etl addApplicationData XYZ "XYZ Warehouse Application"

See Alsoscmd etl enable, scmd etl disable, scmd etl getApps


scmd etl disable

Prevents data belonging to the specified source application from being transferredfrom the Tivoli Enterprise Data Warehouse database to the SLM Database(dyk_cat).

Syntaxscmd [–p <current_password>] etl disable <measurement_source_code> [list]

DescriptionThe scmd etl disable command prevents unwanted data from being transferredfrom the Tivoli Enterprise Data Warehouse database to the SLM Database, helpingto minimize the amount of data that is transferred. You can specify the code namefor the source application to disable, and on subsequent runs of the RegistrationETL process, data from this source application will be blocked from beingtransferred to the SLM Database. The value of the associated flag in the extractfilter is changed to N, signifying No.

This command also removes any existing data that was registered for the specifiedsource application as long as there are no outstanding service offerings or customerorders associated with the specified source application. If you attempt to disable asource application but there are existing offerings or orders that were constructedusing data associated with that application, an error message will be displayed.You should then reissue the scmd etl disable command using the list parameter todetermine which offerings and orders are associated with the specified sourceapplication.



<measurement_source_code>Specifies the code name for the source application that is to beblocked. You can use the scmd etl getApps command to display alist of applications in the filter and their associated measurementsource codes.

list Lists all offerings and orders which are dependent on dataassociated with the specified source application. Using the listparameter does not disable the application. If offerings or ordersare listed for a source application that you want to disable, use theIBM Console to cancel and then remove existing orders, and thenremove the offerings upon which the orders were based. Thenissue the scmd etl disable command again to disable the sourceapplication.


Chapter 4. Extract, Transform, and Load Process Commands 37

NotesAll source applications are disabled by default. Use the scmd etl enable commandto enable source applications to be used with IBM Tivoli Service Level Advisorbefore running the Registration ETL.

Examples1. Block data from the BWM source application from being transferred from the

Tivoli Enterprise Data Warehouse database to the SLM Database.scmd etl disable BWM

See Alsoscmd etl enable, scmd etl getApps, scmd etl addApplicationData


scmd etl enableEnables data from the specified source application to be transferred from the TivoliEnterprise Data Warehouse database to the SLM Database (dyk_cat).

Syntaxscmd [–p <current_password>] etl enable <measurement_source_code>

DescriptionThe scmd etl enable command enables data associated with a specific sourceapplication to be transferred from the Tivoli Enterprise Data Warehouse databaseto the SLM Database. You can specify the code name for the source application toenable, and on subsequent runs of the Registration ETL process, data from thissource application will be allowed to be transferred from the Tivoli Enterprise DataWarehouse database to the SLM Database. The value of the associated flag in theextract filter is changed to Y, signifying Yes.



<measurement_source_code>Specifies the code name for the source application that is to beenabled. You can use the scmd etl getApps command to display alist of applications in the filter and their associated measurementsource codes.


NotesAll source applications are disabled by default. Use the scmd etl enable commandto enable source applications to be used with IBM Tivoli Service Level Advisorbefore running the Registration ETL.

Examples1. Enable data from the BWM source application to be transferred from the Tivoli

Enterprise Data Warehouse database to the SLM Database.scmd etl enable BWM

See Alsoscmd etl disable, scmd etl getApps, scmd etl addApplicationData


scmd etl getAppsReturns a list of applications that are registered by their filter, and also indicateswhether the filter is enabled or disabled.

Syntaxscmd [–p <current_password>] etl getApps

DescriptionThe scmd etl getApps command returns a list of applications that are registered bytheir filter, and also indicates whether the filter is enabled or disabled.




Examples1. Get a list of applications.

scmd etl getApps

For each application, the output will be displayed similar to the following:Measurement Source Code: BWM

Application Name: Tivoli Web Services Manager

Flag: Y

See Alsoscmd etl disable, scmd etl enable, scmd etl addApplicationData


scmd etl getDataExpirationReturns the number of days that data can reside in the SLM Measurement DataMart (dyk_dm) before it is deleted.

Syntaxscmd [–p <current_password>] etl getDataExpiration

DescriptionThe scmd etl getDataExpiration command returns the number of days that datacan reside in the SLM Measurement Data Mart before it is deleted. Expired data isdeleted to conserve space in the database and prevent it from becoming excessivelylarge.




Examples1. Get the number of days that data is kept in the SLM Measurement Data Mart

before it expires.scmd etl getDataExpiration

The output will typically look like the following:DYKET1506I The data is set to expire every 63 days.

See Alsoscmd etl setDataExpiration


scmd etl getDMVersionReturns the schema version of the SLM Measurement Data Mart (dyk_dm)

Syntaxscmd [–p <current_password>] etl getDMVersion

Descriptionthe scmd etl getDMVersion command returns the schema version of the SLMMeasurement Data Mart (dyk_dm).




Examples1. Get the schema version of the SLM Measurement Data Mart database.

scmd etl getDMVersion

Typical output is displayed similar to the following:DM Schema Version: 1.15


scmd etl getMMVersionReturns the schema version of the SLM Database database (dyk_cat).

Syntaxscmd [–p <current_password>] etl getMMVersion

DescriptionThe scmd etl getMMVersion command returns the schema version of the SLMDatabase (dyk_cat) database.




Examples1. Get the schema version of the SLM Database.

scmd etl getMMVersion

Typical output is displayed similar to the following:MM Schema Version: 1.1


scmd etl help

Returns the help screen with information on using the scmd etl command.

Syntaxscmd [–p <current_password>] etl help

DescriptionThe scmd etl help command returns the help screen with information on using thescmd etl command.




Examples1. Request help for the scmd etl command.

scmd etl help

See Alsoscmd help


scmd etl list

Lists information about the scmd etl command.

Syntaxscmd [–p <current_password>] etl list

DescriptionThe scmd etl list command displays information about the various commandsavailable in the etl command bundle.




Examples1. Display information on the etl command bundle.

scmd etl list

See AlsoOther scmd etl commands described in this chapter.


scmd etl setDataExpirationSets the number of days that data will be kept in the SLM Measurement Data Martbefore being deleted.

Syntaxscmd [–p <current_password>] etl setDataExpiration <number_of_days>

DescriptionThe scmd etl setDataExpiration command sets the number of days that data willbe kept in the SLM Measurement Data Mart before being deleted. The defaultexpiration setting is 63 days (essentially two months plus one day).



<number_of_days>Specifies the number of days, expressed as an integer, that the datawill remain in the SLM Measurement Data Mart before expiring.


Examples1. Set the expiration time for data in the SLM Measurement Data Mart to expire

in 45 days.scmd etl setDataExpiration 45

See Alsoscmd etl getDataExpiration


Chapter 5. Logging and Tracing Commands

This chapter describes the CLI commands related to logging and tracing:

Table 6. CLI Commands for Logging and Tracing


scmd log filter 48

scmd log handler 50

scmd log help 52

scmd log list 53

scmd log message 54

scmd log trace 56



scmd log filterDisplays or changes the properties of a filter.

Syntaxscmd [–p <current_password>] log filter {[–g <group_name>]/ [<object_name>]}{–keys | –get <key> | –set <key>=<value> | –contents | –list}

DescriptionThe scmd log filter command displays or changes the properties of a filter loggingobject.



–g <group_name>Specifies the name of a group of filter objects. This option affectsthe properties of all objects in the group.

<object_name> Specifies the name of the filter object.

–keys Displays a list of properties (keys) for the specified filter object.

–get <key> Retrieves information for the specified key for the filter object.

–set <key>=<value>Sets a new property for the specified filter object.

–contents Displays a list of key=value pairs for the logger or handleridentified by <object_name>.

–list Displays a list of all filter objects. If a group name is specified, thenonly filter loggers in the group will be displayed.

AuthorizationThis command requires no authorization.1. There are four pre-defined filters:

trcFilter.slm(default) Used to view TYPE_LEVEL1, TYPE_LEVEL2, andTYPE_LEVEL3 trace messages

trcFilter.slmlevel1Used to view TYPE_LEVEL1 trace messages only

trcFilter.slmlevel2Used to view TYPE_LEVEL1 and TYPE_LEVEL2 trace messages only

trcFilter.slmlevel3Used to view TYPE_LEVEL1, TYPE_LEVEL2, and TYPE_LEVEL3 tracemessages

All components of IBM Tivoli Service Level Advisor are configured to use thedefault trcFilter.slm filter. To effect a change for all components, you can changethe mask for that filter.


Components external to IBM Tivoli Service Level Advisor use trcFilter.slm. Usethe other filters to effect a change on individual components of IBM TivoliService Level Advisor by changing the filter that they use.

To trace only TYPE_LEVEL1 messages for all components, change the mask ontrcFilter.slm by entering the following command:scmd log filter trcFilter.slm -set mask=TYPE_LEVEL1

2. List the parent filter objects.scmd log filter -list

msgFilter

trcFilter

trcFilter/slmlevel3

trcFilter/slmlevel2

trcFilter/slmlevel1

trcFilter/slm

3. List the child filter objects of the trcFilter parent filter object.scmd log filter trcFilter -list

trcFilter

trcFilter/slmlevel3

trcFilter/slmlevel2

trcFilter/slmlevel1

trcFilter/slm

Chapter 5. Logging and Tracing Commands 49

scmd log handlerDisplays or changes the properties of a handler.

Syntaxscmd [–p <current_password>] log handler {[–g <group_name>]/[<object_name>]}{–keys | –get <key> | –set <key>=<value> | –contents | –list}

DescriptionThe scmd log handler command displays or changes the properties of a handlerlogging object.



–g <group_name>Specifies the name of a group of handler objects. This optionaffects the properties of all objects in the group.

<object_name> Specifies the name of the handler object.

–keys Displays a list of properties (keys) for the specified handler object.

–get <key> Retrieves information for the specified key for the handler object.

–set <key>=<value>Sets a new property for the specified handler object.

–contents Displays a list of key=value pairs for the specified handler object.

–list Displays a list of all handler objects. If a group name is specified,then only handler loggers in the group will be displayed.

Examples1. The default console handler uses a formatter named minimal. The minimal

formatter shows only the time stamp and message text on the console. Aformatter named maximal is defined in the default configuration settings. Themaximal formatter displays additional fields from a log record.To attach the maximal formatter to the default console handler, enter thefollowing command:scmd log handler console -set formatterNames=maximal

2. To change the maximum size (in Kb) of each log file (the default value is 512Kb), enter the following commands for trace logs and message logs,respectively:scmd log handler trcFile.slm -set maxFileSize=256

scmd log handler msgFile.slm -set maxFileSize=666

3. To change the number of log files (the default is 3) to use, enter the followingcommands for trace logs and message logs, respectively:scmd log handler trcFile.slm -set maxFiles=5

scmd log handler msgFile.slm -set maxFiles=5

4. List the parent handler objects.scmd log handler -list


msgFile

msgFile/slm

logFile

console

serialTrcFile

log

log/dbDelete

log/dbReader

log/dbHandler

serialMsgFile

serialMsgFile/slm

logServerHandler

trcFile

trcFile/slm

5. List the child handler objects of the msgFile parent handler object.scmd log handler msgFile -list

msgFilemsgFile/xmlmsgFile/slmAuditDetailmsgFile/slmAuditmsgFile/slmAuditDetailxmlmsgFile/slmmsgFile/slmAuditxmllogFileconsoleserialTrcFileloglog/dbDeletelog/dbReaderlog/dbHandlerserialMsgFilelogServerHandlertrcFiletrcFile/ffdctrcFile/xmltrcFile/slm


scmd log helpDisplays command syntax and examples for the scmd log command bundle.

Syntaxscmd [–p <current_password>] log help

DescriptionThe scmd log help command displays the command syntax, variables, options,and examples for the scmd log command bundle.



ExamplesDisplay help for the scmd log command bundle.scmd log help


scmd log listLists all available commands and options for the scmd log command bundle.

Syntaxscmd [–p <current_password>] log list

DescriptionThe scmd log list command lists all available commands and options for the scmdlog command bundle.



ExamplesList all available scmd log commands.scmd log list


scmd log messageDisplays or changes the properties of a message logger.

Syntaxscmd [–p <current_password>] log message {[–g <group_name>]/ [<object_name>]}{–keys | –get <key> | –set <key>=<value> | –contents | –list | –listactive}

DescriptionThe scmd log message command displays or changes the properties of a messagelogger.



–g <group_name>Specifies the name of a group of message logger objects. Thisoption affects the properties of all objects in the group.

<object_name> Specifies the name of the message logger object.

–keys Displays a list of properties (keys) for the specified message loggerobject.

–get <key> Retrieves information for the specified key for the message loggerobject.

–set <key>=<value>Sets a new property for the specified message logger object.

–contents Displays a list of key=value pairs for the specified message loggerobject.

–list Displays a list of all message loggers. If a group name is specified,then only message loggers in the group will be displayed.

–listactive Displays a list of loggers that have message logging enabled.

Examples1. List the message logger objects.

scmd log message -list

A partial response to this command is as follows:dykitk

dykut

dyksl

log

log/serialLogger

log/serverLogger

log/dbLogger

log/msgLogger

dykrp

dykal


dykal/cli

dykal/cm

2. List the message loggers for the dykal group message object.scmd log message -g dykal -list

dykaldykal/clidykal/cmdykal/cfgdykal/adapterdykal/auditdykal/logdykal/ds

3. List the components with message logging turned on:scmd log message -listactive


scmd log traceDisplays or changes the properties of a trace logger.

Syntaxscmd [–p <current_password>] log trace {[–g <group_name>] | [<object_name>]}{–keys | –get <key> | –set <key>=<value> | –contents | –list | –listactive}

DescriptionThe scmd log trace command displays or changes the properties of a trace logger.



–g <group_name>Specifies the name of a group of trace logger objects. This optionaffects the properties of all objects in the group.

<object_name> Specifies the name of the trace logger object.

–keys Displays a list of properties (keys) for the specified trace loggerobject.

–get <key> Retrieves information for the specified key for the trace loggerobject.

–set <key>=<value>Sets a new property for the specified trace logger object.

–contents Displays a list of key=value pairs for the specified trace loggerobject.

–list Displays a list of all trace loggers. If a group name is specified,then only trace loggers in the group will be displayed.

–listactive Displays a list of the components that have trace logging enabled.

Examples1. By default, trace loggers are disabled. To enable trace loggers, enter the

following commands:scmd log trace -set isLogging=true

2. To enable trace logging for the spi group only, enter the following command:scmd log trace -g spi isLogging=true

3. To list all trace loggers, enter the following command:scmd log trace -list

4. To list all trace loggers in the spi group, enter the following command:scmd log trace -g spi -list

5. To trace only level 2 messages for the spi component, enter the followingcommand:scmd log trace -g spi -set filterNames=trcFilter.slmlevel2

6. To list the components with trace logging turned on, enter the followingcommand:


scmd log trace -listactive

7. To list the components in the spi group with trace logging turned on, enter thefollowing command:scmd log trace -g spi -listactive

8. List the trace loggers.scmd log trace -list

A partial response to this command is as follows:dykitk

dykut

dyksl

log

log/managerTrace

util

util/dirWatcher

dykrp

dykal

dykal/cli

dykal/cm

9. List the trace loggers for the dykal trace group.scmd log trace -g dykal -list

dykaldykal/clidykal/cmdykal/cfgdykal/adapterdykal/auditdykal/logdykal/ds



Chapter 6. Metric Evaluator Manager Commands

This chapter describes the CLI commands related to the Metric Evaluator Managercomponent of IBM Tivoli Service Level Advisor, as shown in Table 7.

Table 7. CLI Commands for Metric Evaluator Manager


scmd mem flushEvents 60

scmd mem help 61

scmd mem list 62

scmd mem removeStoppedRetryEntries 63

scmd mem retryMissedIntervals 65

scmd mem showAllOrderIDs 67

scmd mem showMetricEvaluators 68

scmd mem showRetrys 70

scmd mem trending 72



scmd mem flushEventsSends all persisted events to the SLA component of IBM Tivoli Service LevelAdvisor.

Syntaxscmd [–p <current_password>] mem flushEvents

DescriptionThe scmd mem flushEvents command sends events that are persisted in the metricevaluator component of IBM Tivoli Service Level Advisor to the SLA component.When events cannot be sent to the SLA they are stored in the metric evaluator.This command flushes these stored events out of the metric evaluator and sendsthem on to the SLA component for processing.

For example, if a DB2 failure or a network failure occurred between the SLMServer machine and the machine where the SLM Database is located, when anattempt is made after SLA evaluation to write results to the SLA database, thefollowing error message would be displayed in the message log:DYKME9034E An attempt was made to publish service monitoring results and

a failure occurred. The monitoring results will be stored locally.

You can issue the scmd mem flushEvents command to send this data to the SLMDatabase after the network failure has been resolved.


Specifies the current password that is set in the configuration. Thisoption is required if password protection has been enabled for theCLI service. The password is set with the scmd setPasswordcommand. Password protection is enabled or disabled with thescmd setPasswordEnabled command.


NotesThis command should only be used during error recovery.

ExamplesSend events stored in the metric evaluator to the SLA.scmd mem flushEvents


scmd mem helpDisplays command syntax and examples for the scmd mem command bundle.

Syntaxscmd [–p <current_password>] mem help

DescriptionThe scmd cfg help command displays the command syntax and examples for thescmd mem command bundle.




ExamplesDisplay help for the scmd mem command bundle.scmd mem help

Chapter 6. Metric Evaluator Manager Commands 61

scmd mem listLists the available commands and options for the scmd mem command bundle.

Syntaxscmd [–p <current_password>] mem list

DescriptionThe scmd mem list command lists the available commands and command syntaxfor the scmd mem command bundle.




ExamplesList all available commands and their command syntax for the scmd memcommand bundle.scmd mem list


scmd mem removeStoppedRetryEntries

Removes entries that are in the stopped retry state.

Syntaxscmd [–p <current_password>] mem removeStoppedRetryEntries [–co<Customer_Order_ID> | <Customer_Order_Name> ] [–me<Metric_Evaluator_Identifier>]

DescriptionThe scmd mem removeStoppedRetryEntries command removes entries that are inthe stopped retry state.

Data is retrieved from the SLM Measurement Data Mart to be processed fortrending and evaluation. Data that is retrieved may not be available in the SLMMeasurement Data Mart at the time of the evaluation because the sourceapplication failed, or only reported a portion of the data.

To retain data that is stored in the SLM Measurement Data Mart after theevaluation time, a retry process runs periodically. An entry is added to this retrymechanism every time the retrieved data is not available. When this occurs, theentry goes into the active retry state. A fixed number of retries are executed for eachentry in the active retry state. After the configurable number of retries for aparticular entry is exhausted, this entry is removed from the active retry state andput in the stopped retry state. This CLI removes entries that are in the stopped retrystate.



–co <Customer_Order_ID> | <Customer_Order_Name>Specifies the customer order ID or customer order name associatedwith the data in the stopped retry state that is to be removed.

–me <Metric Evaluator_Identifier>Specifies the metric evaluator identifier associated with the data inthe stopped retry state that is to be removed.



If you are not getting data in your reports for a particular resource or customerorder, it is possible that some data may be lost if the source application failed orfor some other reason. To see if there is a source application reporting partial or nodata, try running the scmd mem showStoppedRetry command to show the entries


in the active retry state and the stopped retry state. Check the source applicationrelated to the customer order or resource and verify that it is reporting datacorrectly. If the source application eventually does report data into the SLMMeasurement Data Mart, you should run the scmd mem retryMissedIntervals –allcommand to force the evaluation and trend analysis to occur for all entries. If youare sure that the source application will never report this data, you can run thescmd mem removeStoppedRetryEntries command for that particular customerorder to remove entries in the stopped retry state.

Examples1. Remove entries in the stopped retry state for customer order ID 1005.

scmd mem removeStoppedRetryEntries -co 1005

The output of this command might look similar to the following:Evaluate operation time intervalscustomer order ID 1005Service element instance identifier 1028Metric Evaluator Instance Identifier 50:1028:97

customer order ID 1005Service element instance identifier 1028Metric Evaluator Instance Identifier 48:1028:97


Trend operation time intervals




2. Remove entries in the stopped retry state for customer order ID 1008 andmetric evaluator ID 48:1041:97.scmd mem removeStoppedRetryEntries -co 1008 -me 48:1041:97

The output of this command might look similar to the following:Evaluate operation time intervals




See Alsoscmd mem showStoppedRetry, scmd mem retryMissedIntervals


scmd mem retryMissedIntervals

Retries the trend or evaluation again for all time intervals in the retry state.

Syntaxscmd [–p <current_password>] mem retryMissedIntervals

DescriptionThe scmd mem retryMissedIntervals command retries the trend or evaluation forall time intervals in the retry state.


To retain data that is stored in the SLM Measurement Data Mart after theevaluation time, a retry process runs periodically. An entry is added to this retrymechanism every time the retrieved data is not available. When this occurs, theentry goes into the active retry state. A fixed number of retries are executed for eachentry in the active retry state. After the configurable number of retries for aparticular entry is exhausted, this entry is removed from the active retry state andput in the stopped retry state. This CLI retrieves data again for all entries in theretry, active, and stopped states.





If you are not getting data in your reports for a particular resource or customerorder, it is possible that some data may be lost if the source application failed orfor some other reason. To see if there is a source application reporting partial or nodata, try running the scmd mem showStoppedRetry command to show the entriesin the active retry state and the stopped retry state. Check the source applicationrelated to the customer order or resource and verify that it is reporting datacorrectly. If you are sure that the source application will never report this data, youcan run the scmd mem removeStoppedRetryEntries command for that particularcustomer order to remove entries in the stopped retry state.

After running this command, the trending for the Customer Orders in stoppedretry state may have unexpected behavior.


Examples1. Retry missed intervals that are still in the retry state.

scmd mem retryMissedIntervals

The output of this command might look similar to the following:Retry missed intervals that were still in retry state.Evaluate operation time intervals

Service element instance identifier 1043 Metric Evaluator Instance

Identifier 60:1043:1Service element instance identifier 1043 Metric Evaluator Instance

Identifier 63:1043:1Trend operation time intervals



Identifier 63:1043:1Retry missed intervals that retry operation had already stopped.Evaluate operation time intervals






Identifier 48:1041:97Trend operation time intervals






Identifier 48:1041:97

See Alsoscmd mem showStoppedRetry, scmd mem removeStoppedRetryEntries


scmd mem showAllOrderIDsDisplays all customer order IDs.

Syntaxscmd [–p <current_password>] mem showAllOrderIDs

DescriptionThe scmd mem showAllOrderIDs command displays all existing customer orderIDs.




ExamplesShow all customer order IDs.scmd mem showAllOrderIDs

The output will look similar to the following:customer order ID: 1004

customer order ID: 1003





scmd mem showMetricEvaluatorsDisplays information related to all instances of metric evaluators.

Syntaxscmd [–p <current_password>] mem showMetricEvaluators [–co<Customer_Order_ID> | <Customer_Order_Name>] [–v]

DescriptionThe scmd mem showMetricEvaluators command displays information related toeach metric evaluator, including the following:v Customer order IDv Service element instance IDv Component namev Description for each metric evaluator



–co <Customer_Order_ID> | <Customer_Order_Name>Specifies the customer order ID or customer order name to restrictthe scope of this CLI. It is an optional field.

–v If specified, the customer order names are displayed. It is anoptional field.


Examples1. Display a list of metric evaluators.

scmd mem showMetricEvaluators

The resulting output might look similar to the following:customer order ID 1005

Listing Metric Evaluators for Service Element InstanceID: 1028Metric Evaluator Instance Identifier 48:1028:97customer order ID 1005Resource Name /fvtsol17/slmfvt8 job3Component Identifier 48Evaluator Type EVAL_TYPE_A

Metric Evaluator Instance Identifier 50:1028:97customer order ID 1005Resource Name /fvtaix18.rtp.lab.tivoli.com/slmfvt9 job_name1Component Identifier 50Evaluator Type EVAL_TYPE_A

Listing Metric Evaluators for Service Element InstanceID: 1029


Metric Evaluator Instance Identifier 49:1029:97customer order ID 1005Resource Name /SLMFVT5.rtp.lab.tivoli.com/slmfvt5_sti playbackComponent Identifier 49Evaluator Type EVAL_TYPE_A

customer order ID 1008

Listing Metric Evaluators for Service Element InstanceID: 1041Metric Evaluator Instance Identifier 48:1041:97customer order ID 1008Resource Name /fvtsol17/slmfvt8 job3Component Identifier 48Evaluator Type EVAL_TYPE_A

Listing Metric Evaluators for Service Element InstanceID: 1042Metric Evaluator Instance Identifier 49:1042:97customer order ID 1008Resource Name /SLMFVT5.rtp.lab.tivoli.com/slmfvt5_sti playbackComponent Identifier 49Evaluator Type EVAL_TYPE_A

2. Display a list of metric evaluators for the Customer Order ID 1008scmd mem showMetricEvaluators -co 1008

The resulting output might look similar to the following:customer order ID 1008

Listing Metric Evaluators for Service Element InstanceID:1041Metric Evaluator Instance Identifier 48:1041:97customer order ID 1008Resource Name /fvtsol17/slmfvt8 job3Component Identifier 48Evaluator Type EVAL_TYPE_A

Listing Metric Evaluators for Service Element InstanceID:1042Metric Evaluator Instance Identifier 49:1042:97customer order ID 1008Resource Name /SLMFVT5.rtp.lab.tivoli.com/slmfvt5_sti playbackComponent Identifier 49Evaluator Type EVAL_TYPE_A


scmd mem showRetrys

Displays all entries that are in the stopped retry state and active retry state.

Syntaxscmd [–p <current_password>] mem showRetrys [–v]

DescriptionThe scmd mem showRetrys command displays entries that are in the stopped retrystate and the active retry state.


To retain data that is stored in the SLM Measurement Data Mart after theevaluation time, a retry process runs periodically. An entry is added to this retrymechanism every time the retrieved data is not available. When this occurs, theentry goes into the active retry state. A fixed number of retries are executed for eachentry in the active retry state. After the configurable number of retries for aparticular entry is exhausted, this entry is removed from the active retry state andput in the stopped retry state. This CLI shows all entries that are in the stoppedretry state.

It also shows entries in the active retry state. The entries in stopped retry state areshown above the separator line. The entries in active retry state are shown belowthe separator line.



–v If specified, the customer order names are displayed. It is anoptional field.



If you are not getting data in your reports for a particular resource or customerorder, it is possible that some data may be lost if the source application failed orfor some other reason. To see if there is a source application reporting partial or nodata, try running the scmd mem showRetrys command to show the entries in theactive retry state and the stopped retry state. Check the source application relatedto the customer order or resource and verify that it is reporting data correctly. Ifthe source application eventually does report data into the SLM Measurement Data


Mart, you should run the scmd mem retryMissedIntervals command to force theevaluation and trend analysis to occur for all entries. If you are sure that the sourceapplication will never report this data, you can run the scmd memremoveStoppedRetryEntries command for that particular customer order toremove entries in the stopped retry state.

ExamplesDisplay all entries that are in the stopped retry state.scmd mem showRetrys

The output of this command might look similar to the following:Evaluate operation time intervals

customer order ID 1005Service element instance identifier 1028Resource Name /fvtaix18.rtp.lab.tivoli.com/slmfvt9 job_name1Metric Evaluator Instance Identifier 50:1028:97

customer order ID 1005Service element instance identifier 1028Resource Name /fvtsol17/slmfvt8 job3Metric Evaluator Instance Identifier 48:1028:97

customer order ID 1005Service element instance identifier 1029Resource Name /SLMFVT5.rtp.lab.tivoli.com/slmfvt5_sti playbackMetric Evaluator Instance Identifier 49:1029:97

customer order ID 1008Service element instance identifier 1041Resource Name /fvtsol17/slmfvt8 job3Metric Evaluator Instance Identifier 48:1041:97

customer order ID 1008Service element instance identifier 1042Resource Name /SLMFVT5.rtp.lab.tivoli.com/slmfvt5_sti playbackMetric Evaluator Instance Identifier 49:1042:97Active retries of missed intervals

Evaluate operation time intervals

customer order ID 1008Service element instance identifier 1043Resource Name /dellxps32.ivt.rtp.lab.tivoli.com/Administrator/web_page_dl_times/

http://corp.tivoli.commMetric Evaluator Instance Identifier 63:1043:1


customer order ID 1008Service element instance identifier 1043Resource Name /dellxps32.ivt.rtp.lab.tivoli.com/Administrator/web_page_dl_times/

http://corp.tivoli.commMetric Evaluator Instance Identifier 63:1043:1

See Alsoscmd mem retryMissedIntervals, scmd mem removeStoppedRetryEntries


scmd mem trendingShows or sets the current list of trend interval values.

Syntaxscmd [ –p <current_password>] mem trending {view | set –warningPeriod<time_interval> –trendMethod {linear | exponential | all}}

DescriptionThe scmd mem trending command displays the current trend interval settings, orsets the individual algorithm to a particular trend interval.



view Displays the current list of trend interval values

set Sets the specified trend type to the specified interval. At least onetrend method must be specified with an associated warning period.

–warningPeriod <time_interval>The number of intervals in the future to determine if a trend exists.Setting this value to 0 will disable the specified algorithm

–trendMethod Specifies the specific trend type (linear, exponential, or all) toassociate with the given interval.


Examples1. Display the current trend interval values:

scmd mem trending view

The resulting output might look similar to the following example:Trend Method Warning Period

=========================================

Linear 2

Exponential 2

2. Set the trend interval count to 3 warning periods for the linear trend method:scmd mem trending set -warningPeriod 3 -trendMethod linear

Issuing another scmd mem trending view command results in the followingoutput:Trend Method Warning Period

=========================================

Linear 3

Exponential 2


Chapter 7. Order Manager Commands

This section describes the CLI commands you can use for the Order Managercomponent of IBM Tivoli Service Level Advisor, as shown in Table 8.

Table 8. CLI Commands for Order Manager


scmd om help 74

scmd om list 75

scmd om redeployCompletedCustomerOrders 76

scmd om submitCustomerOrder 78



scmd om helpDisplays command syntax and examples for the scmd om command bundle.

Syntaxscmd [–p <current_password>] om help

DescriptionThe scmd om help command displays the command syntax, variables, options,and examples for the scmd om command bundle.




Examples1. Display help for the om bundle.

scmd om help


scmd om listLists all available commands and options for the scmd om command bundle.

Syntaxscmd [–p <current_password>] om list

DescriptionThe scmd om list command lists all available commands and options for the scmdom command bundle.




ExamplesList all available commands in the scmd om command bundle.scmd om list

Chapter 7. Order Manager Commands 75

scmd om redeployCompletedCustomerOrdersScans the SLM Database for completed customer orders and redeploys them to theMetric Evaluator Manager component of IBM Tivoli Service Level Advisor.

Syntaxscmd [–p <current_password>] om redeployCompletedCustomerOrders

DescriptionThere may be a need to totally reload the Metric Evaluator Manager with all of thecustomer orders on which it should be reporting. For instance, the server runningthe Metric Evaluator Manager component might become inoperable and lose thelist of customer orders being handled by the Metric Evaluator Manager. Thiscommand enables you to recover from these situations.

The scmd om redeployCompletedCustomerOrders command scans the SLMDatabase for completed customer orders and redeploys them to the MetricEvaluator Manager component of IBM Tivoli Service Level Advisor. This commandenables you to recover data if Metric Evaluator Manager loses its persistent data.There is no harm done if the Metric Evaluator Manager has already deployed thesecustomer orders.




NotesThis command should only be issued by an SLM Administrator during errorrecovery.

ExamplesDue to increased usage, a larger server is needed for the IBM Tivoli Service LevelAdvisor software, but the server for the SLM Database is satisfactory. Afterinstalling and configuring the IBM Tivoli Service Level Advisor software on thelarger server, run the reDeployCompletedCustomerOrders command to re-load theMetric Evaluator Manager component with the customer orders that it should behandling.scmd om redeployCompletedCustomerOrders

The output of the scmd om redeployCompletedCustomerOrders command showsthe progress in processing each customer order as follows:DYKOM1057I Customer order processing started.DYKOM1035I Total number of customer orders read from the SLM Database: 5DYKOM1043I The number of customer orders to reprocess: 3

DYKMO1040I 1. preparing customer order: 1032DYKOM1033I 1. processing customer order: 1032


DYKOM1040I 2. preparing customer order: 1036DYKOM1033I 2. processing customer order: 1036

DYKOM1040I 3. preparing customer order: 1044DYKOM1033I 3. processing customer order: 1044DYKOM1050I Customer order processing completed.

The above sample output indicates that the SLM Database contains five customerorders, three of which were in the complete state. The preparing step involvesreading the customer order from the SLM Database and preparing it fordeployment to the Metric Evaluator Manager component. The processing stepinvolves sending the customer order to the Metric Evaluator Manager component.

Chapter 7. Order Manager Commands 77

scmd om submitCustomerOrderSubmits a customer order in the SLM Database to the Order Manager componentof IBM Tivoli Service Level Advisor.

Syntaxscmd [–p <current_password>] om submitCustomerOrder [<customer_order_ID> |<customer_order_name>

DescriptionOn occasion you may need to resubmit a customer order to the Order Managercomponent of IBM Tivoli Service Level Advisor, but the resubmission cannot beperformed using the IBM Console interface. The scmd om submitCustomerOrdercommand submits the specified customer order, regardless of its current state, tothe Order Manager.scmd om submitCustomerOrder <customer_order_ID>

scmd om submitCustomerOrder <customer_order_name>



<customer_order_ID>Specifies the numeric ID of the customer order. This customerorder must already exist in the SLM Database.

<customer_order_name>Specifies the order name of the customer order. This customerorder must already exist in the SLM Database.


NotesThis command should only be issued by an SLM Administrator during errorrecovery.

ExamplesA user creates order number 1046, but after submitting the order, for some reasonit does not get sent to the Order Manager for processing. Instead the order remainsheld in the submitted state. The administrator can send this order manually withthe following command:scmd om submitCustomerOrder 1046

The following example shows sample output.DYKOM1045I The OM command line has successfully submitted thiscustomer order 1046 to Order Manager.


Chapter 8. Remote Communication Commands

This section describes the CLI commands you can use for remote communication,as shown in Table 9.

Table 9. CLI Commands for Remote Communication


scmd rcc getPort 80

scmd rcc help 81

scmd rcc list 82

scmd rcc setPort 83



scmd rcc getPortLists the port currently used for remote communication with this server.

Syntaxscmd [–p <current_password>] rcc getPort

DescriptionThe scmd rcc getPort command lists the port currently used for remotecommunication with this server. Changing the port requires a restart of the serverfor the new port to be enabled. If the port has been changed, but the server hasnot yet been restarted then both the current and future values are displayed.



AuthorizationNo authorization is required.

ExamplesList the current port.scmd rcc getPort

The resulting output will look similar to the following:DYKAL9056I Current port: 9980

See Alsoscmd rcc setPort, rcomutil


scmd rcc helpDisplays command syntax and examples for the scmd rcc command bundle.

Syntaxscmd [–p <current_password>] rcc help

DescriptionThe scmd rcc help command displays the command syntax, variables, options, andexamples for the scmd rcc command bundle.




Examples1. Display help for the rcc bundle.

scmd rcc help

Chapter 8. Remote Communication Commands 81

scmd rcc listLists all available commands and options for the scmd rcc command bundle.

Syntaxscmd [–p <current_password>] rcc list

DescriptionThe scmd rcc list command lists all available commands and options for the scmdrcc command bundle.




ExamplesList all available commands in the scmd rcc command bundle.scmd rcc list


scmd rcc setPortSets the port number to be used for remote communication with this server.

Syntaxscmd [–p <current_password>] rcc setPort <port>

DescriptionThe scmd rcc setPort command sets the port number to be used for remotecommunication with this server. The server must be restarted for the new port tobe enabled.



<port> Specifies the port number to be used for remote communication.


ExamplesChange the port for remote communication to 9981.scmd rcc setPort 9981

The port is set to the new number, and you receive the following response:DYKAL0066I The remote communication port was updated successfully.The server must be restarted before the new value can be used.

See Alsoscmd rcc getPort, rcomutil

Chapter 8. Remote Communication Commands 83


Chapter 9. Scheduler Commands

This section describes the CLI commands you can use for configuring thescheduler component of IBM Tivoli Service Level Advisor, as shown in Table 10.

Table 10. CLI Commands for Scheduler


scmd scheduler help 86

scmd scheduler list 87

scmd scheduler listSettings 88

scmd scheduler setMaxEvaluationThreads 89

scmd scheduler setMaxTimeForForcedScheduling 90



scmd scheduler helpDisplays command syntax and examples for the scmd scheduler command bundle.

Syntaxscmd [–p <current_password>] scheduler help

DescriptionThe scmd scheduler help command displays the command syntax, variables,options, and examples for the scmd scheduler command bundle.




Examples1. Display help for the scheduler bundle.

scmd scheduler help


scmd scheduler listLists all available commands and options for the scmd scheduler commandbundle.

Syntaxscmd [–p <current_password>] scheduler list

DescriptionThe scmd scheduler list command lists all available commands and options for thescmd scheduler command bundle.




ExamplesList all available commands in the scmd scheduler command bundle.scmd scheduler list

Chapter 9. Scheduler Commands 87

scmd scheduler listSettingsLists the current state of the scheduler settings.

Syntaxscmd [–p <current_password>] scheduler listSettings

DescriptionThe scmd scheduler listSettings command lists the current configurationparameters that are set for the schedule. The maximum number of threads used formetric evaluation and the maximum time in hours for scheduling activities tocomplete are displayed.




Examples1. Display the current settings for the scheduler.

scmd scheduler listSettings

The output will look similar to the following:Max Evaluation Threads = 2

Maximum time in hours for forced Scheduling requests = 5

See Alsoscmd scheduler setMaxEvaluationThreads, scmd schedulersetMaxTimeForForcedScheduling


scmd scheduler setMaxEvaluationThreadsSets the maximum number of threads that the scheduler can use for metricevaluation tasks.

Syntaxscmd [ –p <current_password>] scheduler setMaxEvaluationThreads<number_of_threads>

DescriptionThe scmd scheduler setMaxEvaluationThreads command sets the maximumnumber of threads the scheduler can use for metric evaluation tasks. On a machinewith multiple processors, the number of threads used for evaluation tasks can beincreased for better performance. This number should be set to at least twice thenumber of processors available.




ExamplesSet the maximum number of threads to 3scmd scheduler setMaxEvaluationThreads 3

See Alsoscmd scheduler listSettings

Chapter 9. Scheduler Commands 89

scmd scheduler setMaxTimeForForcedSchedulingSets the maximum time for completion of any forced scheduling request.

Syntaxscmd [–p <current_password>] scheduler setMaxTimeForForcedScheduling<number_of_hours>

DescriptionThe scmd scheduler setMaxTimeForForcedScheduling command sets themaximum time, in hours, allowed for any forced scheduling request to complete itsprocessing. All metric evaluations are initiated by a single forced evaluation taskshortly after the Process ETL completes, and the evaluation task must becompleted by the maximum time set by this command. This is useful forcoordinating the evaluation processing time with the frequency of running theProcess ETL.




ExamplesSet the maximum amount of time allowed for forced evaluations to complete theirprocessing to 5 hours:scmd scheduler setMaxTimeForForcedScheduling 5

See Alsoscmd scheduler listSettings


Chapter 10. SLM Database Commands

This section describes the CLI commands related to the data in the SLM Databasecomponent of IBM Tivoli Service Level Advisor, as shown in Table 11.

Table 11. CLI Commands for the SLM Database Commands


scmd sdc adjustIDGenerator 92

scmd sdc displayActiveServiceElements 93

scmd sdc displayAllCustomerOrders 94

scmd sdc displayAllCustomers 96

scmd sdc displayAllRealms 97

scmd sdc displayAllSchedules 98

scmd sdc displayAllServiceOfferings 99

scmd sdc displayBaseCustomerOrders 102

scmd sdc displayBusinessSchedules 104

scmd sdc displayCustomerByID 106

scmd sdc displayCustomerFromOrderID 107

scmd sdc displayCustomerOrderByID 108

scmd sdc displayCustomerOrderState 109

scmd sdc displayDataCollectorType 110

scmd sdc displayMilestoneSchedules 111

scmd sdc displayOfferingElementList 112

scmd sdc displayOfferingScheduleName 113

scmd sdc displayOfferingState 114

scmd sdc displayOrderMetricPropertyID 115

scmd sdc displayScheduleByName 116

scmd sdc displayServiceOfferingByID 117

scmd sdc displayServiceOfferingID 119

scmd sdc displayServiceOfferingName 120

scmd sdc displayServiceOfferingsByState 121

scmd sdc getAssociatedCustomerOrderID 122

scmd sdc help 123

scmd sdc list 124

scmd sdc registerWarehouseData 125



scmd sdc adjustIDGeneratorAdjusts the ID generator mechanism.

Syntaxscmd [–p <current_password>] sdc adjustIDGenerator

DescriptionEvery business object, such as customer, or customer order, is identified by aunique ID. This ID is constructed based on a table called ID_GENERATOR, whichhas a record for each business object. If a record is accidentally deleted, thecreation of the business object might fail, because the same ID might be used morethan once. You can use the scmd sdc adjustIDGenerator command to adjust orcreate the records in the ID_GENERATOR table.




NotesYou should only use this command when instructed to by Tivoli CustomerSupport.

ExamplesAdjust all of the ID generator records in the ID_GENERATOR table.scmd sdc adjustIDGenerator

See AlsoNone.


scmd sdc displayActiveServiceElementsDisplays all active service elements.

Syntaxscmd [–p <current_password>] sdc displayActiveServiceElements

DescriptionThe scmd sdc displayActiveServiceElements command displays all active serviceelements.




NotesThis command potentially displays a large amount of information.

ExamplesDisplay the active service elements.scmd sdc displayActiveServiceElements

See AlsoNone.

Chapter 10. SLM Database Commands 93

scmd sdc displayAllCustomerOrdersDisplays the information on all customer orders.

Syntaxscmd [–p <current_password>] sdc displayAllCustomerOrders

DescriptionThe scmd sdc displayAllCustomerOrders command displays the attributes of allcustomer orders.




ExamplesDisplay the attributes of all customer orders.scmd sdc displayAllCustomerOrders

For each order, the output will be displayed similar to the following:Number of Customer Orders=9Customer order ID: 1000State: CompleteOriginal order ID: nullName: Storage Availability for WindowsDescription: nullAction: ACTION_DEPLOYRemarks: nullStart Time: nullEnd Time: nullLast Modified: March 17, 2003 3:47:24 PM ESTService consumer

ID: 1004Name: IBM Strategic Outsourcing InfrastructureDescription: nullReport file location: nullLocale: en_USNumber of realms: 0

OfferingID: 1000Name: Storage Availability WINDOWSDescription: Ensures Availability of WINDOWS Data Storage for dependent

Systems like SAP and DB2State: PublishedLocale: en_USSchedule name: nullType: TYPE_INTERNALRelated offering: nullStart Time: nullEnd Time: nullLast Modified: null


See AlsoNone.


scmd sdc displayAllCustomers

Displays the customer information of all customers.

Syntaxscmd [–p <current_password>] sdc displayAllCustomers

DescriptionThe scmd sdc displayAllCustomers command displays the customer informationof all customers.




ExamplesDisplay the customer information of all customers.scmd sdc displayAllCustomers

For each customer, the output will be displayed similar to the following:Service consumer

ID: 1001Name: IBM AccountingDescription: IBM Accounting DepartementReport file location: nullLocale: en_USNumber of realms: 2

Realm:ID: 1001Name: IBM Strategic OutsourcingDescription: IBM Strategic Outsourcing

Realm:ID: 1003Name: IBM HQDescription: IBM HeadQuarters Central Operations

See AlsoNone.


scmd sdc displayAllRealms

Displays the realm information for all realms.

Syntaxscmd [–p <current_password>] sdc displayAllRealms

DescriptionDisplays the realm information for all realms.




ExamplesDisplay the realm information for all realms.scmd sdc displayAllRealms

The output will be displayed similar to the following:Number of Realms=3Realm:

ID: 1001Name: IBM Strategic OutsourcingDescription: IBM Strategic Outsourcing

Realm:ID: 1002Name: IBM Software GroupDescription: IBM Software Group Divisions

Realm:ID: 1003Name: IBM HQDescription: IBM HeadQuarters Central Operations

See AlsoNone.


scmd sdc displayAllSchedulesDisplays all business schedules and milestone schedules.

Syntaxscmd [–p <current_password>] sdc displayAllSchedules

DescriptionThe scmd sdc displayAllSchedules command displays all business schedules thatare also displayed by the scmd sdc displayBusinessSchedules command, and allmilestone schedules that are displayed by the scmd sdcdisplayMilestoneSchedules command.




ExamplesDisplay all business schedules and milestone schedules.scmd sdc displayAllSchedules

The output will be displayed similar to the following:ID: 1042Name: 1042Description: nullGlobal: falseSchedule milestone:

Schedule state: nullAction: EVALUATEInterval: 134217534Timeout: -1Exclusive: falseTime zone: nullRepeated date

Date formula: -1Schedule milestone:

Schedule state: nullAction: TRENDInterval: 134217534Timeout: -1Exclusive: falseTime zone: nullRepeated date

Date formula: -1

See Alsoscmd sdc displayBusinessSchedules, scmd sdc displayMilestoneSchedules


scmd sdc displayAllServiceOfferingsDisplays all service offerings.

Syntaxscmd [–p <current_password>] sdc displayAllServiceOfferings

DescriptionThe scmd sdc displayAllServiceOfferings command displays all service offerings.




ExamplesDisplay all service offerings.scmd sdc displayAllServiceOfferings

The resulting output is displayed similar to the following:ID: 1007Name: Database OperationsDescription: Ensures Operation of Databases on Distr. and z/OS SystemsState: PublishedLocale: en_USSchedule name: 7 x 24Type: TYPE_INTERNALRelated offering: nullStart Time: nullEnd Time: nullLast Modified: March 17, 2003 3:47:57 PM ESTOffering class: nullThere are 5 service elements in the service offeringService element #0

Service element:Service element ID: 1036SEM ID: 1000Instance ID: 1015Original instance ID: nullName: DB2 Database AvailabilityDescription: Monitors Database Availability of DB2State: ActiveScope version: nullHuman interaction requiredfalseResponsibility: nullOriginal order element instance ID: nullOffering element instance ID: 1015Order element instance ID: nullStatus: STATUS_BUSYClass name:null

Service element #1Service element:

Service element ID: 1034SEM ID: 1000


Instance ID: 1016Original instance ID: nullName: DB2 Database PerformanceDescription: Monitors Database Performance of DB2State: ActiveScope version: nullHuman interaction requiredfalseResponsibility: nullOriginal order element instance ID: nullOffering element instance ID: 1016Order element instance ID: nullStatus: STATUS_BUSYClass name:null


Service element ID: 1040SEM ID: 1000Instance ID: 1017Original instance ID: nullName: DB2 Database Resource AvailabilityDescription: Monitors Database Tablespace Usage and DB2 Avail.State: ActiveScope version: nullHuman interaction requiredfalseResponsibility: nullOriginal order element instance ID: nullOffering element instance ID: 1017Order element instance ID: nullStatus: STATUS_BUSYClass name:null


Service element ID: 1050SEM ID: 1000Instance ID: 1018Original instance ID: nullName: z/OS DB2 PerformanceDescription: Monitors Perf. of DB2 (z/OS) Buffer PoolsState: ActiveScope version: nullHuman interaction requiredfalseResponsibility: nullOriginal order element instance ID: nullOffering element instance ID: 1018Order element instance ID: nullStatus: STATUS_BUSYClass name:null


Service element ID: 1053SEM ID: 1000Instance ID: 1019Original instance ID: nullName: z/OS DB2 UsageDescription: Monitors Usage/Perf. of DB2 z/OS MVS SubsystemState: ActiveScope version: nullHuman interaction requiredfalseResponsibility: nullOriginal order element instance ID: nullOffering element instance ID: 1019Order element instance ID: nullStatus: STATUS_BUSYClass name:null

Number of SLAs in offering (if tiered): 210001001


See AlsoNone.


scmd sdc displayBaseCustomerOrdersDisplays all base customer orders.

Syntaxscmd [–p <current_password>] sdc displayBaseCustomerOrders

DescriptionThe scmd sdc displayBaseCustomerOrders displays all base customer orders. Abase customer order is a customer order that is not associated with any othercustomer order, such as a change order or a cancel order.




ExamplesDisplay all base customer orders.scmd sdc displayBaseCustomerOrders

For each order, the resulting output is displayed similar to the following:Customer order ID: 1000State: CompleteOriginal order ID: nullName: Storage Availability for WindowsDescription: nullAction: ACTION_DEPLOYRemarks: nullStart Time: nullEnd Time: nullLast Modified: March 17, 2003 3:47:24 PM ESTService consumer

ID: 1004Name: IBM Strategic Outsourcing InfrastructureDescription: nullReport file location: nullLocale: en_USNumber of realms: 0

OfferingID: 1000Name: Storage Availability WINDOWSDescription: Ensures Availability of WINDOWS Data Storage for dependent

Systems like SAP and DB2State: PublishedLocale: en_USSchedule name: nullType: TYPE_INTERNALRelated offering: nullStart Time: nullEnd Time: nullLast Modified: null


See AlsoNone.


scmd sdc displayBusinessSchedulesDisplays all business schedules.

Syntaxscmd [–p <current_password>] sdc displayBusinessSchedules

DescriptionThe scmd sdc displayBusinessSchedules command displays all businessschedules. A business schedule is a schedule that has an associated scheduleperiod.




ExamplesDisplay all business schedules.scmd sdc displayBusinessSchedules

The resulting output is displayed similar to the following:ID: 1002Name: Office Hours ServiceDescription: 0800-1800 Prime Time ServiceGlobal: falseSchedule states:

PrimeLow ImpactNo Service

Schedule period:Schedule state: PrimeTime zone: Europe/BerlinStart Time: 28800000End Time: 64800000Repeated date

Date formula: 66060094 Hex: 3efff3eSchedule period:

Schedule state: No ServiceTime zone: Europe/BerlinStart Time: 0End Time: 86400000Repeated date

Date formula: 68157246 Hex: 40fff3eSchedule period:

Schedule state: Low ImpactTime zone: GMTStart Time: 0End Time: 86399999Repeated date

Date formula: 134217534 Hex: 7ffff3e

Associated schedules:ID: 1001


Name: Public Holidays 2003Description: Public Holidays 2003 in Germany (selection)Global: true

Last Modified: null

See Alsoscmd sdc displayAllSchedules, scmd sdc displayMilestoneSchedules


scmd sdc displayCustomerByIDDisplays the customer information associated with a customer ID.

Syntaxscmd [–p <current_password>] sdc displayCustomerByID <customerID>

DescriptionThe scmd sdc displayCustomerByID command displays the customer informationassociated with the specified customer ID.



<customerID>Specifies the ID of the customer.


ExamplesDisplay the customer information for the customer whose ID is 1000.scmd sdc displayCustomerByID 1000

The output is displayed similar to the following:Service consumer

ID: 1000Name: Deutsche BankDescription: Deutsche Bank IT ServicesReport file location: nullLocale: en_USNumber of realms: 2

Realm:ID: 1000Name: Deutsche BankDescription: IBM Strategic Outsourcing Customer


See AlsoNone.


scmd sdc displayCustomerFromOrderID

Displays the customer information associated with a customer order.

Syntaxscmd [–p <current_password>] sdc displayCustomerFromOrderID<customerOrderID>

DescriptionThe scmd sdc displayCustomerFromOrderID command displays the customerinformation associated with the specified customer order.



<customerOrderID>Specifies the ID of the customer order.


ExamplesDisplay the customer information associated with customer order 1000.scmd sdc displayCustomerFromOrderID 1000

The output is displayed similar to the following:Service consumer

ID: 1004Name: IBM Strategic Outsourcing InfrastructureDescription: IBM Strategic Outsourcing HW InfrastructureReport file location: nullLocale: en_USNumber of realms: 1


See AlsoNone.


scmd sdc displayCustomerOrderByIDDisplays information about the customer order associated with the specifiedcustomer order ID.

Syntaxscmd [–p <current_password>] sdc displayCustomerOrderByID <customerOrderID>

DescriptionThe scmd sdc displayCustomerOrderByID command displays information aboutthe customer order associated with the specified customer order ID.



<customerOrderID>Specifies the order ID of the customer order.


NotesThis command may display a large amount of information.

ExamplesDisplay information about the customer order associated with customer order ID101.scmd sdc displayCustomerOrderByID 101

See AlsoNone.


scmd sdc displayCustomerOrderStateDisplays the state of a customer order.

Syntaxscmd [–p <current_password>] sdc displayCustomerOrderState <customerOrderID>

DescriptionThe scmd sdc displayCustomerOrderState command displays the state of thecustomer order associated with the specified customer order ID.



<customerOrderID>Specifies the order ID of the customer order.


ExamplesDisplay the state of the customer order 101.scmd sdc displayCustomerOrderState 101

The output is displayed similar to the following:Completed

See AlsoNone.


scmd sdc displayDataCollectorTypeDisplays the data collector type of a service element manager.

Syntaxscmd [–p <current_password>] sdc displayDataCollectorType<serviceElementManagerID>

DescriptionThe scmd sdc displayDataCollectorType command displays the data collector typeof the specified service element manager.



<serviceElementManagerID>Specifies the ID of the service element manager.


ExamplesDisplay the data collector type of the service element manager with an ID of 101.scmd sdc displayDataCollectorType 101

The output is displayed similar to the following:com.tivoli.managed.dc.twh.TWHDataCollector

See AlsoNone.


scmd sdc displayMilestoneSchedulesDisplays all milestone schedules.

Syntaxscmd [–p <current_password>] sdc displayMilestoneSchedules

DescriptionThe scmd sdc displayMilestoneSchedules command displays all milestoneschedules. A milestone schedule is an internal schedule that is created by IBMTivoli Service Level Advisor when a schedule is associated with a service offering.




ExamplesDisplay all milestone schedules.scmd sdc displayMilestoneSchedules

For each milestone schedule, the output is displayed similar to the following:ID: 1039Name: 1039Description: nullGlobal: falseSchedule milestone:




Date formula: -1

See Alsoscmd sdc displayAllSchedules, scmd sdc displayBusinessSchedules


scmd sdc displayOfferingElementListDisplays all offering elements associated with a service offering.

Syntaxscmd [–p <current_password>] sdc displayOfferingElementList <offeringID>

DescriptionThe scmd sdc displayOfferingElementList command displays all offering elementsassociated with the specified service offering.



<offeringID> Specifies the ID of the service offering.


ExamplesDisplay the offering elements associated with the service offering with an ID of101.scmd sdc displayOfferingElementList 101

See AlsoNone.


scmd sdc displayOfferingScheduleNameDisplays the name of the schedule associated with a service offering.

Syntaxscmd [–p <current_password>] sdc displayOfferingScheduleName <offeringID>

DescriptionThe scmd sdc displayOfferingScheduleName command displays the name of theschedule associated with the specified service offering ID.





ExamplesDisplay the name of the schedule associated with service offering 101.scmd sdc displayOfferingScheduleName 101

The output is the name of the schedule, and is displayed similar to the following:Office Hours Service Schedule

See AlsoNone.


scmd sdc displayOfferingStateDisplays the state of a service offering.

Syntaxscmd [–p <current_password>] sdc displayOfferingState <offeringID>

DescriptionThe scmd sdc displayOfferingState command displays the state of the specifiedservice offering.





ExamplesDisplay the state for service offering 101.scmd sdc displayOfferingState 101

The output is displayed similar to the following:Published

See AlsoNone.


scmd sdc displayOrderMetricPropertyIDDisplays the property ID of a metric defined in an order element.

Syntaxscmd [–p <current_password>] sdc displayOrderMetricPropertyID <metricName><orderElementID>

DescriptionThe scmd sdc displayOrderMetricPropertyID displays the property ID of thespecified metric name defined in the specified order element.



<metricName> Specifies the name of the metric.

<orderElementID>Specifies the ID of the order element.


ExamplesDisplay the property ID for the metric TOTAL_RESPONSE_TI ME in the orderelement 101.scmd sdc displayOrderMetricPropertyID TOTAL_RESPONSE_TIME 101

See AlsoNone.


scmd sdc displayScheduleByNameDisplays the contents of a schedule.

Syntaxscmd [–p <current_password>] sdc displayScheduleByName <scheduleName>

DescriptionThe scmd sdc displayScheduleByName command displays the scheduleinformation for the specified schedule.



<scheduleName>Specifies the name of the schedule.


ExamplesDisplay the information for the schedule named MySchedule.scmd sdc displayScheduleByName MySchedule

The output is displayed similar to the following:ID: MyScheduleName: MyScheduleDescription: nullGlobal: falseSchedule milestone:




Date formula: -1

See AlsoNone.


scmd sdc displayServiceOfferingByIDDisplays the contents of a service offering.

Syntaxscmd [–p <current_password>] sdc displayServiceOfferingByID <offeringID>

DescriptionThe scmd sdc displayServiceOfferingByID displays the contents of the specifiedservice offering.





ExamplesDisplay the information for service offering 1001.scmd sdc displayServiceOfferingByID 1001

The output is displayed similar to the following:ID: 1001Name: Storage Availability UNIXDescription: Ensures Availability of UNIX Data Storage for dependent Systems like SAP and DB2State: PublishedLocale: en_USSchedule name: 7 x 24Type: TYPE_INTERNALRelated offering: nullStart Time: nullEnd Time: nullLast Modified: March 17, 2003 3:47:04 PM ESTOffering class: nullThere are 1 service elements in the service offeringService element #0

Service element:Service element ID: 1008SEM ID: 1000Instance ID: 1001Original instance ID: nullName: Storage Availability UNIXDescription: Ensures Availability of UNIX Data StorageState: ActiveScope version: nullHuman interaction requiredfalseResponsibility: nullOriginal order element instance ID: nullOffering element instance ID: 1001


Order element instance ID: nullStatus: STATUS_BUSYClass name:null

Number of SLAs in offering (if tiered): 0

See AlsoNone.


scmd sdc displayServiceOfferingIDDisplays the service offering ID associated with a customer order.

Syntaxscmd [–p <current_password>] sdc displayServiceOfferingID <customerOrderID>

DescriptionThe scmd sdc displayServiceOfferingID displays the service offering ID associatedwith the customer order specified by <customerOrderID>.





ExamplesDisplay the service offering ID of customer order 101.scmd sdc displayServiceOfferingID 101


scmd sdc displayServiceOfferingName

Displays the name of the service offering associated with a customer order.

Syntaxscmd [–p <current_password>] sdc displayServiceOfferingName <customerOrderID>

DescriptionThe scmd sdc displayServiceOfferingName displays the name of the serviceoffering associated with the specified customer order.





ExamplesDisplay the name of the service offering associated with customer order 101.scmd sdc displayServiceOfferingName 101

The output is the name of the service offering, displayed similar to the following:Storage Availability UNIX

See AlsoNone.


scmd sdc displayServiceOfferingsByStateDisplays all service offerings in a particular state specified by the user.

Syntaxscmd [–p <current_password>] sdc displayServiceOfferingsByState <state>

DescriptionThe scmd sdc displayServiceOfferingsByState command displays a list of serviceofferings in the database that are currently at a particular state that you specify.Valid states you can specify include published, draft, obsolete, or active.



<state> Specifies the service offering state for which you want to listservice offerings.


ExamplesDisplay the list of service offerings that are currently in the active state.scmd sdc displayServiceOfferingsByState active

See AlsoNone.


scmd sdc getAssociatedCustomerOrderIDGets the customer order ID associated with a cancel or change customer order ID.

Syntaxscmd [–p <current_password>] sdc getAssociatedCustomerOrderID<customer_order_ID>

DescriptionThe scmd sdc getAssociatedCustomerOrderID command gets the originalcustomer order ID associated with the specified cancel or change customer orderID.





Return ValuesThe scmd sdc getAssociatedCustomerOrderID returns one of the following values:v The original customer order ID associated with the specified customer order ID.v If an original customer order ID was not found for the specified customer order

ID, an error message is returned.

ExamplesDisplay the original customer order ID associated with customer order ID 101.scmd sdc getAssociatedCustomerOrderID 101

See AlsoNone.


scmd sdc helpDisplays the command syntax and examples for the scmd sdc command bundle.

Syntaxscmd [–p <current_password>] sdc help

DescriptionThe scmd sdc help command displays the command syntax and examples for thesdc command bundle.




ExamplesDisplay help for the sdc bundle name.scmd sdc help

See AlsoNone.


scmd sdc listLists available commands and options for the scmd sdc command bundle.

Syntaxscmd [–p <current_password>] sdc list

DescriptionThe scmd sdc list command lists all available commands and options for the sdccommand bundle.




ExamplesList all available scmd sdc commands.scmd sdc list

See AlsoNone.


scmd sdc registerWarehouseDataRegisters warehouse data into the SLM Server for use in creating offerings.

Syntaxscmd [–p <current_password>] sdc registerWarehouseData

DescriptionWhen the Registration ETL is run, data is moved from the Tivoli Enterprise DataWarehouse database (also referred to as the central data warehouse) to the SLMDatabase. The scmd sdc registerWarehouseData command registers this data intothe SLM Server for use in creating offerings and orders. The Registration ETLprocess must have successfully completed moving the data into the SLM Databasebefore issuing this command.

Note: The SLM Server automatically examines the SLM Database every tenminutes and registers any new data received from the Tivoli Enterprise DataWarehouse database as needed. Because this data is regularly registered aspart of the normal process, you should only use the scmd sdcregisterWarehouseData command when you do not want to wait for thenext automatic check.




ExamplesRegister warehouse data for use in building offerings.scmd sdc registerWarehouseData

See AlsoNone.



Chapter 11. Web Report User Commands

This section describes the CLI commands you can use for adding, deleting,changing, and listing information about users who log in to customer web sites toview reports. The available commands are shown in Table 12.

Table 12. CLI Commands for authenticating users of SLM Reports


scmd sla addUser 128

scmd sla changeUser 131

scmd sla deleteUser 133

scmd sla help 134

scmd sla list 135

scmd sla listUser 136



scmd sla addUserCreates a user account with the specified attributes in the database.

Syntaxscmd [–p <current_password>] sla addUser –name <name> [–password <password>]–view {1 | 2 | 3} [–consumer <consumer>] [–realm <realm>] [–page <page>][–userType {1 | 2 | 3}]

DescriptionThe scmd sla addUser command creates a user account with the specifiedattributes in the database. With this command you can do the following:v Assign the user namev Optionally specify a signon password, or let the system generate one for youv Specify the authentication privilege of this user, enabling the user to view

reports unrestricted, or limit the user to view only reports for specific consumername (customer) and realm ID

v Limit the view of the user to data classified as external and prevent the userfrom viewing data reserved for internal use only.

v Specify the initial portal page to which the user will be sent after successfullylogging in to the customer’s web site.

v Specify a user type for report users, to authorize this user name to view reportsfrom the perspective of an executive overview level, from the customer’sperspective, or from the operations personnel perspective.



–name <name>Specifies the user ID. The user ID is required for a user to log in tothe application.

Note: At installation time, three default user IDs are createdautomatically for use in viewing reports: customer,executive, and operations.

–password <password>Optionally specifies the password that the user must enter to login. If left unspecified, a password will be generated and passedback to you.

Note: Do not use double-byte characters in the password.

–view {1 | 2 | 3}Specifies the privilege of the user. The parameter specified is aninteger value of 1, 2, or 3, defined as follows:

View Privilege Explanation

1 Unrestricted An unrestricted user canview all reports.



2 Restricted A restricted user can viewonly reports of the specifiedconsumer name and realmID

3 External An external user can viewonly reports of the specifiedconsumer name and realmID. The user is only allowedto view data with anisInternal value of falsewithin the restricted data.

–consumer <consumer>Specifies the customer name whose data the user will be permittedto view in reports. This name must be already defined.

–realm <realm>Specified the ID of the realm whose data the user will be permittedto view in reports. This ID must be already defined.

–page <page> Specifies the initial portal page that is to be displayed after theuser successfully signs on to the web site to view reports. If aportal page is not specified at the time of user creation, this valueis set to report.jsp.

–userType {1 | 2 | 3}Specifies the type of user for viewing reports. The parameterspecified is an integer value of 1, 2, or 3, defined as follows:

User Type User Explanation

1 Operations This user type can view detailed reports from a day today operations personnel perspective. This is thedefault type if the userType is not specified.

2 Executive This user type can view high level executive summaryreports.

3 Customer This user type can view moderately detailed reportsfrom a customer point of view.

The userType specification determines the level of detail that isshown in certain reports, with executive user types seeing more ofan overview level, while customer and operations types will seemore detailed reports.


Examples1. Create an unrestricted user named Jennell with a user type of executive.

scmd sla addUser -name Jennell -view 1 -userType 2

Because no password was specified, a password is generated and passed backto you for this user. Because no portal page was specified, the report.jsp portalpage will be initially displayed when this login successfully completes.

Chapter 11. Web Report User Commands 129

2. Create an external user with operations user type named Martha, with access toRealm ID = 12345.scmd sla addUser -name Martha -view 3 -realm 12345 -userType 1

Because no password was specified, a password is generated and passed backto you for this user. Because a Realm ID was specified but not a consumer, thisuser can view any consumer data within the specified realm ID. Because noportal page was specified, the report.jsp portal page will be first displayed whenthis login successfully completes.

3. Create a restricted user named David, with a signon password of pass1, withaccess to consumer name ABC and configured to display a report page namedEastCoast.jsp.scmd sla addUser -name David -password pass1 -view 2 -consumer ABC

-page EastCoast.jsp

Because a consumer name was specified but not a realm ID, this user can viewany data for this consumer across one or more realms. This user isautomatically assigned a user type of operations.

See Alsoscmd sla changeUser, scmd sla deleteUser, scmd sla listUser


scmd sla changeUserChanges the user account information in the database.

Syntaxscmd [–p <current_password>] sla changeUser –name <name> [–password<password>] [–view {1 | 2 | 3}] [–consumer <consumer>] [–realm <realm>] [–page<page>] [–userType {1 | 2 | 3}]

DescriptionThe scmd sla changeUser command enables you to modify user authenticationinformation in the database. With this command you can do the following:v Change the authentication privilege of this user, enabling the user to view

reports unrestricted, or limit the user to view only reports for specific consumername (customer) and realm ID

v Change the authorization of the user to view data classified as external orinternal use only.

v Change the portal page to which the user will be sent after successfully logging into the customer’s web site.

v Change the user type for report users, to authorize this user name to view reportsfrom the perspective of an executive overview level, from the customer’sperspective, or from the operations personnel perspective.



–name <name>Specifies the user ID. The user ID is required for a user to log in tothe application.

–password <password>Specifies the current password that the user must enter to log in.

–view {1 | 2 | 3}Specifies the privilege of the user. The parameter specified is aninteger value of 1, 2, or 3, defined as follows:


1 Unrestricted An unrestricted user canview all reports.

2 Restricted A restricted user can viewonly reports of the specifiedconsumer name and realmID

3 External An external user can viewonly reports of the specifiedconsumer name and realmID. The user is only allowedto view data with anisInternal value of falsewithin the restricted data.


–consumer <consumer>Specifies the customer name whose data the user will be permittedto view in reports. This name must be already defined.

–realm <realm>Specified the ID of the realm whose data the user will be permittedto view in reports. This ID must be already defined.

–page <page> Specifies the initial portal page that is to be displayed after theuser successfully signs on to the web site to view reports. If aportal page is not specified at the time of user creation, this valueis set to report.jsp.

–userType {1 | 2 | 3}Specifies the type of user for viewing reports. The parameterspecified is an integer value of 1, 2, or 3, defined as follows:

User Type User Explanation

1 Operations This user type can view detailed reports from a day today operations personnel perspective. This is thedefault type if the userType is not specified.

2 Executive This user type can view high level executive summaryreports.

3 Customer This user type can view moderately detailed reportsfrom a customer point of view.


NotesFor report access security reasons, after changing user access to a more restrictedlevel or deleting the user, the changes will not be in effect for users currentlylogged into the system until the next time they login.

Examples1. Change the unrestricted user Jennell to an external user with authority to view

reports on consumer name Tivoli.scmd sla changeUser -name Jennell -view 3 -consumer Tivoli

2. Change an external user Martha to an unrestricted user.scmd sla changeUser -name Martha -view 1

3. Change the user type for user Fred to customer.scmd sla changeUser -name Fred -view 1 -userType 3

See Alsoscmd sla addUser, scmd sla deleteUser, scmd sla listUser


scmd sla deleteUserDeletes the specified user from the database.

Syntaxscmd [–p <current_password>] sla deleteUser –name <name>

DescriptionThe scmd sla deleteUser command deletes the specified user from the database.



–name <name>Specifies the user ID to be deleted.


NotesFor report access security reasons, after changing user access to a more restrictedlevel or deleting the user, the changes will not be in effect for users currentlylogged into the system until the next time they login.

Examples1. Delete the user Hiroko from the database.

scmd sla deleteUser -name Hiroko

See Alsoscmd sla addUser, scmd sla changeUser, scmd sla listUser


scmd sla helpDisplays command syntax and examples for the scmd sla command bundle.

Syntaxscmd [–p <current_password>] sla help

DescriptionThe scmd sla help command displays the command syntax, variables, options, andexamples for the scmd sla command bundle.




Examples1. Display help for the sla bundle.

scmd sla help


scmd sla listLists all available commands and options for the scmd sla command bundle.

Syntaxscmd [–p <current_password>] sla list

DescriptionThe scmd sla list command lists all available commands and options for the scmdsla command bundle.




ExamplesList all available commands in the scmd sla command bundle.scmd sla list


scmd sla listUserDisplays information about all of the users in the database.

Syntaxscmd [–p <current_password>] sla listUser

DescriptionThe scmd sla listUser command lists authentication information about all of theusers in the database.




Examples1. List user information from the database.

scmd sla listUser

The out put of this command will look similar to the following:name view consumer realm userType page

-----------------------------------------------------------------------

customer unrestricted customer report.jsp

executive unrestricted executive report.jsp

operations unrestricted operations DeptA.jsp

Jennell unrestricted executive report.jsp

Martha external 12345 operations rpt12345.jsp

David unrestricted ABC customer ABCReports.jsp

See Alsoscmd sla addUser, scmd sla changeUser, scmd sla deleteUser


Chapter 12. Component Management Commands

This chapter describes the CLI commands related to management of thecomponents of IBM Tivoli Service Level Advisor as shown in Table 13.

Table 13. CLI Commands related to management of the Adapter Layers and Components


scmd slm getComponentStatus 138

scmd slm getStatus 139

scmd slm help 141

scmd slm list 142

scmd slm listComponents 143

scmd slm shutdown 144

scmd slm startComponent 145

scmd slm stopComponent 146



scmd slm getComponentStatusDisplays the status of a component.

Syntaxscmd [–p <current_password>] slm getComponentStatus [<component_name>]

DescriptionThe scmd slm getComponentStatus command displays the status of the specifiedcomponent name. If the component name is not specified, then status for allcomponents is listed.

The output of the scmd slm getComponentStatus command includes thecomponent name and the status of the component, which will be one of thefollowing:v Startingv Runningv Stoppingv Stoppedv Failed

A sample of the output is as follows:badlands.raleigh.tivoli.com:SLA:1 Running



<component_name>Specifies the fully-qualified name of the component. Thiscomponent name can be obtained by running the scmdlistComponents CLI command (see “scmd slm listComponents” onpage 143).


Examples1. Display the status of the component named badlands.raleigh.tivoli.com:SLA:1.

scmd slm getComponentStatus badlands.raleigh.tivoli.com:SLA:1

2. Display the status of all components.scmd slm getComponentStatus

See Alsoscmd slm listComponents, scmd slm getStatus


scmd slm getStatusDisplays status information about the IBM Tivoli Service Level Advisor SLMServer.

Syntaxscmd [–p <current_password>] slm getStatus

DescriptionThe scmd slm getStatus command displays all status information about the IBMTivoli Service Level Advisor SLM Server. This information includes the status ofthe server and of all known components.

The output of the scmd slm getStatus command includes the following:v The name of the serverv The date the server was startedv The current status of the server, which will be one of the following:

– Running– Starting– Stopping

v The list of all components with associated states. States may be one of thefollowing:– Starting– Running– Stopping– Stopped– Failed

A sample of the output format is shown as follows:Name: mySystem.raleigh.ibm.comStatus: RunningStarted: Tuesday, March 25, 2003 11:47:17 AM EST

DYKAL9070I The number of components is 13.

mySystem.raleigh.ibm.com:ADPCLI:1 RunningmySystem.raleigh.ibm.com:LogCli:1 RunningmySystem.raleigh.ibm.com:RCC:1 RunningmySystem.raleigh.ibm.com:CLI:1 RunningmySystem.raleigh.ibm.com:DS:1 RunningmySystem.raleigh.ibm.com:CfgCli:1 RunningmySystem.raleigh.ibm.com:OMTEST:1 RunningmySystem.raleigh.ibm.com:SDC:1 RunningmySystem.raleigh.ibm.com:ETL:1 RunningmySystem.raleigh.ibm.com:WDcCli:1 RunningmySystem.raleigh.ibm.com:MEM:1 RunningmySystem.raleigh.ibm.com:SLA:1 RunningmySystem.raleigh.ibm.com:OM:1 Running


Specifies the current password that is set in the configuration. Thisoption is required if password protection has been enabled for theCLI service. The password is set with the scmd setPassword

Chapter 12. Component Management Commands 139

command. Password protection is enabled or disabled with thescmd setPasswordEnabled command.


ExamplesDisplay status information for the IBM Tivoli Service Level Advisor SLM server.scmd slm getStatus

See Alsoscmd slm getComponentStatus, scmd slm listComponents


scmd slm helpDisplays command syntax and examples for the scmd slm command bundle.

Syntaxscmd [–p <current_password>] slm help

DescriptionThe scmd slm help command displays the command syntax and examples for thescmd slm command bundle.




ExamplesDisplay help for the slm command bundle.scmd slm help

See AlsoNone.


scmd slm listLists all available commands and options for the scmd slm command bundle.

Syntaxscmd [–p <current_password>] slm list

DescriptionThe scmd slm list command lists all available commands and options for the scmdslm command bundle.




ExamplesList all available scmd slm commands.scmd slm list

See AlsoNone.


scmd slm listComponentsLists all components managed by the IBM Tivoli Service Level Advisor SLMServer.

Syntaxscmd [–p <current_password>] slm listComponents

DescriptionThe scmd slm listComponents command lists all components managed by theIBM Tivoli Service Level Advisor SLM Server. The output includes the totalnumber of components and the fully-qualified name of each component with itscurrent status as shown in the following sample output:DYKAL9070I The number of components is 10.

badlands.raleigh.tivoli.com:CfgCli:1 Runningbadlands.raleigh.tivoli.com:ADPCLI:1 Runningbadlands.raleigh.tivoli.com:RCC:1 Runningbadlands.raleigh.tivoli.com:LogCli:1 Runningbadlands.raleigh.tivoli.com:CLI:1 Runningbadlands.raleigh.tivoli.com:DS:1 Runningbadlands.raleigh.tivoli.com:SDC:1 Runningbadlands.raleigh.tivoli.com:MEM:1 Runningbadlands.raleigh.tivoli.com:SLA:1 Runningbadlands.raleigh.tivoli.com:OM:1 Running




ExamplesList all components.scmd slm listComponents

See Alsoscmd slm getComponentStatus


scmd slm shutdownShuts down the IBM Tivoli Service Level Advisor SLM Server.

Syntaxscmd [–p <current_password>] slm shutdown

DescriptionThe scmd slm shutdown command initiates a shutdown of the IBM Tivoli ServiceLevel Advisor SLM Server. The command is asynchronous. For information on theprogress of the shutdown, look in the log file.

The user will be notified that the shutdown request has been initiated, with thefollowing message:DYKAL0250I The shutdown request has been initiated. Please seethe log for further details.




ExamplesShut down the IBM Tivoli Service Level Advisor SLM Server.scmd slm shutdown

See AlsoNone.


scmd slm startComponentStarts a component of IBM Tivoli Service Level Advisor.

Syntaxscmd [–p <current_password>] slm startComponent <component_name>

DescriptionThe scmd slm startComponent command starts the specified component. Thespecified component must be in the Running or the Failed state to be started,otherwise an error message is displayed and the command is aborted.

A message is displayed indicating the command’s success or failure. The followingexample indicates that the component was successfully started:DYKAL0254I Component badlands.raleigh.tivoli.com:SLA:1 was started successfully.

When the component startup has completed (either successfully or in failure), amessage will be printed. The message for a successful startup is displayed asfollows:DYKAL0254I Component badlands.raleigh.tivoli.com:SLA:1 was started



<component_name>Specifies the fully-qualified name of the component. You can obtainthis component name by running the scmd slm listComponentscommand.


Examples1. Start the component named badlands.raleigh.tivoli.com:SLA:1.

scmd slm startComponent badlands.raleigh.tivoli.com:SLA:1

2. Start the component named badlands.raleigh.tivoli.com:OM:1.scmd slm startComponent badlands.raleigh.tivoli.com:OM:1

See Alsoscmd slm listComponents


scmd slm stopComponentStops a component of IBM Tivoli Service Level Advisor.

Syntaxscmd [–p <current_password>] slm stopComponent <component_name>

DescriptionThe scmd slm stopComponent command stops the specified component. Thespecified component must be in the Running state to be stopped, otherwise anerror message will be displayed and the command will be aborted.

When the component shutdown has completed (either successfully or in failure), amessage will be displayed. The output for a successful shutdown is as follows:DYKAL0255I Component badlands.raleigh.tivoli.com:SLA:1 was stopped successfully.



<component_name>Specifies the fully-qualified name of the component.


Examples1. Stop the component named badlands.raleigh.tivoli.com:SLA:1.

scmd slm stopComponent badlands.raleigh.tivoli.com:SLA:1

2. Stop the component named badlands.raleigh.tivoli.com:OM:1.scmd slm stopComponent badlands.raleigh.tivoli.com:OM:1

See Alsoscmd slm listComponents


Chapter 13. Warehouse Data Collection Commands

This section describes the CLI commands you can use for warehouse datacollection, as shown in Table 14.

Table 14. CLI commands for warehouse data collection


scmd wdccli connections 148

scmd wdccli help 149

scmd wdccli list 150

scmd wdccli listSettings 151

scmd wdccli setConRetries 152

scmd wdccli setConWait 153

scmd wdccli setETLPoll 154

scmd wdccli setLogStartEnd 155



scmd wdccli connectionsReturns the number of database connections currently held by the data collector.

Syntaxscmd [–p <current_password>] wdccli connections

DescriptionThe scmd wdccli connections command returns the number of databaseconnections currently held by the data collector. The data collection component ofIBM Tivoli Service Level Advisor performs its activities at the request of the metricevaluator management component. All operations are of short duration (one ortwo database queries), and the data collector obtains a connection from the SLMserver pool at the start of the operation, and returns it at the end. Executing thiscommand will return the number of connections currently held. If the datacollector is idle, the number of held connections should be zero.




ExamplesInquire how many database connections are currently held by the data collector.scmd wdccli connections

The output when the data collector is idle is displayed as follows:Database connections held by the data collector: 0


scmd wdccli helpDisplays command syntax and examples for the scmd wdccli command bundle.

Syntaxscmd [–p <current_password>] wcccli help

DescriptionThe scmd wdccli help command displays the command syntax, variables, options,and examples for the scmd wdccli command bundle.




Examples1. Display help for the wdccli bundle.

scmd wdccli help

Chapter 13. Warehouse Data Collection Commands 149

scmd wdccli listLists all available commands and options for the scmd wdccli command bundle.

Syntaxscmd [–p <current_password>] wdccli list

DescriptionThe scmd wdccli list command lists all available commands and options for thescmd wdccli command bundle.




ExamplesList all available commands in the scmd wdccli command bundle.scmd wdccli list


scmd wdccli listSettingsLists the current data collector settings.

Syntaxscmd [–p <current_password>] wdccli listSettings

DescriptionThe scmd wdccli listSettings command displays the current configurable settingsfor the data collector component of IBM Tivoli Service Level Advisor, including thefollowing:v Retry wait timev Connection retriesv ETL poll intervalv Log setting

A sample output might look like the following:ConRetries = 10

ConWait = 10 (seconds)

ETLPoll = 10 (minutes)

logStartEnd = true




ExamplesList the current settings for the data collector.scmd wdccli listSettings


scmd wdccli setConRetriesSets the number of times that the data collector will retry a failed databaseoperation.

Syntaxscmd [–p <current_password>] wdccli setConRetries <number_of_retries>

DescriptionThe data collector can perform retries when database failures occur. The scmdwdccli setConRetries command configures the number of times to retry theoperation. If the database is temporarily unreachable, retrying the operation avoidsdelay in collection of data. For best results, limit the number of retries and thedelay between retries to total an hour or less if possible. For example, you mightset the number of retries to 5, and the delay time between retries to 60 seconds, or5 minutes total. To set the delay time between retries, see the scmd wdcclisetConWait command.



<number_of_retries>Specifies the number of times to retry a failed database operation.


ExamplesSet the number of retries to 10.scmd wdccli setConRetries 10

See Alsoscmd setConWait


scmd wdccli setConWaitSets the wait time, in seconds, between attempts to retry failed databaseoperations.

Syntaxscmd [–p <current_password>] wdccli setConWait <number_of_seconds>

DescriptionThe data collector can perform retries when database failures occur. The scmdwdccli setConWait sets the wait time, in seconds, between attempts to retry faileddatabase operations. If the database is temporarily unreachable, retrying theoperation avoids delay in collection of data. For best results, limit the number ofretries and the delay between retries to total an hour or less if possible. Forexample, you might set the number of retries to 5, and the delay time betweenretries to 60 seconds, or 5 minutes total. To set the number of retries, see the scmdwdccli setConRetries command.



<number_of_seconds>Specifies the wait time, in seconds, to delay before attempting toretry a failed database operation.


ExamplesSet the time to wait between retry attempts to wait 30 seconds.scmd wdccli setConWait 30

See Alsoscmd wdccli setConRetries


scmd wdccli setETLPollSets the ETL notification polling time interval.

Syntaxscmd [–p <current_password>] wdccli setETLPoll <timeInMinutes>

DescriptionMetric evaluations are started when the data collector detects that the Process ETLhas completed its processing. The setETLPoll CLI command can change how oftenthe data collector checks (polls) for ETL completion. The default time is 10minutes.




ExamplesSet the ETL Polling time to 15 minutes:scmd wdccli setETLPoll 15


scmd wdccli setLogStartEndEnables or disables messages to the log whenever data collection starts and ends.

Syntaxscmd [–p <current_password>] wdccli setLogStartEnd { true | false }

DescriptionThe data collector can log a start and an end message to the console each time it iscalled to collect data. Because the console log is usually kept on the system harddisk storage, these messages could eventually consume a large amount of space, soby default they are disabled. These messages may be useful in debug or timingsituations.

The scmd wdccli setLogStartEnd command enables or disables these log messages.A setting of true enables start and end messages to be logged each time the datacollector is called. A setting of false disables this logging.

The following is an example of the message format:2002.01.07 16:05:20.015 DYLWS0008I Start retrieve for component: 3 "twhdc

CLI" 2001-01-01 00:00:01.0 to 2004-12-31 00:00:23.0 (GMT)

2002.01.07 16:05:20.109 DYLWS0009I Ended retrieve for component: 3 "twhdc

CLI" 2 ( Hourly ) datapoint(s) retrieved for MeasTypeID 1.



true Enables start and end messages to be written to the console logwhenever the data collector is called to collect data.

false Disables start and end messages from being written to the consolelog whenever the data collector is called to collect data.


ExamplesEnable start and end messages to be logged:scmd wdccli setLogStartEnd true

Disable start and end messages:scmd wdccli setLogStartEnd false



Chapter 14. Non-CLI Service Utilities

This section describes the non-CLI service utilities that you can use to performvarious administrative tasks, as shown in Table 15.

Table 15. Non-CLI Service utilities

Utility Command See page

cliutil 158

diagutil 159

dsutil 161

logutil 164

rcomutil 165

slmbackup 167

slmenv 170

slmrestore 171

slmrestorerestart 174

verutil 175

viewer 177

Note: The slmenv utility must be run before running any of these othercommands, to initialize the command environment. See page 170 for detailson the slmenv command.


cliutilSets or retrieves the CLI service port number, and resets the CLI Service password.

Syntaxcliutil {[resetPassword] | [setPort <port_number>] | getPort]}

DescriptionThe cliutil utility sets or retrieves the port on which the CLI Service listens, andresets the CLI Service password.

The cliutil getport command returns the port number of the CLI Service, in amessage similar to the following:Current port for CLI service is 9990

The cliutil resetPassword and cliutil setPort commands return a messageindicating if the operation was successful. For example, a successful cliutilrestPassword command returns the message:Password was successfully reset.

OptionsresetPassword Resets the CLI Service password to a known default. See your SLM

Administrator for this default value, or consult the Administrator’sGuide for IBM Tivoli Service Level Advisor for more information.

setPort <port_number>Sets the CLI Service listening port to the specified port number.This command modifies both the configuration information as wellas the slmenv script (see the command utility “slmenv” onpage 170 for more information). Before changing this port number,verify that the port number is valid and not already in use byanother application.

getPort Retrieves the current CLI service listening port.


Examples1. Get the current CLI Service listening port number.

cliutil getPort

2. Set the CLI Service listening port to 9991.cliutil setPort 9991

3. Reset the CLI Service password.cliutil resetPassword


diagutilDumps diagnostic information to be used by Tivoli customer support.

Syntaxdiagutil [–p <current_password>] {dump | zip [-config] [-logs]}

DescriptionThe diagutil utility dumps diagnostic information to be used by Tivoli customersupport teams to help diagnose problems. The utility executes many scmdcommands, so the –p <current_password> option must be used if the command lineinterface service is password protected. Information is collected for any of the threemain install options of IBM Tivoli Service Level Advisor (SLM Server, SLMReports, and SLM Task Drivers). Some DB2 related information is also collected.

The diagutil dump command displays information on the console, but theinformation can be redirected to a file if desired, using the > operator, such as dump> abc.txt.

The diagutil zip command performs the dump operation, and also collects loggingand configuration information, and writes all of this data into a zip file on theTivoli Common Directory for IBM Tivoli Service Level Advisor, nameddiag.<timestamp>.zip, to send to Tivoli customer support for diagnosis.

Using –config or –logs options with the diagutil zip command specifies to onlycollect configuration files or log files, respectively. If either –config or –logs isspecified, no scmd commands will be performed. To zip the configuration files, logfiles, and scmd output, use the default diagutil zip command.




NotesThe db2profile must be sourced when running this command on UNIX platforms.

Examples1. Collect diagnostic information and display it on the console.

diagutil dump

2. Collect and zip up all diagnostic information, and include logging andconfiguration information as well, and zip it into a file to be sent to TivoliCustomer Support.diagutil zip

3. Collect only the logging diagnostic information and zip it into a file to be sentto Tivoli Customer Support.

Chapter 14. Non-CLI Service Utilities 159

diagutil zip -logs


dsutilModifies information for the specified datasource.

Syntaxdsutil <datasource_name> [url=<url>] [driver=<driver>] [userid=<userid>][password=<password>] [minconnections=<min_connections>][maxconnections=<max_connections>]

DescriptionThe dsutil utility displays or updates datasource information for the givendatasource. Any combination of the database connection parameters may bechanged to create a new datasource to replace an already existing datasource.Values entered must be valid values for the database being accessed. If any valuesare invalid, the datasource creation will return errors during the restart of the SLMServer, and the datasource creation will fail.

If you have IBM Tivoli Service Level Advisor distributed on multiple systems, youmust run dsutil on each system that has an SLM install option (SLM Server, SLMTask Drivers, or SLM Reports).

After these database parameters are altered, you must restart the SLM Server, theSLM Reports Server (restart WebSphere), and the SLM Task Drivers (restart theIBM Console) for the configuration changes to take effect.

To get the current state of a specific datasource, issue the following command:dsutil <datasource_name>

The output of this command is similar to the following:For the <Server name> server, the sdc datasource has the following

values:url = jdbc:db2:db_namedriver = COM.ibm.db2.jdbc.app.DB2Driveruserid = db2userminconnections = 3maxconnections = 25

Note: Output from Tivoli Presentation Services will also be displayed, containingsimilar information.

Options<datasource_name>

Indicates the name of the datasource to be recreated. Thisparameter must specify the name of an existing datasource.

Valid datasources include:

dmt for the SLM Measurement Data Mart (dyk_dm)

sdc for the SLM Database (dyk_cat)

url=<url> Specifies the JDBC connection URL necessary to identify theappropriate databases and drivers. Refer to your specific databasemanagement system documentation for the format of this URL.

driver=<driver>Specifies the JDBC driver used to establish a connection to the


database. Refer to your specific database management systemdocumentation for the format of the driver string. For the DB2Application Driver, this value would be set toCOM.ibm.db2.jdbc.app.DB2Driver.

userid=<userid>Specifies the user name used to connect to the database.

password=<password>Specifies the password used to connect to the database.

minconnections=<min_connections>Specifies the minimum number of connections to hold in thedatabase connection pool. This value must be greater than zero andless than or equal to the value specified in maxconnections. If thisvalue is not set properly, an error is returned and the parameter isnot set.

maxconnections=<max_connections>Specifies the maximum number of connections to hold in thedatabase connection pool. This value must be greater than or equalto the value specified in minconnections. This configurationparameter is associated with the DB2 database level configurationparameter maxappls. The maxappls database configurationparameter specifies the maximum number of concurrentapplications that can be connected to a database. If you increasethe maxconnections value in dsutil, you may also need to increasethe value of maxappls. See the DB2 Administrator’s Guide for moreinformation about database configuration parameters. If this valueis not set properly, an error is returned and the parameter is notset.


Examples1. List the information for the SLM Database (dyk_cat).

dsutil sdc

The resulting output, for a machine on which both the SLM Server and SLMReports are installed, is displayed similar to the following:DYKAL9184I For the SLM Server, the sdc datasource has the following values:url = jdbc:db2:dyk_catdriver = COM.ibm.db2.jdbc.app.DB2Driveruserid = iddtest01minconnections = 3maxconnections = 25

DYKAL9213I For the SLM Report Server, the sdc datasource has the following values:url = jdbc:db2:dyk_catdriver = COM.ibm.db2.jdbc.app.DB2Driveruserid = iddtest01minconnections = 3maxconnections = 25

2. Given a datasource DataSrc1 on a DB2 database management system, thefollowing command updates the database connection URL to point to a newlycreated database named DataSrc2:


dsutil DataSrc1 url=jdbc:db2:DataSrc2

3. Given a datasource DataSrc1, the following command updates both the username and password used to access the database:dsutil DataSrc1 userid=newuser password=newpassword

Note: The datasource will only be created if the user name and password arevalid connection parameters to the database.

4. Given a datasource DataSrc1 on a DB2 management system, the followingcommand updates the JDBC driver used to access the database:dsutil DataSrc1 driver=COM.ibm.db2.jdbc.app.DB2Driver


logutilDisplays or changes properties of logging objects.

Syntaxlogutil {filter | handler | message | trace} {[–g <group_name>] | [<object_name>}]{–keys | –get <key> | –set <key>=<value> | –contents | –list | –listactive}

DescriptionThe logutil utility displays or changes the properties of logging objects. Loggingobjects can be any of the following:v Filterv Handlerv Messagev Trace

The logutil utility can be used to enable or disable logging for report servlets, butit may also be executed on the SLM Server machine as well.

The logutil utility has the same functionality as the scmd log bundle, but does notrequire a CLI Service connection. For more information, see Chapter 5, “Loggingand Tracing Commands”, on page 47 for details on the scmd log bundle. You canuse logutil in the same way, by substituting logutil for scmd log.


rcomutilDisplays or sets the host name and port used for remote communication with theSLM Server component of IBM Tivoli Service Level Advisor.

Syntaxrcomutil getValues

rcomutil setValues <hostname> <port>

DescriptionThe rcomutil getValues command displays the hostname and port currently usedfor remote communication between the SLM task drivers and the SLM Servercomponents of IBM Tivoli Service Level Advisor. The hostname is the fullyqualified hostname of the SLM Server. This command is only available on themachine where the SLM task drivers are installed (also known as the IBM ConsoleServer).

The following shows a sample output of the rcomutil getValues command,displaying information about the SLM Server machine with host namemySystem.myCompany.com and the assigned port number, 9980, used for remotecommunication:DYKAL9156I SLM Report Server remote communication settings:

SLM Server: mySystem.myCompany.comPort: 9980

The rcomutil setValues command enables you to specify the fully qualified hostname of the SLM Server and to define the port to be used for remotecommunication with the SLM Server. The hostname is the fully qualified hostnameof the SLM Server. This command is only available on the machine where the SLMtask drivers are installed.

If the port is changed then a corresponding change must be made on the SLMServer machine, using the scmd rcc setport command so that the ports used forcommunication between the SLM Server machine and the IBM Console Servermachine are in agreement (see Chapter 8, “Remote Communication Commands”,on page 79 for more information on the scmd rcc setport command).

Note: The Web Services For IBM Console service must be restarted for the newhostname and port to be recognized.

When the values are successfully changed, messages similar to the following willbe displayed (the following sample is a result of changing the hostname toyourcomany.com and the port number to 9981):DYKAL9194I The values have been successfully changed for SLM Reports.The WebSphere Application Server must be restarted before the newvalues will be used.

Options<hostname> The fully qualified host name of the machine where the SLM

Server component of IBM Tivoli Service Level Advisor is installed.

<port> The port number to be used for remote communication with theSLM Server machine.



Examples1. Display the current remote communication host name and port number.

rcomutil getvalues

2. Change the host name to mycompany.com and the port to 9981.rcomutil setvalues mycompany.com 9981


slmbackupPerforms functions for automating steps of the IBM Tivoli Service Level Advisorbackup procedure.

Syntaxslmbackup {<output_directory> [–auto] | [–start]}

DescriptionBefore issuing slmbackup commands, consult the backup and restoredocumentation in the Administrator’s Guide for IBM Tivoli Service Level Advisor

The slmbackup utility performs shutdown, startup and backup operations on theIBM Tivoli Service Level Advisor installation directories as part of the definedbackup procedure.

Once the IBM Tivoli Service Level Advisor Registration and Process ETLs havediscontinued running, the slmbackup <output_directory> command may be issued.The slmbackup command should not be run while the Registration or ProcessETLs are running, or if they are about to be run according to their schedule.

The slmbackup <output_directory> command shuts down the three maincomponents of IBM Tivoli Service Level Advisor, the SLM Server, the IBM ConsoleServer (which includes the SLM task drivers), and the SLM Reports Server. Backupimages of the installation directories from which the command was issued arecreated. If these three components of IBM Tivoli Service Level Advisor are installedon separate machines or disk partitions, the slmbackup command must be run oneach of the machines, and should be issued at approximately the same time inorder to guarantee that all three components are shutdown, and that each will becontained in a backup image. In this situation, slmbackup will wait forconfirmation that all three components of IBM Tivoli Service Level Advisor haveshutdown before creating the backup image. This confirmation step can be omittedby specifying the –auto flag.

If the –auto flag is specified or after shutdown confirmation has been received, thefile <timestamp>.zip will be created and placed in the directory <outputdir>/DYK/<timestamp>. The <timestamp> value is the time determined by theslmbackup utility of when the command was issued. The exact values used for the<output_directory> and <timestamp> for slmbackup should be retained and usedlater to restore this backup image.

After slmbackup <output_directory> has completed, you should perform theremaining steps to complete the backup procedure as outlined in theAdministrator’s Guide for IBM Tivoli Service Level Advisor before restarting IBM TivoliService Level Advisor. After all backup procedures have been completed,slmbackup –start can be used to restart IBM Tivoli Service Level Advisor. As withthe backup procedure, if IBM Tivoli Service Level Advisor is installed on multiplemachines or disk partitions, slmbackup –start must be issued on each machine.

Options<output_directory>

Specifies the root directory in which to place the backup file


<timestamp>.zip. The file will be placed in the following directory,where <timestamp> is the time at which the slmbackup command isinvoked:<output_directory>/DYK/<timestamp>

–auto Specifies that the backup procedure should run without pausingfor user input that all of the components of IBM Tivoli ServiceLevel Advisor have shutdown. This is only necessary inconfigurations where the three components reside on more thanone machine or installation directory.

–start Starts the main components of IBM Tivoli Service Level Advisor.This option should be used after all of the backup steps have beencompleted.


NotesIt is important that you understand all of the steps in the IBM Tivoli Service LevelAdvisor backup process before performing this command. Consult theAdministrator’s Guide for IBM Tivoli Service Level Advisor for further information onbacking up IBM Tivoli Service Level Advisor to ensure the slmbackup commandmeets your systems needs, and that the correct information from slmbackup isstored.

All backups made using slmbackup should be restored using the slmrestorecommand. IBM Tivoli Service Level Advisor does not support using any othermethod to restore the IBM Tivoli Service Level Advisor installation directories.

The slmenv command must be issued to setup the IBM Tivoli Service LevelAdvisor command environment before running the slmbackup command. See“slmenv” on page 170 for more information.

FilesThe following file will be created:<output_dir>/DYK/<timestamp>/<timestamp>.zip

Examples1. Back up the IBM Tivoli Service Level Advisor installation directory to the

following location:C:\temp\DYK\200112080908

The backup image file 200112080908.zip will be placed in the directory, where200112080908 is the timestamp representing the date and time at which theslmbackup command was issued:slmbackup C:\temp

2. Back up the IBM Tivoli Service Level Advisor installation directory to thefollowing location, without pausing for user confirmation that one or more ofthe three main components of IBM Tivoli Service Level Advisor not located onthis machine have shutdown:C:\temp\DYK\200112080908


The backup image file 200112080908.zip will be placed in the directory.200112080908 is the timestamp representing the date and time at which theslmbackup command was issued:slmbackup C:\temp -auto

3. Restart the three main components of IBM Tivoli Service Level Advisor (theSLM Server, SLM task drivers, and SLM Reports) contained on this installation:slmbackup -start

See Alsoslmrestore, slmenv


slmenvInitializes the current command window so that scmd and server utilities can beexecuted.

Syntaxslmenv

DescriptionThe slmenv command sets necessary environment information so that scmd andserver utility commands can be executed properly. On Windows platforms, slmenvcan be executed directly. On UNIX platforms, slmenv must be sourced byspecifying a period (.) before the invocation. For example, on UNIX, the slmenvcommand is executed correctly by typing the following at a command prompt:. ./slmenv

The slmenv command is located in the installation directory specified at installtime.

OptionsNone


Examples1. Initialize the command environment on Windows.

slmenv

2. Initialize the command environment on UNIX.. ./slmenv


slmrestorePerforms functions for automating steps of the IBM Tivoli Service Level Advisorrestore procedure. The slmrestore command is located on the IBM Tivoli ServiceLevel Advisor product CD and can only be run from the CD.

Syntaxslmrestore <image_location_directory> [<timestamp>] [–auto]

DescriptionBefore issuing slmrestore commands, consult the backup and restoredocumentation in the Administrator’s Guide for IBM Tivoli Service Level Advisor.

The slmrestore utility performs shutdown and restore operations on the IBM TivoliService Level Advisor installation directories, and re-imports the SLM reportservlets for WebSphere AES 4.0.1, as part of the defined restore procedure.

Note: Other versions of WebSphere require you to manually re-import the SLMreport servlets.

Once the IBM Tivoli Service Level Advisor Registration and Process ETLs havediscontinued running, the slmrestore <image_location_directory> <timestamp>command may be issued. The slmrestore command should not be run while theRegistration or Process ETLs are running, or if they are about to be run accordingto their schedule.

The slmrestore <image_location_directory> <timestamp> command shuts down thethree main components of IBM Tivoli Service Level Advisor, the SLM Server, theIBM Console Server (which includes the SLM task drivers), and the SLM ReportsServer, and restores the installation directories from the backup image<timestamp>.zip, located in the directory<image_location_directory>/DYK/<timestamp>, to its original installation directory.The values for <image_location_directory> and <timestamp> should be identical tothose used or created during the original backup procedure using the slmbackup<image_location_directory> command.

If the three main components of IBM Tivoli Service Level Advisor are installed onseparate machines or disk partitions, the slmrestore command must be run oneach of the machines, and should be issued at approximately the same time inorder to guarantee all three components are shutdown and each will be restored tocompatible backup images. In this situation, slmrestore will wait for confirmationthat all three components of IBM Tivoli Service Level Advisor have shutdownbefore performing the restore operation. This confirmation step can be omitted byspecifying the –auto flag.

If the –auto flag is specified or after shutdown confirmation has been received,slmrestore re-imports the SLM Reports Servlets into WebSphere AES 4.0.1. If youare restoring to a different version of WebSphere, consult Getting Started with IBMTivoli Service Level Advisor for information on importing the SLM report servlet. Ifthe SLM Reports option of IBM Tivoli Service Level Advisor is not installed on thismachine, this step will be skipped.

After slmrestore <image_location_directory><timestamp> has completed, you shouldperform the remaining steps to complete the restore procedure as outlined in theAdministrator’s Guide for IBM Tivoli Service Level Advisor before restarting IBM Tivoli


Service Level Advisor. After all restore procedures have been completed,slmrestorerestart can be used to restart IBM Tivoli Service Level Advisor. As withthe restore procedure, if IBM Tivoli Service Level Advisor is installed on multiplemachines or disk partitions, slmrestorerestart must be issued on each machine.

The slmrestorerestart command is a non-CLI service command and, unlikeslmrestore, can be used in a shell in which the command line environment hasbeen correctly initialized. See “slmrestorerestart” on page 174 for further details onits use.

Options<image_location_directory>

Specifies the root directory in which the backup files were placedduring the slmbackup procedure. The directory specified shouldcontain the /DYK/<timestamp> directory containing the backup file<timestamp>.zip. The /DYK/<timestamp> does not need to bespecified as part of the <image_location_directory> parameter.

<timestamp> Specifies the timestamp denoting a backup image taken by thecommand slmbackup. All backup files are located in a directorynamed by the time at which it was taken. This <timestamp>directory is a subdirectory of the DYK directory contained in the<image_location_directory> location. The <timestamp> directoryspecified should contain the backup file <timestamp>.zip.

–auto Specifies that the restore procedure should run without pausing foruser input that all of the components of IBM Tivoli Service LevelAdvisor have shutdown. This is only necessary in configurationswhere the three components reside on more than one machine orinstallation directory.


NotesThe slmrestore command is different from all other CLI commands in that it is runfrom the IBM Tivoli Service Level Advisor product CD. It is located in the<CD_Image>/tools/restore directory, where <CD_Image> is the location of theCD-ROM drive containing the IBM Tivoli Service Level Advisor product CD. Theslmrestore command must be issued from a command shell in which<CD_Image>/tools/restore is the current directory. The slmrestore will only workfrom this directory.

It is important that you understand all of the steps in the IBM Tivoli Service LevelAdvisor restore process before performing this command. Consult theAdministrator’s Guide for IBM Tivoli Service Level Advisor for further information onrestoring IBM Tivoli Service Level Advisor to ensure the slmrestore commandmeets your systems needs, and that the correct information is used to perform eachrestore.

All restores of IBM Tivoli Service Level Advisor should be performed using theslmrestore command. IBM Tivoli Service Level Advisor does not support usingany other method to restore the IBM Tivoli Service Level Advisor installationdirectories.


FilesThe following file contains the zipped image of the IBM Tivoli Service LevelAdvisor installation directory. It is unzipped to its original installation directory:<output_dir>/DYK/<timestamp>/<timestamp>.zip

Examples1. Restore the IBM Tivoli Service Level Advisor installation directory found in the

following directory to its original installation directory:C:\temp\DYK\200112080908

The file 200112080908.zip is contained in the directory and used in the restore.The value 200112080908 is the timestamp representing the date and time atwhich the slmbackup command was issued:slmrestore C:\temp 200112080908

2. Restore the IBM Tivoli Service Level Advisor directory image found in thedirectory C:\temp\DYK\200112080908 to its original installation directory withoutpausing for user confirmation that one or more of the three main componentsof IBM Tivoli Service Level Advisor not located on this machine haveshutdown. The file 200112080908.zip is contained in the directory and is usedin the restore. 200112080908 is the timestamp representing the date and time atwhich the slmbackup command was issued:slmrestore C:\temp 200112080908 -auto

3. Return the slmrestore help screen and the list of the timestamps for all backupimages contained in the directory C:\temp\DYK. The returned values may beused for the <timestamp> value in the slmrestore <image_location_directory><timestamp> command:slmrestore C:/temp

4. Return the slmrestore help screen:slmrestore

See Alsoslmbackup, slmrestorerestart


slmrestorerestartRestarts a restored IBM Tivoli Service Level Advisor.

Syntaxslmrestorerestart

DescriptionBefore issuing slmrestorerestart, consult the backup and restore documentation inthe Administrator’s Guide for IBM Tivoli Service Level Advisor.

The slmrestorerestart command performs the startup step of the IBM Tivoli ServiceLevel Advisor defined restore procedure. It should be executed followingsuccessful completion of the slmrestore <image_location_directory> <timestamp>command. As in the case of slmrestore, if the three main components of IBM TivoliService Level Advisor are installed on separate machines or disk partitions, theslmrestorerestart command must be run on each of the machines.

The slmrestorerestart command can be used in any command shell in which thecommand line environment has been correctly initialized.

OptionsNone.


ExamplesStart the main components of IBM Tivoli Service Level Advisor after theslmrestore <output directory> <timestamp> command has completed:slmrestorerestart

See Alsoslmbackup, slmenv, slmrestore


verutilDisplays version information for all component jar files or for an individual file,and checks for jar files that are not consistent with the current release or fix packlevel.

Syntaxverutil {check | dump [<output_filename>] | –f <filename>}

DescriptionThe verutil command displays version information for all component jar files orfor an individual file, and checks for jar files that are not consistent with thecurrent release or fix pack level. This information is displayed for any of the threeinstall options of IBM Tivoli Service Level Advisor (SLM Server, SLM Reports, andSLM Task Drivers), and is normally only required when providing diagnosticinformation to Tivoli customer support.

The verutil check command performs a version check on all installed jar files forthe product and reports any jars that are not consistent with the current release orfix pack level. The check is performed

The verutil dump <output_filename> command produces a report detailing all ofthe version information about the product. The report lists the overall productversion and the version of each component jar file. If <output_filename> is specified,the report is written to that file, otherwise the report will be written to the console.

The verutil –f <filename> command reports the version information for thespecified jar file <filename>.

Options<output_filename>

Specifies the name of the file into which the version report iswritten.

–f <filename> Specifies the name of the particular jar file on which to reportversion information.


Examples1. Perform a version check on all installed jar files.

verutil check

The output of this command when all jar files match the current release and fixpack level is similar to the following:IBM Tivoli Service Level Advisor Version 1.2.1.0 - 3/20/03 12:37 PM

All SLM Server jar versions match the current release.

All SLM Task Driver jar versions match the current release.

All SLM Report Server jar versions match the current release.

2. Produce a product version report, displayed on the console.verutil dump


3. Produce a product version report, writing it to the file nameC:/temp/version.report:verutil dump C:/temp/version.report

4. Check the version of the jar file named spi.jar.verutil -f spi.jar

The output of this command is displayed on the console and looks similar tothe following:IBM Tivoli Service Level Advisor Version 1.2.1.0 (build xxxxxxxxxxxx)

SLM Server Version Report

spi.jar 1.2.1.0 3/4/03 4:52 AM (407621 bytes)

SLM Report Server Version Report (WebSphere:AEs4.0.1)

spi.jar 1.2.1.0 3/4/03 9:07 AM (407501 bytes)

SLM Task Drivers Version Report (IBM Console Version:2.2.0)

spi.jar 1.2.1.0 3/4/03 9:25 AM (407621 bytes)


viewerProcesses log files in the Tivoli XML format into ASCII or HTML for presentation.

Syntaxviewer [ –q ″<query_string>″ | –f <filename>] [ –s { ascii | html }] [–h] <input.xml>[<input.xml>*] [ > <outputFile>]

DescriptionThe viewer command processes log files in the Tivoli XML format into ASCII orHTML for presentation. It provides the ability for XML Log files produced byseveral products to be correlated and filtered according to a time window, severityor trace level, thread ID, component, and several other fields. It requires thespecific XML format of the Tivoli logs. XML files not in the Tivoli standard formatcannot be processed by the XML log viewer.

You can provide a query string that specifies one or more fields to be displayed, oryou can point to a file that contains the desired query string. You can specifywhether you want the output in ASCII or HTML format, and specify one or moreinput XML files to be examined. Finally, you can direct the output to a file or letthe output be displayed to the console by default.

Options–q ″<query_string>″

Specifies which fields are to be displayed in the generated output,and defines the criteria for displaying log records. The query stringshould be surrounded by quotes.

–f <filename> Specifies the name of a file that contains a query string.

–s {ascii | html}Specifies whether generated output is to be in ASCII or HTMLformat. The default is HTML.

–h Displays the help menu.

<input.xml> Specifies the name of one or more log files that are in the TivoliXML format.

<outputFile> Specifies the name of a file in which to write the output. Thedefault is to display the output on the console.


NotesThe following sections provide details on specifying viewer commands.

Creating a Query StringThe query string passed to the log viewer through the –q or –f option gives the logviewer its filtering and correlation capabilities. You determine what queries, if any,are useful in generating log files. Through a query string, you can adjust theinformation contained in each log record and what log records should bedisplayed. If no query string is specified the default query string that is used is″select default where true″.


The query string should be specified in the following format:select <column> [,<column>] where <filter predicate>

Specifying Columns: The <column> variable determines which fields from eachlog record should be displayed in the generated output. Fields vary depending onwhether the log record is for trace or message data. Each log record may containthe following fields:

Table 16.

Column field Information displayed Example

Component The internal component of IBM TivoliService Level Advisor in which the logrecord was created.

MEM

Element The type of log record, Message or Trace Message

Exception Java Exception information java.io.IOException

LogText The text of the log record Creating order 2002

MessageID The ID specific to a log record DYKME1023I

Millis Time, in milliseconds 1022029398844

ProductId Tivoli Product Identifier, DYK for IBMTivoli Service Level Advisor logs

DYK

ProductInstance The instance name of the productcomponent. For IBM Tivoli Service LevelAdvisor, this is not defined.

myserver.mydomain.com:1

Server String, name, or IP address on which thelog record was taken

myserver.mydomain.com:1

Severity (see note1 below)

The severity of a message log record.Valid values are INFO, ERROR, orWARNING.

INFO

SourceFile The source file where the event wasgenerated.

com.Tivoli.managed.om.OrderManager

SourceMethod The method which generated the event. createOrder()

Thread The ID or name of a thread Thread-4

Time Time in ISO format 2002-06-27 0:06:58.141 EST

TraceLevel (seenote 2 below)

The trace level. Valid values are MIN,MID, MAX, OTHER

MID

Notes:

1. The Severity field is intended for message logs only. See the section below onthe Message ID for information on the three Severity levels INFO, ERROR, andWARNING used with the XML Log Viewer.

2. The TraceLevel field is intended for trace logs only. The XML Log Viewer tracelevels of MIN, MID, and MAX correspond to the IBM Tivoli Service LevelAdvisor trace levels of LEVEL1, LEVEL2, and LEVEL3, respectively.

The word all may be used in place of a column to specify that all columns shouldbe displayed. The word default will select the following columns: Time, Severity,Message Id, LogText, Server, Product Id, Component, and Product Instance. Thecolumn field is not case sensitive.


Note: The product instance field for IBM Tivoli Service Level Advisor will remainblank. If a specified column does not exist for a log record, a blank field willbe displayed.

Specifying Filter Predicates: The <filter predicate> determines which particular logrecords will be present in the output. It is specified in the format of an expression,or the reserved word true, which causes all log records to be output. This is usefulwhen you want to adjust only the columns that are present in the output logs.

Each filter predicate is specified in the following format:<column> <operator> <value>

The column names from above may be used as keys in the filter predicate tospecify for which values of particular columns should log records be displayed.For example, the expression Severity=Error specifies to only display log records inwhich the Severity column has the value Error.

An <operator> is used to determine the relationship between the <value> and thespecified <column>. In the example above, = is the conditional operator specifyingthat the Severity column must be of type Error. Valid operators include thefollowing:

= Equal

> Greater than

< Less than

>= Greater than or equal to

<= Less than or equal to

<> Not equal to

MATCHThe MATCH pattern matching operator can also be used in the conditionalselection of the where clause. Match is a powerful operator that allows youto select log or trace records using regular expression syntax. Strings withspecial characters used in the regular expression must be in single quotes.Strings with spaces must also be in single quotes. An example of the matchoperator in a query string is:“select default where logtext match hostname”

When using relational operators with the TraceLevel and Severity fields in a filterpredicate, it is important to understand the values assigned to each. Messageseverities can have the value of INFO, WARNING, or ERROR. INFO is assigned thegreatest value, and logging at the INFO level will allow all three types of messagesto be displayed. Similarly, WARNING is assigned an intermediate value, andERROR is assigned the least value. Using the expression Severity<ERROR wouldreturn no values. The relationship between message severity values is as follows:INFO > WARNING > ERROR

Trace Levels can be MIN, MID, MAX, or OTHER. Contrary to its name, MAX isassigned the least value. Trace Levels have the following relationship:OTHER > MIN > MIX > MAX

The filter predicate is not case sensitive.


Using Boolean Operators: Boolean operators may be used to join two expressionsinto a single filter predicate. The OR and AND operators may be used in thefollowing format:(<filter expression>) { OR | AND } (< filter expression>)

The parentheses around each expression are required. The following example doesnot contain a well-formed filter predicate because it contains three expressionsbeing joined into a single filter predicate:viewer -q "select default where (server = ’myserver’) AND (element = ’trace’)

AND (messageID=’DYKAL0001E’)"

This results in the following error:2002.04.10 14:52:19.755 com.tivoli.log.viewer.QueryTree labels Tivoli IVR 1

log viewer

myserver.mydoman.com IP IVR0019E unexpected character after query: AND

To avoid this error, ensure that each boolean expression has the form of(expression) AND (expression). In this case, the example should be written to jointhe first two expressions in one filter predicate, and the join the result of that withthe third expression (note the nested parentheses):viewer -q"select default where ((server = ’myserver’) AND (element = ’trace’))

AND (messageID = ‘DYKAL0001E’)"

The keyword true is a complete filter expression. It indicates that filtering isdisabled, and every log and trace record should be included in the output.

Specifying the Output FormatThe –s flag can be used to modify the format of the generated log output from thedefault HTML format. The ASCII output format is similar to that of the standardIBM Tivoli Service Level Advisor message and trace logs traceTSLA.log andmsgTSLA.log. However, with the ASCII and HTML log files generated through theLog Viewer, existing log records can be reformatted and filtered as desired.

Specifying Input XML FilesEach <input.xml> file specified should be one of the IBM Tivoli Service LevelAdvisor XML log files, or another Tivoli product log formatted in the TivoliCommon XML format. The IBM Tivoli Service Level Advisor log files,msgTSLAXML.log and traceTSLAXML.log are located in the Tivoli CommonDirectory and are denoted by the keyword XML. Specifying multiple input fileswill merge log records based on their timestamp. All files containing a space in thepath or filename must be encapsulated in double quotes. See the examples thatfollow for details.

Directing the OutputThe ASCII or HTML output generated by the XML Log Viewer is written to theconsole or command prompt from which the command was issued. To capture thisoutput and view it in HTML form using a Web browser, the output must beredirected to a file. You can direct the output to a file by specifying the > <outputfile> option of the viewer command.

The > (greater than) symbol notifies the system that the output is being redirectedto the name and location of the generated log file specified by <output file>. HTMLformatted files should use the file extension .html. ASCII formatted files may usethe preferred file extension for the intended viewer or platform.


Unless the fully qualified path to the output file is specified, the location of thegenerated log file is the current directory from which the command was issued.You can choose to move files or specify the output location as desired. Similar tospecifying the input file, any output file specified with a space in the name or pathmust be encapsulated in double quotes.

Examples1. Write the default field list of all message and trace records in HTML, and direct

the output to msgTSLAHTML1.html in the Tivoli Common Directory:viewer C:\TSLA\DYK\logs\SLMServer\msgTSLAXML1.log

C:\TSLA\DYK\logs\SLMServer\traceTSLAXML1.log

> C:\TSLA\DYK\logs\SLMServer\msgTSLAHTML1.html

In the above example, two log files are specified as input, msgTSLAXML1.logand traceTSLAXML1.log, and the > symbol is used to indicate that the outputshould be redirected to the HTML file. HTML format is the default.

2. Display all fields with a Message log record severity of WARNING or ERROR,or a Trace log record level of MIN. The output is not redirected to an outputfile, but is written to the command prompt on the console.viewer -q "select all where (Severity<INFO) OR (TraceLevel=MIN)"

–s ascii

C:\TSLA\DYK\logs\SLMServer\msgTSLAXML1.log

C:\TSLA\DYK\logs\SLMServer\traceTSLAXML1.log

In this example, the query string is specified using the all keyword. SpecifyingSeverity<INFO will return all messages with a severity of WARNING or ERROR.Note that the format requested is ASCII, and the two input log files arespecified, but no output file is specified, which directs the result to the consoleor command prompt from which the command was issued.

3. Display the Component, SourceFile, SourceMethod, Message ID, and LogTextcolumns, and fields with a timestamp less than 1007067881373. Timestamp isthe only column name that takes a numeric argument instead of a string.Output is in ASCII format, written to stdout, and all XML files in the currentdirectory are processed.viewer -q "select component, sourcefile, sourcemethod, messageid, logtext where

Millis < 1007067881373" –s ascii *XML*.log

In this example, the desired columns are specified, separated by commas, andthe timestamp is specified in milliseconds. Output format is specified as ASCIIusing the –s option, and the wildcard asterisk (*) characters are used to specifyall input log files whose names contain the characters XML.



Appendix. Notices

This information was developed for products and services offered in the U.S.A.IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user’s responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not give youany license to these patents.You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia CorporationLicensing2-31 Roppongi 3-chome, Minato-kuTokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION ″AS IS″ WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certaintransactions, therefore, this statement might not apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.


IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (I) the mutual use of theinformation which has been exchanged, should contact:

IBM Corporation2Z4A/10111400 Burnet RoadAustin, TX 78758 U.S.A.

Such information may be available, subject to appropriate terms and conditions,including in some cases payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurement may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

All statements regarding IBM’s future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. You may copy,modify, and distribute these sample programs in any form without payment to


IBM for the purposes of developing, using, marketing, or distributing applicationprograms conforming to IBMs application programming interfaces.

TrademarksThe following terms are trademarks of International Business MachinesCorporation in the United States, other countries, or both: IBM, the IBM logo,Tivoli, the Tivoli logo, AIX, Tivoli Enterprise, Tivoli Enterprise Console, DB2, DB2Universal Database, WebSphere.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks ofMicrosoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and othercountries.

Java and all Java-based trademarks and logos are trademarks or registeredtrademarks of Sun Microsystems, Inc. in the United States and other countries.

Other company, product, or service names may be trademarks or service marks ofothers.

Appendix. Notices 185


Index

Aaccount

user, changing authentication 131account, user

create 128active retry state 63, 65

showing 70addApplicationData 36addUser 128adjustIDGenerator 92application filter

enabled/disabled 40list applications by 40

application problem eventsdisabling escalation 25enabling escalation 26

application, add to SLM environment 36authentication

list users 136authentication information,

changing 131

Bbackup procedure 167bundle name

scmd syntax 1

Ccached events

flushing 20cached events, checking 20central data warehouse

disabling data from 37enabling data from 39

changeUser 131checkCache 20, 28checking for cached events 20CLI commands

general 9CLI Commands

list and help methods 4CLI password

enabling and disabling 16CLI password, resetting 5CLI Service

additional information 3commands 5connections 3password, resetting 158port number, retrieving 158port number, setting 158using 4

CLI service password, setting 14cliutil 158collector type, displaying 110command environment

initializing 170

command line interfaceusing 3

componentstarting 145status, display 138stopping 146

componentsmanaged by SLM Server, list 143

connections 148list number held by data

collector 148customer

displaying information for associatedorder 107

information, displaying 96, 106order, displaying information 108

customer orderredeploying 76submit 78

customizing e-mail notification 21

Ddata

disabling transfer 37enabling transfer 39expiration, set days 46

data collectornumber of connections 148retry operation, set number of

retries 152retry operation, set wait time between

retries 153settings, list 151start/stop messages, disabling 155start/stop messages, enabling 155

data expiration, get number of days 41data, registering in warehouse 125database connections

listing number of 148database operation

number of retries, setting 152wait time between retries, setting 153

datasourcemodifying information 161

delete user 133deleteUser 133diagnostic information, dumping 159diagnostic information, write to zip

file 159diagutil 159disable data transfer 37disable event escalation 25disabling CLI password protection 16display IDs

service orders 67displayActiveServiceElements 93displayAllCustomerOrders 94displayAllCustomers 96displayAllRealms 97displayAllSchedules 98

displayAllServiceOfferings 99displayBaseCustomerOrders 102displayBusinessSchedules 104displayCustomerByID 106displayCustomerFromOrderID 107displayCustomerOrderByID 108displayCustomerOrderState 109displayDataCollectorType 110displayMilestoneSchedules 111displayOfferingElementList 112displayOfferingScheduleName 113displayOfferingState 114displayOrderMetricPropertyID 115displayScheduleByName 116displayServiceOfferingByID 117displayServiceOfferingID 119displayServiceOfferingName 120displayServiceOfferingsByState 121dsutil 161dyk_cat

getting version 43dyk_dm

getting version 42

Ee-mail messages, customizing 21e-mail notification

testing 33e-mail notification, disabling 25e-mail notification, enabling 26enable application 36enable data transfer 39enable event escalation 26enabling CLI password protection 16entry

stopped retry, removing 63escalate

checkCache 20, 28customize 21disable 25enable 26flush 20, 28help 29list 30, 31snmp FormatDateTime 32test 33view 34

escalationapplication problem events,

disabling 25application problem events,

enabling 26formatting SNMP Trap DateTime

value 32methods, viewing

enabled/disabled 34parameters, viewing 34testing the enabled method 33

etladdApplicationData 36


etl (continued)disable 37enable 39getApps 40getDataExpiration 41getDMVersion 42getMMVersion 43help 44list 45setDataExpiration 46

ETL notification polling time,setting 154

evaluationretrying for missed intervals 65

evaluation, setting maximum number ofthreads 89

eventformatting SNMP Trap DateTime

value 32sending a sample 33

event escalation, disabling 25event escalation, enabling 26events

cached 20flushing cached 20persisted, flushing 60

expirationdata in SLM Database 41, 46

Ffilter logging object

change properties 48display properties of 48

flushEvents 60flushing cached events 20flushing TEC events 28

GgetApps 40getAssociatedCustomerOrderID 122getComponentStatus 138getDataExpiration 41getDMVersion 42getMMVersion 43getport 80getStatus 139

Hhandler logger

properties, change 50properties, display 50

helpCLI commands 4etl 44log 52om bundle 74rcc 81scheduler 86slm 141

help mem 61help scmd, general 10help sla 134help wdccli 149

help, escalate 29hours

maximum for scheduling activities tocomplete, listing 88

IIBM Tivoli Service Level Advisor

backup procedure 167restart after restore 174restore procedure 171start component 145stop component 146

ID Generator, adjusting 92initializing the command

environment 170instances

of metric evaluators, showing 68intervals, retrying missed 65

Llist

CLI commands 4list etl 45list mem 62list om 75list rcc 82, 87list scmd, general 13list sla 135list slm 142list wdccli 150list, escalate 30, 31listComponents 143listSettings 88, 151listUser 136log

filter 48handler 50help 52list 53message 54scmd example 2trace 56

log commands, listing 53log files, processing in XML format 177log messages

data collector start/stopenable/disable 155

logging objectfilter, properties 48

logging objectschange properties of 164display properties of 164

logutil 164

Mmem

flushEvents 60help 61list 62removeStoppedRetryEntries 63retryMissedIntervals 65showAllOrderIDs 67showMetricEvaluators 68

mem (continued)showRetrys 70trending 72

message loggerproperties, change 54properties, display 54

methodscmd syntax 1

metricproperty ID, displaying 115

Metric evaluatorreloading orders 76

Metric Evaluator Managerflushing events from 60

metric evaluatorsinstances, show information 68

missed intervals, retrying 65

Nnon-CLI Service commands 3notification

e-mail, customizing 21

Ooffering

contents, displaying 117displaying 99elements, displaying 112ID, displaying 119in particular state, displaying 121name, displaying 120state, displaying 114

omhelp 74list 75submitCustomerOrder 78

optionsscmd syntax 1

orderbase customer, displaying 102displaying associated customer

information 107displaying information 94, 108displaying the state of 109ID, associated with cancel or change

order ID 122orders

displaying 67redeploy 76

Ppassword

CLI Service, resetting 158enabling protection for CLI

commands 16forgotten CLI 5setting the CLI 14

password protection 1, 5polling time, setting for ETL

notification 154port

remote communication, list 80remote communication, set 83


port numberCLI Service

retrieving 158setting 158

Rrcc

getport 80help 81list 82, 87setport 83

rcomutil 165realm

information, displaying 97reDeployCompletedCustomerOrders 76registerWarehouseData 125remote communication

display, set host name 165display, set port 165port, setting 83

remote communication portlist 80

removeStoppedRetryEntries 63removing stopped retry entries 63resetting CLI password 5restore procedure 171restore process

restarting after restore 174retry state

retrying trends and evaluations 65retryMissedIntervals 65

Sschedule

business, displaying 104contents, displaying 116displaying 98milestone, displaying 111name, displaying 113

scheduleirsetMaxEvaluationThreads 89

schedulerhelp 86listSettings 88setMaxTimeForForcedScheduling 90

scheduler settings, listing currentstate 88

schedulingforced requests, setting maximum

time 90scmd

bundle name 1bundle names 5escalate

checkCache 20, 28customize 21disable 25enable 26flush 20, 28help 29list 30, 31snmp FormatDateTime 32test 33view 34

scmd (continued)etl

addApplicationData 36disable 37enable 39getApps 40getDataExpiration 41getDMVersion 42getMMVersion 43help 44list 45setDataExpiration 46

help 10list 13log

filter 48handler 50help 52list 53message 54trace 56

memflushEvents 60help 61list 62removeStoppedRetryEntries 63retryMissedIntervals 65showAllOrderIDs 67showMetricEvaluators 68showRetrys 70trending 72

method 1om

help 74list 75submitCustomerOrder 78

options 1password protection 1rcc

getport 80help 81list 82, 87setport 83

schedulerhelp 86listSettings 88setMaxEvaluationThreads 89

sdcadjustIDGenerator 92displayActiveServiceElements 93displayAllCustomerOrders 94displayAllCustomers 96displayAllRealms 97displayAllSchedules 98displayAllServiceOfferings 99displayBaseCustomerOrders 102displayBusinessSchedules 104displayCustomerByID 106displayCustomerFromOrderID 107displayCustomerOrderByID 108displayCustomerOrderState 109displayDataCollectorType 110displayMilestoneSchedules 111displayOfferingElementList 112displayOfferingScheduleName 113displayOfferingState 114

scmd (continued)sdc (continued)

displayOrderMetricPropertyID 115displayScheduleByName 116displayServiceOfferingByID 117displayServiceOfferingID 119displayServiceOfferingName 120displayServiceOfferingsByState 121getAssociatedCustomerOrderID 122help 123list 124registerWarehouseData 125

setPassword 14setPasswordEnabled 16sla

addUser 128changeUser 131deleteUser 133help 134list 135listUser 136

slmgetComponentStatus 138getStatus 139help 141list 142listComponents 143shutdown 144startComponent 145stopComponent 146

syntax 1syntax help 10wdccli

connections 148help 149list 150listSettings 151setConRetries 152setConWait 153setETLPoll 154setLogStartEnd 155

sdcadjustIDGenerator 92displayActiveServiceElements 93displayAllCustomerOrders 94displayAllCustomers 96displayAllRealms 97displayAllSchedules 98displayAllServiceOfferings 99displayBaseCustomerOrders 102displayBusinessSchedules 104displayCustomerByID 106displayCustomerFromOrderID 107displayCustomerOrderByID 108displayCustomerOrderState 109displayDataCollectorType 110displayMilestoneSchedules 111displayOfferingElementList 112displayOfferingScheduleName 113displayOfferingState 114displayOrderMetricPropertyID 115displayScheduleByName 116displayServiceOfferingByID 117displayServiceOfferingID 119displayServiceOfferingName 120displayServiceOfferingsByState 121getAssociatedCustomerOrderID 122

Index 189

sdc (continued)help 123list 124registerWarehouseData 125

service elementactive, displaying 93

service orderdisplaying IDs 67

setConRetries 152setConWait 153setDataExpiration 46setETLPoll 154setLogStartEnd 155setMaxEvaluationThreads 89setMaxTimeForForcedScheduling 90setPassword 4, 9, 14setPasswordEnabled 4, 9, 16setport 83settings

data collector 151showAllOrderIDs 67showMetricEvaluators 68showRetrys 70shutdown

SLM Server 144sla

addUser 128changeUser 131deleteUser 133help 134list 135listUser 136

slmgetComponentStatus 138getStatus 139help 141list 142listComponents 143shutdown 144startComponent 145stopComponent 146

SLM Databasedata expiration 41disabling data transfer to 37enabling data transfer to 39get version 43redeploy orders to MEM 76set data expiration 46submit order to OM 78

SLM Measurement Data Martget version 42missed intervals, retrying 65retry states, showing 70stopped retry entries

removing 63SLM Reports

partial or missing data 65SLM Server

list components managed by 143registering warehouse data 125remote communication

display, set host name 165display, set port 165

show status 139shutdown 144

slmbackup 167slmenv 170

slmrestore 4, 171slmrestorerestart 174snmp FormatDateTime, escalate 32SNMP trap notification

testing 33SNMP trap notification, disabling 25SNMP trap notification, enabling 26startComponent 145status

display for component 138SLM Server, show 139

stopComponent 146stopped retry entries, removing 63stopped retry state 63, 65

showing 70submitCustomerOrder 78

TTEC event notification

testing 33TEC event notification, disabling 25TEC event notification, enabling 26TEC events

flushing 28test, escalate 33threads

maximum for metric evaluation,listing 88

threads, setting maximum forevaluation 89

trace loggerproperties, change 56properties, display 56

trendretrying for missed intervals 65

trend intervals, displaying andsetting 72

trending 72

Uuser

delete from database 133user account

changing 131user account, create 128user authentication

changing consumer 131changing portal page 131changing realm 131changing view 131

user information, list 136utilities

cliutil 158diagutil 159dsutil 161logutil 164non-CLI service 3rcomutil 165slmbackup 167slmenv 170slmrestore 171slmrestorerestart 174verutil 175viewer 177

Vversion

of SLM Database, getting 43of SLM Measurement Data Mart,

getting 42version information, checking consistency

with release or fix pack 175version information, displaying 175verutil 175view escalate 34viewer 177violation

e-mail message,specifyingtrende-mail message, specifyingtrend

cancelled 21

Wwdccli

connections 148help 149list 150listSettings 151setConRetries 152setConWait 153setETLPoll 154setLogStartEnd 155

XXML format,log files 177


��

Printed in U.S.A.

SC32-0833-02

Documents

publib.boulder.ibm.compublib.boulder.ibm.com/tividd/td/TSLA/SC32-0833-02/en_US/... · 2005-04-01 · scmd sdc displayAllCustomers ........96 scmd sdc displayAllRealms .........97