Note:
- These details only explain how to enable use of the JVM COBOL run-time system with WebLogic; any other WebLogic configuration is out of the scope of this topic.
- The manifest file (manifest.mf) in
mfcobolrts.jar already contains the information required to be recognized as a shared library in WebLogic.
To install the JVM COBOL run-time system (mfcobolrts.jar) in WebLogic 12.1.1 or later, you can add it as a shared library from the
weblogic.Deployer command line utility.
To install the run-time system from the command line
Note: The
weblogic.Deployer utility only registers the JVM COBOL run-time system with the application server; it does not copy it to the server's directory structure.
- Ensure the application server is running.
- To set up your environment for the command line tool, run the
setWLSEnv.cmd (Windows) or
setWSLEnv.sh (UNIX) script, located in the
server\bin (Windows) or
server/bin (UNIX) sub-directory of the WebLogic server installation directory.
- Copy
mfcobolrts.jar from
%COBDIR%\bin (Windows) or
$COBDIR/bin (UNIX) to a new location.
- Enter the following command:
java weblogic.Deployer -adminurl t3://localhost:7001 -username USER_NAME
-password PASSWORD -deploy -library PATH\mfcobolrts.jar
Replace USER_NAME and PASSWORD 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
weblogic-application.xml file that contains the following code - 2.3 is the version of
Visual COBOL:
<?xml version="1.0" encoding="UTF-8"?>
<weblogic-application
xmlns="http://xmlns.oracle.com/weblogic/weblogic-application"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
<library-ref>
<library-name>mfcobolrts</library-name>
<specification-version>2.3</specification-version>
<implementation-version>2.3</implementation-version>
<exact-match>false</exact-match>
</library-ref>
</weblogic-application>
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 a more recent version of
Visual COBOL, that must be reflected in the
specification-version and
implementation-version settings.
To uninstall the run-time system from the command line
- Ensure the application server is running.
- Enter the following command:
java weblogic.Deployer -adminurl t3://localhost:7001 -username USER_NAME
-password PASSWORD -undeploy -name mfcobolrts
Replace USER_NAME and PASSWORD with details supplied by the administrator of the application server.