A fix is available
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
GC34703501 | GC34717600 |
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
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