IBM Support

PK84214: INSTALLING A DOCTEMPLATE OF TYPE EXITPGM FAILS WITH ABEND AALZ

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Abend AALZ when installing a doctemplate defined as a EXITPGM.
    .
    For document templates generated by an exit program, the exit
    program specifies (in its exit parameter list) whether or not a
    copy of the document template should be cached by the document
    handler.
    .
    An attempt is made to create a definition for a DOCTEMPLATE,
    which is returned by an exit program (which asks DH domain not
    to cache), and the size exceeds 8k (x'2000'). As part of the
    create process a caching buffer is obtained to hold the new
    template. However as the size is greater than the maximum
    allowed for the operation, 8k, it fails with a truncated error.
    When a template is held in a program this is not an error, but
    is reported as such. This leads to the creation being rejected
    with an AALZ abend. APAR PK54398 addressed this issue for
    DOCTEMPLATE's defined as PROGRAMS.
    
    Additional Keywords: abendAALZ KIXREVEPH
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Installing a DOCTEMPLATE of type        *
    *                      EXITPGM fails with ABEND AALZ.          *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    For document templates generated by an exit program, the exit
    program specifies (in its exit parameter list) whether or not a
    copy of the document template should be cached by the document
    handler.
    An attempt is made to create a definition for a DOCTEMPLATE,
    which is returned by an exit program (which asks DH domain not
    to cache), and the size exceeds 8k (x'2000'). As part of the
    create process a caching buffer is obtained to hold the new
    template. However as the size is greater than the maximum
    allowed for the operation, 8k, it fails with a truncated error
    and the caching buffer is freed. This truncation error causes
    the installation of the DOCTEMPLATE to fail with an abend AALZ.
    
    Additional Keywords: abendAALZ
    

Problem conclusion

  • The creation process, within DFHDHTM, has been amended to accept
    the failure to cache a template greater than 8k for DOCTEMPLATES
    defined as EXITPGM, when the exit requests that the template is
    not cached.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK84214

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-04-07

  • Closed date

    2009-06-29

  • Last modified date

    2009-08-03

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

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

    PK89701 UK47973

Modules/Macros

  •    DESDHTM  DFHDHTM
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R500 PSY UK47973

       UP09/07/07 P F907

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":"3.2","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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 August 2009