IBM Support

OA63728: MISCELLANEOUS CICS AND MQ UPDATES AND FIXES.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Issues addressed:
    1) CICS hangs when AGMU traces is on
    2) AGMAD65W message written to system log
    3) Handle MQ shutdown to free unused entries
    4) HTTP ingress from nginx updates
    5) Handle MQ queue property PROPCTL=COMPAT for Instana
    6) Cleanup zAPM control blocks when  CICS is shutdown without
    AGMU STOP being issued. Error message AGMP1044E RCODE=19 when
    zAPM proc terminates without issuing AGMU,STOP command first.
    

Local fix

  • n/s
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All Z APM Connect users                      *
    ****************************************************************
    * PROBLEM DESCRIPTION: 1) CICS hangs when AGMU traces is on    *
    *                      2) AGMAD65W message written to system   *
    *                      log                                     *
    *                      3) Handle MQ shutdown to free unused    *
    *                      entries. This condition was preventing  *
    *                      the initialization of additional MQ     *
    *                      subsystems.                             *
    *                      4) Handling Instana proprietary trace   *
    *                      context for HTTP calls into CICS.       *
    *                      5) Handle MQ queue property             *
    *                      PROPCTL=COMPAT for Instana              *
    *                      6) Cleanup zAPM control blocks when     *
    *                      CICS is shutdown without AGMU STOP      *
    *                      being issued.                           *
    ****************************************************************
    Container should print AGMAD65W Lost connection
    message to SYSLOG so customers can automate an action based
    on the message.
    
    AGMQ TERM should be done automatically when MQ
    goes down.
    
    Container's AGMA STATUS ALL command displays incorrect number of
    connected address spaces.  This was caused by incorrect cleanup
    during CICS shutdown.
    
    Support for Instana proprietary trace context in the CICS data
    collector is required.
    

Problem conclusion

  • The code has been modified to resolve the above problems.
    

Temporary fix

Comments

APAR Information

  • APAR number

    OA63728

  • Reported component name

    Z APM CONNECT

  • Reported component ID

    5698ABF00

  • Reported release

    610

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2022-09-02

  • Closed date

    2023-07-07

  • Last modified date

    2023-07-11

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

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

    UJ92531

Modules/Macros

  • AGMAD    AGMADH64 AGMADHXP AGMADK64 AGMADKXP AGMADM64 AGMADMXP
    AGMADN64 AGMADNXP AGMADOG  AGMADR64 AGMADRXP AGMADSG  AGMADTIL
    AGMADTL2 AGMAINXP AGMAMSGS AGMAPARM AGMASHXP AGMATJAV AGMATKXP
    AGMATLOG AGMATMXP AGMATRXP AGMATTLA AGMAXAPI AGMAXCOM AGMDB20E
    AGMDB20F AGMDBF0E AGMDBF0F AGMDLA0E AGMDLA0F AGMEAI00 AGMPADF0
    AGMPADG0 AGMPADH0 AGMPADI0 AGMPADJ0 AGMPADK0 AGMPADL0 AGMPADM0
    AGMPAPI  AGMPFLTR AGMPGGA  AGMPGLF0 AGMPGLG0 AGMPGLH0 AGMPGLI0
    AGMPGLJ0 AGMPGLK0 AGMPGLL0 AGMPGLM0 AGMPHTTP AGMPINIT AGMPPUE0
    AGMPRQF0 AGMPRQG0 AGMPRQH0 AGMPRQI0 AGMPRQJ0 AGMPRQK0 AGMPRQL0
    AGMPRQM0 AGMPSGF0 AGMPSGG0 AGMPSGH0 AGMPSGI0 AGMPSGJ0 AGMPSGK0
    AGMPSGL0 AGMPSGM0 AGMPSTOP AGMPTRF0 AGMPTRG0 AGMPTRH0 AGMPTRI0
    AGMPTRJ0 AGMPTRK0 AGMPTRL0 AGMPTRM0 AGMPUTIL AGMPWRF0 AGMPWRG0
    AGMPWRH0 AGMPWRI0 AGMPWRJ0 AGMPWRK0 AGMPWRL0 AGMPWRM0 AGMQAPID
    AGMQAPIE AGMQAPIX AGMQBKUR AGMQCMUR AGMQCO71 AGMQCOLL AGMQDUMP
    AGMQEFMT AGMQEGET AGMQEPUT AGMQEUTL AGMQEVNT AGMQINST AGMQRSMG
    AGMQSTBX AGMQSTOP AGMSYSIN
    

Fix information

  • Fixed component name

    Z APM CONNECT

  • Fixed component ID

    5698ABF00

Applicable component levels

  • R610 PSY UJ92531

       UP23/07/11 I 1000

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"610"}]

Document Information

Modified date:
11 July 2023