IBM Support

PM06266: DOCTEMPLATE GETS CACHED DURING CICS INITIALIZATION WHEN IT SHOULD NOT. ECDSA SUBPOOL DHCACHE UNEXPECTEDLY LARGE AT STARTUP.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You use CPSM BAS to define CICS resources during CICS startup.
    Some of those resources are of type DOCTEMPLATE.  They are HTML
    code stored in a PDS.
    .
    The CICS publications document that DOCTEMPLATEs that are
    installed during region initialization are not cached until they
    are first used, but you find that the ones created by BAS get
    cached anyway.
    .
    BAS uses the EXEC CICS CREATE SPI call to define DOCTEMPLATEs.
    Even when these CREATE calls are made during CICS
    initialization, the DOCTEMPLATEs that are HTML-based code in
    PDS's are being cached.  They should not be.
    .
    The same situation occurs if you have your own PLTPI program
    issuing EXEC CICS CREATE DOCTEMPLATE calls using the CICS SPI
    during region initialization
    Additional Symptoms:
    CICS EDSA ECDSA DHCACHE
    KIXREVRBD
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: DOCTEMPLATE resources installed during  *
    *                      PLT processing are cached, slowing      *
    *                      CICS initialization and using up        *
    *                      storage.                                *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Document templates that are installed from the GRPLIST during
    CICS startup are not cached, by copying them into storage,
    at that time. Each of these document templates is cached
    when it is referenced for the first time by an application.
    
    However, document templates installed during CICS
    initialization by EXEC CICS CREATE DOCTEMPLATE requests
    issued by a late stage PLT program or by CICSPlex SM
    BAS autoinstall, are cached which delays initialization
    and uses up storage.
    

Problem conclusion

  • Document Handler domain initialization is changed so that
    DOCTEMPLATE resources installed during late stage PLT
    processing or CICSPlex SM BAS autoinstall are not
    cached until first reference by an application. When using
    BAS autoinstall, the MASPLTWAIT EYUPARM system parameter must
    be set to YES.
    
    DFHDHRP now waits for the phase DMPH_TOP, rather than
    DMPH_RECOVERY_ACTIVE, before setting a flag to indicate that
    a cached copy is to be created for subsequent DOCTEMPLATE
    installs.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM06266

  • 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

    2010-01-29

  • Closed date

    2010-04-08

  • Last modified date

    2010-05-04

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

    PM05875

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

    UK55900

Modules/Macros

  • DESDHRP  DFHDHRP
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R600 PSY UK55900

       UP10/04/14 P F004

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:
04 May 2010