EPC - 790
Date : 24 October 2006
EPC790 Highlights
EPC790 delivers enhancements and corrections for Visual LANSA, LANSA for iSeries, LANSA for the Web, LANSA Client and the Visual LANSA Framework.
The significant benefits to be achieved by applying EPC790 are:
- WAMs :
- It is now possible to generate the XSL for a single webroutine of a WAM. Use the right click menu to invoke the XSL generation. WAM developers should find this enhancement improves productivity.
- The stability and reliability in the XSL Editor has been improved.
- A new weblet (std_largelist) now supports very large lists (either XHTML or CSV). This weblet is recommended for report-like lists where there is no need to visualize columns with web widgets (controls) and the fields are output-only. You will need EPC792 applied to the Web Administrator and EPC791 applied to the LANSA for the Web IIS Plugin before you can use the std_largelist weblet.
- The performance for various types of deployed WAM applications, especially for complex WAMs, has been improved.
- The XSL editor Options dialogue now includes validation of entered values. Some users had mistakenly entered invalid values which caused unpredictable results during development (e.g. retrieving icons and images). The Options dialogue now makes its best attempt to connect to the nominated URL and ports at the time of update and when the XSL Editor is invoked.
- EPCs and other upgrades will now automatically invoke changed imports. All system wide imports will be done e.g. BIFs, commands, Technology Services. A new dialogue will be presented during this EPC install requesting that you nominate the Web enabled RDMLX partitions to receive the changed Weblets. This enhancement ensures that web partitions will never be using old versions of Weblets and Technology Services again.
- Internet Explorer V7.0 is now supported by the LANSA XSL editor.
- Various issues associated with the XSL Editor and with web and WAM execution have been addressed.
- Visual LANSA :
- The performance of RDMLX applications has been improved, in some cases, substantially.
Many Visual LANSA applications running on iSeries will perform significantly faster after applying EPC790. Although there will be benefits for RDMLX applications running on Windows, the improvements on this platform will not be as dramatic. The amount of improvement available to Visual LANSA applications will depend on the processing they perform. The major improvements are in the handling of packed and integer field types (which affects common operations like maths processing and comparisons). Therefore, applications that use such commands as Change, Assign, If, DoWhile, DoUntil, Loc_Entry, etc. should experience improvements especially where these commands are executed repeatedly (as in a loop situation). - Importing times for medium to large imports has been reduced. For example, importing time for the Visual LANSA Framework should be reduced after applying EPC790. Deployment of LANSA developed applications will also benefit.
- Installation of changed system imports is now handled automatically. Removes the obligation from the user to complete this step to ensure all definitions are up-to-date.
- Various issues associated with deployed Visual LANSA applications and the Visual LANSA Framework have been addressed.
- The performance of RDMLX applications has been improved, in some cases, substantially.
- Server side support for LANSA Client V11.3 has been completed. EPC790 will be listed as the pre-requisite for LANSA Client V11.3 when it is released.
| Product | Visual LANSA and LANSA for iSeries | ||
|---|---|---|---|
| Version | 11.3 | ||
| Pre-Requisite Details | EPC771 (CU3) | ||
| Related Products | LANSA for the Web, Visual LANSA Framework, LANSA Client | ||
| Full Distribution In | Next Cumulative EPC or next Version | ||
| Special Notes | This EPC requires EPC792 applied to the Web Administrator and EPC791 applied to the LANSA for the Web IIS Plugin for WAM development and IIS web serving. All Version 11.3 Visual LANSA EPCs include updates that must be applied to Windows and iSeries systems (Independent Visual LANSA development environments only require the Windows updates). Failure to upgrade both sides of a development environment will render the Host Monitor and Super Server applications inoperable. Attempting to use the Host Monitor and Super Server applications without having applied the EPC to both sides of a development environment will generate an EPC mismatch error. Make a full backup of your LANSA environment on each platform to which this EPC will be applied. | ||
| Compatibility Notes | To avoid object versioning issues on any target LANSA runtime environment after applying this EPC to your LANSA development environment (Windows and iSeries), you must also apply this EPC to the target LANSA runtime environment before deploying any objects built and compiled at this EPC level. This ensures that all required runtime routines are present in the target runtime environment to support any new or altered facilities introduced by the EPC. Failure to apply this EPC to such target environments before deploying any objects built and compiled at this EPC level will produce unpredictable results at runtime. | ||
| iSeries Specific Special Notes | V5R1 ONLY: This EPC should NOT be applied to a LANSA system on OS/400 V5R1. Applying this EPC to a LANSA system on V5R1 can cause connections via the LANSA Listener to fail with an MCH3601 error. Refer to QC2POSIX error on V5R1 after applying post CU3 EPCs The iSeries instructions are expedited procedures that assume a sound knowledge of OS/400. You should use a user profile that is QSECOFR, part of the QSECOFR group, or, has *ALLOBJ and *SECADM special authorities. You must end the web server and run the LANSA for the Web cleanup program before applying this EPC. You must end the Listener and Host Monitor if active. You must end the LANSA Integrator server if it has been used with the LANSA system to be updated. | ||
| User Actions | You may need to rebuild OAMs for LANSA files on iSeries if the partition is RDMLX enabled. See below for further details. Recompile RDMLX applications to achieve the advertised performance improvements. Import the standard weblets into your RDMLX partitions:
| ||
| Document Updates | Updates to these guides are provided:
| ||
| Hotfixes | The following Hotfixes will be replaced by this EPC:
| ||
| Hotfix Special Notes | This EPC includes special instructions for applying the latest V11.3 Hotfixes to a LANSA environment on EPC790. These hotfixes contain fixes for significant issues found after EPC790 had been shipped. |
Instructions to install the EPC
EPC790 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.
- Download EPC790.EXE file from the Web site or email.
- Unzip (double click) EPC790.EXE. These files will be extracted:
- EPC790.htm - this document
- EPC790 - iSeries Save file
- EPC790w.exe - Windows install executable
- EPC790HF-061117 - Folder
- EC790P07 - Zip file
- EC790P09 - Zip file
Instructions provided for:
| Yes | LANSA for iSeries |
| Yes | iSeries Web Server (multi-tier) |
| Yes | Visual LANSA |
| Yes | EPC790HF-061117 (Windows) |
| Yes | EC790P07 (iSeries) EC790P09 (iSeries) |
Detailed changes
EPC790 includes these changes: [Click here to Show table...]
EPC790 supersedes EPC784, EPC783, EPC781, EPC780 and EPC769: [Click here to Show table...]
Affected objects
Windows Components: [Click here to Show table...]
iSeries Components: [Click here to Show table...]
Install Instructions
Instructions for installing on iSeries
- These instructions have been abridged for experienced LANSA users. IIf you need further assistance to install the EPC, full instructions are available in the Technical Resources of the LANSA web site at www.lansa.com/support/notes/epc
- Recommend a backup be done of all the LANSA folders, system libraries and ALL the LANSA IFS objects (LANSA_pgmlib/x_lansa) before applying this EPC
- You need exclusive use of the LANSA system before applying the EPC. To check for active users refer to Appendix C How to check for Active Users in the Installing LANSA on iSeries guide for instructions.
- End the Listener, Host Monitor and web server for the LANSA system and run the LANSA for the Web cleanup program.
- Move the unzipped file EPC790 to a shared folders (QDLS) on the iSeries.
- Use the XFLRTOSAVF command to convert the folder to a save file (LANSA program library must be on your library list) - press F4 for command details. A save file will be created by this command.
- You now have a save file.
- Sign on as a user profile that is QSECOFR, part of the QSECOFR group, or, has *ALLOBJ and *SECADM special authorities.
- Use the RSTOBJ command to restore all objects from library QTEMP into library QTEMP, eg.
RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(<save file name>) RSTLIB(QTEMP) - Display your current library list. If QTEMP is not shown, add it to your library list by using the ADDLIBLE (add library list entry) command.
- Install the EPC using the command:
LOADEPC790 PGMLIB(<pgmlib>) COMLIB(<comlib>)
<pgmlib> is the name of the LANSA program library, often DC@PGMLIB but it may be different on your system.
<comlib> is the name of the LANSA Communications library, often DC@COMLIB but it may different on your system.
- Save and then delete the backout library (iiiEPCnn where iii = 1st three characters of the LANSA pgm library and nn is sequence number) created by the install. The contents of the library may be used to backout this EPC and return your system to its previous state.
- Sign off and then on again before commencing the next installation, eg:
- to apply this EPC on another LANSA system
- to apply another EPC on the same LANSA system
- Import the standard weblets into your RDMLX partitions from the save file found in the LANSA program library.
Special Instructions for users of iSeries web server (multi-tier)
To apply EPC790 on the Web Server tier of your LANSA for the Web system, follow these steps:
- End the web server and run the LANSA for the Web cleanup program. Refer to 13.5.6 Clean Up Systems in the LANSA Online documentation for cleanup instructions.
- If you haven't installed or upgraded LANSA for the Web on the Web Server, do so before proceeding with step 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).
- 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.
- Install the EPC for the Web Server by using the command:
LOADE790MT 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
- Press enter to continue processing.
- Save, and then delete, the backout library (iiiEPCMBnn where iii = 1st three characters of the LANSA pgm library and nn is sequence number) created by the install. The contents of this library may be used to backout this EPC and return your system to its previous state.
- Sign off and sign on again if you want to run the configuration program.
Instructions for installing on Windows
- Recommend that a backup be done of all LANSA folders and your LANSA database before applying this EPC.
- Stop using the LANSA development environment and stop all currently executing LANSA applications.
- Double-click on EPC790w.exe.
- Select the "Setup" button or "Cancel" if you do not want to proceed.
- If you have multiple configurations installed, Select the configuration to which the EPC is to be applied.
- From EPC790 you will be asked to nominate the web partitions into which the updated set of weblets are to be imported.
- If you are prompted to reboot your pc - please reboot.
- To view details of the installed EPCs:
- sign into LANSA
- view the Help menu
- Product Information option
- then select the Installation Details tab
- expand the Installation/ EPC Summary
- review the last entries
Instructions for installing EPC790HF-061117 to Visual LANSA
Copy the extracted EPC790HF-061117 directory structure into the LANSA V11.0 root directory eg. C:\Program Files\LANSA
In the EPC790HF-061117 directory there is a file called hotfix.cmd. Run this command file (double click on it).
This will perform the following actions
- Create a BACKUP folder under the \LANSA and \EXECUTE folders.
- Copy the files to be replaced to these folders and rename them to *.bak
- 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.
Instructions for installing EC790P07 and EC790P09 to LANSA for iSeries
EC790P07 and EC790P09 include software to be installed on an iSeries system. These instructions describe the installation and use of all delivered items.
- Unzip (double click) the EC790P07.ZIP. These files will be extracted EC790P07.htm and EC790P07 - iSeries Save file. Follow the instructions in EC790P07.htm to apply the patch.
- Unzip (double click) the EC790P09.ZIP. These files will be extracted EC790P09.htm and EC790P09 - iSeries Save file. Follow the instructions in EC790P09.htm to apply the patch.
© 2006 LANSA
