PM86938: EYUNX0013E AND EYUNX0014E FOR CPSM TRANSACTIONS AFTER UPGRADE OF MAS AGENT AND CICS AUTO START

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You upgrade the CPSM MAS agent code in your CICS region, but do
  not properly follow the requirement in the instructions to COLD
  start your region after the upgrade. When the region
  initializes next, you receive EYUNX0013E and EYUNX0014E
  messages, and the MAS agent code shuts down.
  The description of the EYUNX0013E message indicates that CPSM
  would attempt to correctly redefine the transactions, but that
  does not appear to have happened.
  
  Additional Symptom(s) Search Keyword(s): KIXREVxxx
  

Local fix

• COLD (or INITIAL) start your region as required and documented
  in the InfoCenter.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You upgrade the CPSM MAS agent code  *
  *                      in your CICS region, but do not follow  *
  *                      the requirement in the documentation    *
  *                      to COLD start your region after the     *
  *                      upgrade.  When the region initializes   *
  *                      next, you receive messages:             *
  *                      .                                       *
  *                           EYUNX0013E  TRANSACTION CONL       *
  *                                has invalid value: EYU9XLEV   *
  *                                for option: PROGRAM           *
  *                      and                                     *
  *                           EYUNX0014E  The definition for     *
  *                                TRANSACTION CONL     is       *
  *                                invalid.  MAS initialization  *
  *                                is terminating                *
  *                      .                                       *
  *                      and the MAS agent code shuts down.      *
  *                      The description of message EYUNX0013E   *
  *                      indicates that CPSM attempts to rede-   *
  *                      fine the transactions correctly, but    *
  *                      that does not happen.                   *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes must be recycled to pick     *
  *                 up the new code.  Note that regions do not   *
  *                 need to be brought down and restarted at     *
  *                 the same time.                               *
  ****************************************************************
     CICSPlex SM uses some CICS interfaces which are version
  specific.  Programs and methods which use these interfaces have
  names which identify the version of CICS to which they apply.
  When required resources are created during CPSM initialization,
  module EYU9NXLM (NXLM - Local MAS Bootstrap Program) verifies
  that the proper version programs are installed, and that trans-
  actions which execute version specific programs identify the
  proper program names.
     Transaction CONL, the MAS Agent Long-Running Task, executes
  program xxx9XLEV, where xxx is the version-specific prefix.  If
  a MAS which was executing the same CICS and CPSM versions is
  upgraded to a new CPSM version without upgrading the version of
  CICS, and the region is not started COLD or INITIAL, the defi-
  nition of COLM in the catalog will identify the wrong version
  of xxx9XLEV.  A logic error in EYU9NXLM prevents CPSM from
  trying to correct the installed definition if the transaction
  ID begins with the letter "C".
  

Problem conclusion

• Program EYU9NXLM was modified to invoke EXEC CICS CREATE for
  any transaction whose installed attributes are not correct.  If
  the CREATE is successful, message EYUNX0013E will be followed by
  EYUNX0011W, and the MAS will initialize properly.  If the CREATE
  fails, message EYUNX0038E will be issued to expose the RESP and
  RESP2 values returned by CICS, an exception trace will be gen-
  erated, and MAS Agent initialization will then be terminated.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM86906

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

  UK94163

Modules/Macros

• EYU9NXLM EYUTVTHE
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R80M PSY UK94163

     UP13/05/10 P F305

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.