PJ40979: MULTIPLE ECB RESOURCE MONITORING LIMITS ENHANCEMENT TO ECBRM -

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

APAR status

  • Closed as program error.

Error description

  • See Problem Summary
    

Local fix

  • na
    

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.
    

Problem conclusion

  • 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
    

Temporary fix

Comments

APAR Information

  • APAR number

    PJ40979

  • Reported component name

    Z/TPF

  • Reported component ID

    5748T1501

  • Reported release

    110

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-02-07

  • Closed date

    2013-06-14

  • Last modified date

    2013-06-14

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    Z/TPF

  • Fixed component ID

    5748T1501

Applicable component levels

  • R110 PSY

       UP



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

TPF
z/TPF

Software version:

110

Reference #:

PJ40979

Modified date:

2013-06-14

Translate my page

Machine Translation

Content navigation