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

A fix is available

Subscribe

You can track all active APARs for this component.

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 number

    PM76101

  • Reported component name

    IBM HOURGLASS

  • Reported component ID

    5655U4200

  • Reported release

    610

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-10-30

  • Closed date

    2012-12-14

  • Last modified date

    2013-01-02

  • 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.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

HourGlass

Software version:

6.1

Reference #:

PM76101

Modified date:

2013-01-02

Translate my page

Machine Translation

Content navigation