Version Release Notes GI

Transcription

1 Tivoli IBM Tivoli OMEGAMON XE for CICS on z/os Version Release Notes GI

2

3 Tivoli IBM Tivoli OMEGAMON XE for CICS on z/os Version Release Notes GI

4 Note Before using this information and the product it supports, read the information in Notices on page 7. First Edition (July 2005) This edition applies to Version of IBM Tivoli OMEGAMON XE for CICS on z/os and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Release notes Where to find the latest information Tivoli OMEGAMON XE for CICS on z/os library 1 Changes in product and component names....2 OMEGAMON II documentation for monitoring agents OMEGAVIEW documentation Changes to the locations of information Limitations and troubleshooting for version 360 of the OMEGAMON Platform Issues with OMEGAMON platform components.5 Issues with Candle Management Server...5 Issues with setting up DB Configuring and usability issues Accessibility limitations Hardware issues with CandleNet Portal...6 Fix pack, prerequisites, and build level issues.6 Notices Trademarks Support Searching knowledge bases Searching the information center Searching the Internet Obtaining fixes Receiving weekly support updates Contacting IBM Software Support Determining the business impact Describing problems and gathering information 12 Submitting problems iii

6 iv IBM Tivoli OMEGAMON XE for CICS on z/os: Release Notes

7 Release notes These Release Notes provide the following important information about the IBM Tivoli OMEGAMON XE for CICS on z/os Version product: v Where to find the latest information v Tivoli OMEGAMON XE for CICS on z/os library v Changes in product and component names on page 2 v Changes to the locations of information on page 3 v Limitations and troubleshooting for version 360 of the OMEGAMON Platform on page 4 Where to find the latest information You received the documentation for IBM Tivoli OMEGAMON XE for CICS on z/os and for the OMEGAMON platform components on CD-ROM. To ensure you have the most up-to-date information about installation procedures and known workaround and limitations for this product, check this Web site for a later version: Consult this Web site before beginning any of the procedures in the configuration or user guides since the Web site contains the most current information for the product and takes precedence over all other product documentation. The Information Center for IBM Tivoli OMEGAMON XE for CICS on z/os is found at this Web site: Tivoli OMEGAMON XE for CICS on z/os library With this release, there are three main books. v IBM Tivoli OMEGAMON XE for CICS on z/os: Getting Started is a planning book and provides An introduction to the product Software and hardware prerequisites Serviceability, scaleabilty and tuning information An outline of four basic configurations that you can use deploy Tivoli OMEGAMON XE for CICS on z/os. The appendix provides worksheets that you can use to calculate space requirements for collecting history data. v IBM Tivoli OMEGAMON XE for CICS on z/os: Configuring IBM Tivoli OMEGAMON XE on CICS for z/os describes the procedures to configure each of the four configurations. You can use these procedures to get started. The configuration procedure described are: Candle Management Server and Monitoring Agent in a single z/os image Candle Management Server on a distributed system (Windows) Configuring Tivoli OMEGAMON XE for CICS on z/os over multiple z/os images 1

8 Candle Management Server and Monitoring Agent in the same address space. Installing and configuring CandleNet Portal on a workstation Configuring the collection of historical tasks Migration The use of some of the advanced features of the Configuration Tool v IBM Tivoli OMEGAMON XE for CICS on z/os: Using Tivoli OMEGAMON XE for CICS on z/os incorporates: A tutorial to walk you through the features and functions of CandleNet Portal Two typical CICS scenarios so that you can understand how to exploit Tivoli OMEGAMON XE for CICS on z/os. There is also a comprehensive reference section. It includes predefined: - Attributes - Situations - Workspaces It also includes all the messages that are issued by both Tivoli OMEGAMON XE for CICS on z/os and Tivoli OMEGAMON II for CICS on z/os products. The information center incorporates the Tivoli OMEGAMON II for CICS on z/os books (They are unchanged form the previous release) and the related documentation. Changes in product and component names IBM recently acquired Candle Corporation. The transition of Candle ordering and service processes is complete. As you will see in this publication, this release is part of a transition phase of this acquisition. Many changes have been made to this product and its publications to deliver it as an IBM product. You will notice that much of the Candle terminology and component names used to describe the OMEGAMON products remain unchanged. However, in some cases, the product release number has been modified. For example, the version of CandleNet Portal required by this release is version 196. Publications that have been modified, such as IBM Tivoli OMEGAMON Platform: Installing and Setting up OMEGAMON Platform and CandleNet Portal on Windows and UNIX include the new version 196 release number on the cover. Publications that have not been modified, such as IBM Tivoli OMEGAMON Platform: Administering OMEGAMON Products: CandleNet Portal Version 195 and IBM Tivoli OMEGAMON Platform: Using OMEGAMON Products: CandleNet Portal Version 195 continue to carry the previous version 195 release number. Note that the information provided in these books is still valid for version 196. Candle products have new IBM names, and during this transition period, some publications use the old names while others use the new names. For example, CandleNet Portal might be referred to by the new name Tivoli Management Portal. For a mapping of previous Candle names and new IBM names, refer to Table 1 on page 3 shows the mapping of the former Candle names for OMEGAMON platform components to the new IBM names. 2 IBM Tivoli OMEGAMON XE for CICS on z/os: Release Notes

9 Table 1. Mapping of former Candle names to new IBM names Former Name New Name CandleNet Portal Tivoli Enterprise Portal CandleNet Portal Server Tivoli Enterprise Portal Server Candle Management Server Tivoli Enterprise Monitoring Server Candle agent Tivoli Enterprise Monitoring Agent OMEGAMON Tivoli Monitoring Services OMEGAMON Platform Tivoli Monitoring Services Manage Candle Services Manage Tivoli Monitoring Services event situation event Event Console Enterprise Event Console Manage Candle Services Tivoli Enterprise Services OMEGAMON II documentation for monitoring agents Most OMEGAMON II documentation has not been updated. These documents refer to the Candle Support structure rather than to IBM Software Support. References to Candle Support processes and procedures are invalid. Direct questions to IBM Software Support. For details about the IBM support structure, see Support on page 9. OMEGAVIEW documentation References to OMEGAVIEW in the OMEGAMON II documentation sets should not to be interpreted to mean that OMEGAVIEW is provided with the product being documented. The OMEGAVIEW and OMEGAVIEW II for the Enterprise products are now components of the IBM Tivoli OMEGAMON DE on z/os product. To order this product, contact your IBM account representative. Changes to the locations of information As part of the transition from Candle to IBM, some of the information to support the OMEGAMON platform and monitoring agent products has been moved to new locations. Table 2 maps the old location for familiar information to the new location. Table 2. Information location changes between OMEGAMON platform version 350 and version 360 Information Location in version 350 library Location in version 360 library Location of the Tivoli OMEGAMON XE for CICS on z/os messages Only in IBM Tivoli OMEGAMON XE Platform: Candle Products Messages Volume 2 (EU KLVGM) Still found in IBM Tivoli OMEGAMON XE Platform: Candle Products Messages Volume 2 (EU KLVGM) but also part of the Tivoli OMEGAMON XE for CICS on z/os Information Center and searchable by number from Release notes 3

10 Table 2. Information location changes between OMEGAMON platform version 350 and version 360 (continued) Information Location in version 350 library Location in version 360 library Installation information for distributed platform products (for example, CandleNet Portal Server on UNIX ) Space required for historical data tables used by the Tivoli OMEGAMON XE for CICS on z/os monitoring agent Installation guides were organized by platform, with all distributed platform products being covered in one installation guide. IBM Tivoli OMEGAMON Platform: Historical Data Collection Guide for OMEGAMON XE Products,Versions 360 and 196 Installation of the product The product was installed using Candle Installation and Configuration Assistance Tool (CICAT). This process was documented in the online help for CICAT. v For distributed components, IBM Tivoli OMEGAMON Platform: Installing and Setting up OMEGAMON Platform and CandleNet Portal on Windows and UNIX v For Candle Management Server of z/os, IBM Tivoli OMEGAMON Platform: Configuring Candle Management Server on z/os Historical data table appendix in IBM Tivoli OMEGAMON XE for CICS on z/os: Getting Started The product is now installed using the IBM System Modification Program/Extended (SMP/E) tool and instructions found in the IBM Tivoli OMEGAMON XE for CICS on z/os: Program Directory. Planning Tivoli OMEGAMON XE for CICS on z/os CICAT has been renamed the Configuration Tool. You still use this tool to configure the product after the SMP/E installation is complete. Information about configuration is found in IBM Tivoli OMEGAMON XE for CICS on z/os: Configuring IBM Tivoli OMEGAMON XE on CICS for z/os. Distributed across the library IBM Tivoli OMEGAMON XE for CICS on z/os: Getting Started, a new book, which includes information about such topics as: v Platform function and components v Prerequisites v Security planning v v Packaging Serviceability v Platform tuning v Install flow v Information sources Limitations and troubleshooting for version 360 of the OMEGAMON Platform The topics below discuss known limitations that you should be aware of associated with Tivoli OMEGAMON XE for CICS on z/os running on the OMEGAMON platform version 360. Some of the information below is provided to help you troubleshoot problems you might be having. Where explanations are available, they are suggested. 4 IBM Tivoli OMEGAMON XE for CICS on z/os: Release Notes

11 The following groups of issues are covered: v Issues with OMEGAMON platform components v Configuring and usability issues Issues with OMEGAMON platform components This section includes the following kinds of information: v Issues with Candle Management Server v Issues with setting up DB2 Issues with Candle Management Server You might encounter these confusing situations in connection with Candle Management Server. v Occasionally, the seeding of the Candle Management Server may fail with return code 171. Typically, this is caused by either the Candle Management Server not being fully initialized or by a communication failure with the Candle Management Server. Ensure that the Candle Management Server has successfully initialized and that a successful connection has been established. Then retry the operation. Another reason for the unsuccessful seeding of the Candle Management Server is due to different levels of code between the Candle Management Server and CandleNet Portal Server. Check the prerequisites in the IBM Tivoli OMEGAMON XE for CICS on z/os: Getting Started guide and install the correct versions of all components. v If, when you configure a z/os-based Candle Management Server and use the same CMS_NODEID for both the remote and hub Candle Management Servers, the server will abend when it is started. Provide different CMS_NODEIDs for the remote and hub Candle Management Servers Issues with setting up DB2 If you change either your DB2 password or the DB2 userid after you install CandleNet Portal and CandleNet Portal Server, then CandleNet Portal Server might not initialize correctly the next time it is started. One symptom of this is that a user logging on to CandleNet Portal will not be able to connect to the CandleNet Portal Server. You can check the problem by looking for SQL exceptions in the CandleNet Portal Server trace log. Configuring and usability issues You should be aware of the following types of configuration and use issues. v Accessibility limitations v Hardware issues with CandleNet Portal on page 6 Accessibility limitations CandleNet Portal is not fully keyboard accessible. v The CandleNet Portal workspace presentation objects (such as Report Table, Pie Chart, or Bar Chart) cannot be selected from the pull-downs menus. v Chart or Report types, once selected, cannot be de-selected without deliberately performing an unnecessary action. v There is also no key-based fastpath. Release notes 5

12 v The tab key cannot be used to cycle through selections on the tool bar. v You cannot use the keyboard to navigate or select the situation condition Relational Operators or Formula Functions when these operators are displayed as a list. Hardware issues with CandleNet Portal Below are irregularities you may experience when you using the CandleNet Portal graphing facility: v Support for multi-screen environments is not fully implemented. v Incompatibility can occur when CandleNet Portal and CandleNet Portal Server is installed on different on Windows workstations. v Do not run two instances of CandleNet Portal on the same workstation. Fix pack, prerequisites, and build level issues v Intermittent irregularities have been noted when the CandleNet Portal browser client is running under the Sun Java Runtime Environment (JRE) version 1.4.2_04 or higher. A General Exception pop-up is displayed in the browser, and the browser closes. v The Help > About CandleNet Portal function on the CandleNet Portal desktop shows only the build level. It is not possible for this facility to determine when a fix pack has been installed on CandleNet Portal. Build levels and fix pack installations are recorded in the CandleNet Portal trace logs. v The online help system works with Internet Explorer Version 6 or above only. You should turn off any Java plugins in your browser to enable the search facility to work. To turn this off enter Tools > Internet Options > Advanced and deselect IBM Java. You should then restart your browser. 6 IBM Tivoli OMEGAMON XE for CICS on z/os: Release Notes

13 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 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 in 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 may not apply to you. This publication 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. 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: 7

14 IBM Corporation 2Z4A/ Burnet Road Austin, TX 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 Programming License Agreement, or any equivalent agreement between us. Trademarks The following terms are trademarks of International Business Machines Corporation in the United States, or other countries, or both: Table 3. Trademarks AF/OPERATOR ETE OMEGAMON II Candle IBM RMF Candle Command Center IBMLink SP Candle Management Server IMS Tivoli CandleNet Command Center MQSeries VTAM CandleNet Portal MVS WebSphere CICS MVS/ESA z/os CICS/ESA MVS/XA zseries CICS/MVS OMEGACENTER DB2 OMEGAMON Java and all Java-based trademarks and logos are 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. Windows is a registered trademark of Microsoft Corporation. Other company, product, and service names may be trademarks or service marks of others. 8 IBM Tivoli OMEGAMON XE for CICS on z/os: Release Notes

15 Support 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 Searching knowledge bases v Receiving weekly support updates on page 10 v Contacting IBM Software Support on page 10 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 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. 9

16 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 Receiving weekly support updates To receive weekly notifications about fixes and other software support news, follow these steps: 1. Go to the IBM Software Support Web site at 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 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 on the Edit profile tab. 11. Select Please send these documents by weekly Update your 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 message to erchelp@ca.ibm.com, describing your problem. By phone Call IBM-4You ( ). Contacting IBM Software Support IBM Software Support provides assistance with product defects. 10 IBM Tivoli OMEGAMON XE for CICS on z/os: Release Notes

17 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: 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 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 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 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 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 If you are not sure what type of software maintenance contract you need, call IBMSERV ( ) in the United States. From other countries, go to the contacts page of the IBM Software Support Handbook on the Web at 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 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. Support 11

18 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. 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: Submitting 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. 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 athttp:// 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 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 OMEGAMON XE for CICS on z/os: Release Notes

19

20 Printed in USA GI