A fix is available
APAR status
Closed as program error.
Error description
The problem - DB2, starting from V9, has db2consv.lvl level file in the ${HOME}/sqllib/cfg/ (V9 instance owner), and the installation process does not look for that file. . Receiving the error when configuring PE: Running the /opt/IBM/db2peage/V2.2.1/bin/db2peage-config command. On a DB2 V9 Instance on the same machine. . The error message is: Now listing all defined hosts for the instance db2inst9: ================================================================ Startup script for PE Agent ====== Mapping DB2 settings to your DB2 environment. The DB2 Edition you are using is not supported by Performance Expert. OK: Execution of the configuration step has ended. ERROR: return code = 1. . db2inst9@rdb2cs03:/home/db2inst9/logfiles> db2level DB21085I Instance "db2inst9" uses "64" bits and DB2 code release "SQL09013" with level identifier "01040107". Informational tokens are "DB2 v9.1.0.3", "s070719", "U811590", and Fix Pack "3". Product is installed at "/opt/IBM/db2/V9.1_01". This is "DB2 Connect Server" V9 fixpak 3. . Receiving the error when installing PE Agent: Initializing InstallShield Wizard........ Launching InstallShield Wizard........ ---------------------------------------------------------------- IBM DB2 Performance Expert Agent V2 Setup Welcome to the InstallShield Wizard for IBM DB2 Performance Expert Agent V2 The InstallShield Wizard will install IBM DB2 Performance Expert Agent V2 on your computer. To continue, choose Next. IBM DB2 Performance Expert Agent V2 IBM http://www.ibm.com Press 1 for Next, 3 to Cancel or 5 to Redisplay [1] 1 ---------------------------------------------------------------- IBM DB2 Performance Expert Agent V2 Setup The DB2 edition "consv" that you use is not supported. ================================================================
Local fix
Configuration Workaround: As a workaround - you can edit e2e file in the following way: search for ${CMD_ECHO} "The DB2 Edition you are using is not supported by Performance Expert." remove the "exit 1" command after the found line keep the original e2e file as e2e_ori . Installation workaround: Find the instance home folder, i.e. ${HOME}/sqllib/cfg/ and make a copy of db2consv.lvl to db2conee.lvl. Make the same chmod for db2conee.lvl as they are for db2consv.lvl If this workaround does not work, make the same change in the global db2 folder, like in /opt/IBM/db2/V9.1_FP3/cfg/ for example. . This solution will be made available for z/OS customers via APAR PK57221. The multiplatform solution will be included in the next v2.2 fixpack.
Problem summary
**************************************************************** * USERS AFFECTED: OMEGAMON XE for DB2 PE/DB2PM * * users of component: * * - Performance Expert Agent for * * DB2 Connect Monitoring * **************************************************************** * PROBLEM DESCRIPTION: V2 CONFIG/INSTALL DB2 V9 INSTANCE * * AGENT RESULTS ERROR: * * RETURNCODE 1. DB2 EDITION YOU ARE * * USING IS NOT SUPPORTED BY PE * * * * Receiving the error when installing * * PE Agent: * * Initializing InstallShield Wizard... * * Launching InstallShield Wizard...... * * ------------------------------------ * * IBM DB2 Performance Expert Agent V2 * * Setup * * Welcome to the InstallShield Wizard * * for IBM DB2 Performance * * Expert Agent V2 * * The InstallShield Wizard will * * install IBM DB2 Performance Expert * * Agent V2 on your computer. * * To continue, choose Next. * * IBM DB2 Performance Expert Agent V2 * * IBM * * http://www.ibm.com * * Press 1 for Next, 3 to Cancel or 5 * * to Redisplay ¢1! 1 * * ------------------------------------ * * IBM DB2 Performance Expert Agent V2 * * Setup * * The DB2 edition "consv" that you use * * is not supported. * **************************************************************** * RECOMMENDATION: Apply this PTF * **************************************************************** PROBLEM SUMMARY: CONFIGURING DB2 V9 INSTANCE AGENT RESULTS ERROR: RETURNCODE 1. DB2 EDITION YOU ARE USING IS NOT SUPPORTED BY PERFORMANCE EXPERT THIS HAPPENS AFTER THE INSTALLATION OF THE AGENT ON THE WORKSTATION, WHERE ONLY "DB2 CONNECT SERVER EDITION" IS INSTALLED. PROBLEM CONCLUSION: CONFIGURING DB2 V9 INSTANCE AGENT RESULTS ERROR: RETURNCODE 1. DB2 EDITION YOU ARE USING IS NOT SUPPORTED BY PERFORMANCE EXPERT
Problem conclusion
CONFIGURING DB2 V9 INSTANCE AGENT RESULTS ERROR: RETURNCODE 1. DB2 EDITION YOU ARE USING IS NOT SUPPORTED BY PERFORMANCE EXPERT KEYWORDS : THE DB2 EDITION YOU ARE USING IS NOT SUPPORTED BY PERFORMANCE EXPERT. THE DB2 EDITION "CONSV" THAT YOU USE IS NOT SUPPORTED.
Temporary fix
Comments
APAR Information
APAR number
PK60255
Reported component name
OM XE DB2PE/PM
Reported component ID
5655OPE00
Reported release
410
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2008-01-31
Closed date
2008-02-01
Last modified date
2017-02-04
APAR is sysrouted FROM one or more of the following:
PK59138
APAR is sysrouted TO one or more of the following:
UK33414 UK33415 PK60994
Modules/Macros
DGOAGZLI FPEKAGL3 FPEKAGUX FPEKL331 FPEKL364
Fix information
Fixed component name
OM XE DB2PE/PM
Fixed component ID
5655OPE00
Applicable component levels
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZJXP","label":"DB2 Tools for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"410"}]
Document Information
Modified date:
30 March 2021