Skip to: Abstract | Comments | Solution | Migration | Download
APAR NUMBER: PJ31144 PRODUCT: TPF4 FUNCTIONAL AREA: CONTINUOUS DATA COLLECTION (CDC) SHIPPED IN PUT: 21 ABSTRACT: CDC Enhancement to collect and display system traces and utility switches. APAR CONTENTS: FEATURE TYPE STATUS NAME Base CHeader Changed include/c$icdc.h Base Object Changed obj/oco/cdcq40.o Base Object Changed obj/oco/cdcx40.o Base SQL Changed sample/cdc_tables.sql Base C Changed source/rt/base/cdco.c Base C Changed source/rt/base/cdcp.c Base SQLC Changed source/rt/base/cdcq.sqlc Base C Changed source/rt/base/cdcw.c Base SQLC Changed source/rt/base/cdcx.sqlc 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) PJ30465(20) PJ30503(20) PJ30701(20) PJ30589(20) PJ30610(20) PJ30946(20) PJ31004(20) Base Object Changed obj/oco/cdcq40.o PJ27095(12) PJ27775(15) PJ28097(15) PJ29811(19) PJ29925(19) PJ30465(20) PJ30503(20) PJ30701(20) PJ30589(20) PJ31004(20) Base Object Changed obj/oco/cdcx40.o PJ29925(19) PJ30465(20) PJ30503(20) PJ30701(20) PJ30946(20) PJ31004(20) Base SQL Changed sample/cdc_tables.sql PJ30503(20) Base C Changed source/rt/base/cdco.c PJ29925(19) PJ30215(20) PJ30503(20) PJ30589(20) 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) PJ30465(20) PJ30503(20) PJ30701(20) PJ30589(20) PJ30610(20) PJ30946(20) PJ31004(20) PJ31135(20) Base SQLC Changed source/rt/base/cdcq.sqlc PJ27095(12) PJ28097(15) PJ29811(19) PJ29925(19) PJ30465(20) PJ30503(20) PJ30701(20) PJ30589(20) Base C Changed source/rt/base/cdcw.c PJ30589(20) Base SQLC Changed source/rt/base/cdcx.sqlc PJ29925(19) PJ30465(20) PJ30503(20) PJ30701(20) PJ30946(20) COMMENTS: It would be very useful to have TPF system traces and subsystem utility switches included in the CDC display. SOLUTION: TPF system trace information and subsystem utility information have been added to the CDC collector and display. In addition to this, a new option has been added to the ZCDCO command to enable users to delete CDC TPFDF subfiles: ZCDCO RELFC ALG-CYYYYMMDD Where: RELFC specifies that a CDC TPFDF subfile is to be deleted ALG-CYYYYMMDD is the TPFDF algorithm that specifies the subfile to delete, where: C is the CPUID YYYY is the year MM is the month DD is the day This APAR also requires a download of the latest version of the client (1.4.3). It can be found at: http://www.ibm.com/software/htp/tpf/download/tools For detailed information on the changes, please reference the readme file in the CDC client package. DEPENDENCIES SEGMENTS TO BE ASSEMBLED OR COMPILED: cdcs.cpp SEGMENTS TO BE LINK EDITED: cdco40.exe (Shipped in Tar File) cdcp40.exe (Shipped in Tar File) cdcs40.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: SYSTEM_MESSAGES - a new field (unsigned int TRACES) was added. SUBSYSTEM_MESSAGES - a new field (unsigned int UTILITY_SWITCHES) was added. 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: TRACES INTEGER NOT NULL DEFAULT SS_MESSAGES_D - One new column has been added: UTIL_SWITCHES_SS INTEGER 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. Before applying this APAR, make sure to stop the current CDC collection if it is running. 1) Enter ZCDCO DISP to see if a collection is running. 2) If so, enter ZCDCO STOP RDB-<collection name> to stop it. 3) After maintenance is applied, enter ZCDCO START RDB-<collection name> to start up the collection UPDATED INFORMATION UNITS: TPF Messages (Online) TPF Operations See your IBM representative if you need additional information. DOWNLOAD INSTRUCTIONS: http://www.ibm.com/software/htp/tpf/pages/maint.htm -- END APAR PJ31144
Download file(s): Login once to access server, leave window open, then click on link(s) below. Listing Binary Source