EPC - 761

Date : 1 December 2005

Description

Cumulative EPC for Visual LANSA V11.0. EPC761 delivers fixes for LANSA on Windows and iSeries and LANSA for the Web. It also provides the server side support for Version 11.0 of LANSA Client and LANSA Open.

Instructions to install the EPC

EPC761 includes software to be installed on an iSeries machine and on a Windows machine. These instructions describe the installation and use of all delivered items.

1. Download EPC761.EXE file from Web site or email.
2. Unzip (double click) EPC761.EXE. These files will be extracted:
   • EPC761.htm - this document
   • EPC761 - iSeries Save file
   • EPC761w.exe - Windows install executable
   • Directory \EPC761HF-051201 will contain the Hotfix files

Instructions provided for:

Detailed changes

EPC761 includes these changes:    [Click here to Show table...]

EPC761 supersedes EPC759 which addressed the following issues:    [Click here to Show table...]

List of affected objects

Windows Components:    [Click here to Show table...]

iSeries Components:    [Click here to Show table...]

Instructions for installing on iSeries

1. End the Listener for this LANSA system.
2. For iSeries shared folders:
   • in Explorer, map to the shared folder drive
   • create a folder named EPC761
   • copy unzipped file EPC761 to folder EPC761
3. If your network file system is not supporting iSeries shared folders, use FTP via TCP/IP performing the following steps:
   • logon to the iSeries and create folder EPC761
   • open a DOS session on the PC
   • change to the directory where the downloaded and unzipped files are located
   • sign on to FTP site - FTP XXXXXXXX (where XXXXXXXX is the name of iSeries system or TCP/IP address)
   • enter your iSeries user id and password
   • to send as a binary file : enter command bin
   • change to QDLS file system : enter command cd /QDLS
   • change to the folder EPCnnn : enter command cd EPC761
   • to send the downloaded file to the iSeries : enter command put EPC761
   • to exit : enter command quit
4. Use XFLRTOSAVF command to convert the folder to a save file format (LANSA program library must be on your library list) - press F4 for command details. Save file will be created by this command.
5. You now have a save file. Continue installing by following the instructions in the next section.

Do you have the EPC in a save file or tape or CD-ROM?

1. Sign on as a user profile that is QSECOFR, part of the QSECOFR group, or, has *ALLOBJ and *SECADM special authorities.
   NOTE: Check the OS/400 system value QFRCCVNRST. If QFRCCVNRST is set to 0, you must use FRCOBJCVN(*YES) on the RSTOBJ command.
2. Use the OS/400 RSTOBJ (restore object) command to restore all objects from library DC@EC761 (on the backup media) into library QTEMP.
   
   If using a save file you will use the following command:
   RSTOBJ OBJ(*ALL) SAVLIB(DC@EC761) DEV(*SAVF) SAVF(save file name) RSTLIB(QTEMP)
 
3. Display your current library list. If QTEMP is not shown, then add it to your library list by using the ADDLIBLE (add library list entry) command.
4. Install the EPC using the command:
   
   LOADEPC761 PGMLIB(<pgmlib>) COMLIB(<comlib>)
   where <pgmlib> is the name of the LANSA program library. This is often DC@PGMLIB but it may be different on your system.
   where <comlib> is the name of the LANSA Comm/Share library. This is often DC@COMLIB but it may different on your system.
    
5. After entering the library name and share library, press enter.
6. Press enter to continue processing.
7. Save and then delete the backout library (LANSAEC761) created by the install. The contents of the library may be used to backout this EPC and return your system to its previous state.
8. To install the EPC on another LANSA system, sign off and then on again before commencing the next installation.

Special Instructions for users of iSeries Web server (multi-tier)

To apply EPC761 on the Web server tier of your LANSA for the Web system, follow these steps:

1. If you haven't installed or upgraded LANSA for the Web on the Web server, do so before proceeding with step 2.
2. Restore the EPC objects into QTEMP (Perform the same steps you used to restore the objects in your LANSA for the Web application/data server system).
3. Display your current library list. If QTEMP is not shown, then add it to your library list using the ADDLIBLE (add library list entry) command.
4. Install the EPC for the Web server by using the command:
   
   LOADE761MT ADMLIB(<adminlib>) COMLIB(<comlib>)
   where <admin> is the name of the LANSA for Web Administration library.
   where <comlib> is the name of the LANSA Com/Share library.This is often DC@COMLIB but it may different on your system
    
5. Press enter to continue processing.
6. Save, and then delete, the backout library (LANSAMT761) created by the install. The contents of this library may be used to backout this EPC and return your system to its previous state.
7. Sign off and sign on again if you want to run the configuration program.

Special Instructions for users of iSeries CLIENT import

The LANSA Client import has been modified. The repository file definitions will now have the LANSA data library as their libraries, while the sample files will have the partition data library as their libraries.

There are some new fields in the repository file definitions.

Where the repository file definitions already exist in a partition (they will have the partition module library name) they should be deleted. The files affected are:
DC@F03
DC@F12
DC@F14
DC@F15
DC@F18
DC@F27

If you have CLIENT enabled partitions you must re-import (after applying EPC761) from save file CLIENT in the LANSA program library.

To import, use the option Import objects into this partition from the Housekeeping Menu.

Special Instructions for users of iSeries Visual LANSA Frameworks

The Visual LANSA Framework has an additional import for some re-build objects. If you have Visual LANSA Framework enabled partitions you must import this additional import  from save file VLF_761 in the LANSA program library.

To import, use the option Import objects into this partition from the Housekeeping Menu.

Special Instructions for users of iSeries LANSA Opens System Utility (OSU)

Once EPC761 has been applied these OSU objects will be located in the LANSA program library.

OS@P0001.pgm
QOPNSRC(OS@P0001).file
LODOSU761N.pgm
LOADOSU761.cmd

1. Signon as QSECOFR
2. Add the LANSA program library to the library list (ADDLIBLE <pgmlib>)
3. Install the OSU part of the EPC by using the command:
   
   LOADOSU761 OSULIB(<osulib>)
   where <osulib> is the name of the LANSA OSU library. This is often DC@OPENLIB but it may be different on your system.

Instructions for installing on Windows

1. Before installing the EPC you should stop using the LANSA development environment and stop all currently executing LANSA applications. If the EPC install finds files locked when it attempts to replace them a warning will be issued and the install will stop.
2. Double-click on EPC761w.exe.
3. A message box will be displayed from which you should select the "Setup" button or "Cancel" if you do not want to proceed.
4. If you have multiple configurations installed:
   • Before the EPC is installed a dialog box will be displayed listing the available LANSA configurations on your machine. Select the configuration to which the EPC is to be applied.
   • When you have selected the correct configuration and pressed OK the EPC will be installed.
5. When EPC installation is complete you may be be prompted to reboot your pc - please reboot.
6. Details of the EPC are recorded. To view these details, after installing the epc, sign into the LANSA development environment and view the Help/Product Information menu option. Select the Installation Details tab then expand the Installation/ EPC Summary and review the last entries.

Instructions for users of Visual LANSA Framework on Windows

If you have not imported the Visual LANSA Framework before or wish to re-import the whole framework, at the LANSA login dialog, select Partition Init then select Visual LANSA Framework.  Refer to Visual LANSA Frameworks Guide for more details.

If you are installing the framework on a Windows Web Server, the EPC installation will import all the necessary Visual LANSA Framework objects.

If you have already imported the Visual LANSA Framework and do not wish to re-import it then perform the following instructions;

1. Make sure the Visual LANSA Framework is not running.
2. Open the Visual LANSA Development environment (IDE) in the same partition the Visual LANSA Framework was previously imported.
3. Select the Tools/LANSA Import menu option.
4. Navigate to the LANSA\Imports\VLFRAMEWORK\EPC761\ folder in your LANSA installation.
5. Click on the LXXDIR.DEL file and click the OPEN button.
6. When the import completes successfully you are free to start the Visual LANSA Framework.

Instructions for installing Hotfix EPC761HF-051201

Copy the extracted EPC761HF-051201 directory structure into the LANSA V11.0 root directory eg. C:\Program Files\LANSA

In the EPC761HF-051201 directory there is a file called hotfix.cmd. Run this command file (double click on it).

This will perform the following actions

1. Create a BACKUP folder under the \LANSA and \EXECUTE folders.
2. Copy the files to be replaced to these folders and rename them to *.bak
3. Copy the delivered files to the appropriate locations. 

Step 3 can potentially fail for any of the following reasons

• The hotfix is being applied to a non- V11.0 LANSA environment
• The files it is attempting to backout and replace are in use
• The LANSA development environment is in use
• The LANSA Web server is in use

If the copy fails, you should review the messages in the DOS prompt and correct the issue eg. if a file is in use because the IDE is open, you should close the IDE and re-run the hotfix.cmd.

If any unexpected issues arise after applying the hotfix, use the backout library to restore the original files and report the problem to your local LANSA Support group.

© 2005 LANSA

EPC Information

• Latest
• EPC FAQs
• Visual LANSA
• Visual LANSA Framework
• LANSA for iSeries
• LANSA for the Web
• LANSA Integrator
• LANSA Open
• LANSA Client