Readme Nx51

1

2

3

4

Net Express 5.1 Compiler

And

Net Express 5.1 Runtime

Installation and Licensing Document

5

I. Preface...................................................................................................................................................3II. Net Express 5.1 Compiler Installation and Licensing.................................................................................4

A. Compiler Installation - Run the setup utility............................................................................4B. Compiler Installation - Prompts and Responses.......................................................................4C. Compiler Licensing................................................................................................................18

III. Net Express 5.1 Runtime Installation and Licensing..........................................................................23A. Runtime - Overview...............................................................................................................23B. NetExpress COBOL Runtime DLLs Installation...................................................................25C. NetExpress Runtime Licensing..............................................................................................26

Appendix A. Known Problems..........................................................................................................27Appendix B. Frequently Asked Questions........................................................................................29

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 systemsC:\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 options1. Net Express support for .NET2. Interface Mapping Toolkit (Workflow Capture Server is automatically deselected)3. Enterprise Server4. UNIX Option5. 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 followsStart -> 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 E7C05WYH 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 DLLsA Windows Registry Entry – ASLMFA directory that contains the license databaseThe Application Server License Manager Service

1. The 6 DLLs are:CBLINTS.DLLCBLRTSM.DLLCBLRTSS.DLLCBLVIOM.DLLCBLVIOS.DLLCOB32API.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