IBM Support

CWWKF0001E Unable to enable ZosConnect2.0 feature in CICS TS 5.2 Liberty Server

Question & Answer


Question

Why would message CWWKF0001E be returned when I start the liberty JVM server in CICS with cicsts: zosConnect-2.0? Do I have to do any additional setup to enable the ZosConnect 2 feature in the CICS Transaction Sever for z/OS (CICS TS) Liberty Server?

I recently installed the Beta version of z/OS Connect Enterprise Edition in the UNIX path /usr/lpp/IBM/zosconnect/v2r0/ and have also applied the PTFs for APAR PI59303 that provide "CICS SUPPORT FOR ZOS CONNECT ENTERPRISE EDITION 2.0".

These are the messages I see while starting the liberty JVM server in CICS with <feature>cicsts:zosConnect-2.0</feature>:

 E CWWKF0001E: A feature definition could not be found for com.ibm.zosConnect-2.0
 [5/25/16 8:43:30:428 EDT] 00000011 LogService-242-com.ibm.cics.wlp.zosconnectee  
 E CWWKE0702E: Could not resolve module: com.ibm.cics.wlp.zosconnectee [242]
   Unresolved requirement: Import-Package: com.ibm.zosconnect.spi; version=&quot;[2.0.0,3.0.0)&quot;
 
 [5/25/16 8:43:30:458 EDT] 00000033
 SystemErr                                                    R
 2016/05/25 12:43:30.386000 UTC [ERROR]
                                THREAD-NAME: Framework Event Dispatcher:
 Equinox Container: f035920d-7622-0016-1645-cd40911977d3
                                BUNDLE-SYMBOLICNAME: com.ibm.cics.wlp.
 zosconnectee
                                MESSAGE: FrameworkEvent ERROR
 org.osgi.framework.BundleException: Could not resolve module: com.ibm.
 cics.wlp.zosconnectee [242]
   Unresolved requirement: Import-Package: com.ibm.zosconnect.spi;
 version=&quot;[2.0.0,3.0.0)&quot;

product = CICS Transaction Server for z/OS 5.2.0, WebSphere Application Server 8.5.5.8, CICS LIBERTY NOTUSAGE, WAS FOR Z/OS 8.5.5.8

Answer

First confirm the properties for zCEE V2 were configured correctly:

  1. Create a configuration file on zFS. This file must be called /var/cicsts/dfhconfig/wlp/etc/extensions/zosconnect.properties.

  2. Add two properties to this file:

        com.ibm.websphere.productId=com.ibm.zosconnect  
        com.ibm.websphere.productInstall=/usr/lpp/IBM/zosconnect/v2r0/runtime  
    

...where the path is the location of zFS in the runtime directory in the place where you installed z/OS Connect Enterprise Edition. This is described in the CICS TS V5.2 documentation topic Configuring z/OS Connect Enterprise Edition.

The CWWKE0702E message can be issued in the following situations:

  • The ./zconsetup install did not run successfully when you installed the z/OS Connect V2 Enterprise Edition Open Beta.

  • A zosconnect.properties file is not at the required location

  • A com.ibm.websphere.productInstall value is specified in the zosconnect.properties file that does not point to the path where z/OS Connect EE is installed.

  • The zosconnect.properties permissions are set such that the CICS region is unable to read the file.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNPJM","label":"IBM z\/OS Connect"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server;zCEE

Document Information

Modified date:
14 February 2023

UID

dwa1276943