IBM Support

PJ46401: Allow recoup to use fenced I-streams

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 new function.

Error description

  • See Problem Summary.
    

Local fix

  • NA
    

Problem summary

  • APAR NUMBER:  PJ46401
    PRODUCT:  z/TPF
    FUNCTIONAL AREA:  INTER-ISTREAM COMMUNICATION
    SHIPPED IN YEAR:  2021
    
    ABSTRACT:
    Allow recoup to use fenced I-streams
    
    PACKAGE CONTENTS:
    Source Segments:
    (C) base/cntl/tpf_app_base.cntl
    (C) base/cp/cce4.cpy
    (C) base/cp/cce7.cpy
    (C) base/cp/ccnucl.asm
    (C) base/cp/cicr.cpy
    (C) base/cp/cidp.cpy
    (C) base/cp/cjio.cpy
    (C) base/cp/clhl.cpy
    (C) base/cp/cpsl.cpy
    (C) base/cp/ct01.cpy
    (C) base/cp/ctme.cpy
    (C) base/cp/dbac.cpy
    (C) base/exp/CTAL.exp
    (C) base/include/tpf/cdcp_collect_lib.h
    (C) base/include/tpf/c_cinfc.h
    (C) base/include/tpf/c_dctist.h
    (N) base/include/tpf/c_iops.h
    (N) base/include/tpf/i_gshared.h
    (C) base/include/tpf/tpfapi.h
    (C) base/macro/cinfc.mac
    (C) base/macro/cz1se.mac
    (C) base/macro/dctist.mac
    (C) base/macro/dctpfx.mac
    (C) base/macro/dltec.mac
    (C) base/macro/icdcc.mac
    (N) base/macro/ificq.mac
    (N) base/macro/igshared.mac
    (N) base/macro/iiops.mac
    (C) base/rt/bam0.asm
    (C) base/rt/bam0.mak
    (C) base/rt/bcp6.asm
    (N) base/rt/bcp6.mak
    (C) base/rt/bkb0.asm
    (C) base/rt/bkb0.mak
    (C) base/rt/bkc1.asm
    (N) base/rt/bkc1.mak
    (C) base/rt/bof4.asm
    (C) base/rt/bpm1.asm
    (C) base/rt/bpm1.mak
    (C) base/rt/brv0.asm
    (N) base/rt/brv0.mak
    (C) base/rt/brv2.asm
    (C) base/rt/brv2.mak
    (C) base/rt/bssa_phase1_util.asm
    (C) base/rt/bssc.asm
    (C) base/rt/cdcist.asm
    (C) base/rt/cdcp_add.cpp
    (C) base/rt/cdefsforasm.c
    (N) base/rt/ciop.c
    (C) base/rt/ctal.mak
    (C) base/rt/cvof.c
    (C) base/rt/cvoff1.asm
    (C) base/rt/cyma.asm
    (C) base/tpf-fdes/tpf_dctist.lib.dfdl.xsd
    
    Object Only Binaries:
    (C) base/oco/lib/libcpoco.a
    
    BINARIES TO BUILD: YES
    Configuration Independent Binaries:
    (C) base/lib/libBSSA.so
    (C) base/lib/libcdcp_collect_lib.a
    (C) base/lib/libCDEFSFORASM.so
    (C) base/load/BKC1.so
    (C) base/load/BPM1.so
    (C) base/load/BSSA.so
    (C) base/load/BSSC.so
    (C) base/load/CDCP.so
    (C) base/load/CDEFSFORASM.so
    (C) base/load/CRRT.so
    (C) base/load/CVOF.so
    (C) base/load/CYMA.so
    (C) base/obj/bkc1.o
    (C) base/obj/bpm1.o
    (C) base/obj/bssa_phase1_util.o
    (C) base/obj/bssc.o
    (C) base/obj/cdcist.o
    (C) base/obj/cdcp_add.o
    (C) base/obj/cdefsforasm.o
    (C) base/obj/cvof.o
    (C) base/obj/cvoff1.o
    (C) base/obj/cyma.o
    
    Configuration Dependent Binaries:
    (C) <sys>/load/BAM0.so
    (C) <sys>/load/BCP6.so
    (C) <sys>/load/BKB0.so
    (C) <sys>/load/BOF4.so
    (C) <sys>/load/BRV0.so
    (C) <sys>/load/BRV2.so
    (C) <sys>/load/CPS0.so
    (C) <sys>/obj/bam0.o
    (C) <sys>/obj/bcp6.o
    (C) <sys>/obj/bkb0.o
    (C) <sys>/obj/bof4.o
    (C) <sys>/obj/brv0.o
    (C) <sys>/obj/brv2.o
    (C) <sys>/obj/ccclhr.o
    (C) <sys>/obj/cccpse.o
    (C) <sys>/obj/ccctin.o
    (C) <sys>/obj/ccdbaf.o
    (C) <sys>/obj/cciisc.o
    (C) <sys>/obj/ccnucl.o
    (C) <sys>/obj/ccsons.o
    (N) <sys>/obj/ciop.o
    (C) <sys>/stdlib/libCTAL.so
    (C) <sys>/stdload/CTAL.so
    (C) os390/bin/amx1.pds
    (C) os390/bin/ppcp.pds
    (C) os390/obj/amx1.o
    (C) os390/obj/ccmcdc.o
    (C) os390/obj/stpp.o
    (C) <sys>/load/IPAT.so
    (C) <sys>/load/UCST.so
    (C) <sys>/obj/ucst.o
    (C) <sys>/obj/ipat.o
    
    
    COMMENTS:
    Allow recoup to use fenced I-streams
    

Problem conclusion

  • SOLUTION:
    Allow recoup to use fenced I-streams.
    
    1.) When the recoup utility is running as a low-priority
    utility and fenced I-streams exist, the following conditions
    occur:
    - The z/TPF system tries to schedule recoup ECBs to the highest
    four fenced I-streams.
    - If a customer has less than 4 fenced I-streams, all fenced
    I-streams will be used.
    - If low-priority utility utilization for a fenced I-stream
    becomes higher than 10% then all subclasses of DASD I/O
    interruptions are enabled.
    - If low-priority utility utilization for a fenced I-stream
    becomes less than 10% then all subclasses of DASD I/O
    interruptions are disabled.
    - If the recoup fenced I-streams reach 100% busy and more
    recoup child ECBs are created, new recoup child ECBs are
    processed on in-use I-streams.
    
    2.) New commands ZSONS ALTER IOPS and ZSONS DISPLAY IOPS are
    provided for you to set and display the maximum number of
    physical DASD IOs that can be issued before users of the
    tpf_dasd_iops_limit function should throttle themselves by
    giving up control.
    
    3.) The ZSTAT command was updated to have the new parameter
    IOPS, which displays the current DASD I/Os per second for each
    device type in each MDBF subsystem.
    
    4.) New API tpf_dasd_iops_limit was created. This API can be
    called by utilities and other programs that want to throttle
    themselves based upon the current IOPs in the MDBF subsystem
    and returns the following values:
    - A red/green light indicator based upon the current IOPs vs.
    the maximum number of physical DASD I/Os set by the ZSONS ALTER
    IOPS command.
    - The amount of time (in microseconds) that this program should
    wait before checking IOPs again.
    
    5.) The U and GPU parameters on the ZSTAT command were updated.
    If the low-priority utility utilization of a fenced I-stream is
    greater than 1%, the system will identify the I-stream as a
    fenced I-stream in use by the system (SF1).
    
    6.) Continuous Data Collection (CDC) was updated to collect
    I-stream status information. This information is the same as
    the status (S) column in the ZSTAT U or ZSTAT GPU command
    output.
    
    7.) Recoup segment base/rt/bssa_phase1_util.asm was updated to
    add a new function tpf_recoup_SystemActivityCheck() which
    interfaces with the function tpf_dasd_iops_limit(). This
    provides a centralized point for multiple recoup segments to
    check the ability to proceed in conjunction with the existing
    LODIC logic. Several .mak files were created or updated to call
    the library segment BSSA.
    
    The following additional enhancements and fixes were made:
    
    1.) Copy member cidp.cpy of CSECT CCCPSE was updated to change
    some parameters of the IBMRSTRT manual dump to try and lessen
    the size of the manual dump. Duplicated keyword IMFST was also
    removed. Additional dump items were added to the 00C115 system
    error dump.
    
    COREQS: YES
    Co-requisite z/TPFDF APAR PH35015 must be installed after z/TPF
    APAR PJ46401. Both APARs must be installed before the new
    functionality can be used in z/TPFDF utilities.
    
    MIGRATION CONSIDERATIONS: YES
    Functional, automation, and operation changes:
    New Commands
    ZSONS DISPLAY IOPS
    ZSONS ALTER IOPS
    
    Changed Commands
    ZSTAT
    
    New Messages
    STAT0062I
    SONS0065E
    SONS0066I
    SONS0067E
    
    
    New System Errors
    06405E
    06405F
    
    
    Application programming interface (API) changes:
    New APIs
    void tpf_dasd_iops_limit(struct iops_limit *iops_ptr);
    
    
    Hardware, software, and configuration changes:
    The IGSHARED format-2 global record must be defined and
    initialized:
    
    ZGLBL GLOBAL DEFINE IGSHARED LOC-64BIT PROT-YES PROC-NO SSU-NO
    IS-NO KEY-NO SYNC-YES LOAD-RES
    ZGLBL GLOBAL INIT IGSHARED SOURCE-ZERO SIZE-F80 PROC-ALL
    
    
    
    
    BUILD COMMANDS AND INSTRUCTIONS: YES
    #maketpf commands for linux
    maketpf -f CDEFSFORASM cdefsforasm.o
    maketpf -f CTAL ciop.o
    maketpf -f CPS0 ccclhr.o cccpse.o ccctin.o ccdbaf.o cciisc.o
    ccnucl.o ccsons.o
    maketpf -f cdcp_collect_lib cdcist.o cdcp_add.o
    maketpf -f BKB0 bkb0.o
    maketpf -f BSSA bssa_phase1_util.o
    maketpf -f BCP6 bcp6.o
    maketpf -f BKC1 bkc1.o
    maketpf -f BOF4 bof4.o
    maketpf -f BRV0 brv0.o
    maketpf -f BRV2 brv2.o
    maketpf -f CVOF cvof.o cvoff1.o
    maketpf -f CYMA cyma.o
    maketpf -f BPM1 bpm1.o
    maketpf -f BAM0 bam0.o
    maketpf -f BSSC bssc.o
    maketpf CDEFSFORASM link TPF_VERIFY_LINK_REFS=NO
    maketpf -f UCST TPF_VERIFY_LINK_REFS=NO
    maketpf CTAL link TPF_VERIFY_LINK_REFS=NO
    maketpf CPS0 link
    maketpf -f IPAT
    maketpf cdcp_collect_lib link
    maketpf BKB0 link TPF_VERIFY_LINK_REFS=NO
    maketpf BSSA link TPF_VERIFY_LINK_REFS=NO
    maketpf BCP6 link
    maketpf BKC1 link TPF_VERIFY_LINK_REFS=NO
    maketpf BOF4 link
    maketpf BRV0 link TPF_VERIFY_LINK_REFS=NO
    maketpf BRV2 link TPF_VERIFY_LINK_REFS=NO
    maketpf CVOF link
    maketpf CYMA link
    maketpf BPM1 link TPF_VERIFY_LINK_REFS=NO
    maketpf BAM0 link TPF_VERIFY_LINK_REFS=NO
    maketpf BSSC link TPF_VERIFY_LINK_REFS=NO
    maketpf CRRT link
    maketpf CDCP link TPF_VERIFY_LINK_REFS=NO
    maketpf CDEFSFORASM link
    maketpf UCST link
    maketpf CTAL link
    maketpf BKB0 link
    maketpf BSSA link
    maketpf BKC1 link
    maketpf BRV0 link
    maketpf BRV2 link
    maketpf BPM1 link
    maketpf BAM0 link
    maketpf BSSC link
    maketpf CDCP link
    #maketpf commands for z/OS
    maketpf -f amx1 amx1.o
    maketpf -f ppcp ccmcdc.o stpp.o
    maketpf amx1 link
    maketpf ppcp link
    
    UPDATED INFORMATION UNITS: YES
    z/TPF and z/TPFDF Migration Guide: PUT 2 and Later
    z/TPF and z/TPFDF System Installation and Support Reference
    z/TPF C/C++ Language Support User's Guide
    z/TPF Main Supervisor Reference
    z/TPF Messages (Online, SQLCODEs, and errno Values)
    z/TPF Messages (System Error, Offline, and Program Status Word)
    z/TPF Operations
    
    See your IBM representative if you need additional information.
    
    DOWNLOAD INSTRUCTIONS:
    https://www.ibm.com/support/docview.wss?uid=swg27049604
    
    APAR URL:
    https://transfer.boulder.ibm.com/2021/PJ46401.tar.gz
    

Temporary fix

Comments

APAR Information

  • APAR number

    PJ46401

  • Reported component name

    Z/TPF

  • Reported component ID

    5748T1501

  • Reported release

    110

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-01-20

  • Closed date

    2021-09-30

  • Last modified date

    2021-09-30

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

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

Publications Referenced
SK2T8062    

Fix information

  • Fixed component name

    Z/TPF

  • Fixed component ID

    5748T1501

Applicable component levels

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZL53","label":"TPF"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]

Document Information

Modified date:
02 October 2021