IBM Tivoli Monitoring for Applications: mysap.com. Reference Guide. Version SC

Transcription

1 IBM Tivoli Monitoring for Applications: mysap.com Reference Guide Version SC

2

3 IBM Tivoli Monitoring for Applications: mysap.com Reference Guide Version SC

4 IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Reference Guide Copyright Notice Copyright IBM Corporation All rights reserved. May only be used pursuant to a Tivoli Systems Software License Agreement, an IBM Software License Agreement, or Addendum for Tivoli Products to IBM Customer or License Agreement. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without prior written permission of IBM Corporation. IBM Corporation grants you limited permission to make hardcopy or other reproductions of any machine-readable documentation for your own use, provided that each such reproduction shall carry the IBM Corporation copyright notice. No other rights under copyright are granted without prior written permission of IBM Corporation. The document is not intended for production and is furnished as is without warranty of any kind. All warranties on this document are hereby disclaimed, including the warranties of merchantability and fitness for a particular purpose. U.S. Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation. Trademarks IBM, the IBM logo, Tivoli, the Tivoli logo, AIX, OS/390, OS/400, OS/2, MVS, DB2, NetView, Tivoli Enterprise, Tivoli Enterprise Console, MQSeries, Tivoli Ready, and TME are trademarks or registered trademarks of International Business Machines Corporation or Tivoli Systems Inc. in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names mentioned in this document may be trademarks or servicemarks of others. Notices References in this publication to Tivoli Systems or IBM products, programs, or services do not imply that they will be available in all countries in which Tivoli Systems or IBM operates. Any reference to these products, programs, or services is not intended to imply that only Tivoli Systems or IBM products, programs, or services can be used. Subject to valid intellectual property or other legally protectable right of Tivoli Systems or IBM, any functionally equivalent product, program, or service can be used instead of the referenced product, program, or service. The evaluation and verification of operation in conjunction with other products, except those expressly designated by Tivoli Systems or IBM, are the responsibility of the user. Tivoli Systems or IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, New York , U.S.A.

5 Contents Preface v Who Should Read This Guide v Publications v IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Library v Prerequisite publications v Related publications vi Accessing Publications Online vi Accessing Publications on the Product CD.... vi Ordering Publications vii Providing Feedback about Publications..... vii Contacting Customer Support vii Conventions used in this guide vii Terminology vii Typeface conventions viii Operating system-dependent variables and paths viii Chapter 1. Introduction Running Tivoli commands Running Tivoli commands on UNIX operating systems Running Tivoli commands on Windows NT operating systems Where to find additional information about shells 2 Establishing the Tivoli environment within a shell 2 Establishing the Tivoli environment on an endpoint Tivoli command syntax Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models How this Manual is Organized List of Available Resource Models Application Server Monitor resource model Internet Transaction Server Monitor resource model. 9 Buffer Monitor resource model Extended Memory Monitor resource model mysapfilesystem Monitor resource model Transaction Performance resource model User Performance resource model Jobs resource model Response Time Analysis resource model Database Connection resource model Chapter 3. Tasks for managing mysap.com resources Configuration tasks Check Status Configure Event Adapter Configure Event Server Configure Remote Function Call Configure Systems Management Deploy Event Adapter Files Discover Display Event Adapter Install Event Adapter List RFC Information Rediscover Report Management Configuration Synchronize mysap Objects on TBSM Uninstall Event Adapter Verify Remote Function Call Create Tasks Create mysapappserver Create mysapdbserver Create mysapitsserver Create mysapsystem Create mysapitsserver Move mysap System Application Server Tasks Cancel Batch Job Cancel Work Process Display Batch Jobs Display Buffer Information Display OS Collect Information Display OS390 DB2 Information Display OS390 Information Display Roll Page Information Display Work Processes Release Batch Job Start Event Adapter Start Server Stop Event Adapter Stop Server DB ServerTasks Start Database Stop Database Internet Transaction Server tasks Start Database Stop Database System Tasks Configure Systems Management Identify mysap System Type Move mysap System List Maintenance Tasks Create New Subscriber List Notices Trademarks Index iii

6 iv IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

7 Preface Who Should Read This Guide Publications The IBM Tivoli IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com User s Guide provides detail information about the monitors for IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com. Use this guide in conjunction with the IBM Tivoli Monitoring for mysap.com User s Guide. This guide is for system administrators who monitor and manage mysap.com resources. Readers should have administrator-level understanding of Tivoli management software, UNIX and Windows operating systems, databases, and mysap.com. Readers should be familiar with the following: v Windows NT or UNIX operating systems v Tivoli software This section lists the publications in the IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com library and any other related documents. It also describes how to access Tivoli publications online, how to order Tivoli publications, and how to make comments on Tivoli publications. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Library The following documents are available in theibm Tivoli Monitoring for Applications, Version 5.1.0: mysap.com library: v IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com User s Guide Provides information about how to manage mysap.com resources with IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com. v IBM Tivoli Monitoring for Appplications, Version 5.1.0: mysap.com Reference Guide Provides information about the resource models that IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com provides Prerequisite publications To be able to use the information in this guide effectively, you must have some prerequisite knowledge, which you can get from the following publications: v IBM Tivoli Monitoring for Applications, Version 5.1.0: Installation and Setup Guide Provides information about installing the IBM Tivoli Monitoring for Applications, Version product. v IBM Tivoli Monitoring for Applications, Version 5.1.0: Release Notes Provides information about system requirements and specific information related to each component of the IBM Tivoli Monitoring for Applications, Version product. v IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Limitations and Workarounds Supplement v

8 Provides late-breaking information about the defects, limitations, and workarounds related to IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com. Related publications The following documents also provide useful information related to IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com: v v v v v v v v v v v v v v v v Tivoli Software Installation Service User s Guide Tivoli Inventory User s Guide Tivoli Framework User s Guide Tivoli Framework Planning and Installation Guide Tivoli Framework Reference Manual Tivoli Software Distribution User s Guide Tivoli Software Distribution Reference Manual Tivoli Enterprise Console User s Guide Tivoli Enterprise Console Reference Manual Tivoli Enterprise Console Rule Builder s Guide Tivoli Enterprise Console Event Integration Facility Guide The mysap.com product documentation The Tivoli Business Systems Manager product documentation TSO/E REXX Reference IBM Tivoli Data Warehouse product documentation IBM Tivoli Monitoring (Advanced Edition) product documentation Accessing Publications Online Tivoli Monitoring for Applications mysap.com documentation is available in the following online formats on both the Tivoli Monitoring for Applications Publications CD and the Tivoli Web site: v v Portable Document Format (.pdf), which you can view or print using the Adobe Acrobat Reader. If you do not already have Adobe Acrobat Reader, you can obtain it for free by clicking the Get Acrobat Reader icon at the Adobe Web site, and following the steps that are provided. Hypertext Markup Language (.htm), which you can view using your default Web browser. Accessing Publications on the Product CD The following.pdf and the.htm documentation files are available on thetivoli Monitoring for Applications publications CD in the /??? directory and are also installed with the product in the $BINDIR/../generic_unix/TME/SAP/doc/ directory: Document IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com User s GuideIBM Tivoli Monitoring for Appplications, Version 5.1.0: mysap.com Reference Guide Files v s51u.pdf v s51utfrm.htm (frames version) v s51u.htm (non-frames version) v s51r.pdf v s51rtfrm.htm (frames version) v s51r.htm (non-frames version) vi IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

9 Note: The IBM Tivoli Monitoring for Appplications: mysap.com Workarounds and Limitations Supplement document is not provided on the Tivoli Monitoring for Applications Publications CD. Ordering Publications You can order many Tivoli publications online at the following Web site: You can also order by telephone by calling one of these numbers: v In the United States: v In Canada: v In other countries, for a list of telephone numbers, see the following Web site: Providing Feedback about Publications We are very interested in hearing about your experience with Tivoli products and documentation, and we welcome your suggestions for improvements. If you have comments or suggestions about our products and documentation, contact us in one of the following ways: v Send an to pubs@tivoli.com. v Complete our customer feedback survey at the following Web site: Contacting Customer Support If you have a problem with any Tivoli product, you can contact Tivoli Customer Support. See the Tivoli Customer Support Handbook at the following Web site: The handbook provides information about how to contact Tivoli Customer Support, depending on the severity of your problem, and the following information: v Registration and eligibility v Telephone numbers and addresses, depending on the country you are in v What information you should gather before contacting support Conventions used in this guide This book uses several conventions for special terms and actions and operating system-dependent commands and paths. Terminology This guide uses several conventions for special terma and actions and operating system-dependent commands and paths. This guide uses the term... Distributed To refer to... Non-z/OS platforms (AIX, HP-UX, Solaris, Windows NT, and Windows 2000) Preface vii

10 This guide uses the To refer to... term... UNIX AIX, HP-UX, and Solaris Windows Windows NT and Windows 2000 For a complete glossary of Tivoli and related terms, refer to the glossary at the following Web site: Typeface conventions The following typeface conventions are used in this book: Bold Italic Monospace Lowercase and mixed-case commands, command options, and flags that appear within text appear like this, in bold type. Graphical user interface elements (except for titles of windows and dialogs) and names of keys also appear like this, in bold type. Variables, values you must provide, new terms, and words and phrases that are emphasized appear like this, in italic type. Commands, command options, and flags that appear on a separate line, code examples, output, and message text appear like this, in monospace type. Names of files and directories and text strings you must type, when they appear within text, also appear like this, inmonospace type. Operating system-dependent variables and paths This book uses the UNIX convention for specifying environment variables and for directory notation. When using the Windows command line, replace $variable with %variable% for environment variables and replace each forward slash (/) with a backslash (\) in directory paths. Note: If you are using the bash shell on a Windows system, you can use the UNIX conventions. viii IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

11 Chapter 1. Introduction Running Tivoli commands This book is a reference manual designed for use with the procedures described in the IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com User s Guide. It provides an alphabetical listing and detailed descriptions of the resource models. Tivoli commands enable you to perform system operations from a UNIX or Windows NT command line interface (CLI) instead of using the Tivoli desktop. The term, Tivoli CLI commands, is another way to refer to these commands. It is often convenient or more appropriate to invoke a Tivoli management application operation from the command line instead of from the graphical user interface. This is the case in the following examples: v v You do not have access to a graphical user interface, such as when you dial in over a modem. You are grouping a number of operations together inside a shell script. All Tivoli CLI commands begin with the letter w to identify them as Tivoli commands. Command names use a w+verb+object syntax, which matches the way you would think of the action. For example, to create a monitor, use the waddmon command. To delete a monitor, use the wdelmon command. Most Tivoli commands run within a shell on a managed node or on a TMR server. A shell is a command interpreter that enables the operating system to process commands. You can run commands from a shell command line or include them in shell scripts, on either UNIX or Windows NT operating systems. Before running Tivoli commands, you must set the Tivoli environment variables for the shell. The managed node or TMR server installation process supplies the scripts to set the Tivoli environment variables. The following sections of this guide contain descriptions of the procedures to run these scripts: Setting the Tivoli environment on UNIX operating systems on page 3 and Setting the Tivoli environment on Windows NT operating systems on page 3. You must also have the appropriate Tivoli authorization role for running each command. Refer to the reference information for each command to see the required authorization role. Note: A few Tivoli commands can run on an endpoint. To set the Tivoli environment variables on an endpoint, see Establishing the Tivoli environment on an endpoint on page 3. Running Tivoli commands on UNIX operating systems The UNIX operating systems contain shells. Tivoli commands can run in the Bourne, Korn, C, and bash shells. The Bourne shell is the standard UNIX shell. Every UNIX system includes the Bourne shell. The Korn shell supports the features of the Bourne shell and has extensions applicable only to the Korn shell. The C 1

12 Introduction shell name comes from the C programming language syntax. The bash shell supports many features of the UNIX shells. Both UNIX and Windows NT systems use the bash shell. Running Tivoli commands on Windows NT operating systems When you install a Windows NT managed node or Windows NT TMR server, the installation process copies the bash shell executable file to the machine. The bash shell supports many UNIX commands and UNIX command syntax. An example is the forward slash (/) for the directory separator. The bash shell supports the features of the Bourne shell plus it has some extensions applicable only to the bash shell. Note: You can use the Windows NT MS-DOS shell instead of the bash shell to run most Tivoli commands (after you set the Tivoli environment variables with the %SystemRoot%\system32\drivers\etc\Tivoli\setup_env command). However, some commands and Tivoli tasks may require a bash shell to run successfully. All examples of Tivoli commands in Tivoli publications use bash shell syntax. Where to find additional information about shells The following lists include resources where you can find additional information about the various shells. These resources were available at the time the lists were created. The lists do not show all of the material that is available, and Tivoli does not provide opinions or recommendations about any of these resources. UNIX shells: v UNIX in a Nutshell: A Desktop Quick Reference for System V Release 4 and Solaris 7 (O Reilly Nutshell handbook) by Arnold Robbins. ISBN: v Portable Shell Programming: An Extensive Collection of Bourne Shell Examples by Bruce Blinn. ISBN: v Learning the Korn Shell (O Reilly Nutshell handbook) by Bill Rosenblatt and Mike Loukides. ISBN: v UNIX C Shell Desk Reference by Martin Arick. ISBN: Bash shell: v Learning the bash Shell (O Reilly Nutshell handbook) by Cameron Newham and Bill Rosenblatt. ISBN: v A Brief Introduction to the bash Shell by Jane Anna Langley. v Bash FAQ (GNU documentation). v Bash Reference Manual (GNU documentation). v bash command reference information (GNU documentation). Establishing the Tivoli environment within a shell When you install a managed node or TMR server, the installation process supplies shell setup scripts. You use these scripts to set the environment variables needed for running Tivoli commands. 2 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

13 Setting the Tivoli environment on UNIX operating systems The following steps describe how to set the Tivoli environment within a UNIX shell: 1. Log in to a UNIX managed node or Tivoli server. 2. Run the appropriate setup script for the shell. For the Bourne, Korn, or bash shell, run the following command:. /etc/tivoli/setup_env.sh For the C shell, run the following command: source /etc/tivoli/setup_env.csh Setting the Tivoli environment on Windows NT operating systems The following steps describe how to set the Tivoli environment and start a bash shell on Windows NT. 1. Log in to a Windows NT managed node or Tivoli server. 2. Open a command window. 3. Run the following command in the command window to set Tivoli environment variables: %SystemRoot%\system32\drivers\etc\Tivoli\setup_env.cmd 4. Run one of the following commands in the command window to start the bash shell: sh OR bash Establishing the Tivoli environment on an endpoint When you install an endpoint, the installation process supplies setup scripts. Use these scripts to set the environment variables needed for running Tivoli commands on an endpoint. The following steps describe how to set the Tivoli environment on an endpoint: 1. Log in to an endpoint. 2. Open a command window. 3. Run the appropriate setup script in the command window. The following table contains setup scripts for the different endpoint operating systems. Table 1. Setup scripts for endpoint operating systems Operating System Setup Script Location Setup Script Name AIX, Solaris /etc/tivoli/lcf/endpoint_label lcf_env.sh (for Bourne, Korn, and bash shells) OR Introduction lcf_env.csh (for C shell) Windows NT %SystemRoot%\Tivoli\lcf\ endpoint_label lcf_env.cmd (for MS-DOS) or lcf_env.sh (for bash shell) Chapter 1. Introduction 3

14 Introduction Tivoli command syntax The following special characters define Tivoli command syntax: [] Identifies elements that are optional. Required elements do not have brackets around them.... Indicates that you can specify multiple values for the previous element. Separate multiple values by a space, unless otherwise directed by command information. If the ellipsis for an element follows a closing bracket, use the syntax within the brackets to specify multiple values. For example, to specify two administrators for the option [ a admin]..., use a admin1 a admin2. If the ellipsis for an element is within the brackets, use the syntax of the last element to specify multiple values. For example, to specify two hosts for the option [ h host...], use h host1 host2. Indicates mutually exclusive information. You can use the element on either the left or right of the vertical bar. {} Delimits a set of mutually exclusive elements when a command requires one of them. Brackets ([ ]) are around elements that are optional. In addition to the special characters, Tivoli command syntax uses the typeface conventions described in the Preface of this document. The following examples illustrate the typeface conventions used in Tivoli command syntax: v wcrtpr [ a admin]... [ s region] [ m resource]... name The name argument is the only required element for the wcrtpr command. The brackets around the options indicate they are optional. The ellipsis after the a admin resource option means that you can specify multiple administrators multiple times. The ellipsis after the m resource option means that you can specify multiple resources multiple times. v wchkdb [ o outfile] [ u] [ x] { f infile i object...} The f, i, and object elements are mutually exclusive. Braces that surround elements indicate that you are including a required element. If you specify the object argument, you can specify more than one object. 4 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

15 Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models How this Manual is Organized The manual is organized alphabetically by monitoring collection. Each monitor is divided into the following sections: v Description. A brief description of the task or monitor. v v v v v v Authorization Role. The permissions an administrator needs to run the task or monitor. Target Endpoint. The Tivoli resource to which a monitor or task is distributed. GUI Data Entry Fields. A description of each field on a specific monitor or task dialog. Output. An example output for each task and monitor. Usage Notes. Any additional information about a task or monitor. See Also. A list of related monitors. List of Available Resource Models The following table lists the available resource models for IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com: Table 2. The following table lists the IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com resource models. GUI Name CLI Name Monitor Number Log File Application Server Monitor resource model on page 6 Internet Transaction Server Monitor resource model on page 9 mysap_basisapplserver Monitor mysap_basisitsserver Monitor 1 No 2 No Buffer Monitor resource model on page 12 mysap_buffer 3 No Extended Memory Monitor resource model on page 15 mysap_memory 4 No mysapfilesystem Monitor resource model on page 23 mysap_filesystem 5 No Transaction Performance resource model on page 26 mysap_transactionperformance7 Yes User Performance resource model on page 35 mysap_user_performance 8 Yes Jobs resource model on page 41 mysap_job 9 Yes Response Time Analysis resource model on page 43 Response_Time_ Analysis 10 Yes Database Connection resource model on page 46 mysap_databaseconnection 11 Yes 5

16 Application Server Monitor resource model Description Checks that a mysap.com application server is available and reports on the status of the server. The main function of this resource model is to report status of the mysap.com Basis application server. This resource model should be used every 60 seconds to determine status. If mysap.com performance and network congestion is an issue with this interval, you can analyze the specific network and mysap.com systems to determine a more appropriate interval. This resource model monitors the status of an application server regardless of the type, such as Dialog Instance or Central Instance. You can obtain the status by pinging the target application server and attempting a Remote Function Call (RFC) logon. The status is determined based on the results of these two operations. See Thresholds on page 7 for more information about server status. Note: : You cannot ping the target application server if you are using local management since the status is being checked on that host. For central management, you can ping the host and it should be included in the status check. If the status is DOWN, you should notify your mysap.com Basis administrator that the application servers are down. Resource model at a glance Internal name Category Indications APPL_SRV_STAT matches TSAP_BasisApplServer WizGenRM Tasks and built-in actions Clearing events Default cycle time Thresholds: v UP v Standby v Down v Unknown Parameters: v Par_APPL_SRV_STAT_eqs Yes Yes One minute Target managed resource mysap Application Server Indications and events The following table lists the events that can be generated by the mysap.com Application Server Status resource model, the name of the indication from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. 6 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

17 Indication Event Severity Page APPL_SRV_STAT matches Ev_TSAP_Basis_ApplServer_APPL_ SRV_STAT matches Critical 7 APPL_SRV_STAT indication This indication is sent when there is a change in status of the application server. The indication has the following attributes: Basis AppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) APPL_SRV_STAT Application server status. The state of functionality that an application server is currently in. This indication has the following thresholds: v Up v Down v Standby v Unknown For more information about these thresholds, see Thresholds. This indication has the following parameters: v Par_APPL_SRV_STAT_eqs For more information about these parameters, see Parameters on page 8. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 1 Holes 0 Associated built-in tasks Update icon status Thresholds The following table lists the thresholds that can be set for the Application Server Monitor resource model. For each threshold it shows the name, a short description, and the default value: Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 7

18 Threshold Description Default value Up The server is running and can be logged on. Standby The server is running, but not able to be logged on. Down The server is down Unknown The status of the server is unknown Parameters The resource model has the following parameters: Par_APPL_SRV_STAT_eqs When the property APPL_SRV_STAT is equal to one of the values of this parameter the event Ev_TSAP_BasisApplServer_APPL_SRV_STAT_matches is generated Associated tasks and built-in actions The resource model has the following tasks and built-in actions: Logging None. CLI example Update Icon Status If the current status of the application server is down, this action updates the status of the application server icon. Start application server If the application server is not running, this action restarts the application server. PROFILE="mySAP App Server Status#tric-region" wdmeditprf -P $PROFILE -add mysap_basisapplserver -c 60 \ -Log -LogDisable -p 12:00 -Agg yes -ap 00:15 -NoMin -NoMax -Avg \ -AddPar Par_APPL_SRV_STAT_eqs "down" \ -e mysap_application_server_status \ -o 1 -h 0 -severity CRITICAL -NoSendTBSM -SendTec 8 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

19 Internet Transaction Server Monitor resource model Description Detects and reports on the overall health of a mysap.com Internet Transaction Server (ITS). The main function of this resource model is to report status of the server. The status is obtained from reading the returned values of the SAP ITSVControl.exe program. The syntax of the command is itsvcontrol.exe /v virtual its name. You should run this resource model should every 60 seconds to determine status of the Internet Transaction server.. If mysap.com performance and network congestion is an issue with this interval, you can analyze the specific network and mysap.com systems to determine a more appropriate interval. If the status is DOWN, you should notify your mysap.com Basis administrator that the Internet Transaction servers are down. Resource model at a glance Internal name Category Indications ITS_SRV_STAT matches WizRM_TSAP_BasisITSServer mysap.com Tasks and built-in actions Clearing events Default cycle time Thresholds: v Up v Down v Unknown Parameters: v Par_ITS_SRV_STAT_eqs Yes Yes One minute Target managed resource mysap ITS server Indications and events The following table lists the events that can be generated by the mysap.com ITS Server Status resource model, the name of the indication from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. Indication Event Severity Page ITS_SRV_STAT matches ITS_SRV_STAT matches Critical 9 ITS_SRV_STAT matches indication This event is generated when the property ITS_SRV_STAT is equal to one of the values of the parameter ITS_SRV_STAT matching values The indication has the following attributes: Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 9

20 BasisITSSystemNumber The system identifier for an Internet Transaction Server in a mysap.com system. (Key attribute) BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) ITS_SRV_STAT ITS status. The state of functionality that an ITS server is currently in. (Key attribute) This indication has the following thresholds: v Up v Down v Unknown For more information about these thresholds, see Thresholds. This indication has the following parameters: v Par_ITS_SRV_STAT_eqs For more information about these parameters, see Parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 1 Holes 0 Associated built-in tasks Update icon status Thresholds The following table lists the thresholds that can be set for the Internet Transaction Server Monitor resource model. For each threshold it shows the name, a short description, and the default value: Threshold Description Default value Up The server is running Up Down The server is down Down Unknown The server status is unknown Unknown Parameters The resource model has the following parameters: Par_ITS_SRV_STAT_eqs When the property ITS_SRV_STAT is equal to one of the values of this parameter the event Ev_TSAP_BasisITSServer_ITS_SRV_STAT_matches is generated. 10 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

21 Associated tasks and built-in actions The resource model has the following tasks and built-in actions: Logging None. CLI example Update Icon Status If the current status of the ITS server is down, this action updates the status of the ITS server icon. Start ITS server If the ITS is not running, this action restarts the ITS server PROFILE="mySAP ITS Server Status#tric-region" wdmeditprf -P $PROFILE -add mysap_basisitsserver -c 60 \ -Log -LogDisable -p 12:00 -Agg yes -ap 00:15 -NoMin -NoMax -Avg \ -AddPar Par_ITS_SRV_STAT_eqs "down" \ -e mysap_its_server_status \ -o 1 -h 0 -severity CRITICAL -NoSendTBSM -SendTec Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 11

22 Buffer Monitor resource model Description Checks that the mysap.com application server buffers are available and reports on the status. This resource model detects and reports problems with the nine mysap.com application buffers. The buffer quality must be greater than 95% in order for an event to trigger. If buffer quality is over 95 percent, an event will be sent to the Tivoli Enterprise Console and to Tivoli Business Systems Manager. The buffer is compared to the buffer quality value for the nine SAP buffers obtained by the DataProvider Buffer ILT which calls Function Module J8C1, which contains the buffer information on the mysap.com Basis Application Server. You should run this resource model every five minutes to determine status. If mysap.com performance and network congestion is an issue with this interval, you can analyze the specific network and mysap.com systems to determine a more appropriate interval. If the status is DOWN, you should notify your mysap.com Basis Administrator that the application servers are down. Resource model at a glance Internal name Category Indications Tasks and built-in actions Clearing events Default cycle time Quality too high Thresholds: v Quality upper bound Parameters: v None TSAP_Buffer_Monitor mysap.com No No 5 minutes Target managed resource mysap.com application server Indications and events The following table lists the events that can be generated by the mysap.com Buffer Monitor resource model, the name of the indication from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. Indication Event Severity Page Quality too high TSAP_Buffer Critical 12 Quality too high indication This indication is used to detect buffers that are poorly tuned. The indication has the following attributes: 12 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

23 BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) QUALITY An attribute that describes the condition of a buffer. UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap resource. (Key attribute) BufferName The name that identifies a buffer. Program, SingleRecord, GenericKey, Screen, CUA, TableDefinition, FieldDescription, InitialRecords, ShortNameTab. (Key attribute) This indication has the following thresholds: v Quality upper bound For more information about these thresholds, see Thresholds. This resource model does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 11 Holes 0 Associated built-in tasks None Thresholds The following table lists the threshold that can be set for the Buffer Monitor resource model. For each threshold it shows the name, a short description, and the default value: Threshold Description Default value Quality When the QUALITY counter exceeds this threshold the EV_TSAP_Buffer_QUALITY_too_high event is generated 95 Parameters This resource model does not have parameters. Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 13

24 Logging None. CLI example TBD 14 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

25 Extended Memory Monitor resource model Description Checks for problems with application server working memory storage areas. These areas include page, roll, heap, and extended memory. Memory areas that reach a percent above the specified thresholds will trigger the generation of both a Tivoli Enterprise Console and a Tivoli Business Systems Manager event. The memory values are obtained by the Data Provider Memory ILT from these two function modules: v J8C1 Memory Roll/Page Sizes v J8C1 em/hm info Resource model at a glance You should run this resource model every 60 seconds to determine memory area status and problems with the Discover task. If mysap.com performance and network congestion is an issue with this interval, you can analyze the specific network and mysap.com systems to determine a more appropriate interval. If the status is DOWN, you should notify your mysap.com Basis administrator that the application servers are down. Internal name Category WizRM_TSAP_Memory mysap.com Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 15

26 Resource model at a glance Indications ROLL_MAX_USED too high Thresholds: v ROLL_MAX_USED_gt Parameters: v None MAX_Extended_Memory_PERCENT_USED value exceeded Thresholds: v Parameters: v None ROLL_MAX_PERCENT_USED too high Thresholds: v ROLL_MAX_PERCENT_USED Uppr bound Parameters: v None PAGE_AREA_PERCENT_USED value exceeded Thresholds: v PAGE_AREA_PERCENT_USED Upper bound Parameters: v None EXTENDED_PERCENT_USED too high Thresholds: v EXTENDED_PERCENT_USED upper bound Parameters: v None PAGE_AREA_MAX_PERCENT_USED value exceeded Thresholds: v PAGE_MAX_PERCENT_USED upper bound Tasks and built-in actions Clearing events Default cycle time Parameters: v None No No Five minutes Target managed resource mysap application server 16 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

27 Indications and events The following table lists the events that can be generated by the Memory resource model, the name of the indication from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. Indication Event Severity Page ROLL_MAX_USED too high TSAP_Roll_Area Critical 17 TSAP_Extended_Memory_PERCENT_USED value exceeded TSAP_Maximum_Extended_Memory_Exceeded Critical 18 ROLL_MAX_PERCENT_USED too high TSAP_Maxmimum_Roll_Area_Exceeded Critical 18 PAGE_AREA_PERCENT_USED value exceeded TSAP_Page Area Critical 19 EXTENDED_PERCENT_USED too high TSAP_ExtendedMemory Critical 20 PAGE_AREA_MAX_PERCENT_USED value exceeded TSAP_Maximum_Page_Area_Exceeded Critical 21 Roll_Max_Used too high indication This indication to detect and report that the current roll area threshold is exceeded. The indication has the following attributes: ROLL_MAX_PERCENT_USED Max roll area percent used. (Key attribute) BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap resource. (Key attribute) This indication has the following thresholds: v ROLL_MAX_PERCENT_USED upper bound For more information about these thresholds, see Thresholds on page 21. This indication does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 111 Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 17

28 Setting Default value Holes 0 Associated built-in tasks None MAX_Extended_Memory_PERCENT_USED value exceeded indication This indication is sent when the EXTENDED_MAX_PERCENT_USED attribute reaches its upper boundary. The indication has the following attributes: EXTENDED_MAX_PERCENT_USED TBD (Key attribute) BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) This indication has the following thresholds: v EXTENDED_MAX_PERCENT_USED upper bound For more information about these thresholds, see Thresholds on page 21. This resource model does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 3 Holes 0 Associated built-in tasks [built-in tasks] ROLL_MAX_PERCENT_USED too high indication This indication is sent when the ROLL_MAX_PERCENT_USED attribute exceeds the ROLL_MAX_PERCENT_USED Upbound threshold. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) UpBound TBD 18 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

29 ROLL_MAX_PERCENT_USED Max roll area percent used. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) This indication has the following thresholds: v ROLL_MAX_PERCENT_USED upper bound For more information about these thresholds, see Thresholds on page 21. This resource model does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 3 Holes 0 Associated built-in tasks None PAGE_AREA_PERCENT_USED value exceeded indication This indication is used to detect and report that the current extended memory threshold is exceeded. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) UpperBound A variable used when we are cycling through (looping) checks during RM processing. PAGE_AREA_PERCENT_USED TBD BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) This indication has the following thresholds: v PAGE_AREA_PERCENT_USED For more information about these thresholds, see Thresholds on page 21. Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 19

30 This indication does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 3 Holes 0 Associated built-in tasks None EXTENDED_PERCENT_USED indication This indication to detect and report that the maximum extended memory threshold is exceeded. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) UpperBound A variable used when we are cycling through (looping) checks during RM processing. EXTENDED_PERCENT_USED The percentage of extended memory used. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap resource. (Key attribute) This indication has the following thresholds: v EXTENDED_PERCENT_USED upper bound For more information about these thresholds, see Thresholds on page 21. This indication does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 3 Holes 0 Associated built-in tasks None 20 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

31 PAGE_AREA_PERCENT_USED value exceeded indication This indication to detect and report that the current page area threshold is exceeded. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) UpperBound A variable used when we are cycling through (looping) checks during RM processing. PAGE_AREA_PERCENT_USED The maximum page area percent used. (Key attribute) BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) This indication has the following thresholds: v PAGE_AREA_PERCENT_USED For more information about these thresholds, see Thresholds. This resource model does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 3 Holes 0 Associated built-in tasks None Thresholds The following table lists the thresholds that can be set for the Extended Memory Monitor resource model. For each threshold it shows the name, a short description, and the default value: Threshold Description Default value PAGE_AREA_PERCENT_USED When the counter PAGE_AREA_PERCENT_USED exceeds this threshold the event Ev_TSAP_Memory_PAGE_AREA_ exceeded is generated 85 Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 21

32 Threshold Description Default value ROLL_MAX_PERCENT_USED When the counter ROLL_MAX_PERCENT_USED exceeds this threshold the event Ev_TSAP_ExtendedMemory_ROLL_MAX _PERCENT_USED_too_high is generated 95 EXTENDED_PERCENT_USED When the counter EXTENDED_PERCENT_USED exceeds this threshold the event Ev_TSAP_ExtendedMemory_EXTENDED _PERCENT_USED_too_high is generated 85 Parameters This resource model does not have parameters. Associated tasks and built-in actions Logging None. CLI example TBD 22 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

33 mysapfilesystem Monitor resource model Description Checks that a mysap.com application server is available and reports problems with the SAP file systems on both Windows and UNIX systems. This resource model only reports the space used on specific mysap.com file systems. It does not monitor standard file systems. Use traditional ITM based resource models for those. This resource model will generate both a Tivoli Enterprise Console event and a Tivoli Business Systems Manager event when the percentage of inodes used used is over 90% on Windows and UNIX systems. You should run this resource model every 60 seconds to determine status. If mysap.com performance and network congestion is an issue, you should analyze the specific network and mysap.com systems to determine a more appropriate interval. Resource model at a glance Internal name Category Indications SPACE_USED_PERCENT too high WizRM_TSAP_FileSystem mysap.com Thresholds: v SPACE_USED_PERCENT Parameters: v None INODES_USED_PERCENT too high Thresholds: v INODES_USED_PERCENT Tasks and built-in actions Clearing events Default cycle time Parameters: v None No Yes Five minutes Target managed resource mysap application server Indications and events The following table lists the events that can be generated by the File System UNIX Monitor resource model, the name of the indication from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. Indication Event Severity Page SPACE_USED_PERCENT too Ev_TSAP_FileSystemUNIX_SPACE_USED_PERCENT_too_high Critical 24 high INODES_USED_PERCENT too high Ev_TSAP_FileSystemUNIX_INODES_USED_PERCENT_too_high Critical 24 Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 23

34 SPACE_USED_PERCENT too high indication This indication is sent when the SPACE_USED_PERCENT counter exceeds the SPACE_USED_PERCENT threshold. The indication has the following attributes: SPACE_USED_PERCENT The percentage of disk space used. UpperBound A variable used when we are cycling through (looping) checks during RM processing. Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) MountPoint The attachment name of a filesystem/volume or NFS volume (Key attribute) OperatingSystemName The operating system name. The type of operating system installed. (Key attribute) This indication has the following thresholds: v SPACE_USED_PERCENT For more information about these thresholds, see Thresholds on page 25. This indication does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 2 Holes 1 Associated built-in tasks None INODES_USED_PERCENT too high indication This indication is used to detect when the INODES_USED_PERCENT counter exceeds the threshold of the INODES_USED_PERCENT upper bound. The indication has the following attributes: INODES_USED_PERCENT The percent of disk inodes used. UpperBound A variable used when we are cycling through (looping) checks during RM processing. 24 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

35 Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) MountPoint The attachment name of a filesystem/volume or NFS volume (Key attribute) OperatingSystemName The operating system name. The type of operating system installed. (Key attribute) This indication has the following thresholds: v INODES_USED_PERCENT For more information about these thresholds, see Thresholds. This indication does not have any parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems No Manager Occurrences 2 Holes 1 Associated built-in tasks None Thresholds The following table lists the thresholds that can be set for the File System Unix Monitor resource model. For each threshold it shows the name, a short description, and the default value: Threshold Description Default value SPACE_USED_PERCENT INODES_USED_PERCENT When this threshold is exceeded, the SPACE_USED_PERCENT_too_high event is generated. When this threshold is exceeded, the INODES_USED_PERCENT event is generated Parameters This resource model does not have parameters. Associated tasks and built-in actions The resource model has the following tasks and built-in actions: Logging None. CLI example TBD Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 25

36 Transaction Performance resource model Description Checks for problems with the transactions running in dialog work processes. This resource model is separate from the Work Process resource model in that you may want to monitor all application servers in a similar manner for work processes, but you may want to monitor different sets of transactions on different application servers. This resource model should be used every three minutes to determine the transaction performance. If mysap.com transaction performance is an issue with this interval, you can analyze the specific network and mysap.com systems to determine a more appropriate interval. If the dialog processing time in the application server is slow, you should notify your mysap.com Basis administrator. Resource model at a glance Internal name Category Indications Slow Level 1 Server Response TSAP_Transaction mysap.com Thresholds: v Level 1 Server Response Time Parameters: v Level 1 Transaction List 26 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

37 Resource model at a glance Slow Level 1 Total Response Thresholds: v Level 1 Total Response Time Parameters: v Level 1 Transaction List Slow Level 2 Server Response Thresholds: v Level 2 Server Response Time Parameters: v Level 2 Transaction List Slow Level 2 Total Response Thresholds: v Level 2 Total Response Time Parameters: v Level 2 Transaction List Slow Level 3 Server Response Thresholds: v Level 3 Server Response Time Parameters: v Level 3 Transaction List Slow Level 3 Total Response Thresholds: v Level 3 Total Response Time Tasks and built-in actions Clearing events Default cycle time Parameters: v Level 3 Transaction List No Yes Three minutes Target managed resource mysap.com application server Indications and events The following table lists the events that can be generated by the Transaction Performance resource model, the name of the indication from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. Indication Event Severity Page Slow Level 1 Server Slow Level 1 Server Response Minor 28 Response Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 27

38 Indication Event Severity Page Slow Level 1 Total Response Slow Level 2 Server Response Slow Level 2 Total Response Slow Level 3 Server Response Slow Level 3 Total Response Slow Level 1 Total Response Minor 29 Slow Level 2 Server Response Minor 30 Slow Level 2 Total Response Minor 30 Slow Level 3 Server Response Minor 31 Slow Level 3 Total Response Minor 32 Slow Level 1 Server Response indication This indications is used to detect slow dial processing time in the application server. The time indicated is only the server time and does not include network time. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) AVG1_SRV_RESP_TIME An average of transaction response times from the SAP system or application server. UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystem SID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) TransactionCode A short code used to execute a program, screen, or series of events on a mysap.comsystem. This indication has the following thresholds: v Level 1 Server Response (ms) For more information about these thresholds, see Thresholds on page 33. This indication has the following parameters: v Level 1 Transaction List For more information about these parameters, see Parameters on page 33. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes 28 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

39 Setting Default value Send indications to Tivoli Business Systems Yes Manager Occurrences 2 Holes 0 Associated built-in tasks None Slow Level 1 Total Response indication This indications is used to detect slow dial processing time in the application server. The time indicated is only the server time and does not include network time. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) AVG1_TOT_RESP_TIME An average of total system response times. UpperBound BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) TransactionCode A short code used to execute a program, screen, or series of events on a mysap.comsystem. This indication has the following thresholds: v Level 1 Total Response For more information about these thresholds, see Thresholds on page 33. This indication has the following parameters: v Level 1 Transaction List For more information about these parameters, see Parameters on page 33. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 2 Holes 0 Associated built-in tasks None Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 29

40 Slow Level 2 Server Response indication This indications is used to detect slow dial processing time in the application server. The time indicated is only the server time and does not include network time. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) AVG2_SRV_RESP_TIME An average of transaction response times from the SAP system or application server. UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystem SID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) TransactionCode A short code used to execute a program, screen, or series of events on a mysap.com system. This indication has the following thresholds: v Level 2 Total Response (ms) For more information about these thresholds, see Thresholds on page 33. This indication has the following parameters: v Level 2 Transaction List For more information about these parameters, see Parameters on page 33. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 2 Holes 0 Associated built-in tasks None Slow Level 2 Total Response indication This indications is used to detect slow dial processing time in the application server. The time indicated is only the server time and does not include network time. The indication has the following attributes: 30 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

41 BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) AVG2_TOT_RESP_TIME An average of total system response times. UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) TransactionCode A short code used to execute a program, screen, or series of events on a mysap.com system. This indication has the following thresholds: v Level 2 Total Response For more information about these thresholds, see Thresholds on page 33. This indication has the following parameters: v Level 2 Transaction List For more information about these parameters, see Parameters on page 33. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 2 Holes 0 Associated built-in tasks None Slow Level 3 Server Response indication This indications is used to detect slow dial processing time in the application server. The time indicated is only the server time and does not include network time. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) AVG3_SRV_RESP_TIME An average of transaction response times from the SAP system or application server. Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 31

42 UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) TransactionCode A short code used to execute a program, screen, or series of events on a mysap.com system. This indication has the following thresholds: v Level 3 Total Response For more information about these thresholds, see Thresholds on page 33. This indication has the following parameters: v Level 3 Transaction List For more information about these parameters, see Parameters on page 33. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 2 Holes 0 Associated built-in tasks None Slow Level 3 Total Response indication This indications is used to detect slow dial processing time in the application server. The time indicated is only the server time and does not include network time. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) AVG3_TOT_RESP_TIME An average of total system response times. UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) 32 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

43 Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) TransactionCode A short code used to execute a program, screen, or series of events on a mysap.com system. This indication has the following thresholds: v Level 3 Total Response For more information about these thresholds, see Thresholds. This indication has the following parameters: v Level 3 Transaction List For more information about these parameters, see Parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 2 Holes 0 Associated built-in tasks None Thresholds The following table lists the thresholds that can be set for the Transaction Performance resource model. For each threshold it shows the name, a short description, and the default value: Threshold Description Default value Level 1 Server Response Level 1 Total Response Level 2 Server Response Level 2 Total Response Level 3 Server Response Level 3 Total Response When the Level 1 Server Response Time exceeds this threshold an event is generated. When the Level 1 Total Response Time exceeds this threshold an event is generated. When the Level 2 Server Response Time exceeds this threshold an event is generated. When the Level 2 Total Response Time exceeds this threshold an event is generated. When the Level 3 Server Response Time exceeds this threshold an event is generated. When the Level 3 Total Response Time exceeds this threshold an event is generated. 1 second 2 seconds 2 seconds 4 seconds 3 seconds 6 seconds Parameters The resource model has the following parameters: Level 1 Transaction List Level 1 Transaction List Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 33

44 Level 2 Transaction List Level 2 Transaction List Level 3 Transaction List Level 3 Transaction List Logging The following table shows the resource, context, and properties for which data can be logged. Resource Context Properties TSAP_Statistics TSAP_Statistics_Availability v AVG1_SRV_RESP_TIME An asterisk (*) denotes a key property. v v v v v v v v v v AVG2_TOT_RESP_TIME AVG3_SRV_RESP_TIME BasisAppSystemNumber* AVG1_SRV_RESP_TIME AVG3_TOT_RESP_TIME AVG1_TOT_RESP_TIME BasisAppSystemNumber* BasisSystemSID* Hostname* CLI example TBD 34 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

45 User Performance resource model Description Reports problems associated with users that are logged on to application servers. The users are running transactions in dialog work processes. The areas that you want to check on are monitoring the number of active user and monitoring user response times. This resource model is separate from the Work Process resource model in that you may want to monitor all application servers in a similar manner for work processes, but you may want to monitor different user loads on different application servers. This resource model should be used every three minutes to determine the user logged-on status. This resource model should be run to check for problems associated with users logged on to application servers You should contact your mysap.com Basis administrator if there are too many users logged on to the specified applications server. Resource model at a glance Internal name Category Indications User Limit Exceeded Thresholds: v User Total Response SAP_User_Performance mysap.com Tasks and built-in actions Parameters: v None User Server Response Exceeded Thresholds: v Maximum Users v Maximum User Sessions v User Server Response v User Total Response Parameters: v None User Session Limit Exceeded Thresholds: v User Server Response Parameters: v None User Limit Exceeded Thresholds: v User Total Response Exceeded Parameters: v None No Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 35

46 Resource model at a glance Clearing events Default cycle time Yes Three minutes Target managed resource mysap.com application server Indications and events The following table lists the events that can be generated by the User Performance resource model, the name of the indication from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. Indication Event Severity Page User Limit Exceeded Ev_TSAP_Statistics_USER_LOGGED _ON_too_high Minor 36 User Server Response Exceeded Ev_TSAP_Statistics_USER_SRV_RESP _TIME_too_high Minor 37 User Session Limit Exceeded Ev_TSAP_Statistics_USER_TERMINAL_SESSIONS_too_high Minor 38 User Total Response Exceeded Ev_TSAP_Statistics_USER_TOT_ RESP_TIME_too_high Minor 38 User Limit Exceeded indication This indication is used to detect when the number of logged on users exceeds the specified threshold. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) USER_LOGGED_ON The number of users that are logged on. UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the Database SID. (Key attribute) HostName The fully qualified name of the system running the mysap resource. (Key attribute) This indication has the following thresholds: v Maximum Users For more information about these thresholds, see Thresholds on page 39. This indication does not have parameters. 36 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

47 The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 1 Holes 0 Associated built-in tasks None User Server Response Exceeded indication This indication is used to detect when the User Server Response time exceeds the specified threshold. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) USER_SRV_RESP_TIME The server response time for the users that are currently active. UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) HostName The fully qualified name of the system running the mysap.com resource. (Key attribute) UserName A user name or account. This indication has the following thresholds: v User Server Response For more information about these thresholds, see Thresholds on page 39. This indication does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 1 Holes 0 Associated built-in tasks None Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 37

48 User Session Limit Exceeded indication This indication is used to detect when the number of user sessions exceeds the specified threshold. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) USER_TERMINAL_SESSIONS The number of user terminal sessions. UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) HostName The fully qualified name of the system running the mysap.com resource. (Key attribute) This indication has the following thresholds: v Maximum User Sessions For more information about these thresholds, see Thresholds on page 39. This indication does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 1 Holes 0 Associated built-in tasks None] User Total Response Exceeded indication This indication is used to detect when the use total response time exceeds the specified threshold. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) USER_TOT_RESP_TIME User total response time. The average response time sampled by the system for user actions. 38 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

49 UpperBound A variable used when we are cycling through (looping) checks during RM processing. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) HostName The fully qualified name of the system running the mysap.com resource. (Key attribute) This indication does not have ng thresholds: v User Total Response For more information about these thresholds, see Thresholds. This indication does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 1 Holes 0 Associated built-in tasks None Thresholds The following table lists the thresholds that can be set for the User Performance resource model. For each threshold it shows the name, a short description, and the default value: Threshold Description Default value User Total Response Maximum Users User Server Response Maximum User Sessions An event is generated when the User Total Response Time counter exceeds this threshold. An event is generated when the Maximum Users Logged On counter exceeds this threshold. An event is generated when the User Server Response Time counter exceeds this threshold. An event is generated when the User Total Response Time counter exceeds this threshold. 4 seconds 50 2 seconds 100 Parameters The resource model does not have parameters. Logging The following table shows the resource, context, and properties for which data can be logged. Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 39

50 Resource Context Properties TSAP_STATISTICS TSAP_STATISTICS_AVAILABILITY v USER_TOT_RESP_TIME An asterisk (*) denotes a key property. v v v v v v USER_LOGGED_ON Basis AppSystemNumber* USER_TERMINAL_SESSIONS USER_SRV_RESP_TIME BasisSystemSID* Hostname* CLI example TBD 40 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

51 Jobs resource model Description Check for and reports any cancelled jobs in a mysap.com system. This resource model replaces the Cancelled Job Monitor from Tivoli Manager for R/3. You should run this resource model every five minutes to check for any jobs that were cancelled, and determine the reason why they were cancelled. Resource model at a glance Internal name Category Indications Cancelled Jobs Thresholds: v Failed v Cancelled Parameters: v Job Status TSAP_Jobs mysap.com Tasks and built-in actions Clearing events Default cycle time No Yes Five minutes Target managed resource mysap.com application server (one per system) Indications and events The following table lists the events that can be generated by the Cancelled Jobs resource model, the name of the indication from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. Indication Event Severity Page Cancelled Jobs Ev_TSAP_Job_Status_matches Critical 41 Cancelled Jobs indication This indication is used to detect and report cancelled jobs. The event is generated when the Job Status property is equal to on of the marked values of the Cancelled Job Status parameter. The indication has the following attributes: BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Name Status A job name that identifies a job to the system. (Key attribute) The current status of jobs. There are active, released, finished, scheduled, ready, and cancelled jobs. Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 41

52 This indication has the following thresholds: v Any thresholds? For more information about these thresholds, see Thresholds. This indication has the following parameters: v Job Status For more information about these parameters, see Parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 1 Holes 0 Associated built-in tasks None Thresholds This resource model does not have any thresholds. Parameters The resource model has the following parameters: Job Status An event is generated when the Job Status is equal to one of the marked values of this parameter. Logging The following table shows the resource, context, and properties for which data can be logged. Resource Context Properties TSAP_Job TSAP_Job_Availability v BasisSystemSID* An asterisk (*) denotes a key property. v v Name* Status 42 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

53 Response Time Analysis resource model Description Detects when additional work processes may be needed. It compares Average Dialog Response Time, Memory Utilization and the Percentage of Running Work Process to determine if additional work processes may be need to increase performance. You should use this resource model every five minutes to determine response time analysis status and to report when additional work processes may be needed. You should contact your mysap.com Basis administrator if additional work processes are needed. Resource model at a glance Internal name Category Indications Built-in action Clearing events Default cycle time Response Time Thresholds: v REP_TIME Parameters: v None Response_Time_Analysis mysap.com No Yes Five minutes Target managed resource mysap.com application server Indications and events The following table lists the events that can be generated by the Response Time Analysis resource model, the name of the indications from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. Indication Event Severity Page Low Work Processes TSAP_BasisSystem_DialogResponseTime Critical 43 Low Work Processes indication This indication is used to monitor when additional work processes may be required. The indication has the following attributes: PERCENT_WORKPROCESSES The percent of workprocesses consumed by user/system activity. RESP_TIME Response time. The time for the system to conduct a transaction. Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 43

54 AVG_DIALOG_RESP_TIME Average dialog response time. A calculation based on other dialogs that determines the average length of time for a dialog response. BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) MEMORY_UTIL Memory utilization by the system. The amount of physical memory consumed. BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) This indication has the following thresholds: v Average Dialog Response Time v Percentage of Memory Utilization v Percentage of active Work Processes For more information about these thresholds, see Thresholds. This indication does not have parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 2 Holes 0 Associated built-in tasks None Thresholds The following table lists the thresholds that can be set for the Response Time Analysis resource model. For each threshold it shows the name, a short description, and the default value: Threshold Description Default value Average Dialog Response Time Percentage of Memory Utilization Percentage of active Work Processes When all three of these thresholds are exceeded simultaneously, an event is generated. When all three of these thresholds are exceeded simultaneously, an event is generated. When all three of these thresholds are exceeded simultaneously, an event is generated IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

55 Parameters This resource model does not have parameters. Logging The following table shows the resource, context, and properties for which data can be logged. Resource Context Properties TSAP_Statistics TSAP_Statistics_Availability v PERCENT_WORKPROCESSES An asterisk (*) denotes a key property. v v v v v v RESP_TIME AVG_DIALOG_RESP_TIME BasisAppSystemNumber* MEMORY_UTIL BasisSystemSID* Hostname* CLI example TBD Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 45

56 Database Connection resource model Description Detects that the application server RDMS client software has failed a connection test with the RDMS Server. You should run this resource model every 10 minutes to determine the Database Instance Connection Test status, and report when the applications server RDMS client software fails a connection test with the RDMS server. You should contact your mysap.com Basis administrator when the connection test fails. Resource model at a glance Internal name Category Indications DB Connection Test Thresholds: v None TSAP_Database_Connection mysap.com Parameters: v Database Logon Status v Database Connection Status Built-in action Clearing events Default cycle time [built-in actions] Yes 10 minutes Target managed resource mysap.com application server Indications and events The following table lists the events that can be generated by the Database Connection resource model, the name of the indication from which each event is generated, the default severity of the event, and where you can find a detailed description of the indication. Indication Event Severity Page Database Connection Failure TSAP_BasisApplServer Critical 46 Database Logon Failure Ev_TSAP_BasisApplServer_DB_LOGON_matches Critical 47 DataBase Logon Failure Test indication This indication is sent when the Database Logon Status is equal to one of the marked values of the Database Logon Status parameter. The indication has the following attributes: 46 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

57 BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) DB_LOGON The application server database client software that connects to the database server and logs on (establishes a connection). If the connection fails the application server can not function. The failure could be an account, communications, or other problem. This indication has the following thresholds: v None For more information about these thresholds, see Thresholds on page 48. This indication has the following parameters: v Database Logon Status For more information about these parameters, see Parameters on page 48. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 3 Holes 1 Associated built-in tasks [built-in tasks] DataBase Connection Failure indication This indication is sent when the Database Connection Status is equal to one of the marked values of the Database Connection Status parameter. The indication has the following attributes: BasisAppSystemNumber Basis system Application number or instance number. A number between that identifies an instance on a host. (Key attribute) BasisSystemSID The system identifier for a mysap.com system. Usually determined at install time by the SAP SID. (Key attribute) Hostname The fully qualified name of the system running the mysap.com resource. (Key attribute) Chapter 2. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com Resource Models 47

58 DB_CONNECT_STATUS Database Client connection status with the database server. If the connection is active then SAP can access the database server and the application server is functional. This indication has the following thresholds: v None For more information about these thresholds, see Thresholds. This indication has the following parameters: v Database Connection Status For more information about these parameters, see Parameters. The following table describes the default settings for this indication. Setting Default value Send indications to Tivoli Enterprise Console Yes Send indications to Tivoli Business Systems Yes Manager Occurrences 3 Holes 1 Associated built-in tasks [built-in tasks] Thresholds This resource model does not have any thresholds. Parameters The resource model has the following parameters: Database Logon Status TBD Database Connection Status TBD Logging The following table shows the resource, context, and properties for which data can be logged. Resource Context Properties TSAP_Basis_APPL_Server TSAP_Basis_APPL_Server_Availability v BasisAppSystemNumber* An asterisk (*) denotes a key property. v v v v BasisSystemSID* Hostname* DB_LOGON DB_CONNECT_STATUS CLI example TBD 48 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

59 Chapter 3. Tasks for managing mysap.com resources This chapter describes the tasks that IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com provides to help you manage mysap.com resources. You can run most mysap.com tasks from a task library and some tasks from a context menu. You might find that running a task from a context menu is easier than running the task from the task library. For more information about running tasks, refer to the IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com User s Guide. Table 3. Tasks Category Configuration tasks on page 50 Create Tasks on page 81 Application Server Tasks on page 90 Tasks v Check Status on page 51 v Configure Event Adapter on page 52 v Configure Event Server on page 57 v Configure Remote Function Call on page 60 v Configure Systems Management on page 62 v Deploy Event Adapter Files on page 64 v Discover on page 67 v Install Event Adapter on page 71 v List RFC Information on page 73 v Rediscover on page 74 v Report Management Configuration on page 76 v Synchronize mysap Objects on TBSM on page 77 v Uninstall Event Adapter on page 78 v Verify Remote Function Call on page 80 v Create mysapappserver on page 82 v Create mysapdbserver on page 84 v Create mysapitsserver on page 88 v Create mysapsystem on page 86 v Cancel Batch Job on page 91 v Cancel Work Process on page 92 v Display Batch Jobs on page 93 v Display Buffer Information on page 96 v Display OS Collect Information on page 97 v Display OS390 DB2 Information on page 98 v Display OS390 Information on page 99 v Display Roll Page Information on page 100 v Display Work Processes on page 101 v Release Batch Job on page 102 v Start Event Adapter on page 103 v Start Server on page 104 v Stop Event Adapter on page 105 v Stop Server on page

60 Table 3. Tasks (continued) Category DB v Start Database on page 108 ServerTasks v Stop Database on page 109 on page 107 Internet v Start Database on page 111 Transaction v Stop Database on page 112 Server tasks on page 110 System Tasks on page 113 List Maintenance Tasks on page 117 Tasks v Configure Systems Management on page 114 v Identify mysap System Type on page 115 v Move mysap System on page 116 v Create New Subscriber List on page 118 Configuration tasks Configuration tasks help you perform common functions related to configuring mysap.com resources, such as, configuring the event server and installing an event adapter. You can run configuration tasks from the mysap.com Configuration Tasks library, and you can also run some utility tasks from the Monitoring for mysap.com icon s context menu. Jobs in the mysap.comconfiguration Tasks library are set up to run on the Tivoli server or the event server, as appropriate. The mysap.comconfiguration Tasks library is located in the mysap.com Configuration policy region. This section describes the configuration tasks that IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com provides. 50 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

61 Check Status Description TBD Authorization roles v r3_senior v r3_admin v r3_user Task location v mysap.com Configuration Tasks library Target managed resource mysap.com application server GUI data entry fields None. Chapter 3. Tasks for managing mysap.com resources 51

62 Configure Event Adapter Description This task is used to configure the Syslog, CCMS, and IDOC event adapters. The Configure Event Server task performs these actions: v Creates a backup of the.conf file: TEC-app_server type.conf-yyyy-mm-dd where app_server is the name of the application server and type is Syslog, CCMS or IDOC. Only one event adapter can be configured at a time, and the task creates one backup per day. v Updates the adapter.conf file: TEC-app_server-type.conf where v Stops and restarts the adapter if it is currently running. Authorization roles v r3_senior v r3_admin Task location v mysap.com Configuration Tasks library Target managed resource mysap.com application server GUI data entry fields This task has the following parameters: 52 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

63 Here is an example of the mysap.com Configure Event Adapter dialog: Event Adapter Type Use this field to select the event adapter you want to configure. Select an adapter by clicking the check box next to the adapter name. You can only configure one adapter for each running of the task. When you click one of these check boxes, the Adapter Unique Parameters section of the dialog is refreshed to show the parameters you can change for the selected adapter type. Configuration File Source Use this field to choose how you want the configuration file updated. You can choose to update the current configuration file. When you choose this option, all fields on the dialog are enabled for update. The values that are shown on the dialog will replace values in the current configuration file. You can choose to replace the current configuration file with values from the adapter template file. When you choose this option, all fields on the dialog are disabled. These values will be taken from the template file. Adapter Unique Parameters This section of the dialog lists parameters common to all adapter types. Chapter 3. Tasks for managing mysap.com resources 53

64 Event Server Type the name of the event server. The name must be of the where region_name is name of a Tivoli interconnected TMR. Polling Delay Type the polling delay in the Minutes and Seconds fields. For the Minutes field, type a value from 0 to For the Seconds field, type a value from 0 to Either the Minutes or Seconds field must contain a number greater than zero. The defaults are: Syslog Adapter 3 minutes CCMS Adapter 10 minutes IDOC Adapter 10 minutes Log File Size Type the maximum size of the adapter log file. The number is specified in kilobytes (KB). The number must be a positive integer. Logging Levels Trace Error Select the level of tracing information to be logged. Low provides the least amount of operational detail, and Verbose provides the most operational detail. Select Verbose for debugging purposes only. Select the level of error information to be logged: v Minor logs all errors v Major logs only major and fatal errors v Fatal logs only fatal errors Adapter Unique Parameters This section of the dialog lists parameters unique to each adapter type. Syslog Adapter: Single Event Messages The syslog adapter provides the ability to locally suppress duplicate syslog messages. Syslog messages are duplicates if they meet the following conditions: v The messages are processed in the same polling cycle of the adapter. v The messages have identical values for the message ID and the message text slots. When the adapter is enabled for duplicate messages, an event will be sent for the first occurrence of the message. No events will be sent for subsequent duplicate messages. The adapter sends a single event for these messages. Use this field to specify messages for which you only want one event per polling cycle. Type the message IDs for the messages. Separate message IDs with spaces or commas. For example: 54 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

65 AB1, AB8 A08 RFC Error Delay When the syslog adapter fails to connect to an application server, it will sleep for a period of time before trying to reconnect. The time that the adapter sleeps is the RFC Error Delay Type the error delay in the Minutes and Seconds fields. For the Minutes field, type a value from 0 to For the Seconds field, type a value from 0 to Either the Minutes or Seconds field must contain a number greater than zero. CCMS Adapter Alerts Per CCMS Attribute Type the number of alerts to be reported as Tivoli events for each CCMS attribute in the CCMS monitoring tree. If you enter zero (0), all alerts are reported. If you enter a number greater than zero, this number of alerts is reported. The reported alerts are the most recent alerts for an attribute. Any alerts that exceed this value are not reported as Tivoli events. You can configure the CCMS Event Adapter to automatically close unreported alerts in CCMS. See the description of the Close CCMS Alerts field. Close CCMS Alerts Check this box to configure the CCMS Adapter to automatically close CCMS alerts. This option applies when the Alerts Per CCMS Attribute number is greater than zero (0). All open CCMS alerts that exceed the Alerts Per CCMS Attribute number will be closed. Monitoring Set Type the name of the CCMS monitoring set that contains the monitor you want to observe Type the name of the monitoring set exactly as it appears in CCMS because this name is case sensitive. Here is an example of a monitoring set name: SAP CCMS Monitor Templates This field is required the first time you configure the CCMS Event Adapter. If you reconfigure the CCMS Event Adapter and you do not want to change the name of the monitoring set to be observed, leave this field and the Monitor field blank. Monitor Type the name of the CCMS monitor contained in the specified monitoring set. The CCMS Event Adapter reports alerts for all attributes in this monitor. Type the monitor name exactly as it appears in CCMS because this name is case sensitive. Here are examples of monitor names in the SAP CCMS Monitor Templates monitoring set: Background Processing Buffers Communications Data Archiving Database Dialog Overview Entire System Operating System Security Spool System Syslog System Configuration Chapter 3. Tasks for managing mysap.com resources 55

66 If you reconfigure the CCMS Event Adapter and you do not want to change the name of the monitor to be observed, leave this field and the Monitoring Set field blank. IDOC Adapter Expiration Days This field controls how long IDOC error conditions will be considered valid. When an IDOC error condition is older than the number of days specified in this field, the IDOC error will be dropped Type the number of days for which IDOC error conditions will considered valid. The number must be an integer greater than or equal to zero. Inbound Error Codes IDOC error states are reported as two digit numbers. The meanings of the error states are documented in SAP documentation. Use this field to specify the set of IDOC inbound error states to be monitored. Type the error codes as two-digit integers. Separate the error codes with commas. Do not use spaces or blanks to separate the error codes. Outbound Error Codes IDOC error states are reported as two digit numbers. The meanings of the error states are documented in SAP documentation. Use this field to specify the set of IDOC outbound error states to be monitored. Type the error codes as two-digit integers. Separate the error codes with commas. Do not use spaces or blanks to separate the error codes. 56 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

67 Configure Event Server Description Sets up your event server to process mysap.com events. IBM Tivoli Monitoring for Applications, Version 5.1.0: mysap.com includes a set of event classes and rules specific to mysap.com. Events received from mysap.com event adapters are included in the MQSeries event group. Events received from the Statistics Event Adapter are included in the MQSeries Statistics event group. The Configure Event Server task creates these groups and to set up the event server to process mysap.com events and mysap.com statistics events. The Configure Event Server task performs these actions: v Installs these mysap.com baroc files: sap_resource_model.baroc sap_tecad.baroc sap_wr3mgr.baroc sap_tecad_wr3ccms.baroc sap_tecad_wr3idoc.baroc sap_tecad_wr3slog.baroc v Installs these script files: sap_alert_control_moni_cb.sh sap_forward_tbsmevent.sh v Installs these rules files: sap_tecad.rls sap_resource_model.rls sap_gemevents.rls v Installs these event sources: mysap CCMS (WR3CCMS) mysap IDOC (WR3IDOC) mysap Syslog (WR3SLOG) v Compiles the rule base to incorporate the new rules. v Loads the new rule base v Restarts the server to incorporate the specified rule base. Authorization roles v r3_senior v r3_admin Task location v mysap.com Configuration Tasks library Target managed resource Endpoint or managed node that is the event server GUI data entry fields Here is an example of the mysap.com Configure Event Server dialog: Chapter 3. Tasks for managing mysap.com resources 57

68 This task has the following parameters: Update Current Rule Base Specifies that you want to update an existing rule base. Select the rule base to be updated from the Rule Bases field. Create New Rule Base from Existing Specifies that you want to create a new rule base, but that you want that rule base to be initialized with a copy of an existing rule base. You must type the name of the new rule base in the New Rule Base Name field, and you must type the path to the new rule base in the New Rule Base Path field. You must select the initializing rule base from the Rule Bases field. Create New Rule Base Specifies that you want to create a new rule base, but that you do not want that rule base to be initialized with an existing rule base. You must type the name of the new rule base in the New Rule Base Name field, and you must type the path to the new rule base in the New Rule Base Path field. You cannot select a rule base in the Rule Bases field. 58 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

69 New (or existing) Rule Base Name To modify a current rule base, enter the rule base name. You should not modify the Default rule base, so do not enter Default. Use the wlsrb command to view a list of all rule bases. To create a new rule base, enter the name of the new rule base. New Rule Base Path If you are creating a new rule base, enter the full path for where you want the new rule base to be created. If you are creating a new rule base from an an existing rule base, you can leave this field blank. Compile Rule Base Only Enables you to create or update the rule base, but the new rule base will not be loaded into the event server. This option is useful if you want to review rule base changes before activating them or to create the rule base in preparation for later activation. Compile and Load Rule Base Only Works like the Compile Rule Base Only option, but it also loads the new rule base into the event server. The new rule base becomes active when the event server is restarted. Compile, Load Rule Base and Restart Server Works like the Compile Rule Base Only option, but it also loads the new rule base into the event server and immediately restarts the event server. Usage notes You can run the Configure Event Server task on selected subscribers to configure additional event servers. Chapter 3. Tasks for managing mysap.com resources 59

70 Configure Remote Function Call Description Configures the user ID information required to execute a mysap remote function call (RFC). The user ID that is used for RFC access was defined when the mysap administrator configured the mysap system. The only validity checking occurs by mysap when this information is presented to mysap during an RFC call. The wr3rfc-based functions, the Syslog Event Adapter, and the IDOC Event Adapter use this configuration information. If you reconfigure an RFC, you must do the following: v Rerun the Configure Event Adapter task for the appropriate Syslog Event Adapter or IDOC Event Adapter and then stop and start the Syslog Event Adapter or IDOC Event Adapter to update the RFC configuration information. v Redistribute the monitoring profiles to all application servers in the affected mysap systems. Authorization roles v r3_senior v r3_admin Task location v mysap.com Configuration Tasks library Target managed resource GUI data entry fields Here is an example of the Configure Remote Function Call dialog: This task has the following parameters: Client Enter the three-digit client number associated with this user ID. Userid Enter the user ID that was defined when the administrator configured the mysap.com system. 60 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

71 Password Enter the password for this user ID. Language Based on the languages installed in your mysap system, select the appropriate language from the drop-down list. IDOC Event Adapter and Syslog Event Adapter messages are returned in the language specified in this field. CCMS Event Adapter messages are returned in the language in which the mysap system is running. Chapter 3. Tasks for managing mysap.com resources 61

72 Configure Systems Management Description Updates the parameters that are used to determine the management characteristics of mysap.com systems. These changes will only apply to newly created or newly discovered systems, with the exception of the Route String parameter. Existing systems will be unaffected by any changes you make to the listed parameters. If the dialog fields are available, they will contain existing values. To completely remove the value of a field, highlight the existing value and press the Backspace or Delete key. This will cause the current value of the fieldd to be deleted when the Set and Execute button is pressed. If this task was executed from the task library, all dialog felds will be initially empty. In this case, you must explicitly provide values for all fields that you want to configure. This includes fields which may already contain values. Any dialog field that remains empty will cause the current value of the field to be deleted when the Set and Execute button is pressed. Authorization roles v r3_senior v r3_admin Task location v mysap.com Configuration Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the dialog: This task has the following parameters: Default Remote Endpoint Enter the name of the Tivoli endpoint that is to be used to manage mysap.com systems by default. The TMA must already exist, and be one of the interpreter types that are supported by the product. If a Default Remote Endpoint is not specified, a random TMA is chosen for systems management Object Location Enter the name of the Managed Node that you are using to create new mysap.com system objects. The Tivoli Endpoint must already exist, and be one of the interpreter types that are supported by the product. Route String If access to the mysap.com servers must be done using a mysap.com router, type the router string in this field. The route string must be of the form /H/Host/H/. For example: /H/beagle/H/brittany/H/ If a route string is not provided, the host machines are accessed directly. Use Local Endpoint Select YES if you prefer newly created or discovered mysap.com systems 62 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

73 to be managed using a locally-installed Tivoli Endpoint. If a locally-installed Tivoli Endpoint is not available, the Default Remote Endpoint will be used. Select NO if you don t want to use locally-installed Tivoli Endpoints to manage newly created or discovered mysap.com systems. In this case, the Default Remote Endpoint is always used to manage newly created or discovered systems. Chapter 3. Tasks for managing mysap.com resources 63

74 Deploy Event Adapter Files Description This task is used to deploy configuration files for the Syslog, CCMS, and IDOC event adapters. The file deployment process consists of the following steps: v Files are copied from the managed node on which this task is run to the managed nodes supporting gateways. v Files are copied from the gateway machines to the endpoints supporting the application servers. v Application servers are updated to use the new files. Authorization roles v r3_admin v r3_user Task location v mysap.com Configuration Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the Deploy Event Adapters dialog: 64 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

75 This task has the following parameters: Adapter File Use this field to select the event adapter file type that you want to deploy. Select a file type by clicking the check box next to the file name. You can deploy multiple files by clicking multiple check boxes. The adapter files are mapped to file names as follows: Table 4. Syslog Configuration File Syslog Class File CCMS Configuration File CCMS Event File IDOC Configuration File tecad_wr3slog.conf tecad_wr3slog.cl tecad_wr3moni.conf tecad_wr3moni.evt tecad_wr3idoc.conf Chapter 3. Tasks for managing mysap.com resources 65

76 Application Servers Select one or more application servers for which the selected files should be updated. Select multiple application servers by using the Ctrl key. 66 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

77 Discover Description This task can be run to discover mysap systems and servers. Authorization roles v r3_senior v r3_admin Task location v Endpoint or managed node that is the event server v mysap.com Configuration Tasks library Target managed resource GUI data entry fields Here is an example of the mysap.com Discover dialog: Chapter 3. Tasks for managing mysap.com resources 67

78 This task has the following parameters: Hosts Ports Type host names in this field. Separate host names with spaces or commas. Host names should be unqualified host names. Type two digit numbers for the ports to be checked. The numbers entered are appended to 36 to form port numbers of 36xx. Type port numbers as single two digit numbers, e.g., 00, 10. Type port ranges as two port numbers separated by a hyphen, 00-10, for example. Use spaces or commas to separate port numbers and port ranges. 68 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

79 Use port numbers to restrict the host scanning process and improve task response time since invalid ports are detected only after a timeout period. Route String If access to the mysap servers must be done using an sap router, type the sap router string here. The route string must be of the form /H/Host/H/. For example: /H/beagle/H/brittany/H/ If a route string is not provided, the host machines are accessed directly. File Name Type a file name in this field to have the Hosts field filled in with host names from a file. The file must be in the /etc/hosts format. Load Press this button to load host names from the file entered in File Name. Information resulting from pushing this button is displayed on a status line below the File Name field. Chapter 3. Tasks for managing mysap.com resources 69

80 Display Event Adapter Description This task is used to display information about the Syslog, CCMS, and IDOC event adapters. This task performs the following actions: v Displays one to three adapters at one time v Displays the current set of configuration file parameters for the adapter. v Reports if adapter is installed, and if so, shows the.conf file v Reports whether or not the adapter is currently running. Authorization roles v r3_senior v r3_admin v r3_user Task location v mysap.com Configuration Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the mysap.com Display Event Adapter dialog: This task has the following parameter: Event Adapter Type Use this field to select the event adapters you want to display. Select an adapter by clicking the check box next to the adapter name. You can display multiple adapters by clicking multiple check boxes. 70 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

81 Install Event Adapter Description Installs the Syslog, CCMS, and IDOC event adapters. When an adapter is installed, its configuration file is created based on the adapter s template configuration file. You may want to display this configuration file before starting the adapter. This task performs these actions: v Installs one to three adapters at one time v Installs adapter as a service on Windows systems v Installs adapter as a daemon on UNIX systems. The daemon is configured to start automatically on system startup. v Creates a default.conf file on Windows and UNIX Systems. The installation task only installs the adapter. It does not start the adapter. To start the adapter, run the Start Event Adapter task. Authorization roles v r3_admin v r3_senior Task location v mysap.com Configuration Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the mysap.com Install Event Adapter dialog: This task has the following parameter: Chapter 3. Tasks for managing mysap.com resources 71

82 Event Adapter Type Use this field to select the event adapters you want to install. Select an adapter by clicking the check box next to the adapter name. You can install multiple adapters by clicking multiple check boxes. 72 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

83 List RFC Information Description If you run a task that displays its output on the desktop, you can save the output to a file. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save to File on the task output dialog. Authorization roles v r3_senior v r3_admin v r3_user Task location v mysap.com Configuration Tasks library Target managed resource mysap.com application server GUI data entry fields None. Chapter 3. Tasks for managing mysap.com resources 73

84 Rediscover Description Rediscovers mysap.com systems and servers starting from a list of message servers and ports. Authorization roles v r3_senior v r3_admin v Task location v mysap.com Configuration Tasks library Target managed resource v Endpoint or managed node that is the event server v mysap.com application server GUI data entry fields Here is an example of the mysap.com Rediscover dialog: This task has the following parameters: 74 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

85 Message Servers This field shows the current set of message servers and ports known to the system. Type new message server host names and ports in this field. Delete message server host names and ports from this field. Host/port entries have the form host:port. The host can be a simple host name, or it can be qualified with a sap route string. The port is a four digit number starting with 35. Separate host/port entries with space or commas. Here are some examples of host/port entries: akit:3610 /H/beagle/H/akita:3610 /H/beagle/H/brittany/H/hemlock:3600 When the task is run, the set of hosts/ports displayed in this window are used for the rediscovery process. Save Press Save to save the host/port entries as the new set of system defined message servers and ports. It is not necessary to save the displayed list to run the rediscovery task. Chapter 3. Tasks for managing mysap.com resources 75

86 Report Management Configuration Description If you run a task that displays its output on the desktop, you can save the output to a file. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save to File on the task output dialog. Authorization roles v r3_senior v r3_admin Task location v mysap.com Configuration Tasks library Target managed resource GUI data entry fields None. 76 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

87 Synchronize mysap Objects on TBSM Description If you run a task that displays its output on the desktop, you can save the output to a file. Note to Reviewers: I need a better description here. To save the task output to a file after the task completes, press Save to File on the task output dialog. Authorization roles v v Task location v mysap.com Configuration Tasks library v Target managed resource GUI data entry fields None. Usage notes Chapter 3. Tasks for managing mysap.com resources 77

88 Uninstall Event Adapter Description Uninstalls the Syslog, CCMS, and IDOC event adapters. This task performs these actions: v Uninstalls one to three adapters at once v Removes the program entry from the Windows services list (Windows systems only) v Stops the adapter, if necessary, before uninstalling it. v Removes the configuration (.conf) file v Removes all backup.conf files v Removes these adapter-specific files: Syslog.cl file CCMS.evt file IDOC work files Authorization roles v r3_senior v r3_admin Task location v mysap.com Configuration Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the mysap.com Uninstall Event Adapter dialog: 78 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

89 This task has the following parameter: Event Adapter Type Use this field to select the event adapters you want to uninstall. Select an adapter by clicking the check box next to the adapter name. You can uninstall multiple adapters by clicking multiple check boxes. Chapter 3. Tasks for managing mysap.com resources 79

90 Verify Remote Function Call Description Verifies that the Rmote Function Call task has been run. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save to File on the task output dialog. Authorization roles v r3_senior v r3_admin Task location v mysap.com Configuration Tasks library Target managed resource mysap.com application server GUI data entry fields None. 80 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

91 Create Tasks Create tasks help you create mysap.com systems, application servers DB servers, and ITS servers. You can run the Create mysap System task from the context menu on the mysap Policy Region, and the other create tasks from the context menu of the mysap server policy region. Chapter 3. Tasks for managing mysap.com resources 81

92 Create mysapappserver Description Creates a mysap application server (mysapappserver). Authorization roles v r3_senior v r3_admin Task location v mysap.com Policy Region context menu v mysap.com Server Policy Region context menu. Target managed resource mysap application server GUI data entry fields Here is an example of the mysap.com Create mysap Application Server dialog: This task has the following parameters: Instance ID Enter the two digit application server instance number. Central Instance Enter the TCP/IP host name by which the application server is known in the mysap system. You can find out the host name to use by running transaction SM51 in the mysap system. Use the first part of the server name (up to the first underscore _)inthehost column. 82 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

93 mysap Host Name Enter the name of the managed node. This is a managed resource running the Tivoli Framework. Typically, this name is the name associated with the machine s network interface card that Tivoli uses to communicate with this machine. Managed Node Name Enter the name of the managed node. This is a managed resource running the Tivoli Framework. Typically, this name is the name associated with the machine s network interface card that Tivoli uses to communicate with this machine. TMA Endpoint Name Enter the name of the TMA endpoint. This is a managed resource that is running the TMA agent. This name is typically the name assigned when the endpoint was defined in the Tivoli region. Usage notes 1. To verify the TMA endpoint name, right-click the Endpoint Manager icon on the desktop and select View and Gateways from the pop-up menu. 2. For an application server that is running on a TMA endpoint, the default locations for the mysapappserver object is the current gateway of the TMA endpoint. However, it is possible to force the object to be created on a managed node other than the gateway. To do this, complete both the Managed Node Name filed and the TMA endpoint field. In the Managed Node field, enter the Tivoli managed node name where you want to created the object. In the TMA Endpoint Name field, enter the Tivoli TMA endpoint name where the application server is running. Chapter 3. Tasks for managing mysap.com resources 83

94 Create mysapdbserver Description This option creates a mysap database server object (mysapdbserver). Authorization roles v r3_senior v r3_admin Task location v mysap.com Policy Region context menu Target managed resource GUI data entry fields Here is an example of the dialog: This task has the following parameters: DB SID (optional( Enter the system identifier of the mysap database server. If this field is left blank, the SID of the associated mysap system will be used as its default. Object Location: Enter the name of the managed node where you want this object to be created. If this field is left blank, the Object Location that is specified in the associated mysapsystem object will be used if available. If the associated mysapsystem object does not specify an Object Location, the managed node will be selected based upon the endpoint s gateway location. Managed Node Name: Enter the name of the managed node. This is a managed resource running the Tivoli Framework. Typically, this name is the name associated with the machine s network interface card that Tivoli uses to communicate with this machine. TMA Endpoint Name: Enter the name of the TMA endpoint. This is a managed resource that is running the TMA agent. This name is typically the name assigned when the endpoint was defined in the Tivoli region. Usage notes To verify the TMA endpoint name, right-click the Endpoint Manager icon on the desktop and select View-->Gateways from the pop-up menu. 84 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

95 Create mysapitsserver Description This task creates a mysap Internet Transaction Server (ITS) object (mysapitsserver). Authorization roles v r3_admin Task location v mysap.com Server Policy Region context menu. Target managed resource GUI data entry fields Here is an example of the dialog: This task has the following parameters: ITS Server Name: Enter the virtual ITS instance name as specified when the mysap.com Internet Transaction Server was set up. If the mysap.com naming recommendation was followed, the virtual ITS instance name is the SID of your mysap.com system. ITS Server Type: If your ITS server has both the AGate and the WGate components running on the same machine, select the Single_Host. If the AGate and WGate components are running on different machines, select Dual-Host (AGate) when configuring the AGate component or select Dual-Host (WGate) when configuring the WGate component. AGate - the component of the ITS server that bridges an application server to a WGate. WGate - the component of the ITS server that bridges an AGate to a standard Web server. Managed Node Name: Enter the name of the managed node. This is a managed resource running the Tivoli Framework. Typically, this name is the name associated with the machine s network interface card that Tivoli uses to communicate with this machine. TMA Endpoint Name: Enter the name of the TMA endpoint. This is a managed resource that is running the TMA agent. This name is typically the name assigned when the endpoint was defined in the Tivoli region. Enter the Tivoli endpoint name where the mysap ITS server is running. Usage notes 1. To verify the endpoint name, right-click the Endpoint Manager icon on the desktop and select View-->Gateways from the pop-up menu. 2. For a mysap.com ITS server that is running on an endpoint, the default location for the mysapitsserver object is the current gateway of the endpoint. However, it is possible to force the object to be created on a managed node other than the gateway. To do this, complete both the Object Location field and the Endpoint Name field. In the Object Location field, enter the Tivoli managed node name where you want to create the object. In the Endpoint Name field, enter the Tivoli endpoint name where the mysap ITS server is running. Chapter 3. Tasks for managing mysap.com resources 85

96 Create mysapsystem Description This option creates a mysap system object (mysapsystem). Authorization roles v r3_senior Task location v Monitoring for mysap.com Policy Region context menu Target managed resource Managed node GUI data entry fields Here is an example of the Create mysap System dialog: This task has the following parameters: mysap System Name (SID): Enter the three-character mysap system identifier. 86 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

97 mysap Release: From the drop-down list, select the mysap release of this mysap system. mysap System Type: From the drop-down list, select the type of this mysap system. If you do not know the correct type, select UNKNOWN. mysap Database Type: From the drop-down list, select the type of this mysap system. If you do not know the correct type, select UNKNOWN. mysap Database Hostname: Enter the host name of the machine on which the mysap database server is running. If the mysap system is running on a failover system, enter the host name of the primary mysap database server. mysap Database Release (optional): Enter the release level of the database you are using. Object Location (optional): Enter the name of the Managed Node that is to be used to create new mysap system objects, like mysapappservers and mysapdbservers. The Managed Node must already exist, and be one of the interpreter types that are supported by the product. Default Remote Endpoint (optional): Enter the name of the Tivoli endpoint that is to be used to manage mysap systems by default. The Tivoli endpoint must already exist, and be one of the interpreter types that are supported by the product. If you do not specify a value for this field, a suitable value will be determined using the Systems Management Filter. Use Local Endpoint: Select YES if you prefer newly created or discovered mysap systems to be managed using a locally-installed Tivoli endpoint (if available). If a locally-installed Tivoli endpoint is unavailable, the Default Remote Endpoint will be used. Select NO if you don t want to use locally-installed Tivoli endpoints to manage newly created or discovered mysap systems. In this case, the Default Remote Endpoint is always used to manage newly created or discovered systems. Route String (optional): If access to the mysap servers must be done using a SAP router, type the SAP router string here. The route string must be of the form /H/host/H/ Here is an example of the router string: /H/beagle/H/brittany/H/ /H/beagle/H/brittany/H/. If a route string is not provided, the host machines are accessed directly. Chapter 3. Tasks for managing mysap.com resources 87

98 Create mysapitsserver Description This task creates a mysap Internet Transaction Server (ITS) object (mysapitsserver). Authorization roles v r3_admin Task location v mysap.com Server Policy Region context menu. Target managed resource GUI data entry fields Here is an example of the dialog: This task has the following parameters: ITS Server Name: Enter the virtual ITS instance name as specified when the mysap.com Internet Transaction Server was set up. If the mysap.com naming recommendation was followed, the virtual ITS instance name is the SID of your mysap.com system. ITS Server Type: If your ITS server has both the AGate and the WGate components running on the same machine, select the Single_Host. If the AGate and WGate components are running on different machines, select Dual-Host (AGate) when configuring the AGate component or select Dual-Host (WGate) when configuring the WGate component. AGate - the component of the ITS server that bridges an application server to a WGate. WGate - the component of the ITS server that bridges an AGate to a standard Web server. Managed Node Name: Enter the name of the managed node. This is a managed resource running the Tivoli Framework. Typically, this name is the name associated with the machine s network interface card that Tivoli uses to communicate with this machine. TMA Endpoint Name: Enter the name of the TMA endpoint. This is a managed resource that is running the TMA agent. This name is typically the name assigned when the endpoint was defined in the Tivoli region. Enter the Tivoli endpoint name where the mysap ITS server is running. Usage notes 1. To verify the endpoint name, right-click the Endpoint Manager icon on the desktop and select View-->Gateways from the pop-up menu. 2. For a mysap.com ITS server that is running on an endpoint, the default location for the mysapitsserver object is the current gateway of the endpoint. However, it is possible to force the object to be created on a managed node other than the gateway. To do this, complete both the Object Location field and the Endpoint Name field. In the Object Location field, enter the Tivoli managed node name where you want to create the object. In the Endpoint Name field, enter the Tivoli endpoint name where the mysap ITS server is running. 88 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

99 Move mysap System Description Moves a mysap.com system from one Policy Region to another. A list of available Policy regions is displayed along with a slide bar to allow you to view all available Policy Regions. Authorization roles v r3_admin Task location v mysap.com Configuration Tasks library Target managed resource mysap.com systems GUI data entry fields Here is an example of the dialog: This task has the following parameter: New Policy Region Name: Available Policy Regions are displayed in this field in the pulldown. Select the Policy Region that you want to move the mysap.com system to. Click the Set and Execute button to move the mysap.com system. Chapter 3. Tasks for managing mysap.com resources 89

100 Application Server Tasks Authentication tasks enable you to manage authentication information objects. These objects most commonly contain the definitions required to perform Certificate Revocation List (CRL) checking using LDAP servers. You can access Authentication tasks from a queue manager icon s context menu or from the Queue Manager Control Center. You should not run Authentication tasks from the Authentication Tasks library. 90 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

101 Cancel Batch Job Description Cancels an active batch job. Enter the job name and job ID of the job you want to cancel. Use the Display Batch Jobs task to determine the appropriate job name and job ID. Only active jobs can be cancelled. Authorization roles v re_senior v r3_admin v r3_user Task location v Monitoring for mysap.com App Servers Task library Target managed resource GUI data entry fields Here is an example of the mysap.com Cancel Batch Job dialog: This task has the following parameters: Job ID Enter the job ID of the job that you want to cancel Job Name Enter the job name of the job that you want to cancel. Chapter 3. Tasks for managing mysap.com resources 91

102 Cancel Work Process Description Cancels a mysap.com work process. Enter the process ID of the mysap.com process that you want to cancel. Clear the check box if you do not want to save a core dump. The default is to save the core dump. Use the Display Work Processes task to determine the process ID of the mysap.com process you want to cancel. The process ID is required for this task. Authorization roles v r3_senior v re_admin Task location v Monitoring for mysap.com App Server Tasks library Target managed resource GUI data entry fields Here is an example of the mysap.com Cancel Work Process dialog: This task has the following parameters: Process ID Enter the process ID of the mysap.com process that you want to cancel With Core Dump The default is to save the core dump. Clear this check box if you do not want to save a core dump. 92 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

103 Display Batch Jobs Description Displays the following information for batch jobs: v Date v Job name v Job ID v Schedule by v Released by v Status v Class Enter a job name, a user name and a date range (yyyymmdd). You can enter an asterisk (*) for pattern matching for job name and user name. Authorization roles v r3_senior v r3_admin v r3_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the mysap.com Display Batch Jobs dialog: Chapter 3. Tasks for managing mysap.com resources 93

104 This task has the following parameters: Job Name Enter the name of the job here. You can use an asterisk (*) for pattern matching if you wish. User name Enter the user name here. You can use an asterisk (*) for pattern matching if you wish. Start date of job From date Enter the date that you want to start the job in the yyyymmddd format. To date Enter the date that you want to end the job in the yyyymmddd format. Only jobs with status Scheduled Check this box to display on jobs that are scheduled. Active Check this box to display only jobs that are active. Released Check this box to display only jobs that have been released. Finished Check this box to display only jobs that have finished. 94 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

105 Ready Check this box to display only jobs that have a status of ready. Terminated Check this box to display only jobs that have been terminated. More Jobs without start date Check this box to display jobs that have no previously defined start date. Jobs without previous job Check this box Chapter 3. Tasks for managing mysap.com resources 95

106 Display Buffer Information Description This task accepts a buffer type as input and then gathers the buffer data from the mysap application server to which the task is distributed. The resulting data is displayed in the keyword=value format. Authorization roles v r3_senior v r3_admin v re_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the mysap.com Display Buffer Information dialog: This task has the following parameter: mysap buffer type Enter the buffer type that you want to display. Available buffer types are: Table 5. CUA FTAB IRBD PRES PXA SNTAB TABL TABLP TTAB Menu and Text Buffer Field Description Buffer Initial Records Buffer Screen and Dynpro Buffer Program Buffer Short Name Table Buffer Generic Key Buffer Single Record Buffer Table Definition Buffer Usage notes 96 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

107 Display OS Collect Information Description If you run a task that displays its output on the desktop, you can save the output to a file. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save To File on the task output dialog. Authorization roles v r3_senior v re_admin v r3_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields None. Chapter 3. Tasks for managing mysap.com resources 97

108 Display OS390 DB2 Information Description Displays formatted output from this task. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save To File on the task output dialog. Authorization roles v r3_senior v r3_admin v r3_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields None. Usage notes 98 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

109 Display OS390 Information Description If you run a task that displays its output on the desktop, you can save the output to a file. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save To File on the task output dialog. Authorization roles v r3_senior v r3_admin v r3_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields None. Chapter 3. Tasks for managing mysap.com resources 99

110 Display Roll Page Information Description If you run a task that displays its output on the desktop, you can save the output to a file. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save To File on the task output dialog. Authorization roles v r3_senior v r3_admin v r3_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields None. 100 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

111 Display Work Processes Description Displays information for mysap.com processes that are running on the specified mysap.com application server. Authorization roles v r3_senior v r3_admin v r3_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the mysap.com Display Work Processes dialog: This task has the following parameter: CPU time Select the check box if you want the CPU time returned as part of the data for each running mysap.com work process. This is the CPU time used by a work process in the dialog step that it is currently processing. Chapter 3. Tasks for managing mysap.com resources 101

112 Release Batch Job Description Releases and starts a scheduled job. Use this task to determine the appropriate job ID and job name. Only scheduled jobs can be released. Authorization roles v r3_senior v r3_admin v r3_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the mysap.com Release Batch Job dialog: This task has the following parameters: Job ID Job id Enter the ID of the job that you want to release. Enter the name of the job that you want to release. 102 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

113 Start Event Adapter Description Starts the Syslog, CCMS and IDOC event adapters. This task performs these actions: v Starts one to three adapters at once v Reports whether or not the event adapter is already running. Authorization roles v r3_senior v r3_admin Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the mysap.com Start Event Adapter dialog: This task has the following parameter: Event Adapter Type Use this field to select the event adapters you want to start. Select an adapter by clicking the check box next to the adapter name. You can start multiple adapters by clicking multiple check boxes. The choices are: v Syslog Adapter v CCMS Adapter v IDOC adapter Chapter 3. Tasks for managing mysap.com resources 103

114 Start Server Description If you run a task that displays its output on the desktop, you can save the output to a file. *********Note to Reviewers: I need a better description to put here.********** Click the Save to File button on the task output dialog to save the task output to a file after the task completes. Authorization roles v r3_senior v r3_admin Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields None. 104 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

115 Stop Event Adapter Description This task is used to stop the Syslog, CCMs and IDOC event adapters. This task performs these actions: v Stops one to three adapters at once v Reports whether or not the event adapter is already running. Authorization roles v r3_senior v r3_admin v r3_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server GUI data entry fields Here is an example of the mysap.com Stop Event Adapter dialog: This task has the following parameter: Event Adapter Type Use this field to select the event adapters that you want to stop. Select and adapter by clicking the check box next to the adapter name. You can stop multiple adapters by clicking more than one check box. Chapter 3. Tasks for managing mysap.com resources 105

116 Stop Server Description Stops a server. Authorization roles v r3_senior v r3_admin v r3_user Task location v Monitoring for mysap.com App Server Tasks library Target managed resource mysap.com application server. GUI data entry fields None. 106 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

117 DB ServerTasks Chapter 3. Tasks for managing mysap.com resources 107

118 Start Database Description If you run a task that displays its output on the desktop, you can save the output to a file. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save to File on the task output dialog. Authorization roles v r3_senior v r3_admin Task location v Monitoring for mysap.com DB Server Tasks library Target managed resource mysap.com Database server GUI data entry fields None. 108 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

119 Stop Database Description If you run a task that displays its output on the desktop, you can save the output to a file. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save to File on the task output dialog. Authorization roles v r3_senior v r3_admin Task location v Monitoring for mysap.com DB Server Tasks library Target managed resource mysap Database server GUI data entry fields None. Chapter 3. Tasks for managing mysap.com resources 109

120 Internet Transaction Server tasks 110 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

121 Start Database Description If you run a task that displays its output on the desktop, you can save the output to a file. *********Note to Reviewers: I need a better description to put here.********** To save the task output to a file after the task completes, press Save to File on the task output dialog. Authorization roles v r3_senior v r3_admin Task location v Monitoring for mysap.com ITS Server Tasks library Target managed resource mysap.com ITS server GUI data entry fields None. Chapter 3. Tasks for managing mysap.com resources 111

122 Stop Database Description Stops a database. Authorization roles v r3_senior v r3_admin Task location v Monitoring for mysap.com ITS Server Tasks library Target managed resource mysap.com ITS server GUI data entry fields None. 112 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

123 System Tasks Command server tasks enable you to start, stop, or display the status of the command server. You can access command server tasks from the queue manager icon s context menu, the Queue Manager Control Center, or the Cmd Server Tasks library. The Cmd Server Tasks library is located in the MQSeries Tasks policy region within each management domain policy region in themonitoring for mysap.com policy region. Chapter 3. Tasks for managing mysap.com resources 113

124 Configure Systems Management Description TBD Authorization roles v r3_senior v r3_admin Task location v Monitoring for mysap.com System Tasks library v Target managed resource mysap.com application server GUI data entry fields This task has the following parameter: Choose mysap System Type Select the type of mysap.com system that you want to identify. The choices are: v APO v Automatic Identification v BW v CFM v CRM v R3 v SEM v UNKNOWN 114 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide

125 Identify mysap System Type Description TBD Authorization roles v r3_senior v r3_admin Task location v Monitoring for mysap.com System Tasks library Target managed resource GUI data entry fields None Chapter 3. Tasks for managing mysap.com resources 115

126 Move mysap System Description Moves a mysap.com system from one Policy Region to another. A list of available Policy regions is displayed along with a slide bar to allow you to view all available Policy Regions. Authorization roles v r3_senior Task location v Monitoring for mysap.com System Tasks library Target managed resource mysap.com managed node GUI data entry fields Here is an example of the mysap.com Move mysap System dialog: This task has the following parameter: New Policy Region Name: Available Policy Regions are displayed in this field in the pulldown. Select the Policy Region that you want to move the mysap.com system to. Click the Set and Execute button to move the mysap.com system. 116 IBM Tivoli Monitoring for Applications: mysap.com: Reference Guide