Skip to: Abstract | Comments | Solution | Migration | Download
APAR NUMBER: PJ31435 PRODUCT: z/TPF FUNCTIONAL AREA: CONTINUOUS DATA COLLECTION (CDC) SHIPPED IN PUT: 4 ABSTRACT: Modification of CDC to collect each type of data (metric) at an independent and variable collection rate. PACKAGE CONTENTS: Source Segments: (C) base/include/tpf/c_icdc.h (C) base/include/tpf/c_irc0df.h (C) base/macro/icdcc.mac (N) base/rt/cdcdad.asm (N) base/rt/cdcdap.asm (N) base/rt/cdcdst.asm (N) base/rt/cdcist.asm (N) base/rt/cdclod.asm (N) base/rt/cdcmpf.asm (N) base/rt/cdcmqc.asm (N) base/rt/cdcmqq.asm (N) base/rt/cdcmqs.asm (C) base/rt/cdco.c (C) base/rt/cdco.mak (C) base/rt/cdcp.c (C) base/rt/cdcp.mak (C) base/rt/cdcq.c (C) base/rt/cdcq.sqc (O) base/rt/cdcr.asm (C) base/rt/cdcs.cpp (N) base/rt/cdcsta.asm (N) base/rt/cdcsub.asm (N) base/rt/cdcsyb.asm (N) base/rt/cdcsyl.asm (N) base/rt/cdcsym.asm (C) base/rt/cdct.c (C) base/rt/cdct.mak (N) base/rt/cdctap.asm (N) base/rt/cdctcp.asm (N) base/rt/cdcvfa.asm (C) base/rt/cdcw.c (C) base/rt/cdcx.c (C) base/rt/cdcx.sqc (C) base/rt/cdefsforasm.c Object Only Binaries: None. Configuration Independent Binaries: (C) base/lib/libCDEFSFORASM.so (C) base/load/CDCO.so (C) base/load/CDCP.so (C) base/load/CDCS.so (C) base/load/CDCT.so (C) base/load/CDEFSFORASM.so (N) base/obj/cdcdad.o (N) base/obj/cdcdap.o (N) base/obj/cdcdst.o (N) base/obj/cdcist.o (N) base/obj/cdclod.o (N) base/obj/cdcmpf.o (N) base/obj/cdcmqc.o (N) base/obj/cdcmqq.o (N) base/obj/cdcmqs.o (C) base/obj/cdco.o (C) base/obj/cdcp.o (C) base/obj/cdcq.o (C) base/obj/cdcs.o (N) base/obj/cdcsta.o (N) base/obj/cdcsub.o (N) base/obj/cdcsyb.o (N) base/obj/cdcsyl.o (N) base/obj/cdcsym.o (C) base/obj/cdct.o (N) base/obj/cdctap.o (N) base/obj/cdctcp.o (N) base/obj/cdcvfa.o (C) base/obj/cdcw.o (C) base/obj/cdcx.o (C) base/obj/cdefsforasm.o Support Files: base/lst/cdcdad.lst base/lst/cdcdap.lst base/lst/cdcdst.lst base/lst/cdcist.lst base/lst/cdclod.lst base/lst/cdcmpf.lst base/lst/cdcmqc.lst base/lst/cdcmqq.lst base/lst/cdcmqs.lst base/lst/cdco.lst base/lst/cdcp.lst base/lst/cdcq.lst base/lst/cdcs.lst base/lst/cdcsta.lst base/lst/cdcsub.lst base/lst/cdcsyb.lst base/lst/cdcsyl.lst base/lst/cdcsym.lst base/lst/cdct.lst base/lst/cdctap.lst base/lst/cdctcp.lst base/lst/cdcvfa.lst base/lst/cdcw.lst base/lst/cdcx.lst base/lst/cdefsforasm.lst base/lst/CDCO.map base/lst/CDCP.map base/lst/CDCS.map base/lst/CDCT.map base/lst/CDEFSFORASM.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) PJ31582(4) base/include/tpf/c_irc0df.h PJ30742(2) PJ30944(2) base/macro/icdcc.mac PJ30609(2) PJ31466(3) base/rt/cdco.c PJ30609(2) PJ30979(2) PJ31582(4) base/rt/cdco.mak PJ30609(2) PJ30979(2) PJ31332(3) 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) PJ31582(4) PJ31680(4) base/rt/cdcp.mak PJ30609(2) PJ30979(2) PJ31332(3) base/rt/cdcq.c PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) PJ31582(4) base/rt/cdcq.sqc PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) PJ31582(4) base/rt/cdcr.asm PJ30609(2) PJ31329(3) PJ31466(3) PJ31739(4) base/rt/cdcs.cpp PJ30403(1) PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31466(3) PJ31437(3) base/rt/cdcw.c PJ30609(2) PJ31332(3) PJ31582(4) base/rt/cdcx.c PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31466(3) PJ31437(3) PJ31549(4) PJ31582(4) base/rt/cdcx.sqc PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31466(3) PJ31437(3) PJ31549(4) PJ31582(4) base/rt/cdefsforasm.c PJ30423(1) PJ30686(2) PJ29149(2) PJ30741(2) PJ30910(2) PJ30885(2) PJ31328(3) PJ31266(3) PJ31270(3) PJ31076(3) PJ31357(4) base/lib/libCDEFSFORASM.so PJ30423(1) PJ30686(2) PJ29149(2) PJ30741(2) PJ30910(2) PJ30885(2) PJ31328(3) PJ31266(3) PJ31270(3) PJ31076(3) PJ31357(4) base/load/CDCO.so PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) PJ31582(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) PJ31582(4) PJ31680(4) PJ31739(4) base/load/CDCS.so PJ30403(1) PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31466(3) PJ31437(3) base/load/CDEFSFORASM.so PJ30423(1) PJ30686(2) PJ29149(2) PJ30741(2) PJ30910(2) PJ30885(2) PJ31328(3) PJ31266(3) PJ31270(3) PJ31076(3) PJ31357(4) base/obj/cdco.o PJ30609(2) PJ30979(2) PJ31582(4) 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) PJ31582(4) PJ31680(4) base/obj/cdcq.o PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31332(3) PJ31466(3) PJ31437(3) PJ31549(4) PJ31582(4) base/obj/cdcs.o PJ30403(1) PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31466(3) PJ31437(3) base/obj/cdcw.o PJ30609(2) PJ31332(3) PJ31582(4) base/obj/cdcx.o PJ30609(2) PJ30742(2) PJ30979(2) PJ30885(2) PJ31329(3) PJ31466(3) PJ31437(3) PJ31549(4) PJ31582(4) base/obj/cdefsforasm.o PJ30423(1) PJ30686(2) PJ29149(2) PJ30741(2) PJ30910(2) PJ30885(2) PJ31328(3) PJ31266(3) PJ31270(3) PJ31076(3) PJ31357(4) COMMENTS: Variable collection rates improves the usability of CDC so that you can collect different types of data at different frequencies. Previously, CDC collected and reported all data at the same frequency. For example, if you set the CDC frequency to 5 seconds, all data was collected and reported every 5 seconds. With this support, you can use the ZCDCO command to set different frequencies for different types of data. For example, if you are collecting data for every DASD module, you might want to have that data collected and reported less frequently (or not at all by setting its frequnecy to zero) because of the quantity of data. The only type of data which is guaranteed to be in each collection on the MQ queue (and selected historical databases) is the static system information data (index 0x94). The user is not allowed to control the frequency setting of static system information data. All other types of CDC data are subject to individual frequency settings and are included on the MQ queue (and selected historical databases) accordingly. To improve performance of CDC, the CDC control files (/etc/TPFCDC/TDS and /etc/TPFCDC/TDS2) are replaced with a single format-2 global record named ICDCCNTL. After applying this APAR, you must define this format-2 global record to the complex and initialize it for each processor that will run CDC. This APAR has changed the format of the ZCDCO command significantly as described in the z/TPF Operations Guide. This APAR requires CDC Client version 1.4.7 or higher. SOLUTION: This APAR significantly modifies the CDC source code to support the function described above. Not only is support for variable collection rates added but an effort was made to make the source more modular in its design. COREQS: None. MIGRATION CONSIDERATIONS: Functional, automation, and operation changes: Changed Command: ZCDCO New Messages: CDCO0041I CDCO0042E CDCO0043E CDCO0044I CDCO0045E CDCO0046E CDCO0047I CDCO0048E CDCO0049I CDCO0050I CDCO0051E CDCO0052E CDCO0053I CDCO0054I CDCO0055E CDCO0057E CDCO0058E CDCO0059E CDCO0060E CDCO0061E CDCO0062E CDCO0063E CDCO0064E CDCO0065E CDCO0066E CDCO0067E CDCO0068E CDCO0069E CDCO0070W CDCO0071I CDCO0072E CDCO0073E CDCO0074E CDCO0075E CDCO0076I Changed Messages: CDCO0001I CDCO0008E CDCO00013W CDCO00040E Obsolete Messages: CDCO0002I CDCO0003I CDCO0004W CDCO0005W CDCO0007I CDCO0009E CDCO00010E CDCO00011W CDCO00012I CDCO00014E CDCO00015E CDCO00016I CDCO00017E CDCO00018E CDCO00019I CDCO00020I CDCO00021E CDCO00023W CDCO00030I CDCO00031E Application programming interface (API) changes: None. User exit changes: None. System generation process (SIP) changes: None. Configuration changes: None. Communications changes: None. Host system considerations: None. Build and load process changes: None. IPL and state changes: None. Installation validation: See Getting Started with CDC in the System Performance and Measurement Reference to validate CDC with this APAR applied. Database changes: None. Feature changes: None. Performance or tuning changes: None. Coexistence, migration, and fallback considerations: None. BUILD COMMANDS AND INSTRUCTIONS: #maketpf commands for linux maketpf -f CDEFSFORASM cdefsforasm.o maketpf -f CDCO cdco.o cdcq.o cdcw.o maketpf -f CDCP cdcdad.o cdcdap.o cdcdst.o cdcist.o cdclod.o cdcmpf.o cdcmqc.o cdcmqq.o cdcmqs.o cdcp.o cdcq.o cdcsta.o cdcsub.o cdcsyb.o cdcsyl.o cdcsym.o cdctap.o cdctcp.o cdcvfa.o cdcw.o cdcx.o maketpf -f CDCT cdct.o maketpf -f CDCS cdcs.o TPF_VERIFY_LINK_REFS=NO maketpf CDEFSFORASM link maketpf CDCO link maketpf CDCP link maketpf CDCT link maketpf CDCS link maketpf CDCS link maketpf CDEFSFORASM link UPDATED INFORMATION UNITS: z/TPF and z/TPFDF Migration Guide: PUT 2 and Later z/TPF Messages (Online, SQLCODEs, and errno Values) z/TPF Operations z/TPF System Performance and Measurement Reference z/TPFDF Glossary 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/PJ31435.htm APAR Package