IBM Support

PH38161: CAE SERVER FAILS IF AT-TLS LISTENER PORT IS UNAVAILABLE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • In case CQM_TLS_CAE_AGNT_LSTNR_PORT is unavailable CAE Server
    doesn't try to listen at CQM_CAE_AGENT_LISTENER_PORT even if
    RC4_PROTOCOL_ENABLED is set to TRUE.
    
    https://git.rocketsoftware.com/projects/CQM/repos/nm/browse/com/
    rocketsoft/nm/qm/portal/CaePortal.java#144
    
    During server socket initialization in CaePortal.java server
    tries to create server sockets for TLS  port. If it fails it
    throws an exception without checking whether RC4 port is
    available
    
    https://git.rocketsoftware.com/projects/CQM/repos/nm/browse/com/
    rocketsoft/nm/qm/portal/CaePortal.java#197
    
    
    In addition logic of socket creation is different if
    localPortalListenerAddresses is not null.
    localPortalListenerAddresses is not used in product anymore and
    has to be removed
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of IBM Db2 Query Monitor for z/OS      *
    *                 users of component:                          *
    *                 - CAE Server                                 *
    ****************************************************************
    * PROBLEM DESCRIPTION: CAE Server may fail if AT-TLS listener  *
    *                      port is unavailable.                    *
    *                                                              *
    ****************************************************************
    * RECOMMENDATION: Apply the PTF.                               *
    ****************************************************************
    With PH13428, CAE Server listens for incoming connections from
    CAE Agents on two ports: AT-TLS and RC4.
    If any of these ports are unavailable CAE server fails without
    checking the other one.
    

Problem conclusion

  • This behavior was fixed. CAE Server now listens on all
    available ports.
    
    ................................................................
    Search Keywords:
    CAE AT-TLS
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH38161

  • Reported component name

    DB2 QUERY MONIT

  • Reported component ID

    5655E6701

  • Reported release

    330

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-06-16

  • Closed date

    2021-06-17

  • Last modified date

    2021-07-02

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

    PH37380

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

    UI75954

Modules/Macros

  • CQMCAEPT CQMJAR   CQMUPXPT
    

Fix information

  • Fixed component name

    DB2 QUERY MONIT

  • Fixed component ID

    5655E6701

Applicable component levels

  • R330 PSY UI75954

       UP21/06/19 P F106

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.

[{"Type":"MASTER","Line of Business":{"code":"","label":""},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZJXP","label":""},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
03 July 2021