PM76101: REMEDIATE MISMATCH IN CICS TASK NUMBER THAT RESULTS IN MSG AGGXT01E NO UNUSED TASK SLOTS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HourGlass CICS support maintains a table of 'slots', where each
  slot is the working-storage area for a CICS transaction.  A slot
  is allocated for each tran at CICS task initialization, and
  freed at task termination, using the CICS task number to
  uniquely identify each slot.  In the case of one client, their
  application slightly modifies the CICS task number in the EIB,
  for example, from a value of x'0123456C' at CICS task
  initialization, to a value of x'0123456F' at CICS task
  termination.  HourGlass, attempting to free the task-related
  slot at task termination, compares the value of the CICS task
  number, retrieved from the EIB with the task number stored in
  the HourGlass task-related slot, and the result is a mismatch.
  The task-related slot is not freed.  Eventually the HourGlass
  task-related slot table fills up with orphaned slots.  Once the
  slot table is full the next CICS task that is initiated and
  attempts to allocate a slot receives the message 'AGGXT01E NO
  UNUSED TASK SLOTS.', indicating that the HourGlass slot table is
  full.
  

Local fix

• If possible, correct user application to disist from modifying
  the CICS task number in the CICS EIB data area.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IBM HourGlass R610 users utilizing       *
  *                 HourGlass CICS support.                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: HourGlass CICS support maintains an     *
  *                      internal table of 'slots', where each   *
  *                      slot is a working-storage area for a    *
  *                      CICS transaction.  A slot is allocated  *
  *                      for each tran at CICS task initializa-  *
  *                      tion, and freed at task termination,    *
  *                      using the CICS task number to uniquely  *
  *                      identify each slot.  In the case of one *
  *                      client, their application happened to   *
  *                      slightly modify the CICS task number    *
  *                      in the EIB, for example, from a value   *
  *                      of x'0123456C' at CICS task initiali-   *
  *                      zation, to a value of x'0123456F' at    *
  *                      CICS task termination.  HourGlass,      *
  *                      while attempting to free the task-      *
  *                      related slot at task termination,       *
  *                      compares the value of the CICS task     *
  *                      number, retrieved from the EIB, with    *
  *                      the task number stored in the HourGlass *
  *                      task-related slot, and the result is a  *
  *                      mismatch.  The task-related slot is not *
  *                      freed.  Eventually the HourGlass task-  *
  *                      related slot table fills up with        *
  *                      orphaned slots.  Once the slot table is *
  *                      full, when the next CICS task to be     *
  *                      initiated attempts to allocate a slot,  *
  *                      the message: 'AGGXT01E NO UNUSED TASK   *
  *                      SLOTS.', indicating that the HourGlass  *
  *                      slot table is full, is displayed on the *
  *                      MVS system display.                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• ***************************************************************
  * FIX DESCRIPTION:     The logic that deallocates the task-   *
  *                      related slot in HourGlass load module  *
  *                      AGGXTRUE has been enhanced to compare  *
  *                      the CICS task number with a sign nibble*
  *                      of both x'C' and x'F'.                 *
  *                                                             *
  *                      Logic in AGGLSPC, AGGSC, AGGUC, and    *
  *                      AGGXTRUE module(s) was changed to      *
  *                      handle a new requirement for CICS TS   *
  *                      4.2 which moves the DFHAFCB trailer in *
  *                      front of the DFHAFCB itself, which     *
  *                      causes a S0C8 when not fixed.          *
  *                      Another change fixes a hypothetical    *
  *                      problem accessing one of the TCAs if   *
  *                      it happens to get swapped out, which   *
  *                      would likely cause a S0C4 in that case.*
  *                      Logic in AGGCC was changed to update   *
  *                      an included HGEPRST MACLIB table       *
  *                      version to match the version built     *
  *                      into the new AGGXTRUE module.          *
  *                                                             *
  * LOCAL FIX:           If possible, correct user application  *
  *                      to disist from modifying the CICS task *
  *                      number in the CICS EIB data area.      *
  *                                                             *
  ***************************************************************
  * PRODUCT ELEMENTS AFFECTED BY THIS FIX:                      *
  ***************************************************************
  * NEW ELEMENTS ADDED:                                         *
  *     None.                                                   *
  *                                                             *
  ***************************************************************
  * EXISTING ELEMENTS MODIFIED:                                 *
  *   SAGGLOAD  AGGCC   .#000008.2012/11/26.16:29:27.PM73129    *
  *             AGGLSPC .#000036 2012/11/14.18:21:14.PM74980    *
  *             AGGSC   .#000008.2012/11/01.12:36:25.PM74980    *
  *             AGGUC   .#000006.2012/11/01.12:50:12.PM74980    *
  *             AGGXTRUE.#000020.2012/12/05.12:21:50.PM76101    *
  *                                                             *
  ***************************************************************
  * EXISTING ELEMENTS DELETED:                                  *
  *     None.                                                   *
  *                                                             *
  ***************************************************************
  * IMPLEMENTATION:      To complete the implementation of this *
  *                      fix these steps must be taken following*
  *                      installation of the fix via SMP/E:     *
  *                                                             *
  *                      1.  Ensure that the updated module is  *
  *                      copied to its execution library.       *
  *                                                             *
  *                      2.  Rerun the customization job.       *
  *                                                             *
  *                      3.  Stop and restart HourGlass via the *
  *                      AGGOFF and AGGON commands.             *
  *                                                             *
  *                      4.  Stop and cold restart, or 'newc'   *
  *                      the changed module(s) in, any CICS     *
  *                      region(s) for which this fix is to be  *
  *                      implemented.                           *
  *                                                             *
  ***************************************************************
  

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:

Modules/Macros

•    AGGCC    AGGLSPC  AGGSC    AGGUC    AGGXTRUE
  

Fix information

• Fixed component name

  IBM HOURGLASS

• Fixed component ID

  5655U4200

Applicable component levels

• R610 PSY UK90359

     UP12/12/18 P F212

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.