EPC - 759

Date : 26 August 2005

ProductVisual LANSA
Version11.0
Pre-Requisite DetailsWindows: EPC751
iSeries:    EPC751 & OS/400 V5R1 or above
Related ProductsLANSA for the Web
Full Distribution InV12.0
Special NotesAll 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.

It is recommended to make a full backup of all the LANSA folders, system libraries and ALL the LANSA IFS objects. (LANSA_pgmlib/x_lansa) before applying this EPC.
iSeries Specific Special NotesThe 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.

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

Description

Cumulative EPC for Visual LANSA V11.0.

Instructions to install the EPC

EPC759 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 EPC759.EXE file from Web site or email.
  2. Unzip (double click) EPC759.EXE. These files will be extracted:
    • EPC759.htm - this document
    • EPC759 - iSeries Save file
    • EPC759w.exe - Windows install executable

Instructions provided for:

YesLANSA for iSeries
YesiSeries Web server (multi-tier)
NoiSeries import
YesVisual LANSA
NoOther Windows based products

Detailed changes

EPC759 includes these changes:    [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 EPC759
    • copy unzipped file EPC759 to folder EPC759
  3. If your network file system is not supporting AS/400 shared folders, use FTP via TCP/IP performing the following steps:
    • logon to the AS/400 and create folder EPC759
    • 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 EPC759
    • to send the downloaded file to the iSeries : enter command put EPC759
    • 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@EC759 (on the backup media) into library QTEMP.

    If using a save file you will use the following command:
    RSTOBJ OBJ(*ALL) SAVLIB(DC@EC759) 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:

    LOADEPC759 PGMLIB(<pgmlib>) COMLIB(<shrlib>)
    where <pgmlib> is the name of the LANSA program library. This is often DC@PGMLIB but it may be different on your system.
    where <shrlib> is the name of the LANSA share library. If this parameter is not specified then the default QGPL library is used.
     
  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 (LANSAEC759) 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 EPC759 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:

    LOADE759MT ADMLIB(<adminlib>) COMLIB(<shrlib>)
    Where <adminlib> is the name of the LANSA for the Web Administration Library. After entering the library name, press enter. The current owner and the current LANSA communication extensions service program library will be displayed. Leave the defaults.
    Where <objown> is the owner of the LANSA for the Web objects.
    Where <shrlib> is the name of the share library. If this parameter is not specified then QGPL is used by default.
     
  5. Press enter to continue processing.
  6. Save, and then delete, the backout library (LANSAMT759) 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.

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 EPC759w.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. Select the Installation Details tab then expand the Installation/Summary and or epc.dat.

© 2005 LANSA

Back to Top