PM73129: HOURGLASS UPDATE NEEDED TO PROVIDE SUPPORT FOR CICS 5.1

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HourGlass fix needed in order to add CICS 5.1 support.
  CICS51
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IBM HourGlass R610 intending to          *
  *                 utilize HourGlass with CICS 5.1.             *
  *                 Older versions of CICS will continue to      *
  *                 be supported w/no visible changes.           *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS 5.1 MACLIBs differ from those of   *
  *                      CICS 4.2 in ways requiring modification *
  *                      of HourGlass to support CICS 5.1.       *
  *                      Also older CICS version specific code   *
  *                      comparision strings, used for detecting *
  *                      CICS calls for which no HourGlass date  *
  *                      time adjustments should be made, do not *
  *                      match the CICS 5.1 code and would cause *
  *                      undesireable HourGlass date time        *
  *                      adjustments, often matching previously  *
  *                      reported (and previously fixed)         *
  *                      problems with earlier CICS and          *
  *                      HourGlass versions.                     *
  *                      Attemped use of previous HourGlass      *
  *                      versions w/CICS 5.1 would cause         *
  *                      HourGlass to ABEND in various places    *
  *                      and at various times, and thus be       *
  *                      unusable for the attempted purpose.     *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF.                               *
  ****************************************************************
  

Problem conclusion

• ***************************************************************
  * FIX DESCRIPTION:     Logic in the modules included in this  *
  *                      fix level adjust for the differences   *
  *                      CICS DSECT offsets between CICS        *
  *                      versions at run time, with new code for*
  *                      determining CICS 5.1 offsets, where it *
  *                      differs from CICS 4.2. Some of the old *
  *                      code for doing this is also now better *
  *                      documented.                            *
  *                      Also CICS 5.1 version specific code    *
  *                      comparision strings, used for detecting*
  *                      CICS calls for which no HourGlass time *
  *                      adjustments should be made, have been  *
  *                      added.                                 *
  *                                                             *
  ***************************************************************
  * PRODUCT ELEMENTS AFFECTED BY THIS FIX:                      *
  ***************************************************************
  * NEW ELEMENTS ADDED:                                         *
  *     None.                                                   *
  *                                                             *
  ***************************************************************
  * EXISTING ELEMENTS MODIFIED:                                 *
  *   SAGGLOAD(AGGCC   ).#000010 2013/01/11.14:47:36.PM73129    *
  *   SAGGLOAD(AGGCCGX ).#000009 2013/01/29.16:39:20.PM73129    *
  *   SAGGLOAD(AGGCSQL ).#000006 2013/01/25.16:43:18.PM73129    *
  *   SAGGLOAD(AGGDL   ).#000005 2012/12/04.13:36:34.PM73129    *
  *   SAGGLOAD(AGGDR   ).#000004 2012/12/04.14:33:33.PM73129    *
  *   SAGGLOAD(AGGFORMT).#000005.2013/01/25.16:46:30.PM73129    *
  *   SAGGLOAD(AGGFRONT).#000016 2012/11/30.15:26:27.PM78106    *
  *  SUBMODULE(AGGELIG ).#000044 2012/11/09.13:12:53.PM72250    *
  *  SUBMODULE(AGGEXCLD).#000007 2012/12/04.14:57:48.PM73129    *
  *   SAGGLOAD(AGGFTCH ).#000007 2013/01/09.14:02:13.PM73129    *
  *   SAGGLOAD(AGGLSPC ).#000039 2013/01/29.16:41:01.PM73129    *
  *   SAGGLOAD(AGGSC   ).#000011.2013/01/30.12:55:57.PM73129    *
  *   SAGGLOAD(AGGUC   ).#000009 2013/01/29.17:07:32.PM73129    *
  *   SAGGLOAD(AGGXPCF ).#000008 2013/01/25.15:59:19.PM73129    *
  *   SAGGLOAD(AGGXTRUE).#000025 2013/01/29.14:19:44.PM73129    *
  ***************************************************************
  * EXISTING ELEMENTS DELETED:                                  *
  *     None.                                                   *
  *                                                             *
  ***************************************************************
  ***************************************************************
  * IMPLEMENTATION:    * After installing the fix for this APAR *
  *                      it will be necessary to reexecute the  *
  *                      HourGlass customization job. One or    *
  *                      more elements replaced by this fix are *
  *                      modified by the HourGlass customization*
  *                      process.                               *
  *                                                             *
  *                    * Due to the replacement of the AGGFRONT *
  *                      module, it will be necessary to stop   *
  *                      and restart the HourGlass product, via *
  *                      an AGGOFF/AGGON command sequence, to   *
  *                      fully implement this fix.              *
  *                                                             *
  *                    * It will also be necessary to stop and  *
  *                      cold restart, any running CICS         *
  *                      region(s) in which the fix is to be    *
  *                      implemented.                           *
  *                                                             *
  *                    * It will also be necessary to bind      *
  *                      the new AGGDL and AGGDR to any DB2     *
  *                      versions to be used with CICS.         *
  *                                                             *
  *                    * To run the newly supported CICS 5.1    *
  *                      with HourGlass, one must also follow   *
  *                      currently documented steps for         *
  *                      supporting CICS 4.2, modified as one   *
  *                      obviously intuits so as to be done to  *
  *                      the CICS 5.1 environment, instead of to*
  *                      the CICS 4.2 environment.              *
  *                                                             *
  ***************************************************************
  

Temporary fix

Comments

APAR Information

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

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

  UK91429

Modules/Macros

•    AGGCC    AGGCCGX  AGGCSQL  AGGDL    AGGDR
  AGGFORMT AGGFRONT AGGFTCH  AGGLSPC  AGGSC    AGGUC    AGGXPCF
  AGGXTRUE
  

Fix information

• Fixed component name

  IBM HOURGLASS

• Fixed component ID

  5655U4200

Applicable component levels

• R610 PSY UK91429

     UP13/02/07 P F302

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.