You need to configure the licensing for
Enterprise Server when running native COBOL applications from a network server.
The following instructions are based on 64-bit Windows environments where:
- any 32-bit software is installed in
C:\Program Files (x86).
- Windows stores the 32-bit system files in
C:\Windows\SysWOW64.
- Windows stores the 64-bit system files in
C:\Windows\System32.
In 32-bit Windows environments, these locations are as follows:
- any software is installed in
C:\Program Files.
- Windows stores the system files in
C:\Windows\System32.
Your native COBOL program must be compiled in
Enterprise Developer with the dynamic link setting enabled. You do this as follows:
In Visual Studio:
- In Visual Studio, load the project for your application.
- Click
Project >
MyProject Properties.
- Click the
COBOL Link tab in the properties and then click
Dynamic.
- Save your changes and rebuild the solution.
To enable a COBOL application to be launched from the client machine, you need to configure the environment at both the server
and the client sides as follows:
Server Side
The following instructions show how to install the entire
Enterprise Server and configure it so that your application uses its run-time system modules.
Important: You must remove any individual copies of run-time system modules (for example,
cblrtsm.dll) that might have been copied into your application’s working directory. This is to avoid issues with running the application
such as "245 no valid licenses found" as the run-time system is not loading from the expected location, or where the copied
run-time modules are from other versions of the product versions. Removing such modules ensures that any run-time system modules
are only loaded from the
Enterprise Server instance which you have installed following the instructions in this topic.
Perform the following steps on the server:
- Ensure is installed.
- Start Micro Focus License Administration.
Enterprise Server
See
To start
Micro Focus License Administration for details.
- Install the license:
- Click
Options > Advanced Configuration.
- Click
Change on the row for
License server field, specify the IP address or the name of the server, and click
Save.
- Close both the
Advanced Configuration and the
Micro Focus Licensing System Administration dialog boxes.
- Copy the following files to the
%ProgramFiles(x86)%\Micro Focus\Enterprise Server\bin folder:
Client Side
Perform the following steps on the client machine:
- Add the
bin subfolder within the
Enterprise Server shared folder you created on the server,
MicroFocusSrv, and the application folder to the PATH environment variable as follows:
where:
- ServerName is the server's name or IP address
- <AppFolder> is the application folder
- If your COBOL application is deployed on the client machine:
- Use a text editor to create a run-time launch file,
progname.exe.mfcfg, where
progname is the same name as the name of the executable,
progname.exe.
Tip: If there are multiple
.exe files, you can instead create one
mfdefault.exe.mfcfg file, to be used for all
.exe files. When running
.int and
.gnt files with
run.exe, we recommend you do create
mfdefault.exe.mfcfg.
- Include the following two lines in the launch file:
SET SERVERPATH=\\ServerName\MicroFocusSrv
SET CESDYNAMIC=ces.ini
where:
- ServerName is the server's name or IP address
- Add the run-time launch configuration file in the same folder as the application's
.exe file.
- Run the application.