Configuring WebSphere

Note: These details only explain how to enable use of the JVM COBOL run-time system with WebSphere; any other WebSphere configuration is out of the scope of this topic.

To install the JVM COBOL run-time system (mfcobolrts.jar) in WebSphere 8.5 or later, you can add it as a shared library either through the application server management console or from the wsadmin command line utility.

Note: The manifest file (manifest.mf) in mfcobolrts.jar already contains the information required to be recognized as a shared library in WebSphere.

To install the run-time system using the management console

To install the JVM COBOL run-time system, refer to the IBM documentation for instructions on creating and managing a shared library:

Managing shared libraries

To install the run-time system from the command line

Note: The wsadmin utility only registers the JVM COBOL run-time system with the application server; it does not copy it to the server's directory structure.
  1. Ensure the application server is running.
  2. Copy mfcobolrts.jar from %COBDIR%\bin (Windows) or $COBDIR/bin (UNIX) to a new location.
  3. Enter the following command:
    wsadmin –lang jython –c AdminResources.createSharedLibrary("SERVER_NODE_NAME"
                                              ,"SERVER_NAME","mfcobolrts","PATH\mfcobolrts.jar”)

    Replace SERVER_NODE_NAME and SERVER_NAME with details supplied by the administrator of the application server. Replace PATH with the path that you used in the previous step.

Configure the application configuration file

In Eclipse, in the project that will be deployed, in the META-INF directory, add a MANIFEST.MF file, that contains the following:

Manifest-Version: 1.0
Extension-Name: mfcobolrts
Specification-Title: Micro Focus COBOL JVM Runtime System
Specification-Version: 2.3
Specification-Vendor: microfocus.com
Implementation-Version: 2.3
Note: 2.3 in this file is the version of Visual COBOL. If you bind your application to a newer version of the COBOL run-time system than was supplied in Visual COBOL, that must be reflected in the Specification-Version and Implementation-Version settings.

To uninstall the run-time system from the command line

  1. Ensure the application server is running.
  2. Enter the following command:
    wsadmin –lang jython -c AdminConfig.remove(AdminConfig.getid('/Library:mfcobolrts'))