Setting up a JVM server

To run Java™ applications, web applications, Axis2, or a CICS® Security Token Service in a JVM server, you must set up the CICS resources and create a JVM profile that passes options to the JVM.

About this task

A JVM server can handle multiple concurrent requests for different Java applications in a single JVM. The JVMSERVER resource represents the JVM server in CICS. The resource defines the JVM profile that specifies configuration options for the JVM, the program that provides values to the Language Environment® enclave, and the thread limit. A JVM server can run different types of workload. A JVM profile is supplied for each different use of the JVM server:

  • To run applications that are packaged as OSGi bundles, configure the JVM server with the DFHOSGI.jvmprofile. This profile contains the options to run an OSGi framework in the JVM server.
  • To run applications that include JSP pages and servlets, configure the JVM server with the DFHWLP.jvmprofile. This profile contains the options to run a web container that is based on the Liberty profile technology. The web container also includes an OSGi framework and can therefore run applications that are packaged as OSGi bundles.
  • To run SOAP processing for web services with the Axis2 SOAP engine, configure the JVM server with the DFHJVMAX.jvmprofile. This profile contains the options to run Axis2 in the JVM server.
  • Start of changeTo run a CICS Security Token Service (STS), configure the JVM server with the DFHJVMST.jvmprofile. This profile contains the options to run an STS.End of change

Any changes that you make to the profiles apply to all JVM servers that use it. When you customize each profile, make sure that the changes are suitable for all the Java applications that use the JVM server.

Start of changeYou can either configure JVM servers and JVM profiles with CICS online resource definition, or you can use the CICS Explorer® to define and package JVMSERVER resources and JVM profiles in CICS bundles. For more information, see Working with bundles in the CICS Explorer product documentation.End of change

Results

The JVM server is configured and ready to run a Java workload.

What to do next

Configure the security for your Java environment. Give appropriate access to application developers to deploy and install Java applications, and authorize application users to run Java programs and transactions in CICS. For more information, see Security for Java applications.