IBM Support

com.ibm.cics.router.RouterException - Unable to create Liberty profile server

Question & Answer


Question

Why am I getting a com.ibm.cics.router.RouterException when starting a CICS region for Liberty using CICS Transaction Server for z/OS (CICS TS) 5.3? I get a dump in the CICS region and the region is unable to start Liberty.

I see the following messages In the message log:

 Exception in thread "Router-Init-Thread" com.ibm.cics.router.RouterException: Unable to create Liberty profile server
     at com.ibm.cics.router.Router.initLiberty(Router.java:693)
     at com.ibm.cics.router.Router.initOSGi(Router.java:360)
     at com.ibm.cics.router.Router.main(Router.java:1211)
 
 Caused by: java.lang.Exception: Liberty profile: auto-configure is disabled and server.xml not found 

Due to this problem I am unable to start my Liberty server.

Answer

Notice that the message includes "Caused by: java.lang.Exception: Liberty profile: auto-configure is disabled and server.xml not found". This is indicating that the following option is set in the JVM system properties in the JVM profile:

 com.ibm.cics.jvmserver.wlp.autoconfigure=false

Because of this, CICS will not create the server.xml file automatically,. It will expect it to already exist. But it did not find a server.xml file within the specified directory and therefore was not able to start up the Liberty server.

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

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server

Document Information

Modified date:
16 September 2016

UID

dwa1303714