IBM Support

DFHSJ0002 0B07 in DFHSJJS during startup after upgrading to CICS TS 5.2 or higher

Question & Answer


Question

Why is the Java Liberty Server failing to start during initialization of my CICS region after I upgrade to CICS Transaction Server for z/OS (CICS TS) V5.2 or higher?

These are the message I receive during CICS start up:

DFHSJ0002 CICSRGN1 A severe error (code X'0B07') has occurred in module DFHSJJS.

DFHSJ0210 02/09/2016 22:52:48 CICSRGN1 An attempt to start a JVM for the JVMSERVER resource LIBERTY1 has failed. Reason code: ERROR_CODE_UNRECOGNIZED.

DFHSJ0914 E 02/09/2016 22:52:48 CICSRGN1 CICSTEST JVMSERVER LIBERTY1 is installed as DISABLED because the
Language Environment Enclave was not created.

I found this message in the SYSOUT DD:

2016/02/10 04:52:48.775767 UTC LIBERTY1 Exc: Attempt to open JVM profile LIBERTY has failed. Runtime error message = EDC5129I No such file or directory.

Answer

The key message here is this one:

2016/02/10 04:52:48.775767 UTC LIBERTY1 Exc: Attempt to open JVM profile LIBERTY has failed. Runtime error message = EDC5129I No such file or directory.

In the message I can see that it is looking for a Liberty JVMPROFILE called "LIBERTY" which does NOT appear in the JVMProfiles directory /usr/lpp/cicsts/TS53/JVMProfiles. The files in this directory are

 - LIBERTY.jvmprofile
 - LIBERTY.JVMPROFILE
 - LIBERTY1.jvmprofile     

It was not obvious at first until looking at the Liberty profiles in the directory. But, at CICS TS 5.2 and above the naming convention of the JVM Liberty Profile was changed to have a .jvmprofile extention.

Therefore, if the correct naming convention was used the message would have been formatted like this:

2016/02/10 04:52:48.775767 UTC LIBERTY1 Exc: Attempt to open JVM profile LIBERTY.jvmprofile has failed. Runtime error message = EDC5129I No such file or directory.

Notice LIBERTY.jvmprofile was used instead of just LIBERTY. This led me to think why was the original message not using the .jvmprofile extension?

That's when it occurred to me that perhaps I am using a pre CICS TS V5.2 hlq.SDFJAUTH library that contains CICS code for java support. After changing to the correct version of SDFJAUTH the Java Liberty Server started correctly.

You can read more about the JVM Liberty Profile naming convention change that started at CICS TS 5.2.

[{"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":"5.2","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server

Document Information

Modified date:
29 March 2016

UID

dwa1259743