PI86767: CICS: DFHSJ1208 MESSAGE OCCURS WHEN INSTALLING APPLICATION ON LIBERTY JVM AND CICS FINDS MATCHING PROGRAM ALREADY INSTALLED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When you install a Java Web application in a Liberty JVM
  server, if a PROGRAM definition with the same name is already
  installed, the following message may occur:
  .
    DFHSJ1208 date time applid An existing definition has been
    installed for PROGRAM program. It is not suitable for use
    with a linkable service because {it does not have JVM(YES).
    | it does not specify the correct JVMSERVER. | it does not
    specify the correct JVMCLASS.} The expected value is
    expected, the value found is found.
  .
  CICS fails to dynamically autoinstall the program defined via
  the @CICSProgram annotation.  When CICS finds a program with a
  matching name is already installed, it will validate if the
  attributes are suitable with the linkable service for running
  on the Liberty JVM.  If it is not suitable, the DFHSJ1208
  message is issued indicating the reason why.  However, CICS
  does not delete the currently installed PROGRAM definition and
  replace it with a new definition that has the correct
  attributes.
  .
  .
  .
  Additional Symptom(s) Search Keyword(s): KIXREVCTC
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS issues message DFHSJ1208 when      *
  *                      dynamically installing a PROGRAM for    *
  *                      running on the Liberty JVM.             *
  ****************************************************************
  When program autoinstall is active, and a task attempts to
  prematurely call @CICSProgram before Liberty has installed
  it, CICS will autoinstall the program with attributes that may
  not be suitable.
  When Liberty tries to dynamically install the @CICSProgram,
  message DFHSJ1208 is issued because the autoinstalled program
  with the same name exists.
  

Problem conclusion

• CICS has been changed to delete an unused and unsuitable
  autoinstalled program definition, allowing Liberty to
  dynamically install a replacement with suitable attributes.
  
  The CICS Transaction Server for z/OS Version 5 Release 3, CICS
  Messages and Codes Vol 2, GC34-7419-00, Chapter 4. DFH messages
  - DFHN to DFHZ, section DFHSJnnnn messages, message DFHSJ1208
  has been updated as follows:
  
  DFHSJ1208    date time applid An existing definition has been
  installed for PROGRAM program. It is not suitable for use with
  a linkable service because {it does not have JVM(YES). | it
  does not specify the correct JVMSERVER. | it does not specify
  the correct JVMCLASS.| it could not be dynamically replaced. }
  The expected value is expected, the value found is found.
  
  Explanation
  While installing an application in a Liberty JVM server, CICS
  found an existing PROGRAM definition installed for program.
  This existing definition was found to be incompatible with the
  linkable service, either because it isn't defined for Java, for
  the correct JVMSERVER, or for the correct JVMCLASS, or it
  could not be dynamically replaced. CICS will only dynamically
  replace a program if it was previously autoinstalled and has
  not been loaded.
  
  System Action
  The existing PROGRAM definition remains installed, but the
  linkable service will not be usable.
  
  User Response
  Either change the program name defined on the @CICSProgram
  annotation so that it does not clash, or correct the PROGRAM
  definition.
  
  Module
  com.ibm.cics.wlp.link.impl.ProgramGenerator
  
  XMEOUT parameters/Message inserts
  1. date
  2. time
  3. applid
  4. program
  5. Value chosen from the following options:
       1=it does not have JVM(YES).,
       2=it does not specify the correct JVMSERVER.,
       3=it does not specify the correct JVMCLASS.
       4=it could not be dynamically replaced.
  6. expected
  7. found
  
  Destination
  CSMT
  
  
  CICS Transaction Server for z/OS Version 5 Release 4
  CICS Messages, Chapter 2. CICS messages, section
  DFHSJnnnn messages, message DFHSJ1208 has
  been updated as follows:
  
  
  DFHSJ1208    date time applid An existing definition has been
  installed for PROGRAM program. It is not suitable for use with
  a linkable service because {it does not have JVM(YES). | it
  does not specify the correct JVMSERVER. | it does not specify
  the correct JVMCLASS.| it could not be dynamically replaced. }
  The expected value is expected, the value found is found.
  
  Explanation
  While installing an application in a Liberty JVM server, CICS
  found an existing PROGRAM definition installed for program.
  This existing definition was found to be incompatible with the
  linkable service, either because it isn't defined for Java, for
  the correct JVMSERVER, or for the correct JVMCLASS, or it could
  not be dynamically replaced. CICS will only dynamically replace
  a program if it was previously autoinstalled and has not been
  loaded.
  
  System Action
  The existing PROGRAM definition remains installed, but the
  linkable service will not be usable.
  
  User Response
  Either change the program name defined on the @CICSProgram
  annotation so that it does not clash, or correct the PROGRAM
  definition.
  
  Module
  com.ibm.cics.wlp.link.impl.ProgramGenerator
  
  XMEOUT parameters/Message inserts
  1. date
  2. time
  3. applid
  4. program
  5. Value chosen from the following options:
          1=it does not have JVM(YES).,
          2=it does not specify the correct JVMSERVER.,
          3=it does not specify the correct JVMCLASS.
          4=it could not be dynamically replaced.
  6. expected
  7. found
  
  Destination
  CSMT
  

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:

  UI52647 UI52648 UI52649 UI52650

Modules/Macros

• DFHMESJC DFHMESJE DFHMESJK DFHPGAI  DFHPGDD  DFHPGRP  DFJ@H467
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI52647

     UP17/12/14 P F712

• R00D PSY UI52648

     UP18/01/03 P F712

• R100 PSY UI52649

     UP17/12/15 P F712

• R10D PSY UI52650

     UP18/01/03 P F712

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.