Thursday, June 5, 2008

PeopleSoft Cobol application server

The MFLicense.exe self-extracting zip file contains the following two updates, that need to be applied to your system(s);
Update 1 - ASCII.DIR and EBCDIC.DIR - Micro Focus NetExpress 4.0 COBOL
Compiler Directives
ASCII.DIR and EBCDIC.DIR contain the Micro Focus NetExpress 4.0 COBOL Compiler Directives required for compiling PeopleSoft COBOL Applications. The ASCII.DIR and EBCDIC.DIR files need to be installed on the systems that will be used for COMPILING PeopleSoft COBOL programs.
The ASCII.DIR and EBCDIC.DIR files need to be installed into EACH \src\cbl\win32 directory,on a system that will use the Micro Focus NetExpress 4.0 compiler
Update 2 - Micro Focus NetExpress 4.0 Application Server License Database The Micro Foucs NetExpress 4.0 Application Server License Database needs to be installedon EACH system that will run PeopleSoft COBOL applications.
Typically, PeopleSoft COBOL application programs are run on PeopleSoft Application ServerSystems and PeopleSoft Batch ( Process Scheduler ) Systems.
_____________________________________________________________ Installation of Updates: _____________________________________________________________
The installation of the Updates is a 3 step process,
1. Run MFLicense.exe. MFLicense.exe is a self-extracting zip file that will put the Updates in the C:\MFLicense-Extract directory, by default. Please refer to Section I, below, for instructions on how to run MFLicense.exe 2. Install Update 1, on your Development systems Note! Development systems are systems where you COMPILE your PeopleSoft COBOL Applications. Please refer to Section II, below, for instructions to install Update 1.
3. Install Update 2, on your Run-Time Systems. Note! Run-Time systems are the sytem where PeopleSoft COBOL applications are run. The Run-Time systems are the systems where your PeopleSoft Application Server and PeopleSoft Batch Server ( Process Scheduler ) run. Please refer to Section III, below, for instructions to install Update 2.

______________________________________________________________
SECTION I - Running MFLicense.exe to extract Updates 1 and 2 ______________________________________________________________

I. Extracting Files from the MFLicense.exe self-extracting zip file
1. Open a CMD box by doing the following; 1.a. Windows Logo Key + R This will open the "Run" dialog box. 1.b. Enter cmd in the Open field 1.c. Click the "OK" button and a CMD box will pop-up
2. Create a directory to copy the MFLicense.EXE file to For Example: From the CMD box, create the directory C:\MFLicense-Extract using the following command; C:>mkdir C:\MFLicense-Extract 3. Copy the MFLicense.EXE file from the CD drive to the directory C:\MFLicense-Extract
For Example: C:>copy X:\MFLicense.EXE C:\MFLicense-Extract\.
Note: Where X: is the drive letter assigned to your CD device
4. Change Directories to the C:\MFLicense-Extract directory For Example: C:\>cd /d C:\MFLicense-Extract
5. List the directory of C:\MFLicense-Extract via the dir command, The following files should be displayed; For Example: C:\MFLicense-Extract>dir Volume in drive C is PS Volume Serial Number is 0426-0234
Directory of C:\MFLicense-Extract
07/18/2005 03:44p . 07/18/2005 03:44p .. 07/18/2005 03:42p 840,599 MFLicense.EXE 1 File(s) 840,599 bytes 2 Dir(s) 10,245,515,264 bytes free

6. Extract Updates 1 and 2 by running MFLicense.EXE. For Example: C:\MFLicense-Extract>MFLicense.EXE
7. A pop-up dialog window will prompt you for the installation directory;
Enter c:\MFLicense-Extract, then click the "Extract" button.
8. A pop-up dialog window will inform you went the Extraction is complete. Click the "OK" button to complete the Extraction.
9. The C:\MFLicense-Extract directory should now contain the folllowing files, which can be verified by running a directory listing;
For Example:
Volume in drive C is PS Volume Serial Number is 8C7E-CAEA
Directory of C:\MFLicense-Extract
07/18/2005 03:44p . 07/18/2005 03:44p .. 07/18/2005 10:08a 267 ASCII.DIR 01/27/2004 03:17p 8,342 ASLMF.LNG 01/27/2004 03:17p 163,840 aslmpclocate.exe 01/27/2004 03:17p 323,584 aslmpcsilent.exe 04/14/2005 04:26a 69,697 CBLINTS.DLL 04/14/2005 04:26a 540,737 CBLRTSS.DLL 04/14/2005 04:26a 41,025 CBLVIOS.DLL 04/14/2005 04:26a 24,642 COB32API.DLL 07/18/2005 10:08a 267 EBCDIC.DIR 07/18/2005 03:42p 840,599 MFLicense.EXE 06/02/2005 11:09a 262,144 MFSetup.exe 01/27/2004 03:17p 448 prodfile 07/18/2005 03:46p 10,254 README 01/27/2004 03:17p 1 semfile 03/25/2005 07:58a 5,268 setupMF.bat 15 File(s) 2,291,115 bytes 2 Dir(s) 1,804,538,368 bytes free

______________________________________________________________
SECTION II - Installing Update 1 - ASCII.DIR and EBCDIC.DIR ______________________________________________________________
II. PeopleSoft Delivered Compiler Directives Need to be updated, for Compiling PeopleSoft COBOL Programs with Micro Focus NetExpress 4.0 COBOL Compiler.
This step is required when using the Micro Focus NetExpress 4.0 COBOL Compiler, to compile PeopleSoft COBOL applications.
1. PeopleSoft Uses Specific COBOL Compiler Directives for Micro Focus NetExpress 4.0 compiler, which are present in ASCII.DIR & EBCDIC.DIR
2. Open a CMD box by doing the following;
2.a. Windows Logo Key + R This will open the "Run" dialog box. 2.b. Enter cmd in the Open field 2.c. Click the "OK" button and a CMD box will pop-up 2.d. Backup Delivered ASCII.DIR & EBCDIC.DIR as follows : copy \src\cbl\win32\ASCII.DIR \src\cbl\win32\ASCII.BAK copy \src\cbl\win32\EBCDIC.DIR \src\cbl\win32\EBCDIC.BAK
Note : The above step has to be performed for all locations, where the COBOL Programs will be compiled with the Micro Focus NetExpress 4.0 Compiler.
2.e. copy C:\MFLicense-Extract\*.DIR \src\cbl\win32\. /A/V/Y
Note: is the High level directory for your PeopleTools installation


________________________________________________________________________ ____________________
SECTION III - Installing Update 2 - NetExpress 4.0 Applications Server License Database ________________________________________________________________________ ____________________

III. Installing the Micro Focus NetExpress 4.0 Applications Server License Database on PeopleSoft Run-Time Systems. This License is required for running COBOL programs compiled with Net Express 4.0.
1. Prior to installing the Micro Focus NetExpress 4.0 Applications Server License Database, you MUST install the PeopleSoft COBOL applications on your Run-Time system.
Note: Attempting to install the Micro Focus Net Express 4.0 Application Server License Database will fail, if the PeopleSoft COBOL applicatons have not been installed and compiled!
2. At this point you need to set the environment variable %PS_HOME% to the directory where your PeopleSoft Software is installed
For Example:
If your PeopleSoft Applications were installed in the directory C:\PEOPLESOFT-HR880, the PS_HOME environment variable would be set as follows: C:\MFLicense-Extract>set PS_HOME=C:\PEOPLESOFT-HR880
3. Echo the PS_HOME environment variable %PS_HOME% to insure it has been set correctly.
For Example:
C:\MFLicense-Extract>echo %PS_HOME% C:\PEOPLESOFT-HR880

4. Installing the Micro Focus Net Express Application Server License Database To install the License Database run the program setupMF
For Example: C:\MFLicense-Extract>setupMF When setupMF runs, the Windows Registry will be updated with the following registry entry;
\HKEY_LOCAL_MACHINE\SOFTWARE\Micro Focus\ASLMF
In addition to the registry entry, the files mfasdb, prodfile and semfile will be created in the directory C:\psft-mf-nx-as-license If desired, an alternate license directory, other than C:\psft-mf-nx-as-license, may be specified for mfasdb, prodfile and semfile. This is done by specifying the directory's complete path as an argument to the setupMF command.
Option 1, below, illustrates the default invocation of setupMF.
Option 2, below, illustrates the invocation of setupMF with an alternative License Directory specified.
To install the Micro Focus Net Express 4.0 Application Server License Database, choose either Option 1 or Option 2. Option 1: Run setupMF, without any parameters, to generate and populate the C:\psft-mf-nx-as-license directory.
For example:
C:\MFLicense-Extract>setupMF 1 file(s) copied. MFSetup - %PS_HOME% Directory EXISTS - C:\PEOPLESOFT-HR880 MFSetup - This utility program will setup the appropriate MFSetup - Micro Focus Application Server Licensing to MFSetup - permit you to run your Peoplesoft applications. ok
MFSetup - Micro Focus Application Server Licensing Setup completed!
Option 2: Running setupMF with the directory path you desire to generate and populate the License Database in a directory different than C:\psft-mf-nx-as-license.
In the following example the directory C:\APPLICATION-LICENSE-DATABASE is specified
For Example: C:\MFLicense-Extract> setupMF C:\APPLICATION-LICENSE-DATABASE 1 file(s) copied. MFSetup - %PS_HOME% Directory EXISTS - C:\PEOPLESOFT-HR880 MFSetup - This utility program will setup the Appropriate MFSetup - Micro Focus Application Server Licensing to MFSetup - permit you to run your Peoplesoft applications. ok MFSetup - Micro Focus Application Server Licensing Setup completed!

5. The license database directory C:\psft-mf-nx-as-license or the alternate directory you specified, should contain the following files;
C:\psft-mf-nx-as-license>dir Volume in drive C is PS Volume Serial Number is 0426-0234 Directory of C:\psft-mf-nx31sp1-as-license 08/12/2004 02:17p . 08/12/2004 02:17p .. 08/12/2004 02:17p 1,194 mfasdb 01/27/2004 03:17p 448 prodfile 08/12/2004 02:17p 0 semfile 3 File(s) 1,642 bytes 2 Dir(s) 7,402,060,800 bytes free