PH62698: MESSAGE DFHAM4990 APPEARS FOR A USER AND CICS-SUPPLIED TRANSACTIONS AFTER MIGRATING TO VERSION 6.1

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After migrating to CICS TS version 6.1, when you issue a CEDA
  INSTALL for a user or CICS transaction, you see messages
  DFHAM4990 E and DFHAM4892 W. The problem is intermittent and
  occurs sporadically rather than consistently.
  
  Examples:
  DFHAM4990 E TRANSACTION DEFINITION FOR TRANSACTION TRN1 COULD
  NOT BE REPLACED BECAUSE IT IS A PROTECTED DEFINITION.
  
  DFHAM4892 W INSTALL FOR GROUP TRGRP HAS COMPLETED WITH ERRORS.
  
  DFHAM4990 E TRANSACTION DEFINITION FOR TRANSACTION CESN COULD
  NOT BE REPLACED BECAUSE IT IS A PROTECTED DEFINITION.
  
  DFHAM4892 W INSTALL FOR GROUP CICSGRP HAS COMPLETED WITH ERRORS.
  
  
  
  Trace of the TRN1 transaction:
  The trace entries in the dump show that transaction TRN1 is a
  user transaction and the first program is TRN1PROG (a cobol user
  
  program) and the transaction is in group TRGRP:
  
  
  AP EB00 AMP   ENTRY - FUNCTION(INSTALL) GROUP(TRGRP   )
  TRANSACTION(TRN1)
  
  XM 0201 XMXD  ENTRY - FUNCTION(ADD_REPLACE_TRANDEF)
  TRANSACTION_ID(TRN1) INITIAL_PROGRAM(TRN1PROG)
  PROFILE_NAME(DFHCICST) TWASIZE(0) INDOUBT_WAIT(YES)
  TRAN_PRIORITY(1) STATUS(ENABLED) PARTITIONSET(NONE)
  TASKDATAKEY(USER) TASKDATALOC(BELOW) STORAGE_CLEAR(NO)
  SYSTEM_RUNAWAY(YES) DYNAMIC(NO) LOCAL_QUEUING(NO) TCLASS(NO)
  INDOUBT(BACKOUT) RESTART(NO) SPURGE(NO) TPURGE(NO)
  DUMP(YES)TRACE(STANDARD) SHUTDOWN(DISABLED) RESSEC(NO)
  CMDSEC(NO) ISOLATE(YES) INDOUBT_WAIT_TIME(0) CONFDATA(NO)
  ROUTABLE_STATUS(NOTROUTABLE) OTSTIMEOUT(0)
  RESOURCE_SIG_BLOCK(2362F968 ,00000040)
  
  XS 0301 XSIS  ENTRY - FUNCTION(INQ_TRANSACTION_CATEGORY)
  TRANSACTION_ID(TRN1)
  
  XS 0302 XSIS  EXIT - FUNCTION(INQ_TRANSACTION_CATEGORY)
  RESPONSE(OK) CATEGORY(CAT2)
  
  XM 0202 XMXD  EXIT  - FUNCTION(ADD_REPLACE_TRANDEF)
  RESPONSE(EXCEPTION) REASON(TRANDEF_PROTECTED)
  
  The message DFHAM4990 occurs because the transaction was
  previously installed incorrectly as a protected transaction.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CEDA intermittently falsely reports that*
  *                      a transaction definition cannot be      *
  *                      replaced because it is "protected".     *
  ****************************************************************
  CICS TS version 6.1 moved some of the CICS supplied transaction
  definitions from the CICS system definition(CSD) and marked
  them as Protected, so that they cannot be changed and used to
  compromise the system.
  Message DFHAM4990 is issued if an attempt is made to replace the
  transaction definition for a protected transaction.
  However, the same message DFHAM4990 was issued for a User
  transaction while replacing the transaction definition using
  CEDA INSTALL.
  

Problem conclusion

• CICS has been changed to check for the protected transaction
  parameter existence before setting up the transaction definition
  as Protected.
  

Temporary fix

Comments

APAR Information

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

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

  UO02226 UO02227

Modules/Macros

• DFHXMXD
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO02226

     UP25/02/28 P F502

• R500 PSY UO02227

     UP25/02/25 P F502

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.