Event Pump 4.2.0 Interim Feature 3 4.2.0.3-TIV-EP-IF0003.README Copyright IBM Corporation 2009. All Rights Reserved. ========================================================================= CONTENTS ========================================================================= 1.0 About this Interim Feature 1.1 Product fix history 1.2 New or updated modules 1.3 Backward compatibility with prior version of this product 1.4 Cross-Product compatibility 1.5 Known issues and limitations 2.0 Installation and configuration 2.1 Hardware and Software requirements 2.2 Installation 2.3 Configuration 3.0 Support Information 3.1 Using IBM Support Assistant 3.2 Obtaining Fixes 3.3 Receiving weekly support updates 3.4 Contacting IBM Software Support 4.0 Notices and Trademarks 4.1 Notices 4.2 Trademarks ========================================================================= 1.0 ABOUT THIS INTERIM FEATURE ========================================================================= Set the font to monospace to better view this file. This maintenance update is Interim Feature 3 for Tivoli Event Pump 4.2.0. It includes the change(s) listed below. ========================================================================= 1.1 Product fix history ========================================================================= This maintenance update contains Netcool/OMNIbus EIF Probe and data base server updates, as well as Tivoli Business Service Manager server updates that are related to the following Event Pump APAR: OA29881 EVENT PUMP INTERIM FEATURE 3 The Event Pump Interim Feature 3 delivers the following function: CICSPlex System Manager (CPSM) data source A new data source for CPSM is added with this enhancement There are corresponding Event Pump address space updates delivered via a PTF through APAR OA29881. The Netcool/OMNIbus server updates that are supplied with this MDV can be installed independently from the PTF that supplies the Event Pump address space updates. See the APAR record in RETAIN for more information. The PTF that corresponds to APAR OA29881 has a prereq for the PTF that corresponds to APAR OA26539 (the Interim Feature 1 APAR). Note that this prereq extends to the 4.2.0.1-TIV-EP-IF0001 MDV for Interim Feature 1. Insure that you have installed the 4.2.0.1-TIV-EP-IF0001 MDV prior to applying the 4.2.0.3-TIV-EP-IF0003 MDV. ======================================================================== 1.2 New or updated modules ======================================================================== New Files: ----------- zOSEventSupport_cpsm.sql zOSEventSupport_rules.sh Changed Files: ---------------- zOSEventSupport.sql zos_event.rules zos_cics_event.rules Installation Files: ------------------- zOSEventSupport_copy.bat zOSEventSupport_rules.bat zOSEventSupport_sql.bat zOSEventSupport_copy.sh zOSEventSupport_sql.sh ========================================================================= 1.3 Backward-Product compatibility ========================================================================= There are no backward-product compatibility issues with this maintenance. ========================================================================= 1.4 Cross-Product compatibility ========================================================================= There are no cross-product compatibility issues with this maintenance. ========================================================================= 1.5 Known issues and limitations ========================================================================= None. ========================================================================= 2.0 Installation and configuration ========================================================================= ========================================================================= 2.1 Hardware and Software Requirements ========================================================================= Install the 4.2.0.1-TIV-EP-IF0001 MDV. If you are forwarding alerts to the Tivoli Business Systems Manager, also install the TBSM maintenance associated with APAR IZ60369. ========================================================================= 2.2 Installation steps: ========================================================================= The probe rules are shipped for either Windows or Linux (x86) systems. For Windows Systems (Netcool/OMNIbus server files) -------------------------------------------------- 1. Copy 4.2.0.3-TIV-EP-IF0003.zip to a download directory on the Netcool/OMNIbus server. 2. Extract the files from 4.2.0.3-TIV-EP-IF0003.zip. For example, use the Extract option of Windows Explorer. This action will create the directory 4.2.0.3-TIV-EP-IF0003 in your current download directory. It includes this readme. 3. Change to 4.2.0.3-TIV-EP-IF0003 and run zOSEventSupport_copy.bat This batch file will create an EventPump directory under the %OMNIHOME%\etc directory (if one does not already exist), and then copy all of the maintenance update files to the %OMNIHOME%\etc\EventPump directory. NOTE: If you have already installed a previous Interim Feature for the Event Pump, the directory %OMNIHOME%\etc\EventPump should already exist. The files listed under the Changed Files and Installation Files sections (above) will already be in this directory. Any modifications you may have made to these files will be overwritten by this step; if you wish to save your previous modifications, rename the files. In particular, if you have customized the zOSEventSupport_sql.bat file to contain your database name, userid, and password, you do not need to copy the version of this file shipped in 4.2.0.3-TIV-EP-IF0003. Delete or rename this file in the 4.2.0.3-TIV-EP-IF0003 directory. 4. Switch to the %OMNIHOME%\etc\EventPump directory. Copy the new and changed rules files into the %OMNIHOME%\probes\win32 directory by running the zOSEventSupport_rules.bat file. NOTE: The zos_event.rules file shipped with this interim feature is a current copy, which includes all changes from any previous maintenance. The zOSEventSupoport_rules.bat does not copy it to the %OMNIHOME%/probes/win32 directory. If you do not have a copy of zos_event.rules file in the %OMNIHOME%/probes/win32 directory, remove the REM in front of the statement which copies this file. If you have modified your existing zos_event.rules file to comment out the include for zos_cics_event.rules, you must uncomment this line to enable the CPSM rules. Base CICs and CPSM rules are defined in the same file, zos_cics_event.rules. 5. Update the Netcool/ONMIbus server database. If not already done, modify the zOSEventSupport_sql.bat file by supplying the correct server database name, userid, and password. Modify the sql file name to zOSEventSupport_cpsm.sql. Then run the bat file. For Unix and Linux(x86) Systems (Netcool/OMNIbus server files) -------------------------------------------------------------- 1. Copy 4.2.0.3-TIV-EP-IF0003.tar to a download directory on the Netcool/OMNIbus server. 2. Extract the files from 4.2.0.3-TIV-EP-IF0003.tar. For example, use the tar command tar -xvf 4.2.0.3-TIV-EP-IF0003.tar. This action will create the directory 4.2.0.3-TIV-EP-IF0003 in your current download directory. It includes this readme. 3. Change to 4.2.0.3-TIV-EP-IF0003 and run zOSEventSupport_copy.sh This shell script will create an EventPump directory under the $OMNIHOME/etc directory (if one does not already exist), and then copy all of the maintenance update files to the $OMNIHOME/etc/EventPump directory. NOTE: If you have already installed a previous Interim Feature for the Event Pump, the directory $OMNIHOME/etc/EventPump should already exist. The files listed under the Changed Files and Installation Files sections (above) will already be in this directory. Any modifications you may have made to these files will be overwritten by this step; if you wish to save your previous modifications, rename the files. In particular, if you have customized the zOSEventSupport_sql.sh file to contain your database name, userid, and password, you do not need to copy the version of this file shipped in 4.2.0.3-TIV-EP-IF0003. Delete or rename this file in the 4.2.0.3-TIV-EP-IF0003 directory. 4. Switch to the $OMNIHOME/etc/EventPump directory. Copy the new and changed rules files into the $OMNIHOME/probes/$ARCH directory by running the zOSEventSupport_rules.sh file. NOTE: The zos_event.rules file shipped with this interim feature is a current copy, which includes all changes from any previous maintenance. The zOSEventSupoport_rules.sh file does not copy it to the $OMNIHOME/probes/$ARCH directory. If you do not have a copy of zos_event.rules file in the $OMNIHME/probes/$ARCH directory, remove the comment in front of the statement which copies this file. If you have modified your existing zos_event.rules file to comment out the include for zos_cics_event.rules, you must uncomment this line to enable the CPSM rules. Base CICs and CPSM rules are defined in the same file, zos_cics_event.rules. 5. Update the Netcool/ONMIbus server database. If not already done, modify the zOSEventSupport_sql.sh file by supplying the correct server database name, userid, and password. Modify the sql file name to zOSEventSupport_cpsm.sql. Then run the bat file. ========================================================================= 2.3 Configuration ========================================================================= After this maintenance is applied, the OMNIbus server and EIF probe must be stopped and restarted. ========================================================================= 3.0 SUPPORT INFORMATION ========================================================================= If you have a problem with your IBM software, you want to resolve it quickly. This section describes options for obtaining support for IBM software products. ========================================================================= 3.1 Using IBM Support Assistant ========================================================================= The IBM Support Assistant is a free, stand-alone application that you can install on any workstation. You can then enhance the application by installing product-specific plug-in modules for the IBM products you use. The IBM Support Assistant saves you time searching product, support, and educational resources. The IBM Support Assistant helps you gather support information when you need to open a problem management record (PMR), which you can then use to track the problem. The product-specific plug-in modules provide you with the following resources: - Support links - Education links - Ability to submit problem management reports For more information, see the IBM Support Assistant Web site at: http://www.ibm.com/software/support/isa If your product does not use IBM Support Assistant, use the links to support topics in your information center. In the navigation frame, check the links for resources listed in the ibm.com and related resource section where you can search the following resources: - Support and assistance (includes search capability of IBM technotes and IBM downloads for interim fixes and workarounds) - Training and certification - IBM developerWorks - IBM Redbooks - General product information If you cannot find the solution to your problem in the information center, search the following internet resources for the latest information that might help you resolve your problem: - Forums and newsgroups - Search engines ========================================================================= 3.2 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: - Go to the IBM Software Support Web site at http://www.ibm.com/software/support - Under Find product support, click "All IBM Software (A-Z). This opens the software product list. - In the software product list, click "IBM Tivoli Event Pump". This opens the "IBM Tivoli Event Pump" support site. - Click the name of a fix to read the description and optionally download the fix. You can also search for a specific fix; for tips on refining your search, click "Search tips". - In the "Find downloads and drivers by product" section, select one software category from the "Category" list. - Select one product from the "Sub-category" list. - Type more search terms in the "Search within results" if you want to refine your search. - Click "Search". - 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.htm ========================================================================= 3.3 Receiving weekly support updates ========================================================================= To receive weekly e-mail notifications about fixes and other software support news, follow these steps: - Go to the IBM Software Support Web site at http://www.ibm.com/software/support. - Click "My support" in the upper right corner of the page. - 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". - Click "Edit profile". - In the "Products" list, select "Software". A second list is displayed. - In the second list, select a product segment, for example, "Systems Management". A third list is displayed. - In the third list, select a product sub-segment, for example, "System Performance". A list of applicable products is displayed. - Select the products for which you want to receive updates, for example, IBM Tivoli Event Pump. - Click Add products. - After selecting all products that are of interest to you, click Subscribe to email on the Edit profile tab. - Select Please send these documents by weekly email. - Update your e-mail address as needed. - In the Documents list, select Software. - Select the types of documents that you want to receive information about. - 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). ========================================================================= 3.4 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: - 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. - 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. - 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. - 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: - 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. 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: - What software versions were you running when the problem occurred? - Do you have logs, traces, and messages that are related to the problem symptoms? IBM Software Support is likely to ask for this information. - Can you re-create the problem? If so, what steps were performed to re-create the problem? - Did you make any changes to the system? For example, did you make changes to the hardware, operating system, networking software, and so on. - 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 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. By 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. ========================================================================= 4.0 NOTICES AND TRADEMARKS ========================================================================= ----------------------- 4.1 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. 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 may contain 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: This information may contain 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 IBMs application programming interfaces. ----------------------- 4.2 Trademarks: ----------------------- IBM, CICS, OMEGAMON, Tivoli, Tivoli Enterprise, z/OS, zSeries, pSeries, AIX, IBMLink, S/390, ibm.com, IBM developerWorks, Passport Advantage, Rational, Lotus, eServer, and IBM Redbooks are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Intel and Pentium are trademarks of Intel Corporation in the United States, other countries, or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft(R) and Windows are registered trademarks of Microsoft Corporation in the United States, other countries, or both. Solaris(TM), Java(TM) 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(R)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. =========================================================================