IBM Support

PM80214: LIBERTY FIXPACK UPDATE AND ASSOCIATED CICS SUPPORT. 13/06/20 PTF PECHANGE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Liberty Fixpack Update And Associated CICS Support.
    PM80214 updates the Liberty Profile technology shipped with CICS
    TS 5.1 to WebSphere Liberty Profile v8.5.0 Fixpack 1. It fixes a
    number of minor configuration issues when running in a CICS JVM
    server, but most importantly it introduces support for OSGi
    applications deployed as EBAs (Enterprise bundle archives) to
    Liberty.
    Liberty Fixpack 1 introduced a restriction that prevents direct
    access to exported packages of OSGi bundles from Servlets within
    a WAR application. This CICS APAR provides an alternative
    mechanism to achieve that design pattern (Servlets to access
    OSGi bundle code). The support is provided by leveraging the
    more functionally rich "OSGi Application" provided by the
    WebSphere Development Tooling for the Liberty Profile. An OSGi
    Application is deployed as an Enterprise Bundle Archive (EBA)
    file to Liberty, and CICS Explorer SDK will be extended to
    deploy this application type to the Liberty Server instance
    running under a JVM server in CICS.
    Within an OSGi application you can develop both Servlets (as WAB
    files) and OSGi bundles (as Plug-in projects). Servlets in the
    WAB file may access OSGi services provided by the OSGi bundles
    within the same EBA. EBAs provide a level of isolation (and run
    in a Blueprint container) within the Liberty Server runtime.
    Application developers should consider the use of Blueprint and
    EBA as a way to deploy their applications once this APAR has
    been installed
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: This APAR upgrades the embedded         *
    *                      WebSphere Application Server Liberty    *
    *                      profile to Version 8.5.0 Fix Pack 1.    *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The embedded CICS TS 5.1 Liberty JVM server requires an upgrade
    to WebSphere Application Server Liberty profile Version
    8.5.0 Fix Pack 1.
    

Problem conclusion

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

  • CICS TS 5.1 has been updated to use a Liberty JVM server
    that is based on WebSphere Application Server Liberty profile
    Version 8.5.0 Fix Pack 1.
    In addition, the following WebSphere Application Server Liberty
    profile APAR fixes have been incorporated into the CICS Liberty
    JVM Server:
    PM83572, PM83576, PM83586, PM83666, PM84523, PM85097, PM86895.
    
    This fix removes visibility between applications deployed
    to the Liberty profile server and OSGi bundles installed into
    the OSGi framework of JVM server via CICS Bundle resources
    and middleware bundles listed in the OSGI_BUNDLES variable of
    the JVM profile, with the exception of DB2 JDBC driver jars.
    To overcome this restriction, CICS now supports OSGi Application
    Projects which are deployed as an Enterprise Bundle Archive
    (EBA) via a CICS bundle resource.
    
    The CICS Explorer version 5.1.1 is required to deploy an EBA
    in a CICS bundle resource.  The existing example applications
    have been converted to EBA and the example RDO group DFH$WLP
    has been updated to include bundle resource definitions for
    deploying the examples.
    The CICS Liberty profile features: cics-ts and
    cics-ts-security have been changed to cicsts-1.0
    and cicstsSecurity-1.0 to be in line with other Liberty
    profile features. If the Java property
    -Dcom.ibm.cics.jvmserver.wlp.autoconfig=true is set
    in the JVM profile, CICS will update the Liberty profile
    configuration with the new feature names.
    If the property is not set, the Liberty profile server.xml
    will need to be updated manually.  The CICS feature no
    longer imports the jsp-2.2 feature.
    
    A new Liberty profile feature cicstsJdbc-1.0 is available
    when using DriverManager to get a connection to a DB2
    database with JDBC.  The feature aids visibility between
    web applications and DB2 JDBC drivers.  The Java property
    -Dcom.ibm.cics.jvmserver.wlp.jdbc.driver.location specifies
    the location of the DB2 driver. If the Java property
    -Dcom.ibm.cics.jvmserver.wlp.autoconfig=true is set in
    the JVM profile and either
    -Dcom.ibm.cics.jvmserver.wlp.jdbc.driver.location is set, or
    the OSGI_BUNDLES variable contains the location of DB2 drivers,
    CICS will update the Liberty profile configuration with the JDBC
    feature. If the autoconfigure property is not set, the Liberty
    profile server.xml will need to be updated manually.
    
    The CICS TS 5.1 Infocenter has been updated with the
    changes introduced by this APAR.
    .
    For additional information see technote 1641213 at:
    http://www.ibm.com/support/docview.wss?uid=swg21641213
    .
    ž**** PE13/07/01 FIX IN ERROR. SEE APAR PM91801  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PM80214

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED UR1

  • PE

    YesPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-01-09

  • Closed date

    2013-06-17

  • Last modified date

    2015-03-04

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

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

    UK95165 UK95166 UK95167 UK95168

Modules/Macros

  • DFHSJSC
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R80D PSY UK95166

       UP13/06/21 P F306

  • R80L PSY UK95167

       UP13/06/21 P F306

  • R800 PSY UK95165

       UP13/06/21 P F306

  • R803 PSY UK95168

       UP13/06/21 P F306

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

Document Information

Modified date:
04 March 2015