IBM Support

PI13927: THE EYUSTARTDB2THRD VIEW (DB2 THREADS IN A CICS REGION> SHOWS 0 FOR FIELD 'MAXIMUM NUMBER OF THREADS'.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The EYUSTARTDB2THRD view ('DB2 threads in a CICS region') shows
    value
    as zero for field 'Maximum number of threads' even if the
    DB2entry
    has a 'threadlimit' specified. Other fields seems correct:
    'Number
    of reserved threads' shows correctly the Protected thread
    defined for
    the DB2entry.
    
    The MAXTHREADS field is only set for PLAN and COMMAND threads.
    We inquire on DB2ENTRY and retrieve THRAEDLIMIT, but don't set
    the value in the DB2THRD resource.
    
    Problem is faced both in CICSTS41 (customer's environment) and
    in CICSTS42 environments.
    

Local fix

  • NA.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V4R1M0 and V4R2M0 Users      *
    ****************************************************************
    * PROBLEM DESCRIPTION: The EYUSTARTDB2THRD view ('DB2 threads  *
    *                      in a CICS region') shows the value for  *
    *                      'Maximum number of threads' as zero,    *
    *                      for pool, command, and entry threads,   *
    *                      even if the DB2ENTRY and DB2CONN re-    *
    *                      sources have thread limits specified.   *
    *                      'Number of current threads' might also  *
    *                      contain zero, even though there are     *
    *                      active pool, command, or entry threads. *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all MASes must be recycled to pick     *
    *                 up the new code.  Note that regions do not   *
    *                 need to be brought down and restarted at     *
    *                 the same time.                               *
    ****************************************************************
       The EXEC CICS INQUIRE DB2CONN and EXEC CICS INQUIRE DB2ENTRY
    commands return thread limits and active thread counts as full
    word values.  However the MAXTHREADS and CURTHREADS attributes
    of the DB2THRD resource table are half word fields.  Module
    EYU0NQT5 (NQT5 - Query DB2THRD Resources) copied the high order
    half word of the value returned by the EXEC CICS INQUIRE com-
    mands into the DB2THRD resource table.  NQT5 did not copy the
    DB2ENTRY THREADLIMIT value into the DB2THRD resource table.
    

Problem conclusion

  •    Module EYU0NQT5 was modified to copy the low order half word
    of thread limits and active thread counts returned by CICS into
    the DB2THRD resource table.  MAXTHREADS is now set for entry
    related DB2THRD resources.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI13927

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-03-18

  • Closed date

    2014-03-26

  • Last modified date

    2014-04-02

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

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

    PI13934 UI16418 UI16419

Modules/Macros

  • EYU0NQT5
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R60M PSY UI16418

       UP14/03/31 P F403

  • R70M PSY UI16419

       UP14/03/29 P F403

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":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 April 2014