Tivoli WebSphere Studio Application Monitor Version 3.2 Release Notes GI11-4082-00
Tivoli WebSphere Studio Application Monitor Version 3.2 Release Notes GI11-4082-00
Note Before using this information and the product it supports, read the information in Notices on page 13. First Edition (April 2005) This edition applies to Version 3.2 of WebSphere Studio Application Monitor and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 2005. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents Release notes............ 1 About WebSphere Studio Application Monitor...1 System requirements............1 Supported environments.........1 Installation instructions...........3 Known problems and workarounds......4 Documentation updates..........6 Publications..............7 WebSphere Studio Application Monitor document library...............7 Release Notes............7 Product Documentation.........7 Accessing softcopy publications.......7 CDs...............8 Online..............8 Ordering publications..........8 Contacting software support........8 Searching knowledge bases.......9 Obtaining fixes...........9 Receiving weekly support updates....10 Contacting IBM Software Support.....10 Notices.............. 13 Trademarks..............15 iii
iv IBM Tivoli WebSphere Studio Application Monitor: Release Notes
Release notes These Release Notes provide the following important information about WebSphere Studio Application Monitor, Version 3.2 (WSAM). v About WebSphere Studio Application Monitor, Version 3.2 v System requirements v Installation instructions v Known problems and workarounds v Documentation updates v Publications About WebSphere Studio Application Monitor This release includes the following new and changed features for the Managing Server and the Data Collector. Managing Server: v Additional Platform support. v Embedded Installer for installing WAS and DB2. v Extended language support. WSAM 3.2 supports the following languages: English, Japanese, Korean, Simplified Chinese, Traditional Chinese, French, German, Italian, Spanish and Brazilian Portuguese languages. Data Collector: v Improved portal monitoring to provide more insight into key WebSphere portal metrics, such as, pages and portlets. v Enhanced Java Heap Analysis to track object allocation and potential memory leaks, as well as identify allocating classes and methods. v New Lock Analysis capability identifies synchronized method invocations, as well as the number and duration of (synchronized code) lock waits. v Enhanced J2EE application server coverage. v Increased platform coverage. System requirements Supported For complete information about system requirements, including software and hardware requirements, for WebSphere Studio Application Monitor, refer to the WebSphere Studio Application Monitor Installation and Customization Guide. environments This section lists the operating systems that work with the Managing Server and the Data Collector for WebSphere Studio Application Monitor. Supported environments for the Managing Server: Operating Systems v AIX 5.1, 5.2 or 5.3 v Linux on xseries (Red Hat Enterprise Linux {RHEL} 2.1 or 3.0) 1
v Linux on zseries (SuSE 8.1) v Solaris 8 or 9 v Windows 2000 with service pack (SP) 4 or Windows 2003 Databases v IBM DB2 8.1 Enterprise Server Edition (ESE) with fix pack 3 v IBM DB2 8.1 ESE with fix pack 5, or later v IBM DB2 8.2 v Oracle 8i Standard Edition (SE) R3 8.1.7, or later v Oracle 9i SE R2 9.2, or later v Oracle 10g Application Servers v IBM WebSphere Application Server 5.1.1, Base Edition (on AIX, Linux on xseries, Linux on zseries, Solaris, Windows) v BEA WebLogic 8.1 with service pack 3 (on Solaris using Oracle database) Supported environments for the Data Collector: Table 1. Supported environments for the Data Collector Operating System WebSphere Application Server 5.0.2.6 5.0.2.8 5.0.2 Portal BEA WebLogic 5.1.1 6.0 7 with SP5 8.1 with SP3 AIX 5.1 x x x x x x AIX 5.2 x x x x x x AIX 5.3 x x x Solaris 8 x x x x x x x x Solaris 9 x x x x x x x x Windows 2000 x x x x x x with SP4 Windows 2003 x x x x x x HP 11i 1 x x x x x x x RHEL 2.1 x x x x x x x (Linux on xseries) RHEL 3.0 x x x x (Linux on xseries) SuSE 8.1 (Linux on zseries) x x x MQ 5.3.0.7 2 IBM Tivoli WebSphere Studio Application Monitor: Release Notes
Installation instructions This section contains the instructions for installing the Managing Server and the Data Collector from the CDROM. Managing Server: To install the Managing Server from the CDROM: 1. Go to the directory: Installer-MS/bin 2. Follow the instructions defined in the WebSphere Studio Application Monitor Installation and Customization Guide Part 2. If you are not installing directly from the CDROM: copy the CDROM contents to a directory and follow the instructions defined in the WebSphere Studio Application Monitor Installation and Customization Guide Part 2. Note: The CDROM installation is not supported for IBM DB2 version 8.1 fixpack 3 and/or WebSphere Application Server 5.1.1 installation. You must copy DB2 and/or WAS images to your local drive and then proceed with the installation. Embedded Installer The following are Embedded installation instructions for WebSphere Application Server 5.1 fixpack1 and IBM DB2 v8.1 fixpack 3 WSAM 3.2 support DB2 v8.1.3 and higher. But if you use installer to install it, it will install only IBM DB2 v8.1 fixpack 3. You cannot use your own images for DB2 installation. You should use the one that is shipped with the WSAM 3.2 package. Do the following steps prior to running the installer. WAS 1. Insert the CD for WAS 5.1 and copy all the contents of WAS 5.1 media to the local directory (e.g. /tmp/was51). 2. Insert the CD for WAS fp1 and copy all the contents of WAS fixpack 1 media to the local directory (e.g. /tmp/wasfp1). 3. Do not mount these images. Make sure that these directories have write permissions. 4. On Windows, before installing WAS, check that the registray does not have any entry related to WebSphere Application Server 5.1.1. If you find it, then please remove it from the registry. Also while selecting the directory where you want to install WAS, make sure that this directory does not have any left over files from the previous WebSphere installation. You should delete the directory before running the installer. 5. Follow the instructions specified in Installation and Customization Guide, Chapter 5: How to uninstall WAS to uninstall previously installed WAS. 6. Follow the instructions in the Installation and Customization, Guide Chapter 3. 7. Go to the directory /Installer-MS/bin and execute install-ms.sh/bat and proceed to the installation. DB2 1. Insert the CD for DB2 v8.1 fixpack 3 and copy all the CD contents to the local directory. (e.g. /tmp/db2). Do not mount these images. Release notes 3
2. Uncompress ese.tar.z file to the same local directory using the following command: uncompress ese.tar.z 3. Untar ese.tar to the same local directory using the following command: tar -xf ese.tar 4. Verify the system requirements specified in the Installation and Customization Guide, Chapter 2: Hardware Requirement, Table 3. 5. Follow the instructions in the Installation and Customization Guide, Chapter 3. except you do not need to create an amuser if you are installing IBM DB2 v8.1 fixpack 3 using the installer. Instance name is considered as amuser and after the installation you need to login as instance name to start the kernel. 6. You need to make sure that port 50000 is not used by any other services and is not specified in /etc/services file. In addition, for UNIX, verify that the /etc/services file is a read-only file before the installation. 7. Follow the instructions specified in the Installation and Customization Guide, Chapter 5: How to uninstall DB2 to uninstall previously installed DB2. 8. Go to the directory /Installer-MS/bin and execute install-ms.sh/bat and proceed with the installation. 9. When it asks for DB2 images, specify the directory up to ese (for UNIX) and win (for Windows). The embedded installer will first gather all user inputs and then will install DB2 and/or WAS and then WSAM. Data Collector: To install the Data Collector from the CDROM: 1. Go to the directory: Installer-DC/bin 2. Follow the instructions defined in the WebSphere Studio Application Monitor Installation and Customization Guide Part 4. If you are not installing directly from the CDROM: copy the CDROM contents to a directory and follow the instructions defined in the WebSphere Studio Application Monitor Installation and Customization Guide Part 4. Known problems and workarounds This section contains information regarding the known problems and workarounds for the Managing Server and the Data Collector. Managing Server v For Solaris operating system and local Oracle Database, sqplplus user (eg. oracle) must use sh shell and variables should be defined in the.profile file. To verify that the profile is set correctly, run the following command which should return your sqlplus path. su - <sqlplus_user(oracle)> -c "which sqlplus" v The Managing Server Installer requires default server1 templates located in <WAS Installation Directory>/config/templates/default/nodes/servers/server1/ directory. So if you modify any of these default templates, restore them before you run the installer. v During the installation, you might see one of the following exceptions in the installer-ms.log. It will not affect your installation so you can ignore it. 4 IBM Tivoli WebSphere Studio Application Monitor: Release Notes
Install, com.installshield.product.service.product.purejavaproductserviceimpl$installer, err, ProductException: (error code = 601; message= JVM not found ) ProductException: (error code = 601; message= JVM not found ) The following exception might be seen during the embedded DB2 Installation. java.lang.nullpointerexception at com.installshield.managingdevice.event.dialog.swing. PanelDB2_das_user.checkedISRadioButtonDef9(PanelDB2_das_user.java:202) java.lang.nullpointerexception at com.installshield.managingdevice.event.dialog.swing. PanelDB2_fence_user.checkedControl107(PanelDB2_fence_user.java:180) java.lang.nullpointerexception at com.installshield.managingdevice.event.dialog.swing. PanelDB2_instance_user.checkedControl110(PanelDB2_instance_user.java:200) v To view WSAM, if the user s language is English, the default browser resolution should be set to 1024X768. For all other languages, the browser resolution should be set to 1280X1024. v When the browser language is set to Simplified Chinese, Chinese input is not accepted. To fix this problem, please make the following change: In $WAS_HOME/properties/encoding.properties, edit the property for zh by changing zh=gb2312 to zh=utf-8. Restart the server in order for the change to take effect. v There is an inconsistency between the English version of msg.properties and msg_jsp. properties and the corresponding files in other languages. These differences will cause users to see different instructions and error messages on the Installed Binary Comparison page. 1. For the English version of the Installed Binary Comparison page, a user will see the instructional text as: The Installed Binary Comparison page is where you set up a comparison of binary files on application servers. From a group, select a server as the authoritative server. Then select up to 5 servers for comparison to the authoritative server. 2. In the English version of the Binary Comparison page, a user will see the error messages: CYNVE0446E: Select up to 5 Comparison Servers. CYNVE0448E: Select up to 5 servers for comparison. 3. For all other languages on this page, a user will see 10 instead of 5 in place of the number of servers for comparison. Only a maximum of 5 servers are supported for Installed Binary Comparision. v At times, idle time can be negative for Recent Requests in the Server Activity Display page. This may happen if the actual CPU time taken for the request is very small, and Operating System resolutions might be different for Resident time (wall clock) and CPU Time (cpu clock). v Thread dump is not encouraged as a trap action in a production environment, it can impose latency on trap actions, and drive high CPU usage on the Data Collector and Managing Server. v For WSAM SNMP messages, non-ascii characters are not supported for Trap Names. v The Managing Server supports Global Security=on. What the Managing Server does not support is SSL connections to the WSAM VE (which can be used regardless of whether Global Security=on.) Data Collector Release notes 5
Documentation v During the WebSphere Data Collector Installation, two variables called AM_HOME and MS_AM_HOME are created in a variables.xml file located under <WAS Installation Directory>/config/cells/<cell name>/nodes/<node name>/servers/<server name>. You must delete these two variables when you do the manual uninstallation of the Data Collector. v If you are using Exceed to run the installation then you might not see the last panel after the installation is done. This should not cause any problem except that the installer will exit after it is done. This is caused due to a bug in the jre. You can use jre 1.4.2.x to avoid this problem. v Add the following line in a batch script Installer-DC/bin/install-DC.bat before running the silent Data Collector installer on windows. copy %CYN_TEMP%\dcInputs.txt %CYN_TEMP%\org_dcInputs.txt Put the above line right before the following line (you can search for the word SilentValidation to go to this line ). %JAVA_HOME%\bin\java.exe -DCOBRAND= %COBRAND_1% -DCYN_WIN_LOG= %CYN_WIN_LOG% -Dcyanea.log.properties=%CYN_TEMP%\\log-validation-win1.properties -classpath %CL ASSPATH% com.cyanea.validation.silentvalidation -dc %CYANEA_LOG_DIR%\\dcInputs.txt updates This section contains documentation updates for the Managing Server and the Data Collector. Managing Server Installation and Customization Guide updates: v All instances of monitoring and performance management should be changed to monitoring and performance analysis. v The update is located in Part 2: The Managing Server Installation,Chapter 3: Installation and Configuration, Section: Upgrading Considerations>Migrating Data>Performing a Migration. The third step says: Execute data migration scripts. You should be logged in as amuser. Execute SQL script: (The change is in parenthesis.) For Oracle databases, go to Oracle database server: sqlplus <am database user name>/<am database user password>@<am ORACLE_SID>@$AM_HOME/etc/migratetables-oracle.sql >$AM_HOME/logs/migratedb.log v The update is located in Part 2: The Managing Server Installation, Chapter 4: Customization, Section: Configuring Managing Server for Multiple Network Cards and NAT. Step one should be as follows: On the Managing Server side, in setenv.sh (in <MS_AM_HOME>/bin/), set the KERNEL_HOST01 and KERNEL_HOST02 to the internal IP address of the Managing Server. IMS Data Collector Product Guide updates: All instances of performance management should be changed to performance analysis. Data Collector User s Guide updates: 6 IBM Tivoli WebSphere Studio Application Monitor: Release Notes
v The update is located in Chapter 20 regarding configuring request mapper. The property name should be com.cyanea.mapper.http.userid.source instead of com.cyanea.mapper.userid.source. v The update is located in Chapter 20 regarding configuring request mapper. The request mapper library should be placed in <AM_DC_HOME>/lib/ext/ directory instead of in the classpath of the JVM. Publications This section contains the following information regarding WebSphere Studio Application Monitor documentation: v Documentation library contents v Accessing softcopy publications v Ordering publications v Contacting software support WebSphere Studio Application Monitor document library This section lists publications in the WebSphere Studio Application Monitor library. It also describes how to access Tivoli publications online, and how to order Tivoli publications. Release Notes The following publication is available for WebSphere Studio Application Monitor, Version 3.2: v WebSphere Studio Application Monitor Release Notes, SC23-4851 Provides information about product features, supported operating systems and estimated disk space requirements. Product Documentation The following list shows the books in the Application Monitor library: v WebSphere Studio Application Monitor User s Guide contains instructions and user information for the Application Monitor. v WebSphere Studio Application Monitor Operator s Guide contains information about the operation of Application Monitor and the common services address space. v WebSphere Studio Application Monitor Installation and Customization Guide contains instructions on installing user s exits and customizing the Application Monitor. In addition, contains troubleshooting and configuration information. v WebSphere Studio Application MonitorCICS Data Collector Product Guide contains information about the installation, configuration and use of the Application Monitor CICS Data Collector. v WebSphere Studio Application Monitor Messages and Codes contains information about messages and codes generated by the Application Monitor. v WebSphere Studio Application Monitor Program Directory contains complete installation instructions for the Application Monitor Engine. v The WebSphere Studio Application Monitor Controller has an online help system that describes all of the commands and dialogs available from its graphical user interface. Accessing softcopy publications You can access publications for this product from documentation CDs or online in PDF and HTML formats: Release notes 7
Ordering CDs The following documentation CD provides publications for WebSphere Studio Application Monitor: v WebSphere Studio Application Monitor, Version 5.1.1: Documentation CD, LK3T-8517 The documentation CD contains the publications that are in the product library. The format of the publications is PDF, HTML, or both. Refer to the readme file on the CD for instructions on how to access the documentation. Online The following Web sites provide publications for WebSphere Studio Application Monitor: v Tivoli Information Center IBM posts publications for this and all other Tivoli products, as they become available and whenever they are updated, to the Tivoli Software Information Center Web site. The Tivoli Software Information Center is located at the following Web address: http://publib.boulder.ibm.com/tividd/td/tdprodlist.html Click the WebSphere Studio Application Monitor link to access the product library. v Passport Advantage Passport Advantage is an IBM licensing program for distributed software. You can download documentation files from Passport Advantage if you enroll in the program. When you enroll in the program, you are assigned a user name and password with which to access the files. You can access Passport Advantage at the following Web address: http://www-3.ibm.com/software/passportadvantage/ All downloadable parts of IBM Tivoli Monitoring for Databases are self-extracting archives. You can log in to Passport Advantage with your assigned user name and password and download any required and optional parts. publications You can order many Tivoli publications online at the following Web site: wwww.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi You can also order by telephone by calling one of these numbers: v In the United States: 800-879-2755 v In Canada: 800-426-4968 In other countries see the following Web site for a list of telephone numbers: http://www.ibm.com/software/tivoli/order-lit/ Contacting software support http://www.ibm.com/software/support http://techsupport.services.ibm.com/guides/handbook.html http://techsupport.services.ibm.com/guides/contacts.html 8 IBM Tivoli WebSphere Studio Application Monitor: Release Notes
http://www.lotus.com/services/passport.nsf/ WebDocs/Passport_Advantage_Home https://techsupport.services.ibm.com/ssr/login http://www.ibm.com/software/support/probsub.html http://www.ibm.com/servers/eserver/techsupport.html http://www.ibm.com/services/us/index.wss/so/its/a1000030/dt006 If you have a problem with your IBM software, you want to resolve it quickly. This section describes the following options for obtaining support for IBM software products: v Searching knowledge bases v Obtaining fixes v Receiving weekly support updates on page 10 v Contacting IBM Software Support on page 10 Searching knowledge bases You can search the available knowledge bases to determine whether your problem was already encountered and is already documented. Searching the information center: IBM provides extensive documentation that can be installed on your local computer or on an intranet server. You can use the search function of this information center to query conceptual information, instructions for completing tasks, and reference information. Searching the Internet: If you cannot find an answer to your question in the information center, search the Internet for the latest, most complete information that might help you resolve your problem. To search multiple Internet resources for your product, use the Web search topic in your information center. In the navigation frame, click Troubleshooting and support Searching knowledge bases and select Web search. From this topic, you can search a variety of resources, including the following: v IBM technotes v IBM downloads v IBM Redbooks v IBM developerworks v Forums and newsgroups v Google Obtaining fixes A product fix might be available to resolve your problem. To determine what fixes are available for your IBM software product, follow these steps: 1. Go to the IBM Software Support Web site at http://www.ibm.com/software/support. 2. Click Downloads and drivers in the Support topics section. 3. Select the Software category. 4. Select a product in the Sub-category list. 5. In the Find downloads and drivers by product section, select one software category from the Category list. Release notes 9
6. Select one product from the Sub-category list. 7. Type more search terms in the Search within results if you want to refine your search. 8. Click Search. 9. From the list of downloads returned by your search, click the name of a fix to read the description of the fix and to optionally download the fix. For more information about the types of fixes that are available, see the IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/handbook.html. Receiving weekly support updates To receive weekly e-mail notifications about fixes and other software support news, follow these steps: 1. Go to the IBM Software Support Web site at http://www.ibm.com/software/support. 2. Click My support in the upper right corner of the page. 3. If you have already registered for My support, sign in and skip to the next step. If you have not registered, click register now. Complete the registration form using your e-mail address as your IBM ID and click Submit. 4. Click Edit profile. 5. In the Products list, select Software. A second list is displayed. 6. In the second list, select a product segment, for example, Application servers. A third list is displayed. 7. In the third list, select a product sub-segment, for example, Distributed Application & Web Servers. A list of applicable products is displayed. 8. Select the products for which you want to receive updates, for example, IBM HTTP Server and WebSphere Application Server. 9. Click Add products. 10. After selecting all products that are of interest to you, click Subscribe to email on the Edit profile tab. 11. Select Please send these documents by weekly email. 12. Update your e-mail address as needed. 13. In the Documents list, select Software. 14. Select the types of documents that you want to receive information about. 15. Click Update. If you experience problems with the My support feature, you can obtain help in one of the following ways: Online Send an e-mail message to erchelp@ca.ibm.com, describing your problem. By phone Call 1-800-IBM-4You (1-800-426-4968). Contacting IBM Software Support IBM Software Support provides assistance with product defects. Before contacting IBM Software Support, your company must have an active IBM software maintenance contract, and you must be authorized to submit problems to IBM. The type of software maintenance contract that you need depends on the type of product you have: 10 IBM Tivoli WebSphere Studio Application Monitor: Release Notes
v For IBM distributed software products (including, but not limited to, Tivoli, Lotus, and Rational products, as well as DB2 and WebSphere products that run on Windows, or UNIX operating systems), enroll in Passport Advantage in one of the following ways: Online Go to the Passport Advantage Web site at http://www.lotus.com/services/passport.nsf/ WebDocs/Passport_Advantage_Home and click How to Enroll. By phone For the phone number to call in your country, go to the IBM Software Support Web site at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region. v For customers with Subscription and Support (S & S) contracts, go to the Software Service Request Web site at https://techsupport.services.ibm.com/ssr/login. v For customers with IBMLink, CATIA, Linux, S/390, iseries, pseries, zseries, and other support agreements, go to the IBM Support Line Web site at http://www.ibm.com/services/us/index.wss/so/its/a1000030/dt006. v For IBM eserver software products (including, but not limited to, DB2 and WebSphere products that run in zseries, pseries, and iseries environments), you can purchase a software maintenance agreement by working directly with an IBM sales representative or an IBM Business Partner. For more information about support for eserver software products, go to the IBM Technical Support Advantage Web site at http://www.ibm.com/servers/eserver/techsupport.html. If you are not sure what type of software maintenance contract you need, call 1-800-IBMSERV (1-800-426-7378) in the United States. From other countries, go to the contacts page of the IBM Software Support Handbook on the Web at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region for phone numbers of people who provide support for your location. To contact IBM Software support, follow these steps: 1. Determining the business impact 2. Describing problems and gathering information on page 12 3. Submitting problems on page 12 Determining the business impact: When you report a problem to IBM, you are asked to supply a severity level. Therefore, you need to understand and assess the business impact of the problem that you are reporting. Use the following criteria: Severity 1 The problem has a critical business impact. You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution. Severity 2 The problem has a significant business impact. The program is usable, but it is severely limited. Severity 3 The problem has some business impact. The program is usable, but less significant features (not critical to operations) are unavailable. Release notes 11
Severity 4 The problem has minimal business impact. The problem causes little impact on operations, or a reasonable circumvention to the problem was implemented. Describing problems and gathering information: When describing a problem to IBM, be as specific as possible. Include all relevant background information so that IBM Software Support specialists can help you solve the problem efficiently. To save time, know the answers to these questions: v What software versions were you running when the problem occurred? v Do you have logs, traces, and messages that are related to the problem symptoms? IBM Software Support is likely to ask for this information. v Can you re-create the problem? If so, what steps were performed to re-create the problem? v Did you make any changes to the system? For example, did you make changes to the hardware, operating system, networking software, and so on. v Are you currently using a workaround for the problem? If so, be prepared to explain the workaround when you report the problem. Submitting problems: You can submit your problem to IBM Software Support in one of two ways: Online By Click Submit and track problems on the IBM Software Support site at http://www.ibm.com/software/support/probsub.html. Type your information into the appropriate problem submission form. phone For the phone number to call in your country, go to the contacts page of the IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region. If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM Software Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Software Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the Software Support Web site daily, so that other users who experience the same problem can benefit from the same resolution. 12 IBM Tivoli WebSphere Studio Application Monitor: Release Notes
Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user s responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described 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: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. 13
Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM s future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: 14 IBM Tivoli WebSphere Studio Application Monitor: Release Notes
This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM s application programming interfaces. Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights reserved. If you are viewing this information in softcopy form, the photographs and color illustrations might not appear. Trademarks IBM, the IBM logo, Tivoli, the Tivoli logo, AIX, DB2, IBMLink, Informix, OS/2, OS/400, Tivoli Enterprise Console, and TME are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Lotus and Lotus Notes are trademarks of International Business Machines Corporation and Lotus Development Corporation in the United States, other countries, or both. Microsoft and Windows NT are registered trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. 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 may be trademarks or service marks of others. Notices 15
16 IBM Tivoli WebSphere Studio Application Monitor: Release Notes
Printed in USA GI11-4082-00