1

2
3
4
 Net Express 5.1 Compiler

And

Net Express 5.1 Runtime

Installation and Licensing Document

5
..........................................................................................................................................................................1
..........................................................................................................................................................................4
I. Preface...........................................................................................................................................................7
II. Net Express 5.1 Compiler Installation and Licensing..................................................................................8
A. Compiler Installation - Run the setup utility...................................................................................8
B. Compiler Installation - Prompts and Responses..............................................................................8
C. Compiler Licensing.......................................................................................................................21
III. Net Express 5.1 Runtime Installation and Licensing................................................................................26
A. Runtime - Overview......................................................................................................................26
B. NetExpress COBOL Runtime DLLs Installation .........................................................................28
C. NetExpress Runtime Licensing.....................................................................................................29
Appendix A. Known Problems......................................................................................................................30
Appendix B. Frequently Asked Questions....................................................................................................32

6
I. Preface
Net Express 5.1 has two major components, a COBOL Compiler and a COBOL Runtime.

Please install and license either the Net Express 5.1 COBOL compiler or the Net Express 5.1
Runtime, on a system, BUT NOT BOTH!!!

How to Decide What to Install, the Compiler or the Runtime?

A. For Compiling or Compiling and Running Cobol Programs – Install the Compiler

If you need to compile or compile and run COBOL Programs, install and license the Net
Express 5.1 Compiler.

The Net Express 5.1 Compiler installation includes the Runtime, so it is not necessary to
install the Runtime if you install the Compiler.

Refer to Section II, for Installing and Licensing the COBOL Compiler

B. For Running Cobol Programs – Install the Runtime

If you need to run COBOL Programs but DON’T need to compile, just install and license the
Net Express 5.1 Runtime.

Refer to Section III, for Installing and Licensing the Runtime

7
II. Net Express 5.1 Compiler Installation and Licensing
A. Compiler Installation - Run the setup utility

Run the setup utility as follows:

• Go to the location where you have downloaded

“Micro Focus Net Express 5.1 for PeopleSoft: Compiler and Documentation”.

(NOTE: The download can be done from http://edelivery.oracle.com)

• Double Click on the setup.exe

B. Compiler Installation - Prompts and Responses

1. Open File - Security Warning Window

• Click the Run button

8
2. Micro Focus Autorun Window

• Click the Install Net Express link

9
3. The Install Shield Wizard, will launch a Windows Dialog box, and start extracting files.

Wait for a few minutes until the files are extracted and then Welcome Window will be displayed.

10
4. Welcome Window

• Click Next

11
5. License Agreement Window

• Click I accept the terms in the license agreement radio button, then click Next

12
6. Customer Information Dialog Box

a. Enter your Name and Company Name (if you want to)
b. Leave the Serial Number and W.O. Number fields blank. The Serial Number and W.O.
Number are not provided to you by Oracle and are NOT required.
c. Click Next

13
7. The Custom Setup Window
Note: Only after reading the points 7 and 8, should you click on the Next button on this window.

14
Highlight the option “Traditional Graphical User Interface” on the Custom Setup window.

The Micro Focus Net Express 5.1 default installation directory is,
For 32-bit systems
C:\Program Files\Micro Focus\Net Express 5.1

For 64-bit systems

C:\Program Files (x86)\Micro Focus\Net Express 5.1

You can install the compiler at any other location if you desire.

15
8. Installation Custom Setup

Note: Microsoft .NET framework is not required for compiling and running COBOL
applications in PeopleSoft architecture. Neither is .NET required for successful installation of
MicroFocus Net Express 5.1

For the PeopleSoft Applications, you just need Traditional Graphical User Interface
feature, rest of the features can be turned off.

You can deselect a feature by clicking on the drop down button and selecting the
“X This feature will not be available” label, as illustrated below:

16
You should deselect these options
1. Net Express support for .NET
2. Interface Mapping Toolkit (Workflow Capture Server is automatically deselected)
3. Enterprise Server
4. UNIX Option
5. XDB Relational Database

Your final selection should look like the below snapshot.

Note: When you would have your cursor highlighted at the “Traditional Graphical User
Interface” option, the Install to location would be pointing to
C:\Program Files\Micro Focus\Net Express 5.1\.

If you have your cursor highlighted on any of the other deselected options, the Install to
location would look grayed (blank).

Click the Next button.

17
9. Ready to install Dialog Box.

• Click Install button.

18
10. Installation Status Dialog Box

• The status of the installation is displayed.

19
11. Installation Wizard Completed.

• Click Finish.

20
C. Compiler Licensing
The Net Express 5.1 Compiler can be licensed via the Request Key / Response Key mechanism.
The initial license that you get after the NetExpress 5.1 install is for 30 days. You should convert
this to a Full License.

1. Open the “Micro Focus Net Express 5.1 License Management System” dialog box as follows
Start -> Programs -> Micro Focus Net Express 5.1 -> Configuration -> License
Management System

21
2. The License Management System Configuration Dialog Box will be displayed

Click the Net Express check box and then click the Generate Full License button.

22
3. Getting a License Key Dialog Box

The Request Key will be displayed in the Request Key box.

Send the Request Key (AWNR 2XFA E8N6 P424KGN2 370F, for example), and your
Oracle Customer Information to licensecodes_ww@oracle.com.

A Response Key will be sent back to you.

3KEB 0JH2 95RF MJA9 212Y E7C0

5WYH W8M2 EA6P KFAF 5FH2 47EB

23
4. Applying the Response Key

Enter the Response Key in the Response Key field and click OK

24
5. The MICRO FOUCS License Management System Configuration Dialog Box will display a
License Status of Full license.

Click OK

Now you are ready to use Micro Focus Net Express 5.1 COBOL Compiler

25
III. Net Express 5.1 Runtime Installation and Licensing
A. Runtime - Overview
The Net Express 5.1 Runtime provides the COBOL Runtime Environment required for COBOL
programs to run.

The Net Express 5.1 Runtime consists of following components:

6 DLLs
A Windows Registry Entry – ASLMF
A directory that contains the license database
The Application Server License Manager Service

1. The 6 DLLs are:

CBLINTS.DLL
CBLRTSM.DLL
CBLRTSS.DLL
CBLVIOM.DLL
CBLVIOS.DLL
COB32API.DLL

2. The ASLMFregistry entry.

3. The directory that contains the runtime license database is c:\psft-mf-nx-as-license, and
contains the following files, mfasdb, prodfile, and semfile.

26
27
B. NetExpress COBOL Runtime DLLs Installation
The Net Express 5.1 Runtime installation is done automatically as part of the COBOL compilation
process, so there is no explicit installation necessary.

1. How is the Runtime Automatically Installed?

When CBLBLD.bat is run, it invokes CBLRTCPY.bat to copy the COBOL runtime DLLs,
cblints.dll, cblrtsm.dll, cblrtss.dll, cblviom.dll, cblvios.dll, and cob32api.dll, from the
%COBROOT%\bin directory to %PS_HOME%\CBLBINx directory.

Where CBLBINx is CBLBINA, CBLBINE or CBLBINU, based on the compilation mode of

ASCII, EBCDIC or Unicode respectively.

28
C. NetExpress Runtime Licensing
The Net Express 5.1 Runtime Licensing files are contained in the self-extracting zip file,
MFLicense.exe. MFLicense.exe was developed specifically for PeopleSoft, to provide the
COBOL runtime system with unlimited runtime Net Express licenses.

You can get the Net Express 5.1 Runtime from licensecodes_ww@oracle.com

The file that you receive will have a README that explains how to license the runtime.

29
Appendix A. Known Problems

1. Dynamically Bound RTS Error

The following error occurs during the installation of the Net Express 5.1 Runtime
License, if the Net Express 5.1 Compiler is installed on the system;

This error occurs because the MFSetup.exe program which is used to install the Net
Express Runtime License was built with Net Express 3.1 SP1, and is picking up the
runtime DLLs from Net Express 5.1 compiler.

Solutions:
1. If the target machine ( machine where you are installing the license ) is just going
to be used running cobol programs, but not compiling, uninstall the Net Express
5.1 Compiler, then re-install the Net Express 5.1 Runtime License

2. If the target machine is going to be used for both compiling and running COBOL
programs, just ignore the above message. The Net Express 5.1 Cobol Compiler
is already installed ( it has an embedded runtime ) which will be used to execute
the cobol programs. And since the compiler is installed there is no need to install
and/or license the Net Express 5.1 Runtime.

30
2. ASLMF Errno 1000

If you get the following error, then the Net Express Runtime License isn’t installed

Solution: Install the Net Express 5.1 Runtime License.

Refer to Section III, for instructions on installing the Runtime License

31
Appendix B. Frequently Asked Questions

1. Does the Runtime License need to be installed on every machine?

Answer:
Yes. The Net Express Runtime License must be installed on each Runtime system. By
Runtime system, we mean any system which will be used to run COBOL programs.
2. Does the Runtime License need to be installed each time PeopleTools or PeopleSoft
applications are installed?

Answer:
NO. Once the Net Express Runtime license has been installed on a system, it DOESN’T
need to be reinstalled, unless the runtime license has been removed.

3. How can the Net Express Runtime License be uninstalled?

Answer:
1. For 32 bit Windows Systems

Delete the following Windows Registry Entry:

HKEY_LOCAL_MACHINE\SOFTWARE\MICRO FOCUS\ASLMF

For 64 bit Windows Systems

Delete the following Windows Registry Entry

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\MICRO
FOCUS\ASLMF

2. Delete the C:\psft-mf-nx-as-license directory and its contents

4. Does the Runtime License need to be removed if my computer is going to be rebuilt?

Answer: No, the runtime license doesn’t need to be removed. But it will need to be
reinstalled, once the computer is back in service

5. Can I use the Net Express 5.0 runtime to run COBOL programs that have been compiled
by Net Express 5.1?

Answer: No, you must use the Net Express 5.1 runtime file to run COBOL programs
compiled by Net Express 5.1

6. Can I use the Net Express 5.1 runtime to run COBOL programs that have been compiled
by previous version i.e. Net Express 5.0?

Answer: No. You must be using Net Express 5.1 runtime file

32