IBM Support

PI79692: BUNDLE INSTALLATION FAILS DURING CICS WARM START 17/10/18 PTF PECHANGE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A CICS region is restarted, however the BUNDLE installation
    fails because the JVMServer isn't available at that time.
    
    There seems to be a timing issue during a CICS warm start when
    installing a JVMServer and it's associated BUNDLES.
    
    
    The joblog shows the following sequence of messages:
    ----------------------------------------------------
    DFHSJ1109 06/12/2016 05:25:16 An attempt to determine the
              highest semantic version of the OSGi bundle with
              symbolic name BUNDLE zzzzzzzz to install into
              JVMSERVER xxxxxx has failed with reason code
              JVMSERVER_NOT_ENABLED.
    
    DFHSJ0915 06/12/2016 05:25:18 JVMSERVER xxxxxx is now
              enabled and is ready for use.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users with UI50057 applied.         *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS bundle installation failure.       *
    ****************************************************************
    * RECOMMENDATION: .                                            *
    ****************************************************************
    A CICS bundle is being installed in an OSGi (non-Liberty) JVM
    server which uses the versionRange attribute for an included
    OSGi bundle resource. The JVM server and the CICS bundle are
    both being installed at the same time, either explicitly or
    during a warm start. The result is that the OSGi bundle
    resource with versionRange is attempting to be installed while
    the JVM server is enabling. This leaves the bundle in an
    disabled state.
      Note - this APAR is also addressing a problem introduced by
    PI77502 (UI50057), where a class router failure is returned
    from the JVM when trying to determine the highest version
    within the version range of the bundle component. The problem
    is because of the use of parm_n on the method signature for
    SetByteArrayRegion within add_extended_plist_buffer in DFHSJSC.
    The use of parm_n is an uninitialised variable. The code should
    have used parm_m.
    

Problem conclusion

  • UI50057
    CICS has been changed to defer the installation of a CICS
    bundle with versionRange attribute until the JVM server has
    completed its own initialisation.
      Note - this APAR is also correcting a problem introduced by
    PI77502 (UI50057) where a class router failure is returned
    from the JVM when trying to determine the highest version
    within the version range of the bundle component. The correct
    variable parm_m is now used on the call to SetByteArrayRegion.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI79692

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    YesPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-04-11

  • Closed date

    2017-10-18

  • Last modified date

    2017-11-01

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

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

    PI87419 UI51219 UI51220 UI51221

Modules/Macros

  • DFHAPJVM DFHAXIS2 DFHCDJNI DFHSJBD  DFHSJDM  DFHSJDS  DFHSJDUF
    DFHSJIN  DFHSJIS  DFHSJJS  DFHSJL   DFHSJNT  DFHSJRE  DFHSJRL
    DFHSJRM  DFHSJSC  DFHSJSM  DFHSJST  DFHSJTH  DFHSJTRI DFHSJXM
    DFJ@H356 DFJ@H360 DFJ@H427 DFJ@H467 DFJ@H468 DFJDTCOE DFJOUTRE
    DFJWLPPL
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R000 PSY UI51219

       UP17/10/20 P F710 {

  • R003 PSY UI51221

       UP17/10/20 P F710 {

  • R00D PSY UI51220

       UP17/10/23 P F710 {

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":"5.3","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":"5.3","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
01 November 2017