Skip to: Abstract | Comments | Solution | Migration | Download
APAR NUMBER: PJ30465 PRODUCT: TPF4 FUNCTIONAL AREA: CONTINUOUS DATA COLLECTION (CDC) SHIPPED IN PUT: 20 ABSTRACT: With APAR PJ29925 applied, running CDC may cause a CTL-04. APAR CONTENTS: FEATURE TYPE STATUS NAME Base CHeader Changed include/c$icdc.h Base CPPHeader Changed include/c$mqdc.h Base Macro Changed macro/icdcc.mac Base C Changed source/rt/base/cdcp.c Base SQLC Changed source/rt/base/cdcq.sqlc Base CPP Changed source/rt/base/cdcs.cpp Base SQLC Changed source/rt/base/cdcx.sqlc Base CPP Changed source/rt/base/cmqcol.cpp Base CPP Changed source/rt/base/cuik.cpp PREREQUISITE APARS: To be applied in order listed. Base CHeader Changed include/c$icdc.h PJ27095(12) PJ28097(15) PJ29925(19) PJ30137(19) PJ30215(20) PJ30233(20) Base CPPHeader Changed include/c$mqdc.h PJ25780(09) PJ27023(12) PJ28435(16) PJ29833(19) PJ29925(19) Base Macro Changed macro/icdcc.mac PJ27095(12) PJ28097(15) PJ29925(19) Base C Changed source/rt/base/cdcp.c PJ27095(12) PJ27775(15) PJ28097(15) PJ29925(19) PJ30137(19) PJ30215(20) PJ30233(20) PJ30253(20) PJ30251(20) Base SQLC Changed source/rt/base/cdcq.sqlc PJ27095(12) PJ28097(15) PJ29811(19) PJ29925(19) Base CPP Changed source/rt/base/cdcs.cpp PJ29925(19) PJ30233(20) Base SQLC Changed source/rt/base/cdcx.sqlc PJ29925(19) Base CPP Changed source/rt/base/cmqcol.cpp PJ25780(09) PJ26156(10) PJ27023(12) PJ27332(13) PJ28435(16) PJ29789(19) PJ29833(19) PJ29925(19) Base CPP Changed source/rt/base/cuik.cpp PJ25780(09) PJ29925(19) COMMENTS: If a TPF system has multiple subsystems defined and more than one of these subsystems has a TPF MQSeries queue manager defined, running continuous data collection (CDC) will cause a CTL-04 dump. SOLUTION: The CDC now takes into account that more than one queue manager can be defined on one TPF system (one per subsystem). This change also requires users to download the latest version (Version 1.3) of the CDC client at http://www.ibm.com/software/htp/tpf/download/tools. The CDC client has new requirements. Refer to the package readme file. DEPENDENCIES SEGMENTS TO BE ASSEMBLED OR COMPILED: cdcr.asm SEGMENTS TO BE LINK EDITED: cdco40.exe (Shipped in Tar File) cdcp40.exe (Shipped in Tar File) cmqs40.exe (Shipped in Tar File) cuik40.exe (Shipped in Tar File) COREQS: None. MIGRATION CONSIDERATIONS: Several data structures and DB2 table definitions have been changed. If any programs have been written to process CDC data, the following structures have been changed: MQCDETAIL MQQDETAIL MQSUMMARY Refer to c$icdc.h for further details. If TPFAR is used to store the CDC data, the following tables have been changed: SYSTEM_MESSAGES_S - A new column has been added: TIME_DIFF_MS INTEGER NOT NULL DEFAULT. This column is meant to replace TIME_DIFF_SECS. Although TIME_DIFF_SECS implies that the time was being stored in seconds, it was actually stored as milliseconds. MQSUMMARY_S - One new column has been added: SS_NAME CHARACTER(4) NOT NULL DEFAULT MQQDETAIL_D - Two new columns were added: SS_NAME CHARACTER(4) NOT NULL DEFAULT QUEUEMGRNAME CHARACTER(48) NOT NULL DEFAULT MQCDETAIL_D - Two new columns were added: SS_NAME CHARACTER(4) NOT NULL DEFAULT QUEUEMGRNAME CHARACTER(48) NOT NULL DEFAULT To make these TPFAR changes take effect, users can do either of the following: (a) Create a new database and let CDC create the new tables. (b) Use a Java class that has been provided with the CDC client package. This class will do the following: 1. Add all the new columns to the appropriate tables. 2. For the SYSTEM_MESSAGES_S table, it will also copy the values from the TIME_DIFF_SECS column into TIME_DIFF_MS. From the CDC install directory, use the following command: java -cp .\dbjava.zip;.\sql.zip;.\tpf_cdc.jar com.ibm.tpf.cdc.CDCDB2TableDefUpdates <parameters> Where <parameters> is as follows: -db DATABASENAME Name of the database to connect with. -us USER Valid user ID for the database server. -pw PASSWORD Authentication for the specified user. -h DB HOST DB host name or IP address. -p PORT TCP/IP database port number. Any SQL programs that used to query the CDC tables will need to be updated. The CDC client has new requirements. Refer to the download readme file for more details. UPDATED INFORMATION UNITS: TPF System Performance and Measurement Reference See your IBM representative if you need additional information. DOWNLOAD INSTRUCTIONS: http://www.ibm.com/software/htp/tpf/pages/maint.htm -- END APAR PJ30465
Download file(s): Login once to access server, leave window open, then click on link(s) below.Source Listing Binary