EPC - 771

Date : 20 April 2006

ProductVisual LANSA
Version11.0
Pre-Requisite DetailsWindows: EPC751 (11.0 CU1 CD)
iSeries: EPC751 (11.0 CU1 CD) & OS/400 V5R1 or above
Related ProductsLANSA Client
LANSA Open
LANSA for the Web
Visual LANSA Framework
Full Distribution In11.3
Special Notes
  1. Any OAMs built with 11.0 Early Release or later must be rebuilt. This includes OAMs in an RDMLX partition on iSeries. 

  2. If SELECT_SQL is used in your application, functions and components that use it must be recompiled. For iSeries, this is only required for RDMLX functions and components.

  3. WAM developers: Read special notes related to cascading style sheet changes for WAMs in CU3.

  4. WAMs are not supported with Oracle databases. Please contact your product vendor for more information.

  5. All Version 11.0 Visual LANSA EPCs will contain 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 SuperServer applications inoperable. Attempting to use the host monitor and SuperServer applications without having applied the EPC to both sides of a development environment will generate an EPC mismatch error.

  6. If you require DBCS support to RDMLX iSeries Servers (E.g. Execute Form as Client to RDMLX iSeries Server),  you must run SYSEXPORT once with the latest languages in your partition.
iSeries Specific Special NotesThese are expedited procedures that assume a sound knowledge of OS/400.

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.

Make sure no one is using the LANSA system to be upgraded.

Make a full backup of all the LANSA system libraries and ALL the LANSA IFS objects. (LANSA_pgmlib/x_lansa) before applying this EPC.

There are special instructions for LANSA Client, LANSA Open, Web-enabled partitions, and OSU changes. Please read them.

Description

Cumulative EPC for Visual LANSA V11.0. EPC771 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 Open.

Instructions provided for:

YesVisual LANSA
YesLANSA for iSeries - download
YesLANSA for iSeries - CD
YesiSeries Web server (multi-tier) - download
YesiSeries Web server (multi-tier) - CD
YesiSeries import (Web-enabled partitions)
YesiSeries import (CLIENT)
YesLANSA OSU Changes
YesLANSA Open server-side changes

Detailed changes

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

EPC771 supercedes EPC759, EPC761, EPC762 and EPC765 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 to install the EPC on Windows

This may be installed as part of CU3. If you are installing just this EPC, follow the instructions below.

With V11.0 LANSA Windows based EPCs are now installed directly from the self-extracting zip file in which they are delivered.

  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 EPC771.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. Details of the EPC are recorded. You can view these details by using the Help/Product Information menu option from inside the LANSA development environment, then click the EPC button.

Instructions to install LANSA V11.0 CU3 on iSeries - Download Version

A LANSA iSeries CU3 download save file will enable you to Update a V11.0(EPC751 or later) system to CU3 level (EPC771).

After the install, remember to do the following additional actions:

Instructions for installing on iSeries

  1. It is recommended to backup all the LANSA folders, system libraries and ALL the LANSA IFS objects (LANSA_pgmlib/x_lansa) before applying this EPC. Refer to Summary of Installed Objects in the LANSA Online documentation for a full list of LANSA installed objects. Note that you may not have all the objects on the list, depending on what LANSA products and features are installed.
  2. Make sure no one is using the LANSA system to be upgraded. Refer to Appendix C How to check for Active Users in the LANSA Online documentation for instructions to check for active users.
  3. End the Listener and Host Monitor for this LANSA system.
  4. 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.
  5. For iSeries shared folders:
    • in Explorer, map to the shared folder drive
    • create a folder named CU3
    • copy unzipped file CU3 to folder CU3
  6. 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 CU3
    • 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 CU3 : enter command cd CU3
    • to send the downloaded file to the iSeries : enter command put CU3
    • to exit : enter command quit
  7. 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.
  8. You now have a save file. Continue installing by following the instructions in the next section.

To upgrade to CU3 follow the following instructions.

  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 the save file CU3 into library QTEMP.

    RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(CU3-save file name-) RSTLIB(QTEMP)
    Note: All other RSTOBJ parametes should be left at their default values.
     
  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:
    LOADCU3 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 (xxxEPC??) created by the install. The contents of the library may be used to backout this EPC and return your system to its previous state. Where xx= the first three charaters of the LANSA program library name and ?? = unique number. The EPC number is on library text.
  8. Sign off and then on again before commencing the next installation of:
    • applying this EPC on another LANSA system
    • applying another EPC on this LANSA system

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

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

  1. 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.
  2. If you haven't installed or upgraded LANSA for the Web on the Web Server, do so before proceeding with step 2.
  3. 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).
  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. Install the EPC for the Web Server by using the command:

    LOADECU3MT 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
     
  6. Press enter to continue processing.
  7. Save, and then delete, the backout library (xxxEPCMB??) created by the install. The contents of this library may be used to backout this EPC and return your system to its previous state. Where xx= the first three charaters of the LANSA Adminisration library name and ?? = unique number. The EPC number is on library text.
  8. Sign off and sign on again if you want to run the configuration program.

Instructions to install LANSA V11.0 CU3 on iSeries - CD Version

A LANSA iSeries CU3 CD-ROM will enable you to Update a V11.0(EPC751 or later) system to CU3 level.

After the install, remember to do the following additional actions:

Instructions for users of iSeries LANSA V11.0 to upgrade to CU3 level

  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. From a command screen run the following: LODRUN *OPT
  3. The Following screen will be displayed and select where to apply this upgrade select FULL_LANSA_SYSTEM for the LANSA program library.

                Load Expedited Program Change (LODCU3SEL)

                Type choices, press Enter.
                Apply This EPC to . . . . . . . FULL_LANSA_SYSTEM
                Job Queue . . . . . . . . . . .     QBATCH
                    Library name . . . . . . . . .     QGPL
  4. On the next screen, enter your LANSA program library. This is the LANSA system that the EPC will be applied.

                Load Expedited Program Change (LOADCU3MA)
        
                Type choices, press Enter.
                LANSA program library . . . . .  <LANSA-pgmlib>

    (Where <LANSA_pgmlib> is the name of the LANSA program library)

    After pressing enter the EPC job LODCU3 will be submitted to the job queue. At the end of EPC job LODCU3 a clean up job CU3CLN will be submitted to the same job queue. All the messages are in a message queue CU3MSGQA in the QGPL library

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

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

  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. From a command screen run the following: LODRUN *OPT
  3. The Following screen will be displayed and select where to to apply this upgrade select LANSA_WEB_SERVER for the WEB server

                Load Expedited Program Change (LODCU3SEL)

                Type choices, press Enter.
                Apply This EPC to . . . . . . . LANSA_WEB_SERVER
                Job Queue . . . . . . . . . . .     QBATCH
                    Library name . . . . . . . . .     QGPL 
     
  4. On the next screen, enter your LANSA Administration library. This is the LANSA Web server (model-b) system to which the EPC will be applied.

                Load CU3 on Web Server (LOADECU3MB)

                Type choices, press Enter.
                LANSA administration library . . <LANSA_adminlib>

    (Where <LANSA_adminlib> is the name of the LANSA Web Server multi-tier program library)

    After pressing enter the CU3 upgrade job LODCU3B will be submitted to the job queue. At the end of CU3 upgrade job LODCU3B a clean up job CU3CLNB will be submitted to the same job queue. All the messages are in a message queue CU3MSGQB in the QGPL library

Special Instructions for users of iSeries Web-enabled partitions

If you have Web enabled partitions then you must import the new import save file WEBLETS from the LANSA program library.

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

Special Instructions for users of iSeries Client import

If you have applied EPC761 you are not required to do this.

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 LANSA Open System Utility (OSU)

If you have applied EPC761 you do are not required to do this.

Once CU3 update 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.

Special Instructions for LANSA Open users

If you enable an iSeries partition for RDMLX, and use LceLansaCall() or LceSubmit() to call LANSA functions, you MUST rebuild all processes called in this way.

Special notes related to cascading style sheet changes for WAMs in CU3

The standard weblet std_style (Standard Cascading Style Sheet) has been changed to ensure that the LANSA shipped cascading style sheet is always included. If you nominate a different CSS file in your layouts, the std_style weblet will include your style sheet after the LANSA shipped style sheet.

If you don't use the std_style weblet and you have your own cascading style sheets, you should add the following import statement at the beginning of your CSS file, to ensure all styles required by LANSA shipped weblets are available:

@import url("std_style.css");

In CU3, a new style "hidden__" has been added to embed text strings in HTML pages. If you notice unwanted text strings in your HTML pages, your pages may not be including the LANSA shipped cascading style sheets.

© 2006 LANSA

Back to Top