IBM Support

PM40297: DFHRL0002 APPLID A SEVERE ERROR (CODE X'022E') HAS OCCURRED IN MODULE DFHRLPM

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You are attempting to install a bundle definition into CICS and
    are receiving the following error:
    
    DFHRL0002 applid A severe error (code X'022E') has occurred in
    module DFHRLPM
    
    After reviewing the CICS region Joblog and Dump you notice that
    CICS is attempting to execute a program that is not installed.
    Once you have installed the group DFHRL, which contains the
    program CICS is attempting to execute, there are no further
    problems. But for CICS to take a dump with this message seems a
    bit unnecessary.
    
    This is pretty much a user error but the message that is put out
    is too severe. This CICS message will need to be changed.
    
    Additional Symptom(s) Search Keyword(s): RL0002
    KIXREVRJL
    

Local fix

  • Installing the group enabled the bundle definition to be
    installed with no further problems.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS issues message DFHRL0002 if a      *
    *                      BUNDLE is installed before group DFHRL  *
    *                      is installed                            *
    ****************************************************************
    * RECOMMENDATION: Ensure CSD groups DFHRL and DFHPIPE are      *
    *                 included in the GRPLIST system               *
    *                 initialization parameter.                    *
    ****************************************************************
    If the definition of program DFHRLMF is missing during the
    installation of a CICS BUNDLE resource then message DFHRL0002
    is issued.
    

Problem conclusion

  • Message DFHRL0123 is added to CICS and issued whenever the
    definition for DFHRLMF is found to be missing, or DFHRLMF cannot
    be loaded.
    
    
    DOC Changes:
    
    CICS Transaction Server for z/OS Version 4 Release 1
    CICS Messages and Codes
    GC34-7035-01
    Append the message description for DFHRL0123 in subsection
    "DFHRLnnnn messages"
    
    DFHRL0123 E  The CICS resource life-cycle manager failed to
                 acquire PROGRAM "program_name" for BUNDLE resource
                 "bundle_name".
    
    Explanation: The CICS resource life-cycle bundle class,
    DFHRLPK, has failed to acquire PROGRAM "program_name"
    for BUNDLE resource "bundle_name". The CSD groups DFHRL
    and DFHPIPE must be installed before any BUNDLE
    resources are installed. It is likely that one of these
    groups is missing from the GRPLIST system initialization
    parameter.
    
    System action: The bundle fails to install, error processing
    continues.
    
    User response: Ensure that the required resource definitions
    are installed. If the definitions are installed from a list in
    the GRPLIST system initialization parameter, ensure that the
    supplied definitions are listed before any groups that contain
    BUNDLE resources.
    
    Module: DFHRLPK
    
    Destination: Console
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

  • ž**** PE12/03/14 FIX IN ERROR. SEE APAR PM56769  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PM40297

  • 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

    2011-05-27

  • Closed date

    2011-09-16

  • Last modified date

    2012-05-14

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

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

    UK72221 UK72222

Modules/Macros

  •    DESDHFS  DESRLPK  DFHDHFS  DFHDHFSA DFHDHFSM
    DFHDHFST DFHMERLC DFHMERLE DFHMERLK DFHRLBR  DFHRLDM  DFHRLDUF
    DFHRLPKC DFHRLPK1 DFHRLPM  DFHRLRG1 DFHRLRO  DFHRLRS1 DFHRLST
    DFH40297
    

Publications Referenced
GC34703501GC34717600   

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R600 PSY UK72221

       UP11/10/05 P F110

  • R700 PSY UK72222

       UP11/10/05 P F110

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:
14 May 2012