Skip to: Abstract | Comments | Solution | Migration | Download
APAR NUMBER: PJ31582 PRODUCT: z/TPF FUNCTIONAL AREA: CONTINUOUS DATA COLLECTION (CDC) SHIPPED IN PUT: 4 ABSTRACT: CDC Enhancement to collect and display system traces and utility switches for z/TPF. PACKAGE CONTENTS: Source Segments: (C) base/include/tpf/c_icdc.h (C) base/rt/cdco.c (C) base/rt/cdcp.c (C) base/rt/cdcq.c (C) base/rt/cdcq.sqc (C) base/rt/cdcw.c (C) base/rt/cdcx.c (C) base/rt/cdcx.sqc (C) base/samples/ztpf_cdc_tables.sql Object Only Binaries: None. Configuration Independent Binaries: (C) base/load/CDCO.so (C) base/load/CDCP.so (C) base/obj/cdco.o (C) base/obj/cdcp.o (C) base/obj/cdcq.o (C) base/obj/cdcw.o (C) base/obj/cdcx.o Support Files: base/lst/cdco.lst base/lst/cdcp.lst base/lst/cdcq.lst base/lst/cdcw.lst base/lst/cdcx.lst base/lst/CDCO.map base/lst/CDCP.map OTHER BINARIES TO BUILD: None. PREREQUISITE APARS IN APPLICATION ORDER: base/include/tpf/c_icdc.h PJ30403(1) PJ30609(2) PJ30742(2) PJ30944(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31466(3) PJ31437(3) base/rt/cdco.c PJ30609(2) PJ30979(2) base/rt/cdcp.c PJ30403(1) PJ30419(1) PJ30609(2) PJ30742(2) PJ30944(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) base/rt/cdcq.c PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) base/rt/cdcq.sqc PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) base/rt/cdcw.c PJ30609(2) PJ31332(3) base/rt/cdcx.c PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31466(3) PJ31437(3) PJ31549(4) base/rt/cdcx.sqc PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31466(3) PJ31437(3) PJ31549(4) base/samples/ztpf_cdc_tables.sql PJ30609(2) PJ30979(2) PJ30885(2) PJ31530(3) PJ31437(3) PJ31549(4) base/load/CDCO.so PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) base/load/CDCP.so PJ30403(1) PJ30419(1) PJ30609(2) PJ30742(2) PJ30944(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) base/obj/cdco.o PJ30609(2) PJ30979(2) base/obj/cdcp.o PJ30403(1) PJ30419(1) PJ30609(2) PJ30742(2) PJ30944(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) base/obj/cdcq.o PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) base/obj/cdcw.o PJ30609(2) PJ31332(3) base/obj/cdcx.o PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31466(3) PJ31437(3) PJ31549(4) COMMENTS: It would be very useful to have z/TPF system traces and subsystem utility switches included in the CDC display. SOLUTION: z/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 z/TPFDF subfiles: ZCDCO RELFC ALG-CYYYYMMDD Where: RELFC specifies that a CDC z/TPFDF subfile is to be deleted ALG-CYYYYMMDD is the z/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 version 1.4.3 or later of the client. It can be found at: http://www.ibm.com/software/htp/tpf/download/tools.htm For detailed information on the changes, please reference the readme file in the CDC client package. COREQS: None. MIGRATION CONSIDERATIONS: Coexistence, migration, and fallback 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 - One 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 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) Enter the following SQL commands while connected directly to your RDBMS to add the necessary columns to the existing tables: ALTER TABLE TPFCDC.SYSTEM_MESSAGES_S ADD COLUMN TRACES INTEGER NOT NULL DEFAULT ALTER TABLE TPFCDC.SS_MESSAGES_D ADD COLUMN UTIL_SWITCHES_SS INTEGER NOT NULL DEFAULT Any SQL programs that used to query the CDC tables will need to be updated. 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 BUILD COMMANDS AND INSTRUCTIONS: #maketpf commands for linux maketpf -f CDCP cdcp.o cdcq.o cdcw.o cdcx.o maketpf -f CDCO cdco.o cdcq.o cdcw.o maketpf CDCP link maketpf CDCO link UPDATED INFORMATION UNITS: z/TPF Messages (Online, SQLCODEs, and errno Values) z/TPF Operations z/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 APAR URL: http://www.ibm.com/software/htp/tpf/ztpfmaint/put4/PJ31582.htm APAR Package