PH62698: MESSAGE DFHAM4990 APPEARS FOR A USER TRANSACTION 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 the customer issues
  a CEDA INSTALL for a some user transactions he receives message
  DFHAM4990 E.
  This is an example:
  DFHAM4990 E CICSD000 TRANSACTION DEFINITION FOR TRANSACTION CDAT
  COULD NOT BE
  
  REPLACED BECAUSE IT IS A PROTECTED DEFINITION.
  The trace entries in the dump show that transaction CDAT is a
  user transaction and the first program is CDAT1 (a cobol user
  program) and the transaction is in group ADLAB:
  
  AP EB00 AMP   ENTRY - FUNCTION(INSTALL) GROUP(ADLAB   )
  TRANSACTION(CDAT)
  
  
  
  
  
  
  XM 0201 XMXD  ENTRY - FUNCTION(ADD_REPLACE_TRANDEF)
  TRANSACTION_ID(CDAT) INITIAL_PROGRAM(CDAT1)
  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(CDAT)
  
  
  
  
  
  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)
  
  
  Message DFHAM4990 appears because CICS treats this transaction
  as CAT2 but it is a user transaction.
  

Local fix

• In order to bypass the problem the customer first disable the
  transaction and then install it.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: TRANDEF_PROTECTED exception issued for  *
  *                      CICS User transaction.                  *
  ****************************************************************
  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.