EPC - 845 (includes 844, 846 and 847)

Date : 1 July 2009

EPC845 Highlights

Get this EPCDownload EPC845 via the LANSA Support Portal
Product Visual LANSA and LANSA for iSeries
LANSA Communications (844 on windows)
LANSA for the Web (846/847 on windows)
Version 11 SP5
Pre-Requisite Details None
Related Products LANSA Integrator
Full Distribution In V12
Special Notes

All Version 11 SP5 Visual LANSA EPCs include updates that must be applied to Windows and System i 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.

System i Specific Special Notes The System i instructions are expedited procedures that assume a sound knowledge of i5/OS.
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 X_RUN arguments DBRM, DBHU, DBHP and DBHS are no longer used or recognized and so must be removed from any X_RUN command line.
The special Windows login XDBG_USER is no longer needed and is highly recommended to be removed.

Web Validation List program W3@P2301 has been enhanced to support long user id.  
If a variable is used for the program W3@P2301's <Web User Profile> parameter, the variable needs to be changed from CHAR(10) to CHAR(256).

Document Updates Updates to these guides are provided:

    BeginHere.chmLANSA User Assistance
directory.chmLANSA Documentation Directory
GlobalDeploy.chmDeploy LANSA Applications
GlobalInstall.chmInstalling LANSA
GlobaliSeries.chmLANSA for iSeries Guides
GlobalVisualLANSA.chm    Visual LANSA Guides
GlobalWeb.chmLANSA for the Web Guides
lansa009.chmIntroduction to LANSA for iSeries Guide
lansa010.chmLANSA iSeries User Guide
lansa011.chmVisual LANSA Administrator Guide
lansa012.chmVisual LANSA User Guide
lansa013.chmVisual LANSA Developer Guide
lansa015.chmTechnical Reference Guilde
lansa016.chmVisual LANSA Feature Help
lansa020.chmDeploying Visual LANSA Applications Guide
lansa022.chmLANSA Application Deployment Tool
lansa040.chmInstalling LANSA on iSeries
lansa041.chmInstalling LANSA on Windows
lansa045.chmLANSA Communications Setup Guide
lansa046.chmInstalling LANSA on UNIX (Linux)
lansa065.chmLANSA Application Design Guide
lansa086.chmWeb Functions
lansa088.chmWeb Features and Housekeeping
lansa093.chmLANSA Integrator Guide
lansa097.chmVisual LANSA Windows Application Tutorials
rdmlref.chmiSeries Technical Reference Guide
TutorialList.chmLANSA Tutorial Directory

The guides updated by EPC are only placed in the default LANSA documentation location as installed with Visual LANSA. This default location is ...\x_win95\x_lansa\execute\eng directory. If you installed the LANSA documentation (default folder ...\lansadoc\) from the LANSA Windows CD-ROM, you should manually copy the updated guides to those folders.

The latest guide updates are also available at http://www.lansa.com/support/docs/update.htm

Hotfixes

Windows and system i Hotfixes and Patches issued after 1st June 2009 are not included in this EPC set. If you have applied a hotfix or patch to your environment and are unsure of its status, do not apply this EPC set as the changes delivered in the hotfix or patch may no longer work (may be backed out). Contact your local LANSA vendor for confirmation before applying this EPC set.

Instructions to install the EPC

EPC845 includes software to be installed on a System i machine and on a Windows machine. These instructions describe the installation and use of all delivered items.

  1. Download EPC845.EXE file from the Web site or email.
  2. Unzip (double click) EPC845.EXE. These files will be extracted:

Instructions provided for:

Yes LANSA for iSeries
Yes System i Web Server (multi-tier)
Yes Visual LANSA

 

Detailed changes

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

Affected objects

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

 

   System i Components:    [Click here to Show table...]

Install Instructions

Instructions for installing on System i

These instructions have been abbreviated for experienced LANSA users. If 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.

  1. Sign on with QSECOFR user profile, part of the QSECOFR group or a user profile that has *ALLOBJ and *SECADM special authorities.
  2. Backup all the LANSA folders, system libraries and ALL the LANSA IFS objects (LANSA_pgmlib/x_lansa) before applying this EPC
  3. 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 System i guide for instructions.
  4. End the Listener, Host Monitor and Web Server for the LANSA system and run the LANSA for the Web cleanup program.
  5. Move the unzipped file EPC845 to an IFS folder on the System i. ( e.g. /LANSA_pgmlib/tmp/epc845' ) 
  6. For this EPC use the following options:
    1. Install the EPC from = *IFS
    2. Apply this EPC to = FULL_LANSA_SYSTEM 
  7. Run the command LOADEPC with the following parameters:

    pgmlib/LOADEPC and press command 4 (F4) to prompt the command (can be run in batch)

  8. EPC number . . . . . . . . . . . > 845

    Install the EPC from . . . . . . > *IFS
    IFS Path and object name . . . . e.g. /LANSA_pgmlib/tmp/epc845

    Apply this EPC to . . . . . . . FULL_LANSA_SYSTEM
    LANSA program library . . . . . pgmlib

  9. 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.
  10. Sign off and then on again before commencing the next installation, e.g.:

Instructions for users of iSeries Web Server (multi-tier)

The command LOADEPC is now available in the LANSA web server Admin library. Use the following instructions.

  1. If you haven't installed or upgraded LANSA for the Web on the Web Server, do so before proceeding with step 2.
  2. Backup all the LANSA folders, system libraries and ALL the LANSA IFS objects (LANSA_admlib/x_lansa) before applying this EPC
  3. 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.
  4. 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.
  5. Move the unzipped file EPC845 to an IFS folder on the System i. ( e.g. /LANSA_admlib/tmp/epc845' ) 
  6. For this EPC use the following options:
    1. Install the EPC from = *IFS
    2. Apply this EPC to = LANSA_WEB_SERVER 
  7. Run the command LOADEPC with the following parameters:

    admlib/LOADEPC and press command 4 (F4) to prompt the command (can be run in batch)

  8. EPC number . . . . . . . . . . . > 845

    Install the EPC from . . . . . . > *IFS 
    IFS Path and object name . . . . e.g. /LANSA_admlib/tmp/epc845

    Apply this EPC to . . . . . . . LANSA_WEB_SERVER
    LANSA web server admin lib . . . admlib 

  9. 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.
  10. Sign off and then on again before commencing the next installation, e.g.:
    • to apply this EPC on another LANSA system
    • to apply another EPC on the same LANSA system

Note 1:

The WEBLETS import will be submitted into a batch job and the job name is EPC_845IMP. This job will import the WEBLET save file into all WEB enabled RDMLX partitions. The import will fail if the WEB enabled RDMLX partition is not multilingual with a language specified. Refer to section Change Partition to Multilingual in the Installing LANSA on System i V11 SP5 guide for instructions on how to convert the partition to multilingual for the duration of the import. Rerun the WEBLETS import (see System i Components in this EPC document for the location of the save file).

 

Instructions for installing on Windows

  1. Recommend that a backup be done of all LANSA folders and your LANSA database before applying this EPC.
  2. Stop using the LANSA development environment and stop all currently executing LANSA applications.
  3. Double-click on AllEPCs.exe.
  4. Select the "Setup" button or "Cancel" if you do not want to proceed.
  5. If you have multiple configurations installed, Select the configuration to which the EPC is to be applied.
  6. If you are prompted to reboot your pc - please reboot.
  7. To view details of the installed EPCs:
    1. sign into LANSA
    2. view the Help menu
    3. Product Information option
    4. then select the Installation Details tab
    5. expand the Installation/ EPC Summary
    6. review the last entries

© 2009 LANSA