PJ40979: MULTIPLE ECB RESOURCE MONITORING LIMITS ENHANCEMENT TO ECBRM -
Closed as program error.
See Problem Summary
APAR NUMBER: PJ40979 PRODUCT: z/TPF FUNCTIONAL AREA: SYSTEM TASK DISPATCHER (CPU LOOP) SHIPPED IN PUT: 10 ABSTRACT: Enhancements to the ECB resource monitor. PACKAGE CONTENTS: Source Segments: (C) base/cimr/spriat.cpy (C) base/cp/cce4.cpy (C) base/cp/cecbrm.cpy (C) base/cp/chsz.cpy (C) base/cp/cicr.cpy (C) base/exp/CTAL.exp (C) base/include/tpf/c_syseq.h (C) base/include/tpf/i_idcrlt.h (C) base/include/tpf/sysapi.h (C) base/macro/ecbmc.mac (C) base/macro/idcecbm.mac (C) base/macro/idcrlt.mac (C) base/macro/idsxfc.mac (C) base/macro/syseq.mac (C) base/rt/bkd8.asm (C) base/rt/cdefsforasm.c (C) base/rt/cecbm.c (C) base/rt/cecbma.asm (C) base/rt/cecbmc.c (C) base/rt/cerm.asm Object Only Binaries: None. Configuration Independent Binaries: (C) base/lib/libCDEFSFORASM.so (C) base/load/CDEFSFORASM.so (C) base/load/CECB.so (C) base/load/CERM.so (C) base/obj/cdefsforasm.o (C) base/obj/cecbm.o (C) base/obj/cerm.o Support Files: base/lst/cdefsforasm.lst base/lst/cecbm.lst base/lst/cerm.lst base/lst/CDEFSFORASM.map base/lst/CECB.map base/lst/CERM.map OTHER BINARIES TO BUILD: YES (C) <sys>/load/BKD8.so (C) <sys>/load/CPS0.so (C) <sys>/load/RIAT.so (C) <sys>/obj/bkd8.o (C) <sys>/obj/cciisc.o (C) <sys>/obj/ccnucl.o (C) <sys>/obj/cecbma.o (C) <sys>/obj/cecbmc.o (C) <sys>/obj/riat.o (C) <sys>/stdlib/libCTAL.so (C) <sys>/stdload/CTAL.so (C) os390/bin/bmgl.pds (C) os390/bin/chqi.pds (C) os390/bin/ppcp.pds (C) os390/bin/stc.pds (C) os390/obj/bmgl.o (C) os390/obj/ccmcdc.o (C) os390/obj/chqi.o (C) os390/obj/dgr0.o (C) os390/obj/stcc.o (C) os390/obj/stpp.o (C) <sys>/obj/ccccp1.o (C) <sys>/obj/cccpse.o (C) <sys>/obj/ccctin.o (C) <sys>/obj/ccfadc.o (C) <sys>/obj/ccsonp.o (C) <sys>/obj/ccstor.o (C) <sys>/obj/cctape.o COMMENTS: Enhancements to the ECB resource monitor.
SOLUTION: There are three enhancements that are being provided to the ECB resource monitor. First, support for named limit sets is now available. A named limit set provides the ability to define resource limits that the ECB resource monitor can use that are different from the system default limit set. Users can create and alter multiple limit sets using the ZECBM command. When a limit set is created, a name is associated to the limit set. This name is the LSETNAME. An application ECB can use a limit set by executing the ECBMC macro with the SET option and specifying the LSETNAME. C function tpf_ecbmc_set_lsetname performs the same capability. Use of ECBMC SET,LSETNAME and tpf_ecbmc_set_lsetname does not require RESTR (restricted) authorization. Also, the ability to change the limits in a limit set is done easily using the ZECBM SET command. Second, the users have the ability to select an action based on a resource type. As a result, an action for a specific resource can be different than the system default action when a limit is reached. For example, if the system default action for LEV1 is MSG (send a message), it is possible to set the action for LEV1 to DMPR (dump with return) for resource RELF. Third, a new API is being added to allow users to query the resource counts. In C language this new API is function tpf_ecbmc_query_rct. In assembler this new API is parameter QUERYRCT on the ECBMC macro. COREQS: NO None. MIGRATION CONSIDERATIONS: YES Functional, automation, and operation changes: ECBM0015I is replaced by ECBM0045I. ECBM0016I is replaced by ECBM0046I. ECBM0022I is changed. ECBM0023I is replaced by ECBM0047I. ECBM0026I is replaced by ECBM0048I. ECBM0027E is changed. ECBM0028E is changed. ECBM0029I is changed. ECBM0030I is changed. ECBM0031E is new. ECBM0032E is new. ECBM0033E is new. ECBM0034E is new. ECBM0035E is new. ECBM0036E is new. ECBM0037E is new. ECBM0038E is new. ECBM0039E is new. ECBM0040I is new. ECBM0041I is new. ECBM0042I is new. ECBM0043I is new. ECBM0044I is new. ECBM0045I is new. ECBM0046I is new. ECBM0047I is new. ECBM0048I is new. ECBM0049E is new. ECBM0100E is new. ECBM0101E is new. Application programming interface (API) changes: Macro ECBMC supports the SET parameter with the LSETNAME option. Macro ECBMC supports the QUERYRCT parameter. C function tpf_ecbmc_set_lsetname is provided. C function tpf_ecbmc_query_rct is provided. Database changes: When a limit set name (LSETNAME) is defined, the ECB resource monitor (ecbRM) keypoint values for this LSETNAME are kept in a 4 K pool record. This 4 K pool record is chained from the fixed file record type #IBMM4 ordinal #ECBRM1. Recoup descriptor BKD8 has been updated so that Recoup phase 1 will chain chase the ecbRM keypoint records. Coexistence, migration, and fallback considerations: PJ40979 reorganized the ECB resource monitor (ecbRM) keypoint record. Prior to PJ40979, the ecbRM keypoint record was in fixed file record type #IBMM4 ordinal #ECBRM0. With PJ40979, the ecbRM keypoint record is in fixed file record type #IBMM4 ordinal #ECBRM1. On the first IPL with PJ40979 applied, the contents of the old ecbRM keypoint record is automatically migrated to the new ecbRM keypoint record. If a fallback of PJ40979 is done, the old ecbRM keypoint record will be used. If changes are made to the system default limits before PJ40979 fallback is done, those changes will not be reflected in the old ecbRM keypoint record. BUILD COMMANDS AND INSTRUCTIONS: YES #maketpf commands for linux maketpf -f CDEFSFORASM cdefsforasm.o maketpf -f CTAL cecbma.o cecbmc.o maketpf -f CPS0 cciisc.o ccnucl.o ccccp1.o cccpse.o ccctin.o ccfadc.o ccsonp.o ccstor.o cctape.o maketpf -f RIAT riat.o maketpf -f BKD8 bkd8.o maketpf -f CERM cerm.o maketpf -f CECB cecbm.o maketpf CDEFSFORASM link TPF_VERIFY_LINK_REFS=NO maketpf CTAL link TPF_VERIFY_LINK_REFS=NO maketpf CPS0 link maketpf RIAT link maketpf BKD8 link maketpf CERM link maketpf CECB link maketpf CDEFSFORASM link maketpf CTAL link #maketpf commands for z/OS maketpf -f bmgl bmgl.o maketpf -f chqi chqi.o maketpf -f ppcp ccmcdc.o stpp.o maketpf -f stc dgr0.o stcc.o maketpf bmgl link maketpf chqi link maketpf ppcp link maketpf stc link If you have apache2 installed, you must also run the following maketpf commands: maketpf -f CA2S modules/http/http_core.o maketpf CA2S link UPDATED INFORMATION UNITS: YES z/TPF and z/TPFDF Migration Guide: PUT 2 and Later z/TPF Application Programming z/TPF C/C++ Language Support User's Guide z/TPF General Services z/TPF Messages (Online, SQLCODEs, and errno Values) z/TPF Operations See your IBM representative if you need additional information. DOWNLOAD INSTRUCTIONS: http://www.ibm.com/software/htp/tpf/maint/maintztpf.html APAR URL: http://www.ibm.com/software/htp/tpf/ztpfmaint/put10/PJ40979.htm
Reported component name
Reported component ID
NoSpecatt / Xsystem
Last modified date
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fixed component name
Fixed component ID
Applicable component levels