IBM Support

PH46906: HOURGLASS UPDATE NEEDED TO PROVIDE SUPPORT FOR CICS 6.1

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • PROBLEM SUMMARY:
    ***************************************************************
    * USERS AFFECTED:      All IBM HourGlass users interested in  *
    *                      support for CICS 6.1, or for avoiding  *
    *                      "false positive" Zero Address Detection*
    *                      breakpoints within HourGlass modules.  *
    ***************************************************************
    * PROBLEM DESCRIPTION:                                        *
    *                      HourGlass did not support CICS 6.1.    *
    *                      We have HourGlass code which compares  *
    *                      the calling version of CICS with the   *
    *                      latest supported version deliberately  *
    *                      and prevents providing virtual times   *
    *                      when the CICS version is not supported.*
    *                      This prevents us from using CICS data  *
    *                      structures which might have been       *
    *                      changed since the latest supported     *
    *                      CICS version and prevents HourGlass    *
    *                      from getting ABENDs on unsupported     *
    *                      CICS versions.  There are also checks  *
    *                      against supported version call         *
    *                      locations which allow us to avoid      *
    *                      providing virtual times for calls      *
    *                      intended to use only "system" times,   *
    *                      which must be tailored to recognize    *
    *                      new CICS versions.                     *
    *                                                             *
    *                      This version is now modified to        *
    *                      produce an AGGXT05 message when the    *
    *                      calling unsupported CICS version       *
    *                      attempts to execute the HGFE command.  *
    *                      So new unsupported CICS versions will  *
    *                      hopefully be quickly so recognized     *
    *                      Previous versions only produced this   *
    *                      message when it detected a new DFHAPIN.*
    *                                                             *
    *                      We had about 18 HourGlass modules      *
    *                      which would have provided "false       *
    *                      positive" Zero Address Detection (ZAD) *
    *                      breakpoints within them if so traced.  *
    *                      They were "false positive" in that     *
    *                      they were not due to errant code, but  *
    *                      instead just not efficiently coded.    *
    *                      And of course would have been less     *
    *                      than helpful if using ZAD breakpoints, *
    *                      in an attempt to find actual error     *
    *                      sources.  2/3 of these HourGlass       *
    *                      modules were CICS related modules      *
    *                      anyway, so it made sense to us to fix  *
    *                      ALL such known modules in a CICS APAR. *
                           FIXCAT keyword: CIC0601T/K
    ***************************************************************
    * RECOMMENDATION:      Apply this APAR to rectify the defect. *
    *                                                             *
    ***************************************************************
    * PROBLEM CONCLUSION:                                         *
    ***************************************************************
    * FIX DESCRIPTION:                                            *
    *                      Numerous HourGlass modules changed to  *
    *                      support CICS 5.6 data offsets.         *
    *                      Numerous HourGlass modules changed to  *
    *                      remove false positive ZAD triggers.    *
    ***************************************************************
    * PRODUCT ELEMENTS AFFECTED BY THIS FIX:                      *
    ***************************************************************
    * NEW ELEMENTS ADDED:                                         *
    *     None.                                                   *
    *                                                             *
    ***************************************************************
    * EXISTING ELEMENTS MODIFIED:                                 *
    *                                                             *
    * For HourGlass V710 (5655-U59-00):                           *
    *   SAGGLOAD(AGGAUDIT).#000004 2022/08/25.16:43:33.PH46906    *
    *   SAGGLOAD(AGGCC   ).#000016 2022/08/25.16:39:17.PH46906    *
    *   SAGGLOAD(AGGCCGX ).#000012 2022/08/25.23:15:43.PH46906    *
    *   SAGGLOAD(AGGCCMS ).#000003.2022/08/25.23:58:26.PH46906    *
    *   SAGGLOAD(AGGCCVR ).#000007 2022/08/26.13:49:16.PH46906    *
    *   SAGGLOAD(AGGCSQL ).#000007 2022/08/29.21:31:33.PH46906    *
    *   SAGGLOAD(AGGCSTCK).#000003 2022/08/26.18:40:27.PH46906    *
    *   SAGGLOAD(AGGDL   ).#000004 2022/08/26.18:49:45.PH46906    *
    *   SAGGLOAD(AGGDR   ).#000004 2022/08/19.18:25:57.PH46906    *
    *   SAGGLOAD(AGGEXCLD).#000019 2022/07/29.12:04:56.PH46906    *
    *   SAGGLOAD(AGGFORMT).#000007 2022/08/26.19:05:41.PH46906    *
    *   SAGGLOAD(AGGFRONT).#000016 2022/08/01.21:50:40.PH46906    *
    *           (AGGELIG ).#000026 2022/06/20.18:50:28.PH45286    *
    *           (AGGEXCLD).#000019 2022/07/29.12:04:56.PH46906    *
    *   SAGGLOAD(AGGFTCH ).#000006 2022/08/26.19:15:14.PH46906    *
    *   SAGGLOAD(AGGGETDT).#000003 2022/08/26.22:20:47.PH46906    *
    *   SAGGLOAD(AGGICGX ).#000009 2022/08/26.23:44:42.PH46906    *
    *   SAGGLOAD(AGGINSTL).#000009 2022/08/27.00:27:31.PH46906    *
    *   SAGGLOAD(AGGLSARR).#000012 2022/08/27.15:52:51.PH46906    *
    *   SAGGLOAD(AGGLSPC ).#000069 2022/08/30 00:32:08.PH46906    *
    *   SAGGLOAD(AGGLSSTC).#000017 2022/08/27.19:02:12.PH46906    *
    *   SAGGLOAD(AGGNATC ).                                       *
    *           (CMCOTIME).#000003 2022/08/28.10:30:33.PH46906    *
    *   SAGGLOAD(AGGPLT  ).#000009 2022/08/28.10:38:02.PH46906    *
    *   SAGGLOAD(AGGPLTNA).#000003 2022/08/28.11:12:00.PH46906    *
    *   SAGGLOAD(AGGRRC01).#000006 2022/08/28.11:43:47.PH46906    *
    *   SAGGLOAD(AGGSC   ).#000015 2022/08/28.12:04:40.PH46906    *
    *           (AGGSCMF ).#000006 2022/08/28.12:16:48.PH46906    *
    *   SAGGLOAD(AGGSCMS ).#000004 2022/08/28 12:30:21.PH46906    *
    *   SAGGLOAD(AGGSCSD ).#000004 2022/08/28.12:38:25.PH46906    *
    *   SAGGLOAD(AGGSEC  ).#000003 2022/08/28.15:04:00.PH46906    *
    *   SAGGLOAD(AGGSETDT).#000003 2022/08/28.14:39:59.PH46906    *
    *   SAGGLOAD(AGGUC   ).#000011 2022/08/28.16:01:02.PH46906    *
    *   SAGGLOAD(AGGUCMS ).#000003 2022/08/28.16:43:10.PH46906    *
    *   SAGGLOAD(AGGVIMS ).#000004 2022/08/28.17:32:14.PH46906    *
    *   SAGGLOAD(AGGVRFY ).#000007 2022/08/29.11:10:14.PH46906    *
    *   SAGGLOAD(AGGXPCF ).#000008 2022/08/29.11:18:56.PH46906    *
    *   SAGGLOAD(AGGXTRUE).#000013 2022/08/29.12:15:47.PH46906    *
    *                                                             *
    *   SAGGDBRM(AGGDL   ).#000004 2022/08/26.18:50:26.PH46906    *
    *   SAGGDBRM(AGGDR   ).#000004 2022/08/19.18:26:13.PH46906    *
    *                                                             *
    ***************************************************************
    * EXISTING ELEMENTS DELETED:                                  *
    *     None.                                                   *
    *                                                             *
    ***************************************************************
    * IMPLEMENTATION:                                             *
    *                      After applying this PTF,               *
    *                      reBIND the new AGGDL and AGGDR         *
    *                      versions to your DB2 versions          *
    *                      with which you might use with          *
    *                      AGGDL (HGDL) and AGGDR (HGDR),         *
    *                      using your JCL derived from            *
    *                      SAGGSAMP ( AGGBNDDL, AGGBNDDR ).       *
    *                                                             *
    *                      After applying this PTF,               *
    *                      you must re-apply HourGlass            *
    *                      customization.                         *
    *                                                             *
    *                      After re-applying HourGlass            *
    *                      customization,                         *
    *                      you must stop and restart HourGlass.   *
    *                                                             *
    *                      After applying this PTF,               *
    *                      you must stop and restart all CICS     *
    *                      HourGlass regions.                     *
    ***************************************************************
    
    IBM.TargetSystem-RequiredService.CICS.V6R1 CIC0601T/K
    

Local fix

Problem summary

  • All IBM HourGlass users interested in support for CICS 6.1, or
    for avoiding "false positive" Zero Address Detection breakpoints
    within HourGlass modules.
    

Problem conclusion

  • Numerous HourGlass modules changed to support CICS 5.6 data
    offsets. Numerous HourGlass modules changed to remove false
    positive ZAD triggers.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH46906

  • Reported component name

    IBM HOURGLASS

  • Reported component ID

    5655U4200

  • Reported release

    710

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2022-06-02

  • Closed date

    2022-09-01

  • Last modified date

    2023-12-07

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

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

    PH46907 UI82225

Modules/Macros

  • AGGAUDIT AGGCC    AGGCCGX  AGGCCMS  AGGCCVR  AGGCSQL  AGGCSTCK
    AGGDL    AGGDR    AGGEXCLD AGGFORMT AGGFRONT AGGFTCH  AGGGETDT
    AGGICGX  AGGINSTL AGGLSARR AGGLSPC  AGGLSSTC AGGNATC  AGGPLT
    AGGPLTNA AGGRRC01 AGGSC    AGGSCMS  AGGSCSD  AGGSEC   AGGSETDT
    AGGUC    AGGUCMS  AGGVIMS  AGGVRFY  AGGXPCF  AGGXTRUE
    

Fix information

  • Fixed component name

    IBM HOURGLASS

  • Fixed component ID

    5655U4200

Applicable component levels

  • R710 PSY UI82225

       UP22/09/02 P F209

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SS9S7H","label":"HourGlass"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
08 December 2023